Home » Archimedes archive » Acorn User » AU 1995-12 B.adf » Regulars » StarInfo/Tanner/!GenBackDr/!Help

StarInfo/Tanner/!GenBackDr/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1995-12 B.adf » Regulars
Filename: StarInfo/Tanner/!GenBackDr/!Help
Read OK:
File size: 09C7 bytes
Load address: 0000
Exec address: 0000
File contents
!GenBackDr
==========

(c) T. R. Tanner

email tomt@selwood.demon.co.uk

Drop a file into the icon & it will set the backdrop. The backdrop icon will
be regenerated if the wimp mode changes.

The "Scaling" option allows controlling of scaling & tiling of the picture on
the backdrop.

The "Processing" menu option allows selection / control of various changefsi
flags.

The "Save" option allows the current state (i.e. icon, etc) to be saved
permamently. NB The actual "default" backdrop will be regenerated when the
machine is rebooted (or !GenBackDr is restarted) if required.

The "Reset" option resets the backdrop to the options at the last save.

NOTES
=====

1/	If you wish to turn on the grid lock (*Pinboard -Grid), you will
wipe out the backdrop (IMHO, this is a bug). => If you do this in a boot
sequence, do it before !GenBackDrop is started!

2/	The program uses CHANGEFSI to generate the sprite for the backdrop.
If CHANGEFSI can't handle it, this can't.

3/	The program was written using CHANGEFSI 0.98 or so & the parameters
to this DO NOT conform to the documentation. However, I Can't check the
version number sensibly.

4/	Pinboard is too pessimistic about how much space it needs to load a
backdrop sprite, so don't blame me if there is buckets of free ram and you
get an error saying "Not Enough Memory To Load Backdrop Sprite". Pinboard is
lying.

5/	Interactive help & desktop save are supported.

TO COME
=======

Have a quick grovel about in the code, you'll see what I haven't done yet (or
properly).

REGISTRATION
============

If anybody wishes to register with me, for some nominal fee I will gladly
send them updates. NB To cover disc costs & so on, said nominal fee should
be in excess of �2.00




Tedious legal message
=====================

   This application is freeware. It can be distributed freely as long as
only reasonable charges are made for media and distribution. I retain
copyright on all program code and documentation.

   This software is supplied �as�is�: I make no warranty, expressed or
implied, of the merchantability of this software or its �tness for any
particular purpose. In no circumstances shall I be liable for any damage,
loss of pro�ts, or any indirect or consequential loss arising out of the use
of this software or inability to use this software, even if I have been
advised of the possibility of such loss.

   In other words, if your computer crashes, blows up, you lose all your work
etc. all because of !GenBackDrop, don�t blame me.
00000000  21 47 65 6e 42 61 63 6b  44 72 0a 3d 3d 3d 3d 3d  |!GenBackDr.=====|
00000010  3d 3d 3d 3d 3d 0a 0a 28  63 29 20 54 2e 20 52 2e  |=====..(c) T. R.|
00000020  20 54 61 6e 6e 65 72 0a  0a 65 6d 61 69 6c 20 74  | Tanner..email t|
00000030  6f 6d 74 40 73 65 6c 77  6f 6f 64 2e 64 65 6d 6f  |omt@selwood.demo|
00000040  6e 2e 63 6f 2e 75 6b 0a  0a 44 72 6f 70 20 61 20  |n.co.uk..Drop a |
00000050  66 69 6c 65 20 69 6e 74  6f 20 74 68 65 20 69 63  |file into the ic|
00000060  6f 6e 20 26 20 69 74 20  77 69 6c 6c 20 73 65 74  |on & it will set|
00000070  20 74 68 65 20 62 61 63  6b 64 72 6f 70 2e 20 54  | the backdrop. T|
00000080  68 65 20 62 61 63 6b 64  72 6f 70 20 69 63 6f 6e  |he backdrop icon|
00000090  20 77 69 6c 6c 0a 62 65  20 72 65 67 65 6e 65 72  | will.be regener|
000000a0  61 74 65 64 20 69 66 20  74 68 65 20 77 69 6d 70  |ated if the wimp|
000000b0  20 6d 6f 64 65 20 63 68  61 6e 67 65 73 2e 0a 0a  | mode changes...|
000000c0  54 68 65 20 22 53 63 61  6c 69 6e 67 22 20 6f 70  |The "Scaling" op|
000000d0  74 69 6f 6e 20 61 6c 6c  6f 77 73 20 63 6f 6e 74  |tion allows cont|
000000e0  72 6f 6c 6c 69 6e 67 20  6f 66 20 73 63 61 6c 69  |rolling of scali|
000000f0  6e 67 20 26 20 74 69 6c  69 6e 67 20 6f 66 20 74  |ng & tiling of t|
00000100  68 65 20 70 69 63 74 75  72 65 20 6f 6e 0a 74 68  |he picture on.th|
00000110  65 20 62 61 63 6b 64 72  6f 70 2e 0a 0a 54 68 65  |e backdrop...The|
00000120  20 22 50 72 6f 63 65 73  73 69 6e 67 22 20 6d 65  | "Processing" me|
00000130  6e 75 20 6f 70 74 69 6f  6e 20 61 6c 6c 6f 77 73  |nu option allows|
00000140  20 73 65 6c 65 63 74 69  6f 6e 20 2f 20 63 6f 6e  | selection / con|
00000150  74 72 6f 6c 20 6f 66 20  76 61 72 69 6f 75 73 20  |trol of various |
00000160  63 68 61 6e 67 65 66 73  69 0a 66 6c 61 67 73 2e  |changefsi.flags.|
00000170  0a 0a 54 68 65 20 22 53  61 76 65 22 20 6f 70 74  |..The "Save" opt|
00000180  69 6f 6e 20 61 6c 6c 6f  77 73 20 74 68 65 20 63  |ion allows the c|
00000190  75 72 72 65 6e 74 20 73  74 61 74 65 20 28 69 2e  |urrent state (i.|
000001a0  65 2e 20 69 63 6f 6e 2c  20 65 74 63 29 20 74 6f  |e. icon, etc) to|
000001b0  20 62 65 20 73 61 76 65  64 0a 70 65 72 6d 61 6d  | be saved.permam|
000001c0  65 6e 74 6c 79 2e 20 4e  42 20 54 68 65 20 61 63  |ently. NB The ac|
000001d0  74 75 61 6c 20 22 64 65  66 61 75 6c 74 22 20 62  |tual "default" b|
000001e0  61 63 6b 64 72 6f 70 20  77 69 6c 6c 20 62 65 20  |ackdrop will be |
000001f0  72 65 67 65 6e 65 72 61  74 65 64 20 77 68 65 6e  |regenerated when|
00000200  20 74 68 65 0a 6d 61 63  68 69 6e 65 20 69 73 20  | the.machine is |
00000210  72 65 62 6f 6f 74 65 64  20 28 6f 72 20 21 47 65  |rebooted (or !Ge|
00000220  6e 42 61 63 6b 44 72 20  69 73 20 72 65 73 74 61  |nBackDr is resta|
00000230  72 74 65 64 29 20 69 66  20 72 65 71 75 69 72 65  |rted) if require|
00000240  64 2e 0a 0a 54 68 65 20  22 52 65 73 65 74 22 20  |d...The "Reset" |
00000250  6f 70 74 69 6f 6e 20 72  65 73 65 74 73 20 74 68  |option resets th|
00000260  65 20 62 61 63 6b 64 72  6f 70 20 74 6f 20 74 68  |e backdrop to th|
00000270  65 20 6f 70 74 69 6f 6e  73 20 61 74 20 74 68 65  |e options at the|
00000280  20 6c 61 73 74 20 73 61  76 65 2e 0a 0a 4e 4f 54  | last save...NOT|
00000290  45 53 0a 3d 3d 3d 3d 3d  0a 0a 31 2f 09 49 66 20  |ES.=====..1/.If |
000002a0  79 6f 75 20 77 69 73 68  20 74 6f 20 74 75 72 6e  |you wish to turn|
000002b0  20 6f 6e 20 74 68 65 20  67 72 69 64 20 6c 6f 63  | on the grid loc|
000002c0  6b 20 28 2a 50 69 6e 62  6f 61 72 64 20 2d 47 72  |k (*Pinboard -Gr|
000002d0  69 64 29 2c 20 79 6f 75  20 77 69 6c 6c 0a 77 69  |id), you will.wi|
000002e0  70 65 20 6f 75 74 20 74  68 65 20 62 61 63 6b 64  |pe out the backd|
000002f0  72 6f 70 20 28 49 4d 48  4f 2c 20 74 68 69 73 20  |rop (IMHO, this |
00000300  69 73 20 61 20 62 75 67  29 2e 20 3d 3e 20 49 66  |is a bug). => If|
00000310  20 79 6f 75 20 64 6f 20  74 68 69 73 20 69 6e 20  | you do this in |
00000320  61 20 62 6f 6f 74 0a 73  65 71 75 65 6e 63 65 2c  |a boot.sequence,|
00000330  20 64 6f 20 69 74 20 62  65 66 6f 72 65 20 21 47  | do it before !G|
00000340  65 6e 42 61 63 6b 44 72  6f 70 20 69 73 20 73 74  |enBackDrop is st|
00000350  61 72 74 65 64 21 0a 0a  32 2f 09 54 68 65 20 70  |arted!..2/.The p|
00000360  72 6f 67 72 61 6d 20 75  73 65 73 20 43 48 41 4e  |rogram uses CHAN|
00000370  47 45 46 53 49 20 74 6f  20 67 65 6e 65 72 61 74  |GEFSI to generat|
00000380  65 20 74 68 65 20 73 70  72 69 74 65 20 66 6f 72  |e the sprite for|
00000390  20 74 68 65 20 62 61 63  6b 64 72 6f 70 2e 0a 49  | the backdrop..I|
000003a0  66 20 43 48 41 4e 47 45  46 53 49 20 63 61 6e 27  |f CHANGEFSI can'|
000003b0  74 20 68 61 6e 64 6c 65  20 69 74 2c 20 74 68 69  |t handle it, thi|
000003c0  73 20 63 61 6e 27 74 2e  0a 0a 33 2f 09 54 68 65  |s can't...3/.The|
000003d0  20 70 72 6f 67 72 61 6d  20 77 61 73 20 77 72 69  | program was wri|
000003e0  74 74 65 6e 20 75 73 69  6e 67 20 43 48 41 4e 47  |tten using CHANG|
000003f0  45 46 53 49 20 30 2e 39  38 20 6f 72 20 73 6f 20  |EFSI 0.98 or so |
00000400  26 20 74 68 65 20 70 61  72 61 6d 65 74 65 72 73  |& the parameters|
00000410  0a 74 6f 20 74 68 69 73  20 44 4f 20 4e 4f 54 20  |.to this DO NOT |
00000420  63 6f 6e 66 6f 72 6d 20  74 6f 20 74 68 65 20 64  |conform to the d|
00000430  6f 63 75 6d 65 6e 74 61  74 69 6f 6e 2e 20 48 6f  |ocumentation. Ho|
00000440  77 65 76 65 72 2c 20 49  20 43 61 6e 27 74 20 63  |wever, I Can't c|
00000450  68 65 63 6b 20 74 68 65  0a 76 65 72 73 69 6f 6e  |heck the.version|
00000460  20 6e 75 6d 62 65 72 20  73 65 6e 73 69 62 6c 79  | number sensibly|
00000470  2e 0a 0a 34 2f 09 50 69  6e 62 6f 61 72 64 20 69  |...4/.Pinboard i|
00000480  73 20 74 6f 6f 20 70 65  73 73 69 6d 69 73 74 69  |s too pessimisti|
00000490  63 20 61 62 6f 75 74 20  68 6f 77 20 6d 75 63 68  |c about how much|
000004a0  20 73 70 61 63 65 20 69  74 20 6e 65 65 64 73 20  | space it needs |
000004b0  74 6f 20 6c 6f 61 64 20  61 0a 62 61 63 6b 64 72  |to load a.backdr|
000004c0  6f 70 20 73 70 72 69 74  65 2c 20 73 6f 20 64 6f  |op sprite, so do|
000004d0  6e 27 74 20 62 6c 61 6d  65 20 6d 65 20 69 66 20  |n't blame me if |
000004e0  74 68 65 72 65 20 69 73  20 62 75 63 6b 65 74 73  |there is buckets|
000004f0  20 6f 66 20 66 72 65 65  20 72 61 6d 20 61 6e 64  | of free ram and|
00000500  20 79 6f 75 0a 67 65 74  20 61 6e 20 65 72 72 6f  | you.get an erro|
00000510  72 20 73 61 79 69 6e 67  20 22 4e 6f 74 20 45 6e  |r saying "Not En|
00000520  6f 75 67 68 20 4d 65 6d  6f 72 79 20 54 6f 20 4c  |ough Memory To L|
00000530  6f 61 64 20 42 61 63 6b  64 72 6f 70 20 53 70 72  |oad Backdrop Spr|
00000540  69 74 65 22 2e 20 50 69  6e 62 6f 61 72 64 20 69  |ite". Pinboard i|
00000550  73 0a 6c 79 69 6e 67 2e  0a 0a 35 2f 09 49 6e 74  |s.lying...5/.Int|
00000560  65 72 61 63 74 69 76 65  20 68 65 6c 70 20 26 20  |eractive help & |
00000570  64 65 73 6b 74 6f 70 20  73 61 76 65 20 61 72 65  |desktop save are|
00000580  20 73 75 70 70 6f 72 74  65 64 2e 0a 0a 54 4f 20  | supported...TO |
00000590  43 4f 4d 45 0a 3d 3d 3d  3d 3d 3d 3d 0a 0a 48 61  |COME.=======..Ha|
000005a0  76 65 20 61 20 71 75 69  63 6b 20 67 72 6f 76 65  |ve a quick grove|
000005b0  6c 20 61 62 6f 75 74 20  69 6e 20 74 68 65 20 63  |l about in the c|
000005c0  6f 64 65 2c 20 79 6f 75  27 6c 6c 20 73 65 65 20  |ode, you'll see |
000005d0  77 68 61 74 20 49 20 68  61 76 65 6e 27 74 20 64  |what I haven't d|
000005e0  6f 6e 65 20 79 65 74 20  28 6f 72 0a 70 72 6f 70  |one yet (or.prop|
000005f0  65 72 6c 79 29 2e 0a 0a  52 45 47 49 53 54 52 41  |erly)...REGISTRA|
00000600  54 49 4f 4e 0a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |TION.===========|
00000610  3d 0a 0a 49 66 20 61 6e  79 62 6f 64 79 20 77 69  |=..If anybody wi|
00000620  73 68 65 73 20 74 6f 20  72 65 67 69 73 74 65 72  |shes to register|
00000630  20 77 69 74 68 20 6d 65  2c 20 66 6f 72 20 73 6f  | with me, for so|
00000640  6d 65 20 6e 6f 6d 69 6e  61 6c 20 66 65 65 20 49  |me nominal fee I|
00000650  20 77 69 6c 6c 20 67 6c  61 64 6c 79 0a 73 65 6e  | will gladly.sen|
00000660  64 20 74 68 65 6d 20 75  70 64 61 74 65 73 2e 20  |d them updates. |
00000670  4e 42 20 54 6f 20 63 6f  76 65 72 20 64 69 73 63  |NB To cover disc|
00000680  20 63 6f 73 74 73 20 26  20 73 6f 20 6f 6e 2c 20  | costs & so on, |
00000690  73 61 69 64 20 6e 6f 6d  69 6e 61 6c 20 66 65 65  |said nominal fee|
000006a0  20 73 68 6f 75 6c 64 0a  62 65 20 69 6e 20 65 78  | should.be in ex|
000006b0  63 65 73 73 20 6f 66 20  a3 32 2e 30 30 0a 0a 0a  |cess of .2.00...|
000006c0  0a 0a 54 65 64 69 6f 75  73 20 6c 65 67 61 6c 20  |..Tedious legal |
000006d0  6d 65 73 73 61 67 65 0a  3d 3d 3d 3d 3d 3d 3d 3d  |message.========|
000006e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 20  |=============.. |
000006f0  20 20 54 68 69 73 20 61  70 70 6c 69 63 61 74 69  |  This applicati|
00000700  6f 6e 20 69 73 20 66 72  65 65 77 61 72 65 2e 20  |on is freeware. |
00000710  49 74 20 63 61 6e 20 62  65 20 64 69 73 74 72 69  |It can be distri|
00000720  62 75 74 65 64 20 66 72  65 65 6c 79 20 61 73 20  |buted freely as |
00000730  6c 6f 6e 67 20 61 73 0a  6f 6e 6c 79 20 72 65 61  |long as.only rea|
00000740  73 6f 6e 61 62 6c 65 20  63 68 61 72 67 65 73 20  |sonable charges |
00000750  61 72 65 20 6d 61 64 65  20 66 6f 72 20 6d 65 64  |are made for med|
00000760  69 61 20 61 6e 64 20 64  69 73 74 72 69 62 75 74  |ia and distribut|
00000770  69 6f 6e 2e 20 49 20 72  65 74 61 69 6e 0a 63 6f  |ion. I retain.co|
00000780  70 79 72 69 67 68 74 20  6f 6e 20 61 6c 6c 20 70  |pyright on all p|
00000790  72 6f 67 72 61 6d 20 63  6f 64 65 20 61 6e 64 20  |rogram code and |
000007a0  64 6f 63 75 6d 65 6e 74  61 74 69 6f 6e 2e 0a 0a  |documentation...|
000007b0  20 20 20 54 68 69 73 20  73 6f 66 74 77 61 72 65  |   This software|
000007c0  20 69 73 20 73 75 70 70  6c 69 65 64 20 94 61 73  | is supplied .as|
000007d0  a0 69 73 95 3a 20 49 20  6d 61 6b 65 20 6e 6f 20  |.is.: I make no |
000007e0  77 61 72 72 61 6e 74 79  2c 20 65 78 70 72 65 73  |warranty, expres|
000007f0  73 65 64 20 6f 72 0a 69  6d 70 6c 69 65 64 2c 20  |sed or.implied, |
00000800  6f 66 20 74 68 65 20 6d  65 72 63 68 61 6e 74 61  |of the merchanta|
00000810  62 69 6c 69 74 79 20 6f  66 20 74 68 69 73 20 73  |bility of this s|
00000820  6f 66 74 77 61 72 65 20  6f 72 20 69 74 73 20 9e  |oftware or its .|
00000830  74 6e 65 73 73 20 66 6f  72 20 61 6e 79 0a 70 61  |tness for any.pa|
00000840  72 74 69 63 75 6c 61 72  20 70 75 72 70 6f 73 65  |rticular purpose|
00000850  2e 20 49 6e 20 6e 6f 20  63 69 72 63 75 6d 73 74  |. In no circumst|
00000860  61 6e 63 65 73 20 73 68  61 6c 6c 20 49 20 62 65  |ances shall I be|
00000870  20 6c 69 61 62 6c 65 20  66 6f 72 20 61 6e 79 20  | liable for any |
00000880  64 61 6d 61 67 65 2c 0a  6c 6f 73 73 20 6f 66 20  |damage,.loss of |
00000890  70 72 6f 9e 74 73 2c 20  6f 72 20 61 6e 79 20 69  |pro.ts, or any i|
000008a0  6e 64 69 72 65 63 74 20  6f 72 20 63 6f 6e 73 65  |ndirect or conse|
000008b0  71 75 65 6e 74 69 61 6c  20 6c 6f 73 73 20 61 72  |quential loss ar|
000008c0  69 73 69 6e 67 20 6f 75  74 20 6f 66 20 74 68 65  |ising out of the|
000008d0  20 75 73 65 0a 6f 66 20  74 68 69 73 20 73 6f 66  | use.of this sof|
000008e0  74 77 61 72 65 20 6f 72  20 69 6e 61 62 69 6c 69  |tware or inabili|
000008f0  74 79 20 74 6f 20 75 73  65 20 74 68 69 73 20 73  |ty to use this s|
00000900  6f 66 74 77 61 72 65 2c  20 65 76 65 6e 20 69 66  |oftware, even if|
00000910  20 49 20 68 61 76 65 20  62 65 65 6e 0a 61 64 76  | I have been.adv|
00000920  69 73 65 64 20 6f 66 20  74 68 65 20 70 6f 73 73  |ised of the poss|
00000930  69 62 69 6c 69 74 79 20  6f 66 20 73 75 63 68 20  |ibility of such |
00000940  6c 6f 73 73 2e 0a 0a 20  20 20 49 6e 20 6f 74 68  |loss...   In oth|
00000950  65 72 20 77 6f 72 64 73  2c 20 69 66 20 79 6f 75  |er words, if you|
00000960  72 20 63 6f 6d 70 75 74  65 72 20 63 72 61 73 68  |r computer crash|
00000970  65 73 2c 20 62 6c 6f 77  73 20 75 70 2c 20 79 6f  |es, blows up, yo|
00000980  75 20 6c 6f 73 65 20 61  6c 6c 20 79 6f 75 72 20  |u lose all your |
00000990  77 6f 72 6b 0a 65 74 63  2e 20 61 6c 6c 20 62 65  |work.etc. all be|
000009a0  63 61 75 73 65 20 6f 66  20 21 47 65 6e 42 61 63  |cause of !GenBac|
000009b0  6b 44 72 6f 70 2c 20 64  6f 6e 91 74 20 62 6c 61  |kDrop, don.t bla|
000009c0  6d 65 20 6d 65 2e 0a                              |me me..|
000009c7