Histogram

Das Histogramm Control TcHmiVnHistogram generiert ein Histogramm aus einem Bild und zeigt dieses an. Zusätzlich bietet es die Möglichkeit, das Bild vor der Generierung des Histogramms vom Farbformat RGB in ein anderes zu konvertieren. Das Histogramm kann als Linien- oder als Balkendiagramm angezeigt werden. Die Beschreibung der einzelnen Konfigurationsmöglichkeiten finden Sie unter den folgenden Kategorien auf dieser Seite. Zu den jeweiligen Kategorien gibt es Unterkapitel mit weiteren Informationen, Details und Anwendungsbeispielen. Um direkt TwinCAT Vision Bilder aus der SPS verarbeiten zu können, wird zudem die Vision-Erweiterung für den HMI-Server benötigt.

	Für alle folgenden Attribute besitzt das Control eine Getter- und eine Setter-Methode. Zum Beispiel existieren für das Attribut `LabelColor` die beiden Methoden `getLabelColor(): SolidColor` und `setLabelColor(value: SolidColor): void`. Die Benutzung der Attribute wird in den verlinkten Unterkapiteln näher erklärt. Alle weiteren Attribute, Events und Permissions die die Basisklasse Controls bereitstellt, finden Sie in der TwinCAT HMI Dokumentation.

Kategorie: Colors

Attribut	Typ	Beschreibung
`HistogramBackgroundColor`	`Color`	Hintergrundfarbe des Histogramms.
`SelectionColor`	`Color`	Farbe der Auswahlmarkierung auf dem Histogramm.
`GridLineColor`	`Color`	Farbe der Rasterlinien auf dem Histogramm.
`LabelColor`	`Color`	Farbe der Labels, welche die Rasterlinien mit Häufigkeitswerten beschriften.
`InfobarForegroundColor`	`Color`	Vordergrundfarbe der Infobar.

Kategorie: Common

Die folgenden Attribute legen die Ressource und die Ansicht des Histogramms fest.

Attribut	Typ	Beschreibung
`Image`	`String`	Ressource für das anzuzeigende Bild. Kann entweder ein Pfad zu einer Bilddatei oder eine Daten-URI sein.
`ImageConversion`	`ImageConversion`	Bildformat, in welches das Bild vor Berechnung des Histogramms konvertiert wird. Das Eingangsbild wird hierbei immer als RGB interpretiert.
`ColorChannels`	`ColorChannels`	Definiert die Anzeige der Farbkanäle. Dies beinhaltet: Anzahl der Kanäle Anzeigefarben der Kanäle Label der Kanäle Sichtbarkeit der Kanäle
`ChartType`	`ChartType`	Histogrammtyp. Möglich sind: `Line` für die Liniendiagrammansicht `Bar Overlay` für die Balkendiagrammansicht mit transparenten Überlagerungen der Kanäle `Bar Mix` für die Balkendiagrammansicht mit Farbmischung bei Kanalüberlagerungen.
`Histogram` _(readonly)	`Histogram`	Die berechneten Histogrammdaten des aktuellen Bildes als zweidimensionales, numerisches Array. Das Array enthält die Häufigkeitswerte pro Farbkanal und Farbwert. Die erste Dimension des Arrays entspricht den Farbkanälen und die zweite Dimension entspricht den Farbwerten.

Kategorie: Selection

Folgende Attribute und Funktionen beziehen sich auf das Selektieren von Farbwerten.

Attribut	Typ	Beschreibung
`SelectionMode`	`SelectionMode`	Bestimmt, ob mehrere aufeinanderfolgende Farbwerte (`Range`), nur einzelne Farbwerte (`Single`), beide Optionen (`Single or Range`) oder gar keine ausgewählt werden können (`Disabled`).
`SelectionLowerBound` _(readonly)	`Number`	Niedrigster Farbwert der aktuellen Auswahl. Bei Einzelauswahl ist dies der ausgewählte Farbwert.
`SelectionUpperBound` _(readonly)	`Number`	Höchster Farbwert der aktuellen Auswahl. Bei Einzelauswahl ist dies der ausgewählte Farbwert.
`SelectionFrequencies` _(readonly)	`Frequencies`	Häufigkeitswerte der einzelnen Bildkanäle von der aktuellen Auswahl bei Single-Selektion, Durchschnittswerte bei Range-Selektion.

