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

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.