home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / morphmenu / morphmenu.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  14.5 KB  |  368 lines  |  [TEXT/ttxt]
  1.  
  2.           Morph Menu - Copyright (C) by Fabio Ciucci 1998/99
  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 the items are displayed.
  8.  
  9. The link feature works only when you are registered by paying for the shareware.
  10. This applet contains code by Dolf van der Schaar & Andrea Fasce which is used 
  11. under a licence.
  12.  
  13. **************************************************************************
  14.  
  15. NECESSARY FILES.
  16.  
  17. Apart from the background image and an optional overlay image, the 
  18. following 5 ".class" files must be uploaded: 
  19.  
  20. morphmenu.class
  21. morphmenub.class
  22. morphmenuc.class
  23. Lware.class
  24. anfy.class 
  25.  
  26. If you use a background animation effect, you have to add the respective 
  27. class file too:
  28.  
  29. mmgalaxy.class or mmblobs.class.
  30.  
  31. Plus, morphmenu.jar for speedy loading on recent browsers.
  32.  
  33. ************************************************************************
  34.  
  35. EXAMPLE.
  36.  
  37. Insert the <applet> tag in your html document as follows to add this applet
  38. to your page (Comments after the ";" symbol are code explanations and
  39. acceptable min/max values. They are not part of the applet language):
  40.  
  41.  
  42. <applet archive="morphmenu.jar" code="morphmenu.class" width="160" height="140">
  43. <param name="credits" value="Applet by Anfy Team (www.anfyteam.com)">
  44. <param name="regcode" value="NO">         ; Registration code (if you have it)
  45. <param name="regnewframe" value="YES">    ; Reglink opened in new frame?
  46. <param name="regframename" value="_blank"> ; Name of new frame for reglink
  47. <param name="menu_fx" value="none">       ; Optional fx ("none" or "random")
  48. <param name="menu_y" value="10">          ; Y offset from top where menu starts
  49. <param name="statusbar_y" value="200">    ; Optional link-statusbar y position
  50. <param name="fontName" value="Heivetica"> ; Font used to paint characters
  51. <param name="font_h" value="25">          ; Font size
  52. <param name="textalign" value="center">   ; Alignment ("left","center","right")
  53. <param name="textcolor" value="ffffff">     ; Colour or unselected text
  54. <param name="selectedcolor" value="00ff00"> ; Colour of selected text
  55. <param name="backcolor" value="000000">     ; Background colour
  56. <param name="back_fx" value="mmgalaxy">     ; B. Fx ("color","image","...other")
  57. <param name="floatmode" value="NO">       ; Float mode ("YES" or "NO")
  58. <param name="floatw" value="200">         ; Float window width
  59. <param name="floath" value="280">         ; Float window height
  60. <param name="floatx" value="100">         ; Float window x position start
  61. <param name="floaty" value="100">         ; Float window y position start
  62. <param name="floatitle" value="Morph Menu"> ; Float window title
  63. <param name="floatinfront" value="NO">    ; Float win. always on top (YES,NO)
  64.  
  65. ; If back_fx = "image":
  66.  
  67. <param name="back_image" value="back.jpg">  ; Background image
  68.  
  69. ; If back_fx = "mmgalaxy":
  70.  
  71. <param name="mmgalaxy_fx" value="rings">    ; Galaxy shape ("ring" or "vortex)
  72. <param name="mmgalaxy_scol" value="7e7e7e"> ; Random seed for effect generation
  73. <param name="mmgalaxy_clr" value="fire">   ; Back fx ("none","blur","fire")
  74. <param name="mmgalaxy_r" value="1">        ; Fire fade red colour (0..255)
  75. <param name="mmgalaxy_g" value="4">        ; Fire fade green colour (0..255)
  76. <param name="mmgalaxy_b" value="2">        ; Fire fade blue colour (0..255)
  77. <param name="mmgalaxy_filter" value="yes"> ; Smooth filter ("yes" or "no")
  78. <param name="mmgalaxy_bcol" value="no">    ; Back colour visible ("yes" or "no")
  79.  
  80. ; If back_fx = "mmblobs":
  81.  
  82. <param name="mmblobs_nblobs" value="8">     ; number of blobs (2-8)
  83. <param name="mmblobs_minspeed" value="15">  ; minimum speed (1-15)
  84. <param name="mmblobs_bval1" value="1080">   ; Blob val 1
  85. <param name="mmblobs_bval2" value="34000">  ; Blob val 2
  86. <param name="mmblobs_bval3" value="3600">   ; Blob val 3
  87. <param name="mmblobs_numpal" value="6">     ; Colour palette (1-6)
  88. <param name="mmblobs_sinemode" value="NO">   ; Sinus movements ("YES" or "NO")
  89. <param name="mmblobs_starshape" value="YES"> ; Star shape ("YES" or "NO")
  90. <param name="mmblobs_negative" value="NO">   ; Negative colours ("YES" or "NO")
  91.  
  92. ; Menu structure example
  93.  
  94. <param name="MenuText00" value="SUB ONE"> ; Text menu 0 item 0
  95. <param name="MenuLink00" value="1">         ; Menu Link menu 0 item 0: submenu 1
  96.  
  97. <param name="MenuText01" value="HELLO">   ; Text menu 0 item 1
  98.                                           ; No links for menu 0 item 1
  99.                                           ; No Target for Url link menu 0 i. 1
  100.  
  101. <param name="MenuText02" value="LINK ONE">  ; Text menu 0 item 2
  102. <param name="MenuUrl02" value="test1.html"> ; Url Link menu 0 item 2
  103.                                           ; No Target for Url link menu 0 i. 2
  104.  
  105. <param name="MenuText03" value="LINK TWO">  ; Text menu 0 item 3
  106. <param name="MenuUrl03" value="test2.html"> ; Url link menu 0 item 3
  107. <param name="MenuTarget03" value="mypage">  ; Target for url link menu 0 item 3
  108.  
  109. <param name="MenuText10" value="<---">      ; Text menu 1 item 0 (back arrow)
  110. <param name="MenuLink10" value="0">         ; Menu link menu 1 item 0: go back
  111.  
  112. <param name="MenuText12" value="ITEM ONE">  ; Text menu 1 item 2
  113. <param name="MenuUrl12" value="test1.html"> ; Url link menu 1 item 2
  114.                                           ; No Target for Url link menu 1 i. 2
  115.  
  116. <param name="overimg" value="NO">          ; Optional image over applet
  117. <param name="overimgX" value="0">          ; Over image X offset
  118. <param name="overimgY" value="0">          ; Over image Y offset
  119. <param name="memdelay" value="1000">       ; Memory deallocation delay
  120. <param name="priority" value="3">          ; Task priority (1..10)
  121. <param name="MinSYNC" value="10">          ; Min. milliseconds/frame for sync
  122. Sorry, your browser doesn't support Java.; Message for no java browsers.
  123. </applet>                                ; End of applet tag
  124.  
  125. ***************************************************************************
  126.  
  127. INSTRUCTIONS.
  128.  
  129. The following instructions describe how to change parameters:
  130.  
  131. Attempting to change the credits parameter will disable the applet.
  132.  
  133. To activate the reg parameters read the shareware registration notes.
  134. In the "regcode" parameter, place the registration code you purchased
  135.  from the author. If the code is correct and the applet is run from
  136. the registered domain name, you can use "link" parameters to link to a URL
  137. when the applet is "clicked".
  138.  
  139. If you set "regnewframe" to "YES", you can specify a specific frame location
  140. for the menu links:
  141.  
  142. "_blank"  : To load the link in a new blank unnamed browser window.
  143. "_self"   : To load the link into the same window the applet occupies.
  144. "_parent" : To load the link into the immediate FRAMESET parent.
  145. "_top"    : To load the link into the top body of the window.
  146.  
  147. You can also set a custom frame name, such as "myframe1".
  148.  
  149. Note: you can specify specific target for specific menu items, using the
  150. parameters MenuTargetXX. If no MenuTargetXX is specified, regnewframe is
  151. used.
  152.  
  153. With "statusbar_y", you can decide the postion of the text link statusbar.
  154. If you place here a value bigger than the height of the applet, the
  155. text will be not displayed.
  156.  
  157. This line will be printed with the colour specified in the "textcolor".
  158.  
  159. With the "menu_fx" parameter, you can enable a random flickering of the
  160. text, specifying "random" in it. Otherwise, specify "none".
  161.  
  162. You can decide the y offset from top where start to draw the menu items
  163. with the "menu_y" parameter.
  164.  
  165. You can control the style and size of a font using the "fontName" and
  166. "font_h" parameters, respectively.
  167.  
  168. The usable fonts are "Courier", "Dialog", "Helvetica" and "TimesRoman".
  169.  
  170. The text alignment can be controlled with "textalign" parameter, which can
  171. be "left","center", or "right".
  172.  
  173. The colour of selected and unselected text is determined by the "textcolor"
  174. and "selectedcolor" parameters, and s in RRGGBB hex format, same as the
  175. html colour format, without the leading #.
  176.  
  177. With "back_fx", you choose a type of background effect from colour, image,
  178. galaxy animation to blobs animation.
  179.  
  180. If you choose "color", a filled colour determined by "backcolor" will be used.
  181. If you choose "image", a gif/jpg image, specified in "back_image", will be
  182. used.
  183.  
  184. Otherwise, you can specify one of the background effects plugins available,
  185. and in this case you have to copy the necessary .class too.
  186.  
  187.  
  188. ; If back_fx = "mmgalaxy", here the extra parameters:
  189.  
  190. mmgalaxy_fx:     Galaxy shape ("ring" or "vortex)
  191. mmgalaxy_scol:   Random seed color for effect generation
  192. mmgalaxy_clr:    Backround burning ("none","blur","fire")
  193. mmgalaxy_r:      Fire fade red colour (0..255)
  194. mmgalaxy_g:      Fire fade green colour (0..255)
  195. mmgalaxy_b:      Fire fade blue colour (0..255)
  196. mmgalaxy_filter: Smooth filter ("yes" or "no")
  197. mmgalaxy_bcol:   Background colour visible ("yes" or "no")
  198.  
  199. Remember to upload to site mmgalaxy.class.
  200.  
  201.  
  202. ; If back_fx = "mmblobs", here the extra parameters:
  203.  
  204. mmblobs_nblobs:    number of blobs (2-8)
  205. mmblobs_minspeed:  minimum speed (1-15)
  206. mmblobs_bval1:     Blob val 1
  207. mmblobs_bval2:     Blob val 2
  208. mmblobs_bval3:     Blob val 3
  209. mmblobs_numpal:    Colour palette (1-6)
  210. mmblobs_sinemode:  Sinus movements ("YES" or "NO")
  211. mmblobs_starshape: Star shape ("YES" or "NO")
  212. mmblobs_negative:  Negative colorus ("YES" or "NO")
  213.  
  214. Remember to upload to site mmblobs.class and mmblob.class.
  215.  
  216. *****
  217.  
  218. [The floating mode:]
  219.  
  220. Optionally, you can enable the "floating window" mode.
  221. The treemenu applet, then, will appear in a floating external window, and will
  222. leave free all the other frame space on the web site.
  223. But, you still have to create a small horizontal or vertical frame (maybe
  224. 1 or 2 pixels large), containing the applet, 1 pixel large.
  225.  
  226. To enable this mode:
  227.  
  228. 1) Set "floatmode" to "YES"
  229. 2) Copy the applet width in the "floatw" parameter
  230. 3) Copy the applet height in the "floath" parameter
  231. 4) Set the applet width=1 and height=1
  232.  
  233. At this point, you just have to customize it using those parameters:
  234.  
  235. The window title must be written in the "floatitle" parameter.
  236.  
  237. The starting X and Y position where window should apper, must be written
  238. in the "floatx" and "floaty" parameters. Note: the coordinates are relative
  239. to user screen, so result can change depending on screen resolution.
  240.  
  241. If you want the window to be always on top and visible, set the "floatinfront"
  242. parameter to "YES". This could be useful for someone, and annoying for others.
  243.  
  244. Note: the "floatinfront" option will have no effect on some versions of
  245. Internet Explorer.
  246.  
  247.  
  248. *****
  249.  
  250. [Menu System:]
  251.  
  252. This menu applet can display up to 20 submenu's, with any number of items
  253. within each menu, the only limitation is the physical space where display
  254.  the items. 
  255.  
  256. Each item is defined with a menu identifier + an item identifier.
  257.  
  258. For example, 00 means menu 0, item 0; 10 means menu 1, item 0; 22 means
  259. menu 2, item 2, and so on.
  260.  
  261. If you need more than 10 menus or items, use character instead of numbers,
  262. for example:
  263.  
  264. <param name="MenuText0a" value="ITEM10">
  265. <param name="MenuText0b" value="ITEM10">
  266.  
  267. The numeration starts from 0, so the max menu is letter j.
  268.  
  269. Please note that you are limited to 20 menus and 20 items per menu (so
  270. item/menu identifies can be in the range 0..9/a..j)
  271.  
  272. Each item should have a Text label:
  273.  
  274. <param name=MenuText00 value="SUB ONE">   ; Text menu 0 item 0
  275.  
  276. The text can contain numbers or special characters, too.
  277.  
  278. Note: If you use "<---" as the name of a menu item, it will be drawn as a
  279. back arrow, useful for back menu items.
  280.  
  281. Each menu item can have (or not have) a link.
  282. The link can be of 2 types: MenuLinkXX or MenuUrlXX:
  283.  
  284. <param name="MenuLink00" value="1">        ; Menu Link menu 0 item 0: submenu 1
  285. <param name="MenuLink10" value="0">        ; Menu link menu 1 item 0: go back
  286.  
  287. When it's a MenuLink, it indicates to go to next sub menu, or to go back
  288. to previous menu.
  289.  
  290. To specify the submenu, you simply specify: 0,1,2,3,4,5,6... and you can go
  291. more than one step deeper, if you want: when you are on menu 2, you can go to
  292. submenu 3, or even to submenu 4 or 5, etc.
  293.  
  294. To go back to previous menu, just specify the number of menu from which you
  295. were linked to the current one.
  296.  
  297. NOTE: you are obliged to specify a "BACK" item, otherwise users can't go back
  298. to the upper level.
  299.  
  300. When it's a MenuUrl, you should specify a http:// or relative link to a file:
  301.  
  302. <param name=MenuUrl02 value="test1.html"> ; Url Link menu 0 item 2
  303.  
  304. And, optionally, you can specify a target frame:
  305.  
  306. <param name="MenuTarget02" value="mypage">  ; Target for url link menu 0 item 3
  307.  
  308. If no target frame is specified, the "regframename" will be used.
  309.  
  310. Let's see a complex example, with more than one sub-menu each screen:
  311.  
  312.     (0)
  313.      |
  314.      |_ (1) Image Gallery            (MenuText00) Link: 1
  315.      |       |_ <--                  (MenuText10) Link: 0
  316.      |       |_ (2) GIF Images       (MenuText11) Link: 2
  317.      |       |       |_ <--          (MenuText20) Link: 1
  318.      |       |       |_ Flower.gif   (MenuText21) Url
  319.      |       |       |_ Portrait.gif (MenuText22) Url
  320.      |       |
  321.      |       |_ (3) JPG Images       (MenuText12) Link: 3
  322.      |               |_ <--          (MenuText30) Link: 1
  323.      |               |_ Flower.jpg   (MenuText31) Url
  324.      |               |_ Portrait.jpg (MenuText32) Url
  325.      |
  326.      |_ (4) Audio Files              (MenuText01) Link: 4
  327.      |       |_ <--                  (MenuText40) Link: 0
  328.      |       |_ Dance.wav            (MenuText41) Url
  329.      |       |_ Classic.wav          (MenuText42) Url
  330.      |
  331.      |_ E-Mail                       (MenuText02) Url
  332.  
  333.  
  334. Here how to build it:
  335.  
  336. <param name="MenuText00" value="Image Gallery">
  337. <param name="MenuLink00" value="1">
  338. <param name="MenuText01" value="Audio Files">
  339. <param name="MenuLink01" value="4">
  340. <param name="MenuText02" value="E-Mail">
  341. <param name="MenuUrl02" value="mailto:test@test.com">
  342. <param name="MenuText10" value="<---">
  343. <param name="MenuLink10" value="0">
  344. <param name="MenuText11" value="GIF Images">
  345. <param name="MenuLink11" value="2">
  346. <param name="MenuText12" value="JPG Images">
  347. <param name="MenuLink12" value="3">
  348. <param name="MenuText20" value="<---">
  349. <param name="MenuLink20" value="1">
  350. <param name="MenuText21" value="Flower.gif">
  351. <param name="MenuUrl21" value="test1.html">
  352. <param name="MenuText22" value="Portrait.gif">
  353. <param name="MenuUrl22" value="test2.html">
  354. <param name="MenuText30" value="<---">
  355. <param name="MenuLink30" value="1">
  356. <param name="MenuText31" value="Flower.jpg">
  357. <param name="MenuUrl31" value="test3.html">
  358. <param name="MenuText32" value="Portrait.jpg">
  359. <param name="MenuUrl32" value="test5.html">
  360. <param name="MenuText40" value="<---">
  361. <param name="MenuLink40" value="0">
  362. <param name="MenuText41" value="Dance.wav">
  363. <param name="MenuUrl41" value="test6.html">
  364. <param name="MenuText42" value="Classic.wav">
  365. <param name="MenuUrl42" value="test7.html">
  366.  
  367.  
  368.