Visible to Intel only — GUID: GUID-6A6BB374-0A2F-495E-B130-A1D858C345E0
Visible to Intel only — GUID: GUID-6A6BB374-0A2F-495E-B130-A1D858C345E0
GetPerspectiveQuad
Computes vertex coordinates of the quadrangle, to which the source ROI rectangle is mapped by the perspective transform.
Syntax
IppStatus ippiGetPerspectiveQuad(IppiRect srcRoi, double quad[4][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). |
quad |
Output array. Contains vertex coordinates of the quadrangle, to which the source ROI is mapped by the perspective transform function. |
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 quadrangle, to which the source rectangular ROI is mapped by the perspective transform function using the given coefficients coeffs.
The first dimension [4] of the array quad[4][2] is equal to the number of vertices, and the second dimension [2] means x and y coordinates of the vertex. Quadrangle vertices have the following meaning:
quad[0] corresponds to the transformed top-left corner of the source ROI,
quad[1] corresponds to the transformed top-right corner of the source ROI,
quad[2] corresponds to the transformed bottom-right corner of the source ROI,
quad[3] corresponds to the transformed bottom-left corner of the source ROI.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error. |
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. |