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

This is an AROS 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 even bother
trying 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).

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:

 - An x86 system capable of running AROS
 - expat.library (DMG plugin) - included
 - z.library (CISO, DAA, DAX, DMG and UIF plugins) - included
 - bz2.library (DMG plugin) - included
 - AISS - 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
 - flac   (with embedded cue file)
 - gi     (untested)
 - hdf
 - img
 - iso    (CD/DVD)
 - mdf    (Daemon Tools/Alcohol)
 - mds    (Daemon Tools/Alcohol)
 - nrg    (Nero)
 - raw
 - toast  (Roxio Toast)
 - uif    (MagicISO)
 - wv     (with embedded cue file)

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
 - Device now saves unit prefs in XML format (format is similar to that used
   in the OS4 version)
 - Added FLAC, Ogg Vorbis and WavPack audio tracks support to the CUE plugin
 - Added support for FLAC and WavPack files with embedded cuesheet information

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)
 - Fixed endian issues in CUE plugin's AIFF and WAVE code
 - CUE plugin now uses libmpg123 for MP3 audio tracks (seeking is much faster
   because of this)

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