Short:        Disk image device (adf,dms,ipf,iso,...)
Author:       Fredrik Wikstrom
Uploader:     Fredrik Wikstrom <fredrik a500 org>
Type:         disk/misc
Version:      52.31
Architecture: m68k-amigaos >= 3.0

This is an OS3.x port of the 52.x OS4 diskimage.device.

It is not to be confused with Thore Boeckelmann's diskimage.device, since it is
a from scratch development and not based on it in any way, so don't try to use
his GUI together with this device since it won't work (they are incompatible in
this way). The same mountlists can however be used for both devices.

Some important notes:

In order to mount .hdf files you will probably need to specify the correct
HighCyl value for the .hdf file in question (FFS2 ignores this value if
LowCyl = 0 so this is not a problem on OS4).

Large files (>=2GB) are supported if and only if the filesystem supports this
as well as the new 64-bit dospackets (like f.e. SFS2 filesystem).

In order to get localisation to work with the diskimage.device you may have to
move the line containing the following command in S:startup-sequence so that
it's located after the C:IPrefs command or the device will always use only the
builtin english strings:
C:Mount >NIL: DEVS:DOSDrivers/~(#?.info)

Requirements:

 - 68020+ CPU (no FPU required)
 - AmigaOS >= 3.0
 - expat.library >= 4.1 - http://aminet.net/util/libs/expat.lha
 - ClassAct/ReAction (DiskImageGUI) - http://aminet.net/dev/gui/classact33.lha
 - screennotify.library (DiskImageGUI) -
   http://aminet.net/util/libs/ScreenNotify10.lha
 - titlebar.image (DiskImageGUI) - http://aminet.net/dev/gui/titlebar_ic.lha
 - capsimage.device (IPF plugin) - http://softpres.org/
 - mpega.library (MP3 audio tracks) -
   http://aminet.net/util/libs/mpega_library.lha

Recommended:

 - AISS >= 4.8 (DiskImageGUI) - http://masonicons.info/

Supported disk image formats:

 - adf    (Amiga Disk File)
 - adz    (gzipped adf file)
 - bin
 - ccd    (CloneCD)
 - cso    (Compressed ISO)
 - cpr    (same format as dsk)
 - cue
 - d64    (use with 1541-Handler)
 - daa
 - dax
 - dmg    (Apple disk image format)
 - dms    (DiskMaSher)
 - dsk    (CPCEmu, non-EXTENDED images only)
 - fdi
 - gi     (untested)
 - hdf
 - img
 - ipf    (needs capsimage.device)
 - iso    (CD/DVD)
 - mdf    (Daemon Tools/Alcohol)
 - mds    (Daemon Tools/Alcohol)
 - nrg    (Nero)
 - raw
 - toast  (Roxio Toast)
 - uif    (MagicISO)

Also supports compressed images through (if available):

 - xadmaster.library
 - xpkmaster.library

Usage:

Put one of the included IDFx/ICDx mount files into DEVS:DOSDrivers (or
SYS:Storage/DOSDrivers in which case they will have to be mounted manually
with C:Mount before use).

To mount a disk image on ICD0:

MountDiskImage drive ICD0: imagefile.iso

To eject:

MountDiskImage drive ICD0: eject

Changes:

52.31 (21-Feb-2012)
 - Rewrote HD_SCSICMD handling and moved some pretty general code away from
   plugins to the device where it belongs
 - DiskImageGUI now saves it's prefs as a single XML file instead of some
   short text files in ENV:/ENVARC: (format is similar to that used in the
   OS4 version)
 - Device now saves unit prefs in XML format (format is similar to that used
   in the OS4 version)
 - Fixed code for saving and restoring the window sizes in DiskImageGUI
 - Updated German DiskImageGUI catalog

52.30 (16-Jan-2012)
 - diskimage.device no longer allocates a useless signal when it creates the
   reply-port for communicating with a device unit
 - Improved the MDS plugin (should now be able to handle more MDS files than
   previously)

See diskimage.guide/Changelog in the archive for a complete list of changes.