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 photopositive [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 histogram 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 routines 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 photopositive [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 background. 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.