Voxelize

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. Optional blur filtering can smooth the resulting volume, and background colors can be set 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.
Upper Bounds Upperbounds – Maximum XYZ coordinates of the voxelization volume.
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.
Ray Direction Mode Raydirmode – – Method for determining ray directions when voxelizing meshes.
Constant constant
Inside Sphere insidesphere
Ray Direction Raydir – Direction vector for ray casting when Ray Direction Mode is set to Constant.
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.
Density Scale Densityscale – Multiplier for voxel density values.
Background Color Bgcolor – RGB color for empty voxel regions.
Background Alpha Bgalpha – Alpha value for empty voxel regions.
Enable Blur Enableblur – Applies blur filtering to smooth the voxelized volume.
Type Type – – Blur filter type.
Catmull-Rom catmull
Gaussian gaussian
Box box
Bartlette bartlette
Sinc sinc
Hanning hanning
Blackman blackman
Extend Extend – – Edge extension mode for blur filtering.
Hold hold
Repeat repeat
Mirror mirror
Pre-Shrink Preshrink – Resolution reduction before applying blur for performance optimization.
Filter Size Size – Size of the blur filter kernel.

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 – Voxel Volume
Output 1 POP – Hit Attributes