read_ocv

read_ocv ( : : FileName : OCVHandle )

Reading an OCV tool from file.

read_ocv reads an OCV tool from file. The tool will contain the same information that it contained when saving it with write_ocv. After reading the tool the training can be completed for those patterns which have not been trained so far. Otherwise a pattern comparison can be applied directly by calling do_ocv_simple.

As extension '.ocv' is used. If this extension is not given with the file name it will be added automatically.

Parameters

`FileName` (input_control)	filename `->` string
Name of the file which has to be read.
Default value: 'test_ocv'

`OCVHandle` (output_control)	ocv `->` integer
Handle of read OCV tool.

Example (Syntax: C++)

read_ocv("ocv_file",&ocv_handle);
for (i=0; i<1000; i++)
{
  grab_image_async(&Image,fg_handle,-1);
  reduce_domain(Image,ROI,&Pattern);
  do_ocv_simple(Pattern,ocv_handle,"A",
                "true","true","false","true",10,
                &Quality);
}
close_ocv(ocv_handle);

Result

read_ocv returns 2 (H_MSG_TRUE), if the file is correct. If the file could not be opened read_ocv returns 5 (H_MSG_FAIL). Otherwise, an exception handling is raised.

Parallelization Information

read_ocv is processed completely exclusively without parallelization.

Possible Predecessors

write_ocv

Possible Successors

do_ocv_simple, close_ocv

See also

read_ocr

Module

OCR/OCV