
vmsquish(1)                  Khoros                   vmsquish(1)

PROGRAM
     vmsquish - Compress columns in map(s) to one column by means
     of Average, RMS or MAX

SYNTAX
     vmsquish

     -i             input image filename

     -o             output image filename

     [-m]           map data after squishing map

     [-t]           Specifies operation to use to squish map(s):
                    1 (Average),
                    2 (RMS),
                    or 3 (Maximum)
                       [default = 1]

     [-V]           Gives the version for vmsquish

     [-U]           Gives the usage for vmsquish

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vmsquish compresses the columns in map(s) to one column by
     means of Average, RMS or MAX. This routine will work on map
     schemes ONEPERBAND and SHARED. The optional argument -m
     specifies whether or not to map the data after squishing the
     map.  If mapping is to occur, the input image must have a
     storage type of BYTE. The resulting image will be the same
     data type as the map.

     The compression is done in one of three ways:

     1.   Compute the AVERAGE value for the elements in a map row
          and update the new 1 column map with that value.

     2    Compute the RMS value for the elements in a map row and
          update the new 1 column map with that value.

     3    find the MAXIMUM value of the elements in a map row and
          update the new 1 column map with that value.

     In all cases the element in the first column of the map is
     updated.

     This program is useful for sending images that have been
     grabbed off the screen to the laser printer. See EXAMPLES.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image filename

     -o     type: outfile
            desc: output image filename

OPTIONAL ARGUMENTS
     -m     type: boolean
            desc: map data after squishing map
            default: true

     -t     type: integer
            desc: Specifies operation to use to squish map(s)
            allowed values:
            1 (Average),
            2 (RMS),
            or 3 (Maximum)

EXAMPLES
     Squishing and mapping an image that is to be printed.

     vmsquish -i ball.xv.color -o ball.ready.to.print

     the -m and -t do not need to be specified since the defaults
     are set correctly.

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

RESTRICTIONS
     If the -m option is yes, the input image data storage type
     must be BYTE.

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

Khoros                    Release: 1.0                          1

