Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

CopyReplicateBorder

Copies pixel values between two 3D images and adds replicated border pixels.

Syntax

IppStatus ipprCopyReplicateBorder_8u_C1V(const Ipp8u* pSrc, int srcPlaneStep, int srcStep, IpprVolume srcRoiVolume, Ipp8u* pDst, int dstPlaneStep, int dstStep, IpprVolume dstRoiVolume, int topBorderHeight, int leftBorderWidth, int forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_16u_C1V(const Ipp16u* pSrc, int srcPlaneStep, int srcStep, IpprVolume srcRoiVolume, Ipp16u* pDst, int dstPlaneStep, int dstStep, IpprVolume dstRoiVolume, int topBorderHeight, int leftBorderWidth, int forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_16s_C1V(const Ipp16s* pSrc, int srcPlaneStep, int srcStep, IpprVolume srcRoiVolume, Ipp16s* pDst, int dstPlaneStep, int dstStep, IpprVolume dstRoiVolume, int topBorderHeight, int leftBorderWidth, int forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_32f_C1V(const Ipp32f* pSrc, int srcPlaneStep, int srcStep, IpprVolume srcRoiVolume, Ipp32f* pDst, int dstPlaneStep, int dstStep, IpprVolume dstRoiVolume, int topBorderHeight, int leftBorderWidth, int forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_64f_C1V(const Ipp64f* pSrc, int srcPlaneStep, int srcStep, IpprVolume srcRoiVolume, Ipp64f* pDst, int dstPlaneStep, int dstStep, IpprVolume dstRoiVolume, int topBorderHeight, int leftBorderWidth, int forwardBorderDepth);

Platform-aware functions

IppStatus ipprCopyReplicateBorder_8u_C1V_L(const Ipp8u* pSrc, IppSizeL srcPlaneStep, IppSizeL srcStep, IpprVolumeL srcRoiVolume, Ipp8u* pDst, IppSizeL dstPlaneStep, IppSizeL dstStep, IpprVolumeL dstRoiVolume, IppSizeL topBorderHeight, IppSizeL leftBorderWidth, IppSizeL forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_16u_C1V_L(const Ipp16u* pSrc, IppSizeL srcPlaneStep, IppSizeL srcStep, IpprVolumeL srcRoiVolume, Ipp16u* pDst, IppSizeL dstPlaneStep, IppSizeL dstStep, IpprVolumeL dstRoiVolume, IppSizeL topBorderHeight, IppSizeL leftBorderWidth, IppSizeL forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_16s_C1V_L(const Ipp16s* pSrc, IppSizeL srcPlaneStep, IppSizeL srcStep, IpprVolumeL srcRoiVolume, Ipp16s* pDst, IppSizeL dstPlaneStep, IppSizeL dstStep, IpprVolumeL dstRoiVolume, IppSizeL topBorderHeight, IppSizeL leftBorderWidth, IppSizeL forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_32f_C1V_L(const Ipp32f* pSrc, IppSizeL srcPlaneStep, IppSizeL srcStep, IpprVolumeL srcRoiVolume, Ipp32f* pDst, IppSizeL dstPlaneStep, IppSizeL dstStep, IpprVolumeL DstRoiVolume, IppSizeL topBorderHeight, IppSizeL leftBorderWidth, IppSizeL forwardBorderDepth);

IppStatus ipprCopyReplicateBorder_64f_C1V_L(const Ipp64f* pSrc, IppSizeL srcPlaneStep, IppSizeL srcStep, IpprVolumeL srcRoiVolume, Ipp64f* pDst, IppSizeL dstPlaneStep, IppSizeL dstStep, IpprVolumeL dstRoiVolume, IppSizeL topBorderHeight, IppSizeL leftBorderWidth, IppSizeL forwardBorderDepth);

Include Files

ippi.h

ippi_l.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

pSrc

Array of pointers to the planes in the source volume.

srcStep

Distance, in bytes, between the starting points of consecutive lines in each plane of the source volume.

srcPlaneStep

Distance, in bytes, between the starting points of consecutive images in every plane of the source volume.

srcRoiVolume

Volume of the source ROI in pixels.

pDst

Array of pointers to the planes in the destination volume.

dstStep

Distance, in bytes, between the starting points of consecutive lines in each plane of the destination volume.

dstPlaneStep

Distance, in bytes, between the starting points of consecutive images in every plane of the source volume.

dstRoiVolume

Volume of the destination ROI in pixels.

topBorderHeight

Height of the top border in pixels.

leftBorderWidth

Width of the left border in pixels.

forwardBorderDepth

Depth of the forward border in pixels.

Description

This function operates with VOI. This function copies the source image pSrc with the volume srcRoiVolume to the destination image pDst with the volume dstRoiVolume. The function fills pixels ('border') outside the copied area in the destination image with the values of the source image pixels.

The image below shows the mapping of the parameters topBorderHeight, leftBorderWidth, and forwardBorderWidth onto the dimensions of the three-dimensional space.


Mapping the border parameters onto the dimensions of the 3D space

Return Values

ippStsNullPtrErr

Indicates an error condition if pSrc or pDst pointer is NULL.

ippStsStepErr

Indicates an error condition if srcPlaneStep value is less than srcStep value or if dstPlaneStep value is less than dstStep value.

ippStsSizeErr

Indicates an error condition if leftBorderWidth, topBorderHeight or forwardBorderDepth has a field with negative value.

See Also