mlib_ImageScalarBlend_Fp_Inp(3MLIB)

Name

mlib_ImageScalarBlend_Fp_Inp - image blending with scalar

Synopsis

cc [ flag... ] file... –lmlib [ library... ]
#include <mlib.h>

mlib_status mlib_ImageScalarBlend_Fp_Inp(mlib_image *src1dst,
     const mlib_image *src2, const mlib_d64 *alpha);

Description

The mlib_ImageScalarBlend_Fp_Inp() 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 a, and the second source image is inverse scaled by (1 - a).

It uses the following equation:

src1dst[x][y][i] = a[i]*src1dst[x][y][i] +
                   (1 - a[i])*src2[x][y][i]

Parameters

The function takes the following arguments:

src1dst

Pointer to first source and destination image.

src2

Pointer to second source image.

alpha

Scalar blending factor. The a value equals alpha which should be in the [0.0, 1.0] range. alpha[i] contains the blending factor for channel i.

Return Values

The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level MT-Safe

See also

mlib_ImageScalarBlend(3MLIB), mlib_ImageScalarBlend_Fp(3MLIB), mlib_ImageScalarBlend_Inp(3MLIB), attributes(5)