Developer Reference for Intel® Integrated Performance Primitives 2018
Mirrors an image about the specified axis (axes).
Case 1: Not-in-place operation
IppStatus ippiMirror_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, IppiAxis flip);
Supported values for mod:
8u_C1R |
16u_C1R |
16s_C1R |
32s_C1R |
32f_C1R |
8u_C3R |
16u_C3R |
16s_C3R |
32s_C3R |
32f_C3R |
8u_C4R |
16u_C4R |
16s_C4R |
32s_C4R |
32f_C4R |
8u_AC4R |
16u_AC4R |
16s_AC4R |
32s_AC4R |
32f_AC4R |
Case 2: In-place operation
IppStatus ippiMirror_<mod>(Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize, IppiAxis flip);
Supported values for mod:
8u_C1IR |
16u_C1IR |
16s_C1IR |
32s_C1IR |
32f_C1IR |
8u_C3IR |
16u_C3IR |
16s_C3IR |
32s_C3IR |
32f_C3IR |
8u_C4IR |
16u_C4IR |
16s_C4IR |
32s_C4IR |
32f_C4IR |
8u_AC4IR |
16u_AC4IR |
16s_AC4IR |
32s_AC4IR |
32f_AC4IR |
ippi.h
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
pSrc |
Pointer to the source buffer. | ||||||||||
srcStep |
Distance, in bytes, between the starting points of consecutive lines in the source image buffer. | ||||||||||
pDst |
Pointer to the destination buffer. | ||||||||||
dstStep |
Distance, in bytes, between the starting points of consecutive lines in the destination image buffer. | ||||||||||
pSrcDst |
Pointer to the source and destination buffer for the in-place operation. | ||||||||||
srcDstStep |
Distance, in bytes, between the starting points of consecutive lines in the source and destination image buffer for the in-place operation. | ||||||||||
roiSize |
Size of the destination ROI in pixels. | ||||||||||
flip |
Specifies the axis to mirror the image about. Use the following values to specify the axes:
|
The ippiMirror function operates with ROI (see Regions of Interest in Intel IPP). This function mirrors the source image pSrc about the axis (axes) specified by the value of the flip parameter and writes the result to the destination image pDst. Each function flavor can mirror an image about the horizontal or vertical axis or both.
The ippiMirror_8u_C1R, ippiMirror_16u_C1R, ippiMirror_16s_C1R, and ippiMirror_32f_C1R function flavors can also use the ippAxs45 or ippAxs135 value of the flip parameter to mirror the source image about an axis rotated counterclockwise by 45 degrees or 135 degrees, respectively. For mirroring with each of these values of the flip parameter, the sizes of the source and destination ROI are different, and
roiSize.height = srcRoiSize.width
roiSize.width = srcRoiSize.height
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error condition if one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with zero or negative value, or when one of the dimensions is equal to 1. |
ippStsMirrorFlipErr |
Indicates an error condition if flip has an illegal value. |
ippStsNotSupportedModeErr |
Indicates an error condition if intersection of the source and destination ROI is detected. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep has a zero or negative value or is not a multiple of the image data size (4 for floating-point images or 2 for short-integer images) |