*****************************************************************************
**    3D Rom Patch  (Version 1.50 26th August 1997)  by Matthew Bullock    **
*****************************************************************************

This patch is designed to give all menus and dialog boxes a 3D
effect. It is based on the original 3DPatch written by Ting Zwei
Kuei. Unlike the original patch this is a ROM patch, so it doesn't
have to copy the WindowManager to ram and thus uses much less
memory (about 21k instead of 80k).

Installation:
-------------

***NOTE***: If you have an existing version of my 3D Rom Patch, you
must remove it completely before continuing, as the installation
method has changed. To do this, delete the obey file called
!3DROMPtch that you installed in either your predesk or tasks
directory. Then delete the directory 3DROMPatch in your !Boot.Utils
directory.

First, remove any existing copy of the original non-rom
patch version of 3DPatch from your boot sequence.

Then copy the whole !3DROMPtch application into your
!Boot.Choices.Boot.Tasks. (Users with RiscOS 3.7 or later can put
it in their !Boot.Choices.Boot.Predesk directory instead if they
wish).

RISC OS 3.50 users only: If you have Acorn's ROM patch on your
system (it will be called !ROMPatch in your
!Boot.Choices.Boot.Tasks directory). Then you must rename it to
!!ROMPatch (add a !). This is to ensure that it is run before 3D
ROM Patch.

Finally reset the machine and it should all be installed.

In the unlikely event that something goes wrong, you may find that
your machine refuses to start, getting as far as the startup screen
then crashing. If this happens, reset the machine holding down
shift (press control + shift + break). This will start the machine
without running the boot sequence. You can then go into !Boot and
remove the files you have just added, restart the machine and try
again.

It is possible to test it first to see the effect if you don't
already have 3DPatch installed. To do so just double click on the
!3DROMPtch application and it will be temporarily installed.



Removing:
---------

The patch can be removed at any time by pressing F12 and typing
RMKill 3DROMPatch

To permanently remove it you should delete the !3DRomPtch
application.


Flashing menu items:
--------------------

The menu item flashing is fixed by a separate module called
MnuFlshFix. If you do not want the menu items to flash when clicked
on, it can be disabled by commenting out a line in the applications
!Run file. See the !Run file for more details.



Alternative menu backgrounds:
-----------------------------

The patch can now use an alternate texture sprite for the
background of menus. The patch is supplied with a default set of
sprites, which are just a lighter version of the standard window
backgrounds. If you wish to create your own background sprites,
then you can. They follow a simmilar naming scheme to the standard
background sprites. They should be called:

tile_m    : Which is the default sprite if no other one is found.
	    It should be a 16 colour sprite.
           
tile_m-XX : Where XX is the number of bits per pixel for the mode
            that the sprite was defined in. Will be used in
            preference to tile_m if one exists for the current
            mode. e.g. 'tile_m-16' will be used in a 32 thousand
            colour mode.

If there are no 'tile_m' sprites then menu backgrounds will use the
same sprite as windows.



NOTES:
------

1) If you are using one of Acorns rom patches then that must be run
   before my patch. If it is installed according to the standard
   instructions then there should be no problem.
   
2) With this patch installed you must not copy the WindowManager
   module to ram with RMFaster. If you do it will crash. This means
   that you cannot use it in conjunction with any other patch that
   alters the windowmanager. If you wish to do that then use the
   original 3DPatch instead.
   
3) This patch will only work on RiscOS 3.5-3.71, not 3.1 or earlier
   and I have no intention of making it work (because it is
   impossible due to limitations of the hardware).


Problems:
---------

All the problems in previous versions have now been fixed.

If you know of any problems not listed here, please email me with
details.

History:
--------

Version 1.00 (5th May 1997)
      
      First public release. The actual patch is almost exactly the same as the
      original non rom patch version, except for improved compatibility with
      Blinds from Quantum software.

Version 1.05 (19th June 1997)
      
      Complete re-write of rom patching code, now much faster, and works on a
      larger range of machines. Also added support for multiple ROM patches.
      
      Improved detection of iconbar, so it now works in modes with 0 eigen
      factors.
      
      Changed border drawing code to use window managers own slab drawing code,
      reducing code size by almost 400 bytes.

Version 1.06 (11th July 1997)
      
      Minor modifications to the ROM patching code.

Version 1.12 (28th July 1997)
      
      Substancial increase in compatiblity:
      
      Fixing problems with some RiscOS 3.5 machines, RiscOS 3.6 with Acorns
      rom patch, RiscOS 3.7 with Version 2.01 of Acorn's rom patch and several
      other problems.
      
      It should now work on all machines. Let me know if it doesn't.

Version 1.50 (26th August 1997)

      Near total rewrite of the patch.
      Fixed colour menu corruption problems.
      Fixed border redraw with textured backgrounds turned off.
      Added support for alternative menu backdrop sprite.
      Fixed problems with winodws resizing. (Previously parts of
      the 3D border could be left in the wrong place.)
      Fixed Selected menu items not flashing.
      Fixed incompatability with Newbase/Ant transport.
      Added RiscOS 3.71 compatability.
      Simplified installation process.
      And several other more minor improvements.

Copyright:
----------

3DRomPatch is copyright Matthew Bullock August 1997.

It contains original code written by Ting Zwei Kuei and Jon Wright.

It has been released as freeware, therefore it may be freely distributed by
anyone, as long as no charge is made for it except to cover the cost of media
and copying and all files are included. Anyone wishing to distribute it on a
large scale e.g. a PD library should contact me first so I can keep them
updated with new versions. It may not appear on a magazine cover
disc or any form of CD ROM without my prior written permission.


Thanks to:
----------

Ting Zwei Kuei - for writing the original 3D patch code.
Jon Wright - for writing the original iconbar detection code.

David McCormack - for the application sprite.

Chris Egan, John Townsend, Ian Walker, 
Iain Carr, Marc Warne, David McCormack,
Andrew Ingram, James Porrit, Scott Brodie,
Nick Grose and Simon Melhuish - for beta testing.

And a multitude of others for reporting bugs and giving
suggestions.

(If your name should be here and I have missed it, sorry, please
let me know.)


Other Rom Patches:
------------------

I hope for this to be the first of several rom patches I will produce. Now I
have written one it is relatively easy to adapt it to other purposes. So, if
anyone has another patch that would benefit from converting into a rom patch,
I would like to hear from you.



Contacting me:
--------------

email: matthew.bullock@dial.pipex.com
web site: http://dialspace.dial.pipex.com/matthew.bullock/

snail mail: Matthew Bullock
	    46 Ibbett Close
	    Kempston
	    Bedford
	    MK43 9BU
