int
lidissolve(kobject src_obj, kobject dst_obj, double factor)
INPUT
src_obj - Input image
factor - Scaling factor
OUTPUT
dst_obj - Output image
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).