Skip to content

read_ocr_class_cnnReadOcrClassCnnReadOcrClassCnnread_ocr_class_cnnT_read_ocr_class_cnn🔗

Short description🔗

read_ocr_class_cnnReadOcrClassCnnReadOcrClassCnnread_ocr_class_cnnT_read_ocr_class_cnn — Read an CNN-based OCR classifier from a file.

Signature🔗

read_ocr_class_cnn( filename.read FileName, out ocr_cnn OCRHandle )void ReadOcrClassCnn( const HTuple& FileName, HTuple* OCRHandle )static void HOperatorSet.ReadOcrClassCnn( HTuple fileName, out HTuple OCRHandle )def read_ocr_class_cnn( file_name: str ) -> HHandle

Herror T_read_ocr_class_cnn( const Htuple FileName, Htuple* OCRHandle )

void HOCRCnn::HOCRCnn( const HString& FileName )

void HOCRCnn::HOCRCnn( const char* FileName )

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

public HOCRCnn( string fileName )

void HOCRCnn::ReadOcrClassCnn( const HString& FileName )

void HOCRCnn::ReadOcrClassCnn( const char* FileName )

void HOCRCnn::ReadOcrClassCnn( const wchar_t* FileName ) (Windows only)

void HOCRCnn.ReadOcrClassCnn( string fileName )

Description🔗

read_ocr_class_cnnReadOcrClassCnn reads a pretrained OCR classifier based on a convolutional neural network (CNN).

The CNN-based OCR classifier is read with read_ocr_class_cnnReadOcrClassCnn and subsequently used for classification with either do_ocr_single_class_cnnDoOcrSingleClassCnn, do_ocr_multi_class_cnnDoOcrMultiClassCnn, or do_ocr_word_cnnDoOcrWordCnn.

HALCON provides a number of pretrained OCR classifiers (see “Solution Guide I”, chapter ‘OCR’, section ‘Pretrained OCR Fonts’). These pretrained OCR classifiers make it possible to read a wide variety of different fonts without the need to train an OCR classifier. Note that the pretrained OCR classifiers were trained with symbols that are printed dark on light.

Execution information🔗

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🔗

FileNamefileNamefile_name (input_control) filename.read → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name.

Default: 'Universal_Rej.occ'"Universal_Rej.occ"
Suggested values: 'Universal_NoRej.occ', 'Universal_Rej.occ', 'Universal_0-9_NoRej.occ', 'Universal_0-9_Rej.occ', 'Universal_0-9+_NoRej.occ', 'Universal_0-9+_Rej.occ', 'Universal_0-9A-Z_NoRej.occ', 'Universal_0-9A-Z_Rej.occ', 'Universal_0-9A-Z+_NoRej.occ', 'Universal_0-9A-Z+_Rej.occ', 'Universal_A-Z+_NoRej.occ', 'Universal_A-Z+_Rej.occ'"Universal_NoRej.occ", "Universal_Rej.occ", "Universal_0-9_NoRej.occ", "Universal_0-9_Rej.occ", "Universal_0-9+_NoRej.occ", "Universal_0-9+_Rej.occ", "Universal_0-9A-Z_NoRej.occ", "Universal_0-9A-Z_Rej.occ", "Universal_0-9A-Z+_NoRej.occ", "Universal_0-9A-Z+_Rej.occ", "Universal_A-Z+_NoRej.occ", "Universal_A-Z+_Rej.occ"
File extension: .occ, .fnt

OCRHandleOCRHandleocrhandle (output_control) ocr_cnn → (handle)HTuple (HHandle)HOCRCnn, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the OCR classifier.

Result🔗

If the parameters are valid, the operator read_ocr_class_cnnReadOcrClassCnn returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible successors

do_ocr_single_class_cnnDoOcrSingleClassCnn, do_ocr_multi_class_cnnDoOcrMultiClassCnn, do_ocr_word_cnnDoOcrWordCnn

See also

get_params_ocr_class_cnnGetParamsOcrClassCnn

Module🔗

OCR/OCV