NAME
gngb - emulate various Nintendo Game Boy handheld systems
SYNOPSIS
gngb [-h] | [options] <romname>
DESCRIPTION
gngb is an emulator program that attempts to be various forms of
Nintendo Game Boy hardware. It can run the various homebrew games and
demos for the system as well as images of commercially-released games.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
OPTIONS
The program follows the usual GNU command line syntax, with long
options starting with two dashes (‘-’). A summary of options are
included below.
-h, --help
print help and exit
-a, --autoframeskip
turn on autoframeskip. This is useful if the emulator is
running too slow. It will cause the emulator to drop frames
every now and then to maintain a realtime emulation.
--sleep_idle
sleep when idle. This will cause the program to sleep when it
has idle cycles instead of busy looping. However, this can
degrade emulation performance under some circumstances.
--color_filter
turn on the color filter.
-r, --rumble
turn on the rumble simulation. This will cause the emulated
screen to shake when a rumble effect is caused by the running
program.
--filter=X
Set the filter to apply. These only work when using standard
(not YUV or GL) video output. 0 = none 1 = scanline 2 =
scanline 50% 3 = smooth 4 = pseudo cell shading
-R, --res=WxH
set the screen resolution to WxH (for YUV and GL mode only).
-Y, --yuv
turn YUV mode on. This utilizes the hardware YUV colorspace
conversion and scaling features if your video card supports it.
Most video cards with Xv support can use this feature for
excellent performance.
--yuv_type
set the type of the YUV overlay: 0 = YV12 1 = YUY2
-o, --opengl
turn OpenGL mode on. This will render the gameboy screen as an
OpenGL 3D texture, which on some cards may perform much better
than the YUV or X11 output. This requires a 3D card with GLX
support.
-f, --fullscreen
run gngb in fullscreen. Fullscreen can be toggled during use
with F9.
--fps Show frames per second counter in the upper left corner of
screen. May be toggled through the emulator’s menu.
-s, --sound
Enable sound.
--sample_rate=RATE
Set the sound output sample rate to RATE. (typically a multiple
of 11025 Hz)
--auto_gb
Automatically detect the system to emulate based on the
cartridge image that is selected. This should work in most
cases. If it fails, you can use one of the [ -C, --color_gb |
-G, --normal_gb | -S, --super_gb ] options to force emulation of
a Color, Normal, or Super Game Boy.
-j, --joy_dev=N
The default joystick is /dev/js0. By setting N here, /dev/jsN
will be used in its place.
-g, --gdma_cycle
This experimental option will halt the CPU during certain DMA
operations. Leave it off unless you are working around problems
in a certain program.
-v, --version
Show version of program.
Most options can be disabled whith --no-OPTION (Ex: --no-sound turn
sound off)
DEFAULT BINDINGS
These are the default keys in the emulator. These, along with the
joystick buttons, may be changed through a custom gngbrc(5) file.
Enter : Start
Right Shift : Select
W : B
X : A
TAB : Open menu
F9 : fullscreen on/off
F10 : show fps
F11 : reset
F12 : show keysym code
KeyPad 1-5: Change palette
Palette must be define in your gngbrc file (see sample_gngbrc)
KeyPad 6 : Toggle color filter
SEE ALSO
There is some good info in the README included in the doc directory.
The gngbrc file is documented in manual section 5.
AUTHOR
This manual page was written by RCU <nemesis@dbz.icequake.net>, for the
Debian GNU/Linux system (but may be used by others).