write_ocr_trainf

Herror ::write_ocr_trainf ( Hobject Character, Hobject Image, const HTuple &Class, const HTuple &FileName ) void HRegion::WriteOcrTrainf ( const HImage &Image, const HTuple &Class, const HTuple &FileName ) const void HRegionArray::WriteOcrTrainf ( const HImage &Image, const HTuple &Class, const HTuple &FileName ) const

Storing of trained characters into a file.

The operator ::write_ocr_trainf serves to prepare the training with the operator ::trainf_ocr_class_box. Hereby regions, representing characters, including their grayvalues (region and pixel) and the corresponding classname 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. The grayvalues are passed via the parameter Image. The file name can be chosen at will.

Parameters

`Character` (input_object)	region(-array) `->` Hobject: HRegion(Array)
Characters to be trained.

`Image` (input_object)	image `->` Hobject: HImage
Grayvalues of the characters.

`Class` (input_control)	string(-array) `->` HTuple.char *
Class (name) of the characters.

`FileName` (input_control)	filename `->` HTuple.char *
Name of the training file.
Default value: ''train_ocr''

Example

char       name[128];
HTuple     Class,Name;

read_image(&Image,"character.tiff");
bin_threshold(Image,&Dark);
connection(Dark,&Character);
count_obj(Character,&num);
create_tuple(&Class,num);
open_window(0,0,-1,-1,0,"","",&WindowHandle);
set_color(WindowHandle,"red");
for (i=0; i<num; i++) {
  select_obj(Character,&SingleCharacter,i);
  clear_window(WindowHandle);
  disp_region(SingleCharacter,WindowHandle);
  printf("class of character %d ?\n",i);
  scanf("%s\n",name);
  set_s(Class,name,i);
}
create_tuple(&Name,1);
set_s(Class,Name,"trainfile");
T_write_ocr_trainf(Character,Image,Class,Name);

Result

If the parameters are correct, the operator ::write_ocr_trainf returns the value H_MSG_TRUE. Otherwise an exception will be raised.

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

Module

Optical character recognition