InverseTransformPoint
Transforms position from world space to local space.
Read time 2 minutesLast updated 5 days ago
Definition
- Type: Method
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
InverseTransformPoint(Vector3)
Transforms from world space to local space.
positionpublic Vector3 InverseTransformPoint(Vector3 position)
Parameters
Returns
Type | Description |
|---|---|
| Vector3 |
Remarks
This function is essentially the opposite of Transform.TransformPoint which is used to convert from local to world space.
Note that the returned position is affected by scale. Use Transform.InverseTransformDirection if you are dealing with direction vectors rather than positions.
If you need to transform many points at once consider using Transform.InverseTransformPoints instead as it is much faster than repeatedly calling this function.
// Calculate the transform's position relative to the camera.using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ public Transform cam; public Vector3 cameraRelative; void Start() { cam = Camera.main.transform; Vector3 cameraRelative = cam.InverseTransformPoint(transform.position); if (cameraRelative.z > 0) print("The object is in front of the camera"); else print("The object is behind the camera"); }}
Additional Resources:Transform.TransformPoint, Transform.InverseTransformPoints, Transform.InverseTransformDirection, Transform.InverseTransformVector.
InverseTransformPoint(float, float, float)
Transforms the position , , from world space to local space.
xyzpublic Vector3 InverseTransformPoint(float x, float y, float z)
Parameters
Returns
Type | Description |
|---|---|
| Vector3 |
Remarks
This function is essentially the opposite of Transform.TransformPoint which is used to convert from local to world space.
Note that the returned position is affected by scale. Use Transform.InverseTransformDirection if you are dealing with direction vectors rather than positions.
If you need to transform many points at once consider using Transform.InverseTransformPoints instead as it is much faster than repeatedly calling this function.
// Calculate the world origin relative to this transform.using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ void Start() { Vector3 relativePoint = transform.InverseTransformPoint(0, 0, 0); if (relativePoint.z > 0) print("The world origin is in front of this object"); else print("The world origin is behind this object"); }}