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

ID 790148
Date 3/22/2024
Public
Document Table of 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.