HALCON Reference Manual 10.0.2
Table of Contents / Inspection / OCV ClassesClassesClasses | | | Operators

create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj (Operator)

Name

create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj — Create a new OCV tool based on gray value projections.

Signature

create_ocv_proj( : : PatternNames : OCVHandle)

Herror create_ocv_proj(const char* PatternNames, Hlong* OCVHandle)

Herror T_create_ocv_proj(const Htuple PatternNames, Htuple* OCVHandle)

Herror create_ocv_proj(const HTuple& PatternNames, Hlong* OCVHandle)

void HOCV::CreateOcvProj(const HTuple& PatternNames)

void HOperatorSetX.CreateOcvProj(
[in] VARIANT PatternNames, [out] VARIANT* OCVHandle)

void HOCVX.CreateOcvProj([in] VARIANT PatternNames)

static void HOperatorSet.CreateOcvProj(HTuple patternNames, out HTuple OCVHandle)

public HOCV(HTuple patternNames)

void HOCV.CreateOcvProj(HTuple patternNames)

void HOCV.CreateOcvProj(string patternNames)

Description

create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj creates a new OCV tool. This tool will be used to train good-patterns for the optical character verification. The training is done using the operator traind_ocv_projtraind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProj. Thus traind_ocv_projtraind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProj is normally called after create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj.

The pattern comparison is based on the gray projections: For every training pattern the horizontal and vertical gray projections are calculated by summing up the gray values along the rows and columns inside the region of the pattern. This operation is applied to the training patterns and the test patterns. For the training patterns the result is stored inside the OCV tool to save runtime while comparing patterns. The OCV is done by comparing the corresponding projections. The Quality is the similarity of the projections.

Input for create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj are the names of the patterns (PatternNamesPatternNamesPatternNamesPatternNamespatternNames) which have to be trained. The number and the names can be chosen arbitrary. In most case only one pattern will be trained, thus only one name has to be specified. The names will be used when doing the OCV (do_ocv_simpledo_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimple). It is possible to specify more names than actually used. These might be trained later.

To close the OCV tool, i.e. to free the memory, the operator close_ocvclose_ocvclose_ocvCloseOcvCloseOcv is called.

Parallelization

Parameters

PatternNamesPatternNamesPatternNamesPatternNamespatternNames (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

List of names for patterns to be trained.

Default value: 'a' "a" "a" "a" "a"

OCVHandleOCVHandleOCVHandleOCVHandleOCVHandle (output_control)  ocv → HOCV, HTupleHOCV, HTupleHOCVX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Handle of the created OCV tool.

Example (C++)

create_ocv_proj("A",&ocv_handle);
draw_region(&ROI,window_handle);
reduce_domain(Image,ROI,&Sample);
traind_ocv_proj(Sample,ocv_handle,"A","single");

Result

create_ocv_projcreate_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProj returns 2 (H_MSG_TRUE), if the parameters are correct. Otherwise, an exception is raised.

Possible Successors

traind_ocv_projtraind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProj, write_ocvwrite_ocvwrite_ocvWriteOcvWriteOcv, close_ocvclose_ocvclose_ocvCloseOcvCloseOcv

Alternatives

read_ocvread_ocvread_ocvReadOcvReadOcv

See also

create_ocr_class_boxcreate_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBox

Module

OCR/OCV

Table of Contents / Inspection / OCV ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH