aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/05_01.tex5
-rw-r--r--doc/07_03.tex30
-rw-r--r--doc/08.tex6
3 files changed, 38 insertions, 3 deletions
diff --git a/doc/05_01.tex b/doc/05_01.tex
index 2afc462e53..ebd671b7a6 100644
--- a/doc/05_01.tex
+++ b/doc/05_01.tex
@@ -36,9 +36,10 @@ Usage: scummvm [OPTIONS]... [GAME]\\
&atari, fmtowns, mac, pc, windows)\\
--savepath=PATH &Path to where savegames are stored\\
--multi-midi &Enable combination of Adlib and native MIDI\\
- --soundfont &Select the SoundFont for MIDI playback. (Only\\
- &supported by some MIDI drivers.)\\
+ --soundfont &Select the SoundFont for MIDI playback (Only\\
+ &supported by some MIDI drivers)\\
--native-mt32 &True Roland MT-32 (disable GM emulation)\\
+ --enable-gs &Enable Roland GS mode for MIDI playback\\
--output-rate=RATE &Select output sample rate in Hz (e.g. 22050)\\
--aspect-ratio &Enable aspect ratio correction\\
--render-mode=MODE &Enable additional render modes (cga, ega, hercGreen, hercAmber, amiga)\\
diff --git a/doc/07_03.tex b/doc/07_03.tex
index 347a2bd427..bd754bf9ee 100644
--- a/doc/07_03.tex
+++ b/doc/07_03.tex
@@ -9,3 +9,33 @@
Use the appropriate -e<mode> command line option from the list above to
select your preferred MIDI device. For example, if you wish to use the
Windows MIDI driver, use the -ewindows option.
+
+\subsubsection{Using MIDI options to customize Native MIDI output}
+ScummVM supports a variety of MIDI modes, depending on the capabilities
+of your MIDI device.
+
+If --native-mt32 is specified, ScummVM will treat your device as a real
+MT-32. Because the instrument mappings and system exclusive commands of
+the MT-32 vary from those of General MIDI devices, you should only
+enable this option if you are using an actual Roland MT-32, LAPC-I, CM-64,
+CM-32L, CM-500, or GS device with an MT-32 map.
+
+If --enable-gs is specified, ScummVM will initialize your GS-compatible
+device with settings that mimic the MT-32's reverb, (lack of) chorus,
+pitch bend sensitivity, etc. If it is specified in conjunction with
+--native-mt32, ScummVM will select the MT-32-compatible map and drumset on
+your GS device. This setting works better than default GM or GS emulation
+with games that do not have custom instrument mappings (Loom and Monkey1).
+You should only specify both settings if you are using a GS device that
+has an MT-32 map, such as an SC-55, SC-88, SC-88 Pro, SC-8820, SC-8850, etc.
+Please note that --enable-gs is automatically disabled in both DOTT and
+Samnmax, since they use General MIDI natively.
+
+If neither of the above settings is enabled, ScummVM will initialize your
+device in General MIDI mode and use GM emulation in games with MT-32
+soundtracks.
+
+Some games contain sound effects that are exclusive to the Adlib soundtrack.
+For these games, you may wish to specify --multi-midi in order to combine
+MIDI music with Adlib sound effects.
+
diff --git a/doc/08.tex b/doc/08.tex
index 56e829415d..84cdf3285f 100644
--- a/doc/08.tex
+++ b/doc/08.tex
@@ -102,11 +102,15 @@ The following keywords are recognized:
& supported by some MIDI drivers.)\\
native\_mt32 &bool If true, disable GM emulation and assume that\\
& there is a true Roland MT-32 available.\\
+ enable\_gs &bool If true, enable Roland GS-specific features to\\
+ & enhance GM emulation. If native\_mt32 is also\\
+ & true, the GS device will select an MT-32 map\\
+ & to play the correct instruments.\\
sfx\_volume &number The sfx volume setting (0-255)\\
tempo &number The music tempo (50-200) (default: 100)\\
speech\_volume &number The speech volume setting (0-255)\\
\\
- copy\_protection&bool Enable copy protection in SCUMM games ,when\\
+ copy\_protection&bool Enable copy protection in SCUMM games, when\\
& ScummVM disables it by default.\\
demo\_mode &bool Start demo in Maniac Mansion\\
alt\_intro &bool Use alternative intro for CD versions of \\