vrawtovx − Convert a raw image to VisionX format

vrawtovx [if=infile] [of=ofile] [b=<bounding-box>] [xy=x,[y]] [c=<n>] [-x] [-a] [-t]

Vrawtovx converts a raw data file to a VisionX image file. Unlike "vformat(1) -raw", vrawtovx can handle a single file with multiple images and can accept all pixel base formats. To get the image dimensions the bounding box must be explicitly specified; this can be done with the b= parameter or for single images the briefer xy= parameter may be used. No frame markers are inserted in the file for multiple images. To add frame markers pipe the result into vframe(1).

b=<bounding-box>

The full version of the bounding box is 6 integer numbers separated by commas (no spaces allowed), these numbers are xlo, xhi, ylo, yhi, zlo and zhi. For example, b=10,20,1,7,4,9 specifies 5 images with dimensions of 10x6 pixels. The zhi parameter can be omitted and will default to zlo + 1. the zlo parameter can be omitted and will default to 0.

xy=x[y]

specifies the bounding box for a single image of size x X x if just x is specified or x X y if both are specified. zhi is set to 1 and all lo parameters are set to 0. For example, a 512x512 image can be fully specified by xy=512.

f=

The f= parameter specifies the format of the input data. Possible formats are u (unsigned byte.. the default), c (signed byte), s (short int), i (integer... 32-bit), f (float), d (double), and b (bit).

c=n

The c= parameter specifies the number of channels in the file, the default is 1.

-a

specifies that the raw data file will be in ascii character form as a set of numbers separated by delimiters.

-t

Specifies that the raw data file will be in text (ascii) character form in which each line corresponds to an image row. The xy= and b= parameters are ignored. Note all lines in the file should contain the same number of numbers.

A. P. Reeves

vformat(1)