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.