HALCON Website / HALCON Operator-Referenz / Inspektion / OCV
KlassenKlassenKlassenKlassen | | | | Operatoren

do_ocv_simpledo_ocv_simpleDoOcvSimpledo_ocv_simpleDoOcvSimpleDoOcvSimple (Operator)

Name

do_ocv_simpledo_ocv_simpleDoOcvSimpledo_ocv_simpleDoOcvSimpleDoOcvSimple — Bewerten eines Zeichens mit einem OCV-Tool.

Signatur

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)

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

Herror do_ocv_simple(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)

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

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

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

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

void HOperatorSetX.DoOcvSimple(
[in] IHUntypedObjectX* Pattern, [in] VARIANT OCVHandle, [in] VARIANT PatternName, [in] VARIANT AdaptPos, [in] VARIANT AdaptSize, [in] VARIANT AdaptAngle, [in] VARIANT AdaptGray, [in] VARIANT Threshold, [out] VARIANT* Quality)

VARIANT HImageX.DoOcvSimple(
[in] IHOCVX* OCVHandle, [in] VARIANT PatternName, [in] BSTR AdaptPos, [in] BSTR AdaptSize, [in] BSTR AdaptAngle, [in] BSTR AdaptGray, [in] double Threshold)

VARIANT HOCVX.DoOcvSimple(
[in] IHImageX* Pattern, [in] VARIANT PatternName, [in] BSTR AdaptPos, [in] BSTR AdaptSize, [in] BSTR AdaptAngle, [in] BSTR AdaptGray, [in] double Threshold)

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)

Beschreibung

do_ocv_simpledo_ocv_simpleDoOcvSimpledo_ocv_simpleDoOcvSimpleDoOcvSimple bewertet das übergebene Zeichen (PatternPatternPatternPatternPatternpattern). Das Zeichen muss vorher mit dem OCV-Tool trainiert worden sein. Die Region sollte dabei in etwa die gleiche (relative) Ausdehnung und Form haben wie beim Training. Zur Kennzeichnung des Zeichens wird der gleichen Name wie beim Training in PatternNamePatternNamePatternNamePatternNamePatternNamepatternName übergeben. Über die nächsten vier Parameter kann dann Einfluss auf die automatische Anpassung genommen werden: AdaptPosAdaptPosAdaptPosAdaptPosAdaptPosadaptPos und AdaptSizeAdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize beziehen sich auf die Geometrie des Zeichens. Mit AdaptPosAdaptPosAdaptPosAdaptPosAdaptPosadaptPos wird festgelegt, ob eine Verschiebung des Zeichens kompensiert werden soll. AdaptSizeAdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize legt fest, ob eine Größenveränderung angepasst werden soll. AdaptAngleAdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngle ist nicht implementiert. Der Parameter AdaptGrayAdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGray bezieht sich auf die Grauwertanpassung. Zum einen wird eine additive Grauwertänderung kompensiert, gleichzeitig wird eine multiplikative Grauwertänderung angepasst.

Der Parameter ThresholdThresholdThresholdThresholdThresholdthreshold gibt den Mindestunterschied der Grauwerte an, der als Fehler interpretiert wird. Als Resultat ergibt sich dann der Prozentsatz der fehlerhaften Pixel. Wird mit dem Parameter ThresholdThresholdThresholdThresholdThresholdthreshold eine Schwelle kleiner als 0 übergeben, besteht das Resultat stattdessen in der Summe aller Abweichungen normiert auf die Fla"che der Region.

Das Ergebnis des Operators ist eine Bewertung des Zeichens. Dies ist der Unterschied der Grauwerte zwischen dem aktuellen Zeichen und dem Trainingszeichen nach den entsprechenden automatischen Anpassungen. Der Wert von QualityQualityQualityQualityQualityquality liegt zwischen 0 und 1. Der Wert 1 bedeutet, dass das Zeichen mit dem Muster identisch ist. Der Wert 0 steht für eine sehr große Abweichung.

Parallelisierung

Parameter

PatternPatternPatternPatternPatternpattern (input_object)  singlechannelimage(-array) → objectHImageHImageHImageHImageXHobject (byte)

Zu bewertendes Zeichen.

OCVHandleOCVHandleOCVHandleOCVHandleOCVHandleOCVHandle (input_control)  ocv → HOCV, HTupleHTupleHOCV, HTupleHOCVX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des OCV-Tools.

PatternNamePatternNamePatternNamePatternNamePatternNamepatternName (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name des Zeichens.

Defaultwert: 'a' "a" "a" "a" "a" "a"

AdaptPosAdaptPosAdaptPosAdaptPosAdaptPosadaptPos (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Anpassung an horizontale und vertikale Verschiebung.

Defaultwert: 'true' "true" "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

AdaptSizeAdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSize (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Anpassung an horizontale und vertikale Größenveränderung.

Defaultwert: 'true' "true" "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

AdaptAngleAdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngle (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Anpassung der Orientierung (nicht implementiert).

Defaultwert: 'false' "false" "false" "false" "false" "false"

Werteliste: 'false'"false""false""false""false""false"

AdaptGrayAdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGray (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Anpassung an additive und multiplikative Grauwertänderungen.

Defaultwert: 'true' "true" "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

ThresholdThresholdThresholdThresholdThresholdthreshold (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Mindestdifferenz der Muster.

Defaultwert: 10

Wertevorschläge: -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

QualityQualityQualityQualityQualityquality (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Bewertung des Zeichens.

Typischer Wertebereich: 0.0 ≤ Quality Quality Quality Quality Quality quality ≤ 1.0

Ergebnis

do_ocv_simpledo_ocv_simpleDoOcvSimpledo_ocv_simpleDoOcvSimpleDoOcvSimple liefert den Wert 2 (H_MSG_TRUE), falls das Handle und die Vergleichsdaten gültig sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox, trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox, read_ocvread_ocvReadOcvread_ocvReadOcvReadOcv, thresholdthresholdThresholdthresholdThresholdThreshold, connectionconnectionConnectionconnectionConnectionConnection, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape

Nachfolger

close_ocvclose_ocvCloseOcvclose_ocvCloseOcvCloseOcv

Siehe auch

create_ocv_projcreate_ocv_projCreateOcvProjcreate_ocv_projCreateOcvProjCreateOcvProj

Modul

OCR/OCV

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH