VPCLIPVisionX V4 NAME

vpclip − clip a region of a VisionX polygon file

SYNOPSIS

vpclip [if=<input_file>] [of=<output_file>] [xl=<x>] [xh=<x>] [yl=<y>] [yh=<y>] [zl=<z>] [zh=<z>] [-b] [-z] [-t] [-v]

DESCRIPTION

vpclip extracts a contiguous three-dimensional region of a VisionX 3D file that contains 3-D vectors polygons. A modified bounding box is specified by the parameters and all the data elements are clipped to fit into the modified bounding box. Three-D vectors other then triangles are deleted if any portion of them falls outside the new bounding box; triangle polygons are cut if they intersect the bounding box and may be split into two so that there is a clean edge to the cutting plane. If the -t flag is specified then triangles are considered as other vectors and are simply deleted if any vertex falls outside the cutting plane.

OPTIONS

if=

Input VisionX file

of=

Output VisionX file

xl=<value> Specify the low x coordinate of the modified bounding box.
xh=<value> Specify the high x coordinate of the modified bounding box.
yl=<value> Specify the low y coordinate of the modified bounding box.
yh=<value> Specify the high y coordinate of the modified bounding box.
zl=<value> Specify the low z coordinate of the modified bounding box.
zh=<value> Specify the high z coordinate of the modified bounding box.

-b

The -b clip the data but maintain the original bounding box.

-z

Translate the bounding box and the data so that the the lowest coordinate of the bounding box is 0,0,0

-t

The -t option specifies an operation in which the polygons not inside the bounding box are deleted instead of trimmed.

-v

The -v option specifies a verbose mode of operation in which some information is printed.

SEE ALSO

vclip(1)

AUTHOR

Winson Lin, May 2007