Vorschau · Entwicklungsstand 1.6.1

Bildvorlage erkennen

Wofür ist das gedacht?

Vergleiche eine Pixelvorlage mit der Bildquelle. Wähle eine der drei unterstützten normalisierten Methoden und einen Schwellenwert. „Mehrere Treffer“ liefert mehrere Erkennungen; alle Konfidenzen werden als 0 bis 1 ausgegeben, auch bei SqDiffNormed, dessen Rohscore intern umgekehrt bewertet wird.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

Einstellung	Bedeutung und Bedienung	Beispielwert
Bildquelle	Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle.	Bildaufnahme → Bild
Bildvorlage	Pfad zur lokalen Bildvorlage. Die Datei muss vorhanden und lesbar sein; für Pixelvorlagen darf sie nicht größer als der Suchbereich sein.	C:\Beispiele\Vorlage.png
Konfidenz (%)	Mindestkonfidenz als Anteil von 0 bis 1, auch im referenzierten localValues-Wert: 0.9 bedeutet 90 %. Der Editor zeigt Prozent an. Zulässiger Bereich: ab 0 % bis 100 %.	90.0 %
Bildbereich (ROI)	Suchrechteck in Pixeln relativ zur Bildquelle. x/y bestimmen die linke obere Ecke, width/height die Größe; es muss zur Quelle passen. Im Bereich „Erweitert“ verfügbar.	X = 100, Y = 80, Breite = 320, Höhe = 180
Vergleichsmethode	Vergleichsmethode für die Pixelvorlage. Im aktuellen Step sind ausschließlich die drei normalisierten Methoden CCoeffNormed, CCorrNormed und SqDiffNormed gültig. Im Bereich „Erweitert“ verfügbar. Korrelationskoeffizient (normalisiert) Normalisierte Korrelation mit Zentrierung; Ergebnis-Konfidenz 0 bis 1. Korrelation (normalisiert) Normalisierte Kreuzkorrelation; Ergebnis-Konfidenz 0 bis 1. Quadratische Differenz (normalisiert) Normalisierte quadratische Differenz. Intern ist ein kleiner Rohwert besser; der Step gibt daraus eine höhere normalisierte Konfidenz aus.	Korrelationskoeffizient (normalisiert)
Mehrere Treffer zurückgeben	true liefert mehrere Template-Treffer nach Unterdrückung benachbarter Treffer; false verwendet nur den besten Treffer.	Aus (Häkchen entfernt)

Eingaben innerhalb zusammengesetzter Einstellungen

Diese Felder erscheinen innerhalb der jeweiligen Einstellung und je nach gewählter Aktion oder Quelle. Bei einer Ergebnisquelle wählst du den passenden vorherigen Step statt eines direkten Werts.

Einstellung / Unterfeld	Bedeutung und Bedienung	Beispielwert
Festen Bildbereich verwenden	Aktiviert den direkt konfigurierten Suchbereich. Ohne Aktivierung wird der Standardbereich der Quelle verwendet, sofern keine dynamische ROI-Quelle greift.	Aus (Häkchen entfernt)
Bildbereich › Höhe (px)	Höhe des Rechtecks oder Bildformats in Pixeln. Negative Größen sind kein gültiger Suchbereich.	0
Bildbereich › Breite (px)	Breite des Rechtecks oder Bildformats in Pixeln. Zusammen mit Höhe und Ursprung ergibt sie die räumliche Größe.	0
Bildbereich › X (px)	Horizontale Position der linken oberen Ecke des Suchrechtecks in Pixeln relativ zum Quellbild. Beispiel 100 startet den Bereich bei Bildkoordinate X = 100; Bildschirm- und Bildkoordinaten können voneinander abweichen.	0
Bildbereich › Y (px)	Vertikale Position der linken oberen Ecke des Suchrechtecks in Pixeln relativ zum Quellbild. Beispiel 100 startet den Bereich bei Bildkoordinate Y = 100; Bildschirm- und Bildkoordinaten können voneinander abweichen.	0

Ergebniswerte verwenden

