qmc2-arcade(6)

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] [-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 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
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 ma‐
23       chine's configuration (or the global setup) you have to do this through
24       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       -language lang
52              Choose  translation  to load. Run 'qmc2-arcade -h' for a list of
53              available values for lang. Note that the default value for -lan‐
54              guage is shared with the main GUI's language setting!
55
56       -video vdo
57              Enable  (vdo  =  'on') or disable (vdo = 'off') the use of video
58              snaps (theme-specific). The value of vdo will  be  ignored  when
59              the current theme has no built-in support for video snaps.
60
61       -config_path path
62              Specify  this  argument to use the directory path instead of the
63              default folder (~/.qmc2) to search for QMC2's configuration  and
64              cache-files.
65
66       -fullscreen
67              Start up in full screen mode, overwriting the stored setting
68
69       -windowed
70              Start up in windowed mode, overwriting the stored setting
71
72       -nojoy Disable joystick-function mapping (regardless if it's enabled in
73              the main GUI or not).
74
75       -joy index
76              Use the joystick specified by index instead of the one read from
77              ~/.qmc2/qmc2.ini,  and enable joystick-function mapping (regard‐
78              less if it's enabled in the main GUI or not).
79
80       -debugjoy
81              Enable debug logging for joystick-function mapping. Every recog‐
82              nized  joystick-function which has been mapped to a key-sequence
83              will be logged to the console.
84
85       -debugkeys
86              Enable debug logging for key-sequence mapping. Every  recognized
87              key  or key-sequence will be logged to the console together with
88              info on how the event is processed.  Mapped  key-sequences  will
89              cause  event  emulation,  others  will follow Qt's default event
90              processing.
91
92       -debugqt
93              Enable logging of Qt debug messages
94
95       -h|-?|-help
96              Show usage help, available options / values  and  their  current
97              defaults.
98

FILES

100       /etc/qmc2/qmc2.ini
101              System-wide default configuration (optional)
102
103       ~/.qmc2/qmc2.ini
104              Individual user's configuration
105
106       ~/.qmc2/mame.mlc
107              Machine list cache
108
109       ~/.qmc2/mame.mlc.filtered
110              Filtered  version  of  the machine list cache created by qmc2(6)
111              (optional)
112
113       ~/.qmc2/mame-icon-cache.db
114              Icon cache database (SQLite 3)
115
116       ~/.qmc2/mame-dat-info.db
117              DAT-info database (SQLite 3), a combined data store for all sup‐
118              ported  DAT-info  sources  (emu-info, machine-info and software-
119              info)
120

BUGS

125       See the TODO file in the included QMC2 documentation for known bugs and
126       restrictions.
127
128       New    bugs    can    be    reported    here:   https://tracker.batcom-
129       it.net/view_all_bug_page.php?project_id=1
130

AUTHOR

132       The QMC2 development-team (https://qmc2.batcom-it.net/)
133
134
135
1360.243                          January 20, 2023                 QMC2-ARCADE(6)