Intel IPP Integration Wrappers Developer Guide and Reference

ID 751823
Date 1/18/2023
Public
Document Table of Contents

iwiResize_Process

Syntax

IW_DECL(IppStatus) iwiResize_Process(
    const IwiResizeSpec    *pSpec,    
    const IwiImage         *pSrcImage,
    IwiImage               *pDstImage, 
    IwiBorderType           border,
    const Ipp64f           *pBorderVal,
    const IwiTile          *pTile        
);

Parameters

pSpec

Pointer to the Resize internal specification structure.

pSrcImage

Pointer to the source image.

pDstImage

Pointer to the destination image.

border

Extrapolation algorithm for out of image pixels processing. Supported values:

ippBorderConst

Values of all border pixels are set to a constant.

ippBorderRepl

Border is replicated from the edge pixels.

ippBorderMirror

Border pixels are mirrored from the source image boundary pixels.

ippBorderInMem

Border is obtained from the source image pixels in memory.

pBorderVal

Pointer to an array of values to assign to pixels of the constant border, one element of the array for each channel of the image. This parameter is applicable only to the ippBorderConst border type and can be NULL for other border types.

pTile

Pointer to the IwiTile structure for tiling. If NULL, the whole image is processed.

Description

This function changes the size of the specified image ROI. The function requires initialization before usage.

This function supports the following features:

Feature Support
Internal threading Yes (check the IW_ENABLE_THREADING_LAYER definition)
Manual tiling Yes (if iwiResize_InitAlloc has been initialized for a full image, not a tile)
IwiTile simple tiling Yes
IwiTile pipeline tiling Yes

Return Values

ippStsNoErr

No errors.

ippStsBorderErr

The border value is illegal.

ippStsDataTypeErr

The dataType value is illegal.

ippStsNumChannelsErr

The channels value is illegal.

ippStsNotEvenStepErr

The srcStep and/or dstStep value is not divisible by size of elements.

ippStsInplaceModeNotSupportedErr

In-place operation is not supported: pSrc is equal to pDst.

ippStsNotSupportedModeErr

Specified combination of parameters' values is not supported.

ippStsNoMemErr

Failed to allocate memory.

ippStsNullPtrErr

The pSpec pointer is NULL.

ippStsNoOperation

Warning: width and/or height of the image is equal to zero.