NINTENDO(1)                                           NINTENDO(1)

     NAME
          gb, gba, nes, snes - emulators

     SYNOPSIS
          games/gb [ -23acdT ] [ -C ... ] romfile
          games/gba [ -23aT ] [ -b biosfile ] [ -s savetype ] romfile
          games/nes [ -23aos ] romfile
          games/snes [ -23ahmsT ] romfile

     DESCRIPTION
          Gb, gba, nes and snes are emulators for the Nintendo Game
          Boy and Game Boy Color (GB and GBC), Nintendo Game Boy
          Advance (GBA), Nintendo Entertainment System (NES), and
          Super Nintendo Entertainment System (SNES).  They execute
          the romfile given as an argument.  The z, x, a, s, return
          and shift keys correspond to B, A, Y, X, Start and Select,
          respectively.  Other keys:

          F5   Save the current state in gb.save / gba.save / nes.save
               / snes.save.

          F6   Load the current state from gb.save / gba.save /
               nes.save / snes.save.

          Esc  Pause the emulator.

          Del  Exit the emulator.

          Command line options:

          -2 -3
               Scale the screen by the given factor.

          -a   Enable audio output.

          -T   Display percentage of how fast the emulator is running
               relative to a real console.

          gb options:

          -c   Run GBC roms in GBC mode and DMG (GB) roms in GBC's DMG
               compatibility mode.

          -d   Run GB roms in DMG mode. GBC-only roms will not run in
               this mode; others will run only in black & white.

          -Cnnnnnn,nnnnnn,nnnnnn,nnnnnn
               Select a color palette. Has no effect on roms in color
               mode. The syntax is of the form -C
               ffffff,aaaaaa,555555,000000 (using HTML style rrggbb

     NINTENDO(1)                                           NINTENDO(1)

               notation).

          gba options:

          -b   Location of the GBA BIOS file (required to operate the
               emulator). Default is /sys/games/lib/gbabios.bin.

          -s   Save format used by the original game. Valid formats
               are: eeprom4, eeprom64, sram256, flash512, flash1024.
               The number corresponds to the size, in kilobits, of the
               save file. By default, the emulator attempts to auto-
               matically detect the save format, but does not always
               succeed.

          nes options:

          -o   Hide the top and bottom eight pixels (overscan area),
               like a real television would.

          -s   Save contents of battery backed SRAM (used by some
               games for savegames) as a file (gb and snes automati-
               cally detect if this is needed).

          snes options:

          -h   Override HiROM/LoROM detection: -h sets LoROM, -hh sets
               HiROM.

          -m   Enable mouse emulation using system mouse. Mouse button
               1 (left button) engages the SNES left mouse button.
               Mouse button 3 (right button) engages the SNES right
               mouse button. Holding down mouse button 2 (middle but-
               ton) disengages the SNES mouse entirely so that the
               Plan 9 cursor offset can be adjusted to align with the
               SNES cursor.

     SOURCE
          /sys/src/games/gb
          /sys/src/games/gba
          /sys/src/games/nes
          /sys/src/games/snes

     BUGS
          You bet!
          SRAM saving on the NES only functions when the -s option is
          used.
          The SNES horizontal hires mode is supported only with -2
          scaling.
          All emulators assume a North American (i.e. NTSC) system.
          PAL games (and in some cases Japanese games) are not sup-
          ported.

     NINTENDO(1)                                           NINTENDO(1)

     HISTORY
          Gb first appeared in 9front (April, 2012).
          Gba first appeared in 9front (September, 2014).
          Nes first appeared in 9front (February, 2014).
          Snes first appeared in 9front (March, 2014).