Home » Archimedes archive » Acorn Computing » 1994 11.adf » 9411 » TechForum/Waster/ReadMe
TechForum/Waster/ReadMe
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 Computing » 1994 11.adf » 9411 |
| Filename: | TechForum/Waster/ReadMe |
| Read OK: | ✔ |
| File size: | 060D bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
Waster is a simple application intended to remove lefthand wastage from sprites in both sprite & draw files. In the latter, sprites may be embedded as either scaled sprite objects (type 5), or transformed sprite objects (type 13). Waster was written to help workaround a bug in RISC OS 3's transformed sprite plotting call. This will fail to correctly render sprites if they have any lefthand wastage. Possible trouble areas include use of sprites, & draw files containing sprites, as graphics within DTP documents. To avoid any problems, ensure all sprites have no wastage. See TechForum in the magazine for further details. Note, waster overwrites any files it is given which require modification, with the corrected version. So, just in case there are any bugs in waster, if important, keep back up copies of your old files until you are satisfied that the modified versions are safe. Waster is command line driven. You can use it by copying the directory Waster.cmdline from the cover disc to a writable medium. Place your files into cmdline, then run ClickMe to set the current directory, go to the command line & enter: waster <filename> <return> to process the named file. This is a little cumbersome in the GUI desktop, so I�ve also provided a desktop shell to drive it - !Waster. Unfortunately, you�ll need to have a copy of Acorn�s FrontEnd & DDEUtils modules in your !System resources, in order to use this. These are supplied as part of Acorn�s DDE � desktop development environment � with both Desktop Assembler & Desktop C.
00000000 0a 57 61 73 74 65 72 20 69 73 20 61 20 73 69 6d |.Waster is a sim| 00000010 70 6c 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 |ple application | 00000020 69 6e 74 65 6e 64 65 64 20 74 6f 20 72 65 6d 6f |intended to remo| 00000030 76 65 20 6c 65 66 74 68 61 6e 64 20 77 61 73 74 |ve lefthand wast| 00000040 61 67 65 0a 66 72 6f 6d 20 73 70 72 69 74 65 73 |age.from sprites| 00000050 20 69 6e 20 62 6f 74 68 20 73 70 72 69 74 65 20 | in both sprite | 00000060 26 20 64 72 61 77 20 66 69 6c 65 73 2e 20 49 6e |& draw files. In| 00000070 20 74 68 65 20 6c 61 74 74 65 72 2c 20 73 70 72 | the latter, spr| 00000080 69 74 65 73 20 6d 61 79 0a 62 65 20 65 6d 62 65 |ites may.be embe| 00000090 64 64 65 64 20 61 73 20 65 69 74 68 65 72 20 73 |dded as either s| 000000a0 63 61 6c 65 64 20 73 70 72 69 74 65 20 6f 62 6a |caled sprite obj| 000000b0 65 63 74 73 20 28 74 79 70 65 20 35 29 2c 20 6f |ects (type 5), o| 000000c0 72 20 74 72 61 6e 73 66 6f 72 6d 65 64 0a 73 70 |r transformed.sp| 000000d0 72 69 74 65 20 6f 62 6a 65 63 74 73 20 28 74 79 |rite objects (ty| 000000e0 70 65 20 31 33 29 2e 0a 0a 57 61 73 74 65 72 20 |pe 13)...Waster | 000000f0 77 61 73 20 77 72 69 74 74 65 6e 20 74 6f 20 68 |was written to h| 00000100 65 6c 70 20 77 6f 72 6b 61 72 6f 75 6e 64 20 61 |elp workaround a| 00000110 20 62 75 67 20 69 6e 20 52 49 53 43 20 4f 53 20 | bug in RISC OS | 00000120 33 27 73 20 74 72 61 6e 73 66 6f 72 6d 65 64 0a |3's transformed.| 00000130 73 70 72 69 74 65 20 70 6c 6f 74 74 69 6e 67 20 |sprite plotting | 00000140 63 61 6c 6c 2e 20 54 68 69 73 20 77 69 6c 6c 20 |call. This will | 00000150 66 61 69 6c 20 74 6f 20 63 6f 72 72 65 63 74 6c |fail to correctl| 00000160 79 20 72 65 6e 64 65 72 20 73 70 72 69 74 65 73 |y render sprites| 00000170 20 69 66 0a 74 68 65 79 20 68 61 76 65 20 61 6e | if.they have an| 00000180 79 20 6c 65 66 74 68 61 6e 64 20 77 61 73 74 61 |y lefthand wasta| 00000190 67 65 2e 0a 0a 50 6f 73 73 69 62 6c 65 20 74 72 |ge...Possible tr| 000001a0 6f 75 62 6c 65 20 61 72 65 61 73 20 69 6e 63 6c |ouble areas incl| 000001b0 75 64 65 20 75 73 65 20 6f 66 20 73 70 72 69 74 |ude use of sprit| 000001c0 65 73 2c 20 26 20 64 72 61 77 20 66 69 6c 65 73 |es, & draw files| 000001d0 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 73 70 72 69 | containing.spri| 000001e0 74 65 73 2c 20 61 73 20 67 72 61 70 68 69 63 73 |tes, as graphics| 000001f0 20 77 69 74 68 69 6e 20 44 54 50 20 64 6f 63 75 | within DTP docu| 00000200 6d 65 6e 74 73 2e 20 54 6f 20 61 76 6f 69 64 20 |ments. To avoid | 00000210 61 6e 79 20 70 72 6f 62 6c 65 6d 73 2c 0a 65 6e |any problems,.en| 00000220 73 75 72 65 20 61 6c 6c 20 73 70 72 69 74 65 73 |sure all sprites| 00000230 20 68 61 76 65 20 6e 6f 20 77 61 73 74 61 67 65 | have no wastage| 00000240 2e 0a 0a 53 65 65 20 54 65 63 68 46 6f 72 75 6d |...See TechForum| 00000250 20 69 6e 20 74 68 65 20 6d 61 67 61 7a 69 6e 65 | in the magazine| 00000260 20 66 6f 72 20 66 75 72 74 68 65 72 20 64 65 74 | for further det| 00000270 61 69 6c 73 2e 0a 0a 4e 6f 74 65 2c 20 77 61 73 |ails...Note, was| 00000280 74 65 72 20 6f 76 65 72 77 72 69 74 65 73 20 61 |ter overwrites a| 00000290 6e 79 20 66 69 6c 65 73 20 69 74 20 69 73 20 67 |ny files it is g| 000002a0 69 76 65 6e 20 77 68 69 63 68 20 72 65 71 75 69 |iven which requi| 000002b0 72 65 0a 6d 6f 64 69 66 69 63 61 74 69 6f 6e 2c |re.modification,| 000002c0 20 77 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 | with the correc| 000002d0 74 65 64 20 76 65 72 73 69 6f 6e 2e 20 53 6f 2c |ted version. So,| 000002e0 20 6a 75 73 74 20 69 6e 20 63 61 73 65 20 74 68 | just in case th| 000002f0 65 72 65 20 61 72 65 0a 61 6e 79 20 62 75 67 73 |ere are.any bugs| 00000300 20 69 6e 20 77 61 73 74 65 72 2c 20 69 66 20 69 | in waster, if i| 00000310 6d 70 6f 72 74 61 6e 74 2c 20 6b 65 65 70 20 62 |mportant, keep b| 00000320 61 63 6b 20 75 70 20 63 6f 70 69 65 73 20 6f 66 |ack up copies of| 00000330 20 79 6f 75 72 20 6f 6c 64 0a 66 69 6c 65 73 20 | your old.files | 00000340 75 6e 74 69 6c 20 79 6f 75 20 61 72 65 20 73 61 |until you are sa| 00000350 74 69 73 66 69 65 64 20 74 68 61 74 20 74 68 65 |tisfied that the| 00000360 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f | modified versio| 00000370 6e 73 20 61 72 65 20 73 61 66 65 2e 0a 0a 57 61 |ns are safe...Wa| 00000380 73 74 65 72 20 69 73 20 63 6f 6d 6d 61 6e 64 20 |ster is command | 00000390 6c 69 6e 65 20 64 72 69 76 65 6e 2e 0a 0a 59 6f |line driven...Yo| 000003a0 75 20 63 61 6e 20 75 73 65 20 69 74 20 62 79 20 |u can use it by | 000003b0 63 6f 70 79 69 6e 67 20 74 68 65 20 64 69 72 65 |copying the dire| 000003c0 63 74 6f 72 79 20 57 61 73 74 65 72 2e 63 6d 64 |ctory Waster.cmd| 000003d0 6c 69 6e 65 20 66 72 6f 6d 20 74 68 65 20 63 6f |line from the co| 000003e0 76 65 72 0a 64 69 73 63 20 74 6f 20 61 20 77 72 |ver.disc to a wr| 000003f0 69 74 61 62 6c 65 20 6d 65 64 69 75 6d 2e 20 50 |itable medium. P| 00000400 6c 61 63 65 20 79 6f 75 72 20 66 69 6c 65 73 20 |lace your files | 00000410 69 6e 74 6f 20 63 6d 64 6c 69 6e 65 2c 20 74 68 |into cmdline, th| 00000420 65 6e 20 72 75 6e 0a 43 6c 69 63 6b 4d 65 20 74 |en run.ClickMe t| 00000430 6f 20 73 65 74 20 74 68 65 20 63 75 72 72 65 6e |o set the curren| 00000440 74 20 64 69 72 65 63 74 6f 72 79 2c 20 67 6f 20 |t directory, go | 00000450 74 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c |to the command l| 00000460 69 6e 65 20 26 20 65 6e 74 65 72 3a 0a 20 20 77 |ine & enter:. w| 00000470 61 73 74 65 72 20 3c 66 69 6c 65 6e 61 6d 65 3e |aster <filename>| 00000480 20 3c 72 65 74 75 72 6e 3e 0a 74 6f 20 70 72 6f | <return>.to pro| 00000490 63 65 73 73 20 74 68 65 20 6e 61 6d 65 64 20 66 |cess the named f| 000004a0 69 6c 65 2e 0a 0a 54 68 69 73 20 69 73 20 61 20 |ile...This is a | 000004b0 6c 69 74 74 6c 65 20 63 75 6d 62 65 72 73 6f 6d |little cumbersom| 000004c0 65 20 69 6e 20 74 68 65 20 47 55 49 20 64 65 73 |e in the GUI des| 000004d0 6b 74 6f 70 2c 20 73 6f 20 49 91 76 65 20 61 6c |ktop, so I.ve al| 000004e0 73 6f 20 70 72 6f 76 69 64 65 64 20 61 0a 64 65 |so provided a.de| 000004f0 73 6b 74 6f 70 20 73 68 65 6c 6c 20 74 6f 20 64 |sktop shell to d| 00000500 72 69 76 65 20 69 74 20 2d 20 21 57 61 73 74 65 |rive it - !Waste| 00000510 72 2e 0a 0a 55 6e 66 6f 72 74 75 6e 61 74 65 6c |r...Unfortunatel| 00000520 79 2c 20 79 6f 75 91 6c 6c 20 6e 65 65 64 20 74 |y, you.ll need t| 00000530 6f 20 68 61 76 65 20 61 20 63 6f 70 79 20 6f 66 |o have a copy of| 00000540 20 41 63 6f 72 6e 91 73 20 46 72 6f 6e 74 45 6e | Acorn.s FrontEn| 00000550 64 20 26 0a 44 44 45 55 74 69 6c 73 20 6d 6f 64 |d &.DDEUtils mod| 00000560 75 6c 65 73 20 69 6e 20 79 6f 75 72 20 21 53 79 |ules in your !Sy| 00000570 73 74 65 6d 20 72 65 73 6f 75 72 63 65 73 2c 20 |stem resources, | 00000580 69 6e 20 6f 72 64 65 72 20 74 6f 20 75 73 65 20 |in order to use | 00000590 74 68 69 73 2e 0a 54 68 65 73 65 20 61 72 65 20 |this..These are | 000005a0 73 75 70 70 6c 69 65 64 20 61 73 20 70 61 72 74 |supplied as part| 000005b0 20 6f 66 20 41 63 6f 72 6e 91 73 20 44 44 45 20 | of Acorn.s DDE | 000005c0 99 20 64 65 73 6b 74 6f 70 20 64 65 76 65 6c 6f |. desktop develo| 000005d0 70 6d 65 6e 74 0a 65 6e 76 69 72 6f 6e 6d 65 6e |pment.environmen| 000005e0 74 20 99 20 77 69 74 68 20 62 6f 74 68 20 44 65 |t . with both De| 000005f0 73 6b 74 6f 70 20 41 73 73 65 6d 62 6c 65 72 20 |sktop Assembler | 00000600 26 20 44 65 73 6b 74 6f 70 20 43 2e 0a |& Desktop C..| 0000060d
.