home *** CD-ROM | disk | FTP | other *** search
/ 64'er / 64ER_CD.iso / spec_emu / spconv / spconv.doc < prev    next >
Text File  |  1992-12-13  |  3KB  |  76 lines
  1. This programs are Public Domain, and because of that I will not be liable 
  2. for any damages resulting from use of this software.
  3.  
  4. The programs is compiled with TURBO-C++ 1.0.
  5.  
  6. SPCONV 1.02 - 14 DEC 1992 - Convert snapshot files (.SNA, .SP, .Z80, .PRG
  7.                   and RAW)
  8.  
  9. Usage:
  10.  
  11. SPCONV <infile> <outfile>
  12.  
  13. Spconv is a utility to convert between various snapshot formats. Snapshot 
  14. files are created by various spectrum emulators. SPCONV converts between .SNA, 
  15. .SP, .Z80 and .PRG files. The conversion to/from .SP files may not work always 
  16. however, it is not clear to me how IFF, IFF2 and the interrupt mode are stored 
  17. in the .SP file. Since version 1.02 I have made some improvements to this type
  18. of conversion however, it sould work now, but I have not enough .SP samples to
  19. fully test it. Note that crashing of a converted image may also be caused by 
  20. bugs in the SPECTRUM emulator. Converion to .SP will work if the image is 
  21. converted from a RAW image (see later).
  22.  
  23. Wildcards for the infile or outfile parameters are not accepted, an error
  24. message is displayed if either * or ? is found in one or both the filenames. 
  25. The outfile parameter is either a full filename or only the suffix .SNA, .SP,
  26. .Z80 or .PRG. The prefix is taken from the first parameter in that case. 
  27. This enables usage like:
  28.  
  29.     "for %%i in (*.z80) do spconv %%i .z80"
  30.  
  31. Normaly the <infile> and <outfile> are not of the same type. If they are you
  32. will get a error message, unless both files are of the .SP type. In that case
  33. the converter will convert an old style .SP file to a new style .SP file or 
  34. from a new style .SP file to an old style .SP file, depending on the input. 
  35. The old style .SP file is used by VGASPEC, with seems to be an unauthorised 
  36. version of the spanish "SPECTRUM" program. The "SPECTRUM" program will use
  37. the new style .SP files.
  38.  
  39. Conversion between .SNA and .Z80 and from .Z80 to .SNA should be no problem, 
  40. both formats are sufficiently described in the documentation of JPP (the
  41. norwegian emulator) and Z80 (the dutch emulator).
  42.  
  43. Conversion to/from .PRG files should work fine also. I don't have a 
  44. description of that format, but I think I figured it all out by looking at
  45. some samples. I only don't know where the border colour is stored. The 
  46. specem emulator (an Irish emulator) doesn't show the border, so I can't find 
  47. out by trail and error.
  48.  
  49. Spconv can also be used to convert a raw spectrum image to a snapshot file. 
  50. The image has to be captured with SLOAD. At the Spectrum side the the command
  51.  
  52.                         SAVE *"b"CODE 16384,49152
  53.  
  54. HAS to be used. Convert will convert the file is such way that it will continue
  55. in the basic interpreter. so 
  56.  
  57.               SAVE *"b"CODE 16384,49152:PRINT "Hello, World!"
  58.  
  59. will after conversion to a snapshot file and loading it in the emulator, begin
  60. with printing "Hello, World!".
  61.  
  62. Example: Converting a .SNA JPP file to the .Z80 Dutch emulator:
  63.  
  64.     spconv game.sna game.z80
  65.     (or spconv game.sna .z80)
  66.  
  67. Thanks to: Arnt Gulbrandsen (author of JPP)
  68.        Ramco v.d. Woestijne (supplied new .SP format)
  69.        G.A. Lunter (author of Z80)
  70.        Pedro Gimeno (author of SPECTRUM)
  71.            Kevin J Phair (author of SPECEM)
  72.  
  73. for suppling information and for creating these spectrum emulators.
  74.  
  75. H. de Groot    -    groot@idca.tds.philips.nl
  76.