Legacy Documentation: Version 5.1
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Rigidbody.AddTorque

Switch to Manual
public function AddTorque(torque: Vector3, mode: ForceMode = ForceMode.Force): void;

Parameters

torque Torque vector in world coordinates.

Description

Adds a torque to the rigidbody.

Force can be applied only to an active rigidbody. If a GameObject is inactive, AddTorque has no effect.

Wakes up the Rigidbody by default. If the torque size is zero then the Rigidbody will not be woken up.

See Also: AddRelativeTorque, AddForce.

// Rotate an object around its Y (upward) axis in response to
// left/right controls.
var torque: float;
var rb: Rigidbody;

function Start() { rb = GetComponent.<Rigidbody>(); }

function FixedUpdate() { var turn = Input.GetAxis("Horizontal"); rb.AddTorque(transform.up * torque * turn); }

public function AddTorque(x: float, y: float, z: float, mode: ForceMode = ForceMode.Force): void;

Parameters

x Size of torque along the world x-axis.
y Size of torque along the world y-axis.
z Size of torque along the world z-axis.

Description

Adds a torque to the rigidbody.

Force can be applied only to an active rigidbody. If a GameObject is inactive, AddTorque has no effect.

Wakes up the Rigidbody by default. If the torque size is zero then the Rigidbody will not be woken up.