Intel IPP Integration Wrappers Developer Guide and Reference

ID 751823
Date 1/18/2023
Public
Document Table of Contents

iwiWarpAffine_InitAlloc

Syntax

IW_DECL(IppStatus) iwiWarpAffine_InitAlloc(
    IwiWarpAffineSpec        **pSpec,          
    IwiSize                    srcSize,        
    IwiSize                    dstSize,        
    IppDataType                dataType,      
    int                        channels,      
    const double               coeffs[2][3],   
    IwTransDirection           direction,      
    IppiInterpolationType      interpolation,  
    const IwiWarpAffineParams *pAuxParams,       
    IwiBorderType              border,       
    const Ipp64f              *pBorderVal     
);

Parameters

pSpec

Double pointer to the WarpAffine specification structure to be initialized.

srcSize

Size of the source image, in pixels.

dstSize

Size of the destination image, in pixels.

dataType

Image pixel type.

channels

Number of image channels.

coeffs[2][3]

Coefficients for the affine transform.

direction

Transformation direction.

interpolation

Interpolation method. Supported values: ippNearest, ippLinear, ippCubic.

pAuxParams

Pointer to the WarpAffine optional parameters structures. If NULL, the function uses default parameters.

border

Extrapolation algorithm for out of image pixels processing. Supported values:

ippBorderConst

Values of all border pixels are set to a constant.

ippBorderRepl

Border is replicated from the edge pixels.

ippBorderTransp

Out of image pixels are not processed.

ippBorderInMem

Border is obtained from the source image pixels in memory.

pBorderVal

Pointer to an array of values to assign to pixels of the constant border, one element of the array for each channel of the image. This parameter is applicable only to the ippBorderConst border type and can be NULL for other border types.

Description

This function allocates memory and initializes the internal data structure for the WarpAffine operation.

Return Values

ippStsNoErr

No errors.

ippStsWarpDirectionErr

The direction value is illegal.

ippStsCoeffErr

Affine transformation is singular.

ippStsInterpolationErr

The interpolation value is illegal.

ippStsDataTypeErr

The dataType value is illegal.

ippStsNumChannelsErr

The channels value is illegal.

ippStsBorderErr

The border value is illegal.

ippStsNotSupportedModeErr

Specified combination of parameters' values is not supported.

ippStsNoMemErr

Failed to allocate memory.

ippStsSizeErr

Values of the srcSize and/or dstSize fields are illegal.

ippStsNullPtrErr

The pSpec pointer is NULL.

ippStsNoOperation

Warning: width and/or height of the image is equal to zero.

ippStsWrongIntersectQuad

Warning: transformed source image has no intersection with the destination image.