
vhremap(1)                   Khoros                    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 "vmap-
     data".  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.

Khoros                    Release: 1.0                          1

