BooZer Scroller by Stefan Mateescu

BooZer Scroller V1.0

Here you will find all information you need about the usage, configuration and registration of the BooZer Scroller applet by Stefan Mateescu. Before mailing the author any problems that you may have experienced, read this info carefully!

Contents

How this applet works...
The textfile
Textfile-Commands
Parameter setup
Freeware & Shareware
Registration
Last words...
See the demo HTML

How this applet works...

As this is a Java applet, the whole code is in a *.class file. This is "BoozerScroller.class" (please remember that Java is case sensitive, so "boozerscroller.class" is not the same). The applet is loaded by the html-file which you may have edited, and after the page is loaded the applet is started. The first thing that this applet will try is to load the text file. These is the only external file that is needed for the scroller to work!

So when you upload the whole bunch to your homepage you have a minimum of THREE files, when using this applet:

the HTML-File, where your applet is set up by the applet and param tags
the class file ("BoozerScroller.class"), which includes the actual code (or program)
a text file, which includes the text that scrolls over the applet

If you don't really understand what the class file is for, read in your HTML manual about "Using Java applets" or similar...

The textfile

As mentioned above, the textfile is the first thing you have to take care of after you edited your HTML script. Edit the textfile with any text-editor you like (notepad or even with a html-editor). Everything that is in that textfile will be displayed on the applet. A RETURN (what means a new line) will always be interpreted like a blank space, so you can begin a new line after every word or where ever you want. See also the demo-text from the ZIP package and you will understand.
You can also control the scroller with Textfile-Commands, which are explained next...

Textfile-Commands

A very powerful way to add functionality to this applet is using the Textfile-Commands. These commands can set the parameters of the applet while it is running. For example you can change the boozer-effect or the speed within the text...
Here is a example of a textfile:

This text scrolls... [E1] Now the effect was changed...
[W1] Now the water is on... [W0] ..and off!
[S5] Speed set to 5! [S1] Speed down to 1 [E7] Effect 7 enabled.
[B] This text is displayed after the screen was scrolled empty!
And this demonstrates a [L http://www.demo-link.com link]...
...

As you have seen, the commands are always in []. Following commands are available:

[Ex]	Effect of the BoozerMotion, where x can be between 0 and 9 // example: [E0],[E3],[E9],...
[Wx]	Water effect, [W1] to enable or [W0] to disable // example: [W0] or [W1]
[Sx]	Scrolling Speed, where x can be between 1 and 9 // example: [S1],[S2],[S5],...
[B]	Scrolls a blank gap, until the screen is empty // example: [B]
[L xxx yyy]	Link setup: xxx is the URL to go to and yyy is the clickable text // example: [L http://www.yahoo.com Click here for YAHOO!] // The displayed text is separated from the URL by a blank space - you know: no spaces in URLs allowed!

Notes:

Don't forget to close the bracketts!
After a [B] you have to leave a blank space because the "blanker" is activated one char AFTER the command
It is a good idea to use the [B]lanker before you change the [E]ffect!
You can always combine the [W]ater effect with any other [E]ffect.

Parameter setup

Here you find the description about the available parameters for the Boozer Scroller:

General Parameters
threadWait	sets the time in millisecons which the applet waits between the redraws.
maxFps	sets the maximum speed of the applet (in frames per second) - if the processor of the target system is too slow, then lower frame rates are possible!
showFps	display the frame rate (1 to enable, 0 to disable)
backCol	background color of the applet
Texter Parameters
txtfile	filename of the text to be used
sinMax	the sinus-interval for the boozer movements - best between 120 and 250
speed	the scrollspeed (can also be changed by texter-commands)
effect	boozer effect - between 0 and 9 (can also be changed by texter-commands)
water	water effect - 1 to enable, 0 to disable (can also be changed by texter-commands)
waterpart	waterpart - this is the area of the water in percent (set it to max. 35!!)
fontName	font name (no comment)
fontSize	font size (no comment)
fontStyle	font style (0 = normal, 1 = bold, 2 = italic, 3 = bold-italic)
fontColor	font color (no comment)
linkColor	color of the link when the mouse pointer is over it
linkTarget	target for the links (_self,_top,_blank or a specific frame name)
PRO parameters
regCode	registration code
statustext	status text that will be displayed, when the mouse is moved over the applet

Change the size of the applet in the applet tag.

Note: the PRO parameters will take no effect if the regCode is wrong or missing!

Freeware and Shareware

This applet is FREE to use for private purposes. That means you don't need a regCode to use the applet in your own private homepage. BUT, if you don't have a working regCode the applet will add some copyright info to the scrolltext. Also the status text will display some copyright notice! If you want to disable these, you have to register (see more below).

For commercial use you have to register. No commercial use of unregistered versions allowed!

Registration

The applet always checks the location of the actual URL where it is running. That's why you will need a regCode that enables the full fuctionallity for the desired URL.
Registration codes will also work with updated versions of this applet!

How to get a regCode... ?

Send the URL where you want the applet to be enabled via email to the author.
(If your homepage is on servers like geocities, tripod, anglefire, etc. then send the FULL path of your directory)
You sure know, that programming such an applet is hard work. To make sure that other applets of high quality will be available in the future I have to bill you for the usage of a registered applet a small shareware fee. I am not doing this job professionally, so you will have to send US $10,- (with your name and email adress) to my home address (If you live in Germany, see the notice below!):
Stefan Mateescu
Schockenriedstr.45
70565 Stuttgart
Germany
After I receive both, the URL and the shareware fee I will send you the regCode that you need for your homepage via email!

If you need more regCodes then this is the formula: every 5 regCodes you get one FREE!

After you received your regCode, NO REPAY WILL BE POSSIBLE! If you move your homepage to another URL you will need a new one.

By registering this applet you are allowed to use it for commercial homepages. Use it at your own risk! The author does not guarantee compatibility to all Web users. There are lots of browsers and systems out there which cannot run this applet properly! No warranty or support from the author! You will use this applet AS IS!

If you live somewhere, where you see Seinfeld in english language on television, you can take a VHS tape, record at least two shows and send me this as a gift. PAL or NTSC - both are OK! I will really appreciate this...

For german users only:
Wenn Sie in Deutschland wohnen, können Sie die "registration fee" auch per Banküberweisung (DM 20,-) bezahlen. Falls Interesse daran besteht, dann einfach in der email mir der URL darauf verwisen, daß Sie das Geld überweisen möchten, dann sende ich Ihnen meine Bankverbindung (regCodes gibt es aber erst NACH Empfang des Geldes).

Last words...

Use this applet at your own risk! The author does not guarantee the compatibility to all Web users. There are lots of browsers and systems out there which cannot run this applet properly!

Do not remove the copyright params! Without these the applet won't work!

Play around with the params and you will see how everything works!

Don't make it too big - it can get very slow on older machines! The bigger you make it, the slower it gets!

For further questions, bug reports or whatever, mail me: mateescu@headlight.de

Don't forget to give me a credit!

Visit my homepage for more applets: http://storm.headlight.de

History

07.March.1999 - Boozer Scroller 1.0 finished