> fields

Voxelize

fields/voxelize·v1.5.1

IN:1 OUT:1

SUMMARY

The Voxelize operator cuts a box around its input into voxels and outputs a grid with one point per voxel carrying Weight and Color, plus optional Dist (signed distance), Gradient (the surface normal) and Velocity. A closed mesh is filled by rasterizing its triangles or by ray tracing, while a point cloud is splatted as soft blobs that carry each point's color and motion.

Max Axis Resolution, Auto Compute Bounds and Margin set the grid, and Velocity follows a moving, spinning or scaling object, optionally with its changing shape. The output feeds the other field operators such as Field Fill, Combine Field, Field Measure and Field Render, or the Flow solver, and Output 3D Textures also provides the field as 3D textures.

PARAMETERS

PAGEVoxelize

[+]Voxelize Mode	Voxelizemode	Mesh voxelizes a closed triangle surface with an inside. Point Cloud splats each point as a soft blob.
[+]Technique	Technique	Rasterize works everywhere. Ray Trace gives exact distances but is slower and Windows only.
Max Axis Resolution	Maxaxisres	Number of voxels along the longest axis. The other axes follow the box proportions.
[+]Voxels Resolution	Voxelsres	Resolution for each axis, from Max Axis Resolution and the box proportions (read-only).
Auto Compute Bounds	Autobounds	When on, the box fits the input bounds every frame. When off, the box is set by hand and the field stays fixed.
[+]Bounds Size	Boundssize	Size of the voxelized box in world units, padded by Margin.
[+]Bounds Center	Boundscenter	Center of the box, in world units.
Margin	Margin	Padding around the box on every side, in world units.
Display Bounds	Displaybounds	Display the field box.
Display Voxels as Points	Displayvoxels	Enable showing the occupied voxels as points in the viewer.
Smoothness	Smoothness	In Raytrace mode, the distance over which density fades in from the surface. 0 gives a hard edge.
Surface Threshold	Surfacethreshold	In Ray Trace, the surface band width in world units. In Point Cloud, the Weight above which a cell is solid.
[+]Ray Direction Mode	Raydirmode	In Raytrace mode, Axis Aligned votes along six axes; Custom Direction casts one ray and needs a closed mesh.
[+]Ray Direction	Raydir	Sets the direction of the single ray cast to test if a voxel is inside or outside, when Ray Direction Mode is Custom Direction.
Point Scale	Pointscale	Splat radius of each point of a point cloud, in cells. 0.5 is one cell.
Override if Color Exists	Overrideifexists	When on, the Color parameter is used even if the input has a Color attribute.
[+]Color	Color	Voxel color used when the input has no Color attribute.
Weight Scale	Weightscale	Multiplies the Weight (density) of the voxels.
Multiply Color by Weight Scale	Multcolor	Whether to multiply Color by Weight Scale.
Compute SDF	Computesdf	Enable writing Dist, the signed distance to the surface, negative inside.
Compute Gradient	Computegradient	Whether to output Gradient, the unit normal of the distance field.
Compute Velocity	Computevelocity	Write Velocity from the change since the previous frame, in units per second.
[+]Velocity Mode	Velocitymode	Determines how Velocity is computed. Object Motion follows how the input moves; Object Motion + Shape also follows the surface deforming and needs Compute SDF.
Velocity Scale	Velocityscale	Multiplies the output Velocity.
Reset Velocity	Resetvelocity	Clears the velocity history so the next frame outputs zero.
Output 3D Textures	Output3dtextures	Whether to output one 3D texture per field attribute.

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 - Geometry

OUTPUTS

Output 0 POP - Field