Primitives

Intel ® Integrated Performance Primitives Concepts 2
This notation means that the ippiDilate function has three flavors for a not-in-place operation, which
process 8-bit unsigned data (of Ipp8u type) and differ in the number of channels in processed images. These
flavors have the following prototypes:
IppStatus ippiDilate_8u_C1R(const Ipp8u* pSrc, int srcStep,
roiSize);
IppStatus ippiDilate_8u_C3R(const Ipp8u* pSrc, int srcStep,
roiSize);
IppStatus ippiDilate_8u_AC4R(const Ipp8u* pSrc, int srcStep,
IppiSize roiSize);
Ipp8u* pDst, int dstStep, IppiSize
Ipp8u* pDst, int dstStep, IppiSize
Ipp8u* pDst, int dstStep,
Thus, to obtain the full name and parameters list for the specific function flavor, not listed directly, do the
following:
1. Choose the function operation mode (denoted in this document as Case 1 , 2 and so on) and look in
the table for the supported data types and descriptors.
2. Set the mod field in the function name as the concatenation of the chosen data type and descriptor,
delimited by the underscore.
3. Use the respective template, substituting all the datatype fields in the parameters list with the chosen
data type. Note that Ipp prefix is written before the datatype in the parameters list (see Data Typesin
this chapter for details).
Example
To get the prototype for the ippiSet function flavor that sets each channel of a 3-channel destination image
to 16-bit signed values, choose Case 2: Setting each color channel to a specified value and use
datatype = 16s, descriptors = C3R.
After substituting the mod field with 16s_C3R, obtain the required prototype as
ippiSet_16s_C3R(const Ipp16svalue[3], Ipp16* pDst, int dstStep, IppiSize roiSize);
Rounding Mode
As many Intel IPP functions have to meet the bit-exact requirement, image processing functions use
rounding. The default rounding mode for all functions can be described as "nearest even", that is the fixed
point number x=N + α, 0 ≤α < 0, where N is an integer number, is rounded as given by:
For example, 1.5 is rounded to 2, and 2.5 to 2.
Some image processing functions have additional rounding modes, which are set by the parameter
roundMode.
Integer Result Scaling
The default for image processing functions is to saturate the results without scaling them.
Some image processing functions operating on integer data use scaling of the internally computed output
results by the integer scaleFactor, which is specified as one of the function parameters. These functions
have the Sfs descriptor in their names.
27