Synopsis
dro2txt < input.dro
Description
Convert a DRO file (a DOSBox raw OPL capture) read from stdin into ASCII text. The text is sent to stdout and each line roughly describes an Ad Lib event.
The events are printed such that things not affecting the audio output (such as different ordering of the OPL register writes, or redundant register writes) will not change the output text. Thus two different players could output quite different OPL data yet providing the resulting music sounds the same, the text produced by this utility would also be the same.
This utility is intended to be used in conjunction with diff(1) to compare two different .dro files. A binary comparison in this situation is not practical, as the files could be very different at the byte level yet sound the same musically. This utility will allow the files to be compared at the aural level. Its main use is in implementing new music formats, where a libgamemusic format reader can be compared with a .dro capture of the original in-game music to ensure the format is being converted correctly.
Examples
- dro2txt < game.dro > orig.txt && dro2txt < output.dro > convert.txt && diff -u orig.txt convert.txt | less
compare two .dro files and show any differences as a diff
Notes
The utility only supports version 2.0 of the DOSBox .dro format, used by DOSBox 0.73 and newer.
Exit status is 0 on success, 1 on failure.
The .dro file format is fully documented on the Game Modding Wiki.
Bugs and Questions
Report bugs at http://www.shikadi.net/camoto/bugs/
Ask questions about Camoto or modding in general at the RGB Classic Games modding forum
Copyright
Copyright (c) 2010-2012 Adam Nielsen.
License GPLv3+: GNU GPL version 3 or later
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.