Open main menu

Difference between revisions of "User Manual"

11,159 bytes removed ,  22:03, 5 December 2007
→‎Configuration: *** Split out configuration section to User_Manual/Configuration
m (Change "CVS" to "SVN")
(→‎Configuration: *** Split out configuration section to User_Manual/Configuration)
Line 463: Line 463:
TODO
TODO


= Configuration =
{{ManualSection|location=User_Manual/Configuration|name=Configuration|desc=Changing the options of ScummVM so that it runs games exactly the way you want it to}}
== Using the Launcher to configure ScummVM ==
The ScummVM Launcher gives us a graphical method for changing the settings that it uses to run games. There are two ways to do this: firstly by changing the default settings (which games will follow unless told otherwise), secondly by overriding an individual game to use settings that are different from the defaults. To begin with we will look at changing the default settings. To do this, click on the "Options" button on the right-hand side of the Launcher window. There are many options, and they are separated into tabs: we shall look at each tab in turn.
 
=== Graphics tab ===
{{ManualScreenshot|name=Graphicstab.png|desc=The Graphics tab of the ScummVM options}}
The graphics tab allows us to change various things about the way the games are displayed on screen when played.
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Graphics mode
| This allows us to change the graphic filter that ScummVM uses. See the [[#Graphic_filters|Graphic filters]] section of the manual for more detail
|-valign="top"
| Render mode
| For games that could be played on various different systems / graphics cards, this control allows us to decide which system we want ScummVM to reproduce. The options are <default> (which tries to choose the most sensible option), Hercules Green, Hercules Amber (monochrome), CGA (4 colors), EGA (16 colors), and Amiga (32 colors))
|-valign="top"
| Fullscreen mode
| Switches between playing games in a window, or playing them in fullscreen mode. Switch between the two using Alt-F5 while in a game.
|-valign="top"
| Aspect ratio correction
| Most games supported by ScummVM were designed to be played at a screen resolution of 320x200. Most modern systems, when displaying this size image, will display it in a window that is not 1.33:1 (as the designers intended), but 1.6:1 or even 1.7:1. This results in the game appearing stretched and the characters looking wider than they should. If this option is checked, ScummVM corrects for this by stretching the game window down by a similar amount, and the game can be played without distortion. Like [[#Graphic_filters|Graphic filters]], this takes a little processing power to achieve.
|}
{{-}}
 
=== Audio tab ===
{{ManualScreenshot|name=Audiotab.png|desc=The Audio tab}}The audio tab in the options allows us to change various things about the way that sound is outputted in ScummVM games.
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Music driver
| This is the method that ScummVM uses to output MIDI music. For more details, see the [[#Music_drivers | section on music drivers]].
|-valign="top"
| Output rate
| This is the sample rate at which ScummVM plays back sounds (including music if using the Adlib <*** TODO or others? ***> music driver). For more information, see the [[#Output_sample_rate| Output sample rate section]]
|-valign="top"
| Text and Speech
| For games with digitized speech, this control allows the user to decide whether to play the game with speech and without any subtitles, with subtitles displaying the words spoken in the digitized speech but not the speech, or with both.
|-valign="top"
| Subtitle speed
| This allows the user to adjust the length of time that the subtitles are displayed on screen: the lower the speed is set, the longer the subtitles appear for.
|}
{{-}}
 
=== Volume tab ===
{{ManualScreenshot|name=Volumetab.png|desc=The Volume tab}}The volume tab allows us to set the relative volumes for the various different types of sound that ScummVM plays.
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Music volume
| The volume of the music played back in games. This is usually MIDI music played back with one of the [[#Music_drivers|music drivers]], but some games use digitized music.
|-valign="top"
| SFX volume
| The volume of the sound effects within the games. '''''*** TODO: are MIDI sound effects included in this, or are they controlled by the Music volume? ***'''''
|-valign="top"
| Speech volume
| The volume of the digitized speech in the game, if it has any.
|}
{{-}}
 
=== MIDI tab ===
{{ManualScreenshot|name=Miditab.png|desc=The MIDI tab}} The MIDI tab lets us change various settings about the MIDI music played back in games.
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Soundfont
| *** TODO ***
|-valign="top"
| Mixed Adlib/MIDI mode
| *** TODO ***
|-valign="top"
| True Roland MT-32 (disable GM emulation)
| *** TODO ***
|-valign="top"
| Enable Roland GS Mode
| *** TODO ***
|-valign="top"
| MIDI gain
| *** TODO ***
|}
{{-}}
 
=== Paths tab ===
{{ManualScreenshot|name=Pathstab.png|desc=The Paths tab}}This part of the options lets the user tell ScummVM where to look for particular files
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Save Path
| This is the default folder in which ScummVM will store saved games. If this is not set, saved games will generally be stored in the current directory. Exceptions to this include Mac OS X (''$HOME/Documents/ScummVM Savegames/'') and other UNIX variants (''$HOME/.scummvm/'').
|-valign="top"
| Extra Path
| This is the folder that ScummVM will look in for various "extra" files. These could include one or more of:
* Additional datafiles required for certain games (e.g. kyra.dat)
* Soundfonts (see [[#MIDI_tab|MIDI tab]])
* MT-32 ROMs (see [[#Music_drivers|Music drivers]])
|-valign="top"
| Theme Path
| The folder that additional themes for the ScummVM Launcher are stored in.
|}
{{-}}
 
=== Misc tab ===
{{ManualScreenshot|name=Misctab.png|desc=The Misc tab}}The Misc tab contains options that don't belong on any of the other tabs.
{|class="wikitable"
|-valign="top"
! width="120"|Control
! Description
|-valign="top"
| Theme
| Click on this button to change the visual appearance of the ScummVM Launcher
|-valign="top"
| Autosave
| In some games (namely ''Beneath a Steel Sky'', ''Flight of the Amazon Queen'' and all SCUMM games), ScummVM will automatically save the game every few minutes. For the SCUMM engine, it will save in Slot 0. This saved game can be loaded again using Ctrl-0 or the F5 menu. Use this control to adjust the time period that ScummVM waits between saves; the default setting is 5 minutes.
|}
 
{{-}}
 
== Using the configuration file to configure ScummVM ==
When you change a setting in the ScummVM Launcher (see [[#Using_the_Launcher_to_configure_ScummVM |Using the Launcher to configure ScummVM]]), all it does is add a line to the ''configuration file''. This is a plain text file which stores all the settings for ScummVM. It is possible to edit this file directly, and some settings can only be changed this way.
 
The name of the config file and the location in which it is stored depend on the system you are running ScummVM on:
 
{|class="wikitable"
|-
! Operating System
! Location of config file
|-
| Windows Vista
| \Users\username\AppData\Roaming\ScummVM\scummvm.ini
|-
| Windows 2000/XP
| \Documents and Settings\username\Application Data\ScummVM\scummvm.ini
|-
| Windows NT4
| <windir>\Profiles\username\Application Data\ScummVM\scummvm.ini
|-
| Windows 95/98/ME
| <windir>\scummvm.ini
|-
| Unix
| $HOME/.scummvmrc
|-
| Mac OS X
| $HOME/Library/Preferences/ScummVM Preferences
|-
| Others
| scummvm.ini in the current directory
|}
Note: all Windows versions will use <windir>\scummvm.ini if it already exists.
 
=== All config file switches in detail ===
 
== Graphic filters ==
 
ScummVM offers several anti-aliasing filters to attempt to improve visual
quality. These filters take the original game graphics, and scale it by a
certain fixed factor (usually 2x or 3x) before displaying them to you.
So for example, if the game originally ran at a resolution of 320x200
(typical for most of the SCUMM games), then using a filter with a scale
factor of 2x will effectively yield 640x400 graphics. Likewise a
3x filter will give 960x600.
 
ScummVM uses the following graphic filters:
{|class="wikitable"
|-
! Name
! Factor
! Description
|-
| 1x
| 1x
| No filtering, no scaling, fastest
|-
| 2x
| 2x
| No filtering, simple pixel duplication (default for non 640x480 games)
|-
| 3x
| 3x
| No filtering, simple pixel duplication
|-
| 2xsai
| 2x
| SAI filter
|-
| super2xsai
| 2x
| Enhanced 2xSAI filtering
|-
| supereagle
| 2x
| Less blurry than 2xSAI, but slower
|-
| advmame2x
| 2x
| Doesn't rely on blurring like 2xSAI, fast
|-
| advmame3x
| 3x
| Doesn't rely on blurring like 2xSAI, fast
|-
| hq2x
| 2x
| Very nice high quality filter but slow
|-
| hq3x
| 3x
| Very nice high quality filter but slow
|-
| tv2x
| 2x
| Interlace filter, tries to emulate a TV
|-
| dotmatrix
| 2x
| Dot matrix effect
|}
 
To select a graphics filter from the command line, use the '-g' [[#Command_line_options|command line option]], e.g.:
 
<pre>scummvm -gadvmame2x monkey2</pre>
 
There is always a speed impact when using any form of anti-aliasing/linear filtering. Filters can be especially slow when ScummVM is compiled in a debug
configuration without optimizations. For these reasons, not all backends support all (or even any) of the filters listed above;
some may support additional ones. The filters listed above are those supported by the default SDL backend.
 
NB: The final resolution depends on the original resolution of the game you are playing. For example, the FM-TOWNS version of Zak McKracken uses an original resolution of 320x240, hence for this game the final resolution with a scaler will be 640x480 (2x) or 960x720 (3x).
Likewise, games that were originally 640x480 (such as Curse of Monkey Island or the Broken Sword games) will be scaled to 1280x960 (2x) and 1920x1440 (3x).
 
== Music and Sound ==
=== Music drivers ===
=== Using compressed audio files ===
=== Output sample rate ===
The output sample rate tells ScummVM how many sound samples to play per channel per second. There is much that could be said on this subject, but most of it is beyond the scope of this document. The short version is that for most games 22050 Hz is fine, but in some cases 44100 Hz is preferable. On extremely low-end systems you may want to use 11025 Hz, but it’s unlikely that you will have to worry about that.
 
To elaborate, most of the sounds that ScummVM has to play were sampled at either 22050 Hz or 11025 Hz. Using a higher sample rate will not magically improve the quality of these sounds, thus 22050 Hz is fine.
 
Some games use CD audio. If you use compressed files for this, they are probably sampled at 44100 Hz, so for these games that may be a better choice of sample rate.
 
When using the Adlib, FM Towns, PC Speaker or IBM PCjr music drivers, ScummVM is responsible for generating the samples. Usually 22050 Hz will be plenty for these, but there is at least one piece of Adlib music in Beneath a Steel Sky that will sound a lot better at 44100 Hz.
 
Using frequencies in between is not recommended. For one thing, your sound card may not support it. In theory, ScummVM should fall back on a sensible frequency in that case, but don’t count on it. More importantly, ScummVM has to resample all sounds to its output frequency. This is much easier to do well if the output frequency is a multiple of the original frequency.


= Appendix: Supported games =
= Appendix: Supported games =
306

edits