Home » Archimedes archive » Acorn User » Acorn User - Updated Shareware Collection (1994).adf » Programs » !Desktop+/!Help

!Desktop+/!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 » Acorn User - Updated Shareware Collection (1994).adf » Programs
Filename: !Desktop+/!Help
Read OK:
File size: 149A bytes
Load address: 0000
Exec address: 0000
File contents
Welcome to the wonderful world of Desktop+ !!!

To find out exactly what +'s it gives to your desktop, run !Desktop+, & !Help from your Apps folder.
Move the pointer over each of Desktop+'s menu entries, & you will be given a few details.

You can find out a bit more by pressing F12 to go to the command line, & typing:
Help Desktop+_Options <Return>

To use the sprite directories/files option, if you need further explanation, take a look at the examples
inside DirSprites.

Note, !Desktop+ includes all C/assembler program/module source code.
If you don't require this, you can reduce the disc space occupied by this program, from 131Kb to 36Kb,
by deleting Makefile & directories c, o, & s.

If you load the module Desktop+ directly from say a boot file, & don't need the !Desktop+ shell, then you
can further reduce disc space from 34Kb to only 6Kb!

Remember also, if you are short of memory, Desktop+ occupies only 6Kb RAM, whereas !Desktop+ uses a further
64k, & can be done without, as the command line can be used to change option settings if you require this
(use eg *Set Desktop+_Options 2_11110 to turn all options on except application solid sprite drags).

The following is taken from Desktop+'s source code:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
See elsewhere for development notes.

