llGetPhysicsMaterial

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetPhysicsMaterial

llGetPhysicsMaterial

Summary

Function: list llGetPhysicsMaterial( );

	Forced Delay
	Energy

Used to get the physical characteristics of an object.
Returns a list in the form [ float gravity_multiplier, float restitution, float friction, float density ]

• float	gravity_multiplier	–	range [-1.0, +28.0], default: 1.0
• float	restitution	–	range [0.0, 1.0], default: [0.3, 0.9] [1]
• float	friction	–	range [0.0, 255.0], default: [0.2, 0.9][1]
• float	density	–	range [1.0, 22587.0] kg/m^3, default: 1000.0

The default values for friction and restitution depend upon the material type.

Caveats

• A collision between two objects with restitution 1.0 will still not be perfectly elastic due to damping in the physics engine.

Examples

default
{
    touch_start(integer total_number)
    {
        list params = llGetPhysicsMaterial();
        llOwnerSay(
            "\nGravity multiplier: " + (string)llList2Float(params, 0) +
            "\nRestitution: " + (string)llList2Float(params, 1) +
            "\nFriction: " + (string)llList2Float(params, 2) +
            "\nDensity: " + (string)llList2Float(params, 3) + "kg/m^3"
        );
    }
}

See Also

Constants

•

PRIM_MATERIAL

Functions

•

llSetPhysicsMaterial

Deep Notes

Material Defaults

material Flags		Description				Friction	Restitution
PRIM_MATERIAL_STONE	0	stone				0.8	0.4
PRIM_MATERIAL_METAL	1	metal				0.3	0.4
PRIM_MATERIAL_GLASS	2	glass				0.2	0.7
PRIM_MATERIAL_WOOD	3	wood				0.6	0.5
PRIM_MATERIAL_FLESH	4	flesh				0.9	0.3
PRIM_MATERIAL_PLASTIC	5	plastic				0.4	0.7
PRIM_MATERIAL_RUBBER	6	rubber				0.9	0.9
PRIM_MATERIAL_LIGHT	7	light, DEPRECATED: Looks the same as [ PRIM_FULLBRIGHT, ALL_SIDES, TRUE ]						0.6	0.5

History

• Content taken from Release Notes/Second Life Server/11#11.09.23.241511
• Documentation expanded with information from Physics Material Settings test.

Date of Release 23/09/2011

Tests

•

Physics Material Settings test

Footnotes

1. ^ The default values for friction and restitution depend upon the prim's material.
2. ^ The ranges in this article are written in Interval Notation.

Signature
function list llGetPhysicsMaterial();