Extract

Performs ROI extraction.

Syntax

Case 1: Vector operation

IppStatus ippmExtract_v_32f(const Ipp32f* pSrc, int srcStride2, Ipp32f* pDst, int len);

IppStatus ippmExtract_v_64f(const Ipp64f* pSrc, int srcStride2, Ipp64f* pDst, int len);

IppStatus ippmExtract_v_32f_P(const Ipp32f** ppSrc, int srcRoiShift, Ipp32f* pDst, int len);

IppStatus ippmExtract_v_64f_P(const Ipp64f** ppSrc, int srcRoiShift, Ipp64f* pDst, int len);

Case 2: Vector array operation

IppStatus, ippmExtract_va_32f(const Ipp32f* pSrc, int srcStride0, int srcStride2, Ipp32f* pDst, int len, int count);

IppStatus ippmExtract_va_64f(const Ipp64f* pSrc, int srcStride0, int srcStride2, Ipp64f* pDst, int len, int count);

IppStatus ippmExtract_va_32f_P(const Ipp32f** ppSrc, int srcRoiShift, int srcStride0, Ipp32f* pDst, int len, int count);

IppStatus ippmExtract_va_64f_P(const Ipp64f** ppSrc, int srcRoiShift, int srcStride0, Ipp64f* pDst, int len, int count);

IppStatus ippmExtract_va_32f_L(const Ipp32f** ppSrc, int srcRoiShift, int srcStride2, Ipp32f* pDst, int len, int count);

IppStatus ippmExtract_va_64f_L(const Ipp64f** ppSrc, int srcRoiShift, int srcStride2, Ipp64f* pDst, int len, int count);

Case 3: Matrix operation

IppStatus ippmExtract_m_32f(const Ipp32f* pSrc, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height);

IppStatus ippmExtract_m_64f(const Ipp64f* pSrc, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height);

IppStatus ippmExtract_m_32f_P(const Ipp32f** ppSrc, int srcRoiShift, Ipp32f* pDst, int width, int height);

IppStatus ippmExtract_m_64f_P(const Ipp64f** ppSrc, int srcRoiShift, Ipp64f* pDst, int width, int height);

Case 4: Transposed matrix operation

IppStatus ippmExtract_t_32f(const Ipp32f* pSrc, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height);

IppStatus ippmExtract_t_64f(const Ipp64f* pSrc, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height);

IppStatus ippmExtract_t_32f_P(const Ipp32f** ppSrc, int srcRoiShift, Ipp32f* pDst, int width, int height);

IppStatus ippmExtract_t_64f_P(const Ipp64f** ppSrc, int srcRoiShift, Ipp64f* pDst, int width, int height);

Case 5: Matrix array operation

IppStatus ippmExtract_ma_32f(const Ipp32f* pSrc, int srcStride0, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ma_64f(const Ipp64f* pSrc, int srcStride0, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height, int count);

IppStatus ippmExtract_ma_32f_P(const Ipp32f** ppSrc, int srcRoiShift, int srcStride0, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ma_64f_P(const Ipp64f** ppSrc, int srcRoiShift, int srcStride0, Ipp64f* pDst, int width, int height, int count);

IppStatus ippmExtract_ma_32f_L(const Ipp32f** ppSrc, int srcRoiShift, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ma_64f_L(const Ipp64f** ppSrc, int srcRoiShift, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height, int count);

Case 6: Transposed matrix array operation

IppStatus ippmExtract_ta_32f(const Ipp32f* pSrc, int srcStride0, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ta_64f(const Ipp64f* pSrc, int srcStride0, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height, int count);

IppStatus ippmExtract_ta_32f_P(const Ipp32f** ppSrc, int srcRoiShift, int srcStride0, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ta_64f_P(const Ipp64f** ppSrc, int srcRoiShift, int srcStride0, Ipp64f* pDst, int width, int height, int count);

IppStatus ippmExtract_ta_32f_L(const Ipp32f** ppSrc, int srcRoiShift, int srcStride1, int srcStride2, Ipp32f* pDst, int width, int height, int count);

IppStatus ippmExtract_ta_64f_L(const Ipp64f** ppSrc, int srcRoiShift, int srcStride1, int srcStride2, Ipp64f* pDst, int width, int height, int count);

Parameters

pSrc, ppSrc

Pointer to the source object or array of objects.

srcStride0

Stride between the objects in the source array.

srcStride1

Stride between the rows in the source matrix(ces).

srcStride2

Stride between the elements in the source object.

srcRoiShift

ROI shift in the source object.

pDst

Pointer to the specified destination object or array of objects.

len

Vector length.

width

Matrix width.

height

Matrix height.

count

Number of objects in the array.

Description

The function ippmExtract is declared in the ippm.h header file. The function extracts ROI from an object of any type to another object with specific properties.

When the operation is performed on vectors, the destination object is a dense vector or dense vector array.

When the operation is performed on matrices, the destination object is a dense matrix or a dense matrix array. The matrices involved in the operation must have the number of columns equal to width and the number of rows equal to height.

Note that if the operation is performed on a transposed matrix or an array of transposed matrices, the source matrices must have the number of columns equal to height and the number of rows equal to width.

Return Values

ippStsOk

Returns no error.

ippStsNullPtrErr

Returns an error when at least one input pointer is NULL.

ippStsSizeErr

Returns an error when the input size parameter is equal to 0.

ippStsStrideMatrixErr

Returns an error when the stride value is not positive or not divisible by size of data type.

ippStsRoiShiftMatrixErr

Returns an error when the roiShift value is negative or not divisible by size of data type.

ippStsCountMatrixErr

Returns an error when the count value is less or equal to zero.

Submit feedback on this help topic

Copyright © 2000 - 2010, Intel Corporation. All rights reserved.