do_ocv_simpleT_do_ocv_simpleDoOcvSimpleDoOcvSimpledo_ocv_simple (Operator)
Name
do_ocv_simpleT_do_ocv_simpleDoOcvSimpleDoOcvSimpledo_ocv_simple — Bewerten eines Zeichens mit einem OCV-Tool.
Signatur
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
double HImage::DoOcvSimple(const HOCV& OCVHandle, const wchar_t* PatternName, const wchar_t* AdaptPos, const wchar_t* AdaptSize, const wchar_t* AdaptAngle, const wchar_t* AdaptGray, double Threshold) const
(Nur Windows)
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
double HOCV::DoOcvSimple(const HImage& Pattern, const wchar_t* PatternName, const wchar_t* AdaptPos, const wchar_t* AdaptSize, const wchar_t* AdaptAngle, const wchar_t* AdaptGray, double Threshold) const
(Nur Windows)
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)
def do_ocv_simple(pattern: HObject, ocvhandle: HHandle, pattern_name: MaybeSequence[str], adapt_pos: str, adapt_size: str, adapt_angle: str, adapt_gray: str, threshold: float) -> Sequence[float]
def do_ocv_simple_s(pattern: HObject, ocvhandle: HHandle, pattern_name: MaybeSequence[str], adapt_pos: str, adapt_size: str, adapt_angle: str, adapt_gray: str, threshold: float) -> float
Beschreibung
do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimpledo_ocv_simple 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 gleiche Name wie beim Training
in PatternNamePatternNamePatternNamePatternNamepatternNamepattern_name übergeben. Über die nächsten vier Parameter
kann dann Einfluss auf die automatische Anpassung genommen werden:
AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos und AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size beziehen sich auf die Geometrie
des Zeichens. Mit AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos wird festgelegt, ob eine Verschiebung
des Zeichens kompensiert werden soll. AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size legt fest,
ob eine Größenveränderung angepasst werden soll.
AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle ist nicht implementiert.
Der Parameter AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray 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 Flä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.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
PatternPatternPatternPatternpatternpattern (input_object) singlechannelimage(-array) → objectHImageHObjectHImageHobject (byte)
Zu bewertendes Zeichen.
OCVHandleOCVHandleOCVHandleOCVHandleOCVHandleocvhandle (input_control) ocv → HOCV, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des OCV-Tools.
PatternNamePatternNamePatternNamePatternNamepatternNamepattern_name (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name des Zeichens.
Defaultwert:
'a'
"a"
"a"
"a"
"a"
"a"
AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (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"
AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (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"
AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Anpassung der Orientierung (nicht implementiert).
Defaultwert:
'false'
"false"
"false"
"false"
"false"
"false"
Werteliste: 'false'"false""false""false""false""false"
AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (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 → HTuplefloatHTupleHtuple (real) (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) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Bewertung des Zeichens.
Typischer Wertebereich: 0.0
≤
Quality
Quality
Quality
Quality
quality
quality
≤
1.0
Ergebnis
do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimpledo_ocv_simple liefert den Wert TRUE, falls
das Handle und die Vergleichsdaten gültig sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box,
trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box,
read_ocvread_ocvReadOcvReadOcvReadOcvread_ocv,
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape
Nachfolger
close_ocvclose_ocvCloseOcvCloseOcvCloseOcvclose_ocv
Siehe auch
create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProjcreate_ocv_proj
Modul
OCR/OCV