******************************************
* File: bdLCD.class                      *
* Title: bartdart LCD Applet             *
* Desc: Displays characters sequentially *
* Copyright: 2003 bartdart.com           *
* License: freeware                      *
* Version: 1.01                          *
******************************************

Intro & License
******************************************
bdLCD is a Java applet that displays characters you specify 
in sequence using custom colors and sizes.  Please go to 
http://www.bartdart.com for the latest version of this applet.
You may use this applet in any way as long as you use the 
Copyright parameter in your code (it wont work without it).  
You do not have permission to sell this applet or decompile it
and sell it.  

 
Applet Parameters
******************************************
Name		Type        	Desc
******************************************
ColorOn		Hex Color   	Foreground Color of Text (Def:435B15)
ColorOff	Hex Color	Background Color Behind Active Text (Def:94C41C)
ColorBack	Hex Color	Base Background Color of Display (Def:9BCA22)
Text		String		Message Text (Def: bartdart.com (o) use \\ for break)
Copyright	String		Copyright MUST BE TYPED AS: bartdart.com
DrawDelay	Integer		Delay in Milliseconds between characters (Def: 50)
InitDelay	Integer		Time in Milliseconds to Run Init Routine (Def: 1000)
PixelWidth	Integer		Width in Pixels of Characters (Def: 2)
PixelHeight	Integer		Height in Pixels of Characters (Def: 2)
RedrawTime	Integer		Time in Characters drawn after end of characters drawn 
				to redraw screen (Def: 0 for no redraw)

bdLCD calculates number of characters to draw based on applet size and
Pixel width and height you specify.  You must calculate how large to 
make your applet based on how many characters you need.  If you do not 
make these calculations, there will be blank space at the edges of your
display.

Example:  	You want a 40X4 Display with characters of size 2

You Need To:	Set PixelWidth and PixelHeight both to 1
		Set your applet width to... 
		40(characters) * 2(PixelWidth) * 5(DotRatio)=400
	
		Set your applet height to...
		4(characters) * 2(PixelHeight) * 7(DotRatio)=56

Applet Methods
******************************************
setElementColor (int colorElement, String theColor) 
------
Desc:	Sets the color of an element in the display to color you specify
	in hex.  colorElement values are:
				0	ColorOn
				1	ColorOff
				2	ColorBack


String getElementColor (int colorElement)
------
Desc:	Returns the current color of element you specify (See above for codes)


cycleColor ()
------
Desc:	Cycles through 6 predefined color schemes, performing an init each time


scrollDown ()
------
Desc:	Scrolls display down one line


scrollUp ()
------
Desc:	Scrolls display to the top


clearScreen ()
------
Desc:	Clears the Display Screen	


turnOff ()
------
Desc:	Turns off display


turnOn ()
------
Desc:	Turns display back on and performs init


setText (String theText)
------
Desc:	Sets the display text, replacing previous text


String getText ()
------
Desc:	Returns the display text in bdLCD


setDrawDelay (int drawDelay)
------
Desc:	Sets the Draw Delay of the display in Milliseconds


setInitDelay (int initDelay)
------
Desc:	Sets the Init Delay of the display in Milliseconds


resetDisplay ()
------
Desc:	Performs a display reset, performs init


Applet HTML Example
******************************************
*** See Example.html for more examples
*** Applet HTML Code

<applet code="bdLCD.class" name=1 width=300 height=64>
<param name="Text" value="ABC\hij\0123\!@#$%^&*()_+-=\[]{}|;':,./<>?`~\"><param>
<param name="PixelWidth" value="1"></param>
<param name="PixelHeight" value="1"></param>
<param name="Copyright" value="bartdart.com"></param>
</applet>


*** Calling the methods with javascript.  Use your own button image

<IMG src="button.gif" onClick="document.applets[0].scrollDown()" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].scrollUp()" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].cycleColor()" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].clearScreen()" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].setText('Hello\\Hi!')" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].setDrawDelay(40)" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].setInitDelay(6000)" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].resetDisplay()" BORDER=0>
<IMG src="button.gif" onClick="window.alert(document.applets[0].getText())" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].turnOff()" BORDER=0>
<IMG src="button.gif" onClick="document.applets[0].turnOn()" BORDER=0>


Disclaimer
******************************************
Neither bartdart.com nor Brett Bartholomew
are responsible for any damage caused to 
your property or code for using this freeware.
This freeware is provided without warranty of
any kind and is not guranteed in any way.  By using
this applet, you agree to take all responsibility
for the usage of this applet.