Difference between revisions of "LlGetObjectMass"

From Second Life Wiki
Jump to navigation Jump to search
m (cleanup)
m (Added a tip that llGetObjectMass() is a handy way to see if an object or avatar with a particular key still exists on a region (hat tip scotty.muircastle))
(12 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-2={{LSL_Function/uuid|id|sim=*|object=*}}
|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=
<lsl>default
<source lang="lsl2">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)</lsl>
}
//Anylyn Hax 15:02, 28 July 2007 (PDT)</source>
|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
|history=Prior to server code version 1.18.6.76747 avatar mass was fixed at 1.954922 Lindens. It is now relative to Avatar shape/size.
|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=
|notes=
* Mass for Avatars is relative to shape/size, and unaffected by attachments.
* [http://en.wikipedia.org/wiki/Mass Mass] in SL is expressed as ''lindogram''. One lindogram appears to be equal to 100 kilograms.
* Mass[m] is the quantity of material that something contains, 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). Mass is NOT weight or density. Ex. objects with bouancy still have mass and still require energy to move.
* 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 18:30, 15 December 2018

Summary

Function: float llGetObjectMass( key id );

Returns a float that is the mass of id

• key id group, 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 );