Intel® Integrated Performance Primitives Developer Guide and Reference

ID 790148
Date 11/07/2023
Public

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

Document Table of Contents

ResizeGetBufferSize

Computes the size of the external buffer for image resizing.

Syntax

Case 1: Single precision

IppStatus ippiResizeGetBufferSize_<mod>(const IppiResizeSpec_32f* pSpec, IppiSize dstSize, Ipp32u numChannels, int* pBufSize);

Supported values for mod:

8u

16u

16s

32f

Case 2: Double precision

IppStatus ippiResizeGetBufferSize_64f(const IppiResizeSpec_64f* pSpec, IppiSize dstSize, Ipp32u numChannels, int* pBufSize);

Case 3: Processing images with platform-aware functions

IppStatus ippiResizeGetBufferSize_L(const IppiResizeSpec* pSpec, IppiSizeL dstSize, Ipp32u numChannels, IppSizeL* pBufSize);

Case 4: Processing images with threading layer (TL) functions

IppStatus ippiResizeGetBufferSize_LT(const IppiResizeSpec_LT* pSpec, IppSizeL* pBufSize);

Include Files

ippi.h

Flavors with the _LT suffix: ippi_tl.h

Flavors with the _L suffix: ippi_l.h

Domain Dependencies

Flavors declared in ippi.h:

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

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

Flavors declared in ippi_tl.h:

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib, ippcore_tl.lib, ippi_tl.lib

Parameters

pSpec

Pointer to the spec structure for the resize filter.

dstSize

Size in pixels of the destination image.

numChannels

Number of channels, possible values: 1, 3, or 4.

pBufSize

Pointer to the size, in bytes, of the external buffer.

Description

This function computes the size of the external buffer for image resizing. The pSpec parameter defines the resize algorithm parameters. Prior to using the ippiResizeGetBufferSize function, you need to initialize the pSpec parameter by calling one of the following functions: ippiResizeNearestInit, ippiResizeLinearInit, ippiResizeCubicInit, ippiResizeLanczosInit, and ippiResizeSuperInit.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error if pBufferSize pointer is NULL.

ippStsNoOperation

Indicates a warning if width or height of the destination image is equal to zero.

ippStsContextMatchErr

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

ippStsNumChannelErr

Indicates an error if the value of numChannels is illegal.

ippStsSizeErr

Indicates an error condition If width or height of the destination image is negative.

ippStsSizeWrn

Indicates a warning if the destination image size is more than the destination image origin size.

ippStsExceededSizeErr

Indicates an error If at least one of the computed values exceeds maximum of IppSizeL type positive value (the size of one of the processed images is too large).