Houdini 21.0 Nodes Copernicus nodes

Geometry to Layer 2.0 Copernicus node

Converts a volume into a layer.

On this page

This node converts volumes that are inside a geometry into layers. If the volume is 3D, the node takes a slice of the volume along the axis (set by Slice), similar to what the Volume Slice SOP does.

Note

The Precision and Border parameters override the output’s precision and border types. The 8 option for Precision is only possible with integer volumes and ID layers.

For more information, see Default COP Network settings.

Parameters

Precision

The layer’s storage precision. This controls how many bytes of storage each channel of the layer requires. More bytes allow for larger integer values or more accuracy for floating point values, but require more memory.

8

The channel uses 8-bits and defaults to quarter-precision.

16

The channel uses 16-bits and defaults to half-precision.

32

The channel uses 32-bits and defaults to full-precision.

Border

The sampling behavior outside of the incoming layer’s boundaries. Automatically uses the layer’s border property.

See Border types for more information.

Slice

The plane to slice along when you convert a 3D volume.

XY Plane

Slice the volume along the X and Y axes.

YZ Plane

Slice the volume along the Y and Z axes.

ZX Plane

Slice the volume along the Z and X axes.

Densify VDBs

Active regions of VDBs with constant values are collapsed into tiles to use less memory. However, as the GPU can’t just-in-time unpack tiles; if one wants to do random writes the VDB has to be fully converted to leaves. This option will fully densify the VDB prior to converting.

NOTE: This will move the VDB back to the CPU, and possibly require a massive amount of memory, so care should be used.

Set Imports from Geometry

Imports the volumes from the incoming geometry and populates the Outputs with the volumes' names and data types. When a volume doesn’t have a name attribute, Primitive Name is set to the volume’s primitive number.

Outputs

The number of outputs for the node, which are the number of volumes from the incoming geometry to convert.

The Set Imports from Geometry parameter creates a node output for each volume.

Primitive Name

The name of the volume to convert. You can also set this to a primitive index. Use the dropdown menu to set the volume’s data type.

When blank, it looks for a volume with a primitive number that corresponds to the multiparm index. For example, the first multiparm index looks for primitive 0 by default.

Tip

Enter vel.* in Primitive Name and set its data type to RGB to collate volume triples (such as vel.x, vel.y, and vel.z) into a single RGB layer. This also works when slicing 3D volumes.

Optional

If the specified volume can’t be found, fall back to the layer defined by the size_ref input and the Default Value parameter.

Default Value

When Optional is on for an ID, Mono, UV, RGB, or RGBA type, this is the value to use for the layer.

Inputs

geometry

The geometry with volumes to convert into a layer.

size_ref

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

Note

The node uses size_ref only for layers that have the Optional parameter on.

Outputs

output#

The layer type that consists of the converted volumes. The amount of node outputs and their details are based on the Outputs information. If the volume has no Primitive Name, the output name consists of output suffixed by the primitive number (in case the primitive number is 0, it’s incremented by 1).

Copernicus nodes