Home » Archimedes archive » Archimedes World » AW-1994-08-Disc1.adf » Disk1Aug94 » !AWAug94/Goodies/Locate/OverWrite/RSI/!RSI/RSI-Info

!AWAug94/Goodies/Locate/OverWrite/RSI/!RSI/RSI-Info

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 » Archimedes World » AW-1994-08-Disc1.adf » Disk1Aug94
Filename: !AWAug94/Goodies/Locate/OverWrite/RSI/!RSI/RSI-Info
Read OK:
File size: 0916 bytes
Load address: 0000
Exec address: 0000
File contents
                          !RSI Documentation.

HOW TO PLAY
===========

   The game involves collecting blocks that are scattered around a room and
putting them into a storage area.  Which sounds simple enough until you see
how they have been arranged.  The blocks are pushed with the Arrow symbol
and this is controlled with the cursor keys.

   The blocks are quite heavy so they have to be collected one at a time.
When all of the blocks in the room have been put away you can progress to
the next room - there are 30 in all.  

DATAFILES
=========
   The original Datafile lifted from the Windows program is called Orig_data
and while it lives in the Maps directory was only used to create the 30 map
files 001 - 030 which are in a format I found easier to look at (but not to
code for!)

   The program expects the Maps directory to be within the !RSI Application
directory.  Each map has a three digit number as its name and the program
will look for 001 then 002 etc. When the next sequence number is missing, 
the program will conclude that this is the end and you have done all the
screens.   So you can reduce or increase the number of screens.

NEW MAPS
========

   You can create your own maps, either adding them to the existing sequence
or replace/rename the maps directory with one of your own.

Using !Edit create files having these characters:-

BB - a block,
WW - a brick for the walls,
OO - a hole to put the blocks in,
^^ - the arrow pointing up,
VV - or down,
<< - or left,
>> - or right.   Only one arrow is required!

Each item on the screen needs two characters in the datafile (including two
spaces for each empty square) I found it easier to visualise the end result
this way.  With one charcter per item it looks too tall and thin.
 
Ensure there is a line of bricks enclosing the whole room otherwise
the game is pointless, and that there are equal numbers of blocks and 
Holes!

There is another directory you can look at: mapsjk this has five screens
that I made.  To use it you will need to rename  Maps to something else
eg. maps_old and rename mapsjk to maps.


ACKNOWLEDGEMENTS
================

        !RSI was written with Huge amounts of help from:
        xLib - ISO Pascal Extension Library by Nick Smith
        and compiled with !Pcompile also by Nick Smith   

John Knight.      

