1QMC2-ARCADE(6)                 QMC2 User's Guide                QMC2-ARCADE(6)
2
3
4

NAME

6       qmc2-arcade  -  Arcade  /  non-desktop version of QMC2 - M.A.M.E. Cata‐
7       log/Launcher II
8

SYNOPSIS

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

DESCRIPTION

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
15       machine-list, launching emulators in the same  smart  way  that  you're
16       used to with QMC2's main GUI (see qmc2(6)).
17
18       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
23       machine's configuration (or the global  setup)  you  have  to  do  this
24       through QMC2's main GUI as well.
25
26       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
34       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

OPTIONS

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
46       -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
51       -graphicssystem engine
52              Select  the  graphics sub-system engine instead of the currently
53              set default  one.  Available  values  for  engine  are  'raster'
54              (default),   'opengl',   'opengl1',   'opengl2',   'openvg'  and
55              'native'. Note that this option only exists when QMC2 Arcade has
56              been  built with Qt 4 (which is recommended). Qt 5 builds do not
57              include it!
58
59       -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
64       -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
69       -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
74       -fullscreen
75              Start up in full screen mode, overwriting the stored setting
76
77       -windowed
78              Start up in windowed mode, overwriting the stored setting
79
80       -nojoy Disable joystick-function mapping (regardless if it's enabled in
81              the main GUI or not).
82
83       -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
88       -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
93       -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
100       -debugqt
101              Enable logging of Qt debug messages
102
103       -h|-?|-help
104              Show  usage  help,  available options / values and their current
105              defaults.
106

FILES

108       /etc/qmc2/qmc2.ini
109              System-wide default configuration (optional)
110
111       ~/.qmc2/qmc2.ini
112              Individual user's configuration
113
114       ~/.qmc2/mame.mlc
115              Machine list cache
116
117       ~/.qmc2/mame.mlc.filtered
118              Filtered version of the machine list cache  created  by  qmc2(6)
119              (optional)
120
121       ~/.qmc2/mame-icon-cache.db
122              Icon cache database (SQLite 3)
123
124       ~/.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

SEE ALSO

130       qmc2-sdlmame(6), qchdman(6)
131

BUGS

133       See the TODO file in the included QMC2 documentation for known bugs and
134       restrictions.
135
136       New    bugs    can    be    reported    here:    http://tracker.batcom-
137       it.net/view_all_bug_page.php?project_id=1
138

AUTHOR

140       The QMC2 development-team (http://qmc2.batcom-it.net/)
141
142
143
1440.195                          January 30, 2020                 QMC2-ARCADE(6)
Impressum