aboutsummaryrefslogtreecommitdiff
path: root/doc/config.tex
blob: e6696fe1ccb9aed03e5dbd41eee83d16c79a872d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "readme"
%%% End: 

\section{Configurations Files}


By default, the configuration file is saved in, and loaded from:
%
\begin{itemize}
\item Windows: \verb#<windir>\scummvm.ini#
\item Unix: \verb#~/.scummvmrc#
\item Mac OS X: \verb#~/Library/Preferences/ScummVM Preferences#
\item Others: \verb#scummvm.ini# in the current directory
\end{itemize}
%
An example config file looks as follows:
%
\begin{verbatim}
        [scummvm]
        gfx_mode=supereagle
        fullscreen=true
        savepath=C:\saves\

        [sky]
        path=C:\games\SteelSky\

        [germansky]
        gameid=sky
        language=de
        path=C:\games\SteelSky\
        description=Beneath a Steel Sky w/ German subtitles
        
        [germandott]
        gameid=tentacle
        path=C:\german\tentacle\
        description=German version of DOTT

        [tentacle]
        path=C:\tentacle\
        subtitles=true
        music_volume=40
        sfx_volume=255

        [loomcd]
        cdrom=1
        path=C:\loom\
        talkspeed=5
        savepath=C:\loom\saves\
        
        [monkey2]
        path=C:\amiga_mi2\
        music_driver=windows
\end{verbatim}
%
The following keywords are recognized:

\begin{tabular}[hf]{lll}
        basename       &string\\
        path           &string   The path to where a game's data files are\\
        read\_only     &bool     If true, ScummVM will never try to overwrite\\
                       &         the configuration file.\\
        autosave\_period&number   The seconds between autosaving (default: 300)
        save\_slot     &number   The save game number to load on startup.\\
        savepath       &string   The path to where a game will store its\\
                       &         savegames.\\
        versioninfo    &string   The version of the ScummVM that created the\\
                       &         configuration file.\\
\\
        gameid         &string   The real id of a game. Useful if you have\\
                       &         several versions of the same game, and want\\
                       &         different aliases for them. See the example.\\
        description    &string   The description of the game as it will appear\\
                       &         in the launcher.\\
\\
        language       &string   Specify language (en, de, fr, it, pt, es, jp,\\
                       &         zh, kr, se, gb, hb, cz, ru)\\
        speech\_mute    &bool    &If true, speech is muted\\
        subtitles      &bool     Set to true to enable subtitles.\\
        talkspeed      &number   Text speed\\
\\
        fullscreen     &bool     Fullscreen mode\\
        aspect\_ratio  &bool     Enable aspect ratio correction\\
        gfx\_mode      &string   Graphics mode (normal, 2x, 3x, 2xsai,\\
                       &         super2xsai, supereagle, advmame2x, advmame3x,\\
                       &         hq2x, hq3x, tv2x, dotmatrix)\\
\\
        cdrom           &number   Number of CD-ROM unit to use for audio. If\\
                        &         negative, don't even try to access the CD-ROM.\\
        joystick\_num   &number   Number of joystick device to use for input\\
        music\_driver   &string   The music engine to use.\\
        output\_rate    &number   The output sample rate to use, in Hz. Sensible\\
                        &         values are 11025, 22050 and 44100.\\
        alsa\_port      &string   Port to use for output when using the\\
                        &         ALSA music driver.\\
        music\_volume   &number   The music volume setting (0-255)\\
        multi\_midi     &bool     If true, enable combination Adlib and native\\
                        &         MIDI.\\
        soundfont       &string   The SoundFont to use for MIDI playback. (Only\\
                        &         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)\\
        midi\_gain      &number   The MIDI gain (0-1000) (default: 100) (Only\\
                        &         supported by some MIDI drivers.)\\
\\
        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 \\
                        &         Beneath a Steel Sky and Flight of the Amazon\\
                        &         Queen
\\
        boot\_param     &number   Pass this number to the boot script\\
\end{tabular}

Broken Sword 2 adds the following non-standard keywords:\\
\begin{tabular}[h]{lll}
        gfx\_details    &number  &Graphics details setting (0-3)\\
        music\_mute     &bool    &If true, music is muted\\
        object\_labels  &bool    &If true, object labels are enabled\\
        reverse\_stereo &bool    &If true, stereo channels are reversed\\
        sfx\_mute       &bool    &If true, sound effects are muted\\
\end{tabular}

Flight of the Amazon Queen adds the following non-standard keywords:\\
\begin{tabular}[h]{lll}
        music\_mute     &bool    &If true, music is muted\\
        sfx\_mute       &bool    &If true, sound effects are muted\\
\end{tabular}

Simon the Sorcerer 1 \& 2 add the following non-standard keywords:\\
\begin{tabular}[h]{lll}
        music\_mute     &bool    &If true, music is muted\\
        sfx\_mute       &bool    &If true, sound effects are muted\\
\end{tabular}

The Legend of Kyrandia adds the following non-standard keyword:\\
\begin{tabular}[h]{lll}
        walkspeed       &int     &The walk speed (0-4)\\
\end{tabular}