qmc2-arcade man page

qmc2-arcade — Arcade / non-desktop version of QMC2 — M.A.M.E. Catalog/Launcher II

Synopsis

qmc2-arcade [-theme qml_theme] [-console type] [-graphicssystem engine] [-language lang] [-video vdo] [-config_path path] [-fullscreen] [-windowed] [-debugkeys] [-nojoy] [-joy index] [-debugjoy] [-h|-?|-help]

Description

For those who want to 'go straight into the games' there's QMC2 Arcade, a QML / QtQuick based approach to presenting an optionally filtered machine-list, launching emulators in the same smart way that you're used to with QMC2's main GUI (see qmc2(6)).

Although it's designed to run stand-alone, you must start QMC2's main GUI at least once prior to using QMC2 Arcade, because some of the file caches need to be created first - QMC2 Arcade doesn't take care of this itself. Also, you cannot change the emulator's configuration from within QMC2 Arcade. So whenever you want to make modifications to a machine's configuration (or the global setup) you have to do this through QMC2's main GUI as well.

The main GUI also has a specific dialog for setting up all relevant back-end default options (-theme, -console, -graphicssystem, -language and -video), for producing a filtered machine list used by QMC2 Arcade exclusively (optional) and for mapping key-sequences or joystick-functions (also optional). Default values for back-end options can also be configured inside QMC2 Arcade provided the chosen qml_theme supports it (which all of the available themes do).

Changed back-end default options will require a restart of QMC2 Arcade to take effect. Specifying them on the command line will overwrite the current defaults temporarily, but will not change their stored default values. Note that the -language back-end default option is a shared setting for both QMC2 Arcade and the main GUI.

Options

-theme qml_theme
Select the QML theme used for scene graphics, animations and/or shader effects. Available values for qml_theme are 'ToxicWaste' (default) and 'darkone'.
-console type
Choose the type of console to use. Available values for type are 'terminal' (default), 'window', 'window-minimized' and 'none'. Console type 'none' will effectively suppress all log messages.
-graphicssystem engine
Select the graphics sub-system engine instead of the currently set default one. Available values for engine are 'raster' (default), 'opengl', 'opengl1', 'opengl2', 'openvg' and 'native'. Note that this option only exists when QMC2 Arcade has been built with Qt 4 (which is recommended). Qt 5 builds do not include it!
-language lang
Choose translation to load. Run 'qmc2-arcade -h' for a list of available values for lang. Note that the default value for -language is shared with the main GUI's language setting!
-video vdo
Enable (vdo = 'on') or disable (vdo = 'off') the use of video snaps (theme-specific). The value of vdo will be ignored when the current theme has no built-in support for video snaps.
-config_path path
Specify this argument to use the directory path instead of the default folder (~/.qmc2) to search for QMC2's configuration and cache-files.
-fullscreen
Start up in full screen mode, overwriting the stored setting
-windowed
Start up in windowed mode, overwriting the stored setting
-debugkeys
Enable debug logging for key-sequence mapping. Every recognized key or key-sequence will be logged to the console together with info on how the event is processed. Mapped key-sequences will cause event emulation, others will follow Qt's default event processing.
-nojoy
Disable joystick-function mapping (regardless if it's enabled in the main GUI or not).
-joy index
Use the joystick specified by index instead of the one read from ~/.qmc2/qmc2.ini, and enable joystick-function mapping (regardless if it's enabled in the main GUI or not).
-debugjoy
Enable debug logging for joystick-function mapping. Every recognized joystick-function which has been mapped to a key-sequence will be logged to the console.
-h|-?|-help
Show usage help, available options / values and their current defaults.

Files

/etc/qmc2/qmc2.ini
System-wide default configuration (optional)
~/.qmc2/qmc2.ini
Individual user's configuration
~/.qmc2/mame.mlc
Machine list cache
~/.qmc2/mame.mlc.filtered
Filtered version of the machine list cache created by qmc2(6) (optional)

See Also

qmc2-sdlmame(6), qchdman(6)

Bugs

See the TODO file in the included QMC2 documentation for known bugs and restrictions.

New bugs can be reported here: http://tracker.batcom-it.net/view_all_b…

Author

The QMC2 development-team (http://qmc2.batcom-it.net/)

Referenced By

qchdman(6), qmc2-main-gui(6).

October 28, 2016 0.69 QMC2 User's Guide