Houdini 22.0 Nodes Copernicus nodes

Align Copernicus node

Transforms a layer to align with another layer.

On this page
Since 22.0

This node performs a 2D transformation of one layer to line up with another reference layer.

Alignment is done by defining both a source rectangle and a target rectangle. The required translation and possible scale required to justify is computed and applied to the source layer.

Note

This transformation is done in world space, so pixel values are unchanged. To take effect, you should also do any merging in world space.

Parameters

Source

The definition of the source rectangle to use for alignment. See Data and display windows for more information.

Data Window

The data window is where pixels are actually present in the image. A cropped image or overscan image may not match the display window.

Display Window

The display window is the idealized location of the real screen and is independent of any overscan or cropping effects.

Justify with

The target to which the source is aligned.

Reference Data Window

The reference data window is the actual pixels of the reference. If you're trying to line up two crops, usually the data windows of each are used.

Reference Display Window

The display window is the idealized location of the real screen in the reference. Use this option to align to a position of the reference screen.

Target Point

Specify a specific point in the space of the reference layer.

Target

Units

The space in which to specify the target. This applies to the size_ref input, which is the reference layer.

Image

Use image coordinates that range from -1 to 1 on the display window of the layer.

Texture

Use texture coordinates that range from 0 to 1 on the data window of the layer.

Pixels

Use absolute pixel locations in the layer.

World

Use coordinates in world space that project through the layer’s implicit camera.

Target Point

The target point. The Units parameter determines if this is in image, texture, pixel, or world space.

Target Size

The target size. The Units parameter determines if this is in image, texture, pixel, or world space.

Matching

Justify X

The side of the source rectangle to use.

None

No movement on this axis.

Min

Align the minimum of the source rectangle.

Center

Align the center of the source rectangle.

Max

Align the maximum of the source rectangle.

Justify Y

The side of the source rectangle to use.

None

No movement on this axis.

Min

Align the minimum of the source rectangle.

Center

Align the center of the source rectangle.

Max

Align the maximum of the source rectangle.

Goal X/Y

The target side of the alignment.

Same

Align to the same side of the target that the source used, so minimum to minimum and center to center.

Min

The minimum of the target rectangle is the goal.

Center

The center of the target rectangle is the goal.

Max

The maximum of the target rectangle is the goal.

Offset by

An additional offset (in image space) from the computed alignment position.

Scale to Fit

Scales the layer so the source rectangle fits inside the target rectangle.

Uniform Scale

Scales uniformly in all axes.

Scale Axis

The axis to use to fit.

Scale X

Scales the x-axis to fit.

Scale Y

Scales the y-axis to fit.

Inputs

source

The source layer to align.

size_ref

An optional reference layer to align to.

Outputs

result

The source layer transformed to align with the specified target.

See also

Copernicus nodes