RigidBodyController::SetExternalForce

Defined in: C4Physics.h

Sets the external force acting on a rigid body.

Prototype

void SetExternalForce(const Vector2D& force);

void SetExternalForce(const Vector3D& force);

Parameters

force The new external force, in world-space coordinates.

Description

The SetExternalForce function sets the external force, in world-space coordinates, acting on a rigid body's center of mass to the force specified by the force parameter. The force is measured in kilonewtons (kN). If a 2D vector is specified, then the z coordinate of the force is zero.

Once an external force is established, it is applied continuously until it is removed. The RigidBodyController::ApplyImpulse function can be used to exert a one-time instantaneous force on a rigid body.

The initial value of the external force is (0,0,0).