Unprojects a point from the 2D pixel coordinate system of the renderer to the 3D world coordinate system of the scene.
- iOS 8.0+
- macOS 10.9+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
A point in the screen-space (view, layer, or GPU viewport) coordinate system of the scene renderer.
The corresponding point in the world coordinate system of the renderer’s scene.
The z-coordinate of the
point parameter describes the depth at which to unproject the point relative to the near and far clipping planes of the renderer’s viewing frustum (defined by its
point node). Unprojecting a point whose z-coordinate is
0 returns a point on the near clipping plane; unprojecting a point whose z-coordinate is
1 returns a point on the far clipping plane.
A 2D point in the rendered screen coordinate space can refer to any point along a line segment in the 3D scene coordinate space. To test for scene contents along this line—for example, to find the geometry corresponding to the location of a click event in a view—use the