00000000  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000010  20 20 20 20 20 20 20 20  20 20 20 21 52 53 49 20  |           !RSI |
00000020  44 6f 63 75 6d 65 6e 74  61 74 69 6f 6e 2e 0a 0a  |Documentation...|
00000030  48 4f 57 20 54 4f 20 50  4c 41 59 0a 3d 3d 3d 3d  |HOW TO PLAY.====|
00000040  3d 3d 3d 3d 3d 3d 3d 0a  0a 20 20 20 54 68 65 20  |=======..   The |
00000050  67 61 6d 65 20 69 6e 76  6f 6c 76 65 73 20 63 6f  |game involves co|
00000060  6c 6c 65 63 74 69 6e 67  20 62 6c 6f 63 6b 73 20  |llecting blocks |
00000070  74 68 61 74 20 61 72 65  20 73 63 61 74 74 65 72  |that are scatter|
00000080  65 64 20 61 72 6f 75 6e  64 20 61 20 72 6f 6f 6d  |ed around a room|
00000090  20 61 6e 64 0a 70 75 74  74 69 6e 67 20 74 68 65  | and.putting the|
000000a0  6d 20 69 6e 74 6f 20 61  20 73 74 6f 72 61 67 65  |m into a storage|
000000b0  20 61 72 65 61 2e 20 20  57 68 69 63 68 20 73 6f  | area.  Which so|
000000c0  75 6e 64 73 20 73 69 6d  70 6c 65 20 65 6e 6f 75  |unds simple enou|
000000d0  67 68 20 75 6e 74 69 6c  20 79 6f 75 20 73 65 65  |gh until you see|
000000e0  0a 68 6f 77 20 74 68 65  79 20 68 61 76 65 20 62  |.how they have b|
000000f0  65 65 6e 20 61 72 72 61  6e 67 65 64 2e 20 20 54  |een arranged.  T|
00000100  68 65 20 62 6c 6f 63 6b  73 20 61 72 65 20 70 75  |he blocks are pu|
00000110  73 68 65 64 20 77 69 74  68 20 74 68 65 20 41 72  |shed with the Ar|
00000120  72 6f 77 20 73 79 6d 62  6f 6c 0a 61 6e 64 20 74  |row symbol.and t|
00000130  68 69 73 20 69 73 20 63  6f 6e 74 72 6f 6c 6c 65  |his is controlle|
00000140  64 20 77 69 74 68 20 74  68 65 20 63 75 72 73 6f  |d with the curso|
00000150  72 20 6b 65 79 73 2e 0a  0a 20 20 20 54 68 65 20  |r keys...   The |
00000160  62 6c 6f 63 6b 73 20 61  72 65 20 71 75 69 74 65  |blocks are quite|
00000170  20 68 65 61 76 79 20 73  6f 20 74 68 65 79 20 68  | heavy so they h|
00000180  61 76 65 20 74 6f 20 62  65 20 63 6f 6c 6c 65 63  |ave to be collec|
00000190  74 65 64 20 6f 6e 65 20  61 74 20 61 20 74 69 6d  |ted one at a tim|
000001a0  65 2e 0a 57 68 65 6e 20  61 6c 6c 20 6f 66 20 74  |e..When all of t|
000001b0  68 65 20 62 6c 6f 63 6b  73 20 69 6e 20 74 68 65  |he blocks in the|
000001c0  20 72 6f 6f 6d 20 68 61  76 65 20 62 65 65 6e 20  | room have been |
000001d0  70 75 74 20 61 77 61 79  20 79 6f 75 20 63 61 6e  |put away you can|
000001e0  20 70 72 6f 67 72 65 73  73 20 74 6f 0a 74 68 65  | progress to.the|
000001f0  20 6e 65 78 74 20 72 6f  6f 6d 20 2d 20 74 68 65  | next room - the|
00000200  72 65 20 61 72 65 20 33  30 20 69 6e 20 61 6c 6c  |re are 30 in all|
00000210  2e 20 20 0a 0a 44 41 54  41 46 49 4c 45 53 0a 3d  |.  ..DATAFILES.=|
00000220  3d 3d 3d 3d 3d 3d 3d 3d  0a 20 20 20 54 68 65 20  |========.   The |
00000230  6f 72 69 67 69 6e 61 6c  20 44 61 74 61 66 69 6c  |original Datafil|
00000240  65 20 6c 69 66 74 65 64  20 66 72 6f 6d 20 74 68  |e lifted from th|
00000250  65 20 57 69 6e 64 6f 77  73 20 70 72 6f 67 72 61  |e Windows progra|
00000260  6d 20 69 73 20 63 61 6c  6c 65 64 20 4f 72 69 67  |m is called Orig|
00000270  5f 64 61 74 61 0a 61 6e  64 20 77 68 69 6c 65 20  |_data.and while |
00000280  69 74 20 6c 69 76 65 73  20 69 6e 20 74 68 65 20  |it lives in the |
00000290  4d 61 70 73 20 64 69 72  65 63 74 6f 72 79 20 77  |Maps directory w|
000002a0  61 73 20 6f 6e 6c 79 20  75 73 65 64 20 74 6f 20  |as only used to |
000002b0  63 72 65 61 74 65 20 74  68 65 20 33 30 20 6d 61  |create the 30 ma|
000002c0  70 0a 66 69 6c 65 73 20  30 30 31 20 2d 20 30 33  |p.files 001 - 03|
000002d0  30 20 77 68 69 63 68 20  61 72 65 20 69 6e 20 61  |0 which are in a|
000002e0  20 66 6f 72 6d 61 74 20  49 20 66 6f 75 6e 64 20  | format I found |
000002f0  65 61 73 69 65 72 20 74  6f 20 6c 6f 6f 6b 20 61  |easier to look a|
00000300  74 20 28 62 75 74 20 6e  6f 74 20 74 6f 0a 63 6f  |t (but not to.co|
00000310  64 65 20 66 6f 72 21 29  0a 0a 20 20 20 54 68 65  |de for!)..   The|
00000320  20 70 72 6f 67 72 61 6d  20 65 78 70 65 63 74 73  | program expects|
00000330  20 74 68 65 20 4d 61 70  73 20 64 69 72 65 63 74  | the Maps direct|
00000340  6f 72 79 20 74 6f 20 62  65 20 77 69 74 68 69 6e  |ory to be within|
00000350  20 74 68 65 20 21 52 53  49 20 41 70 70 6c 69 63  | the !RSI Applic|
00000360  61 74 69 6f 6e 0a 64 69  72 65 63 74 6f 72 79 2e  |ation.directory.|
00000370  20 20 45 61 63 68 20 6d  61 70 20 68 61 73 20 61  |  Each map has a|
00000380  20 74 68 72 65 65 20 64  69 67 69 74 20 6e 75 6d  | three digit num|
00000390  62 65 72 20 61 73 20 69  74 73 20 6e 61 6d 65 20  |ber as its name |
000003a0  61 6e 64 20 74 68 65 20  70 72 6f 67 72 61 6d 0a  |and the program.|
000003b0  77 69 6c 6c 20 6c 6f 6f  6b 20 66 6f 72 20 30 30  |will look for 00|
000003c0  31 20 74 68 65 6e 20 30  30 32 20 65 74 63 2e 20  |1 then 002 etc. |
000003d0  57 68 65 6e 20 74 68 65  20 6e 65 78 74 20 73 65  |When the next se|
000003e0  71 75 65 6e 63 65 20 6e  75 6d 62 65 72 20 69 73  |quence number is|
000003f0  20 6d 69 73 73 69 6e 67  2c 20 0a 74 68 65 20 70  | missing, .the p|
00000400  72 6f 67 72 61 6d 20 77  69 6c 6c 20 63 6f 6e 63  |rogram will conc|
00000410  6c 75 64 65 20 74 68 61  74 20 74 68 69 73 20 69  |lude that this i|
00000420  73 20 74 68 65 20 65 6e  64 20 61 6e 64 20 79 6f  |s the end and yo|
00000430  75 20 68 61 76 65 20 64  6f 6e 65 20 61 6c 6c 20  |u have done all |
00000440  74 68 65 0a 73 63 72 65  65 6e 73 2e 20 20 20 53  |the.screens.   S|
00000450  6f 20 79 6f 75 20 63 61  6e 20 72 65 64 75 63 65  |o you can reduce|
00000460  20 6f 72 20 69 6e 63 72  65 61 73 65 20 74 68 65  | or increase the|
00000470  20 6e 75 6d 62 65 72 20  6f 66 20 73 63 72 65 65  | number of scree|
00000480  6e 73 2e 0a 0a 4e 45 57  20 4d 41 50 53 0a 3d 3d  |ns...NEW MAPS.==|
00000490  3d 3d 3d 3d 3d 3d 0a 0a  20 20 20 59 6f 75 20 63  |======..   You c|
000004a0  61 6e 20 63 72 65 61 74  65 20 79 6f 75 72 20 6f  |an create your o|
000004b0  77 6e 20 6d 61 70 73 2c  20 65 69 74 68 65 72 20  |wn maps, either |
000004c0  61 64 64 69 6e 67 20 74  68 65 6d 20 74 6f 20 74  |adding them to t|
000004d0  68 65 20 65 78 69 73 74  69 6e 67 20 73 65 71 75  |he existing sequ|
000004e0  65 6e 63 65 0a 6f 72 20  72 65 70 6c 61 63 65 2f  |ence.or replace/|
000004f0  72 65 6e 61 6d 65 20 74  68 65 20 6d 61 70 73 20  |rename the maps |
00000500  64 69 72 65 63 74 6f 72  79 20 77 69 74 68 20 6f  |directory with o|
00000510  6e 65 20 6f 66 20 79 6f  75 72 20 6f 77 6e 2e 0a  |ne of your own..|
00000520  0a 55 73 69 6e 67 20 21  45 64 69 74 20 63 72 65  |.Using !Edit cre|
00000530  61 74 65 20 66 69 6c 65  73 20 68 61 76 69 6e 67  |ate files having|
00000540  20 74 68 65 73 65 20 63  68 61 72 61 63 74 65 72  | these character|
00000550  73 3a 2d 0a 0a 42 42 20  2d 20 61 20 62 6c 6f 63  |s:-..BB - a bloc|
00000560  6b 2c 0a 57 57 20 2d 20  61 20 62 72 69 63 6b 20  |k,.WW - a brick |
00000570  66 6f 72 20 74 68 65 20  77 61 6c 6c 73 2c 0a 4f  |for the walls,.O|
00000580  4f 20 2d 20 61 20 68 6f  6c 65 20 74 6f 20 70 75  |O - a hole to pu|
00000590  74 20 74 68 65 20 62 6c  6f 63 6b 73 20 69 6e 2c  |t the blocks in,|
000005a0  0a 5e 5e 20 2d 20 74 68  65 20 61 72 72 6f 77 20  |.^^ - the arrow |
000005b0  70 6f 69 6e 74 69 6e 67  20 75 70 2c 0a 56 56 20  |pointing up,.VV |
000005c0  2d 20 6f 72 20 64 6f 77  6e 2c 0a 3c 3c 20 2d 20  |- or down,.<< - |
000005d0  6f 72 20 6c 65 66 74 2c  0a 3e 3e 20 2d 20 6f 72  |or left,.>> - or|
000005e0  20 72 69 67 68 74 2e 20  20 20 4f 6e 6c 79 20 6f  | right.   Only o|
000005f0  6e 65 20 61 72 72 6f 77  20 69 73 20 72 65 71 75  |ne arrow is requ|
00000600  69 72 65 64 21 0a 0a 45  61 63 68 20 69 74 65 6d  |ired!..Each item|
00000610  20 6f 6e 20 74 68 65 20  73 63 72 65 65 6e 20 6e  | on the screen n|
00000620  65 65 64 73 20 74 77 6f  20 63 68 61 72 61 63 74  |eeds two charact|
00000630  65 72 73 20 69 6e 20 74  68 65 20 64 61 74 61 66  |ers in the dataf|
00000640  69 6c 65 20 28 69 6e 63  6c 75 64 69 6e 67 20 74  |ile (including t|
00000650  77 6f 0a 73 70 61 63 65  73 20 66 6f 72 20 65 61  |wo.spaces for ea|
00000660  63 68 20 65 6d 70 74 79  20 73 71 75 61 72 65 29  |ch empty square)|
00000670  20 49 20 66 6f 75 6e 64  20 69 74 20 65 61 73 69  | I found it easi|
00000680  65 72 20 74 6f 20 76 69  73 75 61 6c 69 73 65 20  |er to visualise |
00000690  74 68 65 20 65 6e 64 20  72 65 73 75 6c 74 0a 74  |the end result.t|
000006a0  68 69 73 20 77 61 79 2e  20 20 57 69 74 68 20 6f  |his way.  With o|
000006b0  6e 65 20 63 68 61 72 63  74 65 72 20 70 65 72 20  |ne charcter per |
000006c0  69 74 65 6d 20 69 74 20  6c 6f 6f 6b 73 20 74 6f  |item it looks to|
000006d0  6f 20 74 61 6c 6c 20 61  6e 64 20 74 68 69 6e 2e  |o tall and thin.|
000006e0  0a 20 0a 45 6e 73 75 72  65 20 74 68 65 72 65 20  |. .Ensure there |
000006f0  69 73 20 61 20 6c 69 6e  65 20 6f 66 20 62 72 69  |is a line of bri|
00000700  63 6b 73 20 65 6e 63 6c  6f 73 69 6e 67 20 74 68  |cks enclosing th|
00000710  65 20 77 68 6f 6c 65 20  72 6f 6f 6d 20 6f 74 68  |e whole room oth|
00000720  65 72 77 69 73 65 0a 74  68 65 20 67 61 6d 65 20  |erwise.the game |
00000730  69 73 20 70 6f 69 6e 74  6c 65 73 73 2c 20 61 6e  |is pointless, an|
00000740  64 20 74 68 61 74 20 74  68 65 72 65 20 61 72 65  |d that there are|
00000750  20 65 71 75 61 6c 20 6e  75 6d 62 65 72 73 20 6f  | equal numbers o|
00000760  66 20 62 6c 6f 63 6b 73  20 61 6e 64 20 0a 48 6f  |f blocks and .Ho|
00000770  6c 65 73 21 0a 0a 54 68  65 72 65 20 69 73 20 61  |les!..There is a|
00000780  6e 6f 74 68 65 72 20 64  69 72 65 63 74 6f 72 79  |nother directory|
00000790  20 79 6f 75 20 63 61 6e  20 6c 6f 6f 6b 20 61 74  | you can look at|
000007a0  3a 20 6d 61 70 73 6a 6b  20 74 68 69 73 20 68 61  |: mapsjk this ha|
000007b0  73 20 66 69 76 65 20 73  63 72 65 65 6e 73 0a 74  |s five screens.t|
000007c0  68 61 74 20 49 20 6d 61  64 65 2e 20 20 54 6f 20  |hat I made.  To |
000007d0  75 73 65 20 69 74 20 79  6f 75 20 77 69 6c 6c 20  |use it you will |
000007e0  6e 65 65 64 20 74 6f 20  72 65 6e 61 6d 65 20 20  |need to rename  |
000007f0  4d 61 70 73 20 74 6f 20  73 6f 6d 65 74 68 69 6e  |Maps to somethin|
00000800  67 20 65 6c 73 65 0a 65  67 2e 20 6d 61 70 73 5f  |g else.eg. maps_|
00000810  6f 6c 64 20 61 6e 64 20  72 65 6e 61 6d 65 20 6d  |old and rename m|
00000820  61 70 73 6a 6b 20 74 6f  20 6d 61 70 73 2e 0a 0a  |apsjk to maps...|
00000830  0a 41 43 4b 4e 4f 57 4c  45 44 47 45 4d 45 4e 54  |.ACKNOWLEDGEMENT|
00000840  53 0a 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |S.==============|
00000850  3d 3d 0a 0a 20 20 20 20  20 20 20 20 21 52 53 49  |==..        !RSI|
00000860  20 77 61 73 20 77 72 69  74 74 65 6e 20 77 69 74  | was written wit|
00000870  68 20 48 75 67 65 20 61  6d 6f 75 6e 74 73 20 6f  |h Huge amounts o|
00000880  66 20 68 65 6c 70 20 66  72 6f 6d 3a 0a 20 20 20  |f help from:.   |
00000890  20 20 20 20 20 78 4c 69  62 20 2d 20 49 53 4f 20  |     xLib - ISO |
000008a0  50 61 73 63 61 6c 20 45  78 74 65 6e 73 69 6f 6e  |Pascal Extension|
000008b0  20 4c 69 62 72 61 72 79  20 62 79 20 4e 69 63 6b  | Library by Nick|
000008c0  20 53 6d 69 74 68 0a 20  20 20 20 20 20 20 20 61  | Smith.        a|
000008d0  6e 64 20 63 6f 6d 70 69  6c 65 64 20 77 69 74 68  |nd compiled with|
000008e0  20 21 50 63 6f 6d 70 69  6c 65 20 61 6c 73 6f 20  | !Pcompile also |
000008f0  62 79 20 4e 69 63 6b 20  53 6d 69 74 68 20 20 20  |by Nick Smith   |
00000900  0a 0a 4a 6f 68 6e 20 4b  6e 69 67 68 74 2e 20 20  |..John Knight.  |
00000910  20 20 20 20 0a 0a                                 |    ..|
00000916