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