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

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

GetBilinearQuad

Computes the vertex coordinates of the quadrangle, to which the source rectangular ROI is mapped by the bilinear transform.

Syntax

IppStatus ippiGetBilinearQuad(IppiRect srcRoi, double quad[4][2], const double coeffs[2][4]);

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 bilinear transform function.

coeffs

The given bilinear transform coefficients.

Description

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

This function is used as a support function for ippiWarpBilinear. It computes vertex coordinates of the quadrangle, to which the source rectangular ROI is mapped by the bilinear transform function ippiWarpBilinear using 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.