Intel IPP Integration Wrappers Developer Guide and Reference

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

iwiCopy

Syntax

typedef struct _IwiCopyParams
{
    int reserved;
} IwiCopyParams;
static IW_INLINE void iwiCopy_SetDefaultParams(
    IwiCopyParams *pParams
)
IW_DECL(IppStatus) iwiCopy(
    const IwiImage      *pSrcImage,
    IwiImage            *pDstImage,  
    const IwiImage      *pMaskImage, 
    const IwiCopyParams *pAuxParams,
    const IwiTile       *pTile        
);

Parameters

pSrcImage

Pointer to the source image.

pDstImage

Pointer to the destination image.

pMaskImage

Pointer to the mask image.

pAuxParams

Pointer to the auxiliary parameters structure. If NULL, default parameters are used.

pTile

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

Auxiliary Arguments

Argument Default Value Description

reserved

0

Reserved value

Description

This function copies image data from the source to destination image with masking.

If the mask image is NULL, the function performs regular copying. Otherwise, the function copies source image pixel values only if the corresponding values of the mask image pixels are non-zero.

This function supports the following features:

Feature Support
Internal threading No
Manual tiling Yes
IwiTile simple tiling Yes
IwiTile pipeline tiling Yes

Return Values

ippStsNumChannelsErr

Channels value is illegal.

ippStsDataTypeErr

Data type is illegal.

ippStsSizeErr

Values of the size fields are illegal.

ippStsNullPtrErr

At least one of the pointers (except pTile) is NULL.

ippStsNoErr

No errors.