read_ocvT_read_ocvReadOcvReadOcv (Operator)

Name

read_ocvT_read_ocvReadOcvReadOcv — Reading an OCV tool from file.

Signature

read_ocv( : : FileName : OCVHandle)

Description

read_ocvread_ocvReadOcvReadOcvReadOcv reads an OCV tool from file. The tool will contain the same information that it contained when saving it with write_ocvwrite_ocvWriteOcvWriteOcvWriteOcv. 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_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimple.

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

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

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Name of the file which has to be read.

Default value: 'test_ocv' "test_ocv" "test_ocv" "test_ocv" "test_ocv"

File extension: .ocv

OCVHandleOCVHandleOCVHandleOCVHandleOCVHandle (output_control) ocv → (handle)

Handle of read OCV tool.

Example (C++ (HALCON 5.0-10.0))

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_ocvread_ocvReadOcvReadOcvReadOcv returns 2 (H_MSG_TRUE), if the file is correct. Otherwise, an exception is raised.

Possible Predecessors

write_ocvwrite_ocvWriteOcvWriteOcvWriteOcv

Possible Successors

do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimple, close_ocvclose_ocvCloseOcvCloseOcvCloseOcv

Module

OCR/OCV

Operators