scummvm/doc/docportal/using_scummvm/the_launcher.rst
2020-10-04 18:29:01 +02:00

136 lines
5.3 KiB
ReStructuredText
Executable file

==============
The Launcher
==============
The main ScummVM window is called the Launcher. The Launcher opens whenever you start ScummVM, unless you launch a game directly from the command line.
The games list
===============
The pane on the left lists the games you have added to ScummVM. This list usually offers some additional information about each game, such as original platform and language. To highlight any game on the list, type the first letter(s) of its title, or click on it.
.. image:: ../images/Launcher/the_launcher.jpg
:class: with-shadow
Quick search
=============
Quick search allows you to filter the list of added games.
The quick search input is located at the top of the page next to the magnifying glass icon. The filter is applied as you type, and is not case sensitive. To clear the filter, select the **X** button next to the input box.
There are many ways to filter games. For instance, you can type "Monkey Island" to quickly locate all "Monkey Island" games on the list, or you can type "German" if you wish to play a game in German.
.. image:: ../images/Launcher/quicksearch.jpg
:class: with-shadow
The buttons
============
To the right of the games list there are a number of buttons. Their functions are as follows:
Start
-----
Launches the highlighted game.
.. image:: ../images/Launcher/start_game.jpg
Load
----
Opens the Load window, from which you can run a previously saved state without having to start the game first.
There are two views: list view and tile view. Toggle between the two by clicking the list and tile icons at the bottom left of the window.
In list view, the pane on the left displays a list of your saved states. Click on a saved state to highlight it. On the right, information about the highlighted state such as timestamps, screenshots and playtime is displayed.
When you have located the desired saved game:
- Click **Load** to launch the game using that state.
- Click **Delete** to delete the saved state.
In tile view, each tile shows a screenshot of the saved state, as well as the description and save slot number. Click on the tile to load that saved state.
.. caution::
There are games that do not support the save game feature, or whose saved states lack information such as playtime or screenshots.
.. image:: ../images/Launcher/save_game_list.jpg
:class: with-shadow
.. image:: ../images/Launcher/save_game_tile.jpg
:class: with-shadow
Add Game
---------
On some platforms, the Add Game button opens the default system dialog to allow you to choose the folder containing the game files. On other platforms, the custom ScummVM file browser opens. Use this file browser to locate the folder containing the game you wish to add. Double click on a folder to open it, and use **Go up** to go back up one level.
Once you have selected the folder that contains the game data files, click **Choose**.
.. image:: ../images/Launcher/choose_game_directory.jpg
:class: with-shadow
To add more than one game at a time, hold :kbd:`Shift` while clicking **Add Game**.
For more information, see the :doc:`adding_games` page.
Edit Game
----------
Opens the game settings window. This window also opens whenever a game is added from the Launcher.
Use this window to configure a game individually by overriding the default global game settings you have set via the **Options** window. You can also change the game's language and original platform, if applicable. For more information, see the :doc:`game_settings` page.
.. image:: ../images/Launcher/edit_game.jpg
:class: with-shadow
Remove Game
-----------
Removes the highlighted game from the list.
Options
-------
Opens the global settings window. Use this window to define global game settings, as well as change a number of the ScummVM Launcher settings. For more details on how to fine-tune ScummVM, see the :doc:`global_settings` page.
.. image:: ../images/Launcher/options.jpg
:class: with-shadow..
About
-----
Shows credits and miscellaneous information about your version of ScummVM.
Quit
-------
Closes the Launcher and quits the ScummVM application.
The Global Main Menu
=====================
The Global Main Menu (GMM) is available while playing any game by pressing :kbd:`Ctrl` + :kbd:`F5`, or :kbd:`Ctrl` + :kbd:`fn` + :kbd:`F5` on a Mac. It provides the following options:
.. image:: ../images/Launcher/gmm.jpg
:class: with-shadow
- **Resume:** Closes the GMM and resume the game.
- **Load:** Loads a saved game state. This is not available for all games.
- **Save:** Saves a game state. This is not available for all games.
- **Options:** Provides gameplay options, such as sound volume and subtitle settings.
.. image:: ../images/Launcher/gmm_options.jpg
:class: with-shadow
- **About:** Displays the ScummVM About box. This is also available from the The Launcher.
- **Help:** Displays a list of keyboard shortcuts for the game. This not available for all games.
.. image:: ../images/Launcher/gmm_help.jpg
- **Return to Launcher:** Quits the game and returns to The Launcher. This is not available for all games.
- **Quit:** Quits the game and ScummVM, and returns to the Operating System.
.. caution::
In some games you can still access the original game menu by using :kbd:`Alt` + :kbd:`F5`. You can save and load games this way, however it is not intended for this purpose and may crash ScummVM in some games.