ReadDataMatrixCode
Detect and interpret a data matrix code (ECC200) within the provided image.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
HRESULT ReadDataMatrixCode(
HRESULT hrPrev,
ITcVnImage* ipSrcImage,
ITcVnContainer*& ipDecodedData,
ITcVnContainer** pipContours = nullptr,
LONG nCodeNumber = 1,
ULONG eSearchStrategy = CSS_DEFAULT,
ITcVnContainer** pipAngles = nullptr
)
Parameters
Name |
Type |
Default |
Description |
---|---|---|---|
hrPrev |
|
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) | |
ipSrcImage |
|
Source image (USINT elements, 1 or 3 channels) | |
ipDecodedData |
|
Returns the decoded code (ContainerType_Vector_String_SINT) | |
pipContours |
nullptr |
Returns the code positions as contours (optional, set to 0 if not required; ContainerType_Vector_Vector_TcVnPoint2_DINT) | |
nCodeNumber |
LONG |
1 |
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 |
ULONG |
CSS_DEFAULT |
Used search strategy (ETcVn2dCodeSearchStrategy) |
pipAngles |
nullptr |
Returns the clockwise code rotation angles (optional, set to 0 if not required; ContainerType_Vector_REAL) |
Required License
TC3 Vision Code Reading