LlSetLinkPrimitiveParams/ja

ルールに沿って、リンクナンバーのプリムにプリミティブのパラメータを設定します。

• この関数は 0.2 秒間、スクリプトを停止します。
• texture がプリムの中で見つからない場合、かつこれが UUID でない場合、またはこれがtextureでない場合、エラーが DEBUG_CHANNEL 上で叫ばれます。
• texture が UUID である場合、オブジェクト自体に新たな アセット権限 が発生するようなことはありません。
  • アセットをプリムのインベントリの中に置いた場合、これまで発生していた使用制限は新しいオブジェクトで新たに作成されません。
• ストレージ媒体として フローティングテキスト の機能が使えると思わないでください。これは不完全ですし、安全なものでもありません。
  • フローティングテキストはサーバの更新時に変更になったことが過去にあり、その際に既に設定されている内容は消去されていました。将来も変更が発生する可能性があります。
  • 「不可視」^[1] のフローティングテキストもクライアントに送信されます。
    • 不可視にしているテキストを表示することのできるクライアントを持っている人が見れてしまう可能性があります。
    • テキストが含まれている通信パケットが盗聴され、テキストが読まれる可能性があります。
• top_size とクライアントの値は異なります。範囲は一致しておらず、変換が必要です。シンプルな計算式は、結果 = 1.0 - value です。詳細は top_size Explained をご覧ください。
• map がプリムの中で見つからない場合、かつこれが UUID でない場合、またはこれがtextureでない場合、エラーが DEBUG_CHANNEL 上で叫ばれます。
• map が UUID である場合、オブジェクト自体に新たな アセット権限 が発生するようなことはありません。
  • アセットをプリムのインベントリの中に置いた場合、これまで発生していた使用制限は新しいオブジェクトで新たに作成されません。
• PRIM_POSITION caveats
  • 状況によって position は ローカル座標 か リージョン座標 のどちらかを指定する必要があります。詳細は llSetPosの仕様 を参照してください。
  • アタッチされていないルートプリムの場合、プリムが動ける範囲は限られています。PRIM_POSITION 1 コールあたり 10m に制限されています。WarpPos を参照してください。これは非常に特殊なケースです。 Do not rely on rule duplication of other flags - 結果は不定で、将来 きっと 壊れます。
  • PRIM_POSITION で アバター を動かすときは、
    • アバターが座っているプリムを動かしてもアバターは動きません。
    • アバターを動かしても、アバターが座っているプリムは動きません。
    • 座っている位置の座標はプリムの座標に素直に連動しません。SitTargetを更新 を使ってください。
    • position が中心から 54 メートルを超えると、エラーを出さずに失敗します。
• PRIM_PHANTOM, PRIM_PHYSICS と PRIM_TEMP_ON_REZ はオブジェクト全体（リンクセット）に適用されます。
• 値はズレたり、切り捨てられたり、上限があったりすることもあります。描画の前にデシリアライゼーションの過程でクライアントがかける制限もあれば、SIM が値を格納する前にかける制限もあります。
  • vector と rotation をテストする時には、(それぞれ) llVecDist と llAngleBetween を使ってファジングを行いましょう。
• face が ALL_SIDES であれば flag は全ての面に作用します。
• face が存在しない面を指している場合、 flag はエラーを出さずに復帰します。
• LINK_SETへの演算の適用は、ルートプリムが最初に適用され、次にそれぞれの子プリムになります。
• 現在llGetLinkPrimitiveParamsに相当するものはありません。.
  • リンクされたプリムから多くのパラメータを取得する唯一の方法は、それぞれの子プリムに別々にスクリプトをいれて、llMessageLinkedを使うことです。

重要事項

		SVC-914	[C]		CHANGED_TEXTURE is not triggered when texture is changed via script
		SVC-93	[C]		llSetRot and llSetPrimitiveParams (using PRIM_ROTATION) incorrectly implemented for child prims.

全てのLINK_SETにスクリプトが含まれている時、llSetLinkPrimitiveParamsを使って、タッチした時にLINK_SETのプリムを点灯させ、最後にタッチした時に消灯する単純なスクリプトです。

default
{
    touch_start(integer total_number)
    {
        // 全てのプリムのフルブライトを消します
        llSetLinkPrimitiveParams(LINK_SET,[PRIM_FULLBRIGHT,ALL_SIDES,FALSE]);
        // タッチされたプリムをフルブライトにします
        llSetLinkPrimitiveParams(llDetectedLinkNumber(0),[PRIM_FULLBRIGHT,ALL_SIDES,TRUE]);        
    }
}

リンク番号

オブジェクトを構成するそれぞれのプリムにはアドレスがあります。それがリンク番号です。オブジェクトの特定のプリムにアクセスするには、そのプリムのリンク番号を知らなければなりません。リンク番号はプリムに振られますが、オブジェクトに座っているアバターにも振られます。

• オブジェクトが単一のプリムで構成されていて、アバターが座っていないとき、（ルート）プリムのリンク番号は 0 です。
• しかし、オブジェクトが複数のプリムで構成されていたり、オブジェクトに座っているアバターがいたりすると、ルートプリムのリンク番号は 1 となります。

アバターがオブジェクトに座ると、リンクセットの末尾に追加され、いちばん大きなリンク番号が振られることになります。さらに、アバターがオブジェクトに座っている場合、アバターを立たせないと、プリムのリンク・リンク解除ができません。

プリムやアバターの数え方

オブジェクトのプリムや、プリムに座っているアバターの数を調べるのに、２つの関数があります。

• llGetNumberOfPrims() - プリムと座っているアバターの数を返します。
• llGetObjectPrimCount(llGetKey()) - オブジェクトのプリムの数だけを返しますが、アタッチメントとなっている場合は 0 を返します。

integer GetPrimCount() { //常にプリムの数だけを返します。
    if(llGetAttached())//装着されているか？
        return llGetNumberOfPrims();//アバターとプリムの数を返しますが、アタッチメントの上には座れないのでこれでいいです。
    return llGetObjectPrimCount(llGetKey());//プリムの数だけを返しますが、アタッチメントの場合ここは通りません。
}

PRIM_POSITION

オブジェクトに座っているアバターを、llSetLinkPrimitiveParams と PRIM_POSITION を使って動かすことができます。もともとは予定していなかった特性ですが、Andrew Linden により、リンデンはこの特性をサポートすることにしました。

例

下の例では、座っているプリムの位置を動かさずに x,y,z の方向にアバターを動かします。x,y,z が呼び出し元から 54 メートルを超えると、何もエラーを出さずに失敗します。x,y,z は他のリンクされているオブジェクトのプリム同様、オブジェクトの相対座標であることに注意してください。

アバターは常にリンクセットの中の最後のプリムです。このため、llGetNumberOfPrims は乗り物に座っている 1 人のアバターにも使用できます。

llSetLinkPrimitiveParams(llGetNumberOfPrims(), [PRIM_POSITION, <x,y,z>]);

関数

記事

記事

		SVC-914	[C]		CHANGED_TEXTURE is not triggered when texture is changed via script
		SVC-93	[C]		llSetRot and llSetPrimitiveParams (using PRIM_ROTATION) incorrectly implemented for child prims.

脚注