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 Hlswitt


Bentigt:
-----------
- Full-Featured DVB Karte 
- vdr 1.5.8+ 
- das Plugin ist abhngig 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' bentigt
        http://pkgconfig.freedesktop.org/
    + libexif-0.6.13 ... 0.6.15 (siehe unten, fr Kompilieren ohne diese)
        http://libexif.sourceforge.net/
    + zur Ausfhrung wird auch das Paket netpbm bentigt
        http://netpbm.sourceforge.net/
        netpbm 10.0+ (prfe ob das Tool "anytopnm" existiert)
    + nicht notwendig, aber sinnvoll utils/file (file) fr bessere Bildtyperkennung
        dieses Tool wird vom Skript anytopnm genutzt
        ftp://ftp.astron.com/pub/file

WICHTIG, 
wenn Tools von Source installiert werden, unbedingt auch dafr 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 bentigt, um diese Plugin zu kompilieren.
Kopiere die Quellen in das vorgegebene Verzeichnis, wie unten aufgefhrt..

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

Das Kompilieren ist abhngig vom Paket ffmpeg, libexif, und spter zum Ausfhren 
wird noch das Paket "netpbm" bentigt.

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

 libexif bersetzen
    $ configure && make && make install

 bersetzen des Plugin

    $ cd $VDRSOURCE
    $ make plugins

 oder wenn bentigt, 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 fr ltere Versionen von ffmpeg)
    
    $ make plugins WITHOUT_SWSCALER=1

 Kompilieren ohne libexif )
    
    $ make plugins WITHOUT_LIBEXIF=1

 Installieren des Plugins

    $ make plugins-install


) bersetzungsoptionen knnen 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 fr 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 fr Quellen die gemountet werden mssen (benutzt das gleiche mount.sh wie
das mplayer/mp3 plugin).
gefolgt mit einer Liste des Suchmuster fr 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 knnen als Kommandozeilenoption die gewhlten 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 fr 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 auswhlen und mit OK whlen.

At all modi
   OK          toggle OSD informations
   Play/Pause  Starte Diaschau/ Stoppe Diaschau
   Stop/Blue   Stoppe Plugin
 
Whrend der Bildbetrachtung:
   Back        Stoppe Plugin
   Red         ffne Menu mit Bildbefehle
   Info        Zeige Exif-Informationen
 
   Left        vorheriges Bild
   Right       nchstes Bild
   Down        Springe drei Bilder zurck
   Up          Springe drei Bilder vorwrts

   7           Springe fnf Bilder zurck
   9           Springe fnf Bilder vorwrts
 
   0           Zeige Originalbild

   1           Drehe 90 Grad gegen den Uhrzeigersinn
   3           Drehe 90 Grad im Uhrzeigersinn
 
   4 	       Diaschau-WeiterschaltwertinSekundenverkleinern
   6 	       Diaschau-WeiterschaltwertinSekundenerhhen

   5           "Zoomwert erhhen" 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 erhhen
   8           Zoomwert verkleinern
  
Jump-Menu (3x3 Vorschau):
   Back        Zeige Originalbild
  
   Left        vorherige Bildgruppe (9 Bilder weiter in der Vorschau)
   Right       nchste Bildgruppe (9 Bilder vorher in der Vorschau)
  
   0           Zeige Originalbild
   1 ... 9     Whlt 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 
fr die Datei commands.conf unter "man 5 vdr" beschrieben wurde.
Wenn nur ein Befehl angegeben wird, wird der Datei des Bildes angehngt an den Befehlstext,
getrennt durch ein Leerzeichen und einschlossen in Anfhrungszeichen (single quotes).

Format> Menutext ?: Kommando %s
?  - Besttigung anfordern, (optional)
%s - Platzhalter fr Dateinamen (optional)

Schaue fr 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 berprfe 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 berprfe die Ausgabe auf dem Bildschirm.

*) Wenn der Script fr dich arbeitet, es knnen die Ausgaben im Syslog reduziert werden,
wenn Du innerhalb von imageplugin.sh die Zeile von VERBOSE=yes zu VERBOSE=no gendert wird.
