C4 Engine
C4 Engine API Documentation

RigidBodyController::SetRigidBodyMatrix3D

Defined in:  C4Physics.h
Sets the node rotation matrix for a rigid body.
Prototype

void SetRigidBodyMatrix3D(const Matrix3D& matrix);

Parameters
matrix The new node rotation matrix for the rigid body.
Description
The SetRigidBodyMatrix3D function sets the node rotation matrix for a rigid body. This function should be called instead of the Node::SetNodeMatrix3D function to change the node rotation matrix for any node under the control of a RigidBodyController.

The matrix specified by the matrix parameter must be right-handed and orthogonal.
WARNING. The SetRigidBodyMatrix3D function should not ordinarily be called to set the transform of a rigid body except in special circumstances, such as to set the initial transform of a newly created rigid body or to reinitialize the transform of a rigid body after it has been teleported to a new location. Otherwise, calling the SetRigidBodyMatrix3D function can interfere with the normal processing of the Physics Manager and cause graphical features such as motion blur not to render correctly for the rigid body.
See Also

RigidBodyController::SetRigidBodyTransform

RigidBodyController::SetRigidBodyPosition