home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / solidscr / solidscr.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  7.9 KB  |  217 lines  |  [TEXT/ttxt]
  1.  
  2.           Solid Scroller - Copyright (C) by Fabio Ciucci 1999
  3.  
  4.  
  5. This applet displays a scrolling text, using colourful fonts.
  6. The text can jump, and wave, and you may even be able to add a mirror 
  7. effect on bottom area.
  8.  
  9. This effect contains the code by Eric Benhamou, used under a licence.
  10.  
  11. The coloured fonts are in AFT (AnFy FonT) format.
  12.  
  13. You can create your own aft fonts using a paint program, otherwise
  14. download freely the AFT fonts collection from here:
  15.  
  16.   http://www.anfyteam.com/aft/
  17.  
  18. ***********************************************************************
  19.  
  20. NECESSARY FILES.
  21.  
  22. As well as your selection font file (.aft) and its data gif image, the 
  23. following 2 ".class" files must be uploaded: 
  24.  
  25. solidscr.class
  26. Lware.class
  27.  
  28. Plus, solidscr.jar for speedy loading on recent browsers.
  29.  
  30. ***********************************************************************
  31.  
  32. EXAMPLE.
  33.  
  34. Insert the <applet> tag in your html document as follows to add this applet
  35. to your page (Comments after the ";" symbol are code explanations and
  36. acceptable min/max values. They are not part of the applet language):
  37.  
  38. <applet archive="solidscr.jar" code="solidscr.class" width="460" height="80">
  39. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  40. <param name="regcode" value="NO">          ; Registration code (if you have it)
  41. <param name="reglink" value="NO">          ; Optional URL link when the applet
  42.                                            is "clicked".
  43. <param name="regnewframe" value="YES">          ; Reglink opened in new frame?
  44. <param name="regframename" value="_blank">      ; Name of new frame for reglink
  45. <param name="statusmsg" value="Solid Scroller"> ; Statusbar message
  46. <param name="textscroll" value="solidscr1.txt">   ; Ascii file with text
  47. <param name="texttype" value="waving">   ; Text effect mode
  48.                                        ; (waving,jumping,horizontal, vertical)
  49. <param name="speed" value="2">           ; Scrolling speed
  50. <param name="wavemode" value="vertical"> ; waving mode (horizontal, vertical)
  51. <param name="wavetype" value="swing">    ; Wave type
  52.                                        ; (swing, short, long, classic, smooth, halfsmooth)
  53. <param name="wavespeed" value="4">       ; Wave speed
  54. <param name="reversefx" value="yes">     ; Reverse wave fx (yes,no)
  55. <param name="TextJumpAmp" value="0">     ; Jumping Amplitude
  56. <param name="TextJumpSpd" value="0">     ; Jumping Speed
  57. <param name="textoffset" value="0">      ; Y Text offset in horizontal mode
  58. <param name="textvspace" value="10">     ; Text Vertical Spacing
  59. <param name="mirrormode" value="normal"> ; Mirror (disabled,normal,perspective)
  60. <param name="mirrorheight" value="20">   ; Mirror height from the bottom.
  61. <param name="fontindex" value="bar2font.aft">  ; Anfy Font file to load
  62. <param name="bgcolor" value="000133">    ; Background colour in hex format
  63. <param name="overimg" value="NO">          ; Optional image over applet
  64. <param name="overimgX" value="0">          ; Over image X offset
  65. <param name="overimgY" value="0">          ; Over image Y offset
  66. <param name="memdelay" value="1000">       ; Memory deallocation delay
  67. <param name="priority" value="3">          ; Task priority (1..10)
  68. <param name="MinSYNC" value="10">          ; Min. milliseconds/frame for sync
  69. Sorry, your browser doesn't support Java.; Message for no java browsers.
  70. </applet>                                ; End of applet tag
  71.  
  72.  
  73. *************************************************************************
  74.  
  75. INSTRUCTIONS.
  76.  
  77. The following instructions describe how to change parameters:
  78.  
  79. Attempting to change the credits parameter will disable the applet.
  80.  
  81. To activate the reg parameters, please read the shareware registration notes.
  82. In the "regcode" parameter, place the registration code you purchased from
  83. the author. If the code is correct and the applet is run from the registered
  84. domain name, you can use "link" parameters to link to a URL when the applet 
  85. is "clicked".
  86.  
  87. If you set "regnewframe" to "YES", you can specify a specific frame location
  88. for the reglink:
  89.  
  90. "_blank"  : To load the link in a new blank unnamed browser window.
  91. "_self"   : To load the link into the same window the applet occupies.
  92. "_parent" : To load the link into the immediate FRAMESET parent.
  93. "_top"    : To load the link into the top body of the window.
  94.  
  95. You can also set a custom frame name, such as "myframe1".
  96.  
  97. With the "overimg" parameter you can specify the name of an image that will
  98. be painted over the applet. The best options are transparent GIF images.
  99.  
  100. NOTE: Animated GIF images are supported, but will be animated only on latest
  101. browsers (Netscape 4 and Explorer 4 or newer).
  102.  
  103. With "overimgX" and "overimgY" you can center the image over the applet area.
  104.  
  105. The size of the applet is determined by width and height tags.
  106.  
  107. The "textscroll" parameter specifies an ascii text file which will be displayed.
  108.  
  109. Note: only characters present in the AFT font will be displayed.
  110.  
  111. If the AFT font does not contain numbers, or special characters, those will 
  112. be simply ignored.
  113.  
  114. With "texttype", you can specify the text effect mode:
  115.  
  116. horizontal : One line of text will scroll horizontally
  117. vertical   : Multiple lines of text will scroll vertically
  118. waving     : One line of text will scroll waving
  119. jumping    : One line of text will scroll jumping
  120.  
  121. With "speed" you specify the scrolling speed.
  122.  
  123.  
  124. If texttype=waving, you can set "wavemode" to "horizontal" or "vertical",
  125. and "wavetype" to one of the following:
  126.  
  127. swing      : long regular sinus 
  128. short      : much irregular sinus
  129. long       : a bit irregular sinus
  130. classic    : short regular sinus
  131. smooth     : fast irregular sinus
  132. halfsmooth : very fast irregular sinus
  133.  
  134. The waving speed is determined by "wavespeed". 0 = frozen wave.
  135.  
  136. The waving effect can be reversed, placing "yes" to the "reversefx" parameter.
  137.  
  138.  
  139. If texttype=jumping, you can set "TextJumpAmp" to control the jumping amplitude,
  140. and "TextJumpSpd" to control the Jumping speed.
  141.  
  142. If texttype=horizontal, you can set the Y Text offset with "textoffset".
  143.  
  144. If texttype=vertical, you can set Vertical Spacing with "textvspace".
  145.  
  146. With "mirrormode" you determine the mirror status. With "disabled" the
  147. mirror is disabled, with "normal" it is reflecting line by line, with
  148. "perspective" it reflects in a perspective-like way.
  149.  
  150. The mirror starts from bottom, up to the height you want, entering the
  151. desired one in the "mirrorheight" parameter.
  152.  
  153. The background colour is determined by the "bgcolor" parameter, entering
  154. the value in hex RRGGBB, like html format, but without the prefix "#".
  155.  
  156. The .aft font file must be specified in the "fontindex" parameter.
  157.  
  158. ***********************************************************************
  159.  
  160. THE AFT FORMAT SPECIFICATIONS
  161.  
  162. If you are interested in creating new fonts for your personal use, or
  163. to add those to the freely usable AFT fonts collection, you should
  164. know how the AFT format works.
  165.  
  166. An AFT font comprises 2 files, with a single prefix + different suffixes,
  167. for example:
  168.  
  169. myfont.aft
  170. myfont.gif
  171.  
  172. The .aft file is an ascii text file, editable by hand, and the gif file
  173. is an image file editable with any paint program.
  174.  
  175. Both files must have the same prefex, and the suffixes should be in 
  176. lowercase.
  177.  
  178. Here an example of .aft:
  179.  
  180.  
  181. myfont
  182. 32
  183. 23
  184. 0
  185.  !#%%%%'()%%,-./0123456789:;%=%?@ABCDEFGHIJKLMNOPQRSTUVWXYZ%
  186. This is a comment... hello...
  187.  
  188.  
  189. The 1st line contains the name of the gif file, without .gif suffix.
  190. The 2nd line contains the font width.
  191. The 3rd line contains the font height.
  192. The 4th line contains the Y spacing between characters.
  193. The 5th line contains the characters index (its order in GIF image)
  194.  
  195. For example, if a font is painted as:
  196.  
  197. ABCDE
  198. FGHIJ
  199. KLMNO
  200.  
  201. The fontindex will be: ABCDEFGHIJKLMNO
  202.  
  203. But, if a font is painted as:
  204.  
  205. AEIMQUY
  206. BFJNRVZ
  207. CGKOSW!
  208. DHLPTX#
  209.  
  210. The fontindex will be: AEIMQUYBFJNRVZCGKOSW!DHLPTX#
  211.  
  212. Note: the background of the gif image must be black (000000 in hex), and the
  213. black must be present only in the background, otherwise the background
  214. colour changes a function in the scroller applet and this will cause problems.
  215.  
  216.  
  217.