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-1999 Lithic Software Corporation, all rights reserved.  Images Copyright John Keogh (keo@lithic.com), who wrote the applet. For updates go to:
http://www.lithic.com/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="lsslideshow130.class" ARCHIVE="lsslideshow130.jar" width=420 height=270>

<PARAM NAME=slide1 VALUE="Above Treeline in the Lasals tukh.jpg http://www.lithic.com/java/calendar.html">
<PARAM NAME=slide2 VALUE="I-70, near Crescent Junction crescent.jpg http://www.kaibab.org/gcvv/gc_vb_tp.htm">
<PARAM NAME=slide3 VALUE="Blue Mesa Reservoir in January bluemesa.jpg http://www.kaibab.org/usgs/gc_dvbdp.htm">

<PARAM NAME=final VALUE="http://www.lithic.com/java/java.html">
<PARAM NAME=prior VALUE="http://www.lithic.com/">

<PARAM NAME=imagedirectory VALUE=".">

<PARAM NAME=link VALUE="blue">
<PARAM NAME=text VALUE="white">
<PARAM NAME=background VALUE="black">

<PARAM NAME=next VALUE="Next">
<PARAM NAME=previous VALUE="Previous">
<PARAM NAME=beginning VALUE="Beginning">
<PARAM NAME=about VALUE="About">

</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.
 


Parameters:

There are five types of  parameters:  slide, prior/final, imagedirectory, colors, button text, each of which is discussed briefly below.
 
slide
<PARAM NAME=slide3 VALUE="Blue Mesa Reservoir in January bluemesa.jpg http://www.kaibab.org/usgs/gc_dvbdp.htm">

These parameters hold the information for each slide.
[Description][space][image name][space][Link]

If you do not want the image to link to anything, use a "." for the link.  The image name must not contain a space.

So if you had an image of a mountain called "mountain.gif", and you wanted it link to a page with the url http://www.mountain.com/mountain.html, you would use the following:
View of a Mountain mountain.gif http://www.mountain.com/mountain.html

If you had a sunset image called "sunset.jpg", and you did not want to link it to a page, you would use the following:
Sunset View sunset.jpg .

prior/final
<PARAM NAME=final VALUE="http://www.lithic.com/java/java.html">
<PARAM NAME=prior VALUE="http://www.lithic.com/java/java.html">

If you want the final click on the next button to lead to a new page, set the final value to the URL of the next page, if not, use a "."
If you want a click on the previous button when the first slide is showing to lead to a new page, set the prior value to the URL of the new page, if not, use a "."
These are useful if you want the user to be able to navigate with the next and previous button after they have seen all the slides.

colors
<PARAM NAME=link VALUE="blue">
<PARAM NAME=text VALUE="black">
<PARAM NAME=background VALUE="white">

These are the colors used by the applet.  link refers to the color of the box which appears around slides which link to another page.  text refers to the color of the text which appear below the slides.  background is the background color of the applet.  Options are shown below under color.
 
imagedirectory
<PARAM NAME=imagedirectory VALUE=".">

This indicates where the images are located.  If they are in the codebase (this is the directory in which the class files are located), just use a "." for this parameter (this is the default).  If your images are in a different directory than your class file, and the URL of that directory is http://www.yourserver.com/images/, then the value would be "http://www.yourserver.com/images/".
 
buttontext
<PARAM NAME=next VALUE="Next">
<PARAM NAME=previous VALUE="Previous">
<PARAM NAME=about VALUE="About">
<PARAM NAME=beginning VALUE="Beginning">

All four of these parameters are included for multilingual support.  The text that is displayed on the buttons is taken from these parameters.  For example, for a French interface, change "Next" to "Suivant".
 
 
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:

The applet is free for use on non-commercial pages.  Decompilation or reverse engineering are violations of license.

Companies that own a domain and want to get a site license to use the slide show can purchase a license.  The licensed version does not have the About button.

In order to purchase a licensed version, you must have a company which owns a domain, which must be sent to us during the registration process.  The modified slideshow will only work on the domain for which it was registered.

Ordering Information is available at:
http://www.lithic.com/ordering/slideshow.html
 


Help/Consulting
Consulting, help with the parameters, customizing, and programming are available for a fee from Lithic Software Corporation.  To contact Lithic Software, email to consulting@lithic.com.

Please send bug reports to java@lithic.com.