Anfy Fireworks - Copyright (C) by Fabio Ciucci 1999-2002


INTRODUCTION.

This applet adds a fireworks animation to a selected image as either a 
foreground or background layer. The image may be very dark or solid black
in colour.

**************************************************************************

NECESSARY FILES.

Apart from an optional sound file, and/or background and/or foreground
images, the following 3 files must be uploaded:
 
firewks.class
firewk.class
Lware.class

Plus, you may want ot upload firewks.jar for speedy loading on recent 
browsers.

**************************************************************************

EXAMPLE.

Insert the <applet></applet> tag in your html document as follows to add
 this applet to your page (Comments after the ";" symbol are code 
explanations and acceptable min/max values. They are not part of the 
applet language):


<applet archive="firewks.jar" code="firewks.class" width="320" height="208">
<param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
<param name="regcode" value="NO">         ; Registration code (if you have it)
<param name="reglink" value="NO">         ; Optional URL link when the applet
                                          is "clicked"
<param name="regnewframe" value="YES">       ; Reglink opened in new frame?
<param name="regframename" value="_blank">   ; Name of new frame for reglink
<param name="statusmsg" value="Fireworks">   ; Statusbar message
<param name="boomsound" value="boom.au">     ; Optional sound file or "NO"
<param name="maxfireworks" value="3">        ; Number of fireworks at same time
<param name="fireworkspower" value="800">    ; Fireworks explosion power
<param name="fireworksdensity" value="200">  ; Fireworks drawn density
<param name="fireworksduration" value="160"> ; Fireworks time duration
<param name="gravity" value="250">           ; Gravity; speed of free fall
<param name="backimage" value="NO">          ; Background image
<param name="bgcolor" value="000133">     ; Background colour in hex rrggbb format
<param name="overtext" value="NO">        ; Fireworks over text? ("YES", "NO")
<param name="overimg" value="NO">        ; Optional image over applet
<param name="overimgX" value="0">        ; Over image X offset
<param name="overimgY" value="0">        ; Over image Y offset
<param name="memdelay" value="1000">     ; Memory deallocation delay
<param name="priority" value="3">        ; Task priority (1..10)
<param name="MinSYNC" value="10">        ; Min. milliseconds/frame for sync
Sorry, your browser doesn't support Java. ; Message for no java browsers.
</applet>                              ; End of applet tag

                             
****************************************************************

PARAMETER DESCRIPTIONS


The following instructions describe the meaning of the available 
parameters for this applet:

[Specify the applet and its size]

<applet archive="firewks.jar" code="firewks.class" width=320 height=208>

The size of the applet has to be identical to that of the background
or foreground image, if present.

[Credit parameter]

<param name=credits value="Applet by Fabio Ciucci (www.anfyteam.com)">

Attempting to change the credit parameter will disable the applet.

[Registration parameters]

<param name=regcode value="NO">         ; Registration code 

To activate the reg parameters, read the shareware registration notes.
In the "regcode" parameter, place the registration code you purchased 
from us. If the code is correct and the applet is run from the registered
 domain name, "link" parameters will be enabled and the applet will be
linked to an associated URL when it mouse-clicked.

<param name=reglink value="NO">         ; Optional URL link
<param name=regnewframe value="YES">       ; Reglink opened in new frame?

If you set "regnewframe" to "YES", you can specify a specific frame location
for the reglink:

"_blank"  : To load the link in a new blank unnamed browser window.
"_self"   : To load the link into the same window the applet occupies.
"_parent" : To load the link into the immediate parent frame.
"_top"    : To load the link into the top body of the window.

<param name=regframename value="_blank">   ; Name of new frame for reglink

You can also set a custom frame name, such as "mainpage".

<param name=statusmsg value="Fireworks">   ; Statusbar message

Here, you set the statusbar message, which is displayed at the bottom
of a browser window, when you mouse-over the applet.

[Sound]

<param name=boomsound value="boom.au">     ; Optional sound file or "NO"

This applet allows you to set a sound file. The default is a sound effect
for fireworks. You can set your own .au file in place of the default
one; otherwise place "no" for the parameter. 

[Fireworks setting]

<param name=maxfireworks value="3">        ; Number of fireworks at same time

With the "maxfireworks" parameter, you determine the maximum number of
 fireworks present on screen at one time.

<param name=fireworkspower value="800">    ; Fireworks explosions power

With "fireworkspower" you determine the speed of propagation of explosion.

<param name=fireworksdensity value="200">  ; Fireworks density

With "fireworksdensity" you determine the number of dots in each explosion.
Higher values require higher CPU power and slow down the effect.

<param name=fireworksduration value="160"> ; Fireworks time duration

The duration of fireworks is determined by the "fireworksduration" parameter.

<param name=gravity value="250">           ; Gravity

This "gravity" parameter controls how fast fireworks fall down. Well, I know
in real world, gravity is a constant.

<param name=backimage value="image.jpg"> ; Background image

Here, you can set a background image. 

<param name=bgcolor value="000133">     ; Background colour in hex rrggbb format

Or, paint the background in a solid colour defined by a hexadecimal number in
a popular RRGGBB format. This parameter is valid only when the background image 
is absent, otherwise ignored.

<param name=overtext value="NO">        ; Fireworks over text? ("YES", "NO")

The "overtext" determines if fireworks can overwrite scrolltext.

[Overlay image]

<param name=overimg value="NO">           ; Optional image over applet
<param name=overimgX value="0">           ; Over image X offset
<param name=overimgY value="0">           ; Over image Y offset


With the "overimg" parameter you can specify the name of an image that will
be shown over the applet. The best options are transparent GIF images.

NOTE: Animated GIF images are supported, but will be displayed as animated
only on latest browsers (Netscape 4 and Explorer 4 or newer).
With "overimgX" and "overimgY" you can position the image over the applet area.