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