ArcImg v.1.2
Archimedes disk image program for PC

Version 1.1   - Jasper Renow-Clarke 1997,99 (jasperr@osl1.co.uk)
        1.2     modified by Tom Humphrey 2001 (t.humphrey@bigfoot.com)
----------------------------------

This is a small program to read/write disk images
from/to Archimedes disks in a pc's floppy drive.

It can be used in conjunction with Archie or RedSquirrel.

Syntax :
  ARCIMG [filename] [operation] [drive:]

    Operations :
    /read        - Reads disk into image (Default)
    /write       - Writes disk from image                
    /format1600  - Formats 1.6 Mb disk
    /format800   - Formats 800k disk
    /q           - Don't prompt for confirmation

If the filename is omitted for a read operation then the disc name will be used.

Some examples are:
------------------

*  (Read an Archi D/E/F format floppy in to a disk image,

  arcimg c:\test.adf


*  (Read an archi format floppy in to a disk image, using the disk's name,

  arcimg /read


*  (Write an Archi D/E/F format floppy from a disk image,
               
  arcimg c:\games.adf /write


*  (Format an 800k floppy disk in drive B: and then write an image to it. 
  
  arcimg c:\games.adf /format800 /write B: 


**********************************************************************************
**********************************************************************************
PLEASE NOTE THAT VERSION 1.2 IS STILL AT A DEVELOPMENT STAGE. IF YOU EXPERIANCE
PROBLEMS WITH READING OR WRITING 800K DISKS THEN I SUGGEST USING THE OLDER VERSION
WHICH IS MORE RELIABLE WITH THIS MEDIA. THE OLD VERSION DOES NOT READ 1.6M DISKS.
**********************************************************************************
**********************************************************************************


Formatting:
-----------
Before writing an image to a disk it must be formatted, preferably using a real
Archimedes. ArcImg can format disks, but the result is NOT equivalent to a native 
Arc format. Disks are readable, but access speed is much slower and reliability
may be reduced. ArcImg formatting does not write filesystem map info, so you
must write an image on to the disk, in order for the disk to be useful.

Please use the correct media type for both format options. It *may* be possible to
format an HD disk to only 800K capacity (particularly if you cover the second hole
with tape) but the disk is unlikely to be as reliable as a true DD disk. 

Reading a disk image:
---------------------
ArcImg can read from D,E and F Archimdes format discs. To create an image
you may either specify an output file, or use the disc name as the filename.
If for any reason the discname is unreable then arcimg will offer to use a
four character serial code instead.

If there are any read errors in creating a file from
a disk, then the sectors are displayed in red, otherwise
the currently being read sector is displayed, to give
you a progress meter. One reason a sector can not be read
is that it may be formatted differently for copy protection
purposes.  If a sector cannot be read then equivalent blank space
is written in the output file.  Files which overlapped the corrupt
area are unlikely to be readable, but the rest of the image may still
have recoverable data. 

Note that DOS truncates filenames to 8 letters, which may be 
significant when using an Arc disk name for the image filename.


Writing an image to a floppy disk:
----------------------------------
Images may be written to Archimedes format floppy discs. Image and disk size
must match.

============================================================================== 

I hope you find this useful, mail me with your comments/
suggestions, your feedback is welcomed.

---

I take no responsibilty whatsoever for the
performance of this software, if it breaks
something, then it's not my fault.

You run this software entirely at your own risk.

(c) 1997-2001, Jasper Renow-Clarke


changelog
----------

v1.2  also read & writes 1.6Mb (F format) disks
      formats discs
      improved error tolerance on reads
      can read name of arc disk
      quiet option
      can specify drive A or B (untested, proceed with caution!)

(v1.2 modifications by Tom Humphrey, all the bugs are mine!)
Please address feedback specific to v1.2 to t.humphrey@bigfoot.com

files
-----
arcimg.exe      ArcImg utility (v1.2)
readme.txt
arcimg.pas      Pascal source code, (suitable for compilation with
	        TurboPascal v5.5 or equivalent)

arcimg.old.exe  ArcImg utility (v1.1)
arcimg.old.pas  Source code for v1.1