Legacy Documentation: Version 5.4
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 void AddTorque(Vector3 torque, ForceMode mode = ForceMode.Force);

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.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public float torque; public Rigidbody rb; void Start() { rb = GetComponent<Rigidbody>(); } void FixedUpdate() { float turn = Input.GetAxis("Horizontal"); rb.AddTorque(transform.up * torque * turn); } }

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

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.