DATAMANIP (kdatamanip) functions
LIBRARY ROUTINE
lkhistops - perform histogram equalization and stretching
LIBRARY CALL
int lkhistops(
kobject in_obj,
char *function,
int invertflag,
int w, int h, int d, int t, int e,
kobject out_obj)
INPUT
- in_obj - object to be processed
- function - a string containing either "equalize" or "stretch"
- invertflag - if non-zero, invert greylevels after processing
w h d t
- e - flags that, if set, indicate that the processing
unit for independent histograms should include the
specified axis
OUTPUT
RETURN VALUE
TRUE (1) on success, FALSE (0) otherwise
DESCRIPTION
Perform histogram equalization and stretching with
optional inversion. Equalization occurs using the
standard algorithm.
Stretching is done between the
most negative data value (mapping to the most negative
value possible for the input data storage type) and the most
positive data value (mapping to the most positive value
possible for the input data storage type).
No span limits are applied, as was the case in the K1.5
vhstr routine.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
KBYTE (8-bit), KUBYTE(8-bit), KSHORT(16-bit), KUSHORT(16-bit) data only
MODIFICATION
21-July-94 Scott Wilson - Fixed incorrect behavior
caused by MAPPING_MODE being set after getting the
size attributes of the input object.
FILES
$DATAMANIP/objects/library/kdatamanip/src/lkhistops.c
SEE ALSO
kdatamanip(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.