Ergebnis	Bedeutung
Found	Ob die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat. false ist ein fachliches Ergebnis und nicht automatisch ein Step-Fehler. Einzelwert dieses Ergebnisses.
Point	Ermittelter Zielpunkt. Bei Bildschirmquellen ist der Quelle-zu-Desktop-Versatz bereits entsprechend dem Ergebnisvertrag berücksichtigt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Point / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Point / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box	Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Width	Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Height	Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Left	Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Top	Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Right	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Bottom	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Is Empty	Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Location	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Location / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Location / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Center	Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Center / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounding Box / Center / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Confidence	Normalisierte Trefferkonfidenz zwischen 0 und 1. 0.9 entspricht 90 %; mehrere Treffer können unterschiedliche Konfidenzen besitzen. Einzelwert dieses Ergebnisses.
Source Capture Is Fresh	Frischezustand der verwendeten Aufnahme, unverändert in das Erkennungsergebnis übernommen. Einzelwert dieses Ergebnisses.
Source Capture Timestamp Utc	UTC-Aufnahmezeit der Bildquelle, aus der dieses Ergebnis berechnet wurde. Einzelwert dieses Ergebnisses.
Source Frame Version	Frame-Identität der verwendeten Bildquelle; auch ein Erkennungsfehlschlag behält die Herkunftsinformation. Einzelwert dieses Ergebnisses.
Source Frame Timestamp	Monotoner Zeitstempel des zugrunde liegenden Frames. 0 bedeutet unbekannte zeitliche Herkunft. Einzelwert dieses Ergebnisses.
Applied Roi	Tatsächlich angewendeter Suchbereich. Damit lässt sich prüfen, ob eine direkte oder dynamische Eingrenzung aktiv war. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Width	Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Height	Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Left	Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Top	Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Right	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Bottom	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Is Empty	Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Location	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Location / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Location / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Center	Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Center / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Applied Roi / Center / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Used Dynamic Roi	Ob für diese Auswertung ein dynamischer Suchbereich verwendet wurde. Einzelwert dieses Ergebnisses.
All Detections	Liste einzelner Erkennungen mit eigenen Punkten, Rechtecken und Konfidenzen. Die Anzahl ist nicht gleich einer pauschalen Erfolgsbewertung. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections / Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
All Detections[] / Center	Mittelpunkt einer einzelnen Erkennung in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Center / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Center / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box	Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Width	Breite des Ergebnisrechtecks in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Height	Höhe des Ergebnisrechtecks in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Left	Linke Rechteckkante in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Top	Obere Rechteckkante in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Right	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Bottom	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Is Empty	Ob die Zwischenablage im abgefragten Kontext leer ist. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Location	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Location / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Location / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Center	Mittelpunkt einer einzelnen Erkennung in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Center / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Bounding Box / Center / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
All Detections[] / Confidence	Normalisierte Trefferkonfidenz zwischen 0 und 1. 0.9 entspricht 90 %; mehrere Treffer können unterschiedliche Konfidenzen besitzen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.

Beispiel

Bildschirmaufnahme mit einer lokalen Symbolvorlage vergleichen, CCoeffNormed und Schwellenwert 0,9 wählen, danach found prüfen.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Nur CCoeffNormed, CCorrNormed und SqDiffNormed sind im aktuellen Step unterstützt. Andere Namen aus der OpenCV-Enumeration sind in der technischen Typaufzählung sichtbar, aber keine gültige Step-Konfiguration. Prüfe außerdem Vorlagendatei, Bildquelle und Bildgrößen.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: template_matching

Felder und Zusammenhänge auf einen Blick

