Houdini 22.0 Nodes Copernicus nodes

UV Shape Copernicus node

Generates UV coordinates for common 2D shapes.

On this page
Since 22.0

This node generates a UV layer, UV filter scale, and mask for a selected procedural shape. Use the UV output with UV Sample COP to map an image into disks, squares, horseshoes, spirals, annuli, and fishscale patterns.

The UV values are generated in image coordinates, where the valid sampled range is generally -1 to 1.

Parameters

Shapes

The shape used to generate the UV coordinates and mask.

Disk

Generate UV coordinates inside a disk.

Square

Generate UV coordinates for a folded square tile.

Horseshoe

Generate UV coordinates for a horseshoe shape with a circular bend and straight arms.

Spiral

Generate UV coordinates along a spiral band.

Annulus

Generate UV coordinates inside a ring.

Fishscale

Generate UV coordinates for repeating fishscale-shaped tiles.

Mode

The mapping method to use for the disk shape.

Linear

Stretch the disk to fit the square UV range. This is inexpensive, but creates more distortion along diagonals.

Polar

Use the disk angle for U and radius for V.

Equal Area

Preserve relative area while mapping the disk into the square UV range.

Squircle

Use a squircle-based disk-to-square mapping with stable distortion near the axes.

Elliptic Arc

Use an elliptic-arc grid to map the disk into the square UV range.

Conformal

Preserve local angles as much as possible while mapping the disk into the square UV range.

Mode

The mapping method to use for the square shape.

Linear

Linearly map the folded square region into UV space.

Conformal

Use an angle-preserving mapping for the folded square region.

Fold

How many symmetric folds to use for the square tile.

2-fold

Use a two-way diagonal fold.

4-fold

Use four symmetric folded regions around the center.

Vertex

The orientation of the central top vertex of the image to use for the linear square mapping.

Top

Place the mapped vertex at the top.

Left

Place the mapped vertex on the left.

Flip Tile Orientation

Flips the orientation of the folded square tile.

Spiral Type

The type of spiral curve to use.

Archimedean

Use an Archimedean spiral, where the radius changes linearly with angle.

Log

Use a logarithmic spiral, where the radius changes exponentially with angle.

Loxodrome

Use a loxodrome-style spiral produced from a transformed logarithmic spiral by a Möbius transformation.

U Mode

How to compute the U coordinate along the spiral.

Angle

Base U on the angle parameter of the closest point on the spiral.

Arc Length

Base U on the arc length along the spiral.

Mode

The mapping method to use for the annulus.

Polar

Use angle for U and linear radius for V.

Log

Use angle for U and logarithmic radius for V.

Radius

The radius of the disk shape.

Fishscale

Mode

The method used to generate the fishscale pattern.

Offset

Generate fishscales from offset disk tiles on a grid.

Fill

Fill each fishscale cell by deforming a disk mapping into the fishscale shape.

Disk Mode

The disk mapping method to use inside each fishscale cell.

Linear

Stretch the disk to fit the square UV range.

Polar

Use disk angle and radius.

Eqaul-area

Preserve relative area while mapping the disk.

Squircle

Use a squircle-based disk-to-square mapping.

Elliptic Arc

Use an elliptic-arc grid mapping.

Conformal

Preserve local angles as much as possible.

Radius

The radius of the disk used to build the fishscale cells.

Center Blend

In Fill mode, the width of the blend region near the center singularity.

Center Blend Exponent

In Fill mode, shapes the blend near the center singularity.

Do Tiled

In Offset mode, rounds the grid scale so the fishscale pattern tiles cleanly.

Grid Scale

In Offset mode, the overall scale of the fishscale grid.

Grid Size Type

Controls whether the grid scale uses a single uniform value or separate per-axis scaling.

Per-Component Controls

Allows Grid Scale to scale the fishscale grid independently in each axis.

Grid Scale

When Per-Component Controls is on, this is the per-axis scale of the fishscale grid.

Horseshoe

Size

The radius of the centerline of the curved part of the horseshoe.

Separation

Controls how open the horseshoe is. Higher values increase the gap between the arms.

Length

The length of the straight arm regions.

Thickness

The half-width of the horseshoe band around its centerline.

U Adjust

Controls how much of the U range is assigned to the curved part of the horseshoe versus the straight arms.

Spiral Archimedean

Size

The radial spacing of the Archimedean spiral.

Start Radius

The radius where the Archimedean spiral starts.

Turns

The number of turns in the Archimedean spiral.

Thickness

The thickness of the UV band around the Archimedean spiral.

Spiral Log

Size

The growth rate of the logarithmic spiral.

Start Radius

The radius where the logarithmic spiral starts.

Turns

The number of turns in the logarithmic spiral.

Thickness

The thickness of the UV band around the logarithmic spiral.

Spiral Loxodrome

Size

Controls the spacing and growth of the loxodrome spiral.

Turns

The number of turns in the loxodrome spiral.

Thickness

The thickness of the UV band around the loxodrome spiral.

Negative Center

The negative center used by the loxodrome transform.

Positve Center

The positive center used by the loxodrome transform.

Annulus

Inner Radius

The inner radius of the annulus.

Outer Radius

The outer radius of the annulus.

Transform

Offset

Offsets the generated UV coordinates.

Angle

Rotates the generated UV coordinates, in degrees.

Shear

Shears the generated UV coordinates.

UV

UV Filter Bound

The maximum filter scale allowed in the uvscale output.

U Border

How to handle U values outside the -1 to 1 range.

Clamp

Clamp U to the nearest valid value.

Mirror

Mirror U about the boundary.

Wrap

Repeat U from the opposite side.

Extend

Leave U unchanged.

U Scale

Scales the generated U coordinates.

V Border

How to handle V values outside the -1 to 1 range.

Clmap

Clamp V to the nearest valid value.

Mirror

Mirror V about the boundary.

Wrap

Repeat V from the opposite side.

Extend

Leave V unchanged.

V Scale

Scales the generated V coordinates.

Inputs

size_ref

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

Outputs

uv

The generated UV coordinates.

uvscale

A filter scale factor for how stretched the UV values are. This can be used by UV Sample COP to choose an appropriate filter width.

mask

A Mono layer that is 1 inside the generated shape and 0 outside.

See also

Copernicus nodes