ClipTest

ClipTest applies zebra stripes to all pixels outside a specified range. This can help you ensure that the input’s blackest blacks and whitest whites are visible on an intended display device. By default, ClipTest highlights any pixels that are outside the range from 0 to 1.

Note:  This node affects the final output and not just the Viewer.

See also Clamp.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The image sequence whose out-of-range pixels you want to highlight.

mask

An optional image to use as a mask. By default, the zebra stripes are 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

ClipTest Tab

channels

channels

rgba

The zebra stripes are only applied to these channels.

You can use the checkboxes on the right to select individual channels.

lower

lower

0

Highlight any pixels whose values are lower than this number.

upper

upper

1

Highlight any pixels whose values are higher than this number.

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 zebra stripes are 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 zebra stripes are 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.

(un)premult by

N/A

disabled

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

unpremult

none

The image is divided by this channel before being processed, and multiplied again afterwards.

If you are using premultiplied input images, you may want to check (un)premult by and select rgba.alpha here. This will simulate doing the clip test before the premultiplication was done. It is the same as adding an Unpremult node before this node and a Premult node after, but allows you to work faster if you’re only using one color correct node.

If you are using unpremultiplied input images, you should leave this set to none.

invert

invert_unpremult

disabled

Inverts the use of the (un)premultiply channel.

mix

mix

1

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