Lithic Calendar

The author and Lithic Software Corporation assume no liability for the use of the Lithic Calendar applet. It is distributed without any warrantee of any type.

This applet and the accompanying documentation 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.

For updates go to:
http://www.lithic.com/java/java.html

This readme covers the following topics:
The Applet Tag
Parameters
License
Help/Consulting

The Lithic Calendar Applet tag:

To use the calendar, create pictures that are 220X140 pixels. Name them January.jpg, February.jpg, March.jpg, (this can be modified (see below)). Do not use the pictures that came with the package, they are included for demonstration (all were taken by John Keogh in the Southwestern US). The aspect ratio of the display, 2:1, is the same aspect ratio as most pictures one takes with a camera, but you will need to resize to 220X140 so that the pictures are displayed properly. Load the pictures in the same directory as the applet class file, then use the tag below in your html code. If the applets and images are located in a different directory than the web page, you will need to include a codebase modifier.

You can modify the parameters (see parameters), but if you are new to HTML and Java, you may want to just leave them as they are.

An example HTML file, calendar.html, is included for demonstration. Internet explorer will not display the images if they are on your hard drive, but most or all versions of Netscape should.

</APPLET>

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. The parameters are discussed below.

Parameters:

There are six types of parameters, each of which is discussed separately below: days of the week, months, images, week start day, colors, button text.

Days of the week
<PARAM NAME=Sun VALUE="Sun">
<PARAM NAME=Mon VALUE="Mon">
<PARAM NAME=Tue VALUE="Tue">
<PARAM NAME=Wed VALUE="Wed">
<PARAM NAME=Thu VALUE="Thu">
<PARAM NAME=Fri VALUE="Fri">
<PARAM NAME=Sat VALUE="Sat">
These parameters are included for internationalization. If you are making a non-English calendar, abbreviate the week day names for your language and substitute them for the abbreviations in the values of the above parameters. The space available is generally enough for three or four letters.

Months
<PARAM NAME=January VALUE="January">
<PARAM NAME=February VALUE="February">
<PARAM NAME=March VALUE="March">
<PARAM NAME=April VALUE="April">
<PARAM NAME=May VALUE="May">
<PARAM NAME=June VALUE="June">
<PARAM NAME=July VALUE="July">
<PARAM NAME=August VALUE="August">
<PARAM NAME=September VALUE="September">
<PARAM NAME=October VALUE="October">
<PARAM NAME=November VALUE="November">
<PARAM NAME=December VALUE="December">
These parameters are included for internationalization. If you are making a non-English calendar, substitute names of the months for your language for the values for these parameters.

Images
<PARAM NAME=JanuaryImage VALUE="January.jpg">
<PARAM NAME=FebruaryImage VALUE="February.jpg">
<PARAM NAME=MarchImage VALUE="March.jpg">
<PARAM NAME=AprilImage VALUE="April.jpg">
<PARAM NAME=MayImage VALUE="May.jpg">
<PARAM NAME=JuneImage VALUE="June.jpg">
<PARAM NAME=JulyImage VALUE="July.jpg">
<PARAM NAME=AugustImage VALUE="August.jpg">
<PARAM NAME=SeptemberImage VALUE="September.jpg">
<PARAM NAME=OctoberImage VALUE="October.jpg">
<PARAM NAME=NovemberImage VALUE="November.jpg">
<PARAM NAME=DecemberImage VALUE="December.jpg">
These are the names of the images that will be loaded for the corresponding month. The images must be in the codebase (if you upload everything to the same directory, and do not change the applet tag, that is the codebase). You can change them, but they should be a file name, do not use a URL. To ensure reliable loading, these images should be as small as possible.

Week Start Day
<PARAM NAME=weekstartsonmonday VALUE="false">
Most Europeans start the week on Monday, so they would set this to true. Americans start the week on Sunday, so leave it false. Everybody else, set appropriately.

Colors
<PARAM NAME=backcolor VALUE="FFFFFF">
<PARAM NAME=calendarback VALUE="BBBBCC">
<PARAM NAME=lines VALUE="000000">
<PARAM NAME=bright VALUE="FFFFFF">
<PARAM NAME=dark VALUE="0F0FCF">
The backcolor is the color of the applet background. The calendarback is the color of the calendar background. The lines, bright, and dark parameters are used to draw the lines on the calendar, and to make them appear raised. If you don't want the number to look raised, set the bright, dark, and calendarback values to the same color.

The colors must be in hex format, as shown. If you need some help with this format, try the hex color calculator (for Windows 3.1/95) located at:
http://www.lithic.com/software/free.html

If you make a mistake, the default colors of black or white will be used for the lines and background.

Button Text
<PARAM NAME=About VALUE="About">
<PARAM NAME=Next VALUE="Next">
<PARAM NAME=Current VALUE="Current">
<PARAM NAME=Previous VALUE="Previous">
This is what the buttons will display. If you make a mistake in these parameters, the button will display the default settings.

License:
This calendar is free to use on your pages. Please send email to java@lithic.com when your calendar is installed. Eventually, a list of all the sites where this calendar is displayed may be compiled so people can see all the different calendars.

Help/Consulting
For General questions, contact John Keogh at keo@lithic.com. 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.

Trademarks used in this documentation are the property of their respective owners.