Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

BoundSegments

Marks pixels belonging to segment boundaries.

Syntax

IppStatus ippiBoundSegments_8u_C1IR(Ipp8u*
pMarker
, int
markerStep
, IppiSize
roiSize
, Ipp8u
val
, IppiNorm
norm
);
IppStatus ippiBoundSegments_16u_C1IR(Ipp16u*
pMarker
, int
markerStep
, IppiSize
roiSize
, Ipp16u
val
, IppiNorm
norm
);
Include Files
ippcv.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
Parameters
pMarker
Pointer to the ROI of the source and destination image of markers.
markerStep
Distance in bytes between starts of consecutive lines in the image of markers.
roiSize
Size of the source and destination image ROI in pixels.
val
Value of the boundary pixel.
norm
Specifies type of the norm gor pixel neighborhood:
ippiNormInf
Infinity norm (8-connectivity);
ippiNormL1
L1 norm (4-connectivity.
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function detects segment boundaries in the
pMarker
image and sets border pixels to the value
val
. A segment is the set of connected pixels of the
pMarker
image with the same value not equal to
val
. After boundaries are marked, the
pMarker
image does not contain any pair of adjacent in
norm
pixels with the same value that not equal to
val
.
Return Values
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.
ippStsStepErr
Indicates an error condition if
markerStep
is less than
roiSize.width
* <
pixelSize
>.
ippNotEvenStsStepErr
Indicates an error condition if
markerStep
for 16-bit integer images is not divisible by 2.
ippStsBadArgErr
Indicates an error condition if
norm
has an illegal value.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804