man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2014
 
 

mlib_ImageSConvKernelConvert(3MLIB)

Name

mlib_ImageSConvKernelConvert - kernel conversion for separable convolution

Synopsis

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

mlib_status mlib_ImageSConvKernelConvert(mlib_s32 *ihkernel,
     mlib_s32 *ivkernel, mlib_s32 *iscale, const mlib_d64 *fhkernel,
     const mlib_d64 *fvkernel, mlib_s32 m, mlib_s32 n, mlib_type type);

Description

The mlib_ImageSConvKernelConvert() function converts a floating-point separable convolution kernel to an integer kernel with its scaling factor, which is suitable to be used in separable convolution functions.

Parameters

The function takes the following arguments:

ihkernel

Pointer to integer horizontal kernel.

ivkernel

Pointer to integer vertical kernel.

iscale

Scaling factor of the integer convolution kernel.

fhkernel

Pointer to floating-point horizontal kernel.

fvkernel

Pointer to floating-point vertical kernel.

m

Width of the convolution kernel. m must be an odd number larger than 1.

n

Height of the convolution kernel. n must be an odd number larger than 1.

type

The image type.

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_ImageSConv3x3(3MLIB), mlib_ImageSConv3x3_Fp(3MLIB), mlib_ImageSConv5x5(3MLIB), mlib_ImageSConv5x5_Fp(3MLIB), mlib_ImageSConv7x7(3MLIB), mlib_ImageSConv7x7_Fp(3MLIB), mlib_ImageConvKernelConvert(3MLIB), attributes(5)