IMAGE (kimage_proc) functions


LIBRARY ROUTINE

licomposite - Compositing routine for images

LIBRARY CALL

int 
licomposite(kobject src1_obj, kobject src2_obj, kobject dst_obj, int flag)

INPUT

OUTPUT

RETURN VALUE

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

DESCRIPTION

This library function implements a variety of compositing routines for combining images as detailed by Thomas Porter and Tom Duff in "Compositing Digital Images", Computer Graphics, ACM, Vol. 18, 1984.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

Output is scaled between 0 and 1. If the datatype of the first source is double the datatype of the destination will be the same. Otherwise the datatype of the destination will be float in order to hold the scaled output.

RESTRICTIONS

If an input image does not have an alpha channel, this routine will create one with value of 1 (appropriate for a background image). Input images are required to have either four channels or three if no alpha channel is supplied. Masked or gated images currently are not supported.

MODIFICATION

none

FILES

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

SEE ALSO

kimage_proc(3)

COPYRIGHT

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