FreeBSD Manual Pages
GNGB(1) General Commands Manual GNGB(1) GNGB 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 Nin- tendo 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 be- cause the original program does not have a manual page. OPTIONS The program follows the usual GNU command line syntax, with long op- tions starting with two dashes (`-'). A summary of options are in- cluded below. -h, --help print help and exit -a, --autoframeskip turn on autoframeskip. This is useful if the emulator is run- ning 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 de- grade 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 = scan- line 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 excel- lent 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 car- tridge 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 joy- stick 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). GNGB(1)
GNGB | SYNOPSIS | DESCRIPTION | OPTIONS | DEFAULT BINDINGS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gngb&sektion=1&manpath=FreeBSD+Ports+15.0>