Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

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 specified in pBorderValue.

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.

Mixed borders are also supported. They can be obtained by the bitwise operation OR between ippBorderTransp and the ippBorderInMemTop, ippBorderInMemBottom, ippBorderInMemLeft, ippBorderInMemRight values.

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

Flag for edge smoothing. Supported values:
  • 0 - transformation without edge smoothing.

  • 1 - transformation with edge smoothing. This feature is supported only for the ippBorderTransp and ippBorderInMem border types.

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

Indicates an error when:
  • one of the specified pointers is NULL, excepting pBorderValue

  • pBorderValue is NULL when border type is set to ippBorderConst

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