Widgets in der CometVisu

Widgets sind die einzelnen Elemente aus denen eine CometVisu-Site zusammengebaut wird. Diese können entweder fest in der CometVisu eingebaut sein oder per Plugin-Schnittstelle integriert werden. Die Widgets lassen sich durch den Editor hinzufügen. (Rechtklick auf das Element, welches ein Widget aufnehmen soll z.B. eine Page oder eine Gruppe (group). Durch Auswahl des Widget aus dem Drop-Down Menü und anschließendem Klick auf das + - Zeichen ist das Widget eingefügt und kann wie folgt konfiguriert werden;

Bedienbare Widgets

Diese Widgets können in irgendeiner Weise bedient werden um so Daten an das Backend zu senden oder andere Aktionen auszulösen, z.B. kann man mit einem Switch durch anklicken einen Lampe schalten, oder mit einem Pagejump kann innerhalb der Visu navigiert werden.

Widget Beschreibung
Audio Mit diesem Widget kann in die Visu eine Audio-Datei eingebunden werden, die sich über eine Adresse abspielen lässt.
Designtoggle Fügt der Visu eine Schaltfläche hinzu, mit der das Design gewechselt werden kann.
ImageTrigger Fügt der Visu ein klickbares Bild hinzu. Dies kann z.B. für Erinnerungen wie Geburtstage oder Müllabfuhr verwendet werden.
InfoAction Ermöglich die Kombination eines darstellenden und bedienbaren Widgets.
InfoTrigger Fügt der Visu ein Element hinzu, dass zwei Schaltflächen und eine Wertanzeige für Rückmeldungen vom BUS enthält. Z.B. für Multimediasteuerungen.
Multitrigger Fügt der Visu ein Widget mit 4 Schaltflächen hinzu. Damit kann z.B. die Betriebsart der Heizung umgestellt (Komfort -> Nacht -> Abwesend -> Frostschutz) oder ein Szenenabruf realisiert werden.
Pagejump Mit dem Widget pagejump lassen sich Seiten der Visu zusätzlich verknüpfen. Von der Funktion ist das vergleichbar mit Hyperlinks.
PushButton Fügt der Visu eine Schaltfläche hinzu, mit der beim Drücken und Loslassen jeweils ein definierter Wert an den BUS gesendet wird. Z.B. beim Drücken eine 1 und beim Loslassen eine 0. Damit ist es z.B. möglich einen Taster zu simulieren um ein Garagentor, Rolläden oder Raffstores zu öffnen und zu schliessen.
Refresh Mit dem Widget refresh lassen sich die angezeigten Daten der Visu neu abrufen.
Reload Mit dem Widget reload wird die Visu Seite komplett neu geladen.
Slide Fügt der Visu einen horizontalen Schieberegler hinzu. Mit diesem kann z.B. gedimmt oder eine Temperatur eingestellt werden.
Switch Fügt der Visu eine Schaltfläche hinzu, mit der z.B. Schaltaktionen ausgelöst werden können. Der Switch wird typisch für EIN/AUS Aktionen benutzt, wie Licht, Steckdosen, etc.
Toggle Das toggle Widget ist ähnlich wie der Switch, kann aber mehr als zwei Zustände annehmen - dies kann z.B. für die Umschaltung von Betriebsarten der Heizung genutzt werden. Bei jedem Druck nimmt der Toggle den nächsten möglichen Zustand an.
Trigger Fügt der Visu eine Schaltfläche hinzu, mit der genau ein definierter Wert für einen kurzen, sowie optional ein definierter Wert für einen langen Tastendruck an den BUS gesendet werden kann, z.B. für das Abrufen und Abspeichern von Szenen oder dem Fahren von Rollos. (kurz = stopp, lang = fahren). Die Adresse für Kurz und Langzeit können unterschiedlich sein.
URL-trigger Das UrlTrigger Widget fügt der Visualisierung eine Schaltfläche hinzu, die im Hintergrund eine URL aufruft um dadurch Aktionen auszuführen, z.B. um ein IFTTT Rezept aufzurufen.

Darstellende Widgets

Diese Widgets haben eine rein informative Funktion, eine Bedienung ist nicht möglich.

Widget Beschreibung
Image Fügt der Visu ein statisches Bild oder ein Kamerabild hinzu.
Info Fügt der Visu ein dynamisches Feld hinzu, dass Werte vom BUS darstellen kann. Z.B. 14-Byte-Text oder Zählerstände.
Line Fügt der Visu eine horizontale Linie hinzu, um die Visuseite in einzelne Bereiche zu unterteilen.
RGB Mit dem RGB-Widget kann man eine Farbe in der Visu anzeigen.
Text Fügt der Visu ein statisches Textfeld hinzu.
Video Fügt der Visu ein Video oder einen Livestream hinzu. Wird derzeit allerdings von den meisten Quellen noch nicht unterstützt.
Web Fügt der Visu ein Fläche hinzu, in der externe Webseiten dargestellt werden können.
WG_Plugin_Info Fügt der Visu ein dynamisches Feld hinzu mit dem Daten aus WireGate Plugins dargestellt werden können.

Sonstige Widgets

Widget Beschreibung
Break Fügt der Visu einen Zeilenumbruch hinzu.
Group Mit group können Widgets in einem Rahmen als Gruppe zusammengefasst werden. Die Größe der Gruppe kann über “layout” eingestellt werden.
Include Ermöglicht es, die visu_config.xml in mehrere Dateien aufzuteilen und die Teile über include wieder zusammenzuführen.
Navbar Mit dem Widget navbar kann der gesamten Visu ein Navigationsmenü hinzu gefügt werden. Das Menü lässt sich an einer Seite (oben, unten, link, rechts) darstellen. Die Navigation durch die Visu lässt sich damit strukturieren.
Page Erstellt eine neue Visuseite und fügt der aktuellen Seite einen entsprechenden Link hinzu.

Widgets die per Plugin eingebunden werden können

Diese müssen im “meta” Bereich der visu_config.xml eingebunden werden bevor sie genutzt werden können.

also z.B.:

<plugins>
  <plugin name="diagram"/>
  <plugin name="colorchooser"/>
  <plugin name="strftime"/>
</plugins>
Widget Beschreibung
ColorChooser Farb-Auswahl-Rad für RGB-Beleuchtung
Diagram RRD-basierte Diagramme
Diagram_Info Informations-Anzeige, die beim Klick ein Diagramm öffnet
PowerSpectrum Darstellung des Strom-Spektrums
Strftime Darstellung der Uhrzeit in Textform
RSSlog RSS
RSS RSS
Gauge Zeigerinstrument
CalendarList externen Kalendar einbinden
Clock Plugin zum Darstellen der Uhrzeit von einer Adresse.
SVG Demo Plugin zur Anzeige einer interaktiv animierten SVG Datei
Timeout Wechselt nach gewisser Zeit der Inaktivität auf eine andere Seite
UPNPController UPNP-Controller
Speech Sprachausgabe (Text-to-speech)

weitere Plugins befinden sich in der Entwicklung.