POPX

Voxelize

v1.3.0
Tools

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

Voxelize ModeVoxelizemode
Determines whether to voxelize mesh geometry or point cloud data.
MeshmeshPoint Cloudpointcloud
Max Axis ResolutionMaxaxisresolution
Maximum resolution along the longest axis of the voxel grid.
Lower BoundsLowerbounds
Minimum XYZ coordinates of the voxelization volume.
Lower BoundsLowerboundsxLower BoundsLowerboundsyLower BoundsLowerboundsz
Upper BoundsUpperbounds
Maximum XYZ coordinates of the voxelization volume.
Upper BoundsUpperboundsxUpper BoundsUpperboundsyUpper BoundsUpperboundsz
MarginMargin
Additional padding around the geometry bounds.
Get BoundsGetbounds
Automatically calculate bounds from input geometry.
Display BoundsDisplaybounds
Visualize the voxelization volume bounds as a bounding box.
Output VolumeOutputvolume
Outputs the volume representation of the voxelized geometry.
Output SurfaceOutputsurface
Outputs the surface shell of the voxelized geometry.
Surface ThresholdSurfacethreshold
Density threshold for extracting the surface shell from the volume.
Output SDFOutputsdf
Outputs a signed distance field representation of the voxelized geometry.
SmoothnessSmoothness
Smoothing amount applied to the voxelized result.
Ray Direction ModeRaydirmode
Method for determining ray directions when voxelizing meshes.
Axis AlignedaxisCustom Directioncustom
Ray DirectionRaydir
Direction vector for ray casting when Ray Direction Mode is set to Custom Direction.
Ray DirectionRaydirxRay DirectionRaydiryRay DirectionRaydirz
Point ScalePointscale
Scale multiplier for point size when voxelizing point clouds.
Enable Max Point CountEnablemaxpointcount
Limits the number of points processed when voxelizing point clouds.
Max Point CountMaxpointcount
Maximum number of points to process for point cloud voxelization.
Override if Color ExistsOverrideifexists
When enabled, uses the Color parameter instead of point color from the geometry.
ColorColor
RGB color applied to voxels.
ColorColorrColorColorgColorColorb
Density ScaleDensityscale
Multiplier for voxel density values.
Background ColorBgcolor
RGB color for empty voxel regions.
Background ColorBgcolorrBackground ColorBgcolorgBackground ColorBgcolorb
Background AlphaBgalpha
Alpha value for empty voxel regions.
BypassBypass
Pass through the first input to the output unchanged.
Free Extra GPU MemoryFreeextragpumem
Free memory that has accumulated when output memory has grown and shrunk.

Inputs

Input 0POP
POPX_in1

Outputs

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