VertScrollText Applet Readme

The VertScrollText applet is a simple Java 1.0 applet
that supports a multi-line vertical text marquee.  You
can supply the text, adjust the speed and colors, set
a non-moving image banner at the top, and more!
This applet and its source are free.

Here is the full list of features that you can select
and adjust with the VertScrollText applet.

  - text font face, font size, bold/italic style
    (default: 12 point Times)
  - text color, background color, link text color
    (default: white, black, blue)
  - movement amount, speed, and direction
    (default: upwards 1 pixel every 50 millisecconds)
  - margins and inter-line padding
    (default: 2 pixels each)
  - image banner at the top of the applet
    (default: none)

For ease of use, this applet is written as a single
modest-sized Java class.  To use this applet on
your web page, follow these steps:

     1. Put the applet tags into your HTML file.
        The tags should look something like this:

	<applet code="VertScrollText.class" width=200 height=300>
	</applet>

     2. In between the two applet tags, put your own
        parameter settings.  Check the reference
        information below, and the example HTML files,
	to see how the parameters should look.  Here
	are two examples

	    <param name="size" value="14">
	    <param name="color" value="FF9090">

     3. After your parameter settings, but still in
        between the two applet tags, put your text
	lines and links.  Each line of text can be
	a plain line or a clickable link.  Decide
	what you want to say first!  Note that your
	numbers must start at 1, and you cannot skip
	any numbers.  Here is an example.

	    <param name="text1" value="Visit Joe's">
	    <param name="text2" value="New web site!">
	    <param name="text3" value="">
	    <param name="text4" value="WWW.JOESDINER.COM">
	    <param name="link4" value="http://www.joesdiner.com">
	    <param name="text5" value="">
	    <param name="text6" value="Thanks">

     4. Upload your web page, the VertScrollText.class
        file, and your banner image (if any) to your 
	web site.  It is simplest if you put them all in
	the same directory or folder.  If you are using
	FTP, be sure to use binary mode to transfer the
	.class file, it won't work otherwise!

     5. Visit the web site, and see how it looks.  If
        you need to change things, adjust the parameters
	in the HTML file, and re-upload it.  Be sure to
	exit your web browser between changes, or your
	changes won't take effect due to applet caching.


If you have questions about the VertScrollText applet, or
need additional features, contact Neal Ziring, ziring@home.com.
Thanks.

===============================================================

Parameter Reference

Here are all the applet parameters accepted by the
VertScrollText applet.


Param Name        Usage                          Default
----------    -----------------------------     --------------
 font		Text typeface			  "Times"
 size           Text pointsize                    11
 bold           Whether to use bold font          "false"
 italic         Whether to use italic font        "false"
 color          Color of basic text, RGB in hex   FFFFFF
 bgcolor        Applet background color, RGB      000000
 linkcolor      Color of link text, RGB in hex    0000FF
 titleImage     URL of banner image to use        --none--
 center         Whether to center the text        "false"
 underlineLinks Whether to underline hyperlinks   "true"
 movement       Per-cycle movement amount and        1
                direction (+ is down, - is up)
 scrollByLines  Whether to scroll by lines, if    "false"
                false, smooth scroll by pixels
 period         Time between movement cycles,       50
                in milliseconds
 margin         Margins around text in pixels       2
 padding        Space between lines in pixels       2
 linkTarget     Browser link target window        "_self"

 textN          Text line number N (N>0), first   "Hello World!"
                line of text is "text1"

 linkN          Link URL for text line number     --none--
		N, if any.



For more information, consult the example HTML files.
