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]);

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

The function ippiGetPerspectiveBound is declared in the ippi.h file. It operates with ROI (see ROI Processing in Geometric Transforms).

This function is used as a support function for ippiWarpPerspective. 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 ippiWarpPerspective 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.