Bild-Ressourcen

Die auf dieser Seite erklärten Attribute und Funktionen sind in der Kategorie Common zu finden.

Bild-Ressourcen

Die Bild-Ressource definiert, welches Bild im Image Viewer angezeigt wird. Die beabsichtigte Benutzung ist, als Bild-Ressource ein ITcVnDisplayableImage-Symbol mittels der HMI.Vision Erweiterung zu verknüpfen. Im Allgemeinen muss die Bild-Ressource allerdings nur eine valide 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.

Im einfachsten Fall wird die Bild-Ressource über das Image Attribut festgelegt:

Darüber hinaus besteht die Möglichkeit, mehrere Bild-Ressourcen in dem ImageList Attribut zu hinterlegen:

Über das ImageIndex Attribut kann ausgewählt werden, welche der Ressourcen tatsächlich genutzt wird. Dies kann z. B. zum einfachen Umschalten zwischen Bild-Symbolen aus der PLC genutzt werden. Die Umschaltung kann zudem grafisch über die ImageSelection Combobox in der Toolbar erfolgen. Für diesen Zweck kann in der ImageList nicht nur die jeweilige Bild-Ressource, sondern auch ein zugehöriger Bild-Name vergeben werden.

Gleichzeitige Nutzung von Image und ImageList schließt sich gegenseitig aus Intern führt die Verwendung der Eigenschaft ImageList dazu, dass das jeweilige Bildsymbol des ausgewählten ImageList Elements an das Image-Symbol gebunden wird. Daher schließen sich die Nutzung von Image und ImageList gegenseitig aus; sie sollten daher kein Bildsymbol an das Image Attribut binden, wenn Sie bereits ImageList verwenden.

Empfangsevent

Jedes Mal, wenn das Control ein neues Bild empfängt, wird das Event onImageReceived ausgelöst.

Alternativ-Text

Wenn keine Bild-Ressource festgelegt ist oder von der festgelegten Ressource kein valides Bild geladen werden konnte, wird ein Alternativ-Text angezeigt. Dieser kann durch das Attribut Alt verändert werden und ist standardmäßig „No image available.“.

Bild-Download

Das aktuell angezeigte Bild kann mittels browserspezifischem Download lokal auf dem Client-Gerät gespeichert werden. Der Download kann entweder durch die Funktion downloadImage oder den Download-Button in der Toolbar ausgelöst werden.

Das Bild wird in Originalgröße gespeichert.

Der Dateiname kann bei programmatischen Aufrufen als Parameter angegeben werden. Eine Dateierweiterung muss nicht angegeben werden, da diese automatisch angehängt wird. Wenn der Parameter leer bleibt, wird der Dateiname ebenfalls automatisch erstellt. Bei einem Symbol wird zuerst der Symbolname verwendet, bei einer Data-URL entsprechend der Controlname:

<Symbolname/Controlname>_<Datum>_<Zeit>-<MS>.<Dateierweiterung>

Bei einem Bild-Pfad wird der Dateiname und die Dateierweiterung aus dem angegebenen Pfad verwendet, ohne einen Zeitstempel anzuhängen.

Die Auswahl des Speicher-Pfads ist innerhalb des Controls nicht möglich, sondern entspricht der Download-Pfad-Einstellung des genutzten Browsers. Der übliche Download-Pfad ist C:\Benutzer\<Benutzer>\Downloads\.

Vorrausetzungen und Einschränkungen des Bild-Downloads Da der Bild-Download über eine browserspezifische Funktionalität erfolgt, sind die Möglichkeiten, Einstellungen und die Funktionsweise abhängig vom verwendeten Webbrowser für den TwinCAT HMI Client. Die Methode downloadImage erfordert die Berechtigung operate der TwinCAT HMI Benutzerverwaltung. Diese Methode funktioniert nicht mit Bildern die als Stream verknüpft sind, sowie in der Live-Ansicht des HMI-Engineerings.