See module help text for details of function (nb, best to load module & use *help, as text in source below
 is compacted via use of PrettyPrint dictionary & so isn't easy to read directly), or figure it out 
 yourself from this code & the credits below.

Note: Me (the name I call myself & the author of this gibberish), is Michael Rozdoba
      I can be reached at 10 Octavia Close, Bedlington, Northumberland, NE22 6LG.

IMPORTANT: since this code incorporates some code written by another person (see below), I cannot claim
           copyright on all of this material.
           It may not be freely distributed, & cannot be sold without the other relevant party's consent.
           The copyright holder of the included code is either Paul Dellar (its author), or
           Acorn Computing's publisher (the distributor of that code).

Credits:
~~~~~~~~
Some of the source code from SolidDrag, (Acorn Computing cover disc, June 1993, v11 n4, by Paul Dellar)
 has been used below (after bug fixes), to provide part of the application solid drag code.
  Note, original SolidDrag {before bug fixes}: Source -  10835 bytes,    Module -  896 bytes.
                 Desktop+                      Source -  64977 bytes,    Module - 5308 bytes.

The original inspiration for the approach used throughout this module (SWI traps via the hardware vector,
 & post filters), is also due to Paul Dellar & his original SolidDrag module, for which I am very grateful,
 though I think I may have used these two together in a way which he didn't anticipate.

Forcing applications to use solid drags rather than dashed outlines, is based both on the idea & the code
 of Paul's SolidDrag, though the code has been extended to cope with a wider range of situations, &
 several bugs have been fixed (I hope!).

Solid drags on Filer file icons was entirely my idea, as is the code.
During development I came across a PD application called Filer+ (by Ting Zwei Kuei, April 1993) which
 achieves similar results, though via a direct patch into the original Acorn Filer module.
This served to test Desktop+'s function against, & led me to discover a few shortcoming's which I was then
 able to fix; these include a couple of situations which Filer+ doesn't correctly handle.

Support for semi-transparent solid drags was incorporated after seeing the benefits this can provide, via
 Dave Lawrence's direct DragASprite patch (*Info, BBC Acorn User, July 1993), though I specifically didn't
 read his code (I wouldn't want to be accused of plagiarism), & this implementation is naturally more
 cumbersome to code as it acts via pre & post processing to the DragASprite_Start call, rather than via a
 direct patch.

Use of fancy text (ie antialiased fonts) in filer windows was inspired by Dave Lawrence's minimalist patch,
 thought implementation is entirely different. Also, here, I have been able to correctly set the background
 colour to light grey (rather than having to adopt white), & further, maintain correct font sizes when
 changing modes (eg 12 to 27), which the BAU patch didn't manage.

Lastly, the idea for replacement of the familiar blue folder directory icons, by arbitrary sprites
 (specified via the directory name), is due to Filer+. Though once again, the difference in implementation
 means that the code used to achieve this result share very little in common.

AND FINALLY: Why this module is worth using -
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 It does all the things that the above patches do, & does some of them better (for instance, the fancy
 filer text, & the solid drags of filer icons).
 It integrates them all into one small module, & as it doesn't patch directly into ROM modules, these
 don't need to be copied to RAM (eg this module uses under 6� Kb in total, whereas Filer+ uses over 27Kb
 as it has to copy Filer to RAM).
 Due to the means of implementation, each option can be turned on or off independently, whenever you want.

00000000  0a 57 65 6c 63 6f 6d 65  20 74 6f 20 74 68 65 20  |.Welcome to the |
00000010  77 6f 6e 64 65 72 66 75  6c 20 77 6f 72 6c 64 20  |wonderful world |
00000020  6f 66 20 44 65 73 6b 74  6f 70 2b 20 21 21 21 0a  |of Desktop+ !!!.|
00000030  0a 54 6f 20 66 69 6e 64  20 6f 75 74 20 65 78 61  |.To find out exa|
00000040  63 74 6c 79 20 77 68 61  74 20 2b 27 73 20 69 74  |ctly what +'s it|
00000050  20 67 69 76 65 73 20 74  6f 20 79 6f 75 72 20 64  | gives to your d|
00000060  65 73 6b 74 6f 70 2c 20  72 75 6e 20 21 44 65 73  |esktop, run !Des|
00000070  6b 74 6f 70 2b 2c 20 26  20 21 48 65 6c 70 20 66  |ktop+, & !Help f|
00000080  72 6f 6d 20 79 6f 75 72  20 41 70 70 73 20 66 6f  |rom your Apps fo|
00000090  6c 64 65 72 2e 0a 4d 6f  76 65 20 74 68 65 20 70  |lder..Move the p|
000000a0  6f 69 6e 74 65 72 20 6f  76 65 72 20 65 61 63 68  |ointer over each|
000000b0  20 6f 66 20 44 65 73 6b  74 6f 70 2b 27 73 20 6d  | of Desktop+'s m|
000000c0  65 6e 75 20 65 6e 74 72  69 65 73 2c 20 26 20 79  |enu entries, & y|
000000d0  6f 75 20 77 69 6c 6c 20  62 65 20 67 69 76 65 6e  |ou will be given|
000000e0  20 61 20 66 65 77 20 64  65 74 61 69 6c 73 2e 0a  | a few details..|
000000f0  0a 59 6f 75 20 63 61 6e  20 66 69 6e 64 20 6f 75  |.You can find ou|
00000100  74 20 61 20 62 69 74 20  6d 6f 72 65 20 62 79 20  |t a bit more by |
00000110  70 72 65 73 73 69 6e 67  20 46 31 32 20 74 6f 20  |pressing F12 to |
00000120  67 6f 20 74 6f 20 74 68  65 20 63 6f 6d 6d 61 6e  |go to the comman|
00000130  64 20 6c 69 6e 65 2c 20  26 20 74 79 70 69 6e 67  |d line, & typing|
00000140  3a 0a 48 65 6c 70 20 44  65 73 6b 74 6f 70 2b 5f  |:.Help Desktop+_|
00000150  4f 70 74 69 6f 6e 73 20  3c 52 65 74 75 72 6e 3e  |Options <Return>|
00000160  0a 0a 54 6f 20 75 73 65  20 74 68 65 20 73 70 72  |..To use the spr|
00000170  69 74 65 20 64 69 72 65  63 74 6f 72 69 65 73 2f  |ite directories/|
00000180  66 69 6c 65 73 20 6f 70  74 69 6f 6e 2c 20 69 66  |files option, if|
00000190  20 79 6f 75 20 6e 65 65  64 20 66 75 72 74 68 65  | you need furthe|
000001a0  72 20 65 78 70 6c 61 6e  61 74 69 6f 6e 2c 20 74  |r explanation, t|
000001b0  61 6b 65 20 61 20 6c 6f  6f 6b 20 61 74 20 74 68  |ake a look at th|
000001c0  65 20 65 78 61 6d 70 6c  65 73 0a 69 6e 73 69 64  |e examples.insid|
000001d0  65 20 44 69 72 53 70 72  69 74 65 73 2e 0a 0a 4e  |e DirSprites...N|
000001e0  6f 74 65 2c 20 21 44 65  73 6b 74 6f 70 2b 20 69  |ote, !Desktop+ i|
000001f0  6e 63 6c 75 64 65 73 20  61 6c 6c 20 43 2f 61 73  |ncludes all C/as|
00000200  73 65 6d 62 6c 65 72 20  70 72 6f 67 72 61 6d 2f  |sembler program/|
00000210  6d 6f 64 75 6c 65 20 73  6f 75 72 63 65 20 63 6f  |module source co|
00000220  64 65 2e 0a 49 66 20 79  6f 75 20 64 6f 6e 27 74  |de..If you don't|
00000230  20 72 65 71 75 69 72 65  20 74 68 69 73 2c 20 79  | require this, y|
00000240  6f 75 20 63 61 6e 20 72  65 64 75 63 65 20 74 68  |ou can reduce th|
00000250  65 20 64 69 73 63 20 73  70 61 63 65 20 6f 63 63  |e disc space occ|
00000260  75 70 69 65 64 20 62 79  20 74 68 69 73 20 70 72  |upied by this pr|
00000270  6f 67 72 61 6d 2c 20 66  72 6f 6d 20 31 33 31 4b  |ogram, from 131K|
00000280  62 20 74 6f 20 33 36 4b  62 2c 0a 62 79 20 64 65  |b to 36Kb,.by de|
00000290  6c 65 74 69 6e 67 20 4d  61 6b 65 66 69 6c 65 20  |leting Makefile |
000002a0  26 20 64 69 72 65 63 74  6f 72 69 65 73 20 63 2c  |& directories c,|
000002b0  20 6f 2c 20 26 20 73 2e  0a 0a 49 66 20 79 6f 75  | o, & s...If you|
000002c0  20 6c 6f 61 64 20 74 68  65 20 6d 6f 64 75 6c 65  | load the module|
000002d0  20 44 65 73 6b 74 6f 70  2b 20 64 69 72 65 63 74  | Desktop+ direct|
000002e0  6c 79 20 66 72 6f 6d 20  73 61 79 20 61 20 62 6f  |ly from say a bo|
000002f0  6f 74 20 66 69 6c 65 2c  20 26 20 64 6f 6e 27 74  |ot file, & don't|
00000300  20 6e 65 65 64 20 74 68  65 20 21 44 65 73 6b 74  | need the !Deskt|
00000310  6f 70 2b 20 73 68 65 6c  6c 2c 20 74 68 65 6e 20  |op+ shell, then |
00000320  79 6f 75 0a 63 61 6e 20  66 75 72 74 68 65 72 20  |you.can further |
00000330  72 65 64 75 63 65 20 64  69 73 63 20 73 70 61 63  |reduce disc spac|
00000340  65 20 66 72 6f 6d 20 33  34 4b 62 20 74 6f 20 6f  |e from 34Kb to o|
00000350  6e 6c 79 20 36 4b 62 21  0a 0a 52 65 6d 65 6d 62  |nly 6Kb!..Rememb|
00000360  65 72 20 61 6c 73 6f 2c  20 69 66 20 79 6f 75 20  |er also, if you |
00000370  61 72 65 20 73 68 6f 72  74 20 6f 66 20 6d 65 6d  |are short of mem|
00000380  6f 72 79 2c 20 44 65 73  6b 74 6f 70 2b 20 6f 63  |ory, Desktop+ oc|
00000390  63 75 70 69 65 73 20 6f  6e 6c 79 20 36 4b 62 20  |cupies only 6Kb |
000003a0  52 41 4d 2c 20 77 68 65  72 65 61 73 20 21 44 65  |RAM, whereas !De|
000003b0  73 6b 74 6f 70 2b 20 75  73 65 73 20 61 20 66 75  |sktop+ uses a fu|
000003c0  72 74 68 65 72 0a 36 34  6b 2c 20 26 20 63 61 6e  |rther.64k, & can|
000003d0  20 62 65 20 64 6f 6e 65  20 77 69 74 68 6f 75 74  | be done without|
000003e0  2c 20 61 73 20 74 68 65  20 63 6f 6d 6d 61 6e 64  |, as the command|
000003f0  20 6c 69 6e 65 20 63 61  6e 20 62 65 20 75 73 65  | line can be use|
00000400  64 20 74 6f 20 63 68 61  6e 67 65 20 6f 70 74 69  |d to change opti|
00000410  6f 6e 20 73 65 74 74 69  6e 67 73 20 69 66 20 79  |on settings if y|
00000420  6f 75 20 72 65 71 75 69  72 65 20 74 68 69 73 0a  |ou require this.|
00000430  28 75 73 65 20 65 67 20  2a 53 65 74 20 44 65 73  |(use eg *Set Des|
00000440  6b 74 6f 70 2b 5f 4f 70  74 69 6f 6e 73 20 32 5f  |ktop+_Options 2_|
00000450  31 31 31 31 30 20 74 6f  20 74 75 72 6e 20 61 6c  |11110 to turn al|
00000460  6c 20 6f 70 74 69 6f 6e  73 20 6f 6e 20 65 78 63  |l options on exc|
00000470  65 70 74 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |ept application |
00000480  73 6f 6c 69 64 20 73 70  72 69 74 65 20 64 72 61  |solid sprite dra|
00000490  67 73 29 2e 0a 0a 54 68  65 20 66 6f 6c 6c 6f 77  |gs)...The follow|
000004a0  69 6e 67 20 69 73 20 74  61 6b 65 6e 20 66 72 6f  |ing is taken fro|
000004b0  6d 20 44 65 73 6b 74 6f  70 2b 27 73 20 73 6f 75  |m Desktop+'s sou|
000004c0  72 63 65 20 63 6f 64 65  3a 0a 7e 7e 7e 7e 7e 7e  |rce code:.~~~~~~|
000004d0  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
*
000004f0  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 0a 53 65  |~~~~~~~~~~~~~.Se|
00000500  65 20 65 6c 73 65 77 68  65 72 65 20 66 6f 72 20  |e elsewhere for |
00000510  64 65 76 65 6c 6f 70 6d  65 6e 74 20 6e 6f 74 65  |development note|
00000520  73 2e 0a 0a 53 65 65 20  6d 6f 64 75 6c 65 20 68  |s...See module h|
00000530  65 6c 70 20 74 65 78 74  20 66 6f 72 20 64 65 74  |elp text for det|
00000540  61 69 6c 73 20 6f 66 20  66 75 6e 63 74 69 6f 6e  |ails of function|
00000550  20 28 6e 62 2c 20 62 65  73 74 20 74 6f 20 6c 6f  | (nb, best to lo|
00000560  61 64 20 6d 6f 64 75 6c  65 20 26 20 75 73 65 20  |ad module & use |
00000570  2a 68 65 6c 70 2c 20 61  73 20 74 65 78 74 20 69  |*help, as text i|
00000580  6e 20 73 6f 75 72 63 65  20 62 65 6c 6f 77 0a 20  |n source below. |
00000590  69 73 20 63 6f 6d 70 61  63 74 65 64 20 76 69 61  |is compacted via|
000005a0  20 75 73 65 20 6f 66 20  50 72 65 74 74 79 50 72  | use of PrettyPr|
000005b0  69 6e 74 20 64 69 63 74  69 6f 6e 61 72 79 20 26  |int dictionary &|
000005c0  20 73 6f 20 69 73 6e 27  74 20 65 61 73 79 20 74  | so isn't easy t|
000005d0  6f 20 72 65 61 64 20 64  69 72 65 63 74 6c 79 29  |o read directly)|
000005e0  2c 20 6f 72 20 66 69 67  75 72 65 20 69 74 20 6f  |, or figure it o|
000005f0  75 74 20 0a 20 79 6f 75  72 73 65 6c 66 20 66 72  |ut . yourself fr|
00000600  6f 6d 20 74 68 69 73 20  63 6f 64 65 20 26 20 74  |om this code & t|
00000610  68 65 20 63 72 65 64 69  74 73 20 62 65 6c 6f 77  |he credits below|
00000620  2e 0a 0a 4e 6f 74 65 3a  20 4d 65 20 28 74 68 65  |...Note: Me (the|
00000630  20 6e 61 6d 65 20 49 20  63 61 6c 6c 20 6d 79 73  | name I call mys|
00000640  65 6c 66 20 26 20 74 68  65 20 61 75 74 68 6f 72  |elf & the author|
00000650  20 6f 66 20 74 68 69 73  20 67 69 62 62 65 72 69  | of this gibberi|
00000660  73 68 29 2c 20 69 73 20  4d 69 63 68 61 65 6c 20  |sh), is Michael |
00000670  52 6f 7a 64 6f 62 61 0a  20 20 20 20 20 20 49 20  |Rozdoba.      I |
00000680  63 61 6e 20 62 65 20 72  65 61 63 68 65 64 20 61  |can be reached a|
00000690  74 20 31 30 20 4f 63 74  61 76 69 61 20 43 6c 6f  |t 10 Octavia Clo|
000006a0  73 65 2c 20 42 65 64 6c  69 6e 67 74 6f 6e 2c 20  |se, Bedlington, |
000006b0  4e 6f 72 74 68 75 6d 62  65 72 6c 61 6e 64 2c 20  |Northumberland, |
000006c0  4e 45 32 32 20 36 4c 47  2e 0a 0a 49 4d 50 4f 52  |NE22 6LG...IMPOR|
000006d0  54 41 4e 54 3a 20 73 69  6e 63 65 20 74 68 69 73  |TANT: since this|
000006e0  20 63 6f 64 65 20 69 6e  63 6f 72 70 6f 72 61 74  | code incorporat|
000006f0  65 73 20 73 6f 6d 65 20  63 6f 64 65 20 77 72 69  |es some code wri|
00000700  74 74 65 6e 20 62 79 20  61 6e 6f 74 68 65 72 20  |tten by another |
00000710  70 65 72 73 6f 6e 20 28  73 65 65 20 62 65 6c 6f  |person (see belo|
00000720  77 29 2c 20 49 20 63 61  6e 6e 6f 74 20 63 6c 61  |w), I cannot cla|
00000730  69 6d 0a 20 20 20 20 20  20 20 20 20 20 20 63 6f  |im.           co|
00000740  70 79 72 69 67 68 74 20  6f 6e 20 61 6c 6c 20 6f  |pyright on all o|
00000750  66 20 74 68 69 73 20 6d  61 74 65 72 69 61 6c 2e  |f this material.|
00000760  0a 20 20 20 20 20 20 20  20 20 20 20 49 74 20 6d  |.           It m|
00000770  61 79 20 6e 6f 74 20 62  65 20 66 72 65 65 6c 79  |ay not be freely|
00000780  20 64 69 73 74 72 69 62  75 74 65 64 2c 20 26 20  | distributed, & |
00000790  63 61 6e 6e 6f 74 20 62  65 20 73 6f 6c 64 20 77  |cannot be sold w|
000007a0  69 74 68 6f 75 74 20 74  68 65 20 6f 74 68 65 72  |ithout the other|
000007b0  20 72 65 6c 65 76 61 6e  74 20 70 61 72 74 79 27  | relevant party'|
000007c0  73 20 63 6f 6e 73 65 6e  74 2e 0a 20 20 20 20 20  |s consent..     |
000007d0  20 20 20 20 20 20 54 68  65 20 63 6f 70 79 72 69  |      The copyri|
000007e0  67 68 74 20 68 6f 6c 64  65 72 20 6f 66 20 74 68  |ght holder of th|
000007f0  65 20 69 6e 63 6c 75 64  65 64 20 63 6f 64 65 20  |e included code |
00000800  69 73 20 65 69 74 68 65  72 20 50 61 75 6c 20 44  |is either Paul D|
00000810  65 6c 6c 61 72 20 28 69  74 73 20 61 75 74 68 6f  |ellar (its autho|
00000820  72 29 2c 20 6f 72 0a 20  20 20 20 20 20 20 20 20  |r), or.         |
00000830  20 20 41 63 6f 72 6e 20  43 6f 6d 70 75 74 69 6e  |  Acorn Computin|
00000840  67 27 73 20 70 75 62 6c  69 73 68 65 72 20 28 74  |g's publisher (t|
00000850  68 65 20 64 69 73 74 72  69 62 75 74 6f 72 20 6f  |he distributor o|
00000860  66 20 74 68 61 74 20 63  6f 64 65 29 2e 0a 0a 43  |f that code)...C|
00000870  72 65 64 69 74 73 3a 0a  7e 7e 7e 7e 7e 7e 7e 7e  |redits:.~~~~~~~~|
00000880  0a 53 6f 6d 65 20 6f 66  20 74 68 65 20 73 6f 75  |.Some of the sou|
00000890  72 63 65 20 63 6f 64 65  20 66 72 6f 6d 20 53 6f  |rce code from So|
000008a0  6c 69 64 44 72 61 67 2c  20 28 41 63 6f 72 6e 20  |lidDrag, (Acorn |
000008b0  43 6f 6d 70 75 74 69 6e  67 20 63 6f 76 65 72 20  |Computing cover |
000008c0  64 69 73 63 2c 20 4a 75  6e 65 20 31 39 39 33 2c  |disc, June 1993,|
000008d0  20 76 31 31 20 6e 34 2c  20 62 79 20 50 61 75 6c  | v11 n4, by Paul|
000008e0  20 44 65 6c 6c 61 72 29  0a 20 68 61 73 20 62 65  | Dellar). has be|
000008f0  65 6e 20 75 73 65 64 20  62 65 6c 6f 77 20 28 61  |en used below (a|
00000900  66 74 65 72 20 62 75 67  20 66 69 78 65 73 29 2c  |fter bug fixes),|
00000910  20 74 6f 20 70 72 6f 76  69 64 65 20 70 61 72 74  | to provide part|
00000920  20 6f 66 20 74 68 65 20  61 70 70 6c 69 63 61 74  | of the applicat|
00000930  69 6f 6e 20 73 6f 6c 69  64 20 64 72 61 67 20 63  |ion solid drag c|
00000940  6f 64 65 2e 0a 20 20 4e  6f 74 65 2c 20 6f 72 69  |ode..  Note, ori|
00000950  67 69 6e 61 6c 20 53 6f  6c 69 64 44 72 61 67 20  |ginal SolidDrag |
00000960  7b 62 65 66 6f 72 65 20  62 75 67 20 66 69 78 65  |{before bug fixe|
00000970  73 7d 3a 20 53 6f 75 72  63 65 20 2d 20 20 31 30  |s}: Source -  10|
00000980  38 33 35 20 62 79 74 65  73 2c 20 20 20 20 4d 6f  |835 bytes,    Mo|
00000990  64 75 6c 65 20 2d 20 20  38 39 36 20 62 79 74 65  |dule -  896 byte|
000009a0  73 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |s..             |
000009b0  20 20 20 20 44 65 73 6b  74 6f 70 2b 20 20 20 20  |    Desktop+    |
000009c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000009d0  20 20 53 6f 75 72 63 65  20 2d 20 20 36 34 39 37  |  Source -  6497|
000009e0  37 20 62 79 74 65 73 2c  20 20 20 20 4d 6f 64 75  |7 bytes,    Modu|
000009f0  6c 65 20 2d 20 35 33 30  38 20 62 79 74 65 73 2e  |le - 5308 bytes.|
00000a00  0a 0a 54 68 65 20 6f 72  69 67 69 6e 61 6c 20 69  |..The original i|
00000a10  6e 73 70 69 72 61 74 69  6f 6e 20 66 6f 72 20 74  |nspiration for t|
00000a20  68 65 20 61 70 70 72 6f  61 63 68 20 75 73 65 64  |he approach used|
00000a30  20 74 68 72 6f 75 67 68  6f 75 74 20 74 68 69 73  | throughout this|
00000a40  20 6d 6f 64 75 6c 65 20  28 53 57 49 20 74 72 61  | module (SWI tra|
00000a50  70 73 20 76 69 61 20 74  68 65 20 68 61 72 64 77  |ps via the hardw|
00000a60  61 72 65 20 76 65 63 74  6f 72 2c 0a 20 26 20 70  |are vector,. & p|
00000a70  6f 73 74 20 66 69 6c 74  65 72 73 29 2c 20 69 73  |ost filters), is|
00000a80  20 61 6c 73 6f 20 64 75  65 20 74 6f 20 50 61 75  | also due to Pau|
00000a90  6c 20 44 65 6c 6c 61 72  20 26 20 68 69 73 20 6f  |l Dellar & his o|
00000aa0  72 69 67 69 6e 61 6c 20  53 6f 6c 69 64 44 72 61  |riginal SolidDra|
00000ab0  67 20 6d 6f 64 75 6c 65  2c 20 66 6f 72 20 77 68  |g module, for wh|
00000ac0  69 63 68 20 49 20 61 6d  20 76 65 72 79 20 67 72  |ich I am very gr|
00000ad0  61 74 65 66 75 6c 2c 0a  20 74 68 6f 75 67 68 20  |ateful,. though |
00000ae0  49 20 74 68 69 6e 6b 20  49 20 6d 61 79 20 68 61  |I think I may ha|
00000af0  76 65 20 75 73 65 64 20  74 68 65 73 65 20 74 77  |ve used these tw|
00000b00  6f 20 74 6f 67 65 74 68  65 72 20 69 6e 20 61 20  |o together in a |
00000b10  77 61 79 20 77 68 69 63  68 20 68 65 20 64 69 64  |way which he did|
00000b20  6e 27 74 20 61 6e 74 69  63 69 70 61 74 65 2e 0a  |n't anticipate..|
00000b30  0a 46 6f 72 63 69 6e 67  20 61 70 70 6c 69 63 61  |.Forcing applica|
00000b40  74 69 6f 6e 73 20 74 6f  20 75 73 65 20 73 6f 6c  |tions to use sol|
00000b50  69 64 20 64 72 61 67 73  20 72 61 74 68 65 72 20  |id drags rather |
00000b60  74 68 61 6e 20 64 61 73  68 65 64 20 6f 75 74 6c  |than dashed outl|
00000b70  69 6e 65 73 2c 20 69 73  20 62 61 73 65 64 20 62  |ines, is based b|
00000b80  6f 74 68 20 6f 6e 20 74  68 65 20 69 64 65 61 20  |oth on the idea |
00000b90  26 20 74 68 65 20 63 6f  64 65 0a 20 6f 66 20 50  |& the code. of P|
00000ba0  61 75 6c 27 73 20 53 6f  6c 69 64 44 72 61 67 2c  |aul's SolidDrag,|
00000bb0  20 74 68 6f 75 67 68 20  74 68 65 20 63 6f 64 65  | though the code|
00000bc0  20 68 61 73 20 62 65 65  6e 20 65 78 74 65 6e 64  | has been extend|
00000bd0  65 64 20 74 6f 20 63 6f  70 65 20 77 69 74 68 20  |ed to cope with |
00000be0  61 20 77 69 64 65 72 20  72 61 6e 67 65 20 6f 66  |a wider range of|
00000bf0  20 73 69 74 75 61 74 69  6f 6e 73 2c 20 26 0a 20  | situations, &. |
00000c00  73 65 76 65 72 61 6c 20  62 75 67 73 20 68 61 76  |several bugs hav|
00000c10  65 20 62 65 65 6e 20 66  69 78 65 64 20 28 49 20  |e been fixed (I |
00000c20  68 6f 70 65 21 29 2e 0a  0a 53 6f 6c 69 64 20 64  |hope!)...Solid d|
00000c30  72 61 67 73 20 6f 6e 20  46 69 6c 65 72 20 66 69  |rags on Filer fi|
00000c40  6c 65 20 69 63 6f 6e 73  20 77 61 73 20 65 6e 74  |le icons was ent|
00000c50  69 72 65 6c 79 20 6d 79  20 69 64 65 61 2c 20 61  |irely my idea, a|
00000c60  73 20 69 73 20 74 68 65  20 63 6f 64 65 2e 0a 44  |s is the code..D|
00000c70  75 72 69 6e 67 20 64 65  76 65 6c 6f 70 6d 65 6e  |uring developmen|
00000c80  74 20 49 20 63 61 6d 65  20 61 63 72 6f 73 73 20  |t I came across |
00000c90  61 20 50 44 20 61 70 70  6c 69 63 61 74 69 6f 6e  |a PD application|
00000ca0  20 63 61 6c 6c 65 64 20  46 69 6c 65 72 2b 20 28  | called Filer+ (|
00000cb0  62 79 20 54 69 6e 67 20  5a 77 65 69 20 4b 75 65  |by Ting Zwei Kue|
00000cc0  69 2c 20 41 70 72 69 6c  20 31 39 39 33 29 20 77  |i, April 1993) w|
00000cd0  68 69 63 68 0a 20 61 63  68 69 65 76 65 73 20 73  |hich. achieves s|
00000ce0  69 6d 69 6c 61 72 20 72  65 73 75 6c 74 73 2c 20  |imilar results, |
00000cf0  74 68 6f 75 67 68 20 76  69 61 20 61 20 64 69 72  |though via a dir|
00000d00  65 63 74 20 70 61 74 63  68 20 69 6e 74 6f 20 74  |ect patch into t|
00000d10  68 65 20 6f 72 69 67 69  6e 61 6c 20 41 63 6f 72  |he original Acor|
00000d20  6e 20 46 69 6c 65 72 20  6d 6f 64 75 6c 65 2e 0a  |n Filer module..|
00000d30  54 68 69 73 20 73 65 72  76 65 64 20 74 6f 20 74  |This served to t|
00000d40  65 73 74 20 44 65 73 6b  74 6f 70 2b 27 73 20 66  |est Desktop+'s f|
00000d50  75 6e 63 74 69 6f 6e 20  61 67 61 69 6e 73 74 2c  |unction against,|
00000d60  20 26 20 6c 65 64 20 6d  65 20 74 6f 20 64 69 73  | & led me to dis|
00000d70  63 6f 76 65 72 20 61 20  66 65 77 20 73 68 6f 72  |cover a few shor|
00000d80  74 63 6f 6d 69 6e 67 27  73 20 77 68 69 63 68 20  |tcoming's which |
00000d90  49 20 77 61 73 20 74 68  65 6e 0a 20 61 62 6c 65  |I was then. able|
00000da0  20 74 6f 20 66 69 78 3b  20 74 68 65 73 65 20 69  | to fix; these i|
00000db0  6e 63 6c 75 64 65 20 61  20 63 6f 75 70 6c 65 20  |nclude a couple |
00000dc0  6f 66 20 73 69 74 75 61  74 69 6f 6e 73 20 77 68  |of situations wh|
00000dd0  69 63 68 20 46 69 6c 65  72 2b 20 64 6f 65 73 6e  |ich Filer+ doesn|
00000de0  27 74 20 63 6f 72 72 65  63 74 6c 79 20 68 61 6e  |'t correctly han|
00000df0  64 6c 65 2e 0a 0a 53 75  70 70 6f 72 74 20 66 6f  |dle...Support fo|
00000e00  72 20 73 65 6d 69 2d 74  72 61 6e 73 70 61 72 65  |r semi-transpare|
00000e10  6e 74 20 73 6f 6c 69 64  20 64 72 61 67 73 20 77  |nt solid drags w|
00000e20  61 73 20 69 6e 63 6f 72  70 6f 72 61 74 65 64 20  |as incorporated |
00000e30  61 66 74 65 72 20 73 65  65 69 6e 67 20 74 68 65  |after seeing the|
00000e40  20 62 65 6e 65 66 69 74  73 20 74 68 69 73 20 63  | benefits this c|
00000e50  61 6e 20 70 72 6f 76 69  64 65 2c 20 76 69 61 0a  |an provide, via.|
00000e60  20 44 61 76 65 20 4c 61  77 72 65 6e 63 65 27 73  | Dave Lawrence's|
00000e70  20 64 69 72 65 63 74 20  44 72 61 67 41 53 70 72  | direct DragASpr|
00000e80  69 74 65 20 70 61 74 63  68 20 28 2a 49 6e 66 6f  |ite patch (*Info|
00000e90  2c 20 42 42 43 20 41 63  6f 72 6e 20 55 73 65 72  |, BBC Acorn User|
00000ea0  2c 20 4a 75 6c 79 20 31  39 39 33 29 2c 20 74 68  |, July 1993), th|
00000eb0  6f 75 67 68 20 49 20 73  70 65 63 69 66 69 63 61  |ough I specifica|
00000ec0  6c 6c 79 20 64 69 64 6e  27 74 0a 20 72 65 61 64  |lly didn't. read|
00000ed0  20 68 69 73 20 63 6f 64  65 20 28 49 20 77 6f 75  | his code (I wou|
00000ee0  6c 64 6e 27 74 20 77 61  6e 74 20 74 6f 20 62 65  |ldn't want to be|
00000ef0  20 61 63 63 75 73 65 64  20 6f 66 20 70 6c 61 67  | accused of plag|
00000f00  69 61 72 69 73 6d 29 2c  20 26 20 74 68 69 73 20  |iarism), & this |
00000f10  69 6d 70 6c 65 6d 65 6e  74 61 74 69 6f 6e 20 69  |implementation i|
00000f20  73 20 6e 61 74 75 72 61  6c 6c 79 20 6d 6f 72 65  |s naturally more|
00000f30  0a 20 63 75 6d 62 65 72  73 6f 6d 65 20 74 6f 20  |. cumbersome to |
00000f40  63 6f 64 65 20 61 73 20  69 74 20 61 63 74 73 20  |code as it acts |
00000f50  76 69 61 20 70 72 65 20  26 20 70 6f 73 74 20 70  |via pre & post p|
00000f60  72 6f 63 65 73 73 69 6e  67 20 74 6f 20 74 68 65  |rocessing to the|
00000f70  20 44 72 61 67 41 53 70  72 69 74 65 5f 53 74 61  | DragASprite_Sta|
00000f80  72 74 20 63 61 6c 6c 2c  20 72 61 74 68 65 72 20  |rt call, rather |
00000f90  74 68 61 6e 20 76 69 61  20 61 0a 20 64 69 72 65  |than via a. dire|
00000fa0  63 74 20 70 61 74 63 68  2e 0a 0a 55 73 65 20 6f  |ct patch...Use o|
00000fb0  66 20 66 61 6e 63 79 20  74 65 78 74 20 28 69 65  |f fancy text (ie|
00000fc0  20 61 6e 74 69 61 6c 69  61 73 65 64 20 66 6f 6e  | antialiased fon|
00000fd0  74 73 29 20 69 6e 20 66  69 6c 65 72 20 77 69 6e  |ts) in filer win|
00000fe0  64 6f 77 73 20 77 61 73  20 69 6e 73 70 69 72 65  |dows was inspire|
00000ff0  64 20 62 79 20 44 61 76  65 20 4c 61 77 72 65 6e  |d by Dave Lawren|
00001000  63 65 27 73 20 6d 69 6e  69 6d 61 6c 69 73 74 20  |ce's minimalist |
00001010  70 61 74 63 68 2c 0a 20  74 68 6f 75 67 68 74 20  |patch,. thought |
00001020  69 6d 70 6c 65 6d 65 6e  74 61 74 69 6f 6e 20 69  |implementation i|
00001030  73 20 65 6e 74 69 72 65  6c 79 20 64 69 66 66 65  |s entirely diffe|
00001040  72 65 6e 74 2e 20 41 6c  73 6f 2c 20 68 65 72 65  |rent. Also, here|
00001050  2c 20 49 20 68 61 76 65  20 62 65 65 6e 20 61 62  |, I have been ab|
00001060  6c 65 20 74 6f 20 63 6f  72 72 65 63 74 6c 79 20  |le to correctly |
00001070  73 65 74 20 74 68 65 20  62 61 63 6b 67 72 6f 75  |set the backgrou|
00001080  6e 64 0a 20 63 6f 6c 6f  75 72 20 74 6f 20 6c 69  |nd. colour to li|
00001090  67 68 74 20 67 72 65 79  20 28 72 61 74 68 65 72  |ght grey (rather|
000010a0  20 74 68 61 6e 20 68 61  76 69 6e 67 20 74 6f 20  | than having to |
000010b0  61 64 6f 70 74 20 77 68  69 74 65 29 2c 20 26 20  |adopt white), & |
000010c0  66 75 72 74 68 65 72 2c  20 6d 61 69 6e 74 61 69  |further, maintai|
000010d0  6e 20 63 6f 72 72 65 63  74 20 66 6f 6e 74 20 73  |n correct font s|
000010e0  69 7a 65 73 20 77 68 65  6e 0a 20 63 68 61 6e 67  |izes when. chang|
000010f0  69 6e 67 20 6d 6f 64 65  73 20 28 65 67 20 31 32  |ing modes (eg 12|
00001100  20 74 6f 20 32 37 29 2c  20 77 68 69 63 68 20 74  | to 27), which t|
00001110  68 65 20 42 41 55 20 70  61 74 63 68 20 64 69 64  |he BAU patch did|
00001120  6e 27 74 20 6d 61 6e 61  67 65 2e 0a 0a 4c 61 73  |n't manage...Las|
00001130  74 6c 79 2c 20 74 68 65  20 69 64 65 61 20 66 6f  |tly, the idea fo|
00001140  72 20 72 65 70 6c 61 63  65 6d 65 6e 74 20 6f 66  |r replacement of|
00001150  20 74 68 65 20 66 61 6d  69 6c 69 61 72 20 62 6c  | the familiar bl|
00001160  75 65 20 66 6f 6c 64 65  72 20 64 69 72 65 63 74  |ue folder direct|
00001170  6f 72 79 20 69 63 6f 6e  73 2c 20 62 79 20 61 72  |ory icons, by ar|
00001180  62 69 74 72 61 72 79 20  73 70 72 69 74 65 73 0a  |bitrary sprites.|
00001190  20 28 73 70 65 63 69 66  69 65 64 20 76 69 61 20  | (specified via |
000011a0  74 68 65 20 64 69 72 65  63 74 6f 72 79 20 6e 61  |the directory na|
000011b0  6d 65 29 2c 20 69 73 20  64 75 65 20 74 6f 20 46  |me), is due to F|
000011c0  69 6c 65 72 2b 2e 20 54  68 6f 75 67 68 20 6f 6e  |iler+. Though on|
000011d0  63 65 20 61 67 61 69 6e  2c 20 74 68 65 20 64 69  |ce again, the di|
000011e0  66 66 65 72 65 6e 63 65  20 69 6e 20 69 6d 70 6c  |fference in impl|
000011f0  65 6d 65 6e 74 61 74 69  6f 6e 0a 20 6d 65 61 6e  |ementation. mean|
00001200  73 20 74 68 61 74 20 74  68 65 20 63 6f 64 65 20  |s that the code |
00001210  75 73 65 64 20 74 6f 20  61 63 68 69 65 76 65 20  |used to achieve |
00001220  74 68 69 73 20 72 65 73  75 6c 74 20 73 68 61 72  |this result shar|
00001230  65 20 76 65 72 79 20 6c  69 74 74 6c 65 20 69 6e  |e very little in|
00001240  20 63 6f 6d 6d 6f 6e 2e  0a 0a 41 4e 44 20 46 49  | common...AND FI|
00001250  4e 41 4c 4c 59 3a 20 57  68 79 20 74 68 69 73 20  |NALLY: Why this |
00001260  6d 6f 64 75 6c 65 20 69  73 20 77 6f 72 74 68 20  |module is worth |
00001270  75 73 69 6e 67 20 2d 0a  7e 7e 7e 7e 7e 7e 7e 7e  |using -.~~~~~~~~|
00001280  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
*
000012a0  7e 7e 7e 7e 7e 0a 20 49  74 20 64 6f 65 73 20 61  |~~~~~. It does a|
000012b0  6c 6c 20 74 68 65 20 74  68 69 6e 67 73 20 74 68  |ll the things th|
000012c0  61 74 20 74 68 65 20 61  62 6f 76 65 20 70 61 74  |at the above pat|
000012d0  63 68 65 73 20 64 6f 2c  20 26 20 64 6f 65 73 20  |ches do, & does |
000012e0  73 6f 6d 65 20 6f 66 20  74 68 65 6d 20 62 65 74  |some of them bet|
000012f0  74 65 72 20 28 66 6f 72  20 69 6e 73 74 61 6e 63  |ter (for instanc|
00001300  65 2c 20 74 68 65 20 66  61 6e 63 79 0a 20 66 69  |e, the fancy. fi|
00001310  6c 65 72 20 74 65 78 74  2c 20 26 20 74 68 65 20  |ler text, & the |
00001320  73 6f 6c 69 64 20 64 72  61 67 73 20 6f 66 20 66  |solid drags of f|
00001330  69 6c 65 72 20 69 63 6f  6e 73 29 2e 0a 20 49 74  |iler icons).. It|
00001340  20 69 6e 74 65 67 72 61  74 65 73 20 74 68 65 6d  | integrates them|
00001350  20 61 6c 6c 20 69 6e 74  6f 20 6f 6e 65 20 73 6d  | all into one sm|
00001360  61 6c 6c 20 6d 6f 64 75  6c 65 2c 20 26 20 61 73  |all module, & as|
00001370  20 69 74 20 64 6f 65 73  6e 27 74 20 70 61 74 63  | it doesn't patc|
00001380  68 20 64 69 72 65 63 74  6c 79 20 69 6e 74 6f 20  |h directly into |
00001390  52 4f 4d 20 6d 6f 64 75  6c 65 73 2c 20 74 68 65  |ROM modules, the|
000013a0  73 65 0a 20 64 6f 6e 27  74 20 6e 65 65 64 20 74  |se. don't need t|
000013b0  6f 20 62 65 20 63 6f 70  69 65 64 20 74 6f 20 52  |o be copied to R|
000013c0  41 4d 20 28 65 67 20 74  68 69 73 20 6d 6f 64 75  |AM (eg this modu|
000013d0  6c 65 20 75 73 65 73 20  75 6e 64 65 72 20 36 bd  |le uses under 6.|
000013e0  20 4b 62 20 69 6e 20 74  6f 74 61 6c 2c 20 77 68  | Kb in total, wh|
000013f0  65 72 65 61 73 20 46 69  6c 65 72 2b 20 75 73 65  |ereas Filer+ use|
00001400  73 20 6f 76 65 72 20 32  37 4b 62 0a 20 61 73 20  |s over 27Kb. as |
00001410  69 74 20 68 61 73 20 74  6f 20 63 6f 70 79 20 46  |it has to copy F|
00001420  69 6c 65 72 20 74 6f 20  52 41 4d 29 2e 0a 20 44  |iler to RAM).. D|
00001430  75 65 20 74 6f 20 74 68  65 20 6d 65 61 6e 73 20  |ue to the means |
00001440  6f 66 20 69 6d 70 6c 65  6d 65 6e 74 61 74 69 6f  |of implementatio|
00001450  6e 2c 20 65 61 63 68 20  6f 70 74 69 6f 6e 20 63  |n, each option c|
00001460  61 6e 20 62 65 20 74 75  72 6e 65 64 20 6f 6e 20  |an be turned on |
00001470  6f 72 20 6f 66 66 20 69  6e 64 65 70 65 6e 64 65  |or off independe|
00001480  6e 74 6c 79 2c 20 77 68  65 6e 65 76 65 72 20 79  |ntly, whenever y|
00001490  6f 75 20 77 61 6e 74 2e  0a 0a                    |ou want...|
0000149a