mirror of https://github.com/mgba-emu/mgba.git
155 lines
3.1 KiB
Groff
155 lines
3.1 KiB
Groff
.\" Copyright (c) 2015-2016 Anthony J. Bentley <anthony@anjbe.name>
|
|
.\"
|
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
.\" file, you can obtain one at https://mozilla.org/MPL/2.0/.
|
|
.Dd July 29, 2015
|
|
.Dt MGBA-QT 6
|
|
.Os
|
|
.Sh NAME
|
|
.Nm mgba-qt
|
|
.Nd Game Boy Advance emulator
|
|
.Sh SYNOPSIS
|
|
.Nm mgba-qt
|
|
.Op Fl 123456fg
|
|
.Op Fl b Ar biosfile
|
|
.Op Fl C Ar option Ns = Ns Ar value
|
|
.Op Fl l Ar loglevel
|
|
.Op Fl p Ar patchfile
|
|
.Op Fl s Ar n
|
|
.Ar file
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a Game Boy Advance emulator.
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl 1
|
|
Scale the window 1\(mu.
|
|
.It Fl 2
|
|
Scale the window 2\(mu.
|
|
.It Fl 3
|
|
Scale the window 3\(mu.
|
|
.It Fl 4
|
|
Scale the window 4\(mu.
|
|
.It Fl 5
|
|
Scale the window 5\(mu.
|
|
.It Fl 6
|
|
Scale the window 6\(mu.
|
|
.It Fl b Ar biosfile , Fl -bios Ar biosfile
|
|
Specify a BIOS file to use during boot.
|
|
If this flag is omitted,
|
|
.Nm
|
|
will use the BIOS specified in the configuration file,
|
|
or a high\(hylevel emulated BIOS if none is specified.
|
|
.It Fl C Ar option Ns = Ns Ar value , Fl -config Ar option Ns = Ns Ar value
|
|
Override the given config
|
|
.Ar option
|
|
with
|
|
.Ar value .
|
|
.It Fl f
|
|
Start the emulator full\(hyscreen.
|
|
.It Fl g
|
|
Start a
|
|
.Xr gdb 1
|
|
session.
|
|
By default the session starts on port 2345.
|
|
.It Fl l Ar loglevel
|
|
Log messages during emulation.
|
|
.Ar loglevel
|
|
is a bitmask defining which types of messages to log:
|
|
.Bl -bullet -compact
|
|
.It
|
|
1 \(en fatal errors
|
|
.It
|
|
2 \(en errors
|
|
.It
|
|
4 \(en warnings
|
|
.It
|
|
8 \(en informative messages
|
|
.It
|
|
16 \(en debugging messages
|
|
.It
|
|
32 \(en stub messages for unimplemented features
|
|
.It
|
|
256 \(en in\(hygame errors
|
|
.It
|
|
512 \(en software interrupts
|
|
.It
|
|
1024 \(en emulator status messages
|
|
.It
|
|
2048 \(en serial I/O messages
|
|
.El
|
|
The default is to log warnings, errors, fatal errors, and status messages.
|
|
.It Fl p Ar patchfile , Fl -patch Ar patchfile
|
|
Specify a patch file in BPS, IPS, or UPS format.
|
|
.It Fl s Ar n , Fl -frameskip Ar n
|
|
Skip every
|
|
.Ar n
|
|
frames.
|
|
.El
|
|
.Sh CONTROLS
|
|
The default controls are as follows:
|
|
.Bl -hang -width "Frame advance" -compact
|
|
.It A
|
|
.Cm x
|
|
.It B
|
|
.Cm z
|
|
.It L
|
|
.Cm a
|
|
.It R
|
|
.Cm s
|
|
.It Start
|
|
.Aq Cm Enter
|
|
.It Select
|
|
.Aq Cm Backspace
|
|
.It Load state
|
|
.Cm F1 Ns \(en Ns Cm F9
|
|
.It Save state
|
|
.Ao Cm Shift Ac Ns \(hy Ns Cm F1 Ns \(en Ns Cm F9
|
|
.It Frame advance
|
|
.Ao Cm Ctrl Ac Ns \(hy Ns Cm n
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width Ds -compact
|
|
.It Ev XDG_CONFIG_HOME
|
|
The location where
|
|
.Nm
|
|
will look for the configuration directory.
|
|
If not set,
|
|
.Pa ~/.config
|
|
is used.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width Ds -compact
|
|
.It Pa $XDG_CONFIG_HOME/mgba/config.ini
|
|
Default
|
|
.Xr mgba 6
|
|
configuration file.
|
|
.It Pa $XDG_CONFIG_HOME/mgba/qt.ini
|
|
Default
|
|
.Nm mgba-qt
|
|
configuration file.
|
|
.It Pa portable.ini
|
|
If this file exists in the current directory,
|
|
.Nm
|
|
will read
|
|
.Pa config.ini
|
|
and
|
|
.Pa qt.ini
|
|
from the current directory instead of
|
|
.Pa $XDG_CONFIG_HOME/mgba .
|
|
.El
|
|
.Sh AUTHORS
|
|
.An Jeffrey Pfau Aq Mt jeffrey@endrift.com
|
|
.Sh HOMEPAGE
|
|
.Bl -bullet
|
|
.It
|
|
.Lk https://mgba.io/ "mGBA homepage"
|
|
.It
|
|
.Lk https://github.com/mgba-emu/mgba "Development repository"
|
|
.It
|
|
.Lk https://github.com/mgba-emu/mgba/issues "Bug tracker"
|
|
.It
|
|
.Lk https://forums.mgba.io/ "Message board"
|
|
.El
|