LlGetLinkKey/ja

/ja

/LSL

GetLinkKey/ja

llGetLinkKey

要約

関数: key llGetLinkKey( integer linknum );

144	関数ID
0.0	遅延
10.0	エネルギー

現在のリンクセットの、リンクナンバーlinknumのプリムのキーを key で返します。

• integer

linknum

–

リンク 番号 (0: リンクなし, 1: ルートプリム, >1: 子プリム) または LINK_* フラグ

フラグ 説明 LINK_ROOT 1 リンクセットの中のルートプリムに送ります LINK_SET -1 全プリムに送ります LINK_ALL_OTHERS -2 自分以外の全プリムに送ります

フラグ 説明 LINK_ALL_CHILDREN -3 （ルートプリム以外の全ての）子プリムに送ります LINK_THIS -4 スクリプトの入った自プリムに送ります

警告

• 非マイナス域の、0からllGetNumberOfPrimsを含む、LINK_ROOTのようなlinknumを準備しましょう。
• linknumにLINK_THISは用いず、SVC-600のバグにつき、代わりにllGetKeyを呼び出します。申し訳ありません。
• LINK_SET、LINK_ALL_OTHERS、もしくはLINK_ALL_CHILDRENを、複数のプリムで参照するlinknumに無意味に用いないでください。

サンプル

リンクされたプリムにこのスクリプトをドラッグして、プリムのリンクを解除し、アバタがすわっているかいないか、llGetLinkKeyをllGetKey, llGetLinkNumber, llGetNumberOfPrims, LINK_ROOTなどを関連して参照します <lsl>// Return the name of a link num else the empty string.

string getLinkNumName(integer link) {

   if (LINK_THIS == link) return "LINK_THIS";
   if (LINK_ALL_CHILDREN == link) return "LINK_ALL_CHILDREN";
   if (LINK_ALL_OTHERS == link) return "LINK_ALL_OTHERS";
   if (LINK_SET == link) return "LINK_SET";
   if (LINK_ROOT == link) return "LINK_ROOT";
   return "";

}

// Say the key of each linked prim.

default {

   state_entry()
   {
       integer theLink = llGetLinkNumber();
       
       key theLinkKey = llGetKey();
       key owner = llGetOwner();
       key creator = llGetCreator();
       
       // Visit each link num.
       
       integer link;
       integer primmed = llGetNumberOfPrims();
       for (link = -5; link <= (primmed + 5); ++link)
       {
           key linkKey = llGetLinkKey(link);
           
           // Detail the key at the link num.
           
           string line = (string) linkKey; // large constant width
           
           if (linkKey == owner) line += " llGetOwner";
           if (linkKey == creator) line += " llGetCreator";
           if (linkKey == theLinkKey) line += " llGetKey";
           
           // Detail the link num.
           
           line += " @ " + (string) link;
           line += " " + getLinkNumName(link);
           if (link == theLink) line += " llGetLinkNumber";
           if (link == primmed) line += " llGetNumberOfPrims";
           
           // Say the detail if fun.
           
           if (linkKey != NULL_KEY)
           {
               llOwnerSay(line);
           }
       }
       
       // Always count the linked prims.
       
       llOwnerSay((string) primmed + " llGetNumberOfPrims");
       llOwnerSay("OK");
   }

}</lsl>

注意点

リンク番号

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

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

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

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

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

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

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

関連項目

関数

•	llGetLinkNumber	–	スクリプトが入っているプリムのリンク番号を取得します。
•	llGetKey
•	llGetLinkName

特記事項

経緯

Bugs

Search JIRA for related Issues

Signature
function key llGetLinkKey( integer linknum );

この翻訳は 原文 と比べて古いですか？間違いがありますか？読みにくいですか？みんなで 修正 していきましょう！ (手順はこちら)

この項目はあなたにとって参考にならない項目ですか？もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。