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

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

GetPerspectiveBound

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

Syntax

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

Include Files

ippi.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 perspective transform coefficients.

Description

This function operates with ROI (see ROI Processing in Geometric Transforms).

This function is used as a support function for the WarpPerspectiveNearest, WarpPerspectiveLinear, and WarpPerspectiveCubic functions. It computes vertex coordinates of the smallest bounding rectangle for the quadrangle quad, to which the source ROI is mapped by the perspective transform function using the given coefficients coeffs.

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.

ippStsSizeErr

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

ippStsCoeffErr

Indicates an error condition if coefficient values are invalid.