AnfyPlasma 2.1 - Copyright (C) by Fabio Ciucci 1996/98


This applet can generate and animate a realtime "plasma" effect, well know
in the "demo scene" contest.
Remember that are needed both Plasma3.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.
This applet is fully parametrized, so you can generate all kinds of plasma
you want. 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="Plasma3.class" width=192 height=192>  ; 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="Plasma applet">  ; Statusbar message
<param name=res value="3">                ; resolution (1-8)
<param name=gen1 value="43">              ; generator1 (8-2000)
<param name=gen2 value="31">              ; generator2 (3-256)
<param name=gen3 value="36">              ; generator3 (3-256)
<param name=red1 value="0">               ; Red1 (0-255)
<param name=red2 value="127">             ; Red2 (0-255)
<param name=red3 value="1">               ; Red3 (1-8)
<param name=green1 value="127">           ; Green1 (0-255)
<param name=green2 value="127">           ; Green2 (0-255)
<param name=green3 value="2">             ; Green3 (1-8)
<param name=blue1 value="127">            ; Blue1 (0-255)
<param name=blue2 value="127">            ; Blue2 (0-255)
<param name=blue3 value="1">              ; Blue3 (1-8)
<param name=speed value="1">              ; Speed (1-8)
<param name=textscroll value="plasmscr.txt"> ; File for scrolltext or "NO"
<param name=textoffset value="140">          ; Txtscroll y offset
<param name=textspeed value="1">          ; Txtscroll speed
<param name=textfont value="Arial">       ; Txtscroll font name
<param name=textbold value="NO">          ; Txtscroll bold ("YES" or "NO")
<param name=textsize value="24">          ; Txtscroll font size
<param name=textshadow value="YES">       ; Txtscroll shadow ("YES" or "NO")
<param name=TextColR value="200">         ; Txtscroll color (red component)
<param name=TextColG value="255">         ; Txtscroll color (green component)
<param name=TextColB value="190">         ; Txtscroll color (blue component)
<param name=TextSColR value="20">         ; Txtscroll shadow col. (red c.)
<param name=TextSColG value="20">         ; Txtscroll shadow col. (green c.)
<param name=TextSColB value="50">         ; Txtscroll shadow col. (blue c.)
<param name=TextJumpAmp value="0">        ; Txtscroll jump aplitude
<param name=TextJumpSpd value="0">        ; Txtscroll jump speed
<param name=TextSineAmp value="0">        ; Txtscroll sineshape amplitude        
<param name=TextSineSpd value="0">        ; Txtscroll sineshape movement
<param name=TextSineAngle value="0">      ; Txtscroll sineangle / pixel  
<param name=memdelay value="1000">        ; Memory deallocation delay
<param name=priority value="3">           ; Task priority (1..10)
<param name=fixnetscape value="NO">       ; Fix Netscape 3.0 bug ("YES","NO")
<param name=MinSYNC value="10">           ; Min. milliseconds/frame for sync
Sorry, your browser doesn't suppor Java.  ; Message for no java browsers.
</applet>                                 ; End of applet tag


                             ---------


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 size of the applet is determined by width and height tags.

The res parameter determine the resolution: with res=1 pixels are small,
but effect is slow, with res=8 pixels are too great but effect fast.
I think the best choices are 2-4.

About the plasma generators gen1,gen2,gen3, I can say that gen1 is a sort
of smooth value: the min is 8 (very smooth, like fog), and the max is 2000,
where all is psychedelic (too much, I think). Gen2 and Gen3 are x and y
stretchers... can go from 3 (many small curves) to 256 (one great curve).

About the palette, there are 3 parameters for each Red Green Blue (RGB)
component. This is more complex, but can give you much flexibility (and
also the power to do many bugged palettes).
The red1,green1,blue1 values (0-255) are the multipliers of tonality.
The red2,green2,blue2 values (0-255) are fixed added values of tonality.
The red3,green3,blue3 values (1-8) are "smoothing" values of tonality.
This mean that if red1=0, then green3 value is totally disabled and
all the 256 colours will have "red2" red component.
Try to change this values, but some combinations make ugly palettes,
you have to make some experiments. Just for who can understand, consider
the formula used to make palette (r steps from 0 to 255):

      red =  (sin(r*PI*2/(256/red3  ))*red1  )+red2
      green= (sin(r*PI*2/(256/green3))*green1)+green2
      blue = (sin(r*PI*2/(256/blue3 ))*blue1 )+blue2

In any case a component value must exceed 255. easy, no?

The speed, from 1 to 8, is useful only when you make really large plasmas
that are slow... in this case you can increase a bit this value, but
the plasma will be not really more fast: it will simply skip some frames,
and this add flickerings and loose smoothness (in faster machines).
Please use speed = 1 when possible. Or atleast don't exceed speed=4.