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

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Complement

Converts pixel values from two's complement to binary representation.

Syntax

Case 1: Not-in-place operation

IppStatus ippiComplement_<mod>(Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize);

Supported values for mod:

8s_C1R

16s_C1R

32s_C1R

8s_C3R

16s_C3R

32s_C3R

8s_C4R

16s_C4R

32s_C4R

8s_AC4R

16s_AC4R

32s_AC4R

Case 2: In-place operation

IppStatus ippiComplement_<mod>(Ipp<datatype>* pSrc, int srcStep, IppiSize roiSize);

Supported values for mod:

8s_C1IR

16s_C1IR

32s_C3IR

8s_C3IR

16s_C3IR

32s_C3IR

8s_C4IR

16s_C4IR

32s_C4IR

8s_AC4IR

16s_AC4IR

32s_AC4IR

Include Files

ippi.h

Parameters

pSrc, pDst, pSrcDst

Pointers to the start of the array with the source image.

srcStep, dstStep, srcDstStep

Distances in bytes between starts of adjacent lines in the source image.

roiSize

Size of the image ROI in pixels.

Description

This function converts the value of each pixel from the two's complement representation to the binary representation. This function takes the data from pSrc and saves the result inpDst.

In-place functions convert the value of each pixel by rewriting the source data. These functions take the data from pSrcDst and saves the result inpSrcDst.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when any of the specified pointers is null.

ippStsSizeErr

Indicates an error when the value for the data size is incorrect.

ippStsStepErr

Indicates an error when step value is less than, or equal to zero.