diff options
author | Matthew Hoops | 2012-12-13 18:30:05 -0500 |
---|---|---|
committer | Matthew Hoops | 2012-12-13 18:30:05 -0500 |
commit | 17f923532533c8a094e1bf0a0efa7369b20ef48a (patch) | |
tree | 954a03adb3270031d8e30c5b9c0ff1bc9647888f | |
parent | f65b22923420cad2d7ece7c2c66617585228ffd1 (diff) | |
download | scummvm-rg350-17f923532533c8a094e1bf0a0efa7369b20ef48a.tar.gz scummvm-rg350-17f923532533c8a094e1bf0a0efa7369b20ef48a.tar.bz2 scummvm-rg350-17f923532533c8a094e1bf0a0efa7369b20ef48a.zip |
AUDIO: Add some general documentation on MidiParser_QT
-rw-r--r-- | audio/midiparser_qt.h | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/audio/midiparser_qt.h b/audio/midiparser_qt.h index c2403f31c5..d6d0f40a48 100644 --- a/audio/midiparser_qt.h +++ b/audio/midiparser_qt.h @@ -30,7 +30,20 @@ #include "common/quicktime.h" /** - * The QuickTime MIDI version of MidiParser. + * The QuickTime Music version of MidiParser. + * + * QuickTime Music is actually a superset of MIDI. It has its own custom + * instruments and supports more than 15 non-percussion channels. It also + * has custom control changes and a more advanced pitch bend (which we + * convert to GM pitch bend as best as possible). We then use the fallback + * GM instrument that each QuickTime instrument definition has to provide. + * + * Furthermore, Apple's documentation on this is terrible. You know + * documentation is bad when it contradicts itself three times on the same + * subject (like about setting the GM instrument field to percussion). + * + * This is as close to a proper QuickTime Music parser as we can currently + * implement using our MidiParser interface. */ class MidiParser_QT : public MidiParser, public Common::QuickTimeParser { public: |