Bildbetrachter
Mit diesem Modul können Sie Einzelbilder und Motion-JPEG-Streams direkt in einer vollflächigen Kachel anzeigen. Die Darstellung wird entsprechend der eingestellten Bildanpassung skaliert.
1. Funktionsumfang
Durch Nutzung des HTML-SDKs kann dieser Bildbetrachter Inhalte nun kachelfüllend darstellen – was mit der klassischen HTMLBox bisher nicht möglich war. Unterstützt werden sowohl MJPEG-Streams (z. B. von IP-Kameras) als auch statische Bildquellen.
Darüber hinaus kann festgelegt werden, wie der Bildinhalt relativ zur Kachelgröße skaliert und angepasst werden soll.
2. Voraussetzungen
- Symcon ab Version 8.1
3. Installation
- Über den Module Store das ‘Bildbetrachter’-Modul installieren.
- Alternativ über das Module Control folgende URL hinzufügen
https://github.com/Wilkware/ImageViewerodergit://github.com/Wilkware/ImageViewer.git
4. Einrichten der Instanzen in Symcon
- Unter “Instanz hinzufügen” ist das ‘Bildbetrachter’-Modul unter dem Hersteller ‘Geräte’ aufgeführt. Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen
Konfigurationsseite:
Einstellungsbereich:
📸 Bild …
| Name | Beschreibung |
|---|---|
| URL der Bild-Ressource | Quell-URL des darzustellenden Bildes/MJPG |
✨ Visualisation …
| Name | Beschreibung |
|---|---|
| Hintergrundfarbe | Hintergrundfarbe der Kachel |
| Bildanpassung | Ausfüllen (cover), Einpassen (contain) oder Strecken (fill) |
⚙️ Erweiterte Einstellungen …
| Name | Beschreibung |
|---|---|
| Dynamische Änderung der Bild-URL zulassen! | Erlaubt das dynamiche Austauschen der URL-Konfiguration (IPS_SetProperty/IPS_ApplyChanges). |
| Anzeigen eines Buttons zum Erstellen eines neuen Snapshots! | Rechts unten wird ein Button (overlay) auf dem Bild angezeigt zum Erstellen eines neuen Bildes (Skript oder Variablenaktion). |
| Skript | Script, welches den Snapshot erzeugt |
| Variable | Variable, dessen Action den Snapshot auslöst |
5. Statusvariablen und Darstellungen
Es werden keine zusätzlichen Statusvariablen und Darstellungen/Profile benötigt.
6. Visualisierung
Das Modul kann direkt als Link in die TileVisu eingehangen werden.
Als Kachel wird ein vollflächiges Bild bzw. Motion-Stream dargestellt.
7. PHP-Befehlsreferenz
WWXIV_SetImageUrl(int $InstanzID, string $source);
Wenn die dynamische Änderung der Image-Url aktiviert wurde, dann kann über diese Funktion eine neue Url für das anzuzeigende Bild hinterlegt wedern. Im Erfolgsfall wird die Url der bis dahin angezeigten Bildes zurückggeben.
Beispiel:
WWXIV_SetImageUrl(12345, 'https://wilkware.de/wp-content/uploads/2025/02/sommer-smart-home.jpeg');
8. Versionshistorie
v2.0.20260713
- NEU: Bildanpassung (cover, contain und fill) eingeführt
- NEU: Umstellung auf öffentlichen Befehl für das Setzen einer Bild-Url
- FIX: Modulpräfix vereinheitlicht auf WWXIV_
- FIX: Interne Bibliotheken und Konfiguration überarbeitet und vereinheitlicht
- FIX: Fehlende Übersetzungen nachgezogen
v1.2.20260105
- NEU: Schalter(Overlay) für Auslöser/Snapshot hinzugefügt
- NEU: Umstellung auf IPSModuleStrict
v1.1.20250915
- NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
- NEU: Kompatibilität auf IPS 8.1 hoch gesetzt
v1.0.20250729
- NEU: Initialversion
Entwickler
Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)
Spenden
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Lizenz
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International
