camoto/manpage/dro2txt

From shikadi.net
Jump to: navigation, search

dro2txt

Name

dro2txt — list the events in a DROv2 capture

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.