http://www.dosbox.com/wiki/api.php?action=feedcontributions&user=Gilgamesh&feedformat=atomDOSBoxWiki - User contributions [en]2024-03-28T18:56:39ZUser contributionsMediaWiki 1.34.1http://www.dosbox.com/wiki/index.php?title=Cuesheet&diff=1369Cuesheet2008-08-15T19:22:55Z<p>Gilgamesh: short howto on creation and mounting CUE/BIN and compression of audio tracks</p>
<hr />
<div>= Cuesheet =<br />
<br />
Cuesheet is a file format that specifies track structures of mixed mode compact discs. <br />
It can be used with DOSBox, when a game needs to access audio tracks of its CD that is stored as an image file. The prevalent ISO format can only store data tracks.<br />
<br />
== The CUE/BIN format for CD images == <br />
<br />
Cuesheets usually come as a CUE/BIN pair. The cuesheet, e.g. image.cue, is an ASCII text file that stores the access information for the “disc at once” binary dump, e.g. image.bin, of the CD's contents. (For more info on the cuesheet file format see [http://www.pcnineoneone.com/howto/cdburnadv4.html here].)<br />
<br />
Mounting a CUE/BIN pair is done in the usual way with<br />
<code><pre>Z:\>IMGMOUNT E C:\Images\MyImage.cue -t iso</pre></code><br />
<br />
An exemplary cuesheet is:<br />
<pre><br />
FILE "image.bin" BINARY<br />
TRACK 01 MODE1/2352<br />
INDEX 01 00:00:00<br />
TRACK 02 AUDIO<br />
PREGAP 00:02:00<br />
INDEX 01 35:17:41<br />
TRACK 03 AUDIO<br />
INDEX 01 37:37:70<br />
TRACK 04 AUDIO<br />
INDEX 01 39:02:74<br />
TRACK 05 AUDIO<br />
INDEX 01 41:34:17<br />
TRACK 06 AUDIO<br />
INDEX 01 43:43:29<br />
TRACK 07 AUDIO<br />
INDEX 01 46:35:11<br />
TRACK 08 AUDIO<br />
INDEX 01 48:47:52<br />
TRACK 09 AUDIO<br />
INDEX 01 51:29:30<br />
TRACK 10 AUDIO<br />
INDEX 01 53:43:54<br />
TRACK 11 AUDIO<br />
INDEX 01 56:28:53<br />
TRACK 12 AUDIO<br />
INDEX 01 58:53:44<br />
TRACK 13 AUDIO<br />
INDEX 01 60:53:66<br />
</pre><br />
<br />
=== Windows ===<br />
<br />
Use a CD burning application like CDRWIN that can write image files in cuesheet format. <br />
(An alternative to mounting the CUE/BIN images directly with DOSBox is to load it with the [http://www.daemon-tools.cc/ Daemon Tools] or similar virtual drives and mount that volume instead like a normal CD-ROM.)<br />
<br />
=== Linux ===<br />
<br />
In order to produce a CUE/BIN pair with Linux use the commands<br />
<code><pre><br />
> cdrdao read-cd --datafile image.bin --driver generic-mmc:0x20000 --device /dev/cdrom --read-raw image.toc<br />
> toc2cue image.toc image.cue<br />
</pre></code><br />
The option <code>--driver generic-mmc:0x20000</code> takes care of the correct byte order. Omitting it would lead to noise instead of music.<br />
<br />
== Compressed audio tracks ==<br />
<br />
Another advantage of cuesheets is the possibility to compress audio tracks. The image of a CD's contents can split into an ISO image of the data track and one or more compressed files in OGG or MP3 format for the audio tracks. This method can drastically reduce the image's size without a substantial loss of audio quality.<br />
<br />
First you have to rip and encode the audio tracks. The the cuesheet will have to be edited. Mind the changes for the first TRACK and the INDEX tags.<br />
<pre><br />
FILE "image.iso" BINARY<br />
TRACK 01 MODE1/2048<br />
INDEX 01 00:00:00<br />
FILE "track02.ogg" MP3<br />
TRACK 02 AUDIO<br />
PREGAP 00:02:00<br />
INDEX 01 00:00:00<br />
FILE "track03.ogg" MP3<br />
TRACK 03 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track04.ogg" MP3<br />
TRACK 04 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track05.ogg" MP3<br />
TRACK 05 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track06.ogg" MP3<br />
TRACK 06 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track07.ogg" MP3<br />
TRACK 07 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track08.ogg" MP3<br />
TRACK 08 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track09.ogg" MP3<br />
TRACK 09 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track10.ogg" MP3<br />
TRACK 10 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track11.ogg" MP3<br />
TRACK 11 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track12.ogg" MP3<br />
TRACK 12 AUDIO<br />
INDEX 01 00:00:00<br />
FILE "track13.ogg" MP3<br />
TRACK 13 AUDIO<br />
INDEX 01 00:00:00<br />
</pre><br />
Warning: The length for the compressed audio tracks will never exactly match the original play length. It will deviate some frames (1 frame = 1/75 sec) from the correct values.<br />
<br />
The ISO-image of the data track can be mastered with any CD Burning application.<br />
<br />
=== Linux ===<br />
<br />
In order to rip and encode the audio tracks you can use the commands<br />
<code><pre><br />
> cdparanoia -B "2-"<br />
> oggenc *.wav<br />
</pre></code></div>Gilgameshhttp://www.dosbox.com/wiki/index.php?title=MOUNT&diff=1366MOUNT2008-08-15T08:08:55Z<p>Gilgamesh: added reference to CUE/BIN images</p>
<hr />
<div>'''MOUNT.COM''' is a command inside DOSBox that can connect physical folders and drives to [[Drives|virtual drives]] inside DOSBox. When you enter the command MOUNT from the DOSBox prompt you should see<br />
<code><pre>Z:\>MOUNT<br />
Current mounted drives are:<br />
Drive Z is mounted as Internal Virtual Drive</pre></code><br />
<br />
To mount a folder as a drive, follow this basic template.<br />
<code><pre>MOUNT [Drive-Letter] [Local-Directory]</pre></code><br />
<br />
The local directory can be specified relative to the working directory from which DOSBox was started.<br />
<br />
To unmount a drive, follow this basic template.<br />
<code><pre>MOUNT -u [Drive-Letter]</pre></code><br />
<br />
= Usage Examples =<br />
<br />
== Windows ==<br />
=== Mounting a folder from your harddrive ===<br />
<code><pre>Z:\>MOUNT C C:\DOSGAMES</pre></code><br />
<br />
=== Mounting a floppy drive ===<br />
<code><pre>Z:\>MOUNT A A:\ -t floppy</pre></code><br />
<br />
=== Mounting a CD-Rom drive ===<br />
<code><pre>Z:\>MOUNT D D:\ -t cdrom</pre></code><br />
<br />
=== Extra CD ROM options ===<br />
-t [floppy|cdrom] Define how the mounted folder should behave to the emulated operating system.<br />
-usecd [drive #] For direct hardware emulation ie: audio playback, etc.<br />
-cd = Generate a list of local CD ROM drive's "drive #" values<br />
-label [name] = Set the volume name of the drive (all caps)<br />
-ioctl = Lowest level of hardware access (Win 2K, XP and Linux)...follows the -usecd command<br />
<br />
Z:\>MOUNT D D:\ -t cdrom -usecd 0 -ioctl -label GAME_CD<br />
<br />
=== Mounting an ISO-File as volume ===<br />
<code><pre>Z:\>IMGMOUNT E C:\Images\MyImage.iso -t iso</pre></code><br />
<br />
=== Mounting a CUE/BIN-Pair as volume ===<br />
If the game plays additionals music tracks from the cd ([http://en.wikipedia.org/wiki/Mixed_Mode_CD mixed mode]), you can still mount it as an image file. Since ISO can only contain pure data, the image has to be in the [[Cuesheet|CUE/BIN format]]. You mount it with<br />
<code><pre>Z:\>IMGMOUNT E C:\Images\MyImage.cue -t iso</pre></code><br />
The BIN-file has to be in the same folder as the CUE-file. It is also possible to use a cuescheet in combination with an ISO and [[Cuesheet|compressed audio tracks]] in OGG or MP3 format.<br />
<br />
== Linux ==<br />
<code><pre>Z:\>MOUNT C ~/DOSGAMES</pre></code><br />
<br />
<code><pre>Z:\>MOUNT D /MEDIA/CDROM/ -T CDROM</pre></code><br />
<br />
<code><pre>Z:\>IMGMOUNT E ~/IMAGES/MYIMAGE.ISO -T ISO</pre></code><br />
<br />
== Mac OSX ==<br />
<code><pre>Z:\>MOUNT C ~/DOSGAMES</pre></code><br />
<code><pre>Z:\>IMGMOUNT D ~/Documents/IMAGE.toast -t iso</pre></code><br />
<br />
== Using your mounted drive ==<br />
To change to the newly mounted virtual drive simply type<br />
<code><pre>[Drive-Letter]:</pre></code><br />
<br />
For example (If you mounted a Local-Directory to the Drive-Letter '''C''')<br />
<code><pre>Z:\>C:</pre></code></div>Gilgamesh