IMAGE (kimage_proc) functions


LIBRARY ROUTINE

lidissolve - Dissolves an image.

LIBRARY CALL

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

INPUT

OUTPUT

RETURN VALUE

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

DESCRIPTION

This library routine dissolves or reverse the dissolution of an image. The alpha channel is scaled by the scaling factor. Scaling factors less than 1.0 will dissolve an image while factors greater than 1.0 will reverse dissolution. If KPDS_DATA_RANGE is not defined it will be defined.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

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

RESTRICTIONS

The scaling facor must be positive. If the input image does not have an alpha channel, an alpha channel of 1.0 will be created (and then scaled). The input image must have four channels (three if no alpha channel is supplied).

MODIFICATION

none

FILES

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

SEE ALSO

kimage_proc(3)

COPYRIGHT

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