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

Written by:                  Joachim Wilke <vdr@joachim-wilke.de>

Project's homepage:          http://joachim-wilke.de

Latest version available at: http://joachim-wilke.de/vdr-screenshot.xml

See the file COPYING for license information.

Description:
------------
With this plugin you can take still images of your screen. After installing
the plugin, a new mainmenu entry "Screenshot" will show up. Each time you
select this item, a file /tmp/title-yyyymmdd-hhmmss.jpg will be created,
where title is the current transmission or the recording currently replayed.

To get a screenshot with a single keypress, add a line like this to your
keymacros.conf:

...
User5    @screenshot
...

After that, pressing your user-button 5 will create a screenshot.
You can use andy User button out of User1 - User9. If you dont know, what your
user-keys are, delete the file remote.conf. After restart, VDR will guide you throgh the
reassignment of your remotecontrol.

At the moment, it is only possible to make screenshots of the tv screen withour any 
osd, because calling a plugin in vdr causes the osd to be cleared.

New function "delayed shooting":
If enabled in the settings menu, selecting "Screenshot" in the main menu (or pressing the 
corresponding key on your remote), causes the plugin to wait for you to press the Mute-key 
twice and then takes the screenshot(s). This way, screenshots of arbitrary osd constellations 
can be taken. Without delayed shooting, this is not possible, because pressing the 
assigned remote-button for Screenshot causes the osd to be closed and calling the plugin from
the main menu disturbs the current osd either.	

Only for vdr users, using vdr-1.3.32 or older:
If you want to hide the mainmenu entry you will have to apply the 
patch-keymacros-for-hidden-plugins.diff in the patch/ subdir, otherwise
the user-button will stop to work, too.

Troubleshooting:
----------------
If you experience problems when using the plugin, check

- if your image-directory exists and is writable to the vdr user

- if you have the correct device node for your video device (/dev/video0 or similar)

When you find an error, I would be happy, if you send me a bug-report. When you expect
a crash please include a backtrace (using gdb or similar) if possible.
