Difference between revisions of "LlGetNumberOfPrims"

From Second Life Wiki
Jump to navigation Jump to search
(strictly speaking that check wasn't needed)
m
 
(18 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|func_id=275|func_sleep=0.0|func_energy=10.0
|func_id=275|func_sleep=0.0|func_energy=10.0
|func=llGetNumberOfPrims|sort=GetNumberOfPrims
|func=llGetNumberOfPrims
|return_type=integer
|return_type=integer
|func_footnote
|func_footnote
Line 7: Line 7:
|return_text=that is the number of prims in a link set the script is attached to.
|return_text=that is the number of prims in a link set the script is attached to.
|spec
|spec
|caveats
|caveats=*The number of prims returned also includes the number of avatars sitting on the object.
|constants
|constants
|examples
|examples=<source lang="lsl2">default
|helpers=<pre>
{
//Returns the number of agents on the object
    state_entry()
integer GetNumberOfAgents()
    {
{//count avatars
        llOwnerSay((string)llGetLinkNumber());
    integer a = llGetNumberOfPrims();
        llOwnerSay((string)llGetNumberOfPrims());
    integer b = a;
    }
    while(llGetAgentSize(llGetLinkKey(a)))
}</source>
        --a;
|helpers=<source lang="lsl2">
    return b - a;
// Returns the number of prims in the object, ignoring seated avatars
integer getNumberOfPrims(){
  if (llGetObjectPrimCount(llGetKey()) == 0 ) return llGetNumberOfPrims(); // attachment
  return llGetObjectPrimCount(llGetKey());   // non-attachment
}
}
 
</source>
//Returns the number of prims in the object
integer GetNumberOfPrims()
{//ignores avatars
    integer a = llGetNumberOfPrims();
    while(llGetAgentSize(llGetLinkKey(a)))
        --a;
    return a;
}
</pre>
|also_functions=
|also_functions=
{{LSL DefineRow||{{LSLG|llGetObjectPrimCount}}|Returns the number of prims in any object.}}
{{LSL DefineRow||[[llGetObjectPrimCount]]|Returns the number of prims in any object.}}
{{LSL DefineRow||{{LSLG|llGetLinkNumber}}|Returns the link number of the prim the script is in.}}
{{LSL DefineRow||[[llGetLinkNumber]]|Returns the link number of the prim the script is in.}}
|also_tests
|also_tests
|also_events
|also_events
Line 38: Line 32:
|notes
|notes
|cat1=Link
|cat1=Link
|cat2
|cat2=Object
|cat3
|cat3
|cat4
|cat4
}}
}}

Latest revision as of 02:16, 22 January 2015

Summary

Function: integer llGetNumberOfPrims( );

Returns an integer that is the number of prims in a link set the script is attached to.

Caveats

  • The number of prims returned also includes the number of avatars sitting on the object.
All Issues ~ Search JIRA for related Bugs

Examples

default
{
    state_entry()
    {
        llOwnerSay((string)llGetLinkNumber());
        llOwnerSay((string)llGetNumberOfPrims());
    }
}

Useful Snippets

// Returns the number of prims in the object, ignoring seated avatars
integer getNumberOfPrims(){
  if (llGetObjectPrimCount(llGetKey()) == 0 ) return llGetNumberOfPrims(); // attachment
  return llGetObjectPrimCount(llGetKey());   // non-attachment
}

See Also

Functions

•  llGetObjectPrimCount Returns the number of prims in any object.
•  llGetLinkNumber Returns the link number of the prim the script is in.

Deep Notes

Search JIRA for related Issues

Signature

function integer llGetNumberOfPrims();