Operator Reference

HALCON Operator Reference / Legacy / OCR

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

read_ocrT_read_ocrReadOcrReadOcrread_ocr (Operator)

read_ocrT_read_ocrReadOcrReadOcrread_ocr — Read an OCR classifier from a file.

Warning

read_ocrread_ocrReadOcrReadOcrread_ocr is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM or CNN based operators instead.

Signature

read_ocr( : : FileName : OcrHandle)

Herror T_read_ocr(const Htuple FileName, Htuple* OcrHandle)

void ReadOcr(const HTuple& FileName, HTuple* OcrHandle)

void HOCRBox::HOCRBox(const HString& FileName)

void HOCRBox::HOCRBox(const char* FileName)

void HOCRBox::HOCRBox(const wchar_t* FileName)   ( Windows only)

void HOCRBox::ReadOcr(const HString& FileName)

void HOCRBox::ReadOcr(const char* FileName)

void HOCRBox::ReadOcr(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadOcr(HTuple fileName, out HTuple ocrHandle)

public HOCRBox(string fileName)

void HOCRBox.ReadOcr(string fileName)

def read_ocr(file_name: str) -> HHandle

Description

The operator read_ocrread_ocrReadOcrReadOcrread_ocr reads an OCR classifier from a file FileNameFileNameFileNamefileNamefile_name. This file will hereby be searched in the directory ($HALCONROOT/ocr/) as well as in the currently used directory. If too many classifiers have been loaded, an error message will be displayed.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the OCR classifier file.

Default: 'testnet' "testnet" "testnet" "testnet" "testnet"

File extension: .obc, .fnt

OcrHandleOcrHandleOcrHandleocrHandleocr_handle (output_control)  ocr_box → HOCRBox, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

ID of the read OCR classifier.

Result

If the indicated file is available and the format is correct, the operator read_ocrread_ocrReadOcrReadOcrread_ocr returns the value 2 ( H_MSG_TRUE) . Otherwise an exception will be raised.

Possible Predecessors

reset_obj_dbreset_obj_dbResetObjDbResetObjDbreset_obj_db

Possible Successors

do_ocr_multido_ocr_multiDoOcrMultiDoOcrMultido_ocr_multi, do_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingledo_ocr_single, traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box, trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box

See also

write_ocrwrite_ocrWriteOcrWriteOcrwrite_ocr, do_ocr_multido_ocr_multiDoOcrMultiDoOcrMultido_ocr_multi, traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box, trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box

Module

OCR/OCV

---

ClassesClasses | | Operators