ZSlice

This node uses the depth channel of the input to highlight a slice of the image characterized by the same Z depth. You can modify the slice using the Center of Slice and Field Width controls.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The input to select the Z slice from.

Note:  The input must contain a Z depth channel.

mask

An optional image to use as a mask. By default, the slice is limited to the non-black areas of the mask.

At first, the mask input appears as triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. If you cannot see the mask input, ensure that the mask control is disabled or set to none.

Control (UI)

Knob (Scripting)

Default Value

Function

ZSlice Tab

channels

channels

all

The effect is only applied these channels.

If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels.

Z

N/A

disabled

Enables the associated Z channel to the right. Disabling this checkbox is the same as setting the channel to none.

Zchan

none

The channel containing the Z depth information.

Center of Slice

center

0.5

Defines the center, or depth, of the slice within the image. High values are closer to the camera, and lower values further away.

Field Width

dof

0.1

Defines the width of the slice. Higher values highlight a thicker slice around the specified depth, and vice versa.

mask

N/A

disabled

Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none.

maskChannelInput

none

The channel to use as a mask. By default, the slice is limited to the non-black areas of this channel.

inject

inject

disabled

Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream.

invert

invert_mask

disabled

Inverts the use of the mask channel, so that the slice is limited to the non-white areas of the mask.

fringe

fringe

disabled

When enabled, only apply the effect to the edge of the mask.

When disabled, the effect is applied to the entire mask.

mix

mix

1

Dissolves between the original image at 0 and the full effect at 1.