mlib_ImageScalarBlend(3MLImediaLib Library Functiomlib_ImageScalarBlend(3MLIB)NAMEmlib_ImageScalarBlend - image blending with scalar
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageScalarBlend(mlib_image dst, const mlib_image *src1,
const mlib_image *src2, const mlib_s32 *alpha);
DESCRIPTION
The mlib_ImageScalarBlend() function blends the first and second source
images by adding each of their scaled pixels. 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:
dst[x][y][i] = a[i]*src1[x][y][i] + (1 - a[i])*src2[x][y][i]
PARAMETERS
The function takes the following arguments:
dst Pointer to destination image.
src1 Pointer to first source image.
src2 Pointer to second source image.
alpha Scalar blending factor. The a value equals (alpha *
2**(-31)). 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 ALSOmlib_ImageScalarBlend_Fp(3MLIB), mlib_ImageScalarBlend_Fp_Inp(3MLIB),
mlib_ImageScalarBlend_Inp(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007 mlib_ImageScalarBlend(3MLIB)