Difference between revisions of "LlGetObjectPrimCount"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Search JIRA for related Issues
Kaluura Boa (talk | contribs) m |
m (Replaced <source> with <syntaxhighlight>) |
||
| (5 intermediate revisions by 4 users not shown) | |||
| Line 5: | Line 5: | ||
|return_type=integer | |return_type=integer | ||
|p1_type=key|p1_name=prim|p1_desc | |p1_type=key|p1_name=prim|p1_desc | ||
|func_footnote=Avatars sitting on the object are not counted{{Footnote|[[llGetNumberOfPrims]] on the other hand does count avatars sitting on the object.|llGetNumberOfPrims on the other hand does count avatars sitting on the object.}}. Zero is returned if | |func_footnote=Avatars sitting on the object are not counted{{Footnote|[[llGetNumberOfPrims]] on the other hand does count avatars sitting on the object.|llGetNumberOfPrims on the other hand does count avatars sitting on the object.}}. Zero is returned if {{LSLP|prim}}: {{HoverText|(A)|is not found}} is not found, {{HoverText|(B)|is part of an attachment}} is part of an attachment{{Footnote|Whether the attachment exception is a bug or a feature is unclear.|handle=attachment}}, or {{HoverText|(C)|is not a prim}} is not a prim. | ||
|func_desc | |func_desc | ||
|return_text=that is the total number of prims in the object that contains | |return_text=that is the total number of prims in the object that contains {{LSLP|prim}}. | ||
|spec | |spec | ||
|caveats= | |caveats= | ||
| Line 14: | Line 14: | ||
|constants | |constants | ||
|examples= | |examples= | ||
< | <syntaxhighlight lang="lsl2">default | ||
{ | { | ||
touch_start(integer num) | touch_start(integer num) | ||
| Line 31: | Line 31: | ||
+ " avatars."); | + " avatars."); | ||
} | } | ||
}</ | }</syntaxhighlight> | ||
|helpers | |helpers | ||
|also_functions= | |also_functions= | ||
Latest revision as of 10:59, 16 December 2022
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llGetObjectPrimCount( key prim );| 323 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns an integer that is the total number of prims in the object that contains prim.
| • key | prim | – | prim UUID that is in the same region |
Avatars sitting on the object are not counted[1]. Zero is returned if prim: (A) is not found, (B) is part of an attachment[2], or (C) is not a prim.
Caveats
- This cannot be used to detect if an avatar is seated (by checking for a non-zero return), use llGetAgentInfo instead.
- The prim count for attachments are not returned[2]. If possible use llGetNumberOfPrims instead.
Examples
default
{
touch_start(integer num)
{
integer prims = llGetObjectPrimCount(llGetKey());
if (prims == 0)
{
// llGetObjectPrimCount returns zero for attachments.
prims = llGetNumberOfPrims();
// Avatars can't sit on attachments so this is ok.
}
llOwnerSay("This object has "
+ (string)prims
+ " prims and "
+ (string)(llGetNumberOfPrims() - prims)
+ " avatars.");
}
}
See Also
Functions
| • | llGetNumberOfPrims | – | Returns the number of prims in the current object. |
Deep Notes
Footnotes
- ^ llGetNumberOfPrims on the other hand does count avatars sitting on the object.
- ^ Whether the attachment exception is a bug or a feature is unclear.
Signature |
|---|
function integer llGetObjectPrimCount( key prim ); |