ReadMe for Misc Setup Configuration Plugin v1.13 (1st May 2008)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Purpose:
~~~~~~~~
	To provide easy configuration of miscellaneous bootup options.
	At present, there are the following options;
	
		Setting the default desktop font size.
		Setting the default desktop font aspect ratio.
		Setting the default font cache size.
		Setting the default NextSlot.
		Setting LMTransport configuration.
		Correcting the default sample rate to 44.1KHz
		Option of using a RAM disc based !Scrap.
		Replacing the boring switcher icon with the old Acorn one.
		Option of using different toolsprites for the wimp.
		Option of using extra sprites for the wimp.
		Enabling/Disabling lazy task swapping.
		
	 Visual effects
	        Various wimp effects.


Use:
~~~~
	Select from the main !Boot configuration and toggle the options you require.
	The minimum nextslot is 32K and the maximum is 512000K.

	The font size buttons will go up and down in steps of 0.25pt with each click of the
	relevant up/down buttons, unless SHIFT is held down on the keyboard, in which case the
	size will go up/down by 1pt.
	Minimum size is 6pt and maximum size is 32.
	
	The font aspect ratio will go up/down by 1 with each click.
	If SHIFT is held it will go up/down by 10.
	Minimum aspect ratio is 40 and maximum is 400.
	
	The initial font cache size will go up/down by 4K with each click.
	If SHIFT is held it will go up/down by 40.
	Minimum initial font cache is 0 and maximum is 32768K.
	
	The LMTransport options can be toggled by clicking Select on the relevant icon. To turn
	off altogether, click the relevant radio icon with the Adjust button.
	
	Using a RAM disc based !Scrap will automatically copy !Scrap onto a RAM disc at startup.
	This is useful for speed improvements, less wear on the hard disc as well as bringing
	security in that any temporary files will be wiped when you reset the computer.
	
	Enabling extra iconsprites will let you replace some of the desktop sprites with your
	own.
	Enabling 'Big mouse pointer' will make the mouse pointer a lot bigger, for better
	visibility,
	N.B. Current versions of !MiscSetup include a replacement 'shared CD' icon, to replace
	the incorrect one in the ROM.
	
	Custom ToolSprites
	~~~~~~~~~~~~~~~~~~
	This section was amended at version 1.12 to cater for my new !ToolMaker application,
	which can be downloaded from http://www.vigay.com/software/toolmaker.html
	
	Tick the 'Custom ToolSprites' icon in order to enable a new ToolSprite set to be
	automatically loaded when you next reboot your machine.
	
	If enabled, the two icons immediately below this option will become available and allow
	you to select from a range of ToolSprite icon sets stored within MiscSetup
	
	The actual ToolSprites icons are stored within !MiscSetup.Resources.ToolSprites and
	can be edited/created using my !ToolMaker utility.

	Visual Effects Flags
	~~~~~~~~~~~~~~~~~~~
	The various visual effects flags provided by MiscSetup are all actually built into 
	RISC OS, but RISC OS 5 doesn't feature easily configuration options for them, as RISC OS
	Select/Adjust does. Therefore, you can use MiscSetup to control the various aspects of
	the *WimpVisualFlags command.
	
	No icon boxes in windows
		If on, this removes the filled box from behind the text in text+sprite icons
		
	No icon boxes on pinboard
		If on, there will be no background to text on the pinboard. This option may be
		useful in conjunction with 'Font Blending'.
		
	Font Blending
		If on, uses anti-aliased font blending in icons.
		
	Textured Menus
		If on, all standard RISC OS menus have a textured background.
		
	Alternative menu texture
		If on, a different background tile is used for the textured menu background.
		
	3D window borders
		If on, gives all menus and dialogue boxes a 3D border effect.
		
	Fully 3D icon bar
		If on, makes the iconbar have a full 3D border.
		
	Visual effects also allows you to set the colour of the 3D window borders, but I've not
	implemented this facility yet. Keep an eye on my website for news of updates and future
	versions.
	

Installation:
~~~~~~~~~~~~~
	Automatic:
		To install automatically, simply drag the !Boot folder from this archive over
		your existing !Boot folder. The relevant files will then be merged.

	Manual:
		You will need to manually open the !Boot folder in this archive, then open the
		Resources.Configure directory.
		Drag !MiscSetup into this !Boot.Resources.Configure directory in your existing
		!Boot structure.


