lvheq(3)

LIBRARY ROUTINE
lvheq - Performs histogram equalization of a BYTE grey-level image.

LIBRARY CALL
#include "vinclude.h"
int
lvheq(image,pneg)
struct xvimage *image;
int   pneg;

INPUT

image
    points to the input xvimage structure

pneg
    a flag set (equal 1) if a photonegative output is desired.

OUTPUT

image
    points to the xvimage structure that contains the result of the operation.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS
Replaced call to lvhremap with inline code. c.gage 2/25/91

DESCRIPTION
lvheq performs histogram equalization on the image pointed to by image. The result will be converted from photopositive to photonegative after the equalization if pneg is true.

Note that image is used for both the input xvimage structure and the resulting output xvimage structure. This is done to save space, but you must be careful not to overwrite important data.

SEE ALSO
vheq(1), intro(3), vipl(3), verror(3), vutils(3) lvhstr(3)

RESTRICTIONS
lvheq will not operate on any data type except VFF_TYP_1_BYTE.

AUTHOR
Scott Wilson

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