This is a "plugin" for the Video Disk Recorder (VDR).

Originaly written by:           Kai Tobias Burwieck <kai-at-burwieck.net>
                                "Interpohl" <vdr-portal.de>
                                Onno Kreuzinger <o.kreuzinger-at-kreuzinger.biz>
                                Andreas Brachold <anbr at users.berlios.de>

Former project's homepage:      http://www.burwieck.net/vdr (dead?)
                                http://vdr-image.kreuzinger.biz>

Maintainer:                     Andreas Brachold <anbr at users.berlios.de>

Project homepage:               http://vdr-image.berlios.de/

Einige Dateien stammen vom mp3/MPlayer Plugin, der danke geht an Stefan Hülswitt


Benötigt:
-----------
- Full-Featured DVB Karte 
- vdr 1.5.8+ 
- das Plugin ist abhängig vom folgenden Paketen
    + ffmpeg (getestet mit ffmpeg-0.4.8/ffmpeg-0.4.9pre1/ffmpeg-cvs)
        http://ffmpeg.sourceforge.net
    + Zum Kompilieren wird 'pkg-config' benötigt
        http://pkgconfig.freedesktop.org/
    + libexif-0.6.13 ... 0.6.15 (siehe unten, für Kompilieren ohne diese)
        http://libexif.sourceforge.net/
    + zur Ausführung wird auch das Paket netpbm benötigt
        http://netpbm.sourceforge.net/
        netpbm 10.0+ (prüfe ob das Tool "anytopnm" existiert)
    + nicht notwendig, aber sinnvoll utils/file (file) für bessere Bildtyperkennung
        dieses Tool wird vom Skript anytopnm genutzt
        ftp://ftp.astron.com/pub/file

WICHTIG, 
wenn Tools von Source installiert werden, unbedingt auch dafür sorgen das 
die Programme (anytopnm pnmscale pnmfile pnmcut pnmflip) innerhalb des Such-Pfade liegen, 
ansonsten die Variable "PATH" innerhalb der Datei imageplugin.sh anpassen.

Installation:
------------------
Das Plugin wird wie alle Plugins installiert (siehe im Zweifel in vdr Dokumentation nach).
Es wird ein voll Quellcodebaum des vdr benötigt, um diese Plugin zu kompilieren.
Kopiere die Quellen in das vorgegebene Verzeichnis, wie unten aufgeführt..

    cd $VDRSOURCE/PLUGINS/src
    tar -xzvf vdr-image-x.x.x.tgz
    ln -s image-x.x.x image

Das Kompilieren ist abhängig vom Paket ffmpeg, libexif, und später zum Ausführen 
wird noch das Paket "netpbm" benötigt.

 ffmpeg übersetzen
    $ configure --enable-shared && make && make install

 libexif übersetzen
    $ configure && make && make install

 Übersetzen des Plugin

    $ cd $VDRSOURCE
    $ make plugins

 oder wenn benötigt, definiere das ffmpeg source Verzeichnis ¹)
 das ist notwendig, wenn ffmpeg ohne "--enable-shared" übersetzt wurde.

    $ make plugins FFMDIR=/usr/src/ffmpeg-cvs

 Kompilieren ohne swscaler zur Bildconvertierung mittels ffmpeg
   (WITHOUT_SWSCALER=1 verwendet img_convert, notwendig für ältere Versionen von ffmpeg)
    
    $ make plugins WITHOUT_SWSCALER=1

 Kompilieren ohne libexif ¹)
    
    $ make plugins WITHOUT_LIBEXIF=1

 Installieren des Plugins

    $ make plugins-install


¹) Übersetzungsoptionen können auch innerhalb $VDRSOURCE/Make.config definiert 
   werden



Im ./examples Ordner liegt eine Beispieldatei imagesources.conf, dies ggf.
anpassen und in das Verzeichnis plugins Verzeichnis des config Ordners legen.

Die Syntax der Datei ist:
<Pfad>;<Name im vdr Menu>;<0/1>;<Suchmuster für Dateien die angezeigt werden sollen>

Beispiele:
/media/cdrom;CDROM;1;*.jpg *.jpeg *.png *.tif* *.bmp
/archive/photos/holiday;Urlaubs Bilder;0;DSC10*.jpg

0/1 ist für Quellen die gemountet werden müssen (benutzt das gleiche mount.sh wie
das mplayer/mp3 plugin).
gefolgt mit einer Liste des Suchmuster für Dateien welche angezeigt werden sollen,
welche dann jeweils mit Leerzeichen getrennt werden.

