Home » Recent acquisitions » Acorn ADFS disks » adfs_ArchimedesWorld_199207.adf » !AWJULY92 » !AWJUL92/Goodies/Wimp/!WimpPool/!Help
!AWJUL92/Goodies/Wimp/!WimpPool/!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 » Recent acquisitions » Acorn ADFS disks » adfs_ArchimedesWorld_199207.adf » !AWJULY92 |
| Filename: | !AWJUL92/Goodies/Wimp/!WimpPool/!Help |
| Read OK: | ✔ |
| File size: | 0779 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
----------------------------------------
Application :!WimpPool
Help for Version 1.0 : (24 Apr 1992)
----------------------------------------
1. Purpose:
--------
This application allows three sprite files to be saved:
1) The RAM portion of the Wimp Sprite Pool
2) The RMA portion of the Wimp Sprite Pool
3) A sprites file containing a set of "standard" icon sprites
for use with applications.
The saving of these sprite files is done, from the icon bar menu in the
usual way (by dragging the sprite icon to an appropriate window).
2. Background
----------
The icon sprites used by the Filer are stored in an area accessible to
all applications - the Wimp shared sprite pool. This is divided into 2
areas - RAM and RMA. As new application's are run, the sprites they define
are added to the RMA Wimp Sprite Pool.
For an application called !App we need a !Sprites file containing a sprite called !app and perhaps a sprite called sm!app. The latter sprite will be used by the Filer in small icon displays. If a small sprite is not present the Filer will do its best in the small icon displays to represent the
sprite !App.
Sprites for files of type ttt are called file_ttt and small_ttt. These can
be included in !Sprites files for mergeing into the RMA sprite pool.
Acorn advise that icon sprites are designed in mode 12 which is 1280x1024
OS units (width x height). The standard size for the large sprites is 68
OS units square (in mode 12 this is 34 pixels wide by 17 pixels high). The
small sprites are half this: 34 OS units square (in mode 12, 16-19 pixels
wide by 19 pixels high).
Sprites for document files (file_ttt) conventionally have a square black
border 4 OS units wide.
00000000 20 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | . | 00000010 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d | ------------| 00000020 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| 00000030 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 20 |------------. | 00000040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000050 20 20 20 20 20 20 20 41 70 70 6c 69 63 61 74 69 | Applicati| 00000060 6f 6e 20 3a 21 57 69 6d 70 50 6f 6f 6c 0a 20 20 |on :!WimpPool. | 00000070 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |. | 00000080 20 20 20 48 65 6c 70 20 66 6f 72 20 56 65 72 73 | Help for Vers| 00000090 69 6f 6e 20 31 2e 30 20 3a 20 28 32 34 20 41 70 |ion 1.0 : (24 Ap| 000000a0 72 20 31 39 39 32 29 0a 20 20 0a 20 20 20 20 20 |r 1992). . | 000000b0 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 2d 2d | ----| 000000c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000000e0 2d 2d 2d 2d 0a 20 20 0a 31 2e 20 50 75 72 70 6f |----. .1. Purpo| 000000f0 73 65 3a 0a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 0a |se:. --------.| 00000100 0a 20 20 20 54 68 69 73 20 61 70 70 6c 69 63 61 |. This applica| 00000110 74 69 6f 6e 20 61 6c 6c 6f 77 73 20 74 68 72 65 |tion allows thre| 00000120 65 20 73 70 72 69 74 65 20 66 69 6c 65 73 20 74 |e sprite files t| 00000130 6f 20 62 65 20 73 61 76 65 64 3a 0a 0a 20 20 20 |o be saved:.. | 00000140 20 20 20 20 20 20 20 20 31 29 20 54 68 65 20 52 | 1) The R| 00000150 41 4d 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 |AM portion of th| 00000160 65 20 57 69 6d 70 20 53 70 72 69 74 65 20 50 6f |e Wimp Sprite Po| 00000170 6f 6c 0a 20 20 20 20 20 20 20 20 20 20 20 32 29 |ol. 2)| 00000180 20 54 68 65 20 52 4d 41 20 70 6f 72 74 69 6f 6e | The RMA portion| 00000190 20 6f 66 20 74 68 65 20 57 69 6d 70 20 53 70 72 | of the Wimp Spr| 000001a0 69 74 65 20 50 6f 6f 6c 0a 20 20 20 20 20 20 20 |ite Pool. | 000001b0 20 20 20 20 33 29 20 41 20 73 70 72 69 74 65 73 | 3) A sprites| 000001c0 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 | file containing| 000001d0 20 61 20 73 65 74 20 6f 66 20 22 73 74 61 6e 64 | a set of "stand| 000001e0 61 72 64 22 20 69 63 6f 6e 20 73 70 72 69 74 65 |ard" icon sprite| 000001f0 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |s. | 00000200 66 6f 72 20 75 73 65 20 77 69 74 68 20 61 70 70 |for use with app| 00000210 6c 69 63 61 74 69 6f 6e 73 2e 0a 0a 20 20 20 54 |lications... T| 00000220 68 65 20 73 61 76 69 6e 67 20 6f 66 20 74 68 65 |he saving of the| 00000230 73 65 20 73 70 72 69 74 65 20 66 69 6c 65 73 20 |se sprite files | 00000240 69 73 20 64 6f 6e 65 2c 20 66 72 6f 6d 20 74 68 |is done, from th| 00000250 65 20 69 63 6f 6e 20 62 61 72 20 6d 65 6e 75 20 |e icon bar menu | 00000260 69 6e 20 74 68 65 0a 20 20 20 75 73 75 61 6c 20 |in the. usual | 00000270 77 61 79 20 28 62 79 20 64 72 61 67 67 69 6e 67 |way (by dragging| 00000280 20 74 68 65 20 73 70 72 69 74 65 20 69 63 6f 6e | the sprite icon| 00000290 20 74 6f 20 61 6e 20 61 70 70 72 6f 70 72 69 61 | to an appropria| 000002a0 74 65 20 77 69 6e 64 6f 77 29 2e 20 0a 0a 32 2e |te window). ..2.| 000002b0 20 42 61 63 6b 67 72 6f 75 6e 64 0a 20 20 20 2d | Background. -| 000002c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 20 54 68 |---------.. Th| 000002d0 65 20 69 63 6f 6e 20 73 70 72 69 74 65 73 20 75 |e icon sprites u| 000002e0 73 65 64 20 62 79 20 74 68 65 20 46 69 6c 65 72 |sed by the Filer| 000002f0 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 61 | are stored in a| 00000300 6e 20 61 72 65 61 20 61 63 63 65 73 73 69 62 6c |n area accessibl| 00000310 65 20 74 6f 0a 20 20 20 61 6c 6c 20 61 70 70 6c |e to. all appl| 00000320 69 63 61 74 69 6f 6e 73 20 2d 20 74 68 65 20 57 |ications - the W| 00000330 69 6d 70 20 73 68 61 72 65 64 20 73 70 72 69 74 |imp shared sprit| 00000340 65 20 70 6f 6f 6c 2e 20 54 68 69 73 20 69 73 20 |e pool. This is | 00000350 64 69 76 69 64 65 64 20 69 6e 74 6f 20 32 0a 20 |divided into 2. | 00000360 20 20 61 72 65 61 73 20 2d 20 52 41 4d 20 61 6e | areas - RAM an| 00000370 64 20 52 4d 41 2e 20 41 73 20 6e 65 77 20 61 70 |d RMA. As new ap| 00000380 70 6c 69 63 61 74 69 6f 6e 27 73 20 61 72 65 20 |plication's are | 00000390 72 75 6e 2c 20 74 68 65 20 73 70 72 69 74 65 73 |run, the sprites| 000003a0 20 74 68 65 79 20 64 65 66 69 6e 65 0a 20 20 20 | they define. | 000003b0 61 72 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 |are added to the| 000003c0 20 52 4d 41 20 57 69 6d 70 20 53 70 72 69 74 65 | RMA Wimp Sprite| 000003d0 20 50 6f 6f 6c 2e 0a 0a 20 20 20 46 6f 72 20 61 | Pool... For a| 000003e0 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 63 61 |n application ca| 000003f0 6c 6c 65 64 20 21 41 70 70 20 77 65 20 6e 65 65 |lled !App we nee| 00000400 64 20 61 20 21 53 70 72 69 74 65 73 20 66 69 6c |d a !Sprites fil| 00000410 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 73 |e containing a s| 00000420 70 72 69 74 65 20 20 20 63 61 6c 6c 65 64 20 21 |prite called !| 00000430 61 70 70 20 61 6e 64 20 70 65 72 68 61 70 73 20 |app and perhaps | 00000440 61 20 73 70 72 69 74 65 20 63 61 6c 6c 65 64 20 |a sprite called | 00000450 73 6d 21 61 70 70 2e 20 54 68 65 20 6c 61 74 74 |sm!app. The latt| 00000460 65 72 20 73 70 72 69 74 65 20 77 69 6c 6c 20 62 |er sprite will b| 00000470 65 20 20 20 20 75 73 65 64 20 62 79 20 74 68 65 |e used by the| 00000480 20 46 69 6c 65 72 20 69 6e 20 73 6d 61 6c 6c 20 | Filer in small | 00000490 69 63 6f 6e 20 64 69 73 70 6c 61 79 73 2e 20 49 |icon displays. I| 000004a0 66 20 61 20 73 6d 61 6c 6c 20 73 70 72 69 74 65 |f a small sprite| 000004b0 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 | is not present | 000004c0 20 20 74 68 65 20 46 69 6c 65 72 20 77 69 6c 6c | the Filer will| 000004d0 20 64 6f 20 69 74 73 20 62 65 73 74 20 69 6e 20 | do its best in | 000004e0 74 68 65 20 73 6d 61 6c 6c 20 69 63 6f 6e 20 64 |the small icon d| 000004f0 69 73 70 6c 61 79 73 20 74 6f 20 72 65 70 72 65 |isplays to repre| 00000500 73 65 6e 74 20 74 68 65 0a 20 20 20 73 70 72 69 |sent the. spri| 00000510 74 65 20 21 41 70 70 2e 0a 0a 20 20 20 53 70 72 |te !App... Spr| 00000520 69 74 65 73 20 66 6f 72 20 66 69 6c 65 73 20 6f |ites for files o| 00000530 66 20 74 79 70 65 20 74 74 74 20 61 72 65 20 63 |f type ttt are c| 00000540 61 6c 6c 65 64 20 66 69 6c 65 5f 74 74 74 20 61 |alled file_ttt a| 00000550 6e 64 20 73 6d 61 6c 6c 5f 74 74 74 2e 20 54 68 |nd small_ttt. Th| 00000560 65 73 65 20 63 61 6e 0a 20 20 20 62 65 20 69 6e |ese can. be in| 00000570 63 6c 75 64 65 64 20 69 6e 20 21 53 70 72 69 74 |cluded in !Sprit| 00000580 65 73 20 66 69 6c 65 73 20 66 6f 72 20 6d 65 72 |es files for mer| 00000590 67 65 69 6e 67 20 69 6e 74 6f 20 74 68 65 20 52 |geing into the R| 000005a0 4d 41 20 73 70 72 69 74 65 20 70 6f 6f 6c 2e 0a |MA sprite pool..| 000005b0 0a 20 20 20 41 63 6f 72 6e 20 61 64 76 69 73 65 |. Acorn advise| 000005c0 20 74 68 61 74 20 69 63 6f 6e 20 73 70 72 69 74 | that icon sprit| 000005d0 65 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 20 |es are designed | 000005e0 69 6e 20 6d 6f 64 65 20 31 32 20 77 68 69 63 68 |in mode 12 which| 000005f0 20 69 73 20 31 32 38 30 78 31 30 32 34 0a 20 20 | is 1280x1024. | 00000600 20 4f 53 20 75 6e 69 74 73 20 28 77 69 64 74 68 | OS units (width| 00000610 20 78 20 68 65 69 67 68 74 29 2e 20 54 68 65 20 | x height). The | 00000620 73 74 61 6e 64 61 72 64 20 73 69 7a 65 20 66 6f |standard size fo| 00000630 72 20 74 68 65 20 6c 61 72 67 65 20 73 70 72 69 |r the large spri| 00000640 74 65 73 20 69 73 20 36 38 0a 20 20 20 4f 53 20 |tes is 68. OS | 00000650 75 6e 69 74 73 20 73 71 75 61 72 65 20 28 69 6e |units square (in| 00000660 20 6d 6f 64 65 20 31 32 20 74 68 69 73 20 69 73 | mode 12 this is| 00000670 20 33 34 20 70 69 78 65 6c 73 20 77 69 64 65 20 | 34 pixels wide | 00000680 62 79 20 31 37 20 70 69 78 65 6c 73 20 68 69 67 |by 17 pixels hig| 00000690 68 29 2e 20 54 68 65 0a 20 20 20 73 6d 61 6c 6c |h). The. small| 000006a0 20 73 70 72 69 74 65 73 20 61 72 65 20 68 61 6c | sprites are hal| 000006b0 66 20 74 68 69 73 3a 20 33 34 20 4f 53 20 75 6e |f this: 34 OS un| 000006c0 69 74 73 20 73 71 75 61 72 65 20 28 69 6e 20 6d |its square (in m| 000006d0 6f 64 65 20 31 32 2c 20 31 36 2d 31 39 20 70 69 |ode 12, 16-19 pi| 000006e0 78 65 6c 73 0a 20 20 20 77 69 64 65 20 62 79 20 |xels. wide by | 000006f0 31 39 20 70 69 78 65 6c 73 20 68 69 67 68 29 2e |19 pixels high).| 00000700 0a 0a 20 20 20 53 70 72 69 74 65 73 20 66 6f 72 |.. Sprites for| 00000710 20 64 6f 63 75 6d 65 6e 74 20 66 69 6c 65 73 20 | document files | 00000720 28 66 69 6c 65 5f 74 74 74 29 20 63 6f 6e 76 65 |(file_ttt) conve| 00000730 6e 74 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 61 |ntionally have a| 00000740 20 73 71 75 61 72 65 20 62 6c 61 63 6b 0a 20 20 | square black. | 00000750 20 62 6f 72 64 65 72 20 34 20 4f 53 20 75 6e 69 | border 4 OS uni| 00000760 74 73 20 77 69 64 65 2e 0a 0a 0a 20 20 20 0a 0a |ts wide.... ..| 00000770 20 20 20 20 0a 0a 20 20 0a | .. .| 00000779
.