Make your own free website on Tripod.com
The author and Lithic Software Corporation assume no liability for the use of the lsSlideShow Applet.  It is distributed without any warrantee of any type.

This applet and the accompanying images may not be distributed for profit or on CD without the express written consent of the copyright holder. The applet and documentation are Copyright 1998 Lithic Software Corporation, all rights reserved.  Images Copyright John Keogh (keo@gj.net), who wrote the applet. For updates go to:
http://www.gj.net/~lithic/java/java.html
 
This readme covers the following topics:
The Applet Tag
Parameters
Colors
License
Help/Consulting


The lsSlideShow Applet tag:

The tag looks like this (an example html file, SlideShow.html,  is included in the distribution package):
<APPLET CODE="lsSlideShow.class" width=320 height=350>
<PARAM NAME=number VALUE="3">
<PARAM NAME=descriptions
VALUE="Lithic Software Page^Lithic Java Page^Grand Junction Pages^ "
<PARAM NAME=links
VALUE="http://www.gj.net/~lithic^.^http://www.gj.net/~lithic/local/local.html^">
<PARAM NAME=link VALUE="blue">
<PARAM NAME=text VALUE="black">
<PARAM NAME=background VALUE="white">
</APPLET>

The width and height are adjustable, the canvas automatically adjusts.  Experiment with them until you get the look you want.

When you upload this or any applet, you need to use binary mode rather than ASCII mode.  Binary mode is the default mode for a lot of FTP clients, so generally just upload as normal. 

In the above tag, the number parameter indicates that there are three slides named 1.jpg through 3.jpg (currently, lsSlideShow only supports jpegs).  The jpegs must be in the same directory that the applet is downloaded from.

Generally, there should be a 1:1:1 corresponce between the number of slides, links,  and descriptions.  If there is one more link then there are descriptions and slides, the final link will lead from the applet to a new page.  This provides a way to present some material, then have the final click on the "Next" button lead to a new page.

Parameters:

There are five parameters:  number, descriptions, links, link, text, and background, each of which is briefly discussed below.

<PARAM NAME=number VALUE="5">
This indicates how many slides and what they are named.  In the case above, there would be five slides named 1.jpg through 5.jpg.  Currently, lsSlideShow only supports jpegs.  The images must be in the same directory that lsSlideShow.class is in.

<PARAM NAME=descriptions VALUE="first description^second description ^third description^">

The descriptions parameter contains the descriptions that will appear below the slides. There should be one for each slide.  Each description  is separated from the next by a '^'.  Important: the list must teminate with a '^'.  If the description contains a ^, it must be doubled.  The descriptions cannot begin or end with a '^'.  You can separate the items in the lists by carriage returns, if you wish. So the above list can be written:
"first description^
second description^
third description^"

<PARAM NAME=links VALUE="http://www.gj.net/~lithic/hiking/hiking.html^.^http://www.gj.net/~lithic/local/local.html^">

These are the links that the pictures are linked to.  As above, each is separated by a ^.  If the image is not linked, use a dot (.)   The urls must be full urls, not relative. If the picture is linked, a click on the picture will point the browser at the new url.

<PARAM NAME=link VALUE="blue">

This is the color of the box which appears around slides which link to another page.  Options are shown below under color.

<PARAM NAME=text VALUE="black">

This is the color of the text which appear below the slides.  Options are shown below under color.

<PARAM NAME=background VALUE="white">

This is the background color of the applet.  Options are shown below under color.
 
 
Colors:

Colors can be set for the links, text, and background, as discussed above under parameters.
The colors can be any of the following (case sensitive):
black
blue
cyan
darkgray
gray
lightgray
green
magenta
orange
pink
red
white
yellow


License:
The Applet is distributed under the following license:
Free for use on personal sites where nothing is sold.  For use on company sites and/or sites where anything is sold or advertised, the license fee is $20 US per page where it will appear (generally only one).  This will be on an honor system.  Upgrades to this applet will be free to download.  If you are a commercial user, you can register by sending a check for $20.00 US to Lithic Software Corporation, P. O. Box 2994, Grand Junction, CO 81502.  A receipt will be sent to you via the postal service.


Help/Consulting
For General questions, contact John Keogh at keo@gj.net.  Consulting, help with the parameters, customizing, and programming are available for a fee from Lithic Software Corporation.  To contact Lithic Software, email to lithic@gj.net