home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 April / CHIP_4_98.ISO / Java / applet / cubemenu / cubemenu.txt < prev    next >
Encoding:
Text File  |  1998-02-21  |  15.3 KB  |  336 lines
  1.  
  2.     Anfy Cube Menu 1.1 - Copyright (C) by Fabio Ciucci 1997/98
  3.  
  4.  
  5. This applet is a modified version of TmapCube that can work as selector
  6. menu, where each face of the cube is a selectable option.
  7. This feature is working only when registered paying the shareware.
  8. Remember that are needed both CubeMenu.class , Lware.class and anfy.class.
  9. You must upload these 3 .class files and insert the <applet> tag on your
  10. html document to add this applet to your page.
  11. This applet is fully parametrized, so you can change the size and movements
  12. of the cube. Here an example of what you have to write in the html (the
  13. things anfter the ; are comments with min-max values acceptet):
  14.  
  15. <applet code="TmapCube.class" width=188 height=188> ; Name, Width, Height
  16. <param name=credits value="Applet by Fabio Ciucci (www.anfiteatro.it/java.html)">
  17. <param name=regcode value="NO">         ; Register code (if you have it)
  18. <param name=regnewframe value="YES">    ; Reglink opened in new frame?
  19. <param name=regframename value="_blank"> ; Name of new frame for reglink
  20. <param name=res value="1">              ; Resolution (1 .. 8)
  21. <param name=image1 value="face1.gif">   ; Image 1 to load
  22. <param name=image2 value="face1.jpg">   ; Image 2 to load
  23. <param name=image3 value="face2.gif">   ; Image 3 to load
  24. <param name=image4 value="face2.jpg">   ; Image 4 to load
  25. <param name=image5 value="face3.jpg">   ; Image 5 to load
  26. <param name=image6 value="face3.jpg">   ; Image 6 to load
  27. <param name=link1 value="http://www.yahoo.com">     ; Link for face 1
  28. <param name=link2 value="http://www.yahoo.com">     ; Link for face 2
  29. <param name=link3 value="http://www.eff.org">       ; Link for face 3
  30. <param name=link4 value="http://www.eff.org">       ; Link for face 4
  31. <param name=link5 value="http://www.anfiteatro.it"> ; Link for face 5
  32. <param name=link6 value="http://www.anfiteatro.it"> ; Link for face 6
  33. <param name=statusmsg1 value="site 1">  ; Statusbar message for face 1
  34. <param name=statusmsg2 value="site 1">  ; Statusbar message for face 2
  35. <param name=statusmsg3 value="site 2">  ; Statusbar message for face 3
  36. <param name=statusmsg4 value="site 2">  ; Statusbar message for face 4
  37. <param name=statusmsg5 value="site 3">  ; Statusbar message for face 5
  38. <param name=statusmsg6 value="site 3">  ; Statusbar message for face 6
  39. <param name=rotx value="4">             ; X Rotation speed
  40. <param name=roty value="6">             ; Y Rotation speed
  41. <param name=rotz value="8">             ; Z Rotation speed
  42. <param name=backimage value="NO">       ; Optional background image
  43. <param name=backr value="64">           ; Red in background (0 .. 255)
  44. <param name=backg value="96">           ; Green in background (0 .. 255)
  45. <param name=backb value="160">          ; Blue in background (0 .. 255)
  46. <param name=clearback value="YES">      ; Clear the background ("YES" - "NO")
  47. <param name=textscroll value="tcubescr.txt"> ; File for scrolltext or "NO"
  48. <param name=textoffset value="140">          ; Txtscroll y offset
  49. <param name=textspeed value="1">          ; Txtscroll speed
  50. <param name=textfont value="Arial">       ; Txtscroll font name
  51. <param name=textbold value="NO">          ; Txtscroll bold ("YES" or "NO")
  52. <param name=textsize value="24">          ; Txtscroll font size
  53. <param name=textshadow value="YES">       ; Txtscroll shadow ("YES" or "NO")
  54. <param name=TextColR value="200">         ; Txtscroll color (red component)
  55. <param name=TextColG value="255">         ; Txtscroll color (green component)
  56. <param name=TextColB value="190">         ; Txtscroll color (blue component)
  57. <param name=TextSColR value="20">         ; Txtscroll shadow col. (red c.)
  58. <param name=TextSColG value="20">         ; Txtscroll shadow col. (green c.)
  59. <param name=TextSColB value="50">         ; Txtscroll shadow col. (blue c.)
  60. <param name=TextJumpAmp value="0">        ; Txtscroll jump aplitude
  61. <param name=TextJumpSpd value="0">        ; Txtscroll jump speed
  62. <param name=TextSineAmp value="0">        ; Txtscroll sineshape amplitude        
  63. <param name=TextSineSpd value="0">        ; Txtscroll sineshape movement
  64. <param name=TextSineAngle value="0">      ; Txtscroll sineangle / pixel  
  65. <param name=memdelay value="1000">        ; Memory deallocation delay
  66. <param name=memdelay value="1000">        ; Memory deallocation delay
  67. <param name=priorityL value="3">          ; Loading task priority (1..10)
  68. <param name=priority value="3">           ; Task priority (1..10)
  69. <param name=MinSYNC value="10">           ; Min. milliseconds/frame for sync
  70. Sorry, your browser doesn't suppor Java.  ; Message for no java browsers.
  71. </applet>                                 ; End of applet tag
  72.  
  73.  
  74. NOTE: Don't place "; comments" on final HTML!!!
  75.  
  76. Copy and paste in your html document this cleared and correct tag:
  77.  
  78.  
  79. <applet code="TmapCube.class" width=188 height=188>
  80. <param name=credits value="Applet by Fabio Ciucci (www.anfiteatro.it/java.html)">
  81. <param name=regcode value="NO">
  82. <param name=regnewframe value="YES">
  83. <param name=regframename value="_blank">
  84. <param name=res value="1">
  85. <param name=image1 value="face1.gif">
  86. <param name=image2 value="face1.gif">
  87. <param name=image3 value="face2.jpg">
  88. <param name=image4 value="face2.jpg">
  89. <param name=image5 value="face3.jpg">
  90. <param name=image6 value="face3.jpg">
  91. <param name=link1 value="http://www.yahoo.com">
  92. <param name=link2 value="http://www.yahoo.com">
  93. <param name=link3 value="http://www.altavista.digital.com">
  94. <param name=link4 value="http://www.altavista.digital.com">
  95. <param name=link5 value="http://www.anfiteatro.it/java.html">
  96. <param name=link6 value="http://www.anfiteatro.it/java.html">
  97. <param name=statusmsg1 value="site 1">
  98. <param name=statusmsg2 value="site 1">
  99. <param name=statusmsg3 value="site 2">
  100. <param name=statusmsg4 value="site 2">
  101. <param name=statusmsg5 value="site 3">
  102. <param name=statusmsg6 value="site 3">
  103. <param name=rotx value="4">
  104. <param name=roty value="6">
  105. <param name=rotz value="8">
  106. <param name=backimage value="NO">
  107. <param name=backr value="64">
  108. <param name=backg value="96">
  109. <param name=backb value="160">
  110. <param name=clearback value="YES">
  111. <param name=textscroll value="cbmescr.txt">
  112. <param name=textoffset value="180">
  113. <param name=textspeed value="1">
  114. <param name=textfont value="Arial">
  115. <param name=textbold value="NO">
  116. <param name=textsize value="24">
  117. <param name=textshadow value="YES">
  118. <param name=TextColR value="255">
  119. <param name=TextColG value="235">
  120. <param name=TextColB value="100">
  121. <param name=TextSColR value="20">
  122. <param name=TextSColG value="20">
  123. <param name=TextSColB value="50">
  124. <param name=TextJumpAmp value="0">
  125. <param name=TextJumpSpd value="0">
  126. <param name=TextSineAmp value="0">
  127. <param name=TextSineSpd value="0">
  128. <param name=TextSineAngle value="0">
  129. <param name=memdelay value="1000">
  130. <param name=priorityL value="3">
  131. <param name=priority value="3">
  132. <param name=MinSYNC value="10">
  133. Sorry, your browser doesn't suppor Java.
  134. </applet>
  135.  
  136.  
  137.                              ---------
  138.  
  139.  
  140. Here detailed instructions about how to change parameters:
  141.  
  142. The credits parameter can't be changed otherwise the applet will not work.
  143.  
  144. To activate the reg parameters read the shareware registration notes.
  145. In the "regcode" parameter you have to place the registration code you
  146. purchase from the author. If it is correct and the applet is run from the
  147. registered domain name, you can use "link" parameters, where you can specify
  148. an URL where bring user when the applet is clicked.
  149. If you set to "YES" regnewframe, you can specify a frame where load the
  150. reglink:
  151.  
  152. "_blank"  : To load the link in a new blank unnamed browser window.
  153. "_self"   : To load the link into the same window the applet occupies.
  154. "_parent" : To load the link into the immediate FRAMESET parent.
  155. "_top"    : To load the link into the top body of the window.
  156.  
  157. Otherwise the frame name, for example "myframe1".
  158.  
  159. This applet CAN'T WORK AS MENU without a registration code.
  160.  
  161. You can load up to 6 different images to map on the faces of cube.
  162. If you place same image name on all 6 image parameters, all faces will
  163. display same image, otherwise you can display 2, 3, 4, 5, 6 different
  164. images. The best choices are 3 and 6, because with 3 different images
  165. palced in the same order of the example below, you will see no duplicate
  166. images in same frame, but you have to load 3 only images.
  167. If you want to fill all the faces with a different image, you can do it,
  168. but consider loading time will increase.
  169. The GIF/JPG images MUST be all 256*256 pixels large, otherwise ALL 128*128.
  170. No other sizes are allowed, and notice you can't mix 128*128 images with
  171. 256*256 images in same cube applet. Or ALL 128*128 or ALL 256*256.
  172. Using 256*256 images is useful only when applet size is greater than 150.
  173. You can mix GIF and JPG formats in same cube; what you can't mix is image
  174. size.
  175.  
  176. Res is a sort of zoomer. Res=1 mean normal size, res=2 mean double etc.,
  177. just remember to multiply "width" and "height" tags for "res", if it is
  178. higher than 1. Otherwise maintain same width&height and you will have less
  179. resolution (greater pixels), but remember to change distance too.
  180.  
  181. With the "rotx", "roty" and "rotz" parameters you can control the rotation
  182. speed of the cube.
  183.  
  184. With "backr", "backg" and "backb" parameters you can control the RED, GREEN
  185. and BLUE components of the background color.
  186.  
  187. You can load optionally a background image, placing it's name on the
  188. "backimage" parameter. This image must be same size as the aplet if res=1,
  189. otherwise is res=2, must be half size of the applet, and so on.
  190.  
  191. You can disable the background clear routine setting "NO" to "clearback"
  192. parameter, if you like.
  193.  
  194.  
  195.                              ---------
  196.  
  197.  
  198. Optional Scrolltext parameters:
  199.  
  200.  
  201. You can optionally activate a scrolltext that will scroll over the applet.
  202. If you don't need the scrolltext, deactivate it placing "NO" at the
  203. "textscroll" parameter.
  204. Otherwise you must supply the name of an ASCII text file, where you must
  205. write the text that you want to be scrolled.
  206. Is supported one only line of text, that can be long as you want.
  207. Remember to upload the text file too, if you activate the scrolltext!
  208.  
  209. If activated, here are the parameters:
  210.  
  211. With "textoffset" you choose the Y offset from the top: placing it to 0 the
  212. scroll will be placed on the top, for example, and placing a value near the
  213. height of the applet it will scroll at the bottom.
  214.  
  215. With "textspeed" parameter you decide the scrolling speed.
  216.  
  217. With "textfont" you choose the font of text. Don't choose a strange or not
  218. standard font, not present in all systems.
  219. The most common fonts are "Arial", "TimesRoman" and "Courier".
  220. If the required font is not present, the most "near" will be used.
  221.  
  222. Setting "textbold" to "YES" you will enlarge a bit the font, otherwise set
  223. it to "NO" for normal contours.
  224.  
  225. With "textsize" you can change the size of text font.
  226. The most common sizes are: 8,9,10,11,12,14,16,18,20,22,24,26,28,36,48,72.
  227. Intermediate values will be scaled to nearest available size.
  228.  
  229. Setting "textshadow" to "YES", a shadow will be added to textscroll.
  230. Otherwise, setting it to "NO", any shadow will be "projected".
  231.  
  232. You can choose the color of text with:
  233.  
  234. TextColR = Red component of color (0-255)
  235. TextColG = Green component of color (0-255)
  236. TextColB = Blue component of color (0-255)
  237.  
  238. For example, 0,0,0 is black, 255,255,255 is white, 255,0,0 is red,
  239. 255,255,0 is yellow, 128,128,128 is grey.
  240. You can compose any color you want, do it trying manually or use any paint
  241. program's color selector to find Red Green Blue components of your desired
  242. colors.
  243.  
  244. With TextSColR,TextSColG,TextSColB you can select the color for text shadow.
  245.  
  246. If you like, you can activate the text jumping function.
  247. If "TextJumpAmp" is set to "0", any jumping will be shown.
  248. But increasing the value will result in text jumping: more aplitute, more
  249. high jumps.
  250.  
  251. With "TextJumpSpd" parameter you can select the jumping speed.
  252.  
  253. If you like, you can also activate the sine scroll function.
  254. If "TextSineAmp" is set to 0, no sine distortion will be generated.
  255. But increasing the value will result in the that the text is waving. The
  256. higher amplitude, the more waving.
  257.  
  258. With the "TextSineSpd" parameter you can select the speed of the wave.
  259.  
  260. With the "TextSineAngle" parameter you control how many degrees in a sinewave
  261. shape the text will be deformed for each pixel. A higher value gives more
  262. distortion.
  263.  
  264.  
  265.                              ---------
  266.  
  267.  
  268. Compatibility parameters:
  269.  
  270.  
  271. The "memdelay" parameter is useful only to run the applets without problems
  272. on some bugged versions of Netscape 3, that don't deallocate correctly
  273. the memory allocated, resulting in filling all the memory after a minute
  274. the applet is running. This can cause also a system crash in some cases.
  275. Last versions of browsers have fixed this problem, but if you want to run
  276. the applets on old bugged browsers too, set "memdelay" to low values, like
  277. "10" or "16", for example.
  278. But this will slow down a lot the applet speed, so you have to choose
  279. between speed (memdelay set to 1000 or higher) or slow compatibility with
  280. old browsers (memdelay set to 20 or lower).
  281.  
  282. The "priority" parameter is useful mainly when you are running more than
  283. one applet in same page, and one slows down or hangs.
  284. If this applet run too slow or hangs because other one steal all the CPU
  285. power, try increasing the priority.
  286. Otherwise, if this applet runs well and others slows down, decrease the
  287. priority. Consider the min priority is 1, normal priority is 5, and the
  288. max priority is 10. Usually a priority of 3 is ok for single applets.
  289.  
  290. The "priorityL" parameter is the priority when loading images.
  291.  
  292. The "MinSYNC" parameter must be set to a value between 8 and 16 to slow
  293. down animation in the case it runs too faster on faster computers or because
  294. the applet size is very small. The optimal value seems to be 10, but you can
  295. disable this feature placing a value of 0 if you see flickerings or excessive
  296. slow down.
  297. If the applets steal 100% of CPU power or slows down the browser and Operating
  298. System, try increasing MinSYNC until all runs ok.
  299. Usually values between 40 and 400 fixes all problems, even if applet slows
  300. down for compatibility.
  301.  
  302.                              ---------
  303.  
  304.  
  305. Copyright and distribution notices
  306.  
  307.  
  308. Fabio Ciucci is the author and owner of this applet.
  309. You can use freely this applet to enhance your web pages. But since I am
  310. the author of the applet, I placed a secret linkware window that will appear
  311. if the applet is clicked with mouse, only when the applet is online on a site:
  312. it is external to the web browser, so it will not hit the design of your
  313. beautyful html page.
  314. This small window will simply show my name and ask for a link to my java
  315. applets page.. the user can connect to it or cancel, or hide the window and
  316. connect after visiting all your pages.
  317. I hope this credit part is not a problem for you...
  318. In any case, if link is accepted a new browser window will appear and your
  319. page will remain on the original window, so you will not lost the visitor.
  320. Consider you will use an effect programmed by me, without pay, for FREE!
  321.  
  322. NOTE: You can include the applets archive on CD-ROMS or shareware collections
  323. and shareware sites without ask me, but only if you leave the archive(s)
  324. unchanged.
  325.  
  326.                              ---------
  327.  
  328.  
  329. Fabio Ciucci (Randy/Ram Jam)
  330.  
  331. fabioc@anfiteatro.it
  332.  
  333. http://www.anfiteatro.it/java.html
  334.  
  335.  
  336.