v3pol − convert image set to 3-D Polygons

v3pol [if=<inputfile>] [tf=<tablefile>] [of=<outputfile>] [m=<value>] [-id] [-r] [-t] [-tx] [-mc] [-pn] [-pl] [-s] [-p] [-z] [-v]

V3pol converts an image set to a 3-D polygon representation. This is used to obtain a graphical representation of a segmented 3-D region. Each interstitial space between 8 adjacent voxels is translated to a set of precomputed polygons read from a table file. By default, a standard table file of triangular polygons dervived from the marching cubes algorithm modified to prevent holes in the generated surface.

Only byte VisionX files will be accepted as input. False (background) is zero and True (foreground) is any other pixel value.

if=<fname>

Input image set.

tf=<fname>

This option will explicitly specify the conversion table file.

-r

This option produces a rectangular surface representation of the voxel data.

-t

This option selects a standard table which contains triangular polygons following the marching cubes algorithm, with modifications to eliminate the possibility of holes in the generated surface. This is accomplished by splitting several of the 15 canonical classes and adding polygons to prevent discontinuities. This table file contains triangles generated in a consistent system and will give correct curvature values. This is the default table if no options are specified.

-mc

This option selects a standard table which contains triangular polygons generated according to the marching cubes algorithm. This table file contains triangles generated in a consistent system and will give correct curvature values.

-tx

This option selects a standard table which contains only triangular polygons. Unlike the two table files above, this table does not give correct curvature values.

-pl

This option selects a standard table which contains only planar polygons.

-pn

This option selects a standard table which contains only non-planar polygons. This used to be the old default table.

-s

This option uses a buffered input method for image sequences. Useful for very long sequences.

-p

This option inhibits packing of the output; In general, this should be used when the files contain just images

-v

selects the verbose mode and prints some information about its action.

-id

By default each polygon has a unique id tag associated with it. This option inhibits the creation of these tags.

-z

This adds an generic integer tag to each polygon corresponding to its voxel neighborhood.

v3pfilt(1)

A. P. Reeves and W. J. Kostis