Content-type: text/html Man page of mlib_ImageBlend1_Fp_Inp

mlib_ImageBlend1_Fp_Inp

Section: mediaLib Library Functions (3MLIB)
Updated: 2 Mar 2007
Index Return to Main Contents
 

NAME

mlib_ImageBlend1_Fp_Inp - blend with an alpha image  

SYNOPSIS

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

mlib_status mlib_ImageBlend1_Fp_Inp(mlib_image *src1dst,
    const mlib_image *src2, const mlib_image *alpha);

 

DESCRIPTION

The mlib_ImageBlend1_Fp_Inp() function blends two images together, in place, on a pixel-by-pixel basis using an alpha image, when alpha is also on a pixel basis. The alpha image can be a single-channel image or have the same number of channels as the source and destination images.

It uses the following equation when the alpha image is a single-channel image:

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

It uses the following equation when the alpha image has the same number of channels as the source and destination images:

src1dst[x][y][i] = alpha[x][y][i]*src1dst[x][y][i] +
                  (1 - alpha[x][y][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

Alpha image used to control blending. The pixels in this image should have values in the range of [0.0,1.0].

 

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 TYPEATTRIBUTE VALUE

Interface StabilityCommitted

MT-Level

 

SEE ALSO

mlib_ImageBlend(3MLIB), mlib_ImageBlend_Fp(3MLIB), mlib_ImageBlend1_Inp(3MLIB), mlib_ImageBlend2_Fp_Inp(3MLIB), mlib_ImageBlend2_Inp(3MLIB), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:57 GMT, October 02, 2010