File: the_launcher.rst

package info (click to toggle)
scummvm 2.9.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 450,580 kB
  • sloc: cpp: 4,299,825; asm: 28,322; python: 12,901; sh: 11,302; java: 9,289; xml: 7,895; perl: 2,639; ansic: 2,465; yacc: 1,670; javascript: 1,020; makefile: 933; lex: 578; awk: 275; objc: 82; sed: 11; php: 1
file content (160 lines) | stat: -rwxr-xr-x 5,258 bytes parent folder | download | duplicates (3)
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
150
151
152
153
154
155
156
157
158
159
160
===================================
Understanding the interface
===================================

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. Use the buttons on the bottom left of the screen to toggle between list and grid view. 

.. figure:: ../images/Launcher/launcher_list.png

   The Launcher in list view.

.. figure:: ../images/Launcher/launcher_grid.png

   The Launcher in grid view.


The games list
********************

The pane on the left, when the Launcher is in list view, shows the games list, which shows all the games that have been added to ScummVM. The games 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.

In grid view, all game icons are in the pane below the buttons, and show the game artwork. See :ref:`Update Icons <updateicons>` for information on how to update these. Use the **Icons per row** slider at the bottom of the page to change the size of the icons. Click on a game to select it. Click on the play icon in the pop-up menu to start the game, the gear icon to open the Game Options menu, or the export icon to load a saved game. 

.. figure:: ../images/Launcher/launcher_popup.png

   Game pop-up menu in grid view


.. _search_box:

The search box
********************

The search box lets you filter the games list. It 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, click **X**.

There are many ways to filter games. For example, you can type "Monkey Island" to locate all "Monkey Island" games on the list, or you can type "lang:de" to find German games. For a comprehensive look at how to use the search box, check out our :doc:`../advanced_topics/understand_search_box` guide.

The grouping menu
******************

.. _group:

To the right of the search box is the grouping menu. Use this menu to group games in alphabetical order, or by engine, series, publisher, language or platform. Hide or show groups of games by clicking on the black arrow to the left of each group heading. 

.. figure:: ../images/Launcher/launcher_list_group.png
   
   The grouping menu, with the Launcher in list view


The buttons
************************

To the right of the games list in list view, or above the games list in grid view, there are a number of buttons. Their functions are as follows:

Start (list view only)
^^^^^^^^^^^^^^^^^^^^^^^
Launches the highlighted game.

Load (list view only)
^^^^^^^^^^^^^^^^^^^^^

Opens the load game window, from which you can go to a saved game without having to start the game first.

See the :doc:`save_load_games` page.

Add Game
^^^^^^^^^^

Opens a file browser. To add a game, select a folder containing game files.

See the :doc:`add_play_games` page.

Game Options (list view only)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Opens the game settings window. This window also opens whenever a game is added to the games list in the Launcher.

Use this window to configure settings specific to a game. These settings override the global settings. For more information, see the :doc:`../use_scummvm/how_to_settings` page.


Remove Game
^^^^^^^^^^^^^

Removes the highlighted game from the list. This does not remove any saved games, so if you add a game to the games list again, you are able to resume where you left off.


Global 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 information, see the :doc:`../use_scummvm/how_to_settings` page.

About
^^^^^^^^^^
Shows credits and miscellaneous information about ScummVM.

Quit
^^^^^^^
Closes the Launcher and quits the ScummVM application.

The Global Main Menu
=====================

You can access the ScummVM Global Main Menu, also known as the GMM, while you are playing a game. To open the GMM, press :kbd:`Ctrl+F5` (:kbd:`Ctrl+fn+F5` on a Mac).

.. figure:: ../images/Launcher/gmm.png

   The Global Main Menu, or GMM.


The buttons
*****************

In the Global Main Menu there are a number of buttons. Their functions are as follows:

Resume
^^^^^^^^^^

Closes the GMM and resumes the game.

Load
^^^^^^

Opens the load game window. From here, you can load a saved game.

Save
^^^^^^

Opens the save game window. From here, you can save a game.

Options
^^^^^^^^

Opens a dialog which provides some gameplay options, such as sound volume, subtitle and keymap settings.


About
^^^^^^^^^^^

Displays the ScummVM **About** dialog. This is also available from the Launcher.

Help
^^^^^^

Displays a list of keyboard shortcuts for the game. Note that this is not available for all games; refer to the :doc:`../settings/keymaps` tab for keyboard shortcuts.

Return to Launcher
^^^^^^^^^^^^^^^^^^^^^

Quits the game and returns to the Launcher.

.. note::

   This is not available for all games.

Quit
^^^^^^^
Quits the game and ScummVM, and returns to the operating system. Any unsaved game progress is lost.