NES 9x: The Portable Nintendo Entertainment System Emulator
=================================================================
1.0 Beta 20-FEB-2000
=================

Home page: www.nes9x.cjb.net
E-mail: nes9x@nes9x.cjb.net

Contents
========
Changes Since Last Release
Introduction
What's Emulated
What's Not
What You Will Need
Getting Started/Command Line Options
Keyboard Controls
Joystick Support
Netplay Support
Problems With ROMs
Sound Problems
Speeding up the Emulation
Credits

Changes Since Last Release
==========================

Check out changes.txt for those...

Introduction
============

NES 9x is a portable, freeware Nintendo Entertainment System (NES)
emulator. It basically allows you to play most games designed for the NES
and Famicom Nintendo game systems on your PC or Workstation; which
includes some real gems that were only ever released in Japan.

NES 9x was done to inspire everyone to follow the SNES 9x Great Emulator.
Let's make SMS9x, GG9x, Genesis9x, GameBoy9x, PCE9x, PSX9x and more...


What's Emulated
===============

- The Main 6502 CPU
- The NES Sound System
- PPU
- Memory
- Almost all Video Modes
- Mappers #0, #1, #2, #3, #7
- Controler 1
 

What's Not
==========
- A lot of mappers
- The Konami Sound Channel
- Some other sound channels
- Controler 2


What You Will Need
==================

CPU
---
Faster the better, but 386SX 33 minimum when using no sound,
Pentium 166 or higher is recomended.

Memory
------
4 Mb or more. If you have DOS emulate through Linux or MAC then 16 Mb


Screen
------
Any VGA Card should be good.

If your video card doesn't work, please e-mail us.

Disk Space
----------
150Kb for the emulator.

A lot for roms.

Software
--------
Access to NES ROM images in *.nes format otherwise you will have
nothing to run!

Some home-brewed ROM images can be downloaded from http://www.nes9x.cjb.net.
To find commerical games, you could try a web search engine and some
imagnative use of search strings, alternatively, I've heard
http://www.idontknow.com is good place to try. Please note,
it is illegal in most countries to have commercial ROM images without also
owning the actual NES ROM cartridge.

Getting Started
===============

From a shell just type:

nes9x <ROM filename>

ROM images are normally loaded from the directory ./roms. This can be
changed by specifying a pathname with the image name.

For example, to start a game called "mario" type:

nes9x mario.nes

or if your rom of the game "mario" is in other dir, type:

nes9x C:\EMUS\ROMS\mario.nes

Keyboard Controls
=================

While the emulator is running:
'Escape'                 Quit the emulator
'Pause' or 'Scroll Lock' Pause the emulator

Joy-pad 1:

D-Button:

'up'              Up direction
'down'            Down direction
'left'            Left direction
'right'           Right direction

Buttons:
'CTRL'            A button
'ALT'             B button
'Enter'           Start Button
'TAB'             Select Button

Joystick Support
================

There is no Joystick support in this version.

Netplay Support
===============

There is no netplay support in this version.

Problems With ROMs
==================

If the emulator just displays a black screen for over 10 seconds, then one
of the following could be true:

1) The ROM is not supported by NES 9x.

2) Someone has edited the Nintendo ROM information area inside the ROM image
   andSnes9x can't work out what format ROM image is in. 

3) The ROM image is corrupt. If you're loading from CD, I know it might
   sound silly, but is the CD dirty?

Sound Problems
==============

No sound coming from any NES game using NES 9x? Could be any or all of
these:

- NES 9x couldn't open the sound device when it started a permissions problem,
  the device doesn't exist or some other process already has the sound device
  open and using it.
- NES 9x don't know how to play the sound of this game. Not every game has
  sound in this version.
  
- You haven't got the volume control on your speakers turned down, have you?

Emulation speed
===============

Emulating an NES is not very compute intensive,with only one CPU,
an 4 channel digital sound processor, small palette etc.

So if you have at least an 386 cpu, you should get no problem.

Credits
-------

- Aces_High for the code revising.
- xNES team for their source code.
- FX3 of RockNES for his support.
- Flux_Gold for the support and help with the graphics
- John Nicole for the control help.
- Marat for his great M6502
- Kevin Jackson for the help and testing
- Snes9x team (especially you Gary Henderson), for inspiring us
- Bloodlust Software : NESticle Rocks!
- All the other guys who supported us among the process.
- And of course, all our beta testers.

Nintendo is a trademark.
NES, Nintendo and Nintendo Entertaiment System are a trademarks of Nintendo. 
Game Genie is a trademark of Lewis Galoob Toys, Inc.
MS-DOS and Windows 95 are trademarks of Microsoft Corp.

------------------------------------------------------------------------------
NES 9x Team
nes9x@nes9x.cjb.net


