F_VN_ReadDataMatrixCodeExp2
Detect and interpret a data matrix code (ECC200) within the provided image.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_ReadDataMatrixCodeExp2 : 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
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT elements, 1 or 3 channels) | |
|
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 data matrix codes that should be detected within the provided image. (If set to -1, it tries to detect all data matrix codes.) |
|
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 indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Die Funktion F_VN_ReadDataMatrixCodeExp entspricht der Funktion F_VN_ReadDataMatrixCode erweitert um die folgenden Parameter.
ipContours
Der Parameter ipContour gibt die gefundenen Codepositionen jeweils als Kontur zurück.
nCodeNumber
Der Parameter nCodeNumber definiert, nach wie vielen Codes gesucht werden soll. Bei -1 wird so lange gesucht bis kein weiterer Code mehr im Bild gefunden wird oder ein Watchdog die Funktion abbricht.
eSearchStrategy
Der Parameter eSearchStrategy definiert, welche Suchstrategien für die Codesuche genutzt werden sollen. Die Standard-Option TCVN_CSS_DEFAULT führt zu der Suchstrategie TCVN_CSS_FIRST_NOT_FLIPPED. Eine Beschreibung der Suchstrategien finden Sie unter Code Reading Suchstrategien.
 | Suchstrategien Zurzeit unterstützt diese Funktion nur die Einstellung der Suchstrategie zur Spiegelung. Eine Invertierung wird immer automatisch vorgenommen, falls im Originalbild nicht alle erwarteten Codes gefunden werden. |
Drehwinkel
Der Parameter ipAngles gibt die Drehwinkel der gefundenen Codes im Uhrzeigersinn in Grad-Schritten 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 |