home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsc / cpc / !CPC_Demo / !Help < prev    next >
Text File  |  1996-02-14  |  15KB  |  331 lines
  1.  
  2.  !CPC_Demo - An Amstrad CPC emulator for Acorn RISC OS machines (demo)
  3.  =====================================================================
  4.  
  5. [For information on the full version of this emulator, !CPC, see
  6. the end of this document.]
  7.  
  8. Copyright
  9. ---------
  10.  
  11. !CPC_Demo is Copyright (C) 1996 Mark RISON.  This copyright extends to
  12. all the files provided in or with !CPC_Demo, except the ROM images
  13. below.  The BASIC and OS ROM images are copyright Amstrad and Locomotive
  14. Software, and are distributed with their kind permission.  The AMSDOS
  15. ROM image is copyright Amstrad and Digital Research (Novell), and is
  16. distributed with their kind permission (well, Amstrad's at least...).
  17.  
  18. Conditions of use
  19. -----------------
  20.  
  21. You may only use !CPC_Demo for your own personal and non-commercial
  22. purposes.  You may freely distribute !CPC_Demo (including by FTP or BBS)
  23. provided you do not modify it in any way (you must distribute it in its
  24. entirety, including this file), and do not charge anything, either
  25. directly or indirectly.  You may not, however, put !CPC_Demo on CD
  26. without explicit permission.
  27.  
  28. No guarantee of any kind is made concerning operation of !CPC_Demo.  You
  29. use !CPC_Demo at your own risk; you are advised to save all your work
  30. before launching !CPC_Demo.
  31.  
  32. Introduction
  33. ------------
  34.  
  35. The Amstrad CPC range of computers was a hugely successful range of
  36. 8-bit computers.  There were 3 models.  The CPC464 was released in 1984
  37. and consisted of a central unit, a cassette unit and a monitor in one
  38. package.  The CPC664 was released in 1985, and had a 3" disc drive
  39. instead of the cassette unit.  The CPC6128 was released soon after, the
  40. only significant difference being the addition of 64K of bank-switched
  41. RAM.
  42.  
  43. All models were based around a Z80 CPU running at an effective 3.3 MHz.
  44. There was 64K of main RAM and 32K of ROM to contain the BASIC and OS;
  45. the disc drive models had an extra 16K ROM to hold the DOS, and the 6128
  46. had an extra 64K of RAM.  The screen could be operated in one of three
  47. modes: 640x200 in 2 colours, 320x200 in 4 colours, and 160x200 in 16
  48. colours -- from a palette of 27 colours (27 greens on the green screen
  49. models).  Sound capabilities ran to 3 channels with noise and hardware
  50. enveloping if desired.  Two joysticks could be used with the machine. 
  51. CP/M was an option on the disc models (CP/M 2.2 on both, and CP/M+ on
  52. the 6128).
  53.  
  54. !CPC_Demo aims to emulate a real CPC in sufficient detail to allow
  55. programs written for the CPC to be used under RISC OS.  This entails
  56. quite considerable translation from the CPC world to the RISC OS world;
  57. nonetheless !CPC_Demo is roughly as fast as the real thing on machines
  58. with an ARM3 (and faster with newer machines).
  59.  
  60. A reminder of RISC OS operations
  61. --------------------------------
  62.  
  63. To open a RISC OS directory, double-click on it.  If it's an application
  64. (it's got a ! at the start), press Shift as well, else the application
  65. will be run.  To copy files from one directory to another, open both and
  66. drag from one to the other.  To load a given file into a text editor
  67. (e.g. !Edit) double-click on it while pressing Shift -- when you've
  68. finished the editing pressing F3 followed by Return should save the
  69. edited version.  Finally, to access the command line (to type *
  70. commands, setting variables, for example), press F12 -- when you've
  71. finished press Return on its own.
  72.  
  73. File formats
  74. ------------
  75.  
  76. The most common file format (after dearchiving) is the disc image
  77. format.  This can be recognised by filenames ending in .DSK (/DSK under
  78. the standard DOS mapping).  Discs must be used under AMSDOS (see below)
  79. -- use CAT to see what's on them, and something like RUN"MEGADETH" to
  80. run them (file extensions need not normally be specified).  Do not
  81. attempt to write to discs: !CPC_Demo does not support this at present. 
  82. Discs should be placed in the subdirectory Discs in !CPC_Demo.  If you
  83. set a disc's filetype to "CPC disc" (&065 at present), double-clicking on
  84. the disc with launch !CPC_Demo with it.
  85.  
  86. Another file format is the snapshot format, recognisable by filenames
  87. ending in .SNA (/SNA).  Snaps must be used under PseuDOS (see below). 
  88. Use |SNAP,"MEGADETH" to launch snapshot MEGADETH.  Snaps should be
  89. placed in the subdirectory Snaps in !CPC_Demo.  If you set a snap's
  90. filetype to "CPC snap" (&064 at present), double-clicking on the snap
  91. will launch !CPC_Demo with it.  |SNAPS will give a list of snapshots.
  92.  
  93. The last file format is the native AMSDOS format, consisting of one or
  94. more files with filenames typically ending in .BAS or .BIN.  These need
  95. to be converted to PseuDOS format using !AmsToArc (see below), and
  96. placed in the subdirectory Tapes in !CPC_Demo.  These programs are
  97. typically launched with RUN"MEGADETH".
  98.  
  99. Using !CPC_Demo
  100. ---------------
  101.  
  102. !CPC_Demo should mostly behave just like a real CPC!  !CPC_Demo has some
  103. extra features, however.  You can reset the CPC not only using
  104. Shift-Ctrl-Esc, but also by pressing Alt-Esc (you may need to try a few
  105. times for this to work).  You can quit !CPC_Demo by pressing Alt-F12, or
  106. by typing |QUIT (if you're using PseuDOS and not AMSDOS).
  107.  
  108. One joystick is emulated, using Insert, Home, Page Up, Page Down, Num
  109. Lock and keypad / for left, right, up, down, main fire and secondary
  110. fire respectively.  !CPC_Demo also supports two standard Acorn
  111. joysticks, as found on the A3010, which will behave just like CPC
  112. joysticks.
  113.  
  114. If a program seems to be attempting to constantly change the screen
  115. colours, you can press Alt-P to lock out changes.  You can try this a
  116. few times until you get a suitable palette.  If a program seems to be
  117. attempting to constantly change the screen resolution, you can press
  118. Alt-M to lock out changes -- again, you can keep trying until the bit
  119. you're interested in appears right.
  120.  
  121. You can squeeze extra performance out of !CPC by running in MODE 12
  122. rather than a higher resolution mode such as MODE 20.  This is
  123. especially the case for games which use screen banking for smooth
  124. animation -- symptoms are faint horizontal interleave patterns on the
  125. screen.  In certain cases, turning palette switching off (with Alt-P)
  126. will also speed things up.
  127.  
  128. If the machine seems to hang and neither Alt-Esc nor Alt-F12 seem to get
  129. things back under control, you can attempt to kill the emulator off
  130. with Alt-Delete.  This should be a solution of last resort!  If even
  131. this does not seem to help, well ... you were advised to save all your
  132. work before launching !CPC_Demo, weren't you?
  133.  
  134. PseuDOS and AMSDOS
  135. ------------------
  136.  
  137. AMSDOS is the original DOS provided with disc models.  It supports discs
  138. containing about 170K of data.  Various | commands are provided by it to
  139. handle disc files (|ERA, |REN, etc.).  !CPC_Demo only supports enough of
  140. AMSDOS to get standard disc images to load -- complex disc operations,
  141. as well as writing, will fail.  To use AMSDOS the system variable
  142. CPC$DOS should be set to AMSDOS (use *SET CPC$DOS AMSDOS from the
  143. command line to do so).  The disc to be used can be set in CPC$Disc
  144. (e.g. *SET CPC$Disc Megadeth); alternatively, if this variable is not
  145. set, a list of available discs will be given, and you will be asked to
  146. choose one.
  147.  
  148. PseuDOS is a DOS whose purpose is to allow 'tape' files to be used.
  149. These files are held as RISC OS files in a special format.  PseuDOS
  150. provides full access to these files, both in reading and in writing. In
  151. addition, PseuDOS redefines the CPC keyboard mappings to follow the UK
  152. RISC OS keyboard -- so if you're using AMSDOS some keys will be wrong
  153. (in particular, " will be obtained with Shift-2).  To use PseuDOS the
  154. system variable CPC$DOS should be set to PseuDOS (*SET CPC$DOS PseuDOS). 
  155. !AmsToArc (as found in the Support subdirectory in !CPC_Demo) should be
  156. used to make PseuDOS format files -- see the help file there for more
  157. details.
  158.  
  159. CheckSnap and CheckDisc, as found in the Support subdirectory, allow you
  160. to check whether a snap or a disc is broken in some way.  Simply
  161. double-click to launch, and give the name of the snap or disc to be
  162. checked when prompted.
  163.  
  164. Treat both AMSDOS and PseuDOS with care -- don't do unexpected things.
  165. For example, if you are using floppy discs, try to keep the disc in the
  166. drive all the time.  If you are saving under