doc/mgba-qt.6 (view raw)
1.\" Copyright (c) 2015 Anthony J. Bentley <anthony@anjbe.name>
2.\"
3.\" This Source Code Form is subject to the terms of the Mozilla Public
4.\" License, v. 2.0. If a copy of the MPL was not distributed with this
5.\" file, you can obtain one at https://mozilla.org/MPL/2.0/.
6.Dd July 29, 2015
7.Dt MGBA-QT 6
8.Os
9.Sh NAME
10.Nm mgba-qt
11.Nd Game Boy Advance emulator
12.Sh SYNOPSIS
13.Nm mgba-qt
14.Op Fl b Ar biosfile
15.Op Fl l Ar loglevel
16.Op Fl p Ar patchfile
17.Op Fl s Ar n
18.Ar file
19.Sh DESCRIPTION
20.Nm
21is a Game Boy Advance emulator.
22The options are as follows:
23.Bl -tag -width Ds
24.It Fl b Ar biosfile , Fl -bios Ar biosfile
25Specify a BIOS file to use during boot.
26If this flag is omitted,
27.Nm
28will use the BIOS specified in the configuration file,
29or a high\(hylevel emulated BIOS if none is specified.
30.It Fl l Ar loglevel
31Log messages during emulation.
32.Ar loglevel
33is a bitmask defining which types of messages to log:
34.Bl -bullet -compact
35.It
361 \(en fatal errors
37.It
382 \(en errors
39.It
404 \(en warnings
41.It
428 \(en informative messages
43.It
4416 \(en debugging messages
45.It
4632 \(en stub messages for unimplemented features
47.It
48256 \(en in\(hygame errors
49.It
50512 \(en software interrupts
51.It
521024 \(en emulator status messages
53.It
542048 \(en serial I/O messages
55.El
56The default is to log warnings, errors, fatal errors, and status messages.
57.It Fl p Ar patchfile , Fl -patch Ar patchfile
58Specify a patch file in BPS, IPS, or UPS format.
59.It Fl s Ar n , Fl -frameskip Ar n
60Skip every
61.Ar n
62frames.
63.El
64.Sh CONTROLS
65The default controls are as follows:
66.Bl -hang -width "Frame advance" -compact
67.It A
68.Cm x
69.It B
70.Cm z
71.It L
72.Cm a
73.It R
74.Cm s
75.It Start
76.Aq Cm Enter
77.It Select
78.Aq Cm Backspace
79.It Load state
80.Cm F1 Ns \(en Ns Cm F9
81.It Save state
82.Ao Cm Shift Ac Ns \(hy Ns Cm F1 Ns \(en Ns Cm F9
83.It Frame advance
84.Ao Cm Ctrl Ac Ns \(hy Ns Cm n
85.El
86.Sh FILES
87.Bl -tag -width ~/.config/mgba/config.ini -compact
88.It Pa ~/.config/mgba/config.ini
89Default
90.Xr mgba 6
91configuration file.
92.It Pa ~/.config/mgba/qt.ini
93Default
94.Nm mgba-qt
95configuration file.
96.It Pa portable.ini
97If this file exists in the current directory,
98.Nm
99will read
100.Pa config.ini
101and
102.Pa qt.ini
103from the current directory instead of
104.Pa ~/.config/mgba .
105.El
106.Sh AUTHORS
107.An Jeffrey Pfau Aq Mt jeffrey@endrift.com
108.Sh HOMEPAGE
109.Bl -bullet
110.It
111.Lk https://mgba.io/ "mGBA homepage"
112.It
113.Lk https://github.com/mgba-emu/mgba "Development repository"
114.It
115.Lk https://github.com/mgba-emu/mgba/issues "Bug tracker"
116.It
117.Lk https://forums.mgba.io/ "Message board"
118.El