<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/HasPhysicsBody/addTorque(_:relativeTo:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation14HasPhysicsBodyPAAE9addTorque_10relativeToys5SIMD3VySfG_AA6EntityCSgtF"
  },
  "title" : "addTorque(_:relativeTo:)"
}
-->

# addTorque(_:relativeTo:)

Applies a torque to the physics body at its center of mass.

```
@MainActor @preconcurrency func addTorque(_ torque: SIMD3<Float>, relativeTo referenceEntity: Entity?)
```

## Parameters

`torque`

A torque in newton meters per radian.

`referenceEntity`

The reference entity that defines the coordinate
space in which `torque` is defined.

## Discussion

The physics simulator applies the added torque until the end of the
frame interval. To continue exerting the torque after that time, add the
torque again with another call to the method. Handle the
[`SceneEvents.Update`](/documentation/RealityKit/SceneEvents/Update) event to receive an indication of when the frame
interval ends. For an app that renders at 60 frames per second (fps),
this event occurs about once per 16 milliseconds.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)