Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
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).

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804