NewtonMaterialSetContactFrictionCoef

NewtonMaterialSetContactFrictionCoef

void NewtonMaterialSetContactFrictionCoef (const NewtonMaterial* material, dFloat staticFrictionCoef, dFloat kineticFrictionCoef, int index);

Usage

Override the default value of the kinetic coefficient of friction for this contact.

Parameters

• const NewtonMaterial materialHandle - pointer to a material pair.
• dFloat staticFrictionCoef - static friction coefficient. Must be positive.
• dFloat kineticFrictionCoef - Kinetic friction coefficient. Must be positive.
• int index - index to the tangent vector. 0 for primary tangent vector or 1 for the secondary tangent vector.

Return

• Nothing.

Remarks

• This function can only be called from a material callback event handler.

• The coefficient of friction usually should be less than or equal to 1.0; however, because some synthetic materials can have a friction coefficient that is greater than 1.0, Newton allows for the value to be as high as 2.0.

• the value for kinetic friction will be clamped between 0.01f (minimum friction value) and that of the current static friction. If the application wants to set a kinetic friction higher than the current static friction it must increase the static friction first.

See also

NewtonMaterialSetCollisionCallback NewtonMaterialSetDefaultFriction