
vhsee(1)                     Khoros                      vhsee(1)

PROGRAM
     vhsee - Determine a visible histogram of the gray-levels in
     a byte type image.

SYNTAX
     vhsee

     -i             input image filename

     -o             output image filename

     [-p]           Chose between photonegative [False] and pho-
                    topositive [True]

     [-t]           Choose displayable format [False] or plotable
                    format [True]

     [-V]           Gives the version for vhsee

     [-U]           Gives the usage for vhsee

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vhsee constructs a viewable histogram for byte data storage
     type images.  The histogram is normally white on black.
     Black on white can be selected with the -p option.  The his-
     togram is formed as a 256x256 image.  The vertical axis is
     normalized so that the highest peak hits the top of the
     graph.

     The histogram can then be displayed using the xvdisplay
     utility for VIFF or XVPFF files.

     If -t 1 is selected, the histogram is output as an viff file
     suitable for xprism, the plotting utility. Inverting plot
     file histogram is not possible since the VW plotting rou-
     tines expect actual data.

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

     -o     type: outfile
            desc: output image filename

OPTIONAL ARGUMENTS
     -p     type: boolean
            desc: Chose between photonegative [False] and photo-
            positive [True]
            default: false

     -t     type: boolean
            desc: Choose displayable format [False] or plotable
            format [True]
            default: true

EXAMPLES
     vhsee -i input.image -o output.image -p 1 -t 1

     This example creates a viewable histogram of the grey-
     scales in byte type image input.image.  The output is named
     output.image and will have a black plot on a white back-
     ground.  It can be viewed using xprism2.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvhsee(3)
     vhisto(1)

RESTRICTIONS
     vhsee only works on storage type byte images.  vhsee only
     works on the acutual pixel values, not the intensity defined
     by the maps.

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

Khoros                    Release: 1.0                          1

