home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / games / mzx / !SPConv / !Help < prev    next >
PGP Signed Message  |  1995-06-14  |  12KB  |  264 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3. !SPConv - RISC-OS version (1.10), based on SPConv (version 1.08)
  4. ================================================================
  5.  
  6. Purpose: To convert ZX Spectrum 'snapshot' images to and from different
  7.          formats.
  8.  
  9. Details: A ZX Spectrum 'snapshot' is a memory dump of a Sinclair ZX Spectrum
  10.          computer suitable for use with a ZX Spectrum emulator (common on many
  11.          machines now). The RISC-OS platforms have several such emulators
  12.          (listed below).
  13.          This application allows the user to convert different formats of
  14.          spectrum snapshots to other versions.
  15.  
  16.          For full documentation on the converter itself, the different
  17.          snapshot formats and the original CLI version (and its author), see
  18.          the documents in the directory 'Docs' inside this application.
  19.          (Hold down SHIFT and double-click on the application in a filer
  20.          window to gain access to it).
  21.  
  22.          This version is a wimp version for RISC-OS that deals with a drag-
  23.          and-drop interface and a simple dialogue box to choose the format
  24.          to convert to. The original version is a command-line based version.
  25.          Support for interactive help on windows and icons is also provided as
  26.          well as a help menu option.
  27.  
  28.          The main program (SPconv-FE.c) is a front end to 'ROS-SPConv.c'
  29.          (a modified version of 'SPConv.c').
  30.  
  31. Installation:
  32.          To install, just drag the application from the archive onto
  33.          a destination filer window to copy it.
  34.          Using a suitable archive filing system (eg. ArcFS), !SPConv should
  35.          run from within an archive.
  36.          If there are problems de-archiving or running in archives, then
  37.          try de-archiving with !Spark or !SparkPlug.
  38.  
  39. Usage:   1) Install the application on the icon bar by 'double-clicking' on the
  40.             application in a filer window.
  41.          2) Drag a snapshot file of a suitable filetype (see below for info on
  42.             filetypes) onto the icon bar application and a convert dialogue
  43.             window will pop-up.
  44.          3) Select the file format to convert to by clicking on the suitable
  45.             option. (If new 'filetypes' are needed for Z80 or SNA files, then
  46.             'uncheck' the "Old-format Z80/SNA files" box by clicking on it.
  47.             see the 'filetype' info below for more information on this).
  48.          4) Now click on the 'Convert' icon to start the conversion.
  49.             (Click on the 'Cancel' icon to abandon the conversion).
  50.          5) A 'save-as' window will pop-up allowing you to save your file
  51.             to a filer window in the normal RISC-OS manner.
  52.  
  53.  
  54. File Types:
  55.          You must 'file-type' your snapshot files under RISC-OS for them to
  56.          be accepted by !SPConv.
  57.          Use the filer menu under the 'file' submenu and 'set type' and
  58.          specify one of the filetypes below.
  59.          When using !MZX (at least up to version 1.10), set the file types
  60.          for Z80 to Z80old (or CEE) and for SNA to SNAold (or CEF). 
  61.          
  62.          The filetypes are the RISC-OS equivalent to the file extensions
  63.          used on versions of 'spconv' on other machines.
  64.          I have used the following file types for the moment, based on the
  65.          types used in the Spectrum emulators for RISC-OS machines...
  66.  
  67.      Filetype      :  Hex equivalent
  68.      ---------------------------------------------------
  69.          Z80 & Z80old  :  BA0 & CEE       (Z80 snapshot)
  70.          SNA & SNAold  :  BA1 & CEF       (SNA snapshot)
  71.          SP            :  225             (SP snapshot)
  72.          PRG           :  226             (PRG snapshot)
  73.          ZX            :  227             (ZX/KGB snapshot)
  74.          SpecProg      :  702             (ACH snapshot)
  75.          RAWsnap       :  701             (RAW file)
  76.          <unknown/data>:  FFD             (Unknown type)
  77.          
  78.          Note that the filetypes BA0 and BA1 are official Acorn filetypes,
  79.          but that current Acorn emulators (as of June 1995) do not use them.
  80.          For this reason, there is an option provided to choose between new
  81.          and old style filetypes for Z80 and SNA files.
  82.          The current default is to use the old formats which are compatible
  83.          with current versions of emulators such as !MZX.
  84.          
  85.      The output filetype is fairly irrelevent when moving the files to
  86.      another machine, though the can help you identify what they are
  87.      before copying, for example, onto a DOS disc.
  88.     
  89.      Note that these filetypes do not distinguish different versions
  90.      of 'snapshots', such as different versions of the Z80 snapshot.
  91.      The converter *should* try to deal with them.
  92.  
  93.          If you don't know what type the file should be then it may be
  94.          a RAW file. Try either RAWsnap (701) filetype or just plain
  95.          Data (FFD).
  96.          If it is a RAW file, then the converter will attempt to convert
  97.          these if possible.
  98.          If not, try each of the above types (SNA & Z80 being the most common).
  99.          
  100.  
  101.  
  102. !Scrap:  RISC-OS must have seen the application !Scrap for this to work, and
  103.          must have read/write access to !Scrap (and sufficient space -
  104.          probably 48k to 64k aprox.) for it to work. (Good reason to get a
  105.          hard disc :-)
  106.  
  107. Notice:
  108.          I'm no expert on the snapshot converter itself, just the front-end,
  109.          so you may have more luck with the original author if any conversion
  110.          problems arise. Hopefully there shouldn't be any errors introduced
  111.          into it by this front-end.
  112.          See the documentation inside 'Docs' for details about the converter.
  113.  
  114.          This application has not been tested on pre-A5000 machines or
  115.          pre-Risc-OS 3.10 systems. (It also requires SharedCLibrary 3.50
  116.          or higher - I think).
  117.  
  118. The ZX Spectrum ROM:
  119.          A copy of the 16k ROM image from the ZX spectrum is required for some
  120.          conversions. It is provided in the 'Resources' directory inside this
  121.          application on the basis that it has been released into the Public
  122.          Domain. The ROM is (was?) copyrighted to Sinclair Research.
  123.  
  124.         =================================================================
  125.  
  126. Inside the original distribution archives...
  127.  
  128. SPConv.arc contains:
  129.   !SPConv
  130.      !Boot, !Run, !Sprites,Sprites, Messages, } - The application files.
  131.      !RunImage etc.                           }
  132.      Resources.RomImage   - The rom image (spectrum.rom - see documentation).
  133.                             for certain conversions.
  134.      Docs                 - Documentation of SPConv 1.08
  135.  
  136. spcnvsrc.arc contains:
  137.   ReadMe                  - Details about merging source with main application.
  138.   !SPConv
  139.      c, h, o, Makefile    - All to do with the source for this version.
  140.      CliSource            - Original unix & PC source for SPConv 1.08
  141.      OldSprites           - Old Sprites
  142.  
  143. The source directory application can be merged into the main application by
  144. simply dragging the source !SPconv icon onto the main one (once unarchived).
  145.  
  146.         =================================================================
  147.  
  148. Author:  RISC-OS conversion: Tim Moore (c) 1995
  149.          Original version: Henk de Groot (c)
  150.            (Contact: Henk de Groot, hegr@ensae.ericsson.se)
  151.  
  152. Acknowledgements:
  153.          !MZX and !Speculator authors for some of the filetypes and the
  154.          Sprites for the filetypes (now replaced by newer ones).
  155.          Note: The 701 and 702 filetypes are taken from !Speculator
  156.                and I've assumed that 701 fits RAW files.
  157.                The CEE and CEF filetypes are from !MZX.
  158.          
  159.          Mike Borcherds for supplying the Acorn filetypes for Z80/SNA.
  160.          Richard G. Hallas for some advice, new sprites and template
  161.             improvements.
  162.  
  163. Some Archimedes ZX Spectrum Emulators:
  164.          !MZX (version 1.10 at this date) by Graham Willmott
  165.             Last known contact:
  166.                Graham Willmott   (se2044@bristol.ac.uk)   22 Apr 1994
  167.  
  168.          !Speculator, author unknown, availability (officially) unknown.
  169.             Apparently copies available should not be around.
  170.  
  171.  
  172. - -------------------------------------