Material

Material property providing physical attributes to a Shape.

Static Members #

Predefined constructor for a wood style Material.

Predefined constructor for a steel style Material.

Predefined constructor for a ice style Material.

Predefined constructor for a rubber style Material.

Predefined constructor for a glass style Material.

Predefined constructor for a sand style Material.

Instance Members #

@private

Dynamic object for user to store additional data.

This object cannot be set, only its dynamically created properties may be set. In AS3 the type of this property is &#42

This object will be lazily constructed so that until accessed for the first time, will be null internally.

@default {}

Set of all active shapes using this object.

Activeness of a shape in the sense that the Shape's Body is inside of a Space.

This list is immutable.

Elasticity of material.

This property may take any value. Coeffecients of elasticity are combined by taking their average, and then clamping to the range [0,1]. In this way you may give very large values (even infinites) to this property to bias the result of combining elasticities.

A combined, clamped value of 0 results in no bouncing whatsoever.
A combine, clamped value of 1 results in complete elasticity where if possible, the objects will not lose any energy at all.

@default 0.0

Coeffecient of dynamic friction for material.

This property may take any zero or positive value. Coeffecients of dynamicFriction are combined by taking the square root of their product.

The higher this value the more quickly objects will slow down from speed when sliding.

@default 1

Coeffecient of static friction for material.

This property may take any zero or positive value. Coeffecients of staticFriction are combined by taking the square root of their product.

The higher this value the more quickly objects will come to rest once moving very slowly, and the harder it will be to cause the objcet to begin to slide.

@default 2

Density of Shape's using this Material.

This property has units of g/pixel/pixel, not Kg/pixel/pixel for the simple reason that we get more reasonable values like 1 instead of 0.001 to attain reasonable mass values for Bodys.

@default 1

Coeffecient of rolling friction for circle interactions.

This property may take any zero or positive value. Coeffecients of staticFriction are combined by taking the square root of their product.

The higher this value, the more quickly a rolling circle - which would otherwise roll forever ignoring drag and numerical issues - will come to rest.

@default 0.01

Produce a copy of this Material object.

The copied object will be identical in all properties with the the copied userData being assigned the same fields as 'this' Shape with the same values copied over by reference for object types.

@private

Construct a new Material object.

Private Members #

Metadata #