ViewportToWorldPoint
Transforms position from viewport space into world space.
Read time 2 minutesLast updated 4 days ago
Definition
- Type: Method
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
ViewportToWorldPoint(Vector3, MonoOrStereoscopicEye)
Transforms position from viewport space into world space.
public Vector3 ViewportToWorldPoint(Vector3 position, Camera.MonoOrStereoscopicEye eye)
Parameters
Returns
Type | Description |
|---|---|
| Vector3 | The 3d vector in World space. |
Remarks
Viewport space is normalized and relative to the camera. The bottom-left of the viewport is (0,0); the top-right is (1,1). The z position is in world units from the camera.
Note that Camera.ViewportToWorldPoint transforms an x-y screen position into a x-y-z position in 3D space.
Provide the function with a vector where the x-y components of the vector are the screen coordinates and the z component is the distance of the resulting plane from the camera.
Examples
// Draw a yellow sphere at top-right corner of the near plane// for the selected camera in the Scene view.using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ void OnDrawGizmosSelected() { Camera camera = GetComponent<Camera>(); Vector3 p = camera.ViewportToWorldPoint(new Vector3(1, 1, camera.nearClipPlane)); Gizmos.color = Color.yellow; Gizmos.DrawSphere(p, 0.1F); }}
ViewportToWorldPoint(Vector3)
Transforms position from viewport space into world space.
public Vector3 ViewportToWorldPoint(Vector3 position)
Parameters
The 3d vector in Viewport space.
Returns
Type | Description |
|---|---|
| Vector3 | The 3d vector in World space. |
Remarks
Viewport space is normalized and relative to the camera. The bottom-left of the viewport is (0,0); the top-right is (1,1). The z position is in world units from the camera.
Note that Camera.ViewportToWorldPoint transforms an x-y screen position into a x-y-z position in 3D space.
Provide the function with a vector where the x-y components of the vector are the screen coordinates and the z component is the distance of the resulting plane from the camera.
Examples
// Draw a yellow sphere at top-right corner of the near plane// for the selected camera in the Scene view.using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ void OnDrawGizmosSelected() { Camera camera = GetComponent<Camera>(); Vector3 p = camera.ViewportToWorldPoint(new Vector3(1, 1, camera.nearClipPlane)); Gizmos.color = Color.yellow; Gizmos.DrawSphere(p, 0.1F); }}