📸 Bildbetrachter (Image Viewer)

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.

Inhaltverzeichnis

1. Funktionsumfang
2. Voraussetzungen
3. Installation
4. Einrichten der Instanzen in IP-Symcon
5. Statusvariablen und Darstellungen
6. Visualisierung
7. PHP-Befehlsreferenz
8. Versionshistorie

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

• IP-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/ImageViewer oder git://github.com/Wilkware/ImageViewer.git

4. Einrichten der Instanzen in IP-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 IP-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