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

ID 790148
Date 3/22/2024
Public
Document Table of Contents

ResizeAntialiasingCubicInit

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

Syntax

IppStatus ippiResizeAntialiasingCubicInit(IppiSize srcSize, IppiSize dstSize, Ipp32f valueB, Ipp32f valueC, IppiResizeSpec_32f* pSpec, Ipp8u* pInitBuf);

64f equivalent function

IppStatus ippiResizeAntialiasingCubicInit_64f(IppiSize srcSize, IppiSize dstSize, Ipp64f valueB, Ipp64f valueC, IppiResizeSpec_64f* pSpec, Ipp8u* pInitBuf);

Platform-aware function

IppStatus ippiResizeAntialiasingCubicInit_L(IppiSizeL srcSize, IppiSizeL dstSize, IppDataType dataType, Ipp32f valueB, Ipp32f valueC, IppiResizeSpec* pSpec, Ipp8u* pInitBuf);

Threading layer (TL) function

IppStatus ippiResizeAntialiasingCubicInit_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 of the source image, in pixels.

dstSize

Size of the destination image, in pixels.

valueB

The first parameter for cubic filters.

valueC

The second parameter for cubic filters.

numChannels

Number of image channels. Possible values: 1, 3, or 4.

dataType

Data type of the image. Supported values: ipp8u, ipp16u, ipp16s, ipp32f, ipp64f.

pSpec

Pointer to the specification structure for the resize filter.

pInitBuf

Pointer to the temporary buffer for initialization of the cubic filter.

Description

This function initializes the IppiResizeSpec_32f structure for the resize operation with antialiasing using interpolation with the two-parameter cubic filters. Note, that ippiResizeAntialiasingCubicInit_64f will initialize the IppiResizeSpec_64f structure.

Before using these functions, calculate the size of the temporary buffer and specification structure using the ippiResizeGetSize function with the antialiasing parameter equal to 1.

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.

ippStsExceededSizeErr

Indicates an error If width or height of the source or destination image exceeds 33554431 (0x1FFFFFF) (only for platform-aware and TL functions).

ippStsDataTypeErr

Indicates an error if dataType has an illegal value.

See Also