vhremap(1)

PROGRAM
vhremap - Remaps an image according to a map.

SYNTAX

vhremap

-i1 input image

-i2 input map image

-o  resulting output image

[-V]
    Gives the version for vhremap

[-U]
    Gives the usage for vhremap

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vhremap.ans or file1

[-a [file1]]
    Uses vhremap.ans or file1 as the answer file

DESCRIPTION
vhremap remaps an image according to a map from another image. The new image data corresponds to the new mapping.

The new map is read from the second input image, and transferred to the first input image. The data from the first input image is then mapped through the new map. This is accomplished by calling "lvmapxfer()" and "lvmapdata()". The resulting image will have no maps associated with it, since the data is mapped through the map.

vhremap only works on data storage types of BYTE, SHORT, or INTEGER. The resulting image will be the type of the map (byte, short, long, float). This routine does not support map type COMPLEX.

The data and data type of the map image will be completely ignored. Only map schemes of One_Per_Band and Shared are allowd for the map image.

The routine will prescan the data to get the min and max for each data band and make sure that the min and max can map into the map(s). If the min and max cannot map into the map the routine will give an error message and quit.

If the map image has a map scheme of ONE_PER_BAND then the input image must have the same number of data bands as the map image, unless the input image has a map scheme of NONE and the map image has only 1 band.

The color space model for the input image will be set to the color space model of the extracting map image.

For a more detailed description of all the map combinations that are acceptable for transferring from the map image to the input image, see the man pages for "vmapxfer" and "vmapdata". This routine calls the routines "lvmapxfer" and "lvmapdata" to accomplish the remapping of the data.

REQUIRED ARGUMENTS

-i1 type: infile
    desc: input image

-i2 type: infile
    desc: input map image

-o  type: outfile
    desc: resulting output image

OPTIONAL ARGUMENTS
none

EXAMPLES
vhremap -i1 ball.xv -i2 histo.xv -o ball.remap.xv

This will remap the image "ball.xv" according to the map contained in the image "histo.xv". The image "histo.xv", must contain a map for remapping the image data of "ball.xv". The resulting output file contains the remapped image.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3) lvmapxfer(3), lvmapdata(3)

RESTRICTIONS
vhremap will complain if asked to operate on non-byte data storage type viff files.

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.