Main Page   File List   Globals  

vconvert.c File Reference

vconvert - converts images from one pixel representation to another. More...


Detailed Description

vconvert - converts images from one pixel representation to another.

Description
vconvert converts Vista images to a specified pixel representation. The images are read from an input file, converted to the representation specified by the -repn com­ mand-line option, then written to an output file.
vconvert knows several ways of mapping input pixels to output pixels. You can choose the mapping you want by means of a -map command line option. If you don't specify that option, however, then you'll get a default mapping that is usually appropriate. The default mapping is one that retains an image's appearance as accu­ rately as possible -- i.e., a particular shade of gray in the input image will be mapped to nearly the same shade in the output image. Alternatively, you can use -map to specify some other mapping that may change the brightness or contrast of an image while converting it to its new representation.
The following describes, in some detail, the various mappings supported by vconvert. Here the full range of pixel values capable of being represented in the source image is denoted [Smin,Smax]; the actual range of pixel values present in the source image is denoted [Amin,Amax]; and the full range of pixel values capable of being repre­ sented in the destination image is denoted [Dmin,Dmax]. (For float and double pix­ els, the ranges [Smin,Smax] and [Dmin,Dmax] are taken to be [-1,+1].) Define Sabs = max ( |Smin|, |Smax| ), and similarly define Aabs. Then the various mappings sup­ ported by vconvert are: range | copy | opt1 | opt2 | op3 | linear.
Usage
vconvert
Parameters:
-in  Specifies one or more Vista data files containing images.
-out  output image
-repn  Specifies the pixel representation to which images should be converted( bit | ubyte | sbyte | short | long | float | double). Default: ubyte.
-map  Specifies the mapping of input pixel values to output pixel values (range | copy | opt1 | opt2 | op3 | linear). Default: range.
-a  Specify the values a and b to be used when -map linear is the chosen mapping.
-b  Specify the values a and b to be used when -map linear is the chosen mapping.
Examples

Known bugs
none.
Author:
Arthur Pope, UBC Laboratory for Computational Intelligence

Generated on Tue Nov 23 09:50:52 2004 for VIA - Volumetric Image Analysis by doxygen1.2.15