vrend − generate an image from polygons

vrend [-H] [if=<infile>] [of=<outfile>] [sf=<file>] [-c] [-C] [-in] [-w] [-l] [-r] [-ss] [-hl] [-hp] [-hf] [-axy] [-az] [-iy] [-iz] [xy=] [z=] [bg=] [fi=] [li=] [-v] [-d]

Vrend generates a image from a set of 3-dimensional convex polygons. It uses the same render engine as v3d. The difference being that an image with a known scale rather than a visualization from a viewpoint is generated. By default, the image is generated with the size specified by the X and Y coordinates of the bounding box.

Similar to v3d, the boundaries of polygons are rendered as lines. Frequently, just the polygon surfaces are desired; use the -hl option to inhibit line rendering.

For multi-frame files an image is created for each frame. Vrend is a replacement for index images for vrender and vrendr. These older commands still provide some functions that are not yet implemented in vrend especially for range image and true color rendering.

By default, the background is set to 0, polygon faces are set to 128 and polygon edges are set to 255.

No annotation is provided, use vdraw to annotate the result. Only a single view direction (along the z-axis) is supported. Use vtrans to obtain other viewing directions. Only grey level images are currently created; use vcmap to add a color map.

-in

render an index image. Render each polygon with index values for boundary and fill values.

-w

render a wireframe image. By default all polygon boundaries are shown if the -hl option is specified then only visible surface boundaries are rendered.

-l

render a lightmodel image. Pixel intensities indicate surface reflected light from a light source located close to the viewer.

-r

render a range image, pixel intensities correspond to the distance from viewer. High pixel values indicate close to viewer.

-c

True Color rendering; this may only be used when truecolor values are available for each polygon. All other rendering functions are disabled.

-C

clamps the shading so colors are rendered at original intensities when used with the -c option -ss render a slice of a 3D image; this image must be specified with the sf= parameter. Polygons in infile specify the image slices.

sf=

3D image file for slice rendering

xy=size[,ysize]

The output image size defaults to the size of the bounding box; however, this may be set to be a different value, size, by specifying the xy= parameter. A different value for the y dimension may be specified with the optional ysize parameter The rendered image will be scaled to fit into the available space specified by the size parameters.

-hl

hide lines; by default polygon boundaries are rendered.

-hp

hide points; by default single points are rendered by a symbol.

-hf

hide fill; by default the central regions of polygons are rendered as opaque.

-axy

autoscale X and Y coordinates to fit the available display space.

-az

autoscale Z (only for -r) (in any case this is currently the default)

-iy

invert Y coordinate (i.e. set index origin to top left corner)

-iz

invert Z coordinate (i.e., view from the opposite direction)

bg=

background fill index value (default is zero)

fi=

default fill index value (default is 128)

li=

default line index value (default is 255)

st=

set the symbol type for points. Possible values are 0) a single point, 1) a circle and 2) a circle. Default is 0.

ss=

set the symbol size for types 1 and 2. Default is 5.

-v

set the verbose mode in which vrend reports its progress.

-d

debug mode (even more verbose than the verbose mode)

C. Zoulas, A.P.Reeves, J. I. Gorfajn

vdraw(1),vtrans(1),vrender(1)