Vorschau · Entwicklungsstand 1.6.1

Farberkennung

Wofür ist das gedacht?

Wähle eine Bildquelle und die gesuchte Farbe. Die Erkennung filtert zusammenhängende Farbflächen anhand der Mindestkonfidenz, Größe und Breite/Höhe. Verwende found als Bedingung und all_detections für mehrere Treffer; die Pixelkoordinaten werden bei Bildschirmaufnahmen um den Monitorversatz ergänzt.

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
Farbe	Gesuchte Farbe als Hex-Farbwert, zum Beispiel #FF0000 für Rot. Übernimm das vom Editor akzeptierte Format.	#2563EB
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
Mindestfläche (px²)	Kleinste Fläche eines Farbtreffers in Quadratpixeln. Kleine Störflächen werden dadurch ausgeschlossen. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 1.	25
Maximale Fläche (px²)	Größte erlaubte Fläche eines Farbtreffers in Quadratpixeln. Ein zu enger Wert kann das gewünschte Objekt ausschließen. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 1.	2147483647
Mindestbreite (px)	Kleinste erlaubte Breite einer erkannten Farbfläche in Pixeln. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 1.	1
Mindesthöhe (px)	Kleinste erlaubte Höhe einer erkannten Farbfläche in Pixeln. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 1.	1
Verkleinerungsfaktor	Faktor der Bildverkleinerung vor der Farbanalyse. Höhere Verkleinerung kann schneller sein, lässt aber kleine Details verschwinden. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 1.	1

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

Bildschirm aufnehmen → Farberkennung mit #FF0000 und Mindestfläche 20 → Wenn found → Text anzeigen.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Prüfe die in dieser Referenz beschriebenen aktiven Pflichtfelder, kompatible Wertequellen und die Voraussetzungen auf dem Zielrechner. Ungültige Quellen oder Typen sind Fehler; eine gültige, aber nicht verfügbare optionale Quelle kann gemäß Eingabevertrag zum Überspringen führen. Ein Fehler beendet die Start-/Hauptphase; die vorgesehene Endphase wird zum Aufräumen behandelt. Der Verlauf zeigt den tatsächlich belegten Status.

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: color_detection

Felder und Zusammenhänge auf einen Blick

