Houdini 22.0 Nodes Copernicus nodes

Geometry to Layer 2.0 Copernicus node

Converts a volume, VDB, or camera primitive into a layer or VDB.

On this page

This node converts volumes, VDBs, or camera primitives that are inside a geometry into layers or VDBs. 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. The node also imports the primitive attributes (minus the name attribute) as properties.

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, VDBs, or camera primitives from the incoming geometry and populates the Outputs with the volumes', VDBs', or camera primitives' names and data types. When a volume, VDB, or camera primitive doesn’t have a name attribute, Primitive Name is set to the volume’s, VDB’s, or camera primitive’s primitive number.

Outputs

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

The Set Imports from Geometry parameter creates a node output for each volume, VDB, or camera primitive.

Primitive Name

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

When blank, it looks for a volume, VDB, or camera primitive 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 or camera primitive can’t be found, fall back to the layer defined by the size_ref input and the Default Value parameter.

If the specified VDB cannot be found, fall back to the vdb_ref input.

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, VDBs, or camera primitives 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.

vdb_ref

The VDB topology to use for VDBs that have the Optional parameter on and are missing from the source. This topology will be copied into the output (activation masks, size, etc). If different type it is reset to zero values, otherwise unchanged.

NOTE: The fall back is not densified even if Densify VDBs is set. Pre-densify if that is needed.

Outputs

output#

The layer type that consists of the converted volumes, VDBs, or camera primitives. The amount of node outputs and their details are based on the Outputs information. If the volume, VDB, or camera primitive 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