coarsen_refine

This node coarsens and/or refines a volume based on a property on the volume itself or a field.

Inputs

volume

The input volume.

field

A ScalarField used to coarsen and/or refine the volume. The field is interpreted as a (signed) distance field. Wherever the field is negative, the output volume will either be fully refined (if mode is Refine or CoarsenRefine) or retained (if mode is Coarsen). Wherever the field is positive, the output volume will either be gradually refined (if mode is Refine or CoarsenRefine) or retained (if mode is Coarsen) away from the zero-crossing of the (signed) distance field using the bandwidth parameter.

property

The name of a float property used to coarsen and/or refine the volume. If a non-empty field is connected, property is ignored. property is interpreted as a (signed) distance field similar to the field input.

mode

The mode used to coarsen and/or refine the volume. The following modes are supported:

• None Does not coarsen or refine the volume
• Coarsen Coarsens the volume
• Refine Refines the volume
• CoarsenRefine Both coarsens and refines the volume

bandwidth

The width of the band around the zero-crossing of the (signed) distance field where the volume is gradually refined. Measured in voxels at each adaptive level of the volume tile tree.

Outputs

out_volume

The output volume.