Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/!RunImage/Chapter2/Text

Shareware/Event/Documents/!EShellDoc/!RunImage/Chapter2/Text

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 08 subscription disc.adf » 9408s
Filename: Shareware/Event/Documents/!EShellDoc/!RunImage/Chapter2/Text
Read OK:
File size: 0B44 bytes
Load address: 0000
Exec address: 0000
File contents
@	2�pR� 7A�������5� aZ22Creating An Application2 
 

 
p-(RG��'3�� "� c�
(
t���� "� c�The easiest way to create a new application is to use the AppBuild tool. Run t
p��Ǔ����� "�c�this and drag the application icon from the AppBuild window to a directory p
l J�[��g��� "�c�display. The various options available using AppBuild will be discussed l-tR��G#��'R�� "�c�later, but for now just quit AppBuild and run the newly created application. 
t-(R���� "� c�
(
l�zDz���� "� c�You should see a blank icon appear on the icon bar and clicking <MENU> l
tȧ�z��g��� "�c�over this will bring up the usual icon bar menu including the items �Info� and t
pp{GB��'q�� "�c��Quit�. �Info� leads to the normal �About This Program� window (the icons p
p�^
���8�� "c�of which are blank at the moment) and �Quit� which stops the application p-`Rx������ "aZand removes it from the icon bar - don�t quit it just yet.
`-(R����g�� " �M
(
XT�Ga��'��� " �MClicking <SELECT> on the iconbar icon will open a X
\�9)���W�� "�Mwindow which has the usual controls and may be scrolled \
\����� "�Mand moved around the screen. Keep the application you \
d�F����g� "�Mhave just created handy as in the next section we�ll look at d
\,G���'��� "�Mthe program code and see how to change it to suit your \-0R��H���v�� "�Mown needs.
0-(R����>�� " �M
(
\�����g�� " �MAs you can see it is very easy to create a new shell \
\��G���'�� "�Mapplication - even if this particular one doesn�t do \-HV�Kg���� "�Manything useful yet!4��
H-(R�.���]�� " �M
(
\������g%�� " �MIt is of course possible to modify one of the supplied \-`R�EG���'� "�Mexample programs to use as a starting point for a new one.
`�yV4��f�	�pB25��1<��)fff�	f�	Creating Applicationsn�	ff
pyV4��f�	�pB25��<��)�fff�	f�	Creating Applicationson�	ff
pyV4��!�PC���������"!!The !AppBuild main window!
PyV4
00000000  40 09 00 00 01 00 00 00  00 00 00 00 06 08 00 00  |@...............|
00000010  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
00000020  00 10 00 00 02 18 00 00  10 01 00 00 00 00 00 00  |................|
00000030  01 32 0c 00 00 00 00 00  00 18 00 00 ad 70 00 00  |.2...........p..|
00000040  52 dc 20 03 37 41 fe ff  87 87 fe ff dc 35 00 f2  |R. .7A.......5..|
00000050  15 00 00 00 20 03 00 00  61 5a 07 00 07 05 05 05  |.... ...aZ......|
00000060  01 32 0c 00 01 32 0c 00  00 00 00 00 43 72 65 61  |.2...2......Crea|
00000070  74 69 6e 67 20 41 6e 20  41 70 70 6c 69 63 61 74  |ting An Applicat|
00000080  69 6f 6e 08 01 32 0c 00  00 00 00 00 07 00 00 00  |ion..2..........|
00000090  02 20 0a 00 02 20 0a 00  00 00 00 00 0d 08 00 00  |. ... ..........|
000000a0  02 20 0a 00 00 00 00 00  00 70 00 00 2d 28 00 00  |. .......p..-(..|
000000b0  52 00 00 00 47 04 fe ff  27 33 fe ff 20 22 00 f2  |R...G...'3.. "..|
000000c0  15 00 00 00 20 03 00 00  63 aa 05 00 0d 00 00 00  |.... ...c.......|
000000d0  00 28 00 00 0d 74 00 00  10 d0 96 05 07 cc fd ff  |.(...t..........|
000000e0  e7 fa fd ff 20 22 00 f2  15 00 00 00 20 03 00 00  |.... "...... ...|
000000f0  63 aa 05 00 54 68 65 20  65 61 73 69 65 73 74 20  |c...The easiest |
00000100  77 61 79 20 74 6f 20 63  72 65 61 74 65 20 61 20  |way to create a |
00000110  6e 65 77 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |new application |
00000120  69 73 20 74 6f 20 75 73  65 20 74 68 65 20 41 70  |is to use the Ap|
00000130  70 42 75 69 6c 64 20 74  6f 6f 6c 2e 20 52 75 6e  |pBuild tool. Run|
00000140  20 00 00 00 00 74 00 00  0d 70 00 00 10 84 88 05  | ....t...p......|
00000150  c7 93 fd ff a7 c2 fd ff  20 22 00 f0 15 00 00 00  |........ "......|
00000160  00 00 00 00 63 aa 05 00  74 68 69 73 20 61 6e 64  |....c...this and|
00000170  20 64 72 61 67 20 74 68  65 20 61 70 70 6c 69 63  | drag the applic|
00000180  61 74 69 6f 6e 20 69 63  6f 6e 20 66 72 6f 6d 20  |ation icon from |
00000190  74 68 65 20 41 70 70 42  75 69 6c 64 20 77 69 6e  |the AppBuild win|
000001a0  64 6f 77 20 74 6f 20 61  20 64 69 72 65 63 74 6f  |dow to a directo|
000001b0  72 79 20 00 00 70 00 00  0d 6c 00 00 10 20 4a 05  |ry ..p...l... J.|
000001c0  87 5b fd ff 67 8a fd ff  20 22 00 f0 15 00 00 00  |.[..g... "......|
000001d0  00 00 00 00 63 aa 05 00  64 69 73 70 6c 61 79 2e  |....c...display.|
000001e0  20 54 68 65 20 76 61 72  69 6f 75 73 20 6f 70 74  | The various opt|
000001f0  69 6f 6e 73 20 61 76 61  69 6c 61 62 6c 65 20 75  |ions available u|
00000200  73 69 6e 67 20 41 70 70  42 75 69 6c 64 20 77 69  |sing AppBuild wi|
00000210  6c 6c 20 62 65 20 64 69  73 63 75 73 73 65 64 20  |ll be discussed |
00000220  00 6c 00 00 2d 74 00 00  52 9c 91 05 47 23 fd ff  |.l..-t..R...G#..|
00000230  27 52 fd ff 20 22 00 f0  15 00 00 00 00 00 00 00  |'R.. "..........|
00000240  63 aa 05 00 6c 61 74 65  72 2c 20 62 75 74 20 66  |c...later, but f|
00000250  6f 72 20 6e 6f 77 20 6a  75 73 74 20 71 75 69 74  |or now just quit|
00000260  20 41 70 70 42 75 69 6c  64 20 61 6e 64 20 72 75  | AppBuild and ru|
00000270  6e 20 74 68 65 20 6e 65  77 6c 79 20 63 72 65 61  |n the newly crea|
00000280  74 65 64 20 61 70 70 6c  69 63 61 74 69 6f 6e 2e  |ted application.|
00000290  20 0d 00 00 00 74 00 00  2d 28 00 00 52 00 00 00  | ....t..-(..R...|
000002a0  07 eb fc ff e7 19 fd ff  20 22 00 f2 15 00 00 00  |........ "......|
000002b0  20 03 00 00 63 aa 05 00  0d 00 00 00 00 28 00 00  | ...c........(..|
000002c0  0d 6c 00 00 10 e0 7a 05  c7 b2 fc ff a7 e1 fc ff  |.l....z.........|
000002d0  20 22 00 f2 15 00 00 00  20 03 00 00 63 aa 05 00  | "...... ...c...|
000002e0  59 6f 75 20 73 68 6f 75  6c 64 20 73 65 65 20 61  |You should see a|
000002f0  20 62 6c 61 6e 6b 20 69  63 6f 6e 20 61 70 70 65  | blank icon appe|
00000300  61 72 20 6f 6e 20 74 68  65 20 69 63 6f 6e 20 62  |ar on the icon b|
00000310  61 72 20 61 6e 64 20 63  6c 69 63 6b 69 6e 67 20  |ar and clicking |
00000320  3c 4d 45 4e 55 3e 20 00  00 6c 00 00 0d 74 00 00  |<MENU> ..l...t..|
00000330  10 c8 a7 05 87 7a fc ff  67 a9 fc ff 20 22 00 f0  |.....z..g... "..|
00000340  15 00 00 00 00 00 00 00  63 aa 05 00 6f 76 65 72  |........c...over|
00000350  20 74 68 69 73 20 77 69  6c 6c 20 62 72 69 6e 67  | this will bring|
00000360  20 75 70 20 74 68 65 20  75 73 75 61 6c 20 69 63  | up the usual ic|
00000370  6f 6e 20 62 61 72 20 6d  65 6e 75 20 69 6e 63 6c  |on bar menu incl|
00000380  75 64 69 6e 67 20 74 68  65 20 69 74 65 6d 73 20  |uding the items |
00000390  90 49 6e 66 6f 91 20 61  6e 64 20 00 00 74 00 00  |.Info. and ..t..|
000003a0  0d 70 00 00 10 70 7b 05  47 42 fc ff 27 71 fc ff  |.p...p{.GB..'q..|
000003b0  20 22 00 f0 15 00 00 00  00 00 00 00 63 aa 05 00  | "..........c...|
000003c0  90 51 75 69 74 91 2e 20  90 49 6e 66 6f 91 20 6c  |.Quit.. .Info. l|
000003d0  65 61 64 73 20 74 6f 20  74 68 65 20 6e 6f 72 6d  |eads to the norm|
000003e0  61 6c 20 90 41 62 6f 75  74 20 54 68 69 73 20 50  |al .About This P|
000003f0  72 6f 67 72 61 6d 91 20  77 69 6e 64 6f 77 20 28  |rogram. window (|
00000400  74 68 65 20 69 63 6f 6e  73 20 00 00 00 70 00 00  |the icons ...p..|
00000410  0d 70 00 00 10 cc 5e 05  07 0a fc ff e7 38 fc ff  |.p....^......8..|
00000420  20 22 00 00 15 00 00 00  00 00 00 00 63 aa 05 00  | "..........c...|
00000430  6f 66 20 77 68 69 63 68  20 61 72 65 20 62 6c 61  |of which are bla|
00000440  6e 6b 20 61 74 20 74 68  65 20 6d 6f 6d 65 6e 74  |nk at the moment|
00000450  29 20 61 6e 64 20 90 51  75 69 74 91 20 77 68 69  |) and .Quit. whi|
00000460  63 68 20 73 74 6f 70 73  20 74 68 65 20 61 70 70  |ch stops the app|
00000470  6c 69 63 61 74 69 6f 6e  20 00 00 00 00 70 00 00  |lication ....p..|
00000480  2d 60 00 00 52 78 08 04  c7 d1 fb ff a7 00 fc ff  |-`..Rx..........|
00000490  20 22 00 00 15 00 00 00  00 00 00 00 61 5a 07 00  | "..........aZ..|
000004a0  61 6e 64 20 72 65 6d 6f  76 65 73 20 69 74 20 66  |and removes it f|
000004b0  72 6f 6d 20 74 68 65 20  69 63 6f 6e 20 62 61 72  |rom the icon bar|
000004c0  20 2d 20 64 6f 6e 91 74  20 71 75 69 74 20 69 74  | - don.t quit it|
000004d0  20 6a 75 73 74 20 79 65  74 2e 0d 00 00 60 00 00  | just yet....`..|
000004e0  2d 28 00 00 52 00 00 00  87 99 fb ff 67 c8 fb ff  |-(..R.......g...|
000004f0  20 22 00 02 15 00 00 00  20 03 00 00 8b 4d 04 00  | "...... ....M..|
00000500  0d 00 00 00 00 28 00 00  0d 58 00 00 10 54 de 03  |.....(...X...T..|
00000510  47 61 fb ff 27 90 fb ff  20 22 00 02 15 00 00 00  |Ga..'... "......|
00000520  20 03 00 00 8b 4d 04 00  43 6c 69 63 6b 69 6e 67  | ....M..Clicking|
00000530  20 3c 53 45 4c 45 43 54  3e 20 6f 6e 20 74 68 65  | <SELECT> on the|
00000540  20 69 63 6f 6e 62 61 72  20 69 63 6f 6e 20 77 69  | iconbar icon wi|
00000550  6c 6c 20 6f 70 65 6e 20  61 20 00 00 00 58 00 00  |ll open a ...X..|
00000560  0d 5c 00 00 10 e0 39 04  07 29 fb ff e7 57 fb ff  |.\....9..)...W..|
00000570  20 22 00 00 15 00 00 00  00 00 00 00 8b 4d 04 00  | "...........M..|
00000580  77 69 6e 64 6f 77 20 77  68 69 63 68 20 68 61 73  |window which has|
00000590  20 74 68 65 20 75 73 75  61 6c 20 63 6f 6e 74 72  | the usual contr|
000005a0  6f 6c 73 20 61 6e 64 20  6d 61 79 20 62 65 20 73  |ols and may be s|
000005b0  63 72 6f 6c 6c 65 64 20  00 5c 00 00 0d 5c 00 00  |crolled .\...\..|
000005c0  10 bc 12 04 c7 f0 fa ff  a7 1f fb ff 20 22 00 00  |............ "..|
000005d0  15 00 00 00 00 00 00 00  8b 4d 04 00 61 6e 64 20  |.........M..and |
000005e0  6d 6f 76 65 64 20 61 72  6f 75 6e 64 20 74 68 65  |moved around the|
000005f0  20 73 63 72 65 65 6e 2e  20 4b 65 65 70 20 74 68  | screen. Keep th|
00000600  65 20 61 70 70 6c 69 63  61 74 69 6f 6e 20 79 6f  |e application yo|
00000610  75 20 00 00 00 5c 00 00  0d 64 00 00 10 dc 46 04  |u ...\...d....F.|
00000620  87 b8 fa ff 67 e7 fa ff  20 22 00 00 15 00 00 00  |....g... "......|
00000630  00 00 00 00 8b 4d 04 00  68 61 76 65 20 6a 75 73  |.....M..have jus|
00000640  74 20 63 72 65 61 74 65  64 20 68 61 6e 64 79 20  |t created handy |
00000650  61 73 20 69 6e 20 74 68  65 20 6e 65 78 74 20 73  |as in the next s|
00000660  65 63 74 69 6f 6e 20 77  65 91 6c 6c 20 6c 6f 6f  |ection we.ll loo|
00000670  6b 20 61 74 20 00 00 00  00 64 00 00 0d 5c 00 00  |k at ....d...\..|
00000680  10 2c 03 04 47 80 fa ff  27 af fa ff 20 22 00 00  |.,..G...'... "..|
00000690  15 00 00 00 00 00 00 00  8b 4d 04 00 74 68 65 20  |.........M..the |
000006a0  70 72 6f 67 72 61 6d 20  63 6f 64 65 20 61 6e 64  |program code and|
000006b0  20 73 65 65 20 68 6f 77  20 74 6f 20 63 68 61 6e  | see how to chan|
000006c0  67 65 20 69 74 20 74 6f  20 73 75 69 74 20 79 6f  |ge it to suit yo|
000006d0  75 72 20 00 00 5c 00 00  2d 30 00 00 52 e4 d2 00  |ur ..\..-0..R...|
000006e0  07 48 fa ff e7 76 fa ff  20 22 00 00 15 00 00 00  |.H...v.. "......|
000006f0  00 00 00 00 8b 4d 04 00  6f 77 6e 20 6e 65 65 64  |.....M..own need|
00000700  73 2e 0d 00 00 30 00 00  2d 28 00 00 52 00 00 00  |s....0..-(..R...|
00000710  c7 0f fa ff a7 3e fa ff  20 22 00 02 15 00 00 00  |.....>.. "......|
00000720  20 03 00 00 8b 4d 04 00  0d 00 00 00 00 28 00 00  | ....M.......(..|
00000730  0d 5c 00 00 10 ac b3 03  87 d7 f9 ff 67 06 fa ff  |.\..........g...|
00000740  20 22 00 02 15 00 00 00  20 03 00 00 8b 4d 04 00  | "...... ....M..|
00000750  41 73 20 79 6f 75 20 63  61 6e 20 73 65 65 20 69  |As you can see i|
00000760  74 20 69 73 20 76 65 72  79 20 65 61 73 79 20 74  |t is very easy t|
00000770  6f 20 63 72 65 61 74 65  20 61 20 6e 65 77 20 73  |o create a new s|
00000780  68 65 6c 6c 20 00 00 00  00 5c 00 00 0d 5c 00 00  |hell ....\...\..|
00000790  10 bc a6 03 47 9f f9 ff  27 ce f9 ff 20 22 00 00  |....G...'... "..|
000007a0  15 00 00 00 00 00 00 00  8b 4d 04 00 61 70 70 6c  |.........M..appl|
000007b0  69 63 61 74 69 6f 6e 20  2d 20 65 76 65 6e 20 69  |ication - even i|
000007c0  66 20 74 68 69 73 20 70  61 72 74 69 63 75 6c 61  |f this particula|
000007d0  72 20 6f 6e 65 20 64 6f  65 73 6e 91 74 20 64 6f  |r one doesn.t do|
000007e0  20 00 00 00 00 5c 00 00  2d 48 00 00 56 c0 4b 03  | ....\..-H..V.K.|
000007f0  07 67 f9 ff e7 95 f9 ff  20 22 00 00 15 00 00 00  |.g...... "......|
00000800  00 00 00 00 8b 4d 04 00  61 6e 79 74 68 69 6e 67  |.....M..anything|
00000810  20 75 73 65 66 75 6c 20  79 65 74 21 12 34 00 00  | useful yet!.4..|
00000820  cc d4 01 00 00 00 00 00  0d 00 00 00 00 48 00 00  |.............H..|
00000830  2d 28 00 00 52 00 00 00  c7 2e f9 ff a7 5d f9 ff  |-(..R........]..|
00000840  20 22 00 02 15 00 00 00  20 03 00 00 8b 4d 04 00  | "...... ....M..|
00000850  0d 00 00 00 00 28 00 00  0d 5c 00 00 10 e8 da 03  |.....(...\......|
00000860  87 f6 f8 ff 67 25 f9 ff  20 22 00 02 15 00 00 00  |....g%.. "......|
00000870  20 03 00 00 8b 4d 04 00  49 74 20 69 73 20 6f 66  | ....M..It is of|
00000880  20 63 6f 75 72 73 65 20  70 6f 73 73 69 62 6c 65  | course possible|
00000890  20 74 6f 20 6d 6f 64 69  66 79 20 6f 6e 65 20 6f  | to modify one o|
000008a0  66 20 74 68 65 20 73 75  70 70 6c 69 65 64 20 00  |f the supplied .|
000008b0  00 5c 00 00 2d 60 00 00  52 8c 45 04 47 be f8 ff  |.\..-`..R.E.G...|
000008c0  27 ed f8 ff 20 22 00 00  15 00 00 00 00 00 00 00  |'... "..........|
000008d0  8b 4d 04 00 65 78 61 6d  70 6c 65 20 70 72 6f 67  |.M..example prog|
000008e0  72 61 6d 73 20 74 6f 20  75 73 65 20 61 73 20 61  |rams to use as a|
000008f0  20 73 74 61 72 74 69 6e  67 20 70 6f 69 6e 74 20  | starting point |
00000900  66 6f 72 20 61 20 6e 65  77 20 6f 6e 65 2e 05 0d  |for a new one...|
00000910  00 60 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |.`..............|
00000920  00 10 00 00 02 14 00 00  8c 04 00 00 00 00 00 00  |................|
00000930  00 00 00 00 00 14 00 00  06 00 00 00 79 56 34 12  |............yV4.|
00000940  b8 00 00 00 02 00 00 00  00 00 00 00 06 08 00 00  |................|
00000950  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
00000960  00 10 00 00 02 1c 00 00  f0 01 00 00 00 00 00 00  |................|
00000970  18 66 03 00 11 cc 09 00  00 00 00 00 00 1c 00 00  |.f..............|
00000980  a5 70 00 00 42 32 35 02  81 05 f4 ff 31 3c f4 ff  |.p..B25.....1<..|
00000990  e4 29 00 02 07 66 03 00  18 66 03 00 18 66 03 00  |.)...f...f...f..|
000009a0  00 00 00 00 07 05 05 05  11 cc 09 00 18 66 03 00  |.............f..|
000009b0  11 cc 09 00 00 00 00 00  43 72 65 61 74 69 6e 67  |........Creating|
000009c0  20 41 70 70 6c 69 63 61  74 69 6f 6e 73 08 08 6e  | Applications..n|
000009d0  11 cc 09 00 18 66 03 00  00 00 00 00 08 00 00 00  |.....f..........|
000009e0  18 66 03 00 00 00 00 00  0d 00 00 00 00 70 00 00  |.f...........p..|
000009f0  06 00 00 00 79 56 34 12  b8 00 00 00 03 00 00 00  |....yV4.........|
00000a00  00 00 00 00 06 08 00 00  00 08 00 00 01 10 00 00  |................|
00000a10  00 00 00 00 00 00 00 00  00 10 00 00 02 1c 00 00  |................|
00000a20  dc 05 00 00 00 00 01 00  18 66 03 00 11 cc 09 00  |.........f......|
00000a30  00 00 00 00 00 1c 00 00  a5 70 00 00 42 32 35 02  |.........p..B25.|
00000a40  d0 05 e7 ff 80 3c e7 ff  e4 29 00 f2 07 66 03 00  |.....<...)...f..|
00000a50  18 66 03 00 18 66 03 00  00 00 00 00 07 05 05 05  |.f...f..........|
00000a60  11 cc 09 00 18 66 03 00  11 cc 09 00 00 00 00 00  |.....f..........|
00000a70  43 72 65 61 74 69 6e 67  20 41 70 70 6c 69 63 61  |Creating Applica|
00000a80  74 69 6f 6e 73 08 6f 6e  11 cc 09 00 18 66 03 00  |tions.on.....f..|
00000a90  00 00 00 00 08 00 00 00  18 66 03 00 00 00 00 00  |.........f......|
00000aa0  0d 00 00 00 00 70 00 00  06 00 00 00 79 56 34 12  |.....p......yV4.|
00000ab0  94 00 00 00 06 00 00 00  00 00 00 00 06 08 00 00  |................|
00000ac0  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
00000ad0  00 10 00 00 02 18 00 00  88 03 00 00 00 00 04 00  |................|
00000ae0  21 01 0e 00 00 00 00 00  00 18 00 00 a5 50 00 00  |!............P..|
00000af0  43 cc 19 02 b0 97 f7 ff  90 c6 f7 ff f8 22 00 02  |C............"..|
00000b00  07 05 05 05 21 01 0e 00  21 01 0e 00 00 00 00 00  |....!...!.......|
00000b10  54 68 65 20 21 41 70 70  42 75 69 6c 64 20 6d 61  |The !AppBuild ma|
00000b20  69 6e 20 77 69 6e 64 6f  77 05 08 08 21 01 0e 00  |in window...!...|
00000b30  00 00 00 00 0d 00 00 00  00 50 00 00 06 00 00 00  |.........P......|
00000b40  79 56 34 12                                       |yV4.|
00000b44