VAUTILVisionX V4
NAME
vautil − manage jiview annotation files
SYNOPSISvautil [if=infile] [of=ofile] [it=ibkfile] [ot=] [ib=] [ob=] [-c] [-a] [-u]
DESCRIPTIONVautil manages the creation and updating of annotation files used by vdview and other visionx utilities. An annotation file is comprised of two components: (a) a text data element that provides display information to the image viewers, and (b) a boundary that is specifed by a bounding box and a set of 3D vectors. The text data element is required while the boudary section is optional. The action performed by vautil depends upon the the specified parameters. The basic operation, when given parameters it=, ib= and of= is to construct an annotation file from a text file and a boundary file. Note, there is a text file version of the bookmark information that involves a non-visionx text format. The visionx standard extensioname for an annotation file is .vxa while the extensions for the text file and the boundary files are typically .bm (or .bmk) and .bb.
Vautil can be used to construct or update an annotation file or to extract elements from an annotation file.
CONSTAINTSNo known constraints.
OPTIONS|
if= |
input file, The input file is a valid .vxa file that is to be modified | ||
|
of= |
specify the name of the output annotation file | ||
|
it= |
specify the name of the text file. This will overwrite any text annotation already present in the if= file | ||
|
ib= |
the name of a boundary file to replace the existing boundary within the if= file, unless -a is specified | ||
|
ot= |
specify a file for the extracted text element (inhibits the regular annotation file output unless of= is explicitly specified) | ||
|
ob= |
specify a file for the extracted boundary file (inhibits the regular annotation file output unless of= is explicitly specified) | ||
|
-a |
append a boundary file to an annotation file | ||
|
-c |
create a text element and add to a boundary file (ib=) | ||
|
-u |
select the update mode (if= is an existing annotation file and will be modified; there must be no of=) |
A. M. Biancardi, A. P. Reeves