home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / plasma / plasma3.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  6.0 KB  |  134 lines  |  [TEXT/ttxt]
  1.  
  2.           AnfyPlasma - Copyright (C) by Fabio Ciucci 1996-99
  3.  
  4.  
  5. This applet can generate and animate a realtime "plasma" effect, well known
  6. in contest scenes. This applet is fully parametrized, so you can generate
  7. various kinds of plasma effects.
  8.  
  9. The transparent image gun.gif is a courtesy of Lone Star Posse Prod. Inc.
  10.  
  11. *************************************************************************
  12.  
  13. NECESSARY FILES.
  14.  
  15. Apart from an optional foreground image, the following 3 ".class" files
  16. must be uploaded: 
  17.  
  18. Plasma3.class
  19. Lware.class
  20. anfy.class
  21.  
  22. Plus, Plasma3.jar for speedy loading on recent browsers.
  23.  
  24. *************************************************************************
  25.  
  26. EXAMPLE.
  27.  
  28. Insert the <applet></applet> tag in your html document as follows to add 
  29. this applet to your page (Comments after the ";" symbol are code descriptions
  30. and acceptable min/max values. They are not part of the applet language):
  31.  
  32.  
  33. <applet archive="Plasma3.jar" code="Plasma3.class" width="192" height="192">
  34. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  35. <param name="regcode" value="NO">         ; Registration code (if you have it)
  36. <param name="reglink" value="NO">         ; Optional URL link when the applet
  37.                                           is "clicked'.
  38. <param name="regnewframe" value="YES">       ; Reglink opened in new frame?
  39. <param name="regframename" value="_blank">    ; Name of new frame for reglink
  40. <param name="statusmsg" value="Plasma applet">; Statusbar message
  41. <param name="res" value="3">                  ; resolution (1-8)
  42. <param name="gen1" value="43">                ; generator1 (8-2000)
  43. <param name="gen2" value="31">                ; generator2 (3-256)
  44. <param name="gen3" value="36">                ; generator3 (3-256)
  45. <param name="red1" value="0">                 ; Red1 (0-255)
  46. <param name="red2" value="127">               ; Red2 (0-255)
  47. <param name="red3" value="1">                 ; Red3 (1-8)
  48. <param name="green1" value="127">             ; Green1 (0-255)
  49. <param name="green2" value="127">             ; Green2 (0-255)
  50. <param name="green3" value="2">               ; Green3 (1-8)
  51. <param name="blue1" value="127">              ; Blue1 (0-255)
  52. <param name="blue2" value="127">              ; Blue2 (0-255)
  53. <param name="blue3" value="1">                ; Blue3 (1-8)
  54. <param name="speed" value="1">                ; Speed (1-8)
  55. <param name="overimg" value="NO">             ; Optional image over applet
  56. <param name="overimgX" value="0">             ; Over image X offset
  57. <param name="overimgY" value="0">             ; Over image Y offset
  58. <param name="memdelay" value="1000">      ; Memory deallocation delay
  59. <param name="priority" value="3">         ; Task priority (1..10)
  60. <param name="fixnetscape" value="NO">     ; Fix Netscape 3.0 bug ("YES","NO")
  61. <param name="MinSYNC" value="10">         ; Min. milliseconds/frame for sync
  62. Sorry, your browser doesn't support Java. ; Message for no java browsers.
  63. </applet>                                 ; End of applet tag
  64.  
  65.  
  66. ***************************************************************************
  67.  
  68. INSTRUCTIONS.
  69.  
  70. The following instructions describe how to change parameters:
  71.  
  72. Attempting to change the credits parameter will disable the applet.
  73.  
  74. To activate the reg parameters read the shareware registration notes.
  75. In the "regcode" parameter, place the registration code you purchased
  76. from the author. If the code is correct and the applet is run from the
  77. registered domain name, you can use "link" parameters to link to a URL
  78. when the applet is "clicked".
  79.  
  80. If you set "regnewframe" to "YES", you can specify a specific frame location
  81. for the reglink:
  82.  
  83. "_blank"  : To load the link in a new blank unnamed browser window.
  84. "_self"   : To load the link into the same window the applet occupies.
  85. "_parent" : To load the link into the immediate FRAMESET parent.
  86. "_top"    : To load the link into the top body of the window.
  87.  
  88. You can also set a custom frame name, such as "myframe1".
  89.  
  90. With the "overimg" parameter you can specify the name of an image that will
  91. be painted over the applet. The best options are transparent GIF images.
  92. NOTE: Animated GIF images are supported, but will be animated only on 
  93. latest browsers (Netscape 4 and Explorer 4 or newer).
  94.  
  95. With "overimgX" and "overimgY" you can center the image over the applet area.
  96.  
  97. The size of the applet is determined by the width and height tags.
  98.  
  99. The "res parameter determines the resolution: with res=1 pixels are small,
  100. but the effect is slow. With res=8 pixels are too big but the effect isfast.
  101. The optimum choices are 2-4.
  102.  
  103. About the plasma generators: (gen1,gen2,gen3)- I can say that gen1 is a
  104. rather smooth value: the min is 8 (very smooth, like fog), and the max is
  105. 2000, where all is psychedelic (too much, I think). Gen2 and Gen3 are x and y
  106. stretchers... they can go from 3 (many small curves) to 256 (one great curve).
  107.  
  108. About the palette: there are 3 parameters for each Red Green Blue (RGB)
  109. component. This is more complex, but can give you much flexibility (and
  110. also the power to do many bugged palettes).
  111.  
  112. The red1,green1,blue1 values (0-255) are the multipliers of totality.
  113. The red2,green2,blue2 values (0-255) are fixed added values of totality.
  114. The red3,green3,blue3 values (1-8) are "smoothing" values of totality.
  115. This means that if red1=0, then the green3 value is totally disabled and
  116. all the 256 colors will have the "red2" red component.
  117.  
  118. You can experiment with these values, but some combinations make ugly
  119. palettes. For those who understand palettes, consider the formula used to
  120. make a palette (r steps from 0 to 255):
  121.  
  122.       red =  (sin(r*PI*2/(256/red3  ))*red1  )+red2
  123.       green= (sin(r*PI*2/(256/green3))*green1)+green2
  124.       blue = (sin(r*PI*2/(256/blue3 ))*blue1 )+blue2
  125.  
  126. In any case, a component value must exceed 255.
  127.  
  128. The speed from 1 to 8 is useful, only when you make really large plasmas.
  129. In this case you can increase this value a bit, but the plasma will not 
  130. really be faster: it will simply skip some frames.
  131.  
  132. This also adds flickering and loose smoothing effects (in faster machines).
  133. Please use speed = 1 when possible, and don't exceed speed=4.
  134.