README :

German:
jump to -> <English>
Benötigt:
-----------
- linux
- ff dvb Karte (ohne mpeg2 decoder könnte es auch funktionieren, einfach testen)
- vdr 1.2.6+ (Achtung einige Patche ersetzen den DeviceStillPicture code in dvbdevice.c, z.B: AnalogTV)
- mjpeg-tools 1.6.1 (
mpeg2enc wird benötigt; rpm Versionen können Probleme machen)
- netpbm tools (prüfe ob das Tool "jepgtopnm" existiert,wenn nicht upgrade oder install von netpbm tools)
- ImageMagick (die meisten RPM Versionen sollten klappen, mpeg2 encoder/decoder sind nicht nötig)

WICHITG, wenn Tools von Source instaliert wird (empfohlen, besonders für Suse) unbedingt mit
"./configure --prefix=/usr"
kompilieren, damit die Programme auch im Pfad der Sysmdienste (runvdr/vdr) liegen.


Installation:
------------------
Das plugin wird wie alle plugins installiert (siehe vdr Dokumentation).
Im examples Ordner liegt eine Beispiel imagesources.conf, dies ggf.
anpassen und in das 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/holliday;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 plguin).


convert.sh ,
convert_zoom.sh, convert_zoom.sh und mount.sh nach /usr/bin,
oder einen anderen Ordner im Path kopieren, alternativ können als Kommandozeilenoption die
Pfade zu den Skripten beim vdr Start übergeben werden.
[z.B.: ./vdr '-Pimage -C /pfad/convert.sh -z /pfad/convert_zoom.sh -j /pfad/convert_jump.sh' ...]


Bedienung:

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

Während der Bildbetrachtung:
RotJump-Menu(neu):
UpZoom-Menu
5Zoom-Menu
0Zoom-Menu
7Diaschau-WeiterschaltwertinSekundenverkleinern
9Diaschau-WeiterschaltwertinSekundenerhöhen



Jump-Menu (3x3 Vorschau):
1-9ensprechendes Bild
Left9 Bilder vorher in der Vorschau
Right9 Bilder weiter in der Vorschau


Zoom-Bedienung:
0Zoomwert erhöhen
5Zoomwert erhöhen
Back Zoomwert verkleinern
Left Bildausschnitt nach Links verschieben
Right Bildausschnitt nach Rechts verschieben
Up Bildausschnitt nach Oben verschieben
Down Bildausschnitt nach Unten verschieben



Tastaturlayouts:
----------------

Layout 0
=> so wie bisher!
Left Rotieren 90 Grad
Right Rotieren -90 Grad
0 Original (Rotieren 0 Grad)
UpNächstes Bild
Down Voriges Bild


Blau Plugin beenden
Rot Jump-Menu (neu)
Grün Pause
5 Zoom-Menu

Layout 1
=> fast so wie bisher!
Left Rotieren 90 Grad
Right Rotieren -90 Grad
0 Original (Rotieren 0 Grad)
Up Nächstes Bild
Down Voriges Bild


Blau Plugin beenden
Rot Jump-Menu (neu)
Grün Sprung zurück (5 Bilder)
Gelb Sprung vorwärts (5 Bilder)
Pause Pause
5 Zoom-Menu


Layout 2
=> mein Favorit
Left Rotieren 90 Grad
Right Rotieren -90 Grad
Up Original (Rotieren 0 Grad)
Down Pause
Pause Pause


Gelb Nächstes Bild - Länger drücken: Sprung vorwärts (5 Bilder)
Grün Voriges Bild - Länger drücken: Sprung rückwärts (5 Bilder)
Back Plugin beenden
Blau Plugin beenden
Rot Jump-Menu (neu)


5 Zoom-Menu
0 Zoom-Menu
7 Diaschau-Weiterschaltwert in Sekunden verkleinern
9 Diaschau-Weiterschaltwert in Sekunden erhöhen


Layout 3
Left Voriges Bild
Right Nächstes Bild
4 Rotieren 90 Grad
2 Original (Rotieren 0 Grad)
6 Rotieren -90 Grad


