Rotation Constraint component
Constrain a GameObject's rotation to match one or more source objects.
Read time 2 minutesLast updated 20 days ago
A Rotation Constraint component rotates a GameObject to match the rotation of its source GameObjects.
Rotation Constraint component
Properties
Property | Description |
|---|---|
| Activate | After you rotate the constrained GameObject and its source GameObjects, click Activate to save this information. Activate saves the current offset from the source GameObjects in Rotation At Rest and Rotation Offset then enables Is Active and Lock. |
| Zero | Sets the rotation of the constrained GameObject to the source GameObjects. Zero resets the Rotation At Rest and Rotation Offset fields, then enables Is Active and Lock. |
| Is Active | Toggles whether or not to evaluate the Constraint. To also apply the Constraint, make sure Lock is enabled. |
| Weight | The strength of the Constraint. A weight of 1 causes the Constraint to rotate this GameObject at the same rate as its source GameObjects. A weight of 0 removes the effect of the Constraint completely. This weight affects all source GameObjects. Each GameObject in the Sources list also has a weight. |
Constraint Settings
Property: | Description |
|---|---|
| Lock | Enable to let the Constraint rotate the GameObject. Disable this property to edit the rotation of this GameObject. You can also edit the Rotation At Rest and Rotation Offset properties. If Is Active is enabled, the Constraint updates the Rotation At Rest or Rotation Offset properties for you as you rotate the GameObject or its Source GameObjects. When you are satisfied with your changes, enable Lock to let the Constraint to control this GameObject. This property has no effect in Play mode. |
| Rotation At Rest | The X, Y, and Z values to use when Weight is 0 or when the corresponding Freeze Rotation Axes is not enabled. To edit these fields, disable Lock. |
| Rotation Offset | The X, Y, and Z offset from the transform that is imposed by the Constraint. To edit these fields, disable Lock. |
| Freeze Rotation Axes | Enable X, Y, or Z to allow the Constraint to control the corresponding axes. Disable an axis to stop the Constraint from controlling it. This allows you to edit, animate, or script the unfrozen axis. |
Sources
The list of GameObjects that constrain this GameObject. Unity evaluates source GameObjects in the order they appear in this list. This order affects how this Constraint rotates the constrained GameObject. To get the result you want, drag items in this list. Each source has a weight from 0 to 1.