Technical:
~~~~~~~~~~
	!MiscSetup writes several new files into your !Boot sequence:-
	
	Boot:Choices.Boot.PreDesk.MiscSetup will be a directory containing a 'sound sample rate
	patch file as well as a 'settings' file which contains switcher icon, initial font cache
	size and LMTransport settings.
	
	Boot:Choices.Boot.Tasks.MiscSetup will store the Nextslot value	(this is to prevent the
	default !Boot settings from overruling it)
	It will also contain the relevant commands for setting up a RAM based !Scrap if enabled.
	
	It can also modify the Boot:Choices.Boot.PreDesk.FontSetup file if you change the
	desktop font size.
	
	If you can design better sprites for it, please let me know. :-)
	
	The RISC OS mouse pointer can be up to 32x32 pixels in size, if you want to redefine
	the 'big' pointer.


Version History:
~~~~~~~~~~~~~~~~

 v1.13 (1st May 2008)
        a) Added support for 'Big mouse pointer'.
        
 v1.12 (16th Apr 2008)
        a) Added option to select various additional ToolSprites icon sets.
        b) Added email and web links to 'Info' window.
        
 v1.11 (30th Nov 2007)
        a) Added help icon to main window, to load this file.
        b) Added more information to this !Help file.
        
 v1.10 (29th Nov 2007)
        a) Added VisualWimp effects, to provide some of the RISC OS Select 'glossy effects' such
           as 3D window borders, transparent icons on the pinboard and textured menus etc.
           
 v1.09 (13th Jan 2007)
        a) Allowed used of 'Adjust' button to turn off LMTransport or NetBEUI options without
           toggling the other option. This may cater for alternative network cards which don't
           require EITHER setting to be saved within PreDesk.
           
 v1.08 (1st Jun 2006)
        a) Added option to enable/disable lazy task swapping.
     
 v1.07 (8th Mar 2006)
        a) Added option to run !Scrap from a RAM disc.
        b) Added option to use mini toolsprites.
        c) Added option to use extra iconsprites.
        d) Added 'Open resources dir' button.
        e) Redesigned main window layout slightly.
	
 v1.06 (17th Jan 2006)
        a) Re-wrote sound sample patch code to correctly enumerate all the available sample
           rates to the fitted hardware and then patch to 44.1KHz accordingly (see PRM vol 5a,
           p.590-)
        b) Fixed bug whereby Boot:Choices.PreDesk.MiscSetup sometimes didn't get created,
           leading to an error when trying to save preferences.
           
 v1.05a (16th Jan 2006)
        a) Corrected sample rate setting to 25 (441000Hz) - v1.06 will include additional code
           to correctly read all the relevant sound samples according to the relevant hardware
           in the machine (PRM vol5a, p 590-)
           
 v1.05 (14th Jan 2006)
        a) Changed window design slightly.
        b) Added facily to correct the default sound sample rate.
        c) Moved PreDesk choices into it's own directory.
        
 v1.04 (23rd Dec 2004)
        a) Added support for setting the initial font cache.
           Thanks to Mark Rowan for suggesting this option, due to a limitation in the RISC OS 4
           !Boot 'font' configuration.
	   
 v1.03 (22nd Apr 2004)
        a) Fixed minor bug to enable keypresses to work.
 
 v1.02 (21st Apr 2004)
        a) Amended desktop font size to be adjustable in steps of 0.25pt for finer control of
           size. (Thanks to Chris Terran for suggesting it)
        b) Added font aspect ratio configuration editing.
        c) Added SHIFT action to font size buttons to jump bigger steps.
 
 v1.01 (3rd Mar 2004)
        a) Added 'default' switcher icon back so that you can switch back to the default Iyonix
           switcher icon without resetting the machine.
  
 v1.00 (29th Dec 2003)
        a) Bug fix: Work around 'feature' of RISC OS 5 which prevents the resizing of desktop
           ROM fonts (ie. Corpus,Homerton,Trinity etc.)
 
 v0.09 (27th Dec 2003)
        a) Bug fix: Fixed parsing and editing of FontSetup file.
 
 v0.08 (27th Dec 2003)
        a) Increased upper limit on NextSlot to 512M
        b) Tidied icons a bit, to allow for bigger desktop font sizes.
        c) Added desktop font size configuration.
        d) Added 'Adjust' reverse action operation to up/down buttons.
 
 v0.07 (24th Dec 2003)
        First version - should be all working ok.
 
 
Author:
~~~~~~~
MiscSetup is copyright Paul Vigay but may be freely copied and distributed providing all the
files remain intact and unaltered, including this one.

Some of the mini toolsprites were initially inspired from a design by Ian Giblin
(http://www.panix.com/~giblin/acorn/tools/)


Email: nospam@vigay.com
  Web: http://www.vigay.com/software/
  
2003-08 Paul Vigay
