F_VN_ReadDataMatrixCodeExp2

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	ITcVnImage	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	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Further information

The function F_VN_ReadDataMatrixCodeExp corresponds to the function F_VN_ReadDataMatrixCode extended by the following parameters.

ipContours

The parameter ipContour returns the code positions that are found as a contour.

nCodeNumber

The parameter nCodeNumber defines how many codes are to be searched for. At -1 the search continues until no further code is found in the image or a watchdog aborts the function.

eSearchStrategy

The parameter eSearchStrategy defines the search strategies for the code search. The standard option TCVN_CSS_DEFAULT leads to the search strategy TCVN_CSS_FIRST_NOT_FLIPPED. For a description of the search strategies see Code Reading search strategies.

	Search strategies Currently, this function only supports the settings of the search strategy for mirroring. Inversion is always performed automatically if not all expected codes are found in the original image.

Angle of rotation

The parameter ipAngles returns the clockwise rotation angle of the codes found in degree steps. The container is of the type ContainerType_Vector_REAL. This parameter is optional and can be set to 0 if it is not required.

Examples

Related functions

Required License

TC3 Vision Code Reading

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.54 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision