home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / patches / pinpatch / !PinPatch / !Help next >
Encoding:
Text File  |  1997-10-01  |  7.2 KB  |  214 lines
  1.  ______________________________________________________________________________
  2. |  ___ _      _                      _   ___             ___      _      _     |
  3. | | _ (_)_ _ | |__  ___  __ _ _ _ __| | | _ \___ _ __   | _ \__ _| |_ __| |_   |
  4. | |  _/ | ' \| '_ \/ _ \/ _` | '_/ _` | |   / _ \ '  \  |  _/ _` |  _/ _| ' \  |
  5. | |_| |_|_||_|_.__/\___/\__,_|_| \__,_| |_|_\___/_|_|_| |_| \__,_|\__\__|_||_| |
  6. |                                                                              |
  7. |               (Version 0.80 1st October 1997) © Matthew Bullock              |
  8. |______________________________________________________________________________|
  9.                                                                               
  10.  
  11. Pinboard rom patch is a patch for the pinboard.
  12.  
  13. The following new features are implented:
  14.  
  15. Fixes bug when dragging a group of selected icons with adjust.
  16.       Previously, if you dragged a group of selected icons with adjust, it
  17.       would drag all but the icon dragged on.
  18.  
  19. Allows dragging of iconised window icons with adjust.
  20.       Previously only select worked and adjust was just ignored.
  21.  
  22. Fixes always claiming window closed messages.
  23.       Whenever a window closes, the window manager broadcasts a message to tell
  24.       applications. It is only used by pinboard like applications, so the
  25.       pinboard always claimed it. But some patches need to use it.
  26.  
  27. Adds auto saving of pinboard state on shutdown.
  28.       If the system variable SavePinboard$State contains a valid path, the
  29.       current state of the pinboard is saved to that file when the computer is
  30.       shut down.
  31.  
  32. Adds support for JPEG backdrops.
  33.       JPEG files can now be used as backdrops and are rendered in real time.
  34.  
  35. Fixes bug in detecting mode change.
  36.       Previously the pinboard would sometimes fail to redraw the screen when
  37.       the mode changed, that could cause a scaled backdrop to stop filling the
  38.       screen.
  39.  
  40. Fixes bug in spriteextend.
  41.       Previously spriteextend would fail with an address exception error if you
  42.       tried to render a JPEG while the current wimpslot was less than 24k.
  43.  
  44.  
  45. Installation:
  46. -------------
  47.  
  48. ***NOTE***: If you have an existing version of my pinboard Rom
  49. Patch, you must remove it completely before continuing, as the
  50. installation method has changed. To do this, delete the obey file
  51. called !PinPatch that you installed in either your predesk or tasks
  52. directory. Then delete the directory PinROMPatch in your
  53. !Boot.Utils directory.
  54.  
  55. First, copy the whole !PinPatch application into your
  56. !Boot.Choices.Boot.Tasks directory. (Users with RiscOS 3.7 or later
  57. can put it in their !Boot.Choices.Boot.Predesk directory instead if
  58. they wish).
  59.  
  60. RISC OS 3.50 users only: If you have Acorn's ROM patch on your
  61. system (it will be called !ROMPatch in your
  62. !Boot.Choices.Boot.Tasks directory). Then you must rename it to
  63. !!ROMPatch (add a !). This is to ensure that it is run before
  64. pinboard ROM Patch.
  65.  
  66. Finally reset the machine and it should all be installed.
  67.  
  68. In the unlikely event that something goes wrong, you may find that
  69. your machine refuses to start, getting as far as the startup screen
  70. then crashing. If this happens, reset the machine holding down
  71. shift (press control + shift + break). This will start the machine
  72. without running the boot sequence. You can then go into !Boot and
  73. remove the files you have just added, restart the machine and try
  74. again.
  75.  
  76. It is possible to test it first to see the effect. To do so just
  77. double click on the !PinPatch application and it will be
  78. temporarily installed.
  79.  
  80.  
  81. Frequently Asked Questions
  82. --------------------------
  83.  
  84. 1) I have found a JPEG that doesn't appear to work as a backdrop, what should I    do?
  85.       
  86.    Firstly, you should try loading it into draw. If it doesn't work there, then
  87.    it's format is incompatible with the JPEG rendering module. Load it into
  88.    ChangeFSI and save it out again as a JPEG and it will be converted to the
  89.    correct format.
  90.  
  91. 2) I am trying to use a tiled JPEG backdrop, but the JPEG is rendered much
  92.    smaller than it should be, why?
  93.       
  94.    This is caused by an incorrect header in the JPEG. I have found quite a
  95.    large number of JPEG files that have incorrect DPI settings. For the moment,
  96.    the only solution is to pass the JPEG through ChangeFSI, that will cure the
  97.    problem. A future version of the patch will probably fix this.
  98.  
  99.  
  100.  
  101. Removing:
  102. ---------
  103.  
  104. The patch can be removed at any time by pressing F12 and typing
  105. RMKill PinboardROMPatch
  106.  
  107. NOTE: before RMKilling the patch, you must remove the backdrop if it is a JPEG.
  108. failure to do so will cause the machine to crash.
  109.  
  110. To permanently remove it you should delete the !PinPatch
  111. application that you installed in your boot sequence.
  112.  
  113.  
  114. Auto state saving
  115. -----------------
  116.  
  117. To automatically same the pinboard state at shutdown, set the variable
  118. <SavePinboard$File> to point to a valid file. The state will then be saved to
  119. that file on shutdown.
  120.  
  121. For example:
  122.  
  123. Set SavePinboard$File Boot:Choices.Boot.Tasks.PinBoard
  124.  
  125. will make the state be saved on shutdown and reloaded automatically on startup.
  126.  
  127.  
  128. NOTES:
  129. ------
  130.  
  131. 1) If you are using one of Acorns rom patches then that must be run before my
  132.    patch. If it is installed according to the standard instructions then
  133.    there should be no problem.
  134.    
  135. 2) This patch will only work on RiscOS 3.5 to 3.71. It is not
  136.    possible to run it on prior bersions of the operating system due
  137.    to limitations of the hardware.
  138.  
  139.  
  140. Version History
  141. ---------------
  142.  
  143. Version 0.60 (28th June 1997)
  144.       
  145.       First public release.
  146.  
  147. Version 0.61 (28th June 1997)
  148.       
  149.       Added SpriteExtend fix.
  150.  
  151. Version 0.70 (29th July 1997)
  152.       
  153.       Changed to not use error diffused dithering, for faster redraw in low
  154.       colour modes.
  155.       
  156.       Added RiscOS 3.6 compatability.
  157.       
  158.       Fixed error in OS version detection code, no longer gives an "oflaofla"
  159.       error.
  160.  
  161. Version 0.80 (1st October 1997)
  162.  
  163.       Added RiscOS 3.71 compatability.
  164.       
  165.       Simplified installation system.
  166.  
  167. Copyright:
  168. ----------
  169.  
  170. Pinboard Rom Patch is copyright Matthew Bullock October 1997.
  171.  
  172. It has been released as freeware, therefore it may be freely distributed by
  173. anyone, as long as no charge is made for it except to cover the cost of media
  174. and copying and all files are included. It may not be included on a magazine
  175. cover disc or a CDRom without prior written permission from me.
  176. Anyone wishing to distribute it on a large scale e.g. a PD library should
  177. contact me first so I can keep them updated with new versions.
  178.  
  179.  
  180. Thanks To:
  181. ----------
  182.  
  183. David McCormack - for the application sprite.
  184.  
  185. James Porrit, Marc Warne, John Townsend,
  186. Ian Walker, Iain Carr, Marc Warne,
  187. David McCormack, Andrew Ingram, James Porrit,
  188. Peter Smith, Andrew Marsh, Scott Brodie,
  189. Nick Grose and Simon Melhuish - for beta testing.
  190.  
  191. And to everyone else who has reported bugs or given suggestions
  192.  
  193.  
  194. Other Rom Patches:
  195. ------------------
  196.  
  197. I hope for this to be one of several rom patches I will produce. Now I have written
  198. one it is relatively easy to adapt it to other purposes. So, if anyone has another
  199. patch that would benefit from converting into a rom patch, I would like to hear
  200. from you.
  201.  
  202.  
  203. Contacting me:
  204. --------------
  205.  
  206. email: matthew.bullock@dial.pipex.com
  207. web site: http://dialspace.dial.pipex.com/matthew.bullock/
  208.  
  209. snail mail: Matthew Bullock
  210.         46 Ibbett Close
  211.         Kempston
  212.         Bedford
  213.         MK43 9BU
  214.