Capture Client Webcam Java Applet
Version 1.2.8
(c)1999-2008 StarDot Technologies

Overview
--------

Capture Client is a java applet that automatically
updates a live webcam image (JPG) at a specified
interval. With Capture Client, there is no need to
use a meta refresh tag or implement any refresh or
countdown javascript. Capture Client has an optional
built-in countdown to the next scheduled live image
and the image is "cleanly" refreshed with no visible
redrawing.

Capture Client is much smaller than most webcam
java applets and therefore loads very quickly on
the viewer's web browser.

Capture Client works with both Microsoft's JVM
(java virtual machine) and Sun's JVM. Because of a
lawsuit between Sun and Microsoft, Microsoft is no
longer shipping their JVM with Windows. You can
download Sun's free JVM from http://www.java.com

Installation Instructions
-------------------------

Setting up the java applet is very simple. There
are two basic steps.

1. Upload the CaptureClient.class to your web server.

   This can be done with any FTP software or whatever
   software you use to upload your HTML files to your
   web site. Make sure you leave the spelling and case
   intact. It must be titled CaptureClient.class on
   your web server. It is best to upload it to the same
   folder (directory) where you live page HTML and
   image is stored. Once you uploaded the class file
   to your server, you will not need to do this again.
   If it is not possible to place the HTML page, the image file,
   and the CaptureClient.class file on the same machine
   and in the same folder (directory), see the
   "Installing the Applet on a Separate Server"
   instructions below.

2. Implement HTML to reference the applet.
 
   The code below is set for a 640x480 image named
   netcam.jpg and will attempt to refresh every 30
   seconds. It is important to note that the applet
   height be 13 higher than the image height to allow
   room for the status bar. The status bar text is
   changeable... just keep the %M:%S intact. If you opt
   not to have the status bar, then set the applet
   width and height to match the width and height of
   your image.
 
   This block of html code is all that is needed to add
   the java applet to your web page:

   <applet code="CaptureClient.class" width="640" height="493">
   <param name="image" value="netcam.jpg">
   <param name="delay" value="30">
   <param name="status" value="2">
   <param name="statusText" value="Next live image in %M:%S">
   <param name="statusTextColor" value="#ffffff">
   <param name="backgroundColor" value="#000000">
   <param name="url" value="http://www.stardot-tech.com">
   </applet>

   That's all there is to it! If you have any questions or
   problems, e-mail help@stardot.com. Sorry, but we can only
   provide tech support to StarDot customers.

   Note: You can get rid of your current <img> tag,
   <META HTTP-EQUIV="refresh...> tag, and
   <script language="JavaScript"> block if you are using
   these.
 

If Your Image Is On A Different Server Than Your HTML File
----------------------------------------------------------

It is possible to have your HTML file on one server and
reference the live image and applet on another server (such
as a NetCam or Express 6 video server), but the applet HTML
code must be changed to accommodate this.

First, make sure the CaptureClient.class file resides in the
same directory as your live image on "Server B". Then, make
the following changes to the HTML code on "Server A".

Add "codebase" to the <applet> tag:

    <applet code="CaptureClient.class"
     codebase="http://machine_name_with_image.com"
     width="640" height="493">

The "image" parameter should only reference the filename
(preceded by the directory path, if required), and not the
server name.

    <param name="image" value="netcam.jpg">

Once you make these changes, you can display the live image
in the applet on "Server A" with the actual live image and
applet file residing on "Server B".

You can also use the "codebase" method to embed the camera's
live stream on your web site.

HTML Applet Reference
---------------------

Here is an explanation of the parameters that available in
Capture Client. Anything in quotation marks after "value"
can be changed.

<param name="image" value="netcam.jpg">
   The filename of the live JPG file is specified here.

<param name="delay" value="30">
   This is the number of seconds until Capture Client
   reloads the image. This should match the scheduling of
   the live image being uploaded. If your NetCam or
   Capture Host software is uploading a live image very 20
   seconds, you should set this value to 20.

<param name="delayMS" value="0">
   If your camera updates faster than once a second, you
   can use the delayMS parameter. The value represents
   milliseconds (i.e. 1000 = 1 second). Note: The delay
   and delayMS values are added together.

<param name="status" value="2">
   Status Bar options:
	0 = no status
	1 = status in browser status bar
	2 = status in applet under image
   If you use option 0 or 1, the applet height should equal
   the height of the image. If you use option 2, the height
   should equal the height of the image plus 13.

<param name="statusText" value="Next live image in %M:%S">
   This is the text that displays in status line (only valid
   if "status" value = 1 or 2). You can place any text you
   like here but if you'd like to show the countdown until
   the next live image, you must include %M:%S

   Markup Characters
   -----------------
   %H = hours
   %M = minutes
   %S = seconds (up to 60, to be used in %M:%S)
   %s = seconds only (no leading 0)

<param name="statusTextColor" value="#ffffff">
   This is the color of the status text. The color is a
   3-digit RGB value just like it is in HTML code. In this
   example, "#ffffff" means a value of hexadecimal FF (255)
   of red, green & blue, which is white.

<param name="backgroundColor" value="#000000">
   This is the color of the status bar itself (only valid
   if "status" value = 2).  The color is a 3-digit RGB value
   just like it is in HTML code. In this example, "#000000"
   means a value of 0 for red, green & blue, which is black.

<param name="url" value="http://your_web_site.com">
   When the live image is clicked, it will link to the site
   specified here. If you want no link, put value="". If the
   param is not listed, it will default to stardot.com.

<param name="urlWindow" value="_self">
   When the live image is clicked, it will either open the URL
   in the existing window (_self) or the window of your choice
   (_blank, _frame1, etc.) If the param is not listed, it will
   default to opening in the existing window.

<param name="noSplash" value="1">
   Turns off the splash screen.

(c) Copyright 1999-2008 StarDot Technologies. All rights
reserved. This software is offered "as is" and no guarantee
or warranty is provided. This software may not be distributed.