Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

ResizeCubicInit

Initializes the specification structure for image resizing using interpolation with two-parameter cubic filters.

Syntax

IppStatus ippiResizeCubicInit_<mod>(IppiSize
srcSize
, IppiSize
dstSize
, Ipp32f
valueB
, Ipp32f
valueC
, IppiResizeSpec_32f*
pSpec
, Ipp8u*
pInitBuf
);
Supported values for
mod
:
8u
16u
16s
32f
Platform-aware functions
IppStatus ippiResizeCubicInit_L(IppiSizeL
srcSize
, IppiSizeL
dstSize
, IppDataType
dataType
, Ipp32f
valueB
, Ipp32f
valueC
, IppiResizeSpec*
pSpec
, Ipp8u*
pInitBuf
);
IppStatus ippiResizeCubicInit_8u_L(IppiSizeL
srcSize
, IppiSizeL
dstSize
, Ipp32f
valueB
, Ipp32f
valueC
, IppHintAlgorithm
hint
, IppiResizeSpec*
pSpec
, Ipp8u*
pInitBuf
);
Threading layer (TL) functions
IppStatus ippiResizeCubicInit_LT(IppiSizeL
srcSize
, IppiSizeL
dstSize
, IppDataType
dataType
, Ipp32u
numChannels
, Ipp32f
valueB
, Ipp32f
valueC
, IppiResizeSpec_LT*
pSpec
, Ipp8u*
pInitBuf
);
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
srcSize
Size, in pixels, of the source image.
dstSize
Size, in pixels, of the destination image.
dataType
Data type of the image. Supported values:
ipp8u
,
ipp16u
,
ipp16s
,
ipp32f
,
ipp64f
.
hint
Computation algorithm for processing
Ipp8u
data. Possible values are:
ippAlgHintNone
The hint is absent. Equivalent to
ippAlgHintFast
.
ippAlgHintFast
A faster but less accurate algorithm.
ippAlgHintAccurate
A slower but more accurate algorithm.
numChannels
Number of channels, possible values: 1, 3, or 4.
valueB
The first parameter for cubic filters.
valueC
The second parameter for cubic filters.
pSpec
Pointer to the specification structure for the resize filter.
pInitBuf
Pointer to the temporary buffer for the cubic filter initialization.
Description
This function initializes the specification structure for the resize algorithm with interpolation with two-parameter cubic filters. To calculate the size of the specification structure, call the
ippiResizeGetSize
function.
Before using this function, you need to calculate the size of the specification structure and the external buffer
pInitBuf
using the
ippiResizeGetSize
function for the corresponding flavor.
The function with the parameter
hint
allows users to choose between a faster but less accurate algorithm and a slower but more accurate one. Without the parameter
hint
this function initializes the specification structure for the faster but less accurate algorithm for
Ipp8u
data type.
Return Values
ippStsNoErr
Indicates no error.
ippStsNullPtrErr
Indicates an error when one of the specified pointers is
NULL
.
ippStsNoOperation
Indicates a warning when width or height of the image is equal to zero.
ippStsSizeErr
Indicates an error if:
  • width or height of the source or destination image is negative
  • the source image size is less than the size of a 2x2 linear filter
ippStsDataTypeErr
Indicates an error if
dataType
has an illegal value.
ippStsExceededSizeErr
Indicates an error If width or height of the source or destination image exceeds 33554431 (0x1FFFFFF) (only for platform-aware and TL functions).
ippStsNumChannelErr
Indicates an error if
numChannel
has an illegal value.

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