Histogramm-Ressource
Die auf dieser Seite erklärten Attribute sind in der Kategorie Common zu finden.
Bild-Ressource
Die Bild-Ressource definiert, aus welchem Bild die Histogrammdaten berechnet werden. Die beabsichtigte Benutzung ist, als Bild-Ressource das DisplayedImage-Attribut eines ImageWatch Controls zu binden oder ein ITcVnDisplayableImage-Symbol aus der SPS mittels der HMI.Vision Erweiterung zu verknüpfen. Im Allgemeinen muss die Bild-Ressource allerdings nur eine gültige Bild-URL sein. Dies kann entweder ein direkter Pfad im Projekt, eine URL zu einem externen Server oder eine Data-URL sein. Dies funktioniert analog zum Src Attribut des Standard-Image-Controls.
Die Bild-Ressource wird über das Image Attribut festgelegt:
Um das Histogramm beispielsweise mit dem angezeigten Bild eines ImageWatch Controls zu synchronisieren, kann die Eigenschaft DisplayedImage des ImageWatch Controls per Databinding direkt an die Eigenschaft Image gebunden werden, wie im Screenshot zu sehen.
Farbformat-Konvertierung
Im Normalfall werden die drei Kanäle des eingehenden Bildes als RGB-Werte interpretiert und unverändert verwendet, um die Histogramm-Daten daraus zu generieren. Falls das Histogramm jedoch aus einem anderen Farbformat berechnet werden soll, gibt es zwei Möglichkeiten, dies zu erreichen.
Zum einen kann mit dem Attribut ImageConversion ein Farbformat eingestellt werden, in welches das Bild vor der Generierung des Histogramms konvertiert wird. Mögliche Farbformate sind: None(RGB), Gray, HSV, HSV FULL, HLS, HLS FULL, Lab, YUV und YCrCb. Beim Defaultwert None(RGB) wird das Bild nicht konvertiert. Das eingestellte Farbformat kann die Anzeigefarben der Farbkanäle im Histogramm beeinflussen. Weitere Informationen dazu gibt es auf der Seite Histogramm-Ansicht.
Alternativ kann das Bild auch im Voraus mit der Funktion F_VN_ConvertColorSpace in der SPS konvertiert und als Falschfarbenbild an das Histogramm Control übergeben werden. In diesem Fall sollte ImageConversion auf None(RGB) belassen werden und die Labels sowie Farben können entsprechend über ColorChannels aus der Kategorie Common manuell angepasst werden.
 | Einschränkung der ImageConversion Das eingehende Bild wird bei der Verwendung von |
Berechnetes Histogramm
Die Werte des berechneten Histogramms sind über das Attribut Histogram als zweidimensionales Array vollständig zugänglich. Die erste Dimension des Arrays entspricht den Farbkanälen, die zweite Dimension entspricht den Farbwerten. Somit kann beispielsweise mit den Indizes [1][120] abgefragt werden, wie viele Pixel den Farbwert 120 im zweiten Farbkanal haben.
Empfangsevent
Jedes Mal, wenn das Control ein neues Bild empfängt, wird das Event onImageReceived ausgelöst.