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.