> tools

Voxelize

tools/voxelize·v1.3.0

IN:1 OUT:4

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

PAGEVoxelize

[+]Voxelize Mode	Voxelizemode	Determines whether to voxelize mesh geometry or point cloud data.
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.
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.
[+]Ray Direction	Raydir	Direction vector for ray casting when Ray Direction Mode is set to Custom Direction.
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.

PAGECommon

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