- Add service wrapper

- Remove unnecessary DVBDIR from Makefile
- Rename README.de to LIESMICH

1 files changed, 202 insertions, 0 deletions

diff --git a/LIESMICH b/LIESMICH
new file mode 100644
index 0000000..8a72561
--- /dev/null
+++ b/LIESMICH
@@ -0,0 +1,202 @@
+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.3.38+ 
+- 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
+    + libexif-0.6.13 (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 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.