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

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

Make sure you load the floating point emulator, which is contained within
your !System folder before running this program.


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 2a  |Documentation..*|
00000030  2a 2a 50 6c 65 61 73 65  20 4e 6f 74 65 2a 2a 2a  |**Please Note***|
00000040  0a 0a 4d 61 6b 65 20 73  75 72 65 20 79 6f 75 20  |..Make sure you |
00000050  6c 6f 61 64 20 74 68 65  20 66 6c 6f 61 74 69 6e  |load the floatin|
00000060  67 20 70 6f 69 6e 74 20  65 6d 75 6c 61 74 6f 72  |g point emulator|
00000070  2c 20 77 68 69 63 68 20  69 73 20 63 6f 6e 74 61  |, which is conta|
00000080  69 6e 65 64 20 77 69 74  68 69 6e 0a 79 6f 75 72  |ined within.your|
00000090  20 21 53 79 73 74 65 6d  20 66 6f 6c 64 65 72 20  | !System folder |
000000a0  62 65 66 6f 72 65 20 72  75 6e 6e 69 6e 67 20 74  |before running t|
000000b0  68 69 73 20 70 72 6f 67  72 61 6d 2e 0a 0a 0a 48  |his program....H|
000000c0  4f 57 20 54 4f 20 50 4c  41 59 0a 3d 3d 3d 3d 3d  |OW TO PLAY.=====|
000000d0  3d 3d 3d 3d 3d 3d 0a 0a  20 20 20 54 68 65 20 67  |======..   The g|
000000e0  61 6d 65 20 69 6e 76 6f  6c 76 65 73 20 63 6f 6c  |ame involves col|
000000f0  6c 65 63 74 69 6e 67 20  62 6c 6f 63 6b 73 20 74  |lecting blocks t|
00000100  68 61 74 20 61 72 65 20  73 63 61 74 74 65 72 65  |hat are scattere|
00000110  64 20 61 72 6f 75 6e 64  20 61 20 72 6f 6f 6d 20  |d around a room |
00000120  61 6e 64 0a 70 75 74 74  69 6e 67 20 74 68 65 6d  |and.putting them|
00000130  20 69 6e 74 6f 20 61 20  73 74 6f 72 61 67 65 20  | into a storage |
00000140  61 72 65 61 2e 20 20 57  68 69 63 68 20 73 6f 75  |area.  Which sou|
00000150  6e 64 73 20 73 69 6d 70  6c 65 20 65 6e 6f 75 67  |nds simple enoug|
00000160  68 20 75 6e 74 69 6c 20  79 6f 75 20 73 65 65 0a  |h until you see.|
00000170  68 6f 77 20 74 68 65 79  20 68 61 76 65 20 62 65  |how they have be|
00000180  65 6e 20 61 72 72 61 6e  67 65 64 2e 20 20 54 68  |en arranged.  Th|
00000190  65 20 62 6c 6f 63 6b 73  20 61 72 65 20 70 75 73  |e blocks are pus|
000001a0  68 65 64 20 77 69 74 68  20 74 68 65 20 41 72 72  |hed with the Arr|
000001b0  6f 77 20 73 79 6d 62 6f  6c 0a 61 6e 64 20 74 68  |ow symbol.and th|
000001c0  69 73 20 69 73 20 63 6f  6e 74 72 6f 6c 6c 65 64  |is is controlled|
000001d0  20 77 69 74 68 20 74 68  65 20 63 75 72 73 6f 72  | with the cursor|
000001e0  20 6b 65 79 73 2e 0a 0a  20 20 20 54 68 65 20 62  | keys...   The b|
000001f0  6c 6f 63 6b 73 20 61 72  65 20 71 75 69 74 65 20  |locks are quite |
00000200  68 65 61 76 79 20 73 6f  20 74 68 65 79 20 68 61  |heavy so they ha|
00000210  76 65 20 74 6f 20 62 65  20 63 6f 6c 6c 65 63 74  |ve to be collect|
00000220  65 64 20 6f 6e 65 20 61  74 20 61 20 74 69 6d 65  |ed one at a time|
00000230  2e 0a 57 68 65 6e 20 61  6c 6c 20 6f 66 20 74 68  |..When all of th|
00000240  65 20 62 6c 6f 63 6b 73  20 69 6e 20 74 68 65 20  |e blocks in the |
00000250  72 6f 6f 6d 20 68 61 76  65 20 62 65 65 6e 20 70  |room have been p|
00000260  75 74 20 61 77 61 79 20  79 6f 75 20 63 61 6e 20  |ut away you can |
00000270  70 72 6f 67 72 65 73 73  20 74 6f 0a 74 68 65 20  |progress to.the |
00000280  6e 65 78 74 20 72 6f 6f  6d 20 2d 20 74 68 65 72  |next room - ther|
00000290  65 20 61 72 65 20 33 30  20 69 6e 20 61 6c 6c 2e  |e are 30 in all.|
000002a0  20 20 0a 0a 44 41 54 41  46 49 4c 45 53 0a 3d 3d  |  ..DATAFILES.==|
000002b0  3d 3d 3d 3d 3d 3d 3d 0a  20 20 20 54 68 65 20 6f  |=======.   The o|
000002c0  72 69 67 69 6e 61 6c 20  44 61 74 61 66 69 6c 65  |riginal Datafile|
000002d0  20 6c 69 66 74 65 64 20  66 72 6f 6d 20 74 68 65  | lifted from the|
000002e0  20 57 69 6e 64 6f 77 73  20 70 72 6f 67 72 61 6d  | Windows program|
000002f0  20 69 73 20 63 61 6c 6c  65 64 20 4f 72 69 67 5f  | is called Orig_|
00000300  64 61 74 61 0a 61 6e 64  20 77 68 69 6c 65 20 69  |data.and while i|
00000310  74 20 6c 69 76 65 73 20  69 6e 20 74 68 65 20 4d  |t lives in the M|
00000320  61 70 73 20 64 69 72 65  63 74 6f 72 79 20 77 61  |aps directory wa|
00000330  73 20 6f 6e 6c 79 20 75  73 65 64 20 74 6f 20 63  |s only used to c|
00000340  72 65 61 74 65 20 74 68  65 20 33 30 20 6d 61 70  |reate the 30 map|
00000350  0a 66 69 6c 65 73 20 30  30 31 20 2d 20 30 33 30  |.files 001 - 030|
00000360  20 77 68 69 63 68 20 61  72 65 20 69 6e 20 61 20  | which are in a |
00000370  66 6f 72 6d 61 74 20 49  20 66 6f 75 6e 64 20 65  |format I found e|
00000380  61 73 69 65 72 20 74 6f  20 6c 6f 6f 6b 20 61 74  |asier to look at|
00000390  20 28 62 75 74 20 6e 6f  74 20 74 6f 0a 63 6f 64  | (but not to.cod|
000003a0  65 20 66 6f 72 21 29 0a  0a 20 20 20 54 68 65 20  |e for!)..   The |
000003b0  70 72 6f 67 72 61 6d 20  65 78 70 65 63 74 73 20  |program expects |
000003c0  74 68 65 20 4d 61 70 73  20 64 69 72 65 63 74 6f  |the Maps directo|
000003d0  72 79 20 74 6f 20 62 65  20 77 69 74 68 69 6e 20  |ry to be within |
000003e0  74 68 65 20 21 52 53 49  20 41 70 70 6c 69 63 61  |the !RSI Applica|
000003f0  74 69 6f 6e 0a 64 69 72  65 63 74 6f 72 79 2e 20  |tion.directory. |
00000400  20 45 61 63 68 20 6d 61  70 20 68 61 73 20 61 20  | Each map has a |
00000410  74 68 72 65 65 20 64 69  67 69 74 20 6e 75 6d 62  |three digit numb|
00000420  65 72 20 61 73 20 69 74  73 20 6e 61 6d 65 20 61  |er as its name a|
00000430  6e 64 20 74 68 65 20 70  72 6f 67 72 61 6d 0a 77  |nd the program.w|
00000440  69 6c 6c 20 6c 6f 6f 6b  20 66 6f 72 20 30 30 31  |ill look for 001|
00000450  20 74 68 65 6e 20 30 30  32 20 65 74 63 2e 20 57  | then 002 etc. W|
00000460  68 65 6e 20 74 68 65 20  6e 65 78 74 20 73 65 71  |hen the next seq|
00000470  75 65 6e 63 65 20 6e 75  6d 62 65 72 20 69 73 20  |uence number is |
00000480  6d 69 73 73 69 6e 67 2c  20 0a 74 68 65 20 70 72  |missing, .the pr|
00000490  6f 67 72 61 6d 20 77 69  6c 6c 20 63 6f 6e 63 6c  |ogram will concl|
000004a0  75 64 65 20 74 68 61 74  20 74 68 69 73 20 69 73  |ude that this is|
000004b0  20 74 68 65 20 65 6e 64  20 61 6e 64 20 79 6f 75  | the end and you|
000004c0  20 68 61 76 65 20 64 6f  6e 65 20 61 6c 6c 20 74  | have done all t|
000004d0  68 65 0a 73 63 72 65 65  6e 73 2e 20 20 20 53 6f  |he.screens.   So|
000004e0  20 79 6f 75 20 63 61 6e  20 72 65 64 75 63 65 20  | you can reduce |
000004f0  6f 72 20 69 6e 63 72 65  61 73 65 20 74 68 65 20  |or increase the |
00000500  6e 75 6d 62 65 72 20 6f  66 20 73 63 72 65 65 6e  |number of screen|
00000510  73 2e 0a 0a 4e 45 57 20  4d 41 50 53 0a 3d 3d 3d  |s...NEW MAPS.===|
00000520  3d 3d 3d 3d 3d 0a 0a 20  20 20 59 6f 75 20 63 61  |=====..   You ca|
00000530  6e 20 63 72 65 61 74 65  20 79 6f 75 72 20 6f 77  |n create your ow|
00000540  6e 20 6d 61 70 73 2c 20  65 69 74 68 65 72 20 61  |n maps, either a|
00000550  64 64 69 6e 67 20 74 68  65 6d 20 74 6f 20 74 68  |dding them to th|
00000560  65 20 65 78 69 73 74 69  6e 67 20 73 65 71 75 65  |e existing seque|
00000570  6e 63 65 0a 6f 72 20 72  65 70 6c 61 63 65 2f 72  |nce.or replace/r|
00000580  65 6e 61 6d 65 20 74 68  65 20 6d 61 70 73 20 64  |ename the maps d|
00000590  69 72 65 63 74 6f 72 79  20 77 69 74 68 20 6f 6e  |irectory with on|
000005a0  65 20 6f 66 20 79 6f 75  72 20 6f 77 6e 2e 0a 0a  |e of your own...|
000005b0  55 73 69 6e 67 20 21 45  64 69 74 20 63 72 65 61  |Using !Edit crea|
000005c0  74 65 20 66 69 6c 65 73  20 68 61 76 69 6e 67 20  |te files having |
000005d0  74 68 65 73 65 20 63 68  61 72 61 63 74 65 72 73  |these characters|
000005e0  3a 2d 0a 0a 42 42 20 2d  20 61 20 62 6c 6f 63 6b  |:-..BB - a block|
000005f0  2c 0a 57 57 20 2d 20 61  20 62 72 69 63 6b 20 66  |,.WW - a brick f|
00000600  6f 72 20 74 68 65 20 77  61 6c 6c 73 2c 0a 4f 4f  |or the walls,.OO|
00000610  20 2d 20 61 20 68 6f 6c  65 20 74 6f 20 70 75 74  | - a hole to put|
00000620  20 74 68 65 20 62 6c 6f  63 6b 73 20 69 6e 2c 0a  | the blocks in,.|
00000630  5e 5e 20 2d 20 74 68 65  20 61 72 72 6f 77 20 70  |^^ - the arrow p|
00000640  6f 69 6e 74 69 6e 67 20  75 70 2c 0a 56 56 20 2d  |ointing up,.VV -|
00000650  20 6f 72 20 64 6f 77 6e  2c 0a 3c 3c 20 2d 20 6f  | or down,.<< - o|
00000660  72 20 6c 65 66 74 2c 0a  3e 3e 20 2d 20 6f 72 20  |r left,.>> - or |
00000670  72 69 67 68 74 2e 20 20  20 4f 6e 6c 79 20 6f 6e  |right.   Only on|
00000680  65 20 61 72 72 6f 77 20  69 73 20 72 65 71 75 69  |e arrow is requi|
00000690  72 65 64 21 0a 0a 45 61  63 68 20 69 74 65 6d 20  |red!..Each item |
000006a0  6f 6e 20 74 68 65 20 73  63 72 65 65 6e 20 6e 65  |on the screen ne|
000006b0  65 64 73 20 74 77 6f 20  63 68 61 72 61 63 74 65  |eds two characte|
000006c0  72 73 20 69 6e 20 74 68  65 20 64 61 74 61 66 69  |rs in the datafi|
000006d0  6c 65 20 28 69 6e 63 6c  75 64 69 6e 67 20 74 77  |le (including tw|
000006e0  6f 0a 73 70 61 63 65 73  20 66 6f 72 20 65 61 63  |o.spaces for eac|
000006f0  68 20 65 6d 70 74 79 20  73 71 75 61 72 65 29 20  |h empty square) |
00000700  49 20 66 6f 75 6e 64 20  69 74 20 65 61 73 69 65  |I found it easie|
00000710  72 20 74 6f 20 76 69 73  75 61 6c 69 73 65 20 74  |r to visualise t|
00000720  68 65 20 65 6e 64 20 72  65 73 75 6c 74 0a 74 68  |he end result.th|
00000730  69 73 20 77 61 79 2e 20  20 57 69 74 68 20 6f 6e  |is way.  With on|
00000740  65 20 63 68 61 72 63 74  65 72 20 70 65 72 20 69  |e charcter per i|
00000750  74 65 6d 20 69 74 20 6c  6f 6f 6b 73 20 74 6f 6f  |tem it looks too|
00000760  20 74 61 6c 6c 20 61 6e  64 20 74 68 69 6e 2e 0a  | tall and thin..|
00000770  20 0a 45 6e 73 75 72 65  20 74 68 65 72 65 20 69  | .Ensure there i|
00000780  73 20 61 20 6c 69 6e 65  20 6f 66 20 62 72 69 63  |s a line of bric|
00000790  6b 73 20 65 6e 63 6c 6f  73 69 6e 67 20 74 68 65  |ks enclosing the|
000007a0  20 77 68 6f 6c 65 20 72  6f 6f 6d 20 6f 74 68 65  | whole room othe|
000007b0  72 77 69 73 65 0a 74 68  65 20 67 61 6d 65 20 69  |rwise.the game i|
000007c0  73 20 70 6f 69 6e 74 6c  65 73 73 2c 20 61 6e 64  |s pointless, and|
000007d0  20 74 68 61 74 20 74 68  65 72 65 20 61 72 65 20  | that there are |
000007e0  65 71 75 61 6c 20 6e 75  6d 62 65 72 73 20 6f 66  |equal numbers of|
000007f0  20 62 6c 6f 63 6b 73 20  61 6e 64 20 0a 48 6f 6c  | blocks and .Hol|
00000800  65 73 21 0a 0a 54 68 65  72 65 20 69 73 20 61 6e  |es!..There is an|
00000810  6f 74 68 65 72 20 64 69  72 65 63 74 6f 72 79 20  |other directory |
00000820  79 6f 75 20 63 61 6e 20  6c 6f 6f 6b 20 61 74 3a  |you can look at:|
00000830  20 6d 61 70 73 6a 6b 20  74 68 69 73 20 68 61 73  | mapsjk this has|
00000840  20 66 69 76 65 20 73 63  72 65 65 6e 73 0a 74 68  | five screens.th|
00000850  61 74 20 49 20 6d 61 64  65 2e 20 20 54 6f 20 75  |at I made.  To u|
00000860  73 65 20 69 74 20 79 6f  75 20 77 69 6c 6c 20 6e  |se it you will n|
00000870  65 65 64 20 74 6f 20 72  65 6e 61 6d 65 20 20 4d  |eed to rename  M|
00000880  61 70 73 20 74 6f 20 73  6f 6d 65 74 68 69 6e 67  |aps to something|
00000890  20 65 6c 73 65 0a 65 67  2e 20 6d 61 70 73 5f 6f  | else.eg. maps_o|
000008a0  6c 64 20 61 6e 64 20 72  65 6e 61 6d 65 20 6d 61  |ld and rename ma|
000008b0  70 73 6a 6b 20 74 6f 20  6d 61 70 73 2e 0a 0a 0a  |psjk to maps....|
000008c0  41 43 4b 4e 4f 57 4c 45  44 47 45 4d 45 4e 54 53  |ACKNOWLEDGEMENTS|
000008d0  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
000008e0  3d 0a 0a 20 20 20 20 20  20 20 20 21 52 53 49 20  |=..        !RSI |
000008f0  77 61 73 20 77 72 69 74  74 65 6e 20 77 69 74 68  |was written with|
00000900  20 48 75 67 65 20 61 6d  6f 75 6e 74 73 20 6f 66  | Huge amounts of|
00000910  20 68 65 6c 70 20 66 72  6f 6d 3a 0a 20 20 20 20  | help from:.    |
00000920  20 20 20 20 78 4c 69 62  20 2d 20 49 53 4f 20 50  |    xLib - ISO P|
00000930  61 73 63 61 6c 20 45 78  74 65 6e 73 69 6f 6e 20  |ascal Extension |
00000940  4c 69 62 72 61 72 79 20  62 79 20 4e 69 63 6b 20  |Library by Nick |
00000950  53 6d 69 74 68 0a 20 20  20 20 20 20 20 20 61 6e  |Smith.        an|
00000960  64 20 63 6f 6d 70 69 6c  65 64 20 77 69 74 68 20  |d compiled with |
00000970  21 50 63 6f 6d 70 69 6c  65 20 61 6c 73 6f 20 62  |!Pcompile also b|
00000980  79 20 4e 69 63 6b 20 53  6d 69 74 68 20 20 20 0a  |y Nick Smith   .|
00000990  0a 4a 6f 68 6e 20 4b 6e  69 67 68 74 2e 20 20 20  |.John Knight.   |
000009a0  20 20 20 0a 0a                                    |   ..|
000009a5