F_VN_ReadPharmaCodeExp

Detect and interpret a pharma code within the provided image. Can be canceled by Watchdog.
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_ReadPharmaCodeExp : HRESULT
VAR_INPUT
    ipSrcImage    : ITcVnImage;
    ipDecodedData : Reference To  ITcVnContainer;
    ipContours    : Reference To  ITcVnContainer;
    nCodeNumber   : DINT;
    nMinBarNumber : INT;
    hrPrev        : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image (1 channel (all element types) or 3 channel with elements of type TCVN_ET_USINT, TCVN_ET_UINT or TCVN_ET_REAL (3 channel input is expected to be RGB and internally converted to Gray))
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 pharma codes that should be detected within the provided image (currently only 1 supported).
nMinBarNumber	INT	Minimal number of (dark) bars that codes must have.
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Further information

This Expert function extends the F_VN_ReadPharmaCode function as follows:

Return of the position of found codes via the parameter ipContours
Specifies the number of codes to be found in the image. The search is terminated once nCodeNumber or more codes have been found in the image. If less than nCodeNumber codes are found, the function returns S_FALSE.
Minimum number of dark bars that the code must have to be found by the function via the parameter nMinBarNumber.

Samples

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