CopyManaged
CopyManaged
Copies pixel values between two images in accordance with
the specified type of copying.
Syntax
IppStatus ippiCopyManaged_8u_C1R
(
const Ipp8u*
pSrc
,
int
srcStep
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
int
flags
);
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
- pSrc
- Pointer to the source image ROI.
- srcStep
- Distance, in bytes, between the starting points of consecutive lines in the source image.
- pDst
- Pointer to the destination image ROI.
- dstStep
- Distance, in bytes, between the starting points of consecutive lines in the destination image.
- roiSize
- Size of the image ROI in pixels.
- flags
- Specifies the type of copying. Possible values are:
- IPP_TEMPORAL_COPY- standard copying
- IPP_NONTEMPORAL_STORE- copying without caching the destination image
- IPP_NONTEMPORAL_LOAD- processor uses non-temporal load instructions
Description
This function operates with ROI.
This function copies data from a source image ROI
pSrc
to the destination image ROI
pDst
. The flags
parameter specifies the type of copying that
the function performs:- Whenflagsis set toIPP_TEMPORAL_COPY, the function is identical to theippiCopy_8u_C1Rfunction.
- Whenflagsis set toIPP_NONTEMPORAL_STORE, the processor uses non-temporal store instructions. Copying is performed without caching the data of the destination image.
- Whenflagsis set toIPP_NONTEMPORAL_LOAD, the processor uses non-temporal load instructions.
To achieve better performance, align data to 64-byte boundary.
Product and Performance Information
|
---|
Performance varies by use, configuration and other factors. Learn more at
www.Intel.com/PerformanceIndex.
Notice revision #20201201
|
Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error when one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error whenroiSizehas a field with a zero or negative value.