Version: 2022.1
LanguageEnglish
  • C#

RigidbodyConstraints.FreezePositionZ

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Freeze motion along the Z-axis.

//This example shows how RigidbodyConstraints is used to freeze the position and rotation of a Rigidbody in the z axis at start-up.
//It also shows what happens when these constraints are removed, when you press the space key
//Attach this to a GameObject with a Rigidbody to see it in action

using UnityEngine;

public class Example : MonoBehaviour { Rigidbody m_Rigidbody; Vector3 m_ZAxis;

void Start() { m_Rigidbody = GetComponent<Rigidbody>(); //This locks the RigidBody so that it does not move or rotate in the z axis (can be seen in Inspector). m_Rigidbody.constraints = RigidbodyConstraints.FreezePositionZ | RigidbodyConstraints.FreezeRotationZ; //Set up vector for moving the Rigidbody in the z axis m_ZAxis = new Vector3(0, 0, 5); }

void Update() { //Press space to remove the constraints on the RigidBody if (Input.GetKeyDown(KeyCode.Space)) { //Remove all constraints m_Rigidbody.constraints = RigidbodyConstraints.None; }

//Press the right arrow key to move positively in the z axis if the constraints are removed if (Input.GetKeyDown(KeyCode.RightArrow)) { //If the constraints are removed, the Rigidbody moves along the z axis //If the constraints are there, no movement occurs m_Rigidbody.velocity = m_ZAxis; }

//Press the left arrow key to move negatively in the z axis if the constraints are removed if (Input.GetKeyDown(KeyCode.LeftArrow)) { m_Rigidbody.velocity = -m_ZAxis; } } }