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

GetTilePointer

Returns a pointer to the specified image tile.

Syntax

Case 1: Operation with TL functions based on the Platform Aware API

IppStatus ippiGetTilePointer_32f_LT(const Ipp32f* pSrc, Ipp32f** pDst, IppSizeL srcStep, IppSizeL x, IppSizeL y, Ipp32s numChannels);

IppStatus ippiGetTilePointer_64f_LT(const Ipp64f* pSrc, Ipp64f** pDst, IppSizeL srcStep, IppSizeL x, IppSizeL y, Ipp32s numChannels);

Case 2: Operation with TL functions based on the Classic API

IppStatus ippiGetTilePointer_32f_T(const Ipp32f* pSrc, Ipp32f** pDst, int srcStep, int x, int y, Ipp32s numChannels);

IppStatus ippiGetTilePointer_64f_T(const Ipp64f* pSrc, Ipp64f** pDst, int srcStep, int x, int y, Ipp32s numChannels);

Include Files

ippi_tl.h

Parameters

pSrc

Pointer to the source image.

pDst

Pointer to the memory location of the pointer to the destination image.

srcStep

Distance in bytes between consecutive lines in the source image.

x

x coordinate of a tile, in pixels.

y

y coordinate of a tile, in pixels.

numChannels

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

Description

This function returns a pointer to the specified image tile.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error condition when the pSrc or pDst pointer is NULL.

ippStsSizeErr

Indicates an error condition when x or y is less than zero.

ippStsNumChannelsErr

Indicates an error condition when numChannels has an illegal value.