Integration Wrappers for Intel® Integrated Performance Primitives Developer Guide and Reference 2019

API Quick Reference Guide

  • 2020
  • 09/30/2019
  • Public Content
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.