'\" te
.\" Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved 
.TH mlib_ImageScalarBlend_Fp_Inp 3MLIB "2 Mar 2007" "SunOS 5.11" "mediaLib Library Functions"
.SH NAME
mlib_ImageScalarBlend_Fp_Inp \- image blending with scalar
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-lmlib\fR [ \fIlibrary\fR... ]
#include <mlib.h>

\fBmlib_status\fR \fBmlib_ImageScalarBlend_Fp_Inp\fR(\fBmlib_image *\fR\fIsrc1dst\fR,
     \fBconst mlib_image *\fR\fIsrc2\fR, \fBconst mlib_d64 *\fR\fIalpha\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBmlib_ImageScalarBlend_Fp_Inp()\fR function blends the first and second floating-point source images by adding each of their scaled pixels in place. The first source image is scaled by the scalar \fBa\fR, and the second source image is inverse scaled by \fB(1 - a)\fR.
.sp
.LP
It uses the following equation:
.sp
.in +2
.nf
src1dst[x][y][i] = a[i]*src1dst[x][y][i] +
                   (1 - a[i])*src2[x][y][i]
.fi
.in -2

.SH PARAMETERS
.sp
.LP
The function takes the following arguments:
.sp
.ne 2
.mk
.na
\fB\fIsrc1dst\fR\fR
.ad
.RS 11n
.rt  
Pointer to first source and destination image.
.RE

.sp
.ne 2
.mk
.na
\fB\fIsrc2\fR\fR
.ad
.RS 11n
.rt  
Pointer to second source image.
.RE

.sp
.ne 2
.mk
.na
\fB\fIalpha\fR\fR
.ad
.RS 11n
.rt  
Scalar blending factor. The \fBa\fR value equals \fBalpha\fR which should be in the \fB[0.0, 1.0]\fR range. \fBalpha[i]\fR contains the blending factor for channel \fBi\fR.
.RE

.SH RETURN VALUES
.sp
.LP
The function returns \fBMLIB_SUCCESS\fR if successful. Otherwise it returns \fBMLIB_FAILURE\fR.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
.TE

.SH SEE ALSO
.sp
.LP
\fBmlib_ImageScalarBlend\fR(3MLIB), \fBmlib_ImageScalarBlend_Fp\fR(3MLIB), \fBmlib_ImageScalarBlend_Inp\fR(3MLIB), \fBattributes\fR(5)