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

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

ResizeGetSrcRoi

Computes the ROI of the source image for resizing by tile processing.

Syntax

Single precision

IppStatus ippiResizeGetSrcRoi_<mod>(const IppiResizeSpec_32f* pSpec, IppiPoint dstRoiOffset, IppiSize dstRoiSize, IppiPoint* srcRoiOffset, IppiSize* srcRoiSize);

Supported values for mod:

8u

16u

16s

32f

Double precision

IppStatus ippiResizeGetSrcRoi_64f(const IppiResizeSpec_64f* pSpec, IppiPoint dstRoiOffset, IppiSize dstRoiSize, IppiPoint* srcRoiOffset, IppiSize* srcRoiSize);

Processing images with platform-aware functions

IppStatus ippiResizeGetSrcRoi_L(const IppiResizeSpec* pSpec, IppiPointL dstRoiOffset, IppiSizeL dstRoiSize, IppiPointL* srcRoiOffset, IppiSizeL* srcRoiSize);

Include Files

ippi.h

Flavors with the _L suffix: ippi_l.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

pSpec

Pointer to the spec structure for the resize filter.

dstRoiOffset

Offset of the tiled destination image ROI.

dstRoiSize

Size of the tiled destination image ROI.

srcRoiOffset

Offset of the source image ROI.

srcRoiSize

Pointer to the size of the source image ROI.

Description

This function computes the ROI of the processed source image using the processed ROI of the destination image for the corresponding resize transform by tile processing. The pSpec parameter defines the resize algorithm parameters. Prior to using the ippiResizeGetSrcRoi function, you need to initialize the pSpec parameter by calling one of the following functions: ippiResizeNearestInit, ippiResizeLinearInit, ippiResizeCubicInit, ippiResizeLanczosInit, or ippiResizeSuperInit.

NOTE:

If the destination ROI size exceeds the image origin, the source ROI will be obtained for an intersection of the destination ROI and image origin.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error if one of the specified pointers is NULL.

ippStsContextMatchErr

Indicates an error if pointer to the spec structure is invalid.

ippStsOutOfRangeErr

Indicates an error if the destination image offset point is outside the destination image origin.

ippStsSizeWrn

Indicates a warning if the destination ROI exceeds the destination image origin.