F_VN_OCR

Syntax

Definition:

FUNCTION F_VN_OCR : HRESULT
VAR_INPUT
    ipSrcImage   : ITcVnImage;
    eModel       : ULINT;
    ipCharacters : Reference To  ITcVnContainer;
    hrPrev       : HRESULT;
END_VAR

 Inputs

 Return value

HRESULT

Further information

The function F_VN_OCR detects and recognizes characters in a binary image and returns the recognized characters in a container.

Parameter

Input image

The input image that is transferred to ipSrcImage must be a 1-channel binary image. Only white characters on a black background are permitted.

Model

A model type of ETcVnOcrModelType, which is to be used in a function call to classify the characters, must be transferred to eModel. This function only supports the use of one model per function call.

To be able to use a model, it must first be initialized with the function block FB_VN_InitializeFunction.

Recognized characters

The recognized characters are returned via the reference ipCharacters.

Expert parameters

The expert variant F_VN_OCRExp contains additional parameters.

Application

For example, a call of the OCR function, with a model for recognizing numbers, with subsequent string export looks like this:

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