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 -inset
 35.It 1
 36fatal errors
 37.It 2
 38errors
 39.It 4
 40warnings
 41.It 8
 42informative messages
 43.It 16
 44debugging messages
 45.It 32
 46stub messages for unimplemented features
 47.It 256
 48in\(hygame errors
 49.It 512
 50software interrupts
 51.It 1024
 52emulator status messages
 53.It 2048
 54serial 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.El
 97.Sh AUTHORS
 98.An Jeffrey Pfau Aq Mt jeffrey@endrift.com
 99.Sh HOMEPAGE
100.Bl -bullet
101.It
102.Lk https://mgba.io/ "mGBA homepage"
103.It
104.Lk https://github.com/mgba-emu/mgba "Development repository"
105.It
106.Lk https://github.com/mgba-emu/mgba/issues "Bug tracker"
107.It
108.Lk https://forums.mgba.io/ "Message board"
109.El