F_VN_DrawContoursExp
Draws a single point set or multiple point sets that are interpreted as contours. (expert function)
Syntax
Definition:
FUNCTION F_VN_DrawContoursExp : HRESULT
VAR_INPUT
ipContours : ITcVnContainer;
nContourIndex : DINT;
ipDestImage : ITcVnImage;
END_VAR
VAR_IN_OUT
aColor : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
nThickness : DINT;
eLineType : ETcVnLineType;
ipHierarchy : ITcVnContainer;
nMaxLevel : DINT;
END_VAR
VAR_IN_OUT
aOffset : TcVnPoint;
END_VAR
VAR_INPUT
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipContours |
Single contour (ContainerType_Vector_TcVnPoint2_DINT) or multiple contours (ContainerType_Vector_Vector_TcVnPoint2_DINT) | |
|
nContourIndex |
DINT |
Index of a specific contour to be drawn (if negative, all contours within the container are drawn) |
|
ipDestImage |
Destination image | |
|
nThickness |
DINT |
Line thickness (if negative, the contours are filled) |
|
eLineType |
Line type | |
|
ipHierarchy |
Contour hierarchy (ContainerType_Vector_TcVnVector4_DINT) | |
|
nMaxLevel |
DINT |
Maximum level of contours to be drawn |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aColor |
Color | |
|
aOffset |
Offset by which every contour point is shifted |
Return valueWeiterführende Informationen
Die Funktion F_VN_DrawContoursExp entspricht der Funktion F_VN_DrawContours, erweitert um zusätzliche Eingangsvariablen.
So kann die Hierarchie-Beschreibung, welche neben den gefundenen Konturen von der Funktion F_VN_FindContourHierarchyExp zurückgegeben wird, mit berücksichtigt werden. Hierzu wird die Hierarchie-Beschreibung über ipHierarchy und über die Eingangsvariable nMaxLevel angegeben, bis zu welcher Hierarchy-Ebene die Konturen gezeichnet werden sollen. Wird bei ipHierarchy 0 übergeben, so wird die Hierarchy ignoriert.
Über aOffset können alle Konturpunkte in x und y Richtung einheitlich versetzt eingezeichnet werden. Dies ist zum Beispiel interessant, wenn die Konturen in einer ROI gesucht wurden, aber ins Originalbild eingezeichnet werden sollen.
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 PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |