1QMC2-ARCADE(6) QMC2 User's Guide QMC2-ARCADE(6)
2
6 qmc2-arcade - Arcade / non-desktop version of QMC2 - M.A.M.E. Cata‐
7 log/Launcher II
8
10 qmc2-arcade [-theme qml_theme] [-console type] [-graphicssystem engine] [-language lang] [-video vdo] [-config_path path] [-fullscreen] [-windowed] [-nojoy] [-joy index] [-debugjoy] [-debugkeys] [-debugqt] [-h|-?|-help]
11
13 For those who want to 'go straight into the games' there's QMC2 Arcade,
14 a QML / QtQuick based approach to presenting an optionally filtered ma‐
15 chine-list, launching emulators in the same smart way that you're used
16 to with QMC2's main GUI (see qmc2(6)).
17 Although it's designed to run stand-alone, you must start QMC2's main
19 GUI at least once prior to using QMC2 Arcade, because some of the file
20 caches need to be created first - QMC2 Arcade doesn't take care of this
21 itself. Also, you cannot change the emulator's configuration from
22 within QMC2 Arcade. So whenever you want to make modifications to a ma‐
23 chine's configuration (or the global setup) you have to do this through
24 QMC2's main GUI as well.
25 The main GUI also has a specific dialog for setting up all relevant
27 back-end default options (-theme, -console, -graphicssystem, -language
28 and -video), for producing a filtered machine list used by QMC2 Arcade
29 exclusively (optional) and for mapping key-sequences or joystick-func‐
30 tions (also optional). Default values for back-end options can also be
31 configured inside QMC2 Arcade provided the chosen qml_theme supports it
32 (which all of the available themes do).
33 Changed back-end default options will require a restart of QMC2 Arcade
35 to take effect. Specifying them on the command line will overwrite the
36 current defaults temporarily, but will not change their stored default
37 values. Note that the -language back-end default option is a shared
38 setting for both QMC2 Arcade and the main GUI.
39
41 -theme qml_theme
42 Select the QML theme used for scene graphics, animations and/or
43 shader effects. Available values for qml_theme are 'ToxicWaste'
44 (default) and 'darkone'.
45 -console type
47 Choose the type of console to use. Available values for type are
48 'terminal' (default), 'window', 'window-minimized' and 'none'.
49 Console type 'none' will effectively suppress all log messages.
50 -graphicssystem engine
52 Select the graphics sub-system engine instead of the currently
53 set default one. Available values for engine are 'raster' (de‐
54 fault), 'opengl', 'opengl1', 'opengl2', 'openvg' and 'native'.
55 Note that this option only exists when QMC2 Arcade has been
56 built with Qt 4 (which is recommended). Qt 5 builds do not in‐
57 clude it!
58 -language lang
60 Choose translation to load. Run 'qmc2-arcade -h' for a list of
61 available values for lang. Note that the default value for -lan‐
62 guage is shared with the main GUI's language setting!
63 -video vdo
65 Enable (vdo = 'on') or disable (vdo = 'off') the use of video
66 snaps (theme-specific). The value of vdo will be ignored when
67 the current theme has no built-in support for video snaps.
68 -config_path path
70 Specify this argument to use the directory path instead of the
71 default folder (~/.qmc2) to search for QMC2's configuration and
72 cache-files.
73 -fullscreen
75 Start up in full screen mode, overwriting the stored setting
76 -windowed
78 Start up in windowed mode, overwriting the stored setting
79 -nojoy Disable joystick-function mapping (regardless if it's enabled in
81 the main GUI or not).
82 -joy index
84 Use the joystick specified by index instead of the one read from
85 ~/.qmc2/qmc2.ini, and enable joystick-function mapping (regard‐
86 less if it's enabled in the main GUI or not).
87 -debugjoy
89 Enable debug logging for joystick-function mapping. Every recog‐
90 nized joystick-function which has been mapped to a key-sequence
91 will be logged to the console.
92 -debugkeys
94 Enable debug logging for key-sequence mapping. Every recognized
95 key or key-sequence will be logged to the console together with
96 info on how the event is processed. Mapped key-sequences will
97 cause event emulation, others will follow Qt's default event
98 processing.
99 -debugqt
101 Enable logging of Qt debug messages
102 -h|-?|-help
104 Show usage help, available options / values and their current
105 defaults.
106
108 /etc/qmc2/qmc2.ini
109 System-wide default configuration (optional)
110 ~/.qmc2/qmc2.ini
112 Individual user's configuration
113 ~/.qmc2/mame.mlc
115 Machine list cache
116 ~/.qmc2/mame.mlc.filtered
118 Filtered version of the machine list cache created by qmc2(6)
119 (optional)
120 ~/.qmc2/mame-icon-cache.db
122 Icon cache database (SQLite 3)
123 ~/.qmc2/mame-dat-info.db
125 DAT-info database (SQLite 3), a combined data store for all sup‐
126 ported DAT-info sources (emu-info, machine-info and software-
127 info)
128
130 qmc2-sdlmame(6), qchdman(6)
131
133 See the TODO file in the included QMC2 documentation for known bugs and
134 restrictions.
135 New bugs can be reported here: http://tracker.batcom-
137 it.net/view_all_bug_page.php?project_id=1
138
140 The QMC2 development-team (http://qmc2.batcom-it.net/)
1410.195 August 01, 2021 QMC2-ARCADE(6)