Die Datei imageplugin.sh sollte nach /usr/bin kopiert werden, bzw. in einen anderen 
gemeinsamen Ordner innerhalb Such-Path kopieren werden, 
alternativ können als Kommandozeilenoption die gewählten Pfade zu dem Skript
beim vdr Start übergeben werden.
[z.B.: ./vdr '-Pimage -C /usr/local/bin/imageplugin.sh -m /usr/local/bin/mount.sh' ...]

Alle Plugin Optionen :

  -m CMD,   --mount=CMD    verwendetes CMD für mount/unmount/eject der Bildquellen
                           (default: "mount.sh")
  -C CMD,   --convert=CMD  verwendetes CMD fpr die Konvertieren der Bilder
                           (default: "imageplugin.sh")
  -c PATH,  --config=PATH  zum spezifizieren des Verzeichnisses der Konfigurationsdateien
                           relativ zum VDR Plugin Konfiguration-Verzeichnis
                           (default: "" )

Bedienung:
-----------------
Nach dem Aufrufen entweder eine Datei oder einen Ordner auswählen und mit OK wählen.

At all modi
   OK          toggle OSD informations
   Play/Pause  Starte Diaschau/ Stoppe Diaschau
   Stop/Blue   Stoppe Plugin
 
Während der Bildbetrachtung:
   Back        Stoppe Plugin
   Red         Öffne Menu mit Bildbefehle
   Info        Zeige Exif-Informationen
 
   Left        vorheriges Bild
   Right       nächstes Bild
   Down        Springe drei Bilder zurück
   Up          Springe drei Bilder vorwärts

   7           Springe fünf Bilder zurück
   9           Springe fünf Bilder vorwärts
 
   0           Zeige Originalbild

   1           Drehe 90 Grad gegen den Uhrzeigersinn
   3           Drehe 90 Grad im Uhrzeigersinn
 
   4 	       Diaschau-WeiterschaltwertinSekundenverkleinern
   6 	       Diaschau-WeiterschaltwertinSekundenerhöhen

   5           "Zoomwert erhöhen" und damit Zoom-Bedienung starten
   8           "Zoomwert verkleinern" und damit Jump-Bedienung starten
 
'Zoom-Bedienung'
   Back        Zoomwert verkleinern 
   Red         Öffne Menu mit Bildbefehle
   Info        Zeige Exif-Informationen
 
   Left        Bildausschnitt nach Links verschieben
   Right       Bildausschnitt nach Rechts verschieben
   Down        Bildausschnitt nach Unten verschieben
   Up          Bildausschnitt nach Oben verschieben
 
   0           view original image
   5           Zoomwert erhöhen
   8           Zoomwert verkleinern
  
Jump-Menu (3x3 Vorschau):
   Back        Zeige Originalbild
  
   Left        vorherige Bildgruppe (9 Bilder weiter in der Vorschau)
   Right       nächste Bildgruppe (9 Bilder vorher in der Vorschau)
  
   0           Zeige Originalbild
   1 ... 9     Wählt ensprechendes Bild

Bildbefehle
------------
Die Datei imagecmds.conf kann dazu genutzt werden, um definierbare Befehle auf 
auf das an gezeigte Bild anzuwenden. Der Syntax ist extakt der gleiche der 
für die Datei commands.conf unter "man 5 vdr" beschrieben wurde.
Wenn nur ein Befehl angegeben wird, wird der Datei des Bildes angehängt an den Befehlstext,
getrennt durch ein Leerzeichen und einschlossen in Anführungszeichen (single quotes).

Format> Menutext ?: Kommando %s
?  - Bestätigung anfordern, (optional)
%s - Platzhalter für Dateinamen (optional)

Schaue für ein Beispiel nach examples/imagecmds.conf.DE .


Diagnose des Script
-------------------
Wenn der Script nicht arbeitet wie er sollten, starte den Script zum Testen von der Konsole.

imageplugin.sh [infile] [outfile] [WIDTH] [HEIGHT] [ZOOMFACTOR] [LEFTPOS] [TOPPOS] {FLIPCMD}
z.B. imageplugin.sh myimage.png outfile.pnm 720 576 0 0 0 original

und bitte überprüfe die erzeugten Nachrichten im Syslog in /var/log/message bzw.
die Ausgaben auf dem Bildschirm


wenn das nicht hilft wiederhole die Prozedur mit > export DEBUG=yes;

export DEBUG=yes;imageplugin.sh myimage.png outfile.pnm 720 576 0 0 0 original

und überprüfe die Ausgabe auf dem Bildschirm.

*) Wenn der Script für dich arbeitet, es können die Ausgaben im Syslog reduziert werden,
wenn Du innerhalb von imageplugin.sh die Zeile von VERBOSE=yes zu VERBOSE=no geändert wird.