
          AnfyBlur 2.1 - Copyright (C) by Fabio Ciucci 1997/98


This is a Java routine able to animate a sequence of GIF/JPG images, like
other animators, but it calculate also the motion blur affect between
frames, like blur effect caused by speed in cameras.
Offcouse the GIF/JPG frames must be all of same size.
Rememeber that you need both anblur.class , Lware.class and anfy.class.
You must upload these 3 .class files and insert the <applet> tag on your
html document to add this applet to your page.
Here an example of what you have to write in the html (the things anfter
the ; are comments with min-max values acceptet):


<applet code="anblur.class" width=200 height=226>  ; Name, Width, Height
<param name=credits value="Applet by Fabio Ciucci (www.anfiteatro.it/java.html)">
<param name=regcode value="NO">         ; Register code (if you have it)
<param name=reglink value="NO">         ; URL where go optionally when 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="Blur applet">  ; Statusbar message
<param name=imgs value="anim/ani">              ; Animation to load
<param name=format value=".gif">                ; Suffix of frames
<param name=nimgs value="5">                    ; Number of frames
<param name=pingpong value="YES">               ; Cyclic or Ping-Pong mode
<param name=doublesize value="YES">             ; Normal or double size.
<param name=speed value="100">                  ; Speed of play
<param name=pingpause value="1000">             ; Ping Pause
<param name=pongpause value="100">              ; Pong Pause
<param name=audioping value="audio/piccon.au">  ; Audio effect on Ping
<param name=audiopong value="NO">               ; Audio effect on Pong
<param name=priority value="3">                 ; Task priority (1..10)
Sorry, your browser doesn't suppor Java.        ; Msg in no java browsers
</applet>


NOTE: Don't place "; comments" on final HTML!!!

Copy and paste in your html document this cleared and correct tag:


<applet code="anblur.class" width=200 height=226>
<param name=credits value="Applet by Fabio Ciucci (www.anfiteatro.it/java.html)">
<param name=regcode value="NO">
<param name=reglink value="NO">
<param name=regnewframe value="YES">
<param name=regframename value="_blank">
<param name=statusmsg value="Blur applet">
<param name=imgs value="anim/ani">
<param name=format value=".gif">
<param name=nimgs value="5">
<param name=pingpong value="YES">
<param name=doublesize value="YES">
<param name=speed value="100">
<param name=pingpause value="1000">
<param name=pongpause value="100">
<param name=audioping value="audio/piccon.au">
<param name=audiopong value="NO">
<param name=priority value="3">
Sorry, your browser doesn't suppor Java.
</applet>


                             ---------


Here detailed instructions about how to change parameters:


The credits parameter can't be changed otherwise the applet will not work.

To activate the reg parameters read the shareware registration notes.
In the "regcode" parameter you have to place the registration code you
purchase from the author. If it is correct and the applet is run from the
registered domain name, you can use "reglink" parameter, where you can specify
an URL where bring user when the applet is clicked.
If you set to "YES" regnewframe, you can specify a frame where load 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 FRAMESET parent.
"_top"    : To load the link into the top body of the window.

Otherwise the frame name, for example "myframe1".

The images can be of any size, GIF and/or JPG. But all must be same size.
You can display them animated at original size, otherwise zooming them *2,
with "doublesize" parameter set to "YES".
In this case, remember to place in the "width" and "height" tags the doubled
size of frames.
For example, if frames are 100x113, you have to set width=200, height=223.
Setting "doublesize" to "NO", mean playing in original size, in this
case place the original size in "width" and "height" tags.
Note: when the format is .gif, DON'T save any transparency color information.

The frames of animation can start with any prefix, but must end with the
framenum (1,2,3,4...).
You can manually select the suffix (".gif" or ".jpg") with "format" param.
The "imgs" parameter needs the prefix name of images, with an evenctual
path. For example, if images are named ani1.gif, ani2.gif, ani3.gif,
and are placed in the anim/ subdirectory, you have to set:

<param name=imgs value="anim/ani">
<param name=format value=".gif">

The "nimgs" parameter needs to know the number of frames.

There are two replay modes: "CYCLIC" and "PING PONG".
The cyclic mode, simply play the frames starting from 1th, until the last
one, then restarts from 1th again: 1,2,3,4,5,1,2,3,4,5,1,2,3,4....
The ping pong mode instead play from 1th to last, then go backwards reaching
again 1th, then changing direction of play reach again the last frame.
In other words: 1,2,3,4,5,4,3,2,1,2,3,4,5,4,3,2,1,2,3,4.....
This mode is useful for some kind of movements, like the one in the
example animation included.
Setting "pingpong" to "YES" you enable ping pong mode, setting it to "NO"
you enable cyclic mode.

You can determine the speed of play with "speed" parameter. The value is
expressed in microseconds. Usually the animation goes slower than the
parameter, for drawing time.

The "pingpause" and "pongpause" parameters are the speed of first and
last frames, and setting one or both of them higher than "speed" parameter,
you will cause a pause. This can be useful in some cases.

You are able to add sounds at ping (first) and pong (last) frames, with
"audioping" and "audiopong" parameters.
To select a sound, place the name of .au sample, evenctually with the path.
Otherwise write a "NO", this will disable playing feature.

Note: sounds can be only in Sun's .au format. If your programs saves only
in .voc, .waw, .iff, search for programs like Goldwave to convert them.
Remember to save as 8000 Hz mono .au samples.


                             ---------


Compatibility parameters:


The "priority" parameter is useful mainly when you are running more than
one applet in same page, and one slows down or hangs.
If this applet run too slow or hangs because other one steal all the CPU
power, try increasing the priority.
Otherwise, if this applet runs well and others slows down, decrease the
priority. Consider the min priority is 1, normal priority is 5, and the
max priority is 10. Usually a priority of 3 is ok for single applets.


                             ---------


Copyright and distribution notices


Fabio Ciucci is the author and owner of this applet.
You can use freely this applet to enhance your web pages. But since I am
the author of the applet, I placed a secret linkware window that will appear
if the applet is clicked with mouse, only when the applet is online on a site:
it is external to the web browser, so it will not hit the design of your
beautyful html page.
This small window will simply show my name and ask for a link to my java
applets page.. the user can connect to it or cancel, or hide the window and
connect after visiting all your pages.
I hope this credit part is not a problem for you...
In any case, if link is accepted a new browser window will appear and your
page will remain on the original window, so you will not lost the visitor.
Consider you will use an effect programmed by me, without pay, for FREE!

NOTE: You can include the applets archive on CD-ROMS or shareware collections
and shareware sites without ask me, but only if you leave the archive(s)
unchanged.

                             ---------


Fabio Ciucci

fabioc@anfiteatro.it

http://www.anfiteatro.it/java.html


