HALCON Website / HALCON Operator Reference / OCR / Convolutional Neural Networks
ClassesClassesClassesClasses | | | | Operators

read_ocr_class_cnnread_ocr_class_cnnReadOcrClassCnnread_ocr_class_cnnReadOcrClassCnnReadOcrClassCnn (Operator)

Name

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

Signature

read_ocr_class_cnn( : : FileName : OCRHandle)

Herror read_ocr_class_cnn(const char* FileName, Hlong* OCRHandle)

Herror T_read_ocr_class_cnn(const Htuple FileName, Htuple* OCRHandle)

Herror read_ocr_class_cnn(const HTuple& FileName, Hlong* OCRHandle)

void HOCRCnn::ReadOcrClassCnn(const HTuple& FileName)

void ReadOcrClassCnn(const HTuple& FileName, HTuple* OCRHandle)

void HOCRCnn::HOCRCnn(const HString& FileName)

void HOCRCnn::HOCRCnn(const char* FileName)

void HOCRCnn::ReadOcrClassCnn(const HString& FileName)

void HOCRCnn::ReadOcrClassCnn(const char* FileName)

void HOperatorSetX.ReadOcrClassCnn(
[in] VARIANT FileName, [out] VARIANT* OCRHandle)

void HOCRCnnX.ReadOcrClassCnn([in] BSTR FileName)

static void HOperatorSet.ReadOcrClassCnn(HTuple fileName, out HTuple OCRHandle)

public HOCRCnn(string fileName)

void HOCRCnn.ReadOcrClassCnn(string fileName)

Description

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

The CNN-based OCR classifier is read with read_ocr_class_cnnread_ocr_class_cnnReadOcrClassCnnread_ocr_class_cnnReadOcrClassCnnReadOcrClassCnn and subsequently used for classification with either do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnn, do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnn, or do_ocr_word_cnndo_ocr_word_cnnDoOcrWordCnndo_ocr_word_cnnDoOcrWordCnnDoOcrWordCnn.

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.

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

File name.

Default value: 'Universal_Rej.occ' "Universal_Rej.occ" "Universal_Rej.occ" "Universal_Rej.occ" "Universal_Rej.occ" "Universal_Rej.occ"

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

File extension: .occ, .fnt

OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (output_control)  ocr_cnn → HOCRCnn, HTupleHTupleHOCRCnn, HTupleHOCRCnnX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the OCR classifier.

Result

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

Possible Successors

do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnn, do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnn, do_ocr_word_cnndo_ocr_word_cnnDoOcrWordCnndo_ocr_word_cnnDoOcrWordCnnDoOcrWordCnn

See also

get_params_ocr_class_cnnget_params_ocr_class_cnnGetParamsOcrClassCnnget_params_ocr_class_cnnGetParamsOcrClassCnnGetParamsOcrClassCnn

Module

OCR/OCV

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH