README of Clear Water Bay Cam (CWB CAM)

This is the installation guide for the CWB CAM.  

Archive Contents
================

Files and directories that you have after decompression:

Files		Descriptions
------------------------------------------------------------------------
cwbcam		The main directory
camera		A directory under "cwbcam", storing all the CWB CAM
		homepage stuff
cgi-bin		A directory under "cwbcam", storing all the programs
		need to be put into the WWW server cgi-bin directory
pc-server	A directory under "cwbcam", storing all the stuff to
		setup the PC server
doc		A directory under "cwbcam", storing the final year 
		project report
README		This file

In "camera" directory:
cam.html	The CWB CAM HTML document.
colorbar.gif	All the GIF images are used for the CWB CAM Homepage
hkust.gif
hkust3.gif
spectrum.gif
viewer.gif

In "cgi-bin" directory:
client-src	A directory stores the source codes for compiling the
		"client" program.
date		A shell script of Today's time and Local Time
grabimage	A cgi program call by cam.html
inlinegrab	A cgi program call by cam.html

In "pc-server" directory:
WWWCAM.EXE	A PC sever setup program compiled by Microsoft C 6.0
src		A directory stores all the source codes for compiling
		the executables WWWCAM.EXE

In "doc" directory:
wwwcam.ps	A PS version of the final year project report


HOW to Install
==============

1. Uncompress the file "cwbcam.tar.gz" with the following command:
	cat cwbcam.tar.gz |gzip -d | tar -xvf -

2. Go to the directory of cwbcam/cgi-bin/client-src and compile
   the client program using the cammand "make".

3. To setup the CWB CAM to the WWW server, copy all the programs 
   under the directory cwbcam/cgi-bin to the WWW server 's 
   cgi-bin directory.

4. Copy the whole directory cwbcam/camera to the WWW Server's 
   HTML documentation directory.

5. The setup for the WWW server is done. 

6. To setup the PC server, simply copy the executables WWWCAM.EXE to
   the PC that you want to setup as a server.  Or you can compile the 
   executables yourself using the source codes from the directory
   cwbcam/pc-sever/src.  Make sure that it is compiled in the 
   Microsoft C version 6.0 or higher and the Pathwork Socket Library
   are installed properly. 

7. The setup for the PC server is done.


HOW to Play
===========

1. In the PC-server, check if the camera is attached and power on.

2. Load the Video Driver according to your video card.

3. Run the program WWWCAM.EXE with the port number option.

4. In the WWW server, go to the CWB CAM Link
   (http://WWW_Server_site/camera/cam.html>
   and click any icon you want.