GNGB(1) 						      General Commands Manual							   GNGB(1)

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).

																	   GNGB(1)