******************************
dc20wcam - DC20/25 Web Adaptor
******************************

Version 1.0  10/15/1999    Author: John Fitzgibbon fitz@jfitz.com

dc20wcam is a FREEWARE utility to allow a Kodak DC20 camera to be 
used to create time-lapsed images on the Web. The package includes
a web server and all the required graphic processing tools. It 
does not modify the registry or system settings in any way.



INSTALLING AND STARTING THE WEBCAM
==================================

If you DO NOT already have a web server running:
------------------------------------------------

1. Unzip the files in a folder of your choice.
2. Connect to the Internet.
3. Execute "Tinyweb.bat" (Do not run Tiny.exe.)
   (Close the DOS window when the webserver has started.)
4. Connect the DC20 and switch it on.
5. Execute "dc20wcam"
6. Select the appropriate COM port and speed. 
   (Try "Auto" if the camera does not respond to the defaults.)
7. Click "Start" and you're away!

The URL for accessing the WebCam images is:
http://XXX.XXX.XXX.XXX/
replacing XXX.XXX.XXX.XXX with your IP address.

If you don't know your IP address, try using "Eclipse".
You can download it from: http://members.xoom.com/LunaSoft/


If you already have a web server running:
-----------------------------------------
1. Unzip the files somewhere in the web server's file system.
2. Connect the DC20 and switch it on.
3. Execute "dc20wcam.exe"
4. Select the appropriate COM port and speed.
5. Click "Start" and you're away!

The webcam's index.html file is created in the same folder
as the unzipped executables.



UNINSTALLING THE WEBCAM
=======================

To uninstall this software, simply delete the entire contents of
the folder where you unzipped the files.

If the Tinyweb web server is running, you must use the Task Manager
to stop it, (or restart the computer), before deleting the files.



WEBCAM CONTROLS AND OPTIONS
===========================

Speed   - Bit (baud) rate for the serial port that the camera is
          connected to. Try "Auto" if you're unsure.

Port    - COM port 1, 2, 3 or 4. Try "Auto" if you're unsure. 

Camera  - DC20 or DC25. (I have not tested with a DC25)

Refresh Interval - Value between 30 and 90 seconds that specifies
                   how often the image is updated.

Archive Images - If this option is checked, images are saved in an 
                 "archive" folder. The URL for viewing the archived 
                 images is http://XXX.XXX.XXX.XXX/archive

Message -  Text message that appears below the image on the Web Site.

Start - Starts taking pictures. (Make sure the camera is on!)

Stop  - Stops taking pictures. (Last picture stays with "WebCam is 
        OFF" message.) Note: If Archiving is on, the list of 
        archived images is not updated until the "Stop" button is 
        clicked.

Exit  - Exits the program.

Status - Displays current status information. Try to look your best
         when the status reads 'Say "Cheese"!' 
         Note: "Finished Processing" means the current image is ready
         - it does not mean the WebCam has stopped. "WebCam stopped" 
         appears when you click the "Stop" button.



CLEANING UP ARCHIVE AND LOG FILES
=================================

Tinyweb stores web server logs in the unzipped folder. The files are:
access_log, agent_log, error_log and referer_log
You should review and zip/delete these files from time to time.

If you leave the "Archive Images" option on all the time, you may
want to keep an eye on the archive folder - it can get quite large.



CUSTOMIZING THE WEBCAM'S HTML PAGE
==================================

If you have some HTML experience, its quite easy to change the
appearance of the WebCam's main web page.

The INDEX.HTML file is patched together from the following:

- TOP.TXT (or TOPOFF.TXT when the WebCam is being turned off)
- The Image File Name
- MIDDLE.TXT
- MESSAGE.TXT (generated from the text in the "Message" box.)
- BOTTOM.TXT

Feel free to edit TOP.TXT, TOPOFF.TXT, MIDDLE.TXT and BOTTOM.TXT, 
but bear in mind that the image file name and the message must "fit 
in" to the HTML at the appropriate points.



BUGS/LIMITATIONS
================

- Operation with a DC25 has not been tested.

- Only supports high res pictures. 
  (Try low res - the effect is interesting.)

- The DC20 switches off after about 90 seconds. Setting a refresh
  rate around 90 could result in the camera switching off. (Unlikely)

- You cannot copy Tinyweb.bat as a shortcut to the DeskTop.
  Workaround: To start Tinyweb from the desktop:
      - Create a shortcut to Tiny.exe on the desktop.
      - Right click the shortcut and click "Properties".
      - In the shortcut "target" box add a space followed by the
        path to the executable directory. For example:
        C:\webcam\TINY.EXE C:\webcam
        (Note: In this example, the working directory should also be 
        C:\webcam)
      - Click OK



CREDITS
=======

This program is really just a bunch of software duct-taped together:

DC25V20_32.dll comes from Kodak-Eastman. Its the "official" DC20/DC25
SDK. You can get more information by registering as a developer at 
the Kodak site: http://www.kodak.com

dc2totga.exe was written by Oliver Hartmann. To the best of my 
knowledge, he no longer supports this program, but it works for me.

cjpeg.exe was pulled from the Independent JPEG Group, (IJG). 
For everything you ever wanted to know about JPEG, but were afraid to
ask, visit: http://www.ijg.org/

tiny.exe is written by Max Masyutin (max@ritlabs.com). The home page 
for TinyWeb is at: http://www.ritlabs.com/tinyweb/

dc20wcam.exe and imglist.exe are my own creations. The source code is
available somewhere on my web site: http://www.jfitz.com
