ReadDotCodeRoi
Detect and interpret a DotCode within the provided image. The code should be in the image center and horizontally or vertically aligned.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
HRESULT ReadDotCodeRoi(
HRESULT hrPrev,
ITcVnImage* ipSrcImage,
ITcVnContainer*& ipDecodedData,
float fModuleWidth,
float& fAngleDeg,
ITcVnContainer** pipContour = nullptr,
ULONGLONG eOptions = DCO_DEFAULT
)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 channel) | |
|
ipDecodedData |
|
Returns the decoded code (ContainerType_String_SINT) | |
|
fModuleWidth |
float |
|
Average dot diameter of the code in the image (in pixels). Must be at least 3, preferably 5 - 8. |
|
fAngleDeg |
float& |
|
Returns the clockwise rotation angle in degree |
|
pipContour |
nullptr |
Returns the contour of the detected code (ContainerType_Vector_TcVnPoint2_DINT; optional, set to 0 if not required) | |
|
eOptions |
ULONGLONG |
DCO_DEFAULT |
Specifies a combination of one or more ETcVnDotCodeOptions |
Required License
TC3 Vision Code Reading
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4026 or later | PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |