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
plugin on the plugins homepage.

This plugin adds 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.9-tar.gz

The plugin works under VDR Version 1.4.4 and above.

You'll need the avcodec library from the ffmpeg package to run the plugin.
Depending on your distribution packages ''ffmpeg'' and ''libavcodec'' are
needed, as well as the header files eg. ''libavcodec-dev''. Check for the
files ''avcodec.h'' and ''libavcodec.so'' in your include and library paths.

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 adds 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.
''Skip to ...'' will end at the first/last image. It will loop if "Scroll
wraps" is set in VDR's OSD setup, eg. to allow an endless slideshow.


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.

