iwiWarpAffine_InitAlloc
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. IfNULL, 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 theippBorderConstborder type and can beNULLfor other border types.
Description
This function allocates memory and initializes the internal data structure for the WarpAffine operation.
Return Values
- ippStsNoErr
- No errors.
- ippStsWarpDirectionErr
- Thedirectionvalue is illegal.
- ippStsCoeffErr
- Affine transformation is singular.
- ippStsInterpolationErr
- Theinterpolationvalue is illegal.
- ippStsDataTypeErr
- ThedataTypevalue is illegal.
- ippStsNumChannelsErr
- Thechannelsvalue is illegal.
- ippStsBorderErr
- Thebordervalue is illegal.
- ippStsNotSupportedModeErr
- Specified combination of parameters' values is not supported.
- ippStsNoMemErr
- Failed to allocate memory.
- ippStsSizeErr
- Values of thesrcSizeand/ordstSizefields are illegal.
- ippStsNullPtrErr
- ThepSpecpointer isNULL.
- 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.