DistanceTransformation

Calculates the distance transformation, which is the distance to the closest zero pixel in a binary image. Additionally, an image with component labels is created (discrete Voronoi diagram).

Syntax

Definition:

HRESULT DistanceTransformation(
    HRESULT                          hrPrev,
    ITcVnImage*                      ipSrcImage,
    ITcVnImage*&                     ipDestImage,
    ETcVnDistanceType                eDistanceType,
    ETcVnDistanceTransformationMask  eMaskSize,
    ITcVnImage**                     pipDestLabels = nullptr,
    ETcVnDistanceTransformationLabel eLabelType = DTL_CCOMP
)

Parameters

Name	Type	Default	Description
hrPrev	HRESULT		HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipSrcImage	ITcVnImage*		Source image (USINT, 1 channel)
ipDestImage	ITcVnImage*&		Destination image (REAL, 1 channel. An appropriate destination image will be created if required.)
eDistanceType	ETcVnDistanceType		Distance computation method (supported: L1, L2, C)
eMaskSize	ETcVnDistanceTransformationMask		Size of the distance transformation mask (PRECISE not supported for label computation)
pipDestLabels	ITcVnImage**	nullptr	Returns the component labels (Discrete Voronoi diagram; DINT, 1 channel. An appropriate image will be created if required.)
eLabelType	ETcVnDistanceTransformationLabel	DTL_CCOMP	Type of the labels

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.59 or later	PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision