home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 23 / IOPROG_23.ISO / SOFT / ANJAVA.ZIP / morphmenu / morphmenu.txt < prev    next >
Encoding:
Text File  |  1998-11-29  |  12.5 KB  |  294 lines
  1.  
  2.           Morph Menu - Copyright (C) by Fabio Ciucci 1998
  3.  
  4.  
  5. This applet is a navigational menu: it can display up to 20 submenu's, with
  6. max 20 items each menu, but consider even the limit of the phisical space
  7. where display the items.
  8. The link feature works only when you are registered by paying for the shareware.
  9. This applet contains code by Dolf van der Schaar & Andrea Fasce who is used under
  10. license.
  11.  
  12. The following 5 ".class" files must be uploaded: morphmenu.class, Lware.class,
  13. morphmenub.class, morphmenuc.class and anfy.class. If you use one background
  14. effect, you have to copy it's class file too, for example mmgalaxy.class.
  15.  
  16. Insert the <applet> tag in your html document as follows to add this applet
  17. to your page (Comments after the ";" symbol are code explanations and
  18. acceptable min/max values. They are not part of the applet language):
  19.  
  20.  
  21. <applet code="morphmenu.class" width=160 height=210> ; Name, Width, Height
  22. <param name=credits value="Applet by Anfy Team (www.anfyjava.com)">
  23. <param name=regcode value="NO">         ; Registration code (if you have it)
  24. <param name=regnewframe value="YES">    ; Reglink opened in new frame?
  25. <param name=regframename value="_blank"> ; Name of new frame for reglink
  26. <param name=menu_fx value="none">       ; Optional fx ("none" or "random")
  27. <param name=menu_y value="10">          ; Y offset from top where menu starts
  28. <param name=statusbar_y value="200">    ; Optional link-statusbar y position
  29. <param name=fontName value="Heivetica"> ; Font used to paint characters
  30. <param name=font_h value="25">          ; Font size
  31. <param name=textalign value="center">   ; Alignment ("left","center","right")
  32. <param name=textcolor value="ffffff">     ; Color or unselected text
  33. <param name=selectedcolor value="00ff00"> ; Color of selected text
  34. <param name=backcolor value="000000">     ; Background color
  35. <param name=back_fx value="mmgalaxy">     ; B. Fx ("color","image","...other")
  36.  
  37. ; If back_fx = "image":
  38.  
  39. <param name=back_image value="back.jpg">  ; Background image
  40.  
  41. ; If back_fx = "mmgalaxy":
  42.  
  43. <param name=mmgalaxy_fx value="rings">    ; Galaxy shape ("ring" or "vortex)
  44. <param name=mmgalaxy_scol value="7e7e7e"> ; Random seed for effect generation
  45. <param name=mmgalaxy_clr value="fire">   ; Back fx ("none","blur","fire")
  46. <param name=mmgalaxy_r value="1">        ; Fire fade red color (0..255)
  47. <param name=mmgalaxy_g value="4">        ; Fire fade green color (0..255)
  48. <param name=mmgalaxy_b value="2">        ; Fire fade blue color (0..255)
  49. <param name=mmgalaxy_filter value="yes"> ; Smooth filter ("yes" or "no")
  50. <param name=mmgalaxy_bcol value="no">    ; Back color visible ("yes" or "no")
  51.  
  52. ; If back_fx = "mmblobs":
  53.  
  54. <param name=mmblobs_nblobs value="8">     ; number of blobs (2-8)
  55. <param name=mmblobs_minspeed value="15">  ; minimum speed (1-15)
  56. <param name=mmblobs_bval1 value="1080">   ; Blob val 1
  57. <param name=mmblobs_bval2 value="34000">  ; Blob val 2
  58. <param name=mmblobs_bval3 value="3600">   ; Blob val 3
  59. <param name=mmblobs_numpal value="6">     ; Color palette (1-6)
  60. <param name=mmblobs_sinemode value="NO">   ; Sinus movements ("YES" or "NO")
  61. <param name=mmblobs_starshape value="YES"> ; Star shape ("YES" or "NO")
  62. <param name=mmblobs_negative value="NO">   ; Negative colors ("YES" or "NO")
  63.  
  64. ; Menu structure example
  65.  
  66. <param name=MenuText00 value="SUB ONE">   ; Text menu 0 item 0
  67. <param name=MenuLink00 value="1">         ; Menu Link menu 0 item 0: submenu 1
  68.  
  69. <param name=MenuText01 value="HELLO">     ; Text menu 0 item 1
  70.                                           ; No links for menu 0 item 1
  71.                                           ; No Target for Url link menu 0 i. 1
  72.  
  73. <param name=MenuText02 value="LINK ONE">  ; Text menu 0 item 2
  74. <param name=MenuUrl02 value="test1.html"> ; Url Link menu 0 item 2
  75.                                           ; No Target for Url link menu 0 i. 2
  76.  
  77. <param name=MenuText03 value="LINK TWO">  ; Text menu 0 item 3
  78. <param name=MenuUrl03 value="test2.html"> ; Url link menu 0 item 3
  79. <param name=MenuTarget03 value="mypage">  ; Target for url link menu 0 item 3
  80.  
  81. <param name=MenuText10 value="<---">      ; Text menu 1 item 0 (back arrow)
  82. <param name=MenuLink10 value="0">         ; Menu link menu 1 item 0: go back
  83.  
  84. <param name=MenuText12 value="ITEM ONE">  ; Text menu 1 item 2
  85. <param name=MenuUrl12 value="test1.html"> ; Url link menu 1 item 2
  86.                                           ; No Target for Url link menu 1 i. 2
  87.  
  88. <param name=overimg value="NO">          ; Optional image over applet
  89. <param name=overimgX value="0">          ; Over image X offset
  90. <param name=overimgY value="0">          ; Over image Y offset
  91. <param name=memdelay value="1000">       ; Memory deallocation delay
  92. <param name=priority value="3">          ; Task priority (1..10)
  93. <param name=MinSYNC value="10">          ; Min. milliseconds/frame for sync
  94. Sorry, your browser doesn't support Java.; Message for no java browsers.
  95. </applet>                                ; End of applet tag
  96.  
  97.                              ---------
  98.  
  99.  
  100. The following instructions detail how to change parameters:
  101.  
  102. Attempting to change the credits parameter will disable the applet.
  103.  
  104. To activate the reg parameters read the shareware registration notes.
  105. In the "regcode" parameter, place the registration code you
  106. purchased from the author. If the code is correct and the applet is run from
  107. the registered domain name, you can use "link" parameters to link to a URL
  108. when the applet is "clicked".
  109.  
  110. If you set "regnewframe" to "YES", you can specify a specific frame location
  111. for the menu links:
  112.  
  113. "_blank"  : To load the link in a new blank unnamed browser window.
  114. "_self"   : To load the link into the same window the applet occupies.
  115. "_parent" : To load the link into the immediate FRAMESET parent.
  116. "_top"    : To load the link into the top body of the window.
  117.  
  118. You can also set a custom frame name, such as "myframe1".
  119.  
  120. Note: you can specify specific target for specific menu items, using the
  121. parameters MenuTargetXX. If no MenuTargetXX is specified, regnewframe is
  122. used.
  123.  
  124. With "statusbar_y" you can decide the postion of the text link statusbar.
  125. If you place here a value bigger than the height of the applet, the
  126. text will be not displayed.
  127. This line will be printed with the color specified into textcolor
  128.  
  129. With the "menu_fx" parameter, you can enable a random flickering of the
  130. text, specifying "random" in it. Otherwise, specify "none".
  131.  
  132. You can decide the y offset from top where start to draw the menu items
  133. with the "menu_y" parameter.
  134.  
  135. You can control the style and size of the font using the "fontName" and
  136. "font_h" parameters, respectively.
  137. The usable fonts are "Courier", "Dialog", "Helvetica" and "TimesRoman".
  138.  
  139. The text alignment can be controlled with "textalign" parameter, who can
  140. be "left","center","right" justified.
  141.  
  142. The color of selected and unselected text is determined by the "textcolor"
  143. and "selectedcolor" parameters, and s in RRGGBB hex format, same as the
  144. html color format, without the leading #.
  145.  
  146. With "back_fx" you choose what kind of background have.
  147. If you choose "color", a filled color determined by backcolor will be used.
  148. If you choose "image", a gif/jpg image, specified in "back_image", will be
  149. used.
  150. Otherwise, you can specify one of the background effects plugins available,
  151. and in this case you have to copy the .class too.
  152.  
  153.  
  154. ; If back_fx = "mmgalaxy", here the extra parameters:
  155.  
  156. mmgalaxy_fx:     Galaxy shape ("ring" or "vortex)
  157. mmgalaxy_scol:   Random seed color for effect generation
  158. mmgalaxy_clr:    Backround burning ("none","blur","fire")
  159. mmgalaxy_r:      Fire fade red color (0..255)
  160. mmgalaxy_g:      Fire fade green color (0..255)
  161. mmgalaxy_b:      Fire fade blue color (0..255)
  162. mmgalaxy_filter: Smooth filter ("yes" or "no")
  163. mmgalaxy_bcol:   Background color visible ("yes" or "no")
  164.  
  165. Remember to upload to site mmgalaxy.class.
  166.  
  167.  
  168. ; If back_fx = "mmblobs", here the extra parameters:
  169.  
  170. mmblobs_nblobs:    number of blobs (2-8)
  171. mmblobs_minspeed:  minimum speed (1-15)
  172. mmblobs_bval1:     Blob val 1
  173. mmblobs_bval2:     Blob val 2
  174. mmblobs_bval3:     Blob val 3
  175. mmblobs_numpal:    Color palette (1-6)
  176. mmblobs_sinemode:  Sinus movements ("YES" or "NO")
  177. mmblobs_starshape: Star shape ("YES" or "NO")
  178. mmblobs_negative:  Negative colors ("YES" or "NO")
  179.  
  180. Remember to upload to site mmblobs.class and mmblob.class.
  181.  
  182.  
  183. Menu System:
  184.  
  185. This menu applet can display up to 20 submenu's, with any number of items
  186. each menu, the only limit is the phisical space where display the items.
  187. Each item is defined with a menu identifier + an item identifier.
  188. For example, 00 means menu 0, item 0; 10 means menu 1, item 0; 22 means
  189. menu 2, item 2, and so on.
  190. If you need more than 10 menus or items, use character instead of numbers,
  191. for example:
  192.  
  193. <param name=MenuText0a    value="ITEM10">
  194. <param name=MenuText0b    value="ITEM10">
  195.  
  196. The numeration starts from 0, so the max menu is letter j.
  197. Please note that you are limited to 20 menus and 20 items per menu (so
  198. item/menu identifies can be in the range 0..9/a..j)
  199.  
  200. Each item should have a Text label:
  201.  
  202. <param name=MenuText00 value="SUB ONE">   ; Text menu 0 item 0
  203.  
  204. The text can contain numbers or special characters, too.
  205.  
  206. Note: If you use "<---" as the name of a menu item, it will be drawn as a
  207. back arrow, useful for back menu items.
  208.  
  209. Each menu item can have (or not have) a link.
  210. The link can be of 2 types: MenuLinkXX or MenuUrlXX:
  211.  
  212. <param name=MenuLink00 value="1">        ; Menu Link menu 0 item 0: submenu 1
  213. <param name=MenuLink10 value="0">        ; Menu link menu 1 item 0: go back
  214.  
  215. When it's a MenuLink, it indicates to go to next sub menu, or to go back
  216. to previous menu.
  217. To specify the submenu, you simply specify: 0,1,2,3,4,5,6... and you can go
  218. more than one step deeper, if you want: when you are on menu 2, you can go to
  219. submenu 3, or even to submenu 4 or 5, etc.
  220. To go back to previous menu, just specify the number of menu from where you
  221. was linked to the actual one.
  222.  
  223. NOTE: you are obliged to specify a "BACK" item, otherwise users can't go back
  224. in other ways.
  225.  
  226. When it's a MenuUrl, you should specify a http:// or relative link to a file:
  227.  
  228. <param name=MenuUrl02 value="test1.html"> ; Url Link menu 0 item 2
  229.  
  230. And, optionally, you can specify a target frame:
  231.  
  232. <param name=MenuTarget02 value="mypage">  ; Target for url link menu 0 item 3
  233.  
  234. If no target frame is specified, the "regframename" will be used.
  235.  
  236. Let's see a complex example, with more than one sub-menu each screen:
  237.  
  238.     (0)
  239.      |
  240.      |_ (1) Image Gallery            (MenuText00) Link: 1
  241.      |       |_ <--                  (MenuText10) Link: 0
  242.      |       |_ (2) GIF Images       (MenuText11) Link: 2
  243.      |       |       |_ <--          (MenuText20) Link: 1
  244.      |       |       |_ Flower.gif   (MenuText21) Url
  245.      |       |       |_ Portrait.gif (MenuText22) Url
  246.      |       |
  247.      |       |_ (3) JPG Images       (MenuText12) Link: 3
  248.      |               |_ <--          (MenuText30) Link: 1
  249.      |               |_ Flower.jpg   (MenuText31) Url
  250.      |               |_ Portrait.jpg (MenuText32) Url
  251.      |
  252.      |_ (4) Audio Files              (MenuText01) Link: 4
  253.      |       |_ <--                  (MenuText40) Link: 0
  254.      |       |_ Dance.wav            (MenuText41) Url
  255.      |       |_ Classic.wav          (MenuText42) Url
  256.      |
  257.      |_ E-Mail                       (MenuText02) Url
  258.  
  259.  
  260. Here how to build it:
  261.  
  262. <param name=MenuText00 value="Image Gallery">
  263. <param name=MenuLink00 value="1">
  264. <param name=MenuText01 value="Audio Files">
  265. <param name=MenuLink01 value="4">
  266. <param name=MenuText02 value="E-Mail">
  267. <param name=MenuUrl02 value="mailto:test@test.com">
  268. <param name=MenuText10 value="<---">
  269. <param name=MenuLink10 value="0">
  270. <param name=MenuText11 value="GIF Images">
  271. <param name=MenuLink11 value="2">
  272. <param name=MenuText12 value="JPG Images">
  273. <param name=MenuLink12 value="3">
  274. <param name=MenuText20 value="<---">
  275. <param name=MenuLink20 value="1">
  276. <param name=MenuText21 value="Flower.gif">
  277. <param name=MenuUrl21 value="test1.html">
  278. <param name=MenuText22 value="Portrait.gif">
  279. <param name=MenuUrl22 value="test2.html">
  280. <param name=MenuText30 value="<---">
  281. <param name=MenuLink30 value="1">
  282. <param name=MenuText31 value="Flower.jpg">
  283. <param name=MenuUrl31 value="test3.html">
  284. <param name=MenuText32 value="Portrait.jpg">
  285. <param name=MenuUrl32 value="test5.html">
  286. <param name=MenuText40 value="<---">
  287. <param name=MenuLink40 value="0">
  288. <param name=MenuText41 value="Dance.wav">
  289. <param name=MenuUrl41 value="test6.html">
  290. <param name=MenuText42 value="Classic.wav">
  291. <param name=MenuUrl42 value="test7.html">
  292.  
  293.  
  294.