Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

ConvGetBufferSize

Computes the size of the work buffer for the
ippiConv
function.

Syntax

IppStatus ippiConvGetBufferSize (IppiSize
src1Size
, IppiSize
src2Size
, IppDataType
dataType
, int
numChannels
, IppEnum
algType
, int*
pBufferSize
);
Include Files
ippi.h
Parameters
src1Size
,
src2Size
Size, in pixels, of the source images.
dataType
Data type for convolution. Possible values are
ipp32f
,
ipp16s
, or
ipp8u
.
numChannels
Number of image channels. Possible values are 1, 3, or 4.
algType
Bit-field mask for the algorithm type definition. Possible values are the results of composition of the
IppAlgType
and
IppiROIShape
values.
pBufferSize
Pointer to the size of the work buffer.
Description
The
ippiConvGetBufferSize
function computes the size, in bytes, of the external work buffer needed for the function that performs two-dimensional convolution. The result is stored in the
pBufferSize
parameter.
Return Values
ippStsNoErr
Indicates no error.
ippStsSizeErr
Indicates an error when the
src1Size
or
src2Size
is negative, or equal to zero.
ippStsNullChannelsErr
Indicates an error when the
numChannels
value differs from 1, 3, or 4.
ippStsDataTypeErr
Indicates an error when the
dataType
value differs from the
ipp32f
,
ipp16s
, or
ipp8u
.
ippStsAlgTypeErr
Indicates an error when:
  • the result of the bitwise AND operation between
    algType
    and
    ippAlgMask
    differs from the
    ippAlgAuto
    ,
    ippAlgDirect
    , or
    ippAlgFFT
    values;
  • the result of the bitwise AND operation between
    algType
    and
    ippiROIMask
    differs from the
    ippiROIFull
    or
    ippiROIValid
    values.
ippStsNullPtrErr
Indicates an error when the
pBufferSize
is NULL.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804