F_VN_DistanceTransformationExp

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). (expert function)

Syntax

Definition:

FUNCTION F_VN_DistanceTransformationExp : HRESULT
VAR_INPUT
    ipSrcImage    : ITcVnImage;
    ipDestImage   : Reference To  ITcVnImage;
    eDistanceType : ETcVnDistanceType;
    eMaskSize     : ETcVnDistanceTransformationMask;
    ipDestLabels  : Reference To  ITcVnImage;
    eLabelType    : ETcVnDistanceTransformationLabel;
    hrPrev        : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image (USINT, 1 channel)
ipDestImage	Reference To 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)
ipDestLabels	Reference To ITcVnImage	Returns the component labels (Discrete Voronoi diagram; DINT, 1 channel. An appropriate image will be created if required.)
eLabelType	ETcVnDistanceTransformationLabel	Type of the labels
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

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