Quick documentation
===================

This MUI application will let you communicate, configure and download images
from a Kodak DC-240 digicam using the serial port. It should be fairly
self-explanatory in use.

Fixes - 20-July-1999
====================
- Fixed a daft fixed path bug that crept in somehow.
- Fixed support for Picasso96 at last! (Thanks, Carl!)
- Added a comprehensive ARexx port. Timelapse photos automatically converted
  into an anim, anyone? Direct memory-card access from DOpus? The possibilities
  are - uh - multiple! :D

Fixes - 22-June-1999
====================
- Added filename to thumbnail buttons

Fixes - 19-June-1999
====================
- Added the option to keep thumbnail images in a directory on disk. Makes
  things much faster if a large directory is being viewed. Note - *don't* have
  this directory and your image directory pointing to the same place!
- Now sets date and time of thumbnails and pictures to the time the picture was
  taken. Also, if a picture is protected on the camera it is flagged as non-
  deletable.
- Apparently artser.device works in addition to serial.device and 8n1.device.
  (from Mike Carter - thanks!)
- Fixed bugs in DC_Set_Protect and DC_Set_Clock functions.
- Added button for changing protection status. It selects the status based on
  the first picture; if you select 4 pictures, the first of which is not
  protected, *all 4* will be protected regardless of their current status.
- Decent icon provided by Carl Vidos. Thanks!
- Various 'toolbar' icons nicked from DirOpus5. Improvements welcome, if you
  have time on your hands.

Fixes - 02-June-1999
====================
- Added a Cancel button to the Progress window. It's not very resposive, but it
  does work. (It can only check for being pressed when the current thumbnail
  has completely downloaded, so it may take a second or two to notice it's been
  pressed).

- Changed the way the MUI thumbnail display works. Should be much more stable
  now.

- Note that this seems to require at least 8K of stack - set it to 16K or
  higher just in case.


Note
====
This is a first release; it works well enough for me to download images, which
is an improvement over the Amiga software in the box with the camera (there is
none, before you go looking for it!). There *are* bugs, which I intend to fix
at some point. Feel free to email me if you think you've found a good one.

- The 'download thumbs' button does nothing. For the time being, if you want
  a thumbnail image, look in your thumbnail directory - 'T:' by default.

- Changing the camera's name sometimes causes errors. Just restart the program
  and all will be well.   *** This seems OK now ***

- Taking a picture and then switching to another tab quickly sometimes causes
  errors. Although the button should not return until the camera is ready, it
  seems to help to leave it alone for a few seconds anyway.

- Protected images are shown, but there is not yet a way to alter this. Use the
  camera's menus.

- For programmers: there are no docs for the dc240.lib yet. Most of the calls
  should be fairly simple. Try reading the include file, and the source to the
  library itself. The main loop of the main application should give you more
  guidance in the use of the calls.

I will be fixing all of these at some point, but I'm sorta busy right now. This
has been written *very* quickly and I'm sure there are problems in places I
haven't looked yet.

I have tested with serial.device and 8n1.device at 115200 baud, and both seem
fine. If anything, serial.device seems a little faster! I don't have a second
serial port, so I can't test this but as long as they use standard
serial.device commands they should work OK. Confirmation would be nice :)
*** New - artser.device also appears to work ***

Requirements
============
I have compiled for '060 but the program should run on 020 and above. No FPU
is required. There's no point in a PPC version becuase most of the program
consists of interface calls. It would probably be slower.

You will also need a serial port - no problem there I assume - and a Kodak
DC-240 camera. This won't work with any other Kodak digicam, although
conversion for DC-210, DC-220 and DC-265 may be fairly simple.

MUI is also needed. If you want to write a version for another interface, get
the source code and roll your own.

Since the camera produces JPEG (exif) images, you will need a 24-bit JPEG
datatype. I have only tested on a cybergraphics screen - if you have problems
using less than a 16-bit display, fiddle with the datatype's settings. If that
doesn't help, let me know. Picasso96 allegedly works now, thanks to Carl Vidos'
patient testing.

Other stuff
===========
This program was written using information available from Kodak at
www.kodak.com . All trademarks and copyrights are observed. Kodak provides no
support or warranty for this software. For that matter, neither do I.

Having said that, I will be using it fairly extensively myself so bugs may be
fixed from time to time. Please let me know if you come across anything that
stops you working with this and I'll try to fix it.

If you use the library in your own projects, some form of recognition would be
nice. It may not be used in any non-free software without consulting with me
(the author) at the email address below. Also, Kodak requires that any software
accessing it's cameras is accompanied by acknowledgement both in the docs and
in the software. Visit their developer website for more details at
www.kodak.com/US/en/developers/




Happy snapping.

Jamie Keir
jkeir@lht-home.freeserve.co.uk

website: http://www.jameswatt.ac.uk/jkeir/index.html
