write_ocr_trainf_image ( Character : : Class, FileName : )

Write characters into a training file.

The operator write_ocr_trainf_image is used to prepare the training with the operator trainf_ocr_class_box. Hereby regions, representing characters, including their gray values (region and pixel) and the corresponding class name will be written into a file. An arbitrary number of regions within one image is supported. For each character (region) in Character the corresponding class name must be specified in Class. If no file extension is specified in FileName the extension '.trf' is appended to the file name. In contrast to write_ocr_trainf one image per character is passed. The domain of this image defines the pixels which belong to the character. The file format can be defined by the parameter 'ocr_trainf_version' of the operator set_system.


Parameters

Character (input_object)
image(-array) -> object : byte / uint2
Characters to be trained.

Class (input_control)
string(-array) -> string
Class (name) of the characters.

FileName (input_control)
filename -> string
Name of the training file.
Default value: ''train_ocr''


Result

If the parameters are correct, the operator write_ocr_trainf_image returns the value 2 (H_MSG_TRUE). Otherwise an exception will be raised.


Parallelization Information

write_ocr_trainf_image is reentrant and processed without parallelization.


Possible Predecessors

threshold, connection, create_ocr_class_box, read_ocr


Possible Successors

trainf_ocr_class_box, info_ocr_class_box, write_ocr, do_ocr_multi, do_ocr_single


Alternatives

write_ocr_trainf, append_ocr_trainf


Module

OCR/OCV



Copyright © 1996-2008 MVTec Software GmbH