sys/man/1/nintendo

   1 .TH NINTENDO 1
   2 .SH NAME
   3 gb, gba, nes, snes \- emulators
   4 .SH SYNOPSIS
   5 .B games/gb
   6 [
   7 .B -23acdT
   8 ]
   9 [
  10 .B -C
  11 .I ...
  12 ]
  13 .I romfile
  14 .br
  15 .B games/gba
  16 [
  17 .B -23aT
  18 ] [
  19 .B -b
  20 .I biosfile
  21 ] [
  22 .B -s
  23 .I savetype
  24 ]
  25 .I romfile
  26 .br
  27 .B games/nes
  28 [
  29 .B -23aos
  30 ]
  31 .I romfile
  32 .br
  33 .B games/snes
  34 [
  35 .B -23ahmsT
  36 ]
  37 .I romfile
  38 .SH DESCRIPTION
  39 .I Gb,
  40 .I gba,
  41 .I nes
  42 and
  43 .I snes
  44 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).
  45 They execute the romfile given as an argument.
  46 The \fBz\fR, \fBx\fR, \fBa\fR, \fBs\fR, return and shift keys correspond to B, A, Y, X, Start and Select, respectively.
  47 Other keys:
  48 .TP
  49 F5
  50 Save the current state in \fBgb.save\fR / \fBgba.save\fR / \fBnes.save\fR / \fBsnes.save\fR.
  51 .TP
  52 F6
  53 Load the current state from \fBgb.save\fR / \fBgba.save\fR / \fBnes.save\fR / \fBsnes.save\fR.
  54 .TP
  55 Esc
  56 Pause the emulator.
  57 .TP
  58 Del
  59 Exit the emulator.
  60 .PP
  61 Command line options:
  62 .TP
  63 .B -2 -3
  64 Scale the screen by the given factor.
  65 .TP
  66 .B -a
  67 Enable audio output.
  68 .TP
  69 .B -T
  70 Display percentage of how fast the emulator is running relative to a real console.
  71 .PP
  72 .B gb
  73 options:
  74 .TP
  75 .B -c
  76 Run GBC roms in GBC mode and DMG (GB) roms in GBC's DMG compatibility mode.
  77 .TP
  78 .B -d
  79 Run GB roms in DMG mode. GBC-only roms will not run in this mode; others will run only in black & white.
  80 .TP
  81 .BI -C nnnnnn,nnnnnn,nnnnnn,nnnnnn
  82 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 notation).
  83 .PP
  84 .B gba
  85 options:
  86 .TP
  87 .B -b
  88 Location of the GBA BIOS file (required to operate the emulator). Default is \fB/sys/games/lib/gbabios.bin\fR.
  89 .TP
  90 .B -s
  91 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 automatically detect the save format, but does not always succeed.
  92 .PP
  93 .B nes
  94 options:
  95 .TP
  96 .B -o
  97 Hide the top and bottom eight pixels (overscan area), like a real television would.
  98 .TP
  99 .B -s
 100 Save contents of battery backed SRAM (used by some games for savegames) as a file (\fIgb\fR and \fIsnes\fR automatically detect if this is needed).
 101 .PP
 102 .B snes
 103 options:
 104 .TP
 105 .B -h
 106 Override HiROM/LoROM detection:
 107 .B -h
 108 sets LoROM,
 109 .B -hh
 110 sets HiROM.
 111 .TP
 112 .B -m
 113 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 button) disengages the SNES mouse entirely so that the Plan 9 cursor offset can be adjusted to align with the SNES cursor.
 114 .SH SOURCE
 115 .B /sys/src/games/gb
 116 .br
 117 .B /sys/src/games/gba
 118 .br
 119 .B /sys/src/games/nes
 120 .br
 121 .B /sys/src/games/snes
 122 .SH BUGS
 123 You bet!
 124 .br
 125 SRAM saving on the NES only functions when the
 126 .B -s
 127 option is used.
 128 .br
 129 The SNES horizontal hires mode is supported only with
 130 .B -2
 131 scaling.
 132 .br
 133 All emulators assume a North American (i.e. NTSC) system. PAL games (and in some cases Japanese games) are not supported.
 134 .SH HISTORY
 135 .I Gb
 136 first appeared in 9front (April, 2012).
 137 .br
 138 .I Gba
 139 first appeared in 9front (September, 2014).
 140 .br
 141 .I Nes
 142 first appeared in 9front (February, 2014).
 143 .br
 144 .I Snes
 145 first appeared in 9front (March, 2014).