home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / voxel / voxel.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  5.5 KB  |  149 lines  |  [TEXT/ttxt]
  1.  
  2.            AnfyVoxel - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4.  
  5. This applet can generate a lightsourced voxel landscape in realtime.
  6. Thanks to A. Griffini for his help.
  7. The applet is interactive, in fact you can control it with the mouse.
  8.  
  9. The animation superman.gif is a courtesy of mstanya@bigfoot.com
  10.  
  11. This applet is fully parametrized, so you can generate all kinds of
  12. interactive tunnel effects.
  13.  
  14. ****************************************************************************
  15.  
  16. The following 3 ".class" files must be uploaded: 
  17.  
  18. voxel.class
  19. Lware.class
  20. anfy.class
  21.  
  22. Plus, voxel.jar for speedy loading on recent browsers.
  23.  
  24. Optionally, upload an overlay image file.
  25.  
  26. ***************************************************************************
  27.  
  28. INSTRUCTIONS.
  29.  
  30. Insert the <applet> tag in your html document as follows to add this 
  31. applet to your page (Comments after the ";" symbol are code explanations 
  32. and acceptable min/max values. They are not part of the applet language):
  33.  
  34.  
  35. <applet archive="voxel.jar" code="voxel.class" width="320" height="180">
  36. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  37. <param name="regcode" value="NO">          ; Registration code (if you have it)
  38. <param name="reglink" value="NO">          ; Optional URL link when the applet is "clicked".
  39. <param name="regnewframe" value="YES">          ; Reglink opened in new frame?
  40. <param name="regframename" value="_blank">      ; Name of new frame for reglink
  41. <param name="statusmsg" value="Voxel applet">   ; Statusbar message
  42. <param name="res" value="1">                    ; resolution (1-8)
  43. <param name="shadow" value="4">                 ; Shadow factor
  44. <param name="roughness" value="130">            ; Ground roughness (50..200)
  45. <param name="numpal" value="2">                 ; Colour palette (1..27)
  46. <param name="backr" value="0">             ; RED comp. of backg. colour (0-255)
  47. <param name="backg" value="0">             ; GREEN comp. of backg. colour (0-255)
  48. <param name="backb" value="60">            ; BLUE comp. of backg. colour (0-255)
  49. <param name="horizon" value="50">          ; Horizon limit (0 .. 500)
  50. <param name="mapimg" value="symbmp.gif">   ; Land Map (image name or "NO")
  51. <param name="overimg" value="NO">            ; Optional image over applet
  52. <param name="overimgX" value="0">            ; Over image X offset
  53. <param name="overimgY" value="0">            ; Over image Y offset
  54. <param name="memdelay" value="1000">         ; Memory deallocation delay
  55. <param name="priority" value="3">            ; Task priority (1..10)
  56. <param name="fixnetscape" value="NO">        ; Fix Netscape 3.0 bug ("YES","NO")
  57. <param name="MinSYNC" value="10">            ; Min. milliseconds/frame for sync
  58. Sorry, your browser doesn't support Java.  ; Message for no java browsers.
  59. </applet>                                  ; End of applet tag
  60.  
  61. ***************************************************************************
  62.  
  63. INSTRUCTIONS.
  64.  
  65. The following instructions describe how to change parameters:
  66.  
  67. Attempting to change the "credits" parameter will disable the applet.
  68.  
  69. To activate the reg parameters read the shareware registration notes.
  70. In the "regcode" parameter, place the registration code you purchased
  71. from the author. If the code is correct and the applet is run from the
  72. registered domain name, you can use "link" parameters to link to a URL
  73. when the applet is "clicked".
  74.  
  75. If you set "regnewframe" to "YES", you can specify a specific frame 
  76. location for the reglink:
  77.  
  78. "_blank"  : To load the link in a new blank unnamed browser window.
  79. "_self"   : To load the link into the same window the applet occupies.
  80. "_parent" : To load the link into the immediate FRAMESET parent.
  81. "_top"    : To load the link into the top body of the window.
  82.  
  83. You can also set a custom frame name, such as "myframe1".
  84.  
  85. With the "overimg" parameter you can specify the name of an image that will
  86. be painted over the applet. The best options are transparent GIF images.
  87.  
  88. NOTE: Animated GIF images are supported, but will be animated only on latest
  89. browsers (Netscape 4 and Explorer 4 or newer).
  90.  
  91. With "overimgX" and "overimgY" you can center the image over the applet area.
  92.  
  93. The applet can be of any size. The "res" parameter determines the resolution:
  94. with res=1 pixels are small, but the effect is slow. With res=8, pixels are
  95. too big but the effect is faster. 
  96.  
  97. Optimum choices are 1-3. (In fact, res is a sort of zoomer).
  98.  
  99. With the "shadow" parameter, you can calibrate the light intensity: low
  100. values mean less shadows, whereas high values mean high contrasts and 
  101. light-shadow.
  102.  
  103. With "roughness" you can change the roughness of the ground: low values
  104. make soft desert, while high values make tall mountains.
  105.  
  106. You can select the colour palette with "numpal" parameter:
  107.  
  108.  
  109. 1) red     -> blue
  110. 2) orange  -> green
  111. 3) green   -> blue
  112. 4) blue    -> green
  113. 5) green   -> red
  114. 6) blue    -> red
  115. 7) yellow
  116. 8) yellow  -> blue
  117. 9) violet
  118. 10) red
  119. 11) violet -> green
  120. 12) pink   -> green
  121. 13) blue
  122. 14) blue2
  123. 15) azzure
  124. 16) green
  125. 17) green2
  126. 18) gray
  127. 19) blue    -> yellow
  128. 20) yellow
  129. 21) azzure  -> red
  130. 22) green   -> violet
  131. 23) red
  132. 24) violet
  133. 25) gray
  134. 26) gray2
  135. 27) gray3
  136.  
  137. As you can see, there are enough palettes to simulate the moon's surface,
  138. Mars surface, and so on.
  139.  
  140. With the horizon parameter you can increase the horizon calculated, with
  141. a value from "0" to "500". Higher horizon means slower effect.
  142.  
  143. If you want, you can load a heights map, but it must be a 256*256 pixels 
  144. wide grayscale image (GIF or JPG); darker grays are lower altitues, ligher 
  145. grays are higher altitudes.
  146.  
  147. View the included example voxmap.gif to understand this concept.
  148.  
  149.