Go to main content

man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2017
 
 

mlib_ImageMulShift (3MLIB)

Name

mlib_ImageMulShift - multiplication

Synopsis

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

mlib_status mlib_ImageMulShift(mlib_image *dst, const mlib_image *src1,
     const mlib_image *src2, mlib_s32 shift);

Description

The mlib_ImageMulShift() function multiplies the pixel values of the two source images. It scales the result by a right shift and writes the result to the destination image on a pixel-by-pixel basis.

It uses the following equation:

dst[x][y][i] = src1[x][y][i] * src2[x][y][i] * 2**(-shift)

Parameters

The function takes the following arguments:

dst

Pointer to destination image.

src1

Pointer to first source image.

src2

Pointer to second source image.

shift

Right shifting factor. 0 ≤ shift ≤ 31.

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_ImageMulShift_Inp(3MLIB), attributes(5)