Houdini 21.0 Nodes Copernicus nodes

Copy and Transform Copernicus node

Copies stamps and applies transformations to the copies.

On this page
Since 21.0

This node creates copies of the input stamp and applies successive transformations to them. The transformations are cumulative and the original stamp isn’t transformed.

The original copy is included in the copy number. This makes it easier when you make more than one copy since you can specify the final number of objects instead of the number of copies.

Parameters

Signature

The layer type that the source accepts.

See Signatures for more information.

Total Number

The total number of copies to create. This includes the original geometry.

Order

The order in which Houdini applies the Translate, Rotate, and Scale values.

Translate

The location in world space to move the copies' origin to along the x and y axes.

Rotate

The amount of rotation (in degrees) along the z-axis.

Scale

The amount in world space by which to multiply the copies' x and y axes, which compresses (lower values) and stretches (higher values) the copies.

Uniform Scale

The amount by which to multiply the Scale parameter’s x and y values.

Center Pivot on Shape

Centers the pivot point in the bounds of the input stamp. This is useful when your input stamp isn’t in the center of the image.

Pivot Translate

The local pivot point of the copy.

For example, if the shape’s center point is -0.5x, set this parameter to -0.5 so the node acts like the point’s in the center. To do this automatically, turn Center Pivot on Shape on.

Pivot Rotate

The local pivot rotation (in degrees) of the copy, which rotates the pivot’s local coordinate frame.

Blend Method

When mulitple stamps overlap, this controls how they blend together.

Over

Render new copies over previous copies. The copies are presorted by their creation, which can be expensive.

Under

Render new copies underneath previous copies. The copies are presorted by their creation, which can be expensive.

Add

Add the overlapping pixel values of the stamps together.

Subtract

Subtract the original pixel value from the new overlapping stamp’s pixel value. This method works better when you're not subtracting from zero.

Multiply

Multiply the overlapping pixel values of the stamps together. This method works better when the background starts at a non-zero value.

Maximum

Compare the stamps along with the background color and use the maximum value.

Minimum

Compare the stamps along with the background color and use the minimum value.

Filter

The method used to sample the image.

See Filters for more information.

Wrap Mode

The wrapping behavior of the stamps.

Auto

Wrap copies outside of the main tile (whose size is controlled by Tile Size) back into the tile when the size_ref input image’s Border type is Wrap.

Off

Don’t wrap the stamps.

On

Wrap copies outside of the main tile (whose size is controlled by Tile Size) back into the tile. This makes the main tile seamlessly repeat.

Tile Size

When Wrap Mode is Auto or On, this is the size (in world space) of the region to wrap into. The resultant image periodically repeats in this size.

Stamping

Stamp Color

A tint for the stamp.

Change per Copy

A variable tint for the stamp, which can cause a color change for each copy. This is an additive, not a multiplier.

For example, a change of [R: 0.1, G: 0.2, B: 0.0] means that each copy becomes more red, but also becomes more green twice as fast.

Color Ramp

Applies a ramp over all copies and multiplies the ramp by the stamp’s color. When on, this turns Change per Copy off.

See Ramp parameters for more information.

Uniform Alpha

The amount of black (0) and white (1) by which to multiply the stamp’s Background Alpha.

Change per Copy

A variable scale for the stamp, which can create an alpha change for each copy. This is an additive, not a multiplier.

Alpha Ramp

Applies a ramp over all copies and multiplies the ramp by the stamp’s alpha. When on, this turns Change per Copy off.

See Ramp parameters for more information.

Background

Background Color

The initial background color of the space around the stamps.

Background Alpha

The initial background alpha of the space around the stamps.

Inputs

size_ref

A representative layer that determines the size of the output image and controls the metadata.

shape

The original layer that contains a stamp to copy and transform.

pointmask

An optional mask layer to select which copies stamp. A copy stamps if its location is in this mask, otherwise it doesn’t stamp.

Outputs

result

The layer with the resulting stamps applied.

id

The ID attribute of the stamp that contributed the most to this pixel or, if that attribute isn’t present, the point number.

uv

The UV coordinates of the stamp that contributed the most to this pixel. This is in image space.

See also

Copernicus nodes