home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / funland / emulators / spectrum / spconv / !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. - ----------------------------------------------------------------
  173.      This application is Public Domain.
  174.      Distribution is only allowed if the application is
  175.      kept to it's orignal structure, or any alterations
  176.      are described and acknowledged and I'm notified
  177.      of such changes.
  178.  
  179.      Any source codes and binaries included are copyrighted
  180.      to the author(s) of them.
  181.  
  182.      Tim Moore © 1995
  183.  
  184. - ----------------------------------------------------------------
  185. If you wish to contact me then I can be mailed at ...
  186.  
  187. Internet mail (University of Portsmouth):
  188.      sis1514@sis.port.ac.uk
  189.  
  190. (Until July-ish 1995)
  191.  
  192. I finish before then, so mail may remain unanswered for
  193. a while.
  194.  
  195. After that, I don't know what's happening, so this may be
  196. the other possibility until I can get another account (and
  197. maybe a modem etc...) :-
  198.  
  199. Mr. T.Moore
  200. 30 Meadow Rise
  201. Dawlish
  202. Devon
  203. EX7 9AZ
  204.  
  205.  
  206. (Future stuff from me can be verified with PGP).
  207. - ----------------------------------------------------------------
  208.  
  209. History:
  210.      v0.01 - Development version, no front-end. Changed source a little bit
  211.              to work under RISC-OS and to not use UNIX libraries (which caused
  212.              problems when combined with RISC_OSLib).
  213.              Also made the source a header/source set and changed the main
  214.              parameters (no 'main' anymore) so that it could be called
  215.              suitably from a 'front-end'. The source doesn't deal with
  216.              determining file types anymore.
  217.      v0.02 - Development version, with front-end. Did templates, wimp shell
  218.              and all those sort of things. Deal with 'drag-and-drop' loading
  219.              and saving, file type identification, calling the conversion
  220.              routines and saving from !Scrap. Doesn't support RAM loading/
  221.              saving events.
  222.      v1.00 - Release version. Added !Help and tidied up etc.
  223.      v1.01 - Alteration to change filetypes for SNA and Z80.
  224.      v1.02 - Changes to template to use outline fonts and align correctly
  225.              (I hope).
  226.      v1.03a- Outline fonts cause problems with RiscPC (I thought they might)
  227.              so, they're back to as before. Better this way, as you can choose
  228.              the font to use on the basis of the system font (similar patches
  229.              exist for pre-RiscPC machines - see 'FinalLook' by Matthew Godbolt
  230.              especially).
  231.              Option to save old sprite filetypes added and new sprites addded.
  232.      v1.04 - Tidy up of templates and fonts. Thanks to Richard G. Hallas for
  233.              this.
  234.      v1.04a- Woops, help text didn't work. Now corrected.
  235.      v1.10 - Updated for spconv 1.08 & a few small changes.
  236.              It should all work OK (I Hope).
  237.  
  238.  
  239. Disclaimer:
  240.      Any problems and bugs with this program that may lead to your problems
  241.      are not my fault, and are the fault of instructions (or lack of) that
  242.      people give for wimp programming :-)
  243.  
  244.      Please tell me what the bugs are, if possible, though or any conflicts
  245.      with filetypes or anything else.
  246.  
  247.  
  248. PGP:
  249.      You can check my signatures using a trusted public key of mine.
  250.      A copy of my public key block is in the file 'pubkey/asc', but you need
  251.      an independent trusted key to be sure.
  252.      (The signature for the !RunImage executable is RImage/sig. Check with
  253.      the command 'pgp RImage/sig !RunImage' or using a front-end application).
  254.  
  255. -----BEGIN PGP SIGNATURE-----
  256. Version: 2.3a
  257.  
  258. iQCVAgUBL97pPNZm1AuttC5dAQHGQgP/VW2lhjXb5d+/FOD3Mq9T7YZ3WLTm03A5
  259. cfaMPRMn6omelZiEm+cBtE/LHaWKaV8EzIeKv+q8KTgquln5VKqRhZLi/vkHcm3D
  260. kpYJ2pXJu4m6Q9ApzQIV0dQGzP9ThShQHXYVr+Z6bh/IDEiFPI4/XM30DTMuVal/
  261. RihtOjd9uV0=
  262. =r2tu
  263. -----END PGP SIGNATURE-----
  264.