F_VN_ReadQRCodeExp
Detect and interpret a QR code within the provided image. Can be canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_ReadQRCodeExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDecodedData : Reference To ITcVnContainer;
ipContours : Reference To ITcVnContainer;
nCodeNumber : DINT;
eSearchStrategy : UDINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT elements, 1 channel or 3 channel (3 channel input is expected to be RGB and internally converted to Gray)) | |
|
ipDecodedData |
Reference To ITcVnContainer |
Returns the decoded code (ContainerType_Vector_String_SINT) |
|
ipContours |
Reference To ITcVnContainer |
Returns the code positions as contours (optional, set to 0 if not required; ContainerType_Vector_Vector_TcVnPoint2_DINT) |
|
nCodeNumber |
DINT |
Number of QR codes that should be detected within the provided image (currently only 1 supported). |
|
eSearchStrategy |
UDINT |
Used search strategy (ETcVn2dCodeSearchStrategy) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Hinweis | |
Floating Point Exceptions Diese Funktion kann unnötigerweise Fehler herbeiführen, wenn die Option Floating point exceptions der ausführenden SPS-Task aktiv ist. Deaktivieren Sie diese Option deshalb. |
Die Funktion F_VN_ReadQRCodeExp entspricht der Funktion F_VN_ReadQRCode erweitert um die folgenden Parameter.
ipContour
Der Parameter ipContour gibt die gefundene Codeposition als Kontur zurück.
nCodeNumber
Der Parameter nCodeNumber definiert, nach wie vielen Codes gesucht werden soll.
 | Suche nach mehreren QR-Codes aktuell nicht unterstützt Die Suche nach mehreren QR-Codes in einem Bild wird aktuell nicht unterstützt. Daher ist der Parameter nCodeNumber := 1 zu setzen. |
eSearchStrategy
Der Parameter eSearchStrategy definiert, welche Suchstrategien für die Codesuche genutzt werden sollen. Die Standard-Option TCVN_CSS_DEFAULT führt zu den Suchstrategien TCVN_CSS_FIRST_NOT_INVERTED und TCVN_CSS_FIRST_NOT_FLIPPED. Eine Beschreibung der Suchstrategien finden Sie unter Code Reading Suchstrategien.
Beispiele
Verwandte Funktionen
Required License
TC3 Vision Code Reading
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.54 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |