home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / workbench / sexy_bench / nickprefs / nickprefs.doc < prev    next >
Text File  |  1995-02-27  |  8KB  |  190 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                                   NickPrefs
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. The files in this archive were written by Nicola Salmoria and are freely
  9. distributable as long as the archive remains intact, and only a nominal fee
  10. is charged for its distribution.
  11.  
  12. This software is provided "AS IS" without warranty of any kind, either
  13. expressed or implied. By using it, you agree to accept the entire risk as to
  14. the quality and performance of the program.
  15.  
  16. Comments, suggestions and bug reports are welcome.
  17.  
  18.    Nicola Salmoria
  19.    Via Piemonte 11
  20.    53100 Siena   ITALY
  21.  
  22.  
  23.  
  24. Overview
  25. --------
  26. NickPrefs is an enhancement of IPrefs, the preferences manager of Workbench
  27. 2.0. From these very few words, you understand that you need Kickstart 2.0
  28. to use this program ;-) It has been tested under Kickstart 2.04, that is the
  29. one burnt in the A500+' ROMs.
  30.  
  31. NickPrefs manages three new preferences, which may be modified with the three
  32. accompaning programs WBPicture, BusyPointer and Floppy.
  33. WBPicture allows you to display any IFF picture in the main Workbench window,
  34. supplanting the original (and boring ;-)) WBPattern.
  35. BusyPointer lets you edit the clock pointer used by programs when they are
  36. busy. You may create an animated pointer, see later for details.
  37. Floppy provides the ability to mess with the public fields of trackdisk, that
  38. is the TDPF_NOCLICK flag, step delay and the like. BE CAREFUL when changing
  39. the delays! You should not touch them unless you really know what you're
  40. doing! Read on for more info.
  41.  
  42.  
  43. Installation
  44. ------------
  45. Copy Nickprefs in your C: directory, and edit s:startup-sequence. Search for
  46. the line "IPrefs", and below it write "NickPrefs". It's important to launch
  47. NickPrefs just after IPrefs.
  48. If you are currently using my program "BusyPointer" or a similar (and less
  49. powerful ;-)) busy pointer animator, remove it from the startup-sequence
  50. since NickPrefs replaces it.
  51. Likewise, if you use a program that turns off the drive click remove it
  52. because Floppy does the same thing and much more.
  53.  
  54. Then copy WBPicture, BusyPointer and Floppy in SYS:Prefs, and reset.
  55. You're now ready to go.
  56.  
  57.  
  58. WBPicture
  59. ---------
  60. I've tried to make WBPicture, BusyPointer and Floppy identical to the other
  61. Preferences, so usage is (or should be) exactly the same.
  62.  
  63. When started the first time, WBPicture will open a window with most gadgets
  64. disabled. Click on the "Name" gadget to pick a filename, or just insert it in
  65. the string gadget. Pay attention to specify a complete path for the picture,
  66. e.g. "PICTURES:foo". Do not use a relative path or NickPrefs won't be able to
  67. locate the file. Note that the file is referenced by name, not stored in the
  68. preferences file, so you must provide a path which is always accessible at
  69. boot time (that is, somewhere in the hard disk, or your boot floppy).
  70.  
  71. When you've selected a picture, its size, planes and aspect ratio are
  72. displayed. On their right are the current settings of the Workbench screen,
  73. so you can compare them.
  74.  
  75. Below the info fields there are two checkbox. You can decide to center the
  76. picture in the screen, or to put it in the top left corner. If you are using
  77. a small brush, it can be tiled to cover the whole screen. Try with "Boing.br"
  78. contained in the "Presets" directory of this archive.
  79.  
  80. Then there is a gadget named "Load Palette". It will call the Palette
  81. Preferences loaded with the image's palette. You may then decide to use that
  82. colors, if they don't mess the 3D look of Workbench, or to keep the old
  83. colors. Pictures are *NOT* remapped to suit the actual Workbench palette, so
  84. if you have an image processor, you may want to use it. I use an 8 color
  85. Workbench, with this palette:
  86.   10 10 10  grey
  87.    0  0  0  black
  88.   15 15 15  white
  89.    6  8 11  blue
  90.    9  6  3  brown
  91.    3  8  3  green
  92.   12 12  0  yellow
  93.   14  7  0  orange
  94.  
  95. Reducing a picture from HAM to 8 colors with this palette, using some kind of
  96. dithering (and of course resizing it) often gives good results.
  97.  
  98. Finally, the "Test" gadget is equivalent to the one in WBPattern, and lets
  99. you see what the background looks like without exiting from WBPicture.
  100.  
  101.  
  102. BusyPointer
  103. -----------
  104. This is a replacement for my former program, "BusyPointer".
  105. Just as Pointer allows you to edit the Intuition pointer, this one gives you
  106. the possibility to edit the clock which the Workbench and other programs show
  107. when busy.
  108. But it does more than that: if you activate the "Guess Busy" option, not only
  109. the standard clock but also bubbles, "Wait" writings and the like will be
  110. converted to the one you chose. The option does exactly what it says: it will
  111. try to "guess" if a pointer represents a busy state or not. The algorithm is
  112. rather complex, and may fail. It works nice with most programs, but may turn
  113. to busy some pointers it shouldn't, or vice versa. Please let me know of such
  114. behaviours.
  115.  
  116. The editor is very similar to Pointer, but you can create animations. Just
  117. write the number of frames you want and use the slider to move across them.
  118.  
  119. The program has the capability to import IFF brushes and animbrushes. This is
  120. obtained selecting "Open..." in the menu "Project", like when you load a
  121. saved preset. If you have animations written for the stand-alone version of
  122. BusyPointer, you can load them as well.
  123. Animations replace the current one; if you load a single brush, it replaces
  124. only the current frame.
  125.  
  126. There are four presets provided with this archive; they are:
  127. - StopWatch  the standard clock, animated
  128. - TwoHands   the standard clock with two spinning hands
  129. - SandGlass  a sandglass
  130. - ZZBubble   the Workbench 1.3 bubble
  131.  
  132.  
  133. Floppy
  134. ------
  135. This one lets you stop that annoying drive click, and also mess with step,
  136. settle and calibrate delay. Parameters are set individually for each drive.
  137.  
  138. Normally, you should not touch the delay sliders. The default values, 3000,
  139. 15000 and 4000 µs, are the lower bounds stated by Commodore for the drive
  140. mechanics. Lowering them, the drive may work anyway, but don't expect to
  141. speed up floppy access, so there's no point in doing that. If you own an out
  142. of specs drive, raising step and calibrate delay may reduce the risk of r/w
  143. errors.
  144.  
  145. Note that the step delay greatly affects the noise the heads make while
  146. moving. If your drive is particularly noisy, you may try to make it more
  147. bearable by fine tuning the step delay.
  148.  
  149. The "Max Retry" slider shows the number of times that the trackdisk.device
  150. retries to read a track when it finds an error. This is quite interesting,
  151. for two reasons:
  152. - Lowering it to zero will cause a read error request to pop up immediately,
  153. without retrying to read the track. This means that you will discover earlier
  154. potential fatal errors due to imperfections in the disk.
  155. - Raising it will increase the chance to read a faulty track, allowing to
  156. recover data. Copy it somewhere else and throw away the disk!
  157.  
  158. I am currently using a Max Retry of 0 times, and I've no problems at all.
  159.  
  160.  
  161. Bugs
  162. ----
  163. I have problems in recognizing the main Workbench window from drawer windows.
  164. Currently, I modify the BackFill Hook if the window has the flag
  165. WFLG_WBENCHWINDOW set and: is a backdrop window or its title is "Workbench".
  166. This means that if you open a drawer whose name is "Workbench", its hook
  167. will be mistakenly changed.
  168. You can easily work around this bug simply by changing the drawer's name:
  169. since the patch is case sensitive, you may call it "WorkBench" (note the
  170. capital 'B').
  171.  
  172. If the color map of a picture is in 24-bit format, instead of the usual
  173. 12-bit, Palette does not read it correctly. This is a bug in Palette, *NOT*
  174. in WBPicture. I hope it will be fixed soon.
  175.  
  176.  
  177. Acknowledgments
  178. ---------------
  179. As usual, I have to thank my beta testers, whose help has been invaluable
  180. during the development of this program:
  181.  
  182. Stefano Iacus
  183. Federico Giannici
  184.  
  185. Many thanks to Dante Profeta who provided me the documentation for the IFF
  186. ANIM format, without which I wouldn't have been able to load animbrushes
  187. from BusyPointer.
  188.  
  189. Thank you very much!
  190.