vcat − concatenate a set of VisionX files

vcat [if=infile] [of=ofile] [-p][-v][-f] [-3d] [ig=ifile2] [file-list]

Vcat concatenates a set of VisionX files and creates a single composite file. The file list may contain up to 1000 names if the system supports such a command line length.

Files are accessed in the order specified; however, the if= and ig= may be used to explicitly specify the first two files. To have the first file be standard input it is necessary to specify "if=". To have the second file be standard input it is necessary to specify "ig=".

Any VisionX files will be accepted as input. Pure text files are not currently processed correctly; in general the conventional cat command is more appropriate for these files

if=<fname>

This option will explicitly name the first file to be read.

ig=<fname>

This option will explicitly name the second file to be read.

-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.

-f

This option ensures that there is a frame marker (VS_FRAME) and an end of frame (VX_EFRAME) marker present at the start and end of every file read. Frame markers are added with sequential values starting at 1. If markers are already present this option has no effect.

-3d

This option assists in the management of 3D and 4D image files; i.e., files that contain multiple 3D images. Any frame markers within the input image files are deleted. New frame markers are added between the input files. In this way a file may be created which has a set of images between frame markers. A selected set of images may be extracted from such a file by using vclip with the f= option and frame markers may be restored to the extracted set of images by using vdim with the -f and -c options. In general, remember to also use the -p option for image files.

A. P. Reeves