F_VN_ReadDotCodeRoi
Detect and interpret a DotCode within the provided image. The code should be in the image center and horizontally or vertically aligned.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
FUNCTION F_VN_ReadDotCodeRoi : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDecodedData : Reference To ITcVnContainer;
fModuleWidth : REAL;
hrPrev : HRESULT;
END_VAR
VAR_OUTPUT
fAngleDeg : REAL;
END_VARInputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT elements, 1 channel) | |
|
ipDecodedData |
Reference To ITcVnContainer |
Returns the decoded code (ContainerType_String_SINT) |
|
fModuleWidth |
REAL |
Average dot diameter of the code in the image (in pixels). Must be at least 3, preferably 5 - 8. |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Outputs
|
Name |
Type |
Description |
|---|---|---|
|
fAngleDeg |
REAL |
Returns the clockwise rotation angle in degree |
Required License
TC3 Vision Code Reading
Weiterführende Informationen
Die Funktion F_VN_ReadDotCodeRoi sucht nach einem einzelnen DotCode innerhalb eines definierten Bildbereiches (ROI) und dekodiert diesen. Dabei wird eine zentrierte Position des Codes im übergebenen Bild vorausgesetzt.
fModuleWidth
Der Parameter fModuleWidth definiert den erwarteten durchschnittlichen Durchmesser der einzelnen DotCode-Module (Punkte) in Pixeln. Die Modulgröße muss mindestens 3 Pixel betragen, wobei für optimale und robuste Ergebnisse 5 bis 8 Pixel empfohlen werden. Starke Abweichungen vom parametrierten Wert können zu erhöhten Rechenzeit oder keinem Ergebnis führen.
Drehwinkel (Rückgabewert)
Der Rückgabewert fAngleDeg gibt den Drehwinkel im Uhrzeigersinn zurück.
Verwandte Funktionen
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4026 or later | PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |