iwiWarpAffine
iwiWarpAffine
Syntax
IW_DECL(IppStatus) iwiWarpAffine(
const IwiImage *pSrcImage,
IwiImage *pDstImage,
const double coeffs[2][3],
IwTransDirection direction,
IppiInterpolationType interpolation,
const IwiWarpAffineParams *pAuxParams,
IwiBorderType border,
const Ipp64f *pBorderVal,
const IwiTile *pTile
);
Parameters
- pSrcImage
- Pointer to the source image.
- pDstImage
- Pointer to the destination image.
- coeffs[2][3]
- Coefficients for the affine transform.
- direction
- Direction of the affine transformation .
- interpolation
- Interpolation method. Supported values areippNearest,ippLinear, andippCubic.
- pParams
- Pointer to the optional parameters structure. IfNULL, default parameters are used.
- 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.
- pTile
- Pointer to theIwiTilestructure for tiling. IfNULL, the whole image is processed.
Description
This function is a simplified version of the
iwiWarpAffine_Process
function without the specification structure and the need for initialization.This function supports the following features:
Feature | Support |
---|---|
Internal threading | No |
Manual tiling | No |
IwiTile simple tiling | Yes |
IwiTile pipeline tiling | No |
Return Values
- ippStsNoErr
- No errors.
- ippWarpDirectionErr
- Thedirectionvalue is illegal.
- ippCoeffErr
- The affine transformation is singular.
- ippStsInterpolationErr
- Theinterpolationvalue is illegal.
- ippStsDataTypeErr
- ThedataTypevalue is illegal.
- ippStsBorderErr
- Thebordervalue is illegal.
- ippStsNumChannelsErr
- Thechannelsvalue is illegal.
- ippStsNotEvenStepErr
- ThesrcStepand/ordstStepvalue is not divisible by size of elements.
- ippStsNotSupportedModeErr
- Specified combination of parameters' values is not supported.
- ippStsNoMemErr
- Failed to allocate memory.
- ippStsNullPtrErr
- At least one of the pointers (exceptpTileandpBorderVal) isNULL.
- ippStsSizeErr
- Values of thesrcSizeand/ordstSizefields are illegal.
- 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.