vdim − convert between different multidimensional formats

vdim [if=<infile>] [of=<outfile>] [f=<value>] [z=<value>] [-f] [-c] [-z] [-v]

Vdim converts between image sequence and three-dimensional image data formats. Image sequences are required to have the images separated by frame markers while 3D images do not require frame markers. Some VisionX applications only work correctly on one of these multi-image data formats so conversion is sometimes necessary. The -f flag causes file markers to be deleted and the -c flag causes new file markers (starting from 1) to be created.

By default, the z-values of the image bounding boxes are set to be consistent with the first frame number (starting at the frame marker value minus 1) and ascending in value for each image; this is the only action if neither -c or -f are specified. For -c they are set to start at the value of the first frame marker minus 1. Note, the default operation will convert the old 4-element bounding boxes into the current 6-element format.

The usual way to convert a set of images into the standard form is to use "vdim -c". In the previous version of vdim the convention was to start the z frame at one rather than zero. This obsolete behavior may be achieved if desired by the command "vdim f=1 z=1"

f=<value>

Specify the initial value for frame markers (default = 1) also sets -c flag.

z=<value>

set the z-values to be consecutive starting at the given value -c flag.

-f

Delete frame markers.

-c

create frame markers

-z

do not modify the z values of image bounding boxes.

-v

Set the verbose mode in which vdim reports its progress.

A. P. Reeves