IMAGE (kimage_proc) functions


LIBRARY ROUTINE

lidarken - Darkens or brightens an image.

LIBRARY CALL

int 
lidarken(kobject src_obj, kobject dst_obj, double factor)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

This library routine darkens or brightens an image. Scaling factors less than 1.0 darken an image while those greater than 1.0 are brightened. The first three channels of image data are scaled; the alpha channel is unchanged. If KPDS_DATA_RANGE is not defined it will be defined.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

If a factor greater than 1.0 is supplied, the output is not clipped.

RESTRICTIONS

The scaling factor must be positive. The input image must have at least three channels.

MODIFICATION

none

FILES

$IMAGE/objects/library/kimage_proc/src/lidarken.c

SEE ALSO

kimage_proc(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.