vformat − (vx) change image format to VisionX format

vformat [if=infile] [of=ofile] [-v] [l=<value>] [h=<value>] [f=value] [e=<value>] [-g] [-c] [-vx] [-Z] [-gz] [-tiff] [-gif] [-jpeg] [-pict] [-rast] [-xwd] [-xpm] [-yuv] [-ps] [-raw] [-rawc] [x=<value>] [y=<value>] [-rawg] [gf=<value> [conv=<value>]

Vformat converts an image file (or a set of image files) in a standard image format into the VisionX image format.

Vx displays an image (or image set) in one of many standard image formats using xvx. It is equivalent to vformat with the -vx option set.

Image sequencies in many file formats (not VisionX) are often represented by a set of files in which the file names differ in a numeric field; vformat permits a sequence of files to be specified with the following syntax <prefix><numeric-field><extension>>

Filename sets are specified by if=<prefix> e=<extension> l=<first image number> h=<last image number>,

If the format of the input image file(s) is not explicitly specified then Vformat will attempt to guess the format first by running file on the file to check for a magic number and then by examining the filename extension. There are many file names and formats for which this cannot or will not work. Also some file formats (e.g. yuv and raw) may require the image dimensions to be explicitly specified on the command line. Many file formats may be explicitly specified by a command line parameter; see the "Specific FIle Format Options" below.

Vformat uses many conversion programs from the netpbm or pbmplus conversion package. This package must already be installed on the system.

-v

The verbose flag prints all the commands that would be issued with a given set of command line parameters but does not execute any of these commands.

-c

Do not preclear the destination file. That is, append the specified images to the end of the destination file if it already exists

if=<fname>

This option will explicitly name the input file or the prefix of a set of files

of=<fname>

This specifies the VisionX output file name.

-g

convert the data to greyscale image format even if the input data files contain color information. (some common image formats, such as jpeg and tiff, do not distinguish between grey and color images).

-Z

The input file(s) have been compressed with compress.

-gz

The input file(s) have been compressed with gzip

-vx

display the result using xvx instead of creating an output file.

e=<extension>

set the trailing part of the file-name to extension.

l=<value>

set the low (first) numeric value of the image sequence.

h=<value>

set the high (first) numeric value of the image sequence. The default is the same value as l=.

f=<size>

this option specifies that the numeric field should have a fixed format of <size> digits.

s=<number>

set the increment between file names, the default is one. This is useful for selecting a subset of the image files for example s=10 will select every tenth image.

-tiff

convert a TIFF file

-gif

convert a GIF file

-jpeg

convert a jpeg image

-pict

convert a Macintosh PICT file

-rast

convert a Sun rasterfile

-xwd

convert a X11 or X10 window dump file

-xpm

convert an X11 pixmap

-yuv

convert Abekas YUV bytes; requires x= and y= parameters

-ps

convert a PostScript file.

-raw

convert raw grayscale bytes; requires x= and y= parameters unless it is a quadratic? image.

-rawc

convert raw RGB bytes; requires x= and y= parameters.

-rawg

convert raw data; requires x= and y= parameters. This option uses vrawtovx(1) and allows for different base types to be specified with the gf= parameter. 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).

x=<value>

Specify the width of the image when necessary.

y=<value>

Specify the height of the image when necessary.

conv=<cmnd>

This option lets you specify a specific conversion program to use. The output of the conversion program should be in pnm, pgm or pbm format.

A. P. Reeves

mpeg2visx(1), visx2pnm(1), vxto(1)