Difference between revisions of "LlGetObjectMass"

From Second Life Wiki
Jump to navigation Jump to search
(The SL unit of mass is the Linden, no way you would know that. Articles are supposed to be written in the thrid person.)
m (Cannot be used with group keys)
(16 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-2={{LSL_Function/uuid|id|sim=*|object=*|group=}}
|func_id=295|func_sleep=0.0|func_energy=10.0
|func_id=295|func_sleep=0.0|func_energy=10.0
|func=llGetObjectMass
|func=llGetObjectMass
|return_type=float|p1_type=key|p1_name=id|p1_desc=Avatar or object in the sim
|return_type=float|p1_type=key|p1_name=id
|func_footnote
|func_footnote
|func_desc
|func_desc
Line 8: Line 9:
|spec
|spec
|caveats=
|caveats=
*Returns zero if '''id''' is not found in the sim.
* Returns zero if '''id''' is not found in the region.
* '''id''' can be any prim in the object.
|constants
|constants
|examples=
|examples=
Every avatar, regardless of size, shape, attachments, sex or species, the avatar mass is always 1.954922 Lindens.
<source lang="lsl2">default
<pre>
default
{
{
     touch(integer n)
     touch(integer n)
     {
     {
         llSay(0, llDetectedName(0) + " your mass is " + (string)llGetObjectMass( llDetectedKey(0)) + " Lindens.");
         llSay(0, llDetectedName(0) + " your mass is " + (string)llGetObjectMass( llDetectedKey(0)) + " lindogram.");
     }
     }
}//Anylyn Hax 15:02, 28 July 2007 (PDT)
}
</pre>
//Anylyn Hax 15:02, 28 July 2007 (PDT)</source>
Mass [m] is the quantity of materia that a avatar has inside itself, and is expressed in Kg (Kilogramms).
The Weight [G] is a Force, expressed in N (Newtons), and it is m * g, where g is the the gravitational atraction (g = 9.81 on Earth).
|helpers
|helpers
|also_functions=
|also_functions=
{{LSL DefineRow||[[llGetMass]]|Gets the current object mass.}}
{{LSL DefineRow||[[llGetMass]]|Gets the current object mass.}}
|also_tests
|also_tests=
{{LSL DefineRow||[[llGetObjectMass_Test]]}}
|also_events
|also_events
|also_articles
|also_articles
|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.
|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
|cat1=Object
|cat2
|cat2=Physics
|cat3
|cat3
|cat4
|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 );