Unpin compositing node

Extracts an arbitrary quadrilateral area out of the input image.

All Parameters Local variables

See also: Pin

This operation allows you to extract an arbitrary quadrilateral area out of the input image and stretch it to fill the full resolution of the output. It is the opposite of corner pin.

Four points are used to define the desired area of the input image. Image data outside the desired area is discarded.

Scoping

This operation may be restricted to certain planes, or components of planes. In addition, the operation may be applied to a subset of frames within the sequence. An image must have both its frame and plane scoped to be modified.

Images that are not modified are passed through, which does not take any memory or processing time.

Masking

This operation may be masked, which restricts the operation to an area of the image. The mask may be inverted, brightened or dimmed.

The mask input is on the side of the node. The label on the connector indicates the plane being used as a mask.

The mask input can also be scaled to fit the output image’s resolution, if they differ. However, if this node changes more often than the mask input, it is faster to place a Scale COP in front of the mask input to do the resize, as the resize will not occur on every cook of this node.

In the viewport:

  1. click or press ((e)) (default hotkey) to edit the handles on the input image. The viewed image will change to that of the input.

  2. Adjust the handles by dragging them to the corners of the area you wish to unpin.

  3. You can Alt + click a handle to select it, or Alt + drag around handle to select them and move the selected handles as a group. Alt + click empty space to deselect the handles.

  4. click again or press 'e' to return to viewing the output of this node.

Note

Unpin will be temporarily bypassed while you select the input area. It will automatically un-bypass again when you finish selecting the area.

Parameters

UnPin

Units

Specifies the units of the point coordinates.

Bottom Left, Bottom Right, Top Left, Top Right

The four corner points of the input area.

Filter

The filter to use when scaling the image to fit the new area.

Local variables

L

Sequence length

S

Start of sequence

E

End of sequence

IL

Input sequence length

SR

Sequence frame rate

NP

Number of planes in sequence

W,H

Width and height of image

I

Image index (0 at start frame)

IT

Image time (0 at start frame)

AI

Current plane array index

PI

Current plane index

PC

Num of channels in current plane

CXRES

Composite Project X resolution

CYRES

Composite Project Y resolution

CPIXA

Composite Project pixel aspect ratio

CDEPTH

Composite Project raster depth

CBP

Composite Project black point

CWP

Composite Project white point

Usages in other examples

Example name Example for