Go to main content

man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2017
 
 

mlib_ImageConstMulShift_Inp(3MLIB)

Name

mlib_ImageConstMulShift_Inp - multiply with a constant, with shifting

Synopsis

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

mlib_status mlib_ImageConstMulShift_Inp(mlib_image *srcdst,
     const mlib_s32 *c, mlib_s32 shift);

Description

The mlib_ImageConstMulShift_Inp() function multiplies each pixel in an image by a constant value on a pixel-by-pixel basis. 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:

srcdst[x][y][i] = c[i] * srcdst[x][y][i] * 2**(-shift)

Parameters

The function takes the following arguments:

srcdst

Pointer to source and destination image.

c

Constant by which each pixel is multiplied. c[i] contains the constant for channel i.

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_ImageConstMul(3MLIB), mlib_ImageConstMul_Fp(3MLIB), mlib_ImageConstMul_Fp_Inp(3MLIB), mlib_ImageConstMul_Inp(3MLIB), mlib_ImageConstMulShift(3MLIB), attributes(5)