Name

voxelize — Takes as input a primitive or a collection of primitives ,old_obj, and creates a region new_obj which is the collection of voxels(RPPs) approximating the old_obj.

Synopsis

voxelize [[-d] | {n}] [[-s] | { "%s %s %s"}] [[-t] | {f}] {new_obj old_obj} [old_obj1 old_obj2 ...]

DESCRIPTION

Takes as input a primitive or a collection of primitives ,old_obj, and creates a region new_obj which is the collection of voxels(RPPs) approximating the old_obj. The -d option specifies the level of detail(precision in approximation of volume) required. An argument of n means that n * n rays will be shot through each row, and an approximation of volume filled in each voxel region is reached averaging these n * n values. The -s option lets the user specify the voxel size in each direction. The -t option specifies the threshold volume to decide if voxel is to be included in the voxelized output. The threshold should always be a value between 0 and 1.

EXAMPLES

The following example shows the use of the voxelize command to create a voxelized version of an existing object (old_object) and naming the output(new_object).

Example 1. Create a voxelized version of an existing primitive or collection.

mged> voxelize -d 2 -s "0.5 0.5 0.5" -t 0.3 newregion.r oldregion.r

Creates a voxelized region corresponding to the original region oldregion.r.

The region newregion.r consists of the resulting voxels.

The -d 2 option means that on each voxel row, 2*2(=4) rays are uniformly shot over the area and an approximation of the volume is reached from the raytrace data of these four rays.

-s "0.5 0.5 0.5" sets the size of the voxels as 0.5 units (user's choice of units) in each dimension.

-t 0.3 means that a voxel region is considered to be "filled" if the approximated volume of oldregion.r filling this voxel region is 30% of its total volume.


AUTHOR

BRL-CAD Team

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.