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 123456f
 15.Op Fl b Ar biosfile
 16.Op Fl l Ar loglevel
 17.Op Fl p Ar patchfile
 18.Op Fl s Ar n
 19.Ar file
 20.Sh DESCRIPTION
 21.Nm
 22is a Game Boy Advance emulator.
 23The options are as follows:
 24.Bl -tag -width Ds
 25.It Fl 1
 26Scale the window 1\(mu.
 27.It Fl 2
 28Scale the window 2\(mu.
 29.It Fl 3
 30Scale the window 3\(mu.
 31.It Fl 4
 32Scale the window 4\(mu.
 33.It Fl 5
 34Scale the window 5\(mu.
 35.It Fl 6
 36Scale the window 6\(mu.
 37.It Fl b Ar biosfile , Fl -bios Ar biosfile
 38Specify a BIOS file to use during boot.
 39If this flag is omitted,
 40.Nm
 41will use the BIOS specified in the configuration file,
 42or a high\(hylevel emulated BIOS if none is specified.
 43.It Fl f
 44Start the emulator full\(hyscreen.
 45.It Fl l Ar loglevel
 46Log messages during emulation.
 47.Ar loglevel
 48is a bitmask defining which types of messages to log:
 49.Bl -bullet -compact
 50.It
 511 \(en fatal errors
 52.It
 532 \(en errors
 54.It
 554 \(en warnings
 56.It
 578 \(en informative messages
 58.It
 5916 \(en debugging messages
 60.It
 6132 \(en stub messages for unimplemented features
 62.It
 63256 \(en in\(hygame errors
 64.It
 65512 \(en software interrupts
 66.It
 671024 \(en emulator status messages
 68.It
 692048 \(en serial I/O messages
 70.El
 71The default is to log warnings, errors, fatal errors, and status messages.
 72.It Fl p Ar patchfile , Fl -patch Ar patchfile
 73Specify a patch file in BPS, IPS, or UPS format.
 74.It Fl s Ar n , Fl -frameskip Ar n
 75Skip every
 76.Ar n
 77frames.
 78.El
 79.Sh CONTROLS
 80The default controls are as follows:
 81.Bl -hang -width "Frame advance" -compact
 82.It A
 83.Cm x
 84.It B
 85.Cm z
 86.It L
 87.Cm a
 88.It R
 89.Cm s
 90.It Start
 91.Aq Cm Enter
 92.It Select
 93.Aq Cm Backspace
 94.It Load state
 95.Cm F1 Ns \(en Ns Cm F9
 96.It Save state
 97.Ao Cm Shift Ac Ns \(hy Ns Cm F1 Ns \(en Ns Cm F9
 98.It Frame advance
 99.Ao Cm Ctrl Ac Ns \(hy Ns Cm n
100.El
101.Sh FILES
102.Bl -tag -width ~/.config/mgba/config.ini -compact
103.It Pa ~/.config/mgba/config.ini
104Default
105.Xr mgba 6
106configuration file.
107.It Pa ~/.config/mgba/qt.ini
108Default
109.Nm mgba-qt
110configuration file.
111.It Pa portable.ini
112If this file exists in the current directory,
113.Nm
114will read
115.Pa config.ini
116and
117.Pa qt.ini
118from the current directory instead of
119.Pa ~/.config/mgba .
120.El
121.Sh AUTHORS
122.An Jeffrey Pfau Aq Mt jeffrey@endrift.com
123.Sh HOMEPAGE
124.Bl -bullet
125.It
126.Lk https://mgba.io/ "mGBA homepage"
127.It
128.Lk https://github.com/mgba-emu/mgba "Development repository"
129.It
130.Lk https://github.com/mgba-emu/mgba/issues "Bug tracker"
131.It
132.Lk https://forums.mgba.io/ "Message board"
133.El