F_VN_ReadQRCodeExp2

F_VN_ReadQRCodeExp2 1:

Detect and interpret a QR code within the provided image. Can be canceled by Watchdog.

Syntax

Definition:

FUNCTION F_VN_ReadQRCodeExp2 : HRESULT
VAR_INPUT
    ipSrcImage      : ITcVnImage;
    ipDecodedData   : Reference To  ITcVnContainer;
    ipContours      : Reference To  ITcVnContainer;
    nCodeNumber     : DINT;
    eSearchStrategy : UDINT;
    ipAngles        : Reference To  ITcVnContainer;
    hrPrev          : HRESULT;
END_VAR

F_VN_ReadQRCodeExp2 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

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)

ipAngles

Reference To ITcVnContainer

Returns the clockwise code rotation angles (optional, set to 0 if not required; ContainerType_Vector_REAL)

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_ReadQRCodeExp2 3: Return value

HRESULT

Weiterführende Informationen

Hinweis

Floating Point Exceptions

Diese Funktion kann 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.

F_VN_ReadQRCodeExp2 4:

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.

Drehwinkel

Der Parameter ipAngles gibt die Drehwinkel der gefundenen Codes im Uhrzeigersinn in Grad zurück. Der Container ist vom Typ ContainerType_Vector_REAL. Dieser Parameter ist optional und kann auf 0 gesetzt werden, wenn er nicht benötigt wird.

Beispiele

Verwandte Funktionen

Required License

TC3 Vision Code Reading

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