Code

Description

Example

AC4

The images have 4 channels, the fourth of which is the alpha channel. When identified in this way, the alpha channel will be excluded from the operation.

     ippiAddC_8u_AC4R, ippiMean_8u_AC4R

C1,C3,C4

The images have 1,3 or 4 channels of data interleaved in memory. C1, indicating one channel, can also be used for multiple images in most cases.

 ippiDCT8x8Fwd_16s_C1I, ippiRGBToYUV_8u_C3R

C2

The images have interleaved cannels in memory. This is a special case, in which frequently the second "channel" is itself two interleaved, subsampled channels. The sizes and other arguments, though, are based on a 2-channel image.

    ippiYCbCr422ToRGB_8u_C2C3R, ippiJoin422_8u_P3C2R

I

The operation is performed in place. The result of the operation is written back into the source, and one argument is both a source and a destination.
(default is not-in-place)

ippiDCT8x8Fwd_16s_C1I

M

The operation uses a mask to determine which pixels on which to operate.

ippiSet_8u_C1MR

P3, P4

The images have 3 or 4 channels of data arranged in separate planes; the operation takes an array of pointers to image planes.

ippiRGBToYCVCr420_8u_C3P3R

R

The function operates on a defined Rectangle of Interest (ROI) for each of the input images. Most image processing functions have this descriptor and use ROI

 
ippiSet_8u_C1MR

Sfs

The function scales the result of the operation, shifting it right by the scaleFactor argument. This shift generally takes place at a higher bit resolution to preserve precision.

ipiAddC_8u_AC4Sfs

 Parameter

Description

 Explanation  and Example

 pSrc
 pDst

Pointer to the source image ROI
Pointer to the destination image ROI
The datatype is <bit depth><bit interpretation>, mainly be 8u, 8s, 16u,16s, 32u,32s,32f, 64f.

1. pSrc != pDst (default)
pSrc and pDst usually point to different memory, unless in-place operation where I in function name.
2. pSrc point to the first data of memory space, can be adjust to any place (i,j) by pSrc+ srcStep/sizeof(datatype)*j+i*channel
3. ippi image pointer are align to various image file natually.  

Example 1: ippiDemo (Image Processing Demo)
// create new desitination image,  
CSampleDoc* pDst =CSampleDoc::CreateNewDoc(...)
ippiFunction(..., (Ipp8u*)pDst->DataPtr(), ...)
Example 2:  Using Intel® IPP with OpenCV 2.1 
IplImage* pDstImgCV= cvCreateImage(...)
ippiFunction(..., (Ipp8u*)pDstImgCV->imageData

srcStep
dstStep

step != imgROI.width*Channal*sizeof(datatype)
In most of case, they are equal. But sometimes, it is not, especially for bmp image and ippiMalloc, which required 4 bytes aligned and 32 bytes aligned correspondingly. there are padded zero at the end of row.
Example 1, RGB 8u 271x480, bmp image.
step= ((width*channels*sizeof(datatype))+3)>>2)<<2 = 816  ( not 3x271=813)
Example 2: Wrong step cause incorrect result or program crash randomly. See forum discussion U78264

roiSize

More often roiSize={imgWidth, imgHeight}
But it is actaully the width and height of ROI.
roiSize={roiWidth, roiHeight}. Combined with Pointer pSrc/pDst, it can locate the Region (Rectangle) of Interest.

Example 1: Processing an Image from Edge to Edge   
Example 2:  Upgrade Code Examples in IPP Book for Intel® Compiler and Intel® Parallel Studio

srcRoi

Region of interest in the source image

Declared in ippdefs.h file
typedef struct {
    int x;           int y;
    int width;      int height;
} IppiRect;
x, y denote the coordinates of the top left corner of ROI

More often roiSize={0, 0 imgWidth, imgHeight}
but it can locate the ROI exactly via specify the four values explicitly. The parameter are often used in ippi Geometric Transforms as locate src image ROI

Example 1,  ippiDemo.exe
on 512x512 RGB image and to resize the first quarter
IppiRect srcRoi = {0,srcHeight/2, srcWidth/ 2, srcHeight/2}; 
// x=0, y=128, 128x128, where orgin (0,0) is bottom-left of image
Example 2, ippiResizesqrPixel use independent systems of co-ordinates for srcROI and dstROI,  see forum discussion U65400