Vorsicht

Dies ist die Dokumentation des aktuellen Entwicklungszweigs der CometVisu. Es besteht daher die Möglichkeit, dass einige der hier beschriebenen Features mit dem aktuellsten Release der CometVisu nicht genutzt werden können.

Image

Beschreibung

Die Image-Komponente dient zu Anzeige eines Bildes. Optional kann dieses Bild in regelmäßigen Abständen automatisiert neu geladen werden.

<cv-image src="resource/icons/comet_128_ff8000.png"/>

Die Größe des Bilds entspricht immer der Kachel in der das Bild benutzt wird, d.h. das Bild füllt die Kachel komplett aus ohne verzerrt zu werden.

Bei einem Klick auf das Bild wird es aktualisiert. Zusätzlich kann über das optionale refresh-Attribut festgelegt werden in welchem Interval in Sekunden das Bild neu geladen wird. Ebenso kann das Aktualisieren des Bildes durch eingehende Daten vom Backend ausgelöst werden.

<cv-image src="http://webcam/snapshot.jpeg">
    <cv-address transform="DPT:1.001" mode="read" target="refresh">1/4/0</cv-address>
</cv-image>

In diesem Fall würde das Bild jedes mal neu geladen wenn die CometVisu für die Adresse 1/4/0 den Wert „1“ empfängt. So kann z.B. das Bild einer Kamera an der Eingangstür aktualisiert werden, wenn es geklingelt hat.

Sollte eine Authentifizierung erforderlich sein um das Bild laden zu können, so kann diese über die Attribute auth-type, username und password definiert werden. Bisher wird nur die „Basic“-Authentifizierung./ unterstützt. Sofern es dabei Probleme gibt kann das Laden den Bildes über einen Proxy im Backend benutzt werden in dem man das proxy-Attribut auf true setzt. Hierfür muss jedoch die URL in die „proxy.whitelist“ Sektion der Versteckten-Konfiguration hinzugefügt werden. Dafür muss ein neuer Eintrag in der Sektion angelegt werden, der Schlüssel kann beliebig gewählt werden und als Wert wird entweder die komplette URL oder ein regulärer Ausdruck eingetragen der für diese URL gültig ist.

Beispiel mit exakter URL:

"proxy.whitelist": {
    "server": "http://webcam/snapshot.jpeg"
}

Beispiel mit regulärem Ausdruck (beginnt und endet mit „/“), welcher alle URLs erlaubt, die „webcam“ enthalten:

"proxy.whitelist": {
    "server": "/^.+webcam\/.*$/"
}

Erlaubte Attribute

Element	Attribut
	Name	Inhalt	Beschreibung
cv-image	src	Text
	refresh	Zahl	Zeitintervall in Sekunden in dem dieses Widget aktualisiert wird.
	visible-on	mobile oder desktop	Steuert die Sichtbarkeit dieses Elements anhand der Bildschirmgröße.
	class	Text	Füge dieses Attribut der CSS Klasse hinzu, so dass das Widget durch ein eigenes Stylesheet zusätzlich formatiert werden kann.
	style	Text	Individuelle CSS style Regeln für dieses Widget.