F_VN_ReadDataMatrixCodeExp
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_ReadDataMatrixCodeExp : 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 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) |
|
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. |
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 |