home *** CD-ROM | disk | FTP | other *** search
/ Emulator Universe CD / emulatoruniversecd1998.iso / Speccy / Utils / convert / SPCONV.DOC next >
Encoding:
Text File  |  1992-08-14  |  2.4 KB  |  57 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 2.0.
  5.  
  6. SPCONV 1.0 - 10 AUG 1992 - Convert snapshot files (.SNA, .SP, .Z80 and RAW)
  7.  
  8. Usage:
  9.  
  10. SPCONV <infile> <outfile>
  11.  
  12. Spconv is a utility to convert between various snapshot formats. Snapshot 
  13. files are created by various spectrum emulators. SPCONV converts between .SNA, 
  14. .SP and .Z80 files. The conversion to/from .SP files may not work always 
  15. however, it is not clear to me how IFF, IFF2 and the interrupt mode are stored 
  16. in the .SP file. Cashing of a converted image may also be caused by bugs in the 
  17. SPECTRUM emulator. Converion to .SP will work if the image is converted from a 
  18. RAW image (see later)
  19.  
  20. Normaly the <infile> and <outfile> are not of the same type. If they are you
  21. will get a error message, unless both files are of the .SP type. In that case
  22. the converter will convert an old style .SP file to a new style .SP file or form
  23. a new style .SP file to an old style .SP file, depending on the input. The old
  24. style .SP file is used by VGASPEC, with seems to be an unauthorised version
  25. of the spanish "SPECTRUM". The "SPECTRUM" will use the new style .SP files.
  26.  
  27. Conversion between .SNA and .Z80 and from .Z80 to .SNA should be no problem, 
  28. both formats are sufficiently described in the documentation of JPP (the
  29. norwegian emulator) and Z80 (the dutch emulator).
  30.  
  31. Spconv can also be used to convert a raw spectrum image to a snapshot file. 
  32. The image has to be captured with a program that reads the RS232 port and
  33. puts the read data in a file. At the Spectrum side the the command
  34.  
  35.                         SAVE *"b"CODE 16384,49152
  36.  
  37. HAS to be used. Convert will convert the file is such way that it will continue
  38. in the basic interpreter. so 
  39.  
  40.               SAVE *"b"CODE 16384,49152:PRINT "Hello, World!"
  41.  
  42. will after conversion to a snapshot file and loading it in the emulator, begin
  43. with printing "Hello, World!".
  44.  
  45. Example: Converting a .SNA JPP file to the .Z80 Dutch emulator:
  46.  
  47.     spconv game.sna game.z80
  48.  
  49. Thanks to: Arnt Gulbrandsen (author of JPP)
  50.        Ramco v.d. Woestijne (supplied new .SP format)
  51.        G.A. Lunter (author of Z80)
  52.        Pedro Gimeno (author of SPECTRUM)
  53.  
  54. for suppling information and for creating these spectrum emulators.
  55.  
  56. H. de Groot    -    groot@idca.tds.philips.nl
  57.