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);

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

The function ippiBoundSegments is declared in the ippcv.h It 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.