1
Bildquelleimage_source · ResultBinding · Nicht angegeben
Bildobjekt eines Aufnahme-Steps
2
Bildvorlagetemplate_path · FilePath · Nicht angegeben
Pfad zur lokalen Bildvorlage
3
Konfidenz (%)confidence_threshold · Number · 0.9
Mindestkonfidenz als Anteil von 0 bis 1, auch im referenzierten localValues-Wert: 0.9 bedeutet 90 %
4
Bildbereich (ROI)roi · Object · {"enabled": false, "x": 0, "y": 0, "width": 0, "height": 0, "dynamic_source": null}
Suchrechteck in Pixeln relativ zur Bildquelle
5
Vergleichsmethodetemplate_match_mode · Enum · CCoeffNormed, CCorrNormed, SqDiffNormed
Vergleichsmethode für die Pixelvorlage
6
Mehrere Treffer zurückgebenmultiple_points · Boolean · false
true liefert mehrere Template-Treffer nach Unterdrückung benachbarter Treffer; false verwendet nur den besten Treffer.
7
FoundErgebnis: found · Wert
Ob die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat
8
PointErgebnis: point · Wert
Ermittelter Zielpunkt
9
Point / XErgebnis: point.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
10
Point / YErgebnis: point.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
11
Bounding BoxErgebnis: bounding_box · Wert
Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen
12
Bounding Box / XErgebnis: bounding_box.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
13
Bounding Box / YErgebnis: bounding_box.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
14
Bounding Box / WidthErgebnis: bounding_box.width · Wert
Breite des Ergebnisrechtecks in Pixeln
15
Bounding Box / HeightErgebnis: bounding_box.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
16
Bounding Box / LeftErgebnis: bounding_box.left · Wert
Linke Rechteckkante in Pixeln
17
Bounding Box / TopErgebnis: bounding_box.top · Wert
Obere Rechteckkante in Pixeln
18
Bounding Box / RightErgebnis: bounding_box.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
19
Bounding Box / BottomErgebnis: bounding_box.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
20
Bounding Box / Is EmptyErgebnis: bounding_box.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
21
Bounding Box / LocationErgebnis: bounding_box.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
22
Bounding Box / Location / XErgebnis: bounding_box.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
23
Bounding Box / Location / YErgebnis: bounding_box.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
24
Bounding Box / CenterErgebnis: bounding_box.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
25
Bounding Box / Center / XErgebnis: bounding_box.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
26
Bounding Box / Center / YErgebnis: bounding_box.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
27
ConfidenceErgebnis: confidence · Wert
Normalisierte Trefferkonfidenz zwischen 0 und 1
28
Source Capture Is FreshErgebnis: source_capture_is_fresh · Wert
Frischezustand der verwendeten Aufnahme, unverändert in das Erkennungsergebnis übernommen
29
Source Capture Timestamp UtcErgebnis: source_capture_timestamp_utc · Wert
UTC-Aufnahmezeit der Bildquelle, aus der dieses Ergebnis berechnet wurde
30
Source Frame VersionErgebnis: source_frame_version · Wert
Frame-Identität der verwendeten Bildquelle; auch ein Erkennungsfehlschlag behält die Herkunftsinformation
31
Source Frame TimestampErgebnis: source_frame_timestamp · Wert
Monotoner Zeitstempel des zugrunde liegenden Frames
32
Applied RoiErgebnis: applied_roi · Wert
Tatsächlich angewendeter Suchbereich
33
Applied Roi / XErgebnis: applied_roi.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
34
Applied Roi / YErgebnis: applied_roi.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
35
Applied Roi / WidthErgebnis: applied_roi.width · Wert
Breite des Ergebnisrechtecks in Pixeln
36
Applied Roi / HeightErgebnis: applied_roi.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
37
Applied Roi / LeftErgebnis: applied_roi.left · Wert
Linke Rechteckkante in Pixeln
38
Applied Roi / TopErgebnis: applied_roi.top · Wert
Obere Rechteckkante in Pixeln
39
Applied Roi / RightErgebnis: applied_roi.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
40
Applied Roi / BottomErgebnis: applied_roi.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
41
Applied Roi / Is EmptyErgebnis: applied_roi.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
42
Applied Roi / LocationErgebnis: applied_roi.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
43
Applied Roi / Location / XErgebnis: applied_roi.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
44
Applied Roi / Location / YErgebnis: applied_roi.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
45
Applied Roi / CenterErgebnis: applied_roi.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
46
Applied Roi / Center / XErgebnis: applied_roi.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
47
Applied Roi / Center / YErgebnis: applied_roi.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
48
Used Dynamic RoiErgebnis: used_dynamic_roi · Wert
Ob für diese Auswertung ein dynamischer Suchbereich verwendet wurde
49
All DetectionsErgebnis: all_detections · Wert
Liste einzelner Erkennungen mit eigenen Punkten, Rechtecken und Konfidenzen
50
All Detections / CountErgebnis: all_detections.count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
51
All Detections[] / CenterErgebnis: all_detections.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
52
All Detections[] / Center / XErgebnis: all_detections.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
53
All Detections[] / Center / YErgebnis: all_detections.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
54
All Detections[] / Bounding BoxErgebnis: all_detections.bounding_box · Wert
Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen
55
All Detections[] / Bounding Box / XErgebnis: all_detections.bounding_box.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
56
All Detections[] / Bounding Box / YErgebnis: all_detections.bounding_box.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
57
All Detections[] / Bounding Box / WidthErgebnis: all_detections.bounding_box.width · Wert
Breite des Ergebnisrechtecks in Pixeln
58
All Detections[] / Bounding Box / HeightErgebnis: all_detections.bounding_box.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
59
All Detections[] / Bounding Box / LeftErgebnis: all_detections.bounding_box.left · Wert
Linke Rechteckkante in Pixeln
60
All Detections[] / Bounding Box / TopErgebnis: all_detections.bounding_box.top · Wert
Obere Rechteckkante in Pixeln
61
All Detections[] / Bounding Box / RightErgebnis: all_detections.bounding_box.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
62
All Detections[] / Bounding Box / BottomErgebnis: all_detections.bounding_box.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
63
All Detections[] / Bounding Box / Is EmptyErgebnis: all_detections.bounding_box.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
64
All Detections[] / Bounding Box / LocationErgebnis: all_detections.bounding_box.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
65
All Detections[] / Bounding Box / Location / XErgebnis: all_detections.bounding_box.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
66
All Detections[] / Bounding Box / Location / YErgebnis: all_detections.bounding_box.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
67
All Detections[] / Bounding Box / CenterErgebnis: all_detections.bounding_box.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
68
All Detections[] / Bounding Box / Center / XErgebnis: all_detections.bounding_box.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
69
All Detections[] / Bounding Box / Center / YErgebnis: all_detections.bounding_box.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
70
All Detections[] / ConfidenceErgebnis: all_detections.confidence · Wert
Normalisierte Trefferkonfidenz zwischen 0 und 1

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
Bildquelle `image_source`	`ResultBinding`	`Nicht angegeben`	Pflichtfeld	Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle.
Bildvorlage `template_path`	`FilePath`	`Nicht angegeben`	Pflichtfeld	Pfad zur lokalen Bildvorlage. Die Datei muss vorhanden und lesbar sein; für Pixelvorlagen darf sie nicht größer als der Suchbereich sein.
Konfidenz (%) `confidence_threshold`	`Number`	`0.9`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0, "Maximum": 1}`	Mindestkonfidenz als Anteil von 0 bis 1, auch im referenzierten localValues-Wert: 0.9 bedeutet 90 %. Der Editor zeigt Prozent an.
Bildbereich (ROI) `roi`	`Object`	`{"enabled": false, "x": 0, "y": 0, "width": 0, "height": 0, "dynamic_source": null}`	Regeln siehe Erklärung	Suchrechteck in Pixeln relativ zur Bildquelle. x/y bestimmen die linke obere Ecke, width/height die Größe; es muss zur Quelle passen.
Vergleichsmethode `template_match_mode`	`Enum`	`CCoeffNormed`	Pflichtfeld `["CCoeffNormed", "CCorrNormed", "SqDiffNormed"]`	Vergleichsmethode für die Pixelvorlage. Im aktuellen Step sind ausschließlich die drei normalisierten Methoden CCoeffNormed, CCorrNormed und SqDiffNormed gültig. `CCoeffNormed` Normalisierte Korrelation mit Zentrierung; Ergebnis-Konfidenz 0 bis 1. `CCorrNormed` Normalisierte Kreuzkorrelation; Ergebnis-Konfidenz 0 bis 1. `SqDiffNormed` Normalisierte quadratische Differenz. Intern ist ein kleiner Rohwert besser; der Step gibt daraus eine höhere normalisierte Konfidenz aus.
Mehrere Treffer zurückgeben `multiple_points`	`Boolean`	`false`	Regeln siehe Erklärung	true liefert mehrere Template-Treffer nach Unterdrückung benachbarter Treffer; false verwendet nur den besten Treffer.

JSON-Felder und verschachtelte Einstellungen

Technische Feldnamen des Modells. Die Einstellungsfelder oben beschreiben die UI; die JSON-Vorlage zeigt die tatsächliche Schreibweise. Bei aktuellen inputs/localValues stammen aktive Werte aus den Referenzen. Die Modell-Standardwerte und Enum-Namen sind keine universelle JSON-Schreibweise.

Feld	Modelltyp	Modell-Standard / Optionen	Erklärung
`id`	`String`	`Nicht angegeben`	Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.
`inputs`	Dictionary`2	`Nicht angegeben`	Zuordnung von UI-Feld-ID zu typisierter Wertequelle. Bei vorhandenen inputs serialisiert der kanonische Job-Serializer settings nicht zusätzlich. Leere inputs mit settings bleiben als Legacy-/direkte Konfiguration lesbar.
`inputs.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`inputs.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`inputs.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`inputs.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`inputs.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`inputs.provider_id`	`String`	`Nicht angegeben`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`inputs.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`inputs.source_id`	`String`	`Nicht angegeben`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`inputs.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`is_enabled`	`Boolean`	`true`	true führt den Step aus; false deaktiviert ihn. Blockmarker können in der UI nicht beliebig deaktiviert werden, weil ihre Struktur erhalten bleiben muss.
`settings`	`TemplateMatchingSettings`	`Nicht angegeben`	Direkte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
`settings.confidence_threshold`	`Double`	`0.9`	Mindestkonfidenz als Anteil von 0 bis 1, auch im referenzierten localValues-Wert: 0.9 bedeutet 90 %. Der Editor zeigt Prozent an.
`settings.dynamic_roi_source`	`ResultBinding`	`Nicht angegeben`	Kompatible dynamische Rechteckquelle. Eine spätere DynamicRoi-Quelle darf Feedback für den nächsten Durchlauf liefern; dies ist eine besondere Ausnahme von normalen Vorwärtsreferenzen.
`settings.dynamic_roi_source.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.dynamic_roi_source.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`settings.dynamic_roi_source.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`settings.dynamic_roi_source.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.dynamic_roi_source.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`settings.dynamic_roi_source.provider_id`	`String`	`Leerer Text`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`settings.dynamic_roi_source.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`settings.dynamic_roi_source.source_id`	`String`	`Leerer Text`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`settings.dynamic_roi_source.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`settings.enable_roi`	`Boolean`	`false`	Aktiviert den direkt konfigurierten Suchbereich. Ohne Aktivierung wird der Standardbereich der Quelle verwendet, sofern keine dynamische ROI-Quelle greift.
`settings.image_source`	`ResultBinding`	`Nicht angegeben`	Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle.
`settings.image_source.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.image_source.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`settings.image_source.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`settings.image_source.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.image_source.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`settings.image_source.provider_id`	`String`	`Leerer Text`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`settings.image_source.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`settings.image_source.source_id`	`String`	`Leerer Text`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`settings.image_source.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`settings.multiple_points`	`Boolean`	`false`	true liefert mehrere Template-Treffer nach Unterdrückung benachbarter Treffer; false verwendet nur den besten Treffer.
`settings.roi`	`PixelRegion`	`{"x": 0, "y": 0, "width": 0, "height": 0}`	Suchrechteck in Pixeln relativ zur Bildquelle. x/y bestimmen die linke obere Ecke, width/height die Größe; es muss zur Quelle passen.
`settings.roi.Empty`	`PixelRegion`	`{"x": 0, "y": 0, "width": 0, "height": 0}`	Vom serialisierten Geometrieobjekt angebotener Leerzustand. Kein eigener ROI-Schalter: den Suchbereich mit enable_roi beziehungsweise roi.enabled und den Koordinaten konfigurieren; dieses abgeleitete Mitglied nicht als Eingabequelle verwenden.
`settings.roi.height`	`Int32`	`0`	Höhe des Rechtecks oder Bildformats in Pixeln. Negative Größen sind kein gültiger Suchbereich.
`settings.roi.width`	`Int32`	`0`	Breite des Rechtecks oder Bildformats in Pixeln. Zusammen mit Höhe und Ursprung ergibt sie die räumliche Größe.
`settings.roi.x`	`Int32`	`0`	Horizontale Position der linken oberen Ecke des Suchrechtecks in Pixeln relativ zum Quellbild. Beispiel 100 startet den Bereich bei Bildkoordinate X = 100; Bildschirm- und Bildkoordinaten können voneinander abweichen.
`settings.roi.y`	`Int32`	`0`	Vertikale Position der linken oberen Ecke des Suchrechtecks in Pixeln relativ zum Quellbild. Beispiel 100 startet den Bereich bei Bildkoordinate Y = 100; Bildschirm- und Bildkoordinaten können voneinander abweichen.
`settings.template_match_mode`	`TemplateMatchModes`	`CCoeffNormed` `["SqDiff", "SqDiffNormed", "CCorr", "CCorrNormed", "CCoeff", "CCoeffNormed"]`	Vergleichsmethode für die Pixelvorlage. Im aktuellen Step sind ausschließlich die drei normalisierten Methoden CCoeffNormed, CCorrNormed und SqDiffNormed gültig. `SqDiff` OpenCV-Typwert, im aktuellen Template-Step nicht unterstützt; SqDiffNormed verwenden. `SqDiffNormed` Normalisierte quadratische Differenz. Intern ist ein kleiner Rohwert besser; der Step gibt daraus eine höhere normalisierte Konfidenz aus. `CCorr` OpenCV-Typwert, im aktuellen Template-Step nicht unterstützt; CCorrNormed verwenden. `CCorrNormed` Normalisierte Kreuzkorrelation; Ergebnis-Konfidenz 0 bis 1. `CCoeff` OpenCV-Typwert, im aktuellen Template-Step nicht unterstützt; CCoeffNormed verwenden. `CCoeffNormed` Normalisierte Korrelation mit Zentrierung; Ergebnis-Konfidenz 0 bis 1.
`settings.template_path`	`String`	`Leerer Text`	Pfad zur lokalen Bildvorlage. Die Datei muss vorhanden und lesbar sein; für Pixelvorlagen darf sie nicht größer als der Suchbereich sein.

Eingabeverträge

Eingabe	Fehlende Werte	Listen	Akzeptierte Typen / Quellen	Erklärung
`image`	`FailStep`	`NotApplicable`	`[{"ValueKind": "Image", "Cardinalities": ["Single", "OptionalSingle"]}]` `["step_result"]`	Bildobjekt einer Aufnahme. Fehlende erforderliche Werte führen zum Fehler. Es wird kein beliebiges Listenelement ausgewählt. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung.
`dynamicRoi`	`SkipStep`	`FirstValue`	`[{"ValueKind": "Rectangle", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}]` `["job_variable", "step_result"]`	dynamischer Suchbereich. Eine gültige, aber noch nicht verfügbare optionale Step-Quelle kann den Verbraucher mit NoInput überspringen; malformed Referenzen bleiben Fehler. Bei kompatiblen Listen wird der erste Wert verwendet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`found`	`Boolean`	`Single`	Ob die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat. false ist ein fachliches Ergebnis und nicht automatisch ein Step-Fehler. Einzelwert dieses Ergebnisses.
`point`	`Point`	`OptionalSingle`	Ermittelter Zielpunkt. Bei Bildschirmquellen ist der Quelle-zu-Desktop-Versatz bereits entsprechend dem Ergebnisvertrag berücksichtigt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`point.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`point.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box`	`Rectangle`	`OptionalSingle`	Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.width`	`Integer`	`OptionalSingle`	Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.height`	`Integer`	`OptionalSingle`	Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.left`	`Integer`	`OptionalSingle`	Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.top`	`Integer`	`OptionalSingle`	Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.right`	`Integer`	`OptionalSingle`	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.bottom`	`Integer`	`OptionalSingle`	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.is_empty`	`Boolean`	`OptionalSingle`	Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.location`	`Point`	`OptionalSingle`	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.location.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.location.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.center`	`Point`	`OptionalSingle`	Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.center.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounding_box.center.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`confidence`	`Number`	`Single`	Normalisierte Trefferkonfidenz zwischen 0 und 1. 0.9 entspricht 90 %; mehrere Treffer können unterschiedliche Konfidenzen besitzen. Einzelwert dieses Ergebnisses.
`source_capture_is_fresh`	`Boolean`	`Single`	Frischezustand der verwendeten Aufnahme, unverändert in das Erkennungsergebnis übernommen. Einzelwert dieses Ergebnisses.
`source_capture_timestamp_utc`	`DateTime`	`Single`	UTC-Aufnahmezeit der Bildquelle, aus der dieses Ergebnis berechnet wurde. Einzelwert dieses Ergebnisses.
`source_frame_version`	`Integer`	`Single`	Frame-Identität der verwendeten Bildquelle; auch ein Erkennungsfehlschlag behält die Herkunftsinformation. Einzelwert dieses Ergebnisses.
`source_frame_timestamp`	`Integer`	`Single`	Monotoner Zeitstempel des zugrunde liegenden Frames. 0 bedeutet unbekannte zeitliche Herkunft. Einzelwert dieses Ergebnisses.
`applied_roi`	`Rectangle`	`OptionalSingle`	Tatsächlich angewendeter Suchbereich. Damit lässt sich prüfen, ob eine direkte oder dynamische Eingrenzung aktiv war. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.width`	`Integer`	`OptionalSingle`	Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.height`	`Integer`	`OptionalSingle`	Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.left`	`Integer`	`OptionalSingle`	Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.top`	`Integer`	`OptionalSingle`	Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.right`	`Integer`	`OptionalSingle`	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.bottom`	`Integer`	`OptionalSingle`	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.is_empty`	`Boolean`	`OptionalSingle`	Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.location`	`Point`	`OptionalSingle`	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.location.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.location.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.center`	`Point`	`OptionalSingle`	Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.center.x`	`Integer`	`OptionalSingle`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`applied_roi.center.y`	`Integer`	`OptionalSingle`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`used_dynamic_roi`	`Boolean`	`Single`	Ob für diese Auswertung ein dynamischer Suchbereich verwendet wurde. Einzelwert dieses Ergebnisses.
`all_detections`	`Detection`	`Collection`	Liste einzelner Erkennungen mit eigenen Punkten, Rechtecken und Konfidenzen. Die Anzahl ist nicht gleich einer pauschalen Erfolgsbewertung. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`all_detections.center`	`Point`	`Collection`	Mittelpunkt einer einzelnen Erkennung in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.center.x`	`Integer`	`Collection`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.center.y`	`Integer`	`Collection`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box`	`Rectangle`	`Collection`	Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.x`	`Integer`	`Collection`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.y`	`Integer`	`Collection`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.width`	`Integer`	`Collection`	Breite des Ergebnisrechtecks in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.height`	`Integer`	`Collection`	Höhe des Ergebnisrechtecks in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.left`	`Integer`	`Collection`	Linke Rechteckkante in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.top`	`Integer`	`Collection`	Obere Rechteckkante in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.right`	`Integer`	`Collection`	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.bottom`	`Integer`	`Collection`	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.is_empty`	`Boolean`	`Collection`	Ob die Zwischenablage im abgefragten Kontext leer ist. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.location`	`Point`	`Collection`	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.location.x`	`Integer`	`Collection`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.location.y`	`Integer`	`Collection`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.center`	`Point`	`Collection`	Mittelpunkt einer einzelnen Erkennung in Pixeln. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.center.x`	`Integer`	`Collection`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.bounding_box.center.y`	`Integer`	`Collection`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`all_detections.confidence`	`Number`	`Collection`	Normalisierte Trefferkonfidenz zwischen 0 und 1. 0.9 entspricht 90 %; mehrere Treffer können unterschiedliche Konfidenzen besitzen. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag

JSON-Vorlage für Textdateien und Agenten

Strukturelle Defaultvorlage direkt vom App-Serializer. Leere Pflichtwerte und Ziele vor Verwendung ergänzen; diese Vorlage ist kein vollständig validierter Ablauf. Bei neuen Jobs den aktuellen inputs/localValues-Vertrag verwenden.

Dateiformate und Regeln · JSON herunterladen

{
  "type": "template_matching",
  "settings": {
    "template_path": "",
    "template_match_mode": "CCoeffNormed",
    "multiple_points": false,
    "confidence_threshold": 0.9,
    "roi": {
      "x": 0,
      "y": 0,
      "width": 0,
      "height": 0
    },
    "enable_roi": false,
    "image_source": {
      "provider_id": "",
      "source_id": ""
    },
    "dynamic_roi_source": {
      "provider_id": "",
      "source_id": ""
    }
  },
  "id": "fecba802-7139-a95a-9712-cc418e4a3527",
  "inputs": {},
  "is_enabled": true
}