Down Pause
Pause Pause
Gelb Sprung vorwärts (5 Bilder)
Grün Sprung rückwärts (5 Bilder)
Back Plugin beenden
Blau Plugin beenden



English:
jump to -> <German>
Required:
-----------
- linux
- dvb card
- vdr 1.2.6+ (warning some patches revert the devicestillpicture code)
- mjpeg-tools 1.6.1 (1.6.2 can make trouble)
- netpbm tools (check for "jepgtopnm", if  it does not exist upgrade/install netpbm tools)
- ImageMagick (most default versions should work, leave out mpeg2 encoder/decoder stuff)

Important Note:
When compiling from source, whatch out to use:
"./configure --prefix=/usr"
to assure that the new verision will be available in the system daemons path (vdr/runvdr).

Install:

------------
Install the plugin part as usuall (see vdr docs if you not know allready).
In the image/examples directory you can find a sample file for
imagesources.conf, change this file if needed and place it in
the plugins folder in your config folder (the video folder by default).
The syntax is :
<path>;<name in vdr menu>;<0/1>;<pattern to filter file display>
examples:
/media/cdrom;CDROM;1;*.jpg *.jpeg *.png *.tif* *.bmp
/archive/photos/holliday;Holliday pictures;0;DSC10*.jpg
0/1 is for media that need to be mounted (uses the same mount.sh
as mplayer/mp3 plugin).

The other files (*.sh scripts) should go to /usr/bin, or any other folder in your path.
You can also use the plugin optons (vdr -help after installing the plugin) to specify
the path's to the files, if you don't want to those files in you system.
[ e.g.:
./vdr '-Pimage -C /pfad/convert.sh -z /pfad/convert_zoom.sh -j /pfad/convert_jump.sh' ...]
The install.sh in the examples folder will try a automatic install, give it a try if it fails else.

Manual:

------------
Start the plugin, than select a file (or folder) and press OK.


While watching pictures
Red jump menu (new)
Up zoom menu
5 zoom menu
0 zoom menu
7 slide show - decrease the time (seconds) each picture shows
9 slide show - increase the time (seconds) each picture shows






'Jump menu' (3x3 preview):
1-9 pick the corresponding image
Left go 9 pictures back
Right go to the next 9 pictures




'Zoom menu':
0 zoom in
5 zoom in
Back zoom out
Left scroll in the picture
Right scroll in the picture
Up scroll in the picture
Down scroll in the picture






key mapping layouts:
----------------


Layout 0 => traditional key mapping
Left rotate 90 degrees
Right rotate -90 degrees
0 original (rotate 0 degrees)
Up next picture
Down previous picture


Blue quit the plugin
Red jump menu (new)
Green pause
5 zoom menu




Layout 1 => very close to the original
Left rotate 90 degrees
Right rotate -90 degrees
0 original (rotate 0 degrees)
Up next picture
Down previous picture


Blue quit the plugin
Red jump menu (new)
Green go back 5 picture
Yellow jump 5 picture
Pause pause
5 zoom menu




Layout 2 => the author's favourite
Left rotate 90 degrees
Right rotate -90 degrees
Up original (rotate 0 degrees)
Down pause
Pause pause


Yellow next picture - or hold to jump
Green previous picture - or hold to go
Back quit the plugin
Blue quit the plugin
Red jump-Menu (new)


5 zoom menu
0 zoom menu
7 slide show - decrease the time (seconds)
9 slide show - increase the time (seconds)




Layout 3
Left previous picture
Right next picture
4 rotate 90 degrees
2 original (rotate 0 degrees)
6 rotate -90 degrees


Down pause
Pause pause
Yellow jump 5 picture
Green go back 5 picture
Blue quit the plugin
Back quit the plugin

(thx for the english readme/keymapping description to Kai Steinbach)

Tips:

------------
The script image_pregen.sh can be used to pregenerate files outside of
vdr:
'./image_pregen.sh -at -follow /video/jpegs' would start an atd
background job (-at), recursing into all folders and pregenerate the
cache files (mpeg2 stills). Be aware this script is still alpha, check the
surce to understand the usage. (NOTE: not for busybox, needs atd running)