Funktion	Beschreibung
`clearSelection(): void`	Hebt die aktuelle Farbwert-Auswahl auf.

Kategorie: Infobar

Mit folgenden Attributen kann die Infobar des Controls angepasst werden.

Attribut	Typ	Beschreibung
`ShowInfobar`	`Boolean`	Bestimmt, ob die Infobar angezeigt wird.
`InfobarShowLegend`	`Boolean`	Legt fest, ob die Legende in der Infobar angezeigt wird.
`InfobarShowFrequencies`	`Boolean`	Bestimmt, ob die Häufigkeitswerte der aktuellen Selektion in der Infobar angezeigt werden.
`InfobarShowBin`	`Boolean`	Bestimmt, ob der zur aktuellen Selection gehörende Helligkeitsbereich (Bin) in der Infobar angezeigt wird.
`InfobarFontFamily`	`FontFamily`	Schriftart der Infobar.
`InfobarFontSize`	`MeasurementValue`	Schriftgröße der Infobar.
`InfobarFontStyle`	`FontStyle`	Font Style der Infobar.
`InfobarFontWeight`	`FontWeight`	Font Weight der Infobar.

Kategorie: Grid

Mit folgenden Attributen können die Rasterlinien des Controls angepasst werden.

Attribut	Typ	Beschreibung
`ShowGrid`	`Boolean`	Legt fest, ob Rasterlinien auf dem Histogramm angezeigt werden.
`GridShowHorizontalLines`	`Boolean`	Legt fest, ob horizontale Rasterlinien auf dem Histogramm angezeigt werden.
`GridHorizontalLineCount`	`Number`	Anzahl der horizontalen Rasterlinien.
`GridShowVerticalLines`	`Boolean`	Legt fest, ob vertikale Rasterlinien auf dem Histogramm angezeigt werden.
`GridVerticalLineCount`	`Number`	Anzahl der vertikalen Rasterlinien.
`GridLineWidth`	`Number`	Dicke der Rasterlinien.
`GridLineStyle`	`ChartLineStyle`	Style der Rasterlinien. Möglich sind: `Dashed` `Dotted` `Solid`

Kategorie: Subgrid

Mit folgenden Attributen können die Sub-Rasterlinien des Controls angepasst werden.

Attribut	Typ	Beschreibung
`SubgridShowHorizontalLines`	`Boolean`	Legt fest, ob vertikale Sub-Rasterlinien auf dem Histogramm angezeigt werden.
`SubgridHorizontalLineCount`	`Number`	Anzahl der horizontalen Sub-Rasterlinien jeweils zwischen zwei horizontalen Rasterlinien.
`SubgridLineWidth`	`Number`	Dicke der Sub-Rasterlinien.
`SubgridLineStyle`	`ChartLineStyle`	Style der Sub-Rasterlinien. Möglich sind: `Dashed` `Dotted` `Solid`

Kategorie: Labels

Mit folgenden Attributen können die Labels, welche die Rasterlinien mit Häufigkeitswerten beschriften, angepasst werden.

Attribut	Typ	Beschreibung
`ShowLabels`	`Boolean`	Legt fest, ob ein Label mit dem entsprechendem Häufigkeitswert pro horizontaler Rasterlinie angezeigt wird.
`LabelPosition`	`LabelPosition`	Anzeigeposition der Labels. Bei `Left outside` und `Right outside` jeweils neben dem Histogramm und bei `Left inside` und `Right inside` jeweils in dem Histogramm direkt unter der entsprechenden Rasterlinie.
`LabelFontFamily`	`FontFamily`	Schriftart der Labels.
`LabelFontSize`	`MeasurementValue`	Schriftgröße der Labels.
`LabelFontStyle`	`FontStyle`	Font-Style der Labels.
`LabelFontWeight`	`FontWeight`	Font-Weight der Labels.

Events

Alle Events sind in der Kategorie Vision gelistet.

Event	Beschreibung
`.onImageReceived`	Dieses Event wird ausgelöst, wenn das Control ein Bild empfängt.

Weiterführende Informationen