LlSetPhysicsMaterial

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

SetPhysicsMaterial

llSetPhysicsMaterial

Summary

Function: llSetPhysicsMaterial( integer mask, float gravity_multiplier, float restitution, float friction, float density );

	Forced Delay
	Energy

Used to set the physical characteristics of an object.

• integer	mask	–	bitwise combination of DENSITY, FRICTION, RESTITUTION, and GRAVITY_MULTIPLIER and specifies which floats to actually apply
• 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.

mask Flags	V	Description
DENSITY	1	Indicates that density parameter is enabled and will override the previous value.
FRICTION	2	Indicates that friction parameter is enabled and will override the previous value.
RESTITUTION	4	Indicates that restitution parameter is enabled and will override the previous value.
GRAVITY_MULTIPLIER	8	Indicates that gravity_multiplier parameter is enabled and will override the previous value.

Caveats

• A collision between two objects with restitution 1.0 will still not be perfectly elastic due to damping in the physics engine.
• Using PRIM_MATERIAL to set the material type will reset the values for friction and restitution to that material's defaults.

Examples

• Basic Example

     llSetPhysicsMaterial(FRICTION, 1.0,0.9,0.1,0.5); // Sets FRICTION to 0.1

• Multiple Settings

     llSetPhysicsMaterial(GRAVITY_MULTIPLIER | RESTITUTION | FRICTION | DENSITY, 0.5,0.9,0.1,1.0);

See Also

Constants

•

PRIM_MATERIAL

Functions

•

llGetPhysicsMaterial

Deep Notes

Material Defaults

Using PRIM_MATERIAL changes the the values for friction and restitution to the values listed for the material type.

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

llSetPhysicsMaterial cannot use these flags.

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 void llSetPhysicsMaterial( integer mask, float gravity_multiplier, float restitution, float friction, float density ); integer DENSITY = 1;//range 1.0 to 22587.0 (in kg/m^3), default: 1000.0 integer FRICTION = 2;//range 0.0 to 255.0, default values are in the range 0.2 to 0.9 integer RESTITUTION = 4;//range 0.0 to 1.0, default values are in the range 0.3 to 0.9 (note, a collision between two objects with restitution 1.0 will still not be perfectly elastic due to damping in the physics engine) integer GRAVITY_MULTIPLIER = 8;//range -1.0 to +28.0, default: 1.0