Difference between revisions of "LlGetObjectMass"

From Second Life Wiki
Jump to navigation Jump to search
m (Cannot be used with group keys)
(25 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=295|func_sleep=0.0|func_energy=10.0|func=llGetObjectMass|return_type=float|p1_type=key|p1_name=id|func_footnote=Get the mass of the object with key id|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{LSL_Function
|inject-2={{LSL_Function/uuid|id|sim=*|object=*|group=}}
|func_id=295|func_sleep=0.0|func_energy=10.0
|func=llGetObjectMass
|return_type=float|p1_type=key|p1_name=id
|func_footnote
|func_desc
|return_text=that is the mass of '''id'''
|spec
|caveats=
* Returns zero if '''id''' is not found in the region.
* '''id''' can be any prim in the object.
|constants
|examples=
<source lang="lsl2">default
{
    touch(integer n)
    {
        llSay(0, llDetectedName(0) + " your mass is " + (string)llGetObjectMass( llDetectedKey(0)) + " lindogram.");
    }
}
//Anylyn Hax 15:02, 28 July 2007 (PDT)</source>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetMass]]|Gets the current object mass.}}
|also_tests=
{{LSL DefineRow||[[llGetObjectMass_Test]]}}
|also_events
|also_articles
|history=Prior to server code version 1.18.6.76747 avatar mass was fixed at 1.954922 lindogram. It is now relative to Avatar shape/size.
|notes=
* [http://en.wikipedia.org/wiki/Mass Mass] in SL is expressed as ''lindogram''. One lindogram appears to be equal to 100 kilograms.
* Mass for avatars is relative to shape/size, and unaffected by attachments. However, a survey of masses for avatars shows less variation than one would expect relative to shape/size, and the lindogram masses do not appear in any way realistic.
* Sitting avatars add their mass to the object.
* This function returns a mass of 0.01 for child agents.
* This function is a handy way to determine if an object or avatar still exists on a region. Other methods exist (such as checking that [[OBJECT_OWNER]] returned by [[llGetObjectDetails]] is a valid key), but this has slightly less overhead.
|cat1=Object
|cat2=Physics
|cat3
|cat4
}}

Revision as of 10:50, 24 September 2022

Summary

Function: float llGetObjectMass( key id );

Returns a float that is the mass of id

• key id avatar or object UUID that is in the same region

Caveats

  • Returns zero if id is not found in the region.
  • id can be any prim in the object.
All Issues ~ Search JIRA for related Bugs

Examples

default
{
    touch(integer n)
    {
        llSay(0, llDetectedName(0) + " your mass is " + (string)llGetObjectMass( llDetectedKey(0)) + " lindogram.");
    }
}
//Anylyn Hax 15:02, 28 July 2007 (PDT)

Notes

  • Mass in SL is expressed as lindogram. One lindogram appears to be equal to 100 kilograms.
  • Mass for avatars is relative to shape/size, and unaffected by attachments. However, a survey of masses for avatars shows less variation than one would expect relative to shape/size, and the lindogram masses do not appear in any way realistic.
  • Sitting avatars add their mass to the object.
  • This function returns a mass of 0.01 for child agents.
  • This function is a handy way to determine if an object or avatar still exists on a region. Other methods exist (such as checking that OBJECT_OWNER returned by llGetObjectDetails is a valid key), but this has slightly less overhead.

See Also

Functions

•  llGetMass Gets the current object mass.

Deep Notes

History

Prior to server code version 1.18.6.76747 avatar mass was fixed at 1.954922 lindogram. It is now relative to Avatar shape/size.
Search JIRA for related Issues

Tests

•  llGetObjectMass_Test

Signature

function float llGetObjectMass( key id );