1
Bildquelleimage_source · ResultBinding · Nicht angegeben
Bildobjekt eines Aufnahme-Steps
2
Farbecolor_hex · Color · #FF0000
Gesuchte Farbe als Hex-Farbwert, zum Beispiel #FF0000 für Rot
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
Mindestfläche (px²)min_size · Integer · 25
Kleinste Fläche eines Farbtreffers in Quadratpixeln
6
Maximale Fläche (px²)max_size · Integer · 2147483647
Größte erlaubte Fläche eines Farbtreffers in Quadratpixeln
7
Mindestbreite (px)min_width · Integer · 1
Kleinste erlaubte Breite einer erkannten Farbfläche in Pixeln.
8
Mindesthöhe (px)min_height · Integer · 1
Kleinste erlaubte Höhe einer erkannten Farbfläche in Pixeln.
9
Verkleinerungsfaktordownscale_factor · Integer · 1
Faktor der Bildverkleinerung vor der Farbanalyse
10
FoundErgebnis: found · Wert
Ob die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat
11
PointErgebnis: point · Wert
Ermittelter Zielpunkt
12
Point / XErgebnis: point.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
13
Point / YErgebnis: point.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
14
Bounding BoxErgebnis: bounding_box · Wert
Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen
15
Bounding Box / XErgebnis: bounding_box.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
16
Bounding Box / YErgebnis: bounding_box.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
17
Bounding Box / WidthErgebnis: bounding_box.width · Wert
Breite des Ergebnisrechtecks in Pixeln
18
Bounding Box / HeightErgebnis: bounding_box.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
19
Bounding Box / LeftErgebnis: bounding_box.left · Wert
Linke Rechteckkante in Pixeln
20
Bounding Box / TopErgebnis: bounding_box.top · Wert
Obere Rechteckkante in Pixeln
21
Bounding Box / RightErgebnis: bounding_box.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
22
Bounding Box / BottomErgebnis: bounding_box.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
23
Bounding Box / Is EmptyErgebnis: bounding_box.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
24
Bounding Box / LocationErgebnis: bounding_box.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
25
Bounding Box / Location / XErgebnis: bounding_box.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
26
Bounding Box / Location / YErgebnis: bounding_box.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
27
Bounding Box / CenterErgebnis: bounding_box.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
28
Bounding Box / Center / XErgebnis: bounding_box.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
29
Bounding Box / Center / YErgebnis: bounding_box.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
30
ConfidenceErgebnis: confidence · Wert
Normalisierte Trefferkonfidenz zwischen 0 und 1
31
Source Capture Is FreshErgebnis: source_capture_is_fresh · Wert
Frischezustand der verwendeten Aufnahme, unverändert in das Erkennungsergebnis übernommen
32
Source Capture Timestamp UtcErgebnis: source_capture_timestamp_utc · Wert
UTC-Aufnahmezeit der Bildquelle, aus der dieses Ergebnis berechnet wurde
33
Source Frame VersionErgebnis: source_frame_version · Wert
Frame-Identität der verwendeten Bildquelle; auch ein Erkennungsfehlschlag behält die Herkunftsinformation
34
Source Frame TimestampErgebnis: source_frame_timestamp · Wert
Monotoner Zeitstempel des zugrunde liegenden Frames
35
Applied RoiErgebnis: applied_roi · Wert
Tatsächlich angewendeter Suchbereich
36
Applied Roi / XErgebnis: applied_roi.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
37
Applied Roi / YErgebnis: applied_roi.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
38
Applied Roi / WidthErgebnis: applied_roi.width · Wert
Breite des Ergebnisrechtecks in Pixeln
39
Applied Roi / HeightErgebnis: applied_roi.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
40
Applied Roi / LeftErgebnis: applied_roi.left · Wert
Linke Rechteckkante in Pixeln
41
Applied Roi / TopErgebnis: applied_roi.top · Wert
Obere Rechteckkante in Pixeln
42
Applied Roi / RightErgebnis: applied_roi.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
43
Applied Roi / BottomErgebnis: applied_roi.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
44
Applied Roi / Is EmptyErgebnis: applied_roi.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
45
Applied Roi / LocationErgebnis: applied_roi.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
46
Applied Roi / Location / XErgebnis: applied_roi.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
47
Applied Roi / Location / YErgebnis: applied_roi.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
48
Applied Roi / CenterErgebnis: applied_roi.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
49
Applied Roi / Center / XErgebnis: applied_roi.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
50
Applied Roi / Center / YErgebnis: applied_roi.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
51
Used Dynamic RoiErgebnis: used_dynamic_roi · Wert
Ob für diese Auswertung ein dynamischer Suchbereich verwendet wurde
52
All DetectionsErgebnis: all_detections · Wert
Liste einzelner Erkennungen mit eigenen Punkten, Rechtecken und Konfidenzen
53
All Detections / CountErgebnis: all_detections.count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
54
All Detections[] / CenterErgebnis: all_detections.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
55
All Detections[] / Center / XErgebnis: all_detections.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
56
All Detections[] / Center / YErgebnis: all_detections.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
57
All Detections[] / Bounding BoxErgebnis: all_detections.bounding_box · Wert
Begrenzendes Rechteck eines Treffers; bei fehlender Erkennung kann ein optionales Rechteck fehlen
58
All Detections[] / Bounding Box / XErgebnis: all_detections.bounding_box.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
59
All Detections[] / Bounding Box / YErgebnis: all_detections.bounding_box.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
60
All Detections[] / Bounding Box / WidthErgebnis: all_detections.bounding_box.width · Wert
Breite des Ergebnisrechtecks in Pixeln
61
All Detections[] / Bounding Box / HeightErgebnis: all_detections.bounding_box.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
62
All Detections[] / Bounding Box / LeftErgebnis: all_detections.bounding_box.left · Wert
Linke Rechteckkante in Pixeln
63
All Detections[] / Bounding Box / TopErgebnis: all_detections.bounding_box.top · Wert
Obere Rechteckkante in Pixeln
64
All Detections[] / Bounding Box / RightErgebnis: all_detections.bounding_box.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
65
All Detections[] / Bounding Box / BottomErgebnis: all_detections.bounding_box.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
66
All Detections[] / Bounding Box / Is EmptyErgebnis: all_detections.bounding_box.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
67
All Detections[] / Bounding Box / LocationErgebnis: all_detections.bounding_box.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
68
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
69
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
70
All Detections[] / Bounding Box / CenterErgebnis: all_detections.bounding_box.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
71
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
72
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
73
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.
Farbe `color_hex`	`Color`	`#FF0000`	Pflichtfeld	Gesuchte Farbe als Hex-Farbwert, zum Beispiel #FF0000 für Rot. Übernimm das vom Editor akzeptierte Format.
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.
Mindestfläche (px²) `min_size`	`Integer`	`25`	Regeln siehe Erklärung Grenzen: `{"Minimum": 1}`	Kleinste Fläche eines Farbtreffers in Quadratpixeln. Kleine Störflächen werden dadurch ausgeschlossen.
Maximale Fläche (px²) `max_size`	`Integer`	`2147483647`	Regeln siehe Erklärung Grenzen: `{"Minimum": 1}`	Größte erlaubte Fläche eines Farbtreffers in Quadratpixeln. Ein zu enger Wert kann das gewünschte Objekt ausschließen.
Mindestbreite (px) `min_width`	`Integer`	`1`	Regeln siehe Erklärung Grenzen: `{"Minimum": 1}`	Kleinste erlaubte Breite einer erkannten Farbfläche in Pixeln.
Mindesthöhe (px) `min_height`	`Integer`	`1`	Regeln siehe Erklärung Grenzen: `{"Minimum": 1}`	Kleinste erlaubte Höhe einer erkannten Farbfläche in Pixeln.
Verkleinerungsfaktor `downscale_factor`	`Integer`	`1`	Regeln siehe Erklärung Grenzen: `{"Minimum": 1}`	Faktor der Bildverkleinerung vor der Farbanalyse. Höhere Verkleinerung kann schneller sein, lässt aber kleine Details verschwinden.

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`	`ColorDetectionSettings`	`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.color_hex`	`String`	`#FF0000`	Gesuchte Farbe als Hex-Farbwert, zum Beispiel #FF0000 für Rot. Übernimm das vom Editor akzeptierte Format.
`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.downscale_factor`	`Int32`	`1`	Faktor der Bildverkleinerung vor der Farbanalyse. Höhere Verkleinerung kann schneller sein, lässt aber kleine Details verschwinden.
`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.max_size`	`Int32`	`2147483647`	Größte erlaubte Fläche eines Farbtreffers in Quadratpixeln. Ein zu enger Wert kann das gewünschte Objekt ausschließen.
`settings.min_height`	`Int32`	`1`	Kleinste erlaubte Höhe einer erkannten Farbfläche in Pixeln.
`settings.min_size`	`Int32`	`25`	Kleinste Fläche eines Farbtreffers in Quadratpixeln. Kleine Störflächen werden dadurch ausgeschlossen.
`settings.min_width`	`Int32`	`1`	Kleinste erlaubte Breite einer erkannten Farbfläche in Pixeln.
`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.

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": "color_detection",
  "settings": {
    "color_hex": "#FF0000",
    "confidence_threshold": 0.9,
    "min_size": 25,
    "max_size": 2147483647,
    "min_width": 1,
    "min_height": 1,
    "downscale_factor": 1,
    "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": "cc6df427-37e9-687a-3dfa-9333bf16bb90",
  "inputs": {},
  "is_enabled": true
}