BgrdImage V2.14 By Stuart Halliday of Quantum Software  2001-2004

This little program is designed to randomly pick a jpeg or sprite (squashed
sprites are also supported) from a directory and display it scaled full screen
on the Pinboard.

It also has a nice feature of not displaying the same picture twice.

It does this by keeping a list of the pictures in the directory you point
it to and as it displays each one it removes its entry from this list.
Once the list is empty or the number of pictures in the directory changes
it rebuilds the list again.

This list can be found at Boot:Choices.qsbackgrd


HOW TO USE
==========
I use it at boot up to change my Pinboard background.
I do this by creating an obey file (I've supplied an example)
and use the following line in it:

*bgrdimage ADFS::HardDisc4.$.PICS

NOTE: You must edit this path to point to a directory on your own
harddrive of course.

Then using !Boot/Configuration/Boot sequence panel I add this obeyfile to
the 'RUN' section. 

TIP 1
You could use the !Alarm program to run the program at a suitable interval.

TIP 2
If you've got one of our popular programs Keystroke you could get Keystroke
to automatically run bgrdimage every XX secs or mins. :-)

TIP3
If you find that the text of any icons on your pinboard are being masked by
the colour of the picture.
Add the following line above the '*bgrdimage....' line:

*Backdrop -Textcolour &BBGGRR00
Where BB is Blue, GG is Green and RR is Red. Values in Hexidecimal.
&FFFFFF00 is white. &00000000 is Black. &00BBFF00 is sort of gold.
(I use !ColourDef by Rosemary Miskin to help define colours easily.
http://www.argonet.co.uk/users/miskin/net/main.html )

HOW TO INSTALL
==============

Drop the 'bgrdimage' program into !Boot.Library and then use an obey file
like the example 'backgrd' supplied to change the Pinboard picture.

RISC OS SELECT users: Put this example obey file in !Boot.Library.User 




RISC OS
=======
Tested with RISC OS 4 + SELECT. Should work with RISC OS 3.7.
Earlier versions of the Pinboard didn't work with JPEGs iirc.
Works with RISC OS 5 on Iyonix PC.


HISTORY
=======

V2.14
Now works on RISC OS 5

V2.12
Added the ability to use Squashed graphic files.
If you squash Sprites with !Squash you can save a lot of disc space.
bgrdimage now unsquashes the graphic if its squashed to
<Wimp$scrapdir>.scrapimage and placed that copy on the Pinboard.
This feature was requested by Mark Rowan.

Due to changes required to make this work. Bgrdimage is now a wimptask
and so can not run within TaskObey files.


V2.11
now displays a error message if used incorrectly.



Extra Images can be found at:
http://www.quantumsoft.co.uk/files/clipart/jpegs
http://www.quantumsoft.co.uk/desktoppics/
Or see the file ImageList I've included.

CONDITIONS OF USE
=================
This software is freeware.
If you decide to use it, drop me an email to say thanks.

stuart@quantumsoft.co.uk

This software is supplied "as seen"; no warranty, express or implied, of the
merchantability of this software or its fitness for any particular purpose
is given. Under no circumstances shall Quantum Software, the author, or any
provider or distributor of this software, be liable for any  damage, loss of
profits, or any indirect or consequential loss arising out of the use of
this software or for the users inability to use this software correctly.
