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

Written by:                  Peter Juszack <vdr@unterbrecher.de>

Project's homepage:          http://turku.wi-bw.tfh-wildau.de/~pjuszack/digicam

Latest version available at: http://turku.wi-bw.tfh-wildau.de/~pjuszack/digicam/download/digicam.tgz

See the file COPYING for license information.

-------------------------------------------------------------------------------------
Description:

digicam is a plugin for the VDR video disc recorder by Klaus Schmidinger.
It provides access to digital cameras using libgphoto2.
This is a very eraly TESTING version - so always remember. Feel free to report
any bugs or results to  the given mail address.
At the moment images cannot be viewed with this plugin. I use the IMAGE plugin
for that purpose.

For installation notes see INSTALL

Features (all tested with a CANON EOS 300D):

- support for USB digital cameras supported by gphoto2
  type: gphoto2 --list-cameras to see if your model is supported
  
- browsing your cameras storage area

- view general camera information

- view some image/directory parameters

- load image from camera and store on disc

- information ( file count and size of all files) for direcories on the camera 
  ( sub directories are ignored because mostly not present on a camera )
    
- load all images from a directory and save to disc. 

- browsing menu to choose the destination for downloaded files
--------------------------------------------------------------------
MANUAL
--------------------------------------------------------------------

1. PREPARE YOUR CAMERA

Connect your camera to the VDR and switch it on (or whatever must be
done to access the camera from PC).

--------------------------------------------------------------------
2. BROWSE THE CAMERA'S MEMORY

Select 'digicam' from the VDR main menu. You should see a browsing menu for
the filesystem on your camera's memory.
Select a directory and press OK to go into that directory. Use the BLUE button
or the '..' item in the list to go back to the parent directory.

--------------------------------------------------------------------
3. SELECT STORE LOCATION FOR DOWNLOAD

Go into the camera browsing menu (2) and press YELLOW. A second browsing menu is
displayed to browse your disc or whatever you defined in digicamdestinations.conf.

To choose a directory as store location mark it and press RED - you will jump back to
the camera browser afterwards.

Via the green key you can create a new directory for storing files on your disc

3.1. Create new directory

Press GREEN in the store location browser. Enter the name of the folder to create
and press RED.

3.2. Switching sources

Press YELLOW in the store location browser. You will see all sources defined in
digicamdestinations.conf. To change the source mark it and press RED.
Afterwards you can browse the new source and store images.

--------------------------------------------------------------------
4. DOWNLOADING OR DELETING A FILE FROM THE CAMERA

Mark the file in the camera browser(2) and press RED. You will see the a summary page
for the file (name, size and maybe dimensions). Copy destinations specifies the place
where the plugin will store the file (For changing see 3).

Press RED to copy the file from the camera to your VDR.
NOTE: at the moment the plugin will overwrite files - so be careful

Press YELLOW to delete the image (the plugin will ask you for confirmation)

-------------------------------------------------------------------- 
5. DOWNLOADING OR DELETING ALL FILES FROM DIRECTORY

WITH VERSION 0.0.3 THREADED DIRECTORY DOWNLOAD IS INTRODUCED. YOU CAN TURN IT OFF IN THE
PLUGIN'S SETUP MENU.
Mark the directory in the camera browser(2) and press RED. You will see a summary page
for the directory (name, size of all files). Copy destinations specifies the place
where the plugin will store the files (For changing see 3). NOTE: the plugin will copy 
all files to copy destination - it will NOT create a sub folder.
NOTE: at the moment the plugin will overwrite files - so be careful

CANCELING DOWNLOAD
If you use the THREADED DOWNLOAD (default) you can cancel the download process.
Select DIGICAM from the VDR main menu. If the download has not finished the DOWNLOAD
status is displayed. It may take some seconds until a status message is shown.
Select RED to cancel the download. The canceling may also take som seconds.

To delete the directory and all files in it press the yellow button from the diretory
menu. The plugin will ask you for confirmation.

--------------------------------------------------------------------
6. VIEWING IMAGES

There is no image viewer integrated - you should use the image plugin to do that 
(see www.cadsoft.de/vdr/plugins.html) to get it.
After testing the new version of image I decided not to impelement any image viewing
features at all.
Maybe there will be a way to integrate digicam into image sometimes...


NOTE:

feel free to send me your results with the plugin
