F_VN_OCR
Detects and recognizes characters in a binary image (white characters on black background).
Syntax
Definition:
FUNCTION F_VN_OCR : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
eModel : ULINT;
ipCharacters : Reference To ITcVnContainer;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT, 1 channel, binary) | |
|
eModel |
ULINT |
Selection of OCR model types (ETcVnOcrModelType) |
|
ipCharacters |
Reference To ITcVnContainer |
Returns the recognized characters (ContainerType_Vector_String_SINT) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Die Funktion F_VN_OCR detektiert und erkennt Zeichen in einem Binärbild und gibt die erkannten Zeichen in einem Container zurück.
Parameter
Eingangsbild
Das Eingangsbild was an ipSrcImage übergeben wird, muss ein 1-kanaliges Binärbild sein. Es sind nur weiße Zeichen auf schwarzem Hintergrund zulässig.
Modell
Ein Modell-Typ von ETcVnOcrModelType, welches bei einem Funktionsaufruf zur Klassifizierung der Zeichen verwendet werden soll, muss an eModel übergeben werden. Diese Funktion unterstützt nur die Verwendung von einem Modell pro Funktionsaufruf.
Um ein Modell verwenden zu können, muss dieses zuvor mit dem Baustein FB_VN_InitializeFunction initialisiert werden.
Erkannte Zeichen
Die erkannten Zeichen werden über die Referenz ipCharacters zurückgegeben.
Expert-Parameter
Die Expert-Variante F_VN_OCRExp enthält zusätzliche Parameter.
Anwendung
Ein Aufruf der OCR-Funktion, mit einem Modell zur Erkennung von Zahlen, mit anschließendem String-Export sieht z.B. so aus:
hr := F_VN_OCR(
ipSrcImage := ipBinaryImage,
eModel := TCVN_OMT_NUMBERS,
ipCharacters := ipCharactersResults,
hrPrev := hr);
// Export character to string
hr := F_VN_ExportSubContainer_String(ipCharactersResults, 0, sText, 255, hr);
Required License
TC3 Vision OCR
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1. 4024.44 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |