Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
WarpAffineLinearInit
Initializes the specification structure for image affine warping with the linear interpolation method.
Syntax
IppStatus ippiWarpAffineLinearInit(IppiSize srcSize, IppiSize dstSize, IppDataType dataType, const double coeffs[2][3], IppiWarpDirection direction, int numChannels, IppiBorderType borderType, const Ipp64f* pBorderValue, int smoothEdge, IppiWarpSpec* pSpec);
Include Files
ippi.h
Flavors with the _L suffix: ippi_l.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
Parameters
srcSize |
Size of the source image, in pixels. |
dstSize |
Size of the destination image, in pixels. |
dataType |
Data type of the source and destination images. Supported values: ipp8u, ipp16u, ipp16s, ipp32f, and ipp64f. |
coeffs |
Coefficients for the affine transform. |
direction |
Transformation direction. Supported values: * ippWarpForward - forward transformation * ippWarpBackward - backward transformation |
numChannels |
Number of channels in the image. Supported values: 1, 3, or 4. |
borderType |
Type of border. Supported values: * ippBorderConst - the outer pixels of the source image are set to the constant value; * ippBorderRepl - border is replicated from the edge pixels; * ippBorderTransp - outer pixels are not processed; * ippBorderInMem - border is obtained from the source image pixels in memory. |
pBorderValue |
Pointer to the constant value to assign to pixels of the constant border. This parameter is applicable only to the ippBorderConst border type. |
smoothEdge |
|
pSpec |
Pointer to the specification structure. |
Description
This function initializes the IppiWarpSpec structure for the ippiWarpAffineLinear function that performs warp affine transformation with the linear interpolation method. To compute the size of the specification structure, use the WarpAffineGetSize function.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
|
ippStsNoOperation |
Indicates a warning if width or height of any image is zero. |
ippStsSizeErr |
Indicates an error when width or height of the source or destination image is less than, or equal to one. |
ippStsDataTypeErr |
Indicates an error when dataType has an illegal value. |
ippStsWarpDirectionErr |
Indicates an error when direction has an illegal value. |
ippStsCoeffErr |
Indicates an error when affine transformation is singular. |
ippStsWrongIntersectQuad |
Indicates a warning that no operation is performed if the transformed source image extended with borders has no intersection with the destination image. |
ippStsNotSupportedModeErr |
Indicates an error when the requested mode is not supported. The edge smoothing feature is not supported for the ippBorderRepl and ippBorderConst border types. |
ippStsBorderErr |
Indicates an error when borderType has an illegal value. |
ippStsNumChannelsErr |
Indicates an error when numChannels has an illegal value. |
ippStsExceededSizeErr |
Indicates an error if width or height of the destination image or the source image exceeds 33554431 (0x1FFFFFF). |
See Also
WarpAffineGetSize Computes the size of the specification structure and the size of the external work buffer for the warp affine transform.