/*
// Copyright 2015 2018 Intel Corporation All Rights Reserved.
//
// The source code, information and material ("Material") contained herein is
// owned by Intel Corporation or its suppliers or licensors, and title
// to such Material remains with Intel Corporation or its suppliers or
// licensors. The Material contains proprietary information of Intel
// or its suppliers and licensors. The Material is protected by worldwide
// copyright laws and treaty provisions. No part of the Material may be used,
// copied, reproduced, modified, published, uploaded, posted, transmitted,
// distributed or disclosed in any way without Intel's prior express written
// permission. No license under any patent, copyright or other intellectual
// property rights in the Material is granted to or conferred upon you,
// either expressly, by implication, inducement, estoppel or otherwise.
// Any license under such intellectual property rights must be express and
// approved by Intel in writing.
//
// Unless otherwise agreed by Intel in writing,
// you may not remove or alter this notice or any other notice embedded in
// Materials by Intel or Intel's suppliers or licensors in any way.
*/
// A simple example of the Spec structure initialization for warping of
// an arbitrary quadrangle in the source image to the quadrangle
// in the destination image using Intel(R) Integrated Primitives (Intel(R) IPP) functions:
// ippiWarpQuadGetSize
// ippiWarpQuadLinearInit
// ippiWarpGetBufferSize
// ippiWarpPerspectiveLinear_8u_C3R
#include <stdio.h>
#include "ipp.h"
#define WIDTH 640 /* Source image width */
#define HEIGHT 480 /* Destination image width */
/* Next two defines are created to simplify code reading and understanding */
#define EXIT_MAIN exitLine: /* Label for Exit */
#define check_sts(st) if((st) != ippStsNoErr) goto exitLine; /* Go to Exit if Intel(R) IPP function returned status different from ippStsNoErr */
static const double srcQuad[4][2] = /* Vertex coordinates of the quadrangle */
{
{ 0.0, 0.0 },
{ 8.0, 0.0 },
{ 6.0, 8.0 },
{ 2.0, 8.0 } };
static const double dstQuad[4][2] = /* Vertex coordinates of the quadrangle */
{
{ 0.0, 0.0 },
{ 8.0, 0.0 },
{ 6.0, 8.0 },
{ 2.0, 8.0 } };
/* Results of ippMalloc() are not validated because Intel(R) IPP functions perform bad arguments check and will return an appropriate status */
int main(void)
{
IppStatus status = ippStsNoErr;
Ipp8u* pSrc = NULL, *pDst = NULL; /* Pointers to source/destination images */
int srcStep = 0, dstStep = 0; /* Steps, in bytes, through the source/destination images */
IppiSize srcSize = { WIDTH, HEIGHT }, dstSize = { WIDTH, HEIGHT }; /* Size of source/destination ROI in pixels */
IppiInterpolationType interpolation = ippLinear;
IppiBorderType borderType = ippBorderTransp; /* Transparent border : destination image pixels mapped to the outer source image pixels are not changed. */
int specSize = 0, bufSize = 0; /* Size, in bytes, of the specification/temporary buffer structure */
IppiWarpTransformType warpTransformType = ippWarpPerspective;
IppiWarpSpec* pSpec = NULL; /* Pointer to the specification structure/work buffer */
Ipp8u* pBuffer = NULL;
IppiPoint dstOffset = { 0, 0 }; /* Offset of the destination image ROI with respect to the destination image origin */
int numChannels = 3;
pSrc = ippiMalloc_8u_C3(srcSize.width, srcSize.height, &srcStep);
pDst = ippiMalloc_8u_C3(dstSize.width, dstSize.height, &dstStep);
/* Spec and init buffer sizes */
check_sts( status = ippiWarpQuadGetSize(srcSize, srcQuad, dstSize, dstQuad, warpTransformType, ipp8u, interpolation, borderType, &specSize, &bufSize) )
pSpec = (IppiWarpSpec*)ippsMalloc_8u(specSize);
/* Filter initialization */
check_sts( status = ippiWarpQuadLinearInit(srcSize, srcQuad, dstSize, dstQuad, warpTransformType, ipp8u, numChannels, borderType, 0, 0, pSpec) )
check_sts( status = ippiWarpGetBufferSize(pSpec, dstSize, &bufSize) )
pBuffer = ippsMalloc_8u(bufSize);
/* Perform perspective transform of an image */
check_sts( status = ippiWarpPerspectiveLinear_8u_C3R(pSrc, srcStep, pDst, dstStep, dstOffset, dstSize, pSpec, pBuffer) )
EXIT_MAIN
ippsFree(pSpec);
ippsFree(pBuffer);
ippiFree(pSrc);
ippiFree(pDst);
printf("Exit status %d (%s)\n", (int)status, ippGetStatusString(status));
return (int)status;
}