home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / emulator-tools / schneider-cpc / dsk2cpc.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  4.7 KB  |  168 lines
  1. Short: ACPC->AMICPC disk image convertor
  2. Uploader: jgirvin@bfs.unibol.com (John Girvin)
  3. Author: jgirvin@bfs.unibol.com (John Girvin)
  4. Type: misc/emu
  5.  
  6. TITLE
  7.  
  8.     dsk2cpc
  9.  
  10.  
  11. VERSION
  12.  
  13.     1.00
  14.  
  15.  
  16. AUTHOR
  17.  
  18.     John Girvin
  19.  
  20.     E-Mail: jgirvin@bfs.unibol.com (work)
  21.        girv@girvnet.demon.co.uk (play)
  22.  
  23.     SnailMail:
  24.         John Girvin,
  25.         25 Moorgate Street,
  26.         Belfast BT5 5BZ,
  27.         Northern Ireland,
  28.         United Kingdom.
  29.       
  30.  
  31. DESCRIPTION
  32.  
  33.     dsk2cpc converts the disk images used with ACPC (".DSK" format) to 
  34.     those used by AMI-CPC (".CPC" format). Why? Because AMICPC is a *lot* 
  35.     faster than ACPC, but most of the internet available CPC software 
  36.     is in .DSK format. 
  37.  
  38.     ACPC and AMICPC are two Amstrad CPC emulators for the Amiga. An
  39.     Amstrad CPC is an 8 bit Colour Personal Computer made by Amstrad
  40.     Consumer Electronics plc.
  41.  
  42.  
  43. ARCHIVE CONTENTS
  44.  
  45.     dsk2cpc        -    executable file
  46.     dsk2cpc.doc    -    documentation, this file.
  47.  
  48.  
  49. USAGE
  50.  
  51.     CLI/Shell only.
  52.  
  53.     The general format is:
  54.  
  55.         dsk2cpc <infile.DSK> <outfile.CPC>
  56.  
  57.     Both filenames must be supplied and should specify the complete
  58.     path and filename of their respective files.
  59.  
  60.     Eg: to convert "mydisk.dsk" (ACPC format) in directory "ACPC:Disks"
  61.     to to "mydisk.cpc" (AMICPC format) in directory "AMICPC:Disks", open 
  62.     a shell window and type:
  63.  
  64.         dsk2cpc ACPC:Disks/mydisk.dsk AMICPC:Disks/mydisk.cpc
  65.  
  66.  
  67. BUGS/CAVEATS
  68.  
  69.     dsk2cpc is provided "as is" and is used at your own risk.
  70.  
  71.     The author is not liable for any loss or damage caused by the use or 
  72.     misuse of this program. It almost certainly *wont* destroy your Amiga, 
  73.     but if it does (or does anything else untoward) then I cannot be held 
  74.     responsible. For the truly paranoid, I can make the source code
  75.     available.
  76.  
  77.     dsk2cpc was written in Blitz Basic 2 (for ease of coding) v1.8. There
  78.     is a bug in this language concerning command line parameter handling:
  79.     if you type any extra characters after the final parameter (the name
  80.     of the output file) then they are interpreted by Blitz as an another
  81.     parameter, leading to dsk2cpc thinking you have supplied too many
  82.     parameters and aborting. To avoid this, simply ensure that there
  83.     are no extra characters after the end of the output filename.
  84.  
  85.     You should be aware that the .CPC format used by AMICPC is more 
  86.     restricted than the .DSK format used by ACPC. This means that certain 
  87.     .DSK images cannot be converted to matching .CPC images or will not
  88.     work properly when converted. This is not the fault of dsk2cpc but
  89.     a limitation of the .CPC format which was designed (I think) to handle
  90.     only standard non-protected AMSDOS disks.  Should you attempt to 
  91.     convert such an image, dsk2cpc will stop and inform you of the error.
  92.  
  93.     dsk2cpc was designed to work with the disk images used by ACPC v1.1
  94.     and AMICPC v0.29. Should either of these disk image formats change 
  95.     with new versions of the emulators, dsk2cpc may not work as expected.
  96.     I doubt if it will crash, but the output disk image will probably
  97.     be unuseable.
  98.  
  99.  
  100. SPECIAL REQUIREMENTS
  101.  
  102.     The conversion is performed in-memory, so approximately 400K of
  103.     free memory (of any type) is required to run the program. This
  104.     requirement may be reduced in future releases.
  105.  
  106.     Tested on a1200/68030+68882-40Mhz/8Mb/KS3.0, but should run on
  107.     any Amiga. If you have a problem running dsk2cpc then I WANT TO 
  108.     KNOW! Feel free to get in touch.
  109.  
  110.  
  111. HISTORY
  112.  
  113.     1.0  First version. Released to Aminet in January 1996.
  114.     
  115.  
  116. HOST NAMES
  117.  
  118.     Uploaded to wuarchive.wustl.edu (Aminet) prob. in misc/emu
  119.  
  120.  
  121. FILE NAMES
  122.  
  123.     dsk2cpc10.lha
  124.  
  125.  
  126. PRICE
  127.  
  128.     One email message - dsk2cpc is emailware (if you like it let me know :)
  129.  
  130.  
  131. DISTRIBUTABILITY
  132.  
  133.     (c) 1996 John Girvin. No modifications may be made to either the
  134.     program or its accompanying documentation without my consent.
  135.  
  136.     Freely Distributable, provided the files dsk2cpc and dsk2cpc.doc
  137.     are included unchanged in any distribution and no more than minimal
  138.     handling/media costs are charged.
  139.  
  140.     The authors of Amiga CPC emulators are given specific permission
  141.     to include dsk2cpc in any of their CPC related distributions. Drop
  142.     me a line if you do, OK? 
  143.  
  144.  
  145. ACKNOWLEDGEMENTS
  146.  
  147.     ACPC is (c) Kevin Thacker. For all things Amstrad, check out his web 
  148.     page at: http://www.cs.cf.ac.uk/User/K.E.W.Thacker/Amstrad/index.html
  149.     You can download the latest version of ACPC and AMICPC from there. 
  150.  
  151.     The .DSK format specification is also available there (amongst others)
  152.     along with a whole host of other Amstrad related material. 
  153.  
  154.  
  155.     AMICPC is (c) Ludovic Deplanque. I dont think he has an internet email
  156.     address, but the docs in the AMICPC archive give his address as:
  157.  
  158.             Ludovic DEPLANQUE
  159.             70, rue Victor Hugo
  160.             59210 Coudekerque Branche
  161.  
  162.     If anyone knows Ludovic's email address then please get in touch.
  163.  
  164.     AMICPC can be found at ftp://ftp.ibp.fr/pub/amstrad/emulator/ami-cpc.lha
  165.  
  166.  
  167.     Blitz Basic 2 is (c) Acid Software.
  168.