VFMT

VisionX V4
NAME

vfmt − change image format to VisionX format

SYNOPSIS

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

DESCRIPTION

Vfmt converts an image file (or a set of image files) in a standard image format into the VisionX image format. It is intended as a replacement for vformat and contains several extensions and simplifications to that progam. vfmt is currently under development and is not yet complete.

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. Vfmt will imported a directory of files in which the filenames ares first sorted and are to all be image files of the same type.

The format of the input file may be specified 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 Vfmt will attempt to guess the format first by examining the filename extension and then by running vqfile on the file to check for a magic number. 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.

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

OPTIONS

-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

NOT YET IMPELMENTED 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 directory containing 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

NOT YET IMPLEMENTED:The input file(s) have been compressed with compress.

-gz

NOT YET IMPLEMENTED:The input file(s) have been compressed with gzip

FILENAME OPTIONS SPECIFIC FORMATS

-tiff

convert a TIFF file

-gif

convert a GIF file

-jpeg

convert a jpeg image

-pict

convert a Macintosh PICT file

-png

convert a png image file

-rast

convert a Sun rasterfile

-xwd

convert a X11 or X10 window dump file

-xpm

convert an X11 pixmap

-yuv

NOT YET IMPLEMENTED: convert Abekas YUV bytes; requires x= and y= parameters

-ps

convert a PostScript file.

-raw

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

-rawc

NOT YET IMPLEMENTED: convert raw RGB bytes; requires x= and y= parameters.

-rawg

NOT YET IMPLEMENTED: 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>

NOT YET IMPLEMENTED: 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.

AUTHOR

A. P. Reeves

SEE ALSO

vmpegtovx(1), vxtopnm(1), vxto(1)