Intel® Integrated Performance Primitives Developer Guide and Reference

ID 790148
Date 11/07/2023
Public

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

Document Table of Contents

ToneMapLinear, ToneMapMean

Maps an HDRI image to the LDRI image.

Syntax

IppStatus ippiToneMapLinear_32f8u_C1R(const Ipp32f* pSrc, int srcStep, Ipp8u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiToneMapMean_32f8u_C1R(const Ipp32f* pSrc, int srcStep, Ipp8u* pDst, int dstStep, IppiSize roiSize);

Include Files

ippcc.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

pSrc

Pointer to the ROI in the HDRI source image.

srcStep

Distance in bytes between starts of consecutive lines in the source image.

pDst

Pointer to the ROI in the LDRI destination image.

dstStep

Distance in bytes between starts of consecutive lines in the destination image.

roiSize

Size of the source and destination ROI in pixels.

Description

They both operate with ROI (see Regions of Interest in Intel IPP).

These functions convert the source high dynamic range image (HDRI) pSrc into low dynamic range image (LDRI) pDst. Pixel values of the source image must be positive.

The function ippiToneMapLinear implements the Linear Scale-Factor method converting each source pixel pSrc[i] in accordance with the formula:

pSrc[i] = pSrc[i]/Lmax, Lmax = max{pSrc[i]}.

The function ippiToneMapMean implements the Mean Value method converting each source pixel pSrc[i] in accordance with the formula:

pSrc[i] = 0.5*pSrc[i]/Lave, Lave = average{pSrc[i]}.

If the value of Lmax or Lave is less than 0, then the function does not perform the operation and returns the warning message.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsNullPtrErr

Indicates an error condition if pSrc or pDst is NULL.

ippStsSizeErr

Indicates an error condition if roiSize has a field with a zero or negative value.

ippStsNoOperation

Indicates a warning if the values of Lmax or Lave are less than 0.