HALCON 17.12 / HALCON Operator Reference / Inspection / OCV
ClassesClasses | | Operators

do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimple (Operator)

Name

do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimple — Verification of a pattern using an OCV tool.

Signature

do_ocv_simple(Pattern : : OCVHandle, PatternName, AdaptPos, AdaptSize, AdaptAngle, AdaptGray, Threshold : Quality)

Herror do_ocv_simple(const Hobject Pattern, const Hlong OCVHandle, const char* PatternName, const char* AdaptPos, const char* AdaptSize, const char* AdaptAngle, const char* AdaptGray, double Threshold, double* Quality)

Herror T_do_ocv_simple(const Hobject Pattern, const Htuple OCVHandle, const Htuple PatternName, const Htuple AdaptPos, const Htuple AdaptSize, const Htuple AdaptAngle, const Htuple AdaptGray, const Htuple Threshold, Htuple* Quality)

void DoOcvSimple(const HObject& Pattern, const HTuple& OCVHandle, const HTuple& PatternName, const HTuple& AdaptPos, const HTuple& AdaptSize, const HTuple& AdaptAngle, const HTuple& AdaptGray, const HTuple& Threshold, HTuple* Quality)

HTuple HImage::DoOcvSimple(const HOCV& OCVHandle, const HTuple& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const

double HImage::DoOcvSimple(const HOCV& OCVHandle, const HString& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const

double HImage::DoOcvSimple(const HOCV& OCVHandle, const char* PatternName, const char* AdaptPos, const char* AdaptSize, const char* AdaptAngle, const char* AdaptGray, double Threshold) const

HTuple HOCV::DoOcvSimple(const HImage& Pattern, const HTuple& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const

double HOCV::DoOcvSimple(const HImage& Pattern, const HString& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const

double HOCV::DoOcvSimple(const HImage& Pattern, const char* PatternName, const char* AdaptPos, const char* AdaptSize, const char* AdaptAngle, const char* AdaptGray, double Threshold) const

static void HOperatorSet.DoOcvSimple(HObject pattern, HTuple OCVHandle, HTuple patternName, HTuple adaptPos, HTuple adaptSize, HTuple adaptAngle, HTuple adaptGray, HTuple threshold, out HTuple quality)

HTuple HImage.DoOcvSimple(HOCV OCVHandle, HTuple patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)

double HImage.DoOcvSimple(HOCV OCVHandle, string patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)

HTuple HOCV.DoOcvSimple(HImage pattern, HTuple patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)

double HOCV.DoOcvSimple(HImage pattern, string patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)

Description

do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimple evaluates the pattern in (PatternPatternPatternPatternpattern). Before the evaluation the good-pattern has to be trained by using the operator traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj. Both patterns should have roughly the same (relative) extent and shape. To specify which of the trained patterns is used as reference its name is specified in PatternNamePatternNamePatternNamePatternNamepatternName. The next four parameters influence the automatic adaption: AdaptPosAdaptPosAdaptPosAdaptPosadaptPos and AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize refer to the geometry of the pattern. AdaptPosAdaptPosAdaptPosAdaptPosadaptPos specifies whether a shift of the position will be adapted automatically. AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize is used to adapt to changes in the size of the pattern. AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngle is not implemented. The parameter AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGray controls the adaption to changes of the grayvalues. This comprises additive and multiplicative changes of the intensity.

The parameter ThresholdThresholdThresholdThresholdthreshold specifies the minimum difference of the gray values to be treated as an error. In this case the percentage of wrong pixels is returned. If the value is below 0 the sum of all errors normalized with respect to the size is returned.

The result of the operator is the QualityQualityQualityQualityquality of the pattern with a value between 0 and 1. The value 1 corresponds to a pattern with no faults. The value 0 corresponds to a very big fault.

Execution Information

Parameters

PatternPatternPatternPatternpattern (input_object)  singlechannelimage(-array) → objectHImageHImageHobject (byte)

Characters to be verified.

OCVHandleOCVHandleOCVHandleOCVHandleOCVHandle (input_control)  ocv → HOCV, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the OCV tool.

PatternNamePatternNamePatternNamePatternNamepatternName (input_control)  string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the character.

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

AdaptPosAdaptPosAdaptPosAdaptPosadaptPos (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Adaption to vertical and horizontal translation.

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Adaption to vertical and horizontal scaling of the size.

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngle (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Adaption to changes of the orientation (not implemented).

Default value: 'false' "false" "false" "false" "false"

List of values: 'false'"false""false""false""false"

AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGray (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Adaption to additive and scaling gray value changes.

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

ThresholdThresholdThresholdThresholdthreshold (input_control)  number → HTupleHTupleHtuple (real) (double) (double) (double)

Minimum difference between objects.

Default value: 10

Suggested values: -1.0, 0.0, 1.0, 5.0, 10.0, 15.0, 20.0, 30.0, 40.0, 50.0, 60.0, 80.0, 100.0, 150.0

QualityQualityQualityQualityquality (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Evaluation of the character.

Typical range of values: 0.0 ≤ Quality Quality Quality Quality quality ≤ 1.0

Result

do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimple returns 2 (H_MSG_TRUE), if the handle and the characters are correct. Otherwise, an exception is raised.

Possible Predecessors

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBox, trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBox, read_ocvread_ocvReadOcvReadOcvReadOcv, thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, select_shapeselect_shapeSelectShapeSelectShapeSelectShape

Possible Successors

close_ocvclose_ocvCloseOcvCloseOcvCloseOcv

See also

create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProj

Module

OCR/OCV

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH