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

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

GetAffineBound

Computes the bounding rectangle for the source ROI transformed by the ippiWarpAffine function.

Syntax

IppStatus ippiGetAffineBound (IppiRect srcRoi, double bound[2][2], const double coeffs[2][3]);

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

srcRoi

Region of interest in the source image (of the IppiRect type).

bound

Output array. Contains vertex coordinates of the bounding rectangle for the transformed source ROI.

coeffs

The given affine transform coefficients.

Description

This functionis used as a support function for WarpAffineNearest, WarpAffineLinear, and WarpAffineCubic functions. It computes vertex coordinates of the smallest bounding rectangle for the quadrangle quad, to which the source ROI is mapped by the affine transform function using coefficientscoeffs.

bound[0] specifies x, y coordinates of the top-left corner, bound[1] specifies x, y coordinates of the bottom-right corner.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsCoeffErr

Indicates an error condition if c00*c11 - c01*c10 = 0.

ippStsSizeErr

Indicates an error condition if srcRoi has a size field with zero or negative value.