DepthToPosition

DepthToPosition takes depth data contained in an image file and the camera data to create a 2D position (xyz) pass. This pass is created by projecting the depth through the camera and recording the xyz positions of each projected point. The DepthToPosition node can be used together with the PositionToPoints node to create a point cloud, similar to the effect achieved with the DepthToPoints node.

Tip:  DepthToPosition's classic 3D system equivalent is the DepthToPosition node.

Inputs and Controls

Connection Type

Connection Name

Function

Input

camera

The 3D tracked camera that corresponds to the image input.

image

The image from which the position pass is generated, and where all the depth data resides.

Control (UI)

Knob (Scripting)

Default Value

Function

DepthToPosition Tab

Output

output

rgb

Specifies the channels the output position pass is put into, and includes the option to create a new layer for this purpose.

Depth

depth

depth.Z

Sets the channel from the image input from which you want to take the depth data.

Note:  The depth information must be in the 1/Z format, where depth is 1 divided by input depth. Nuke and RenderMan use this depth calculation by default.

Invert Depth

invert

off

Invert the depth before processing the depth pass image. If the data in the depth channel is in the Z format, rather than the required 1/Z format, you can enable invert depth to convert the depth data.

Far

far

10000

Specifies a value beyond which depth values from the camera are ignored when calculating the position pass.

Step-by-Step Guides

Creating a Position Pass Using the DepthToPosition Node