Wilkware Logo Wilkware
Suche

    Bildbetrachter

    Dokumentation direkt aus GitHub Wilkware/ImageViewer ↗

    Version Product Version License Actions

    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.

    Module-Visu

    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/ImageViewer oder git://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 …

    NameBeschreibung
    URL der Bild-RessourceQuell-URL des darzustellenden Bildes/MJPG

    ✨ Visualisation …

    NameBeschreibung
    HintergrundfarbeHintergrundfarbe der Kachel
    BildanpassungAusfüllen (cover), Einpassen (contain) oder Strecken (fill)

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    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).
    SkriptScript, welches den Snapshot erzeugt
    VariableVariable, 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 ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence