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

Written by:                  Thomas Heiligenmann <thomas@heiligenmann.de>

Project's homepage:          ...

Latest version available at: http://www.heiligenmann.de/download/

See the file COPYING for license information.

Description:                 This plugin enables PhotoCD playback with VDR



This plugin adds the functionality to view PhotoCDs with VDR (by Klaus
Schmidinger).

An external MPEG encoder library is required (see Installation) and of course
you'll need a physical CD-ROM drive.

PhotoCD images are read directly from '/dev/cdrom', making use of its driver
ioctl calls. This plugin is not intented to read data from .PCD files on disk
or from any other image file formats. You may find a link to the ImageViewer
plugins on the plugins homepage.

The plugin will add a new entry "PhotoCD" into the main menu, if you have
installed a CD-ROM drive and created a symbolic link '/dev/cdrom'. It should
also work alongside other plugins using the CD-ROM/DVD drive.



Installation:

You should have received the file vdr-pcd-#.#.#.tar.gz or vdr-pcd-#.#.#.tar.bz2
where the #s are replaced by the version numbers, eg. vdr-pcd-0.0.1-tar.gz

This plugin should work under VDR Version 1.2.25 and above. Use it on your own
risk under earlier versions.

You'll need the avcodec library from the ffmpeg package to run the plugin.
At least version 0.4.6 of ffmpeg is required to compile the shared libs. Add
option '--enable-shared' when calling configure to build the shared libraries.
Please ensure that your compiler/linker will find the includes and libraries
installed by ffmpeg when compiling the plugin. When compiled with the standard
options you should get the following files:

    /usr/local/include/ffmpeg/avcodec.h
    /usr/local/include/ffmpeg/common.h
    /usr/local/lib/libavcodec-0.4.6.so
    /usr/local/lib/libavcodec.so -> libavcodec-0.4.6.so

To install the plugin extract the sources in VDR's plugin source directory and
create the appropriate symlink:

    cd /path/to/vdr-#.#.#/PLUGINS/src
    tar xzf vdr-pcd-#.#.#.tgz
    ln -s pcd-#.#.# pcd

Cd back into VDR's source directory and type 'make plugins' to compile your
plugin(s). To load this plugin add the parameter '-Ppcd' when starting VDR.
See VDR's plugin documentation for more information.



Invocation:

Simply call

    /path/to/vdr -P"pcd" [...]

to load the plugin. It will add a new entry in VDR's main menu, e.g.:

    4 Recordings
    5 PhotoCD
    6 Setup



Navigation:

Invoke the "PhotoCD" entry in the main menu to get a list of all images on the
CD displayed as "Image 001" etc.

Use the 'Up' and 'Down' keys to select an image and start the viewer with 'Red'
or 'Ok'. 'Blue' will stop the viewer. 'Yellow' ejects any disc in the drive.

The viewer is controlled by the following keys:

    4:        Skip to the previous image.
    6:        Skip to the next image.
 	1:        Zoom out by 2.
    2:        Zoom by 0.
    3:        Zoom in by 2.
    5:        Pan to the center of the image.
    Left:     Pan the visible image section 20% left.
    Right:    dto. 20% right.
    Up:       dto. 20% up.
    Down:     dto. 20% down.
    0:        Toggle automated slideshow on/off.

'Zoom by 0' is defined to scale the image to fit completely on the screen.



Setup menu:

    Drive speed:
       Adjusts the CD-ROM drive speed in a range of 2..50.
    Hide main menu entry:
       Hides the plugin's entry in VDR's main menu.
    MPEG quality:
       Sets the quantizer scale aka quality of the mpeg encoder [1..31].
    Pal:
       Selects the norm/size of the encoded i-frame:
       PAL (704x576) or NTSC (704x480)
    Quick scaling:
       Use a simpler algorithm to scale the image (for slower machines).
    No adjustment:
       Do not adjust images to fit on the screen, eg. with zoom factor '0'
       images in portrait won't be scaled to screen height.
    Slideshow interval (sec)
       Set interval between images for automated slideshow in a range of
       5..300 seconds.
