Voxelize v1.2.1

Summary

Voxelize converts mesh or point cloud geometry into a 3D texture volume representation. This operator transforms traditional polygon-based geometry into a volumetric voxel grid, enabling volume rendering, simulation, and other volumetric effects.

The operator supports two modes: Mesh and Point Cloud. In Mesh mode, geometry is voxelized using ray casting techniques to determine interior/exterior regions. When voxelizing meshes, the Hit Attributes output provides ray casting hit information including attributes like RayHitNormal, RayNumHits, RayInside, and RayDistance, making it useful for advanced volume generation workflows. In Point Cloud mode, individual points are converted directly into voxel density values, with optional point count limits for performance optimization.

The voxelization process offers extensive control over resolution, bounds, colors, and density. You can define custom spatial bounds, adjust the maximum axis resolution, and control how colors are applied to the volume. Multiple output modes are available including volume, surface shell, and signed distance field representations, with adjustable smoothness and background colors for empty voxel regions.

Parameters

Page: Voxelize

Voxelize Mode Voxelizemode – – Determines whether to voxelize mesh geometry or point cloud data.
Mesh mesh
Point Cloud pointcloud
Max Axis Resolution Maxaxisresolution – Maximum resolution along the longest axis of the voxel grid.
Lower Bounds Lowerbounds – – Minimum XYZ coordinates of the voxelization volume.
Lower Bounds Lowerboundsx
Lower Bounds Lowerboundsy
Lower Bounds Lowerboundsz
Upper Bounds Upperbounds – – Maximum XYZ coordinates of the voxelization volume.
Upper Bounds Upperboundsx
Upper Bounds Upperboundsy
Upper Bounds Upperboundsz
Margin Margin – Additional padding around the geometry bounds.
Get Bounds Getbounds – Automatically calculate bounds from input geometry.
Display Bounds Displaybounds – Visualize the voxelization volume bounds as a bounding box.
Output Volume Outputvolume – Outputs the volume representation of the voxelized geometry.
Output Surface Outputsurface – Outputs the surface shell of the voxelized geometry.
Surface Threshold Surfacethreshold – Density threshold for extracting the surface shell from the volume.
Output SDF Outputsdf – Outputs a signed distance field representation of the voxelized geometry.
Smoothness Smoothness – Smoothing amount applied to the voxelized result.
Ray Direction Mode Raydirmode – – Method for determining ray directions when voxelizing meshes.
Axis Aligned axis
Custom Direction custom
Ray Direction Raydir – – Direction vector for ray casting when Ray Direction Mode is set to Custom Direction.
Ray Direction Raydirx
Ray Direction Raydiry
Ray Direction Raydirz
Point Scale Pointscale – Scale multiplier for point size when voxelizing point clouds.
Enable Max Point Count Enablemaxpointcount – Limits the number of points processed when voxelizing point clouds.
Max Point Count Maxpointcount – Maximum number of points to process for point cloud voxelization.
Override if Color Exists Overrideifexists – When enabled, uses the Color parameter instead of point color from the geometry.
Color Color – – RGB color applied to voxels.
Color Colorr
Color Colorg
Color Colorb
Density Scale Densityscale – Multiplier for voxel density values.
Background Color Bgcolor – – RGB color for empty voxel regions.
Background Color Bgcolorr
Background Color Bgcolorg
Background Color Bgcolorb
Background Alpha Bgalpha – Alpha value for empty voxel regions.

Page: Common

Bypass Bypass – Pass through the first input to the output unchanged.
Free Extra GPU Memory Freeextragpumem – Free memory that has accumulated when output memory has grown and shrunk.

Inputs

Input 0 POP – POPX_in1

Outputs

Output 0 TOP – Volume
Output 1 TOP – Surface
Output 2 TOP – SDF
Output 3 POP – Hit Attributes