F_VN_ReadPharmaCodeExp2

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_ReadPharmaCodeExp2 : HRESULT
VAR_INPUT
    ipSrcImage    : ITcVnImage;
    ipDecodedData : Reference To  ITcVnContainer;
    ipContours    : Reference To  ITcVnContainer;
    nCodeNumber   : DINT;
    nMinBarNumber : INT;
    ipAngles      : Reference To  ITcVnContainer;
    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.
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

Weiterführende Information

Diese Expertenfunktion erweitert die Funktion F_VN_ReadPharmaCode wie folgt:

Rückgabe der Lage von gefundenen Codes über den Parameter ipContours
Angabe der Anzahl der im Bild zu findenden Codes. Sobald nCodeNumber oder mehr Codes im Bild gefunden sind, wird die Suche beendet. Wenn weniger als nCodeNumber Codes gefunden werden, gibt die Funktion S_FALSE zurück.
Mindestanzahl an dunklen Strichen, die der Code haben muss, um von der Funktion gefunden zu werden, über den Parameter nMinBarNumber.

Drehwinkel

Der Parameter ipAngles gibt die ungefähren Drehwinkel der gefundenen Codes im Uhrzeigersinn von -90° bis +90° in Grad zurück. Der Container ist vom Typ ContainerType_Vector_REAL. Dieser Parameter ist optional und kann auf 0 gesetzt werden, wenn er nicht benötigt wird.

	Unterschiede bei der Leserichtung Da ein Pharmacode keine Start- oder Stoppkennung beinhaltet, erhält man je nach Leserichtung ein unterschiedliches Ergebnis. Daher kann anhand des Drehwinkels nicht erkannt werden, ob der Code um 180° gedreht ist. Um sicherzustellen, dass der Code in der erwarteten Orientierung vorliegt, muss das Bild um 180° gedreht und der Code erneut gelesen werden. Dann können beide gelesenen Ergebnisse mit einem erwarteten Wert verglichen werden, um so die Orientierung eindeutig bestimmen zu können.

Beispiele

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