/nesemu

nintendo nes emulator

Primary LanguageAssembly

NESEMU - yet unnamed nintendo nes emulator for ps2/win32/osx/linux

usage:
  nesemu.exe [options] [romfile.ext]

  options:
    --mappers       - output all supported mappers and exit
    --windowed      - start in windowed mode
    --fullscreen    - start in fullscreen mode
    --loadstate     - load state after loaded 'romfile.ext'
    --config <file> - use <file> as configuration file

  note: options are supported on all platforms.  please see the
  section about 'filename translation' for information on passing
  filenames to the ps2 build of nesemu.

  note: not all options listed here are supported on ps2 platform,
  options marked with an * are not supported on ps2.

features:

  . save states
  . loading gz compressed rom images*
  . loading roms from memcard/hdd/usb
  . nice zsnes-ish gui
  . loads ines, ines 2.0, unif, nsf, and fds images
  . fast forward (not very fast on ps2)
  . extra input devices
      . nes
          . zapper (partial)
          . powerpad
          . four player support
      . famicom expansion devices
          . study keyboard
          . basic keyboard
          . arkanoid controller
  . input can be gathered from the os by the
      . keyboard
      . mouse
      . joysticks
  . fast and accurate nes emulation
  . fds emulation using custom hle bios
  . ines mappers (mappers marked with * are partially supported):
      0, 1, 2, 3, 4*, 5*, 6*, 7, 8, 9, 10, 11, 13, 15, 19, 24
      40, 41, 42, 44, 45, 49, 50, 52, 64, 65, 69, 71, 73, 79
      85, 90*, 112, 113, 119, 132, 133, 137, 164, 165, 189
      193, 197, 212, 214, 234, 242, 249, 254
  . unif mappers:
      NES-NROM-128, NES-NROM-256, NES-AxROM, NES-CxROM, NES-FxROM,
      NES-TxROM, NES-AxROM,
      KONAMI-VRC-1,
      KONAMI-VRC-2, KONAMI-VRC-2A, KONAMI-VRC-2B
      KONAMI-VRC-3
      KONAMI-VRC-4, KONAMI-VRC-4A, KONAMI-VRC-4B
      KONAMI-VRC-4C, KONAMI-VRC-4D, KONAMI-VRC-4E
      KONAMI-VRC-6, KONAMI-VRC-6A, KONAMI-VRC-6B
      KONAMI-VRC-7, KONAMI-VRC-7A, KONAMI-VRC-7B
      BMC-FK23C, BMC-Generic42in1, BMC-Super24in1SC03
      BTL-MARIO1-MALEE2
      UNL-KOF97
      UNL-SA-72007, UNL-SA-72008
      UNL-Sachen-74LS374N, UNL-Sachen-8259A, UNL-Sachen-8259B,
      UNL-Sachen-8259C, UNL-Sachen-8259D
  . not all mappers supported are listed

potholes:
  . some input devices can only be plugged into one port.
    enabling them for multiple ports will provide the same
    data to both ports.   devices that can only be plugged
    into one port are:
      zapper
      powerpad
	
credits:
  . as always, the invaluable information from nesdev.parodius.com
  . the odd quirks posted on nesdev.parodius.com/bbs
  . unif board name and information gathered from nestopia v1.40
    sources and '[362]mapper_docs.zip' by Disch
  . mapper information from everynes.htm, '[362]mapper_docs.zip'
    by Disch, mapper dll sources v1.3, nesdev message board,
    fceux 2.0.2 sources, nestopia v1.40 sources
  . matt conte for his apu emulator, which i still use
  . blargg for his awesome nes tests
  . ps2dev.org for all ps2 information
  . a ps2 tutorial by Tony Saveski for ps2 video code
  . sjeep for sjpcm ps2 sound code
  . palette generator borrowed from nintendulator
  . zsnes for the gui font and gui ideas
  
thanks:
  . TNSe for some nice ppu reference.
  . Quietust for mapper dll sources, undocumented mappers
    are documented with his code.
  . Kevin Horton for very detailed mapper information.
  . Disch for [362]mapper_docs.zip.  Now lets document the
    UNIF mappers together!
  . Brad Taylor for awesome 2A03/2C02/FDS documents.
  . All members of the nesdev forums.  Without thier questions
    I would have to ask them myself.

please send all feedback to jamesholodnak _at_ gmail.com