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

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

ResizeLinearInit

Initializes the specification structure for image resizing with the linear interpolation method.

Syntax

IppStatus ippiResizeLinearInit_<mod>(IppiSize srcSize, IppiSize dstSize, IppiResizeSpec_32f* pSpec);

Supported values for mod:

8u

16u

16s

32f

IppStatus ippiResizeLinearInit_64f(IppiSize srcSize, IppiSize dstSize, IppiResizeSpec_64f* pSpec);

Platform-aware function

IppStatus ippiResizeLinearInit_L(IppiSizeL srcSize, IppiSizeL dstSize, IppDataType dataType, IppiResizeSpec* pSpec);

IppStatus ippiResizeLinearInit_8u_L(IppiSizeL srcSize, IppiSizeL dstSize, IppHintAlgorithm hint, IppiResizeSpec* pSpec);

Threading layer (TL) function

IppStatus ippiResizeLinearInit_LT(IppiSizeL srcSize, IppiSizeL dstSize, IppDataType dataType, Ipp32u numChannels, IppiResizeSpec_LT* pSpec);

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 toippAlgHintFast.

ippAlgHintFast

A faster but less accurate algorithm.

ippAlgHintAccurate

A slower but more accurate algorithm.

pSpec

Pointer to the specification structure for the resize filter.

numChannels

Number of channels. Possible values are 1, 3, and 4.

Description

This function initializes the specification structure for the resize algorithm with the linear interpolation method. To calculate the size of the specification structure, call the ippiResizeGetSize function.

NOTE:

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 or TL functions).

ippStsNumChannelErr

Indicates an error if numChannel has an illegal value.

See Also