<(<(<(<(<<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<(<
     .©.      .©.      .©.      .©.      .©.    ..   ..    .©.    ..    .©.
   .$$$$$.  .$$$$$.  .$$$$$.  .$$$$$.  .$$$$$.  $$   $$  .$$$$$.  $$  .$$$$$.
   $$' Ë$$  $$' Ë$$  $$' 'Ë   $$' Ë$$  $$' Ë$$  $$   $$  $$' Ë$$  $$  $$' Ë$$
   $$  ú$$  $$  ú$$  $$ú.     $$  ú$$  $$  ú$$  $$   $$  $$   $$  $$  $$  ú$$
   $$$$$$'  $$$$$$'  ù$$$$$ú  $$$$$$'  $$$$$$'  $$   $$  $$   $$  $$  $$$$$$'
   $$$$ú    $$          ø'$$  $$       $$$$ú    $$   $$  $$   $$  $$  $$$$ú
   $$Ë$$ú   $$ú ú.   $$ú ú$$  $$ú ú.   $$Ë$$ú   $$ú ú$$  $$ú ú$$  $$  $$Ë$$ú
   $$ Ë$$ú  Ë$$$$$ø  Ë$$$$$ø  Ë$$$$$ø  $$ Ë$$ú  Ë$$$$$ø  Ë$$$$$ø  $$  $$ Ë$$ú
   ùù   øùø   øùø      øùø      øùø    ùù   øùø   øùø      øùø    øø  ùù   øùø
                         .©.      .©.    ©ª©ª.      .©.
                       .$$$$$.  .$$$$$.  $$$$$$.  .$$$$$.
                       $$' 'Ë   $$' Ë$$  $$' Ë$$  $$' 'Ë
                       $$       $$   $$  $$   $$  $$ú.
                       $$  $$$  $$   $$  $$   $$  ù$$$$$ú
                       $$   $$  $$   $$  $$   $$     ø'$$
                       $$ú ú$$  $$ú ú$$  $$ú ú$$  $$ú ú$$
                       Ë$$$$$ø  Ë$$$$$ø  $$$$$$ø  Ë$SH3$ø
                         øùø      øùø    ùùùùø      øùø
>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)>)

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


                                G O D L E N E S

                           The Nintendo NES Emulator

                               by Reservoir Gods


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


A long, long time ago (November 1997)  in  a  galaxy far, far away (Liverpool) a
young farmboy (Ed  Cleveland)  stumbled  across  a  dark  secret  hidden away in
anAmiga  CD.  It  was  a  Commodore  64  emulator  with  complete  source  code.
Laughingmanically, Ed hatched his evil plan for world domination. Using the 6502
emulator he would create a NES emulator for the Atari ST.

Ed visited the shadowy lair of Mr Pink clutching a disk full of code.
A secret pact was formed - Ed would code the 68000 version whilst the hapless Mr
Pink would handle the Falcon conversion.

ST Owners will be  pleased  to  see  Ed  Cleveland's  'Nesulator'  arriving on a
machine near them soon.

The Falcon version has a number of enhancements:

* 256 Colour Mode Used to support total NES palette emulation
* Double Buffered Hardware Scrolling for faster emulation
* Sprite Clipping
* Faster Interrupt Handling

Parts of the 6502 emulator have been  recoded to support a more efficient memory
management system. The mapper routines  have  also  been recoded to work faster.
The video chip emulator has been completely recoded.

The consequence of this is that  'Godlenes'  runs a lot faster than 'Nesulator',
but is less technically accurate in operation.

Both 'Nesulator' and 'Godlenes' will be made into generic emulators.
We still have a lot of  work  to  do  with  mapper  routines, so we are going to
release a few games just to whet your appetite for the full generic emulator.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 MAIN MENU
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Control the main menu with powerpad or cursor keys and space.

Press pad 'A' or 'Space' to select option.
Use up and down to move between options.
You can press left and right to toggle between options.

The control defaults to keyboard, but if you begin the menu by moving the Jagpad
then it will switch to Jagpad.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 OPTIONS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 * CONTROL

   The game can be controlled with either Powerpad or Keyboard.

 * GFX DETAIL

   You can change the display detail to provide either faster or more colourful
   emulation. You can also change screen mode 'on the fly' during the game.

   [ LO ]

   This uses 16 colour mode with 2 planes for the background and 2 planes for
   the sprites.

   [ MID ]

   This uses 256 colour mode with 4 planes for the background but only 2 planes
   for the sprites.

   [ HI ]

   This gives you full colour emulation with 4 planes for the background and
   4 planes for the sprites in glorious 256 colour mode.

 * WIDESCREEN

   This gives you a widescreen cinemascope mode for a more realistic NES size
   screen. This works by hardware stretching the pixels horizontally.
   Widescreen only works on RGB monitors and televisions.
   Nemesis owners beware: this switches the Videl Dot Clock into the 25mhz
   setting so get ready with your switch on the side of the Falcon!

 * CLIPPING

   Sprite clipping allows sprites to go behind objects.
   Switching this feature on means a slower but more pretty sprite routine.

 * SCREEN SPLIT

   Game ssuch Super Mario Land uses a screen split to change the screen so the
   score panel remains static and the rest of the screen scrolls.
   Godlenes can emulate this feature by using a Timer B routine.
   This has the disadvantage of making the screen slightly 'wobbly'!
   This wobbliness is accentuated by having the DSP music on.
   This feature is best used on RGB monitors only!

 * MUSIC

   The DSP tracker music can be toggled on and off with this feature.
   Having the music off may lead to slightly faster emulation and less
   screen wobbling with the screen splitting on.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 TRAINER
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

All Godlenes game features a  nifty  trainer  mode  so  even  the weakest of the
weakest can get to see the later levels of action.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 SCREENSHOTS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

At any point during the game you can save a screenshot.
Simply press F9 on your keyboard!

If you are running in 16 colour mode ( gfx detail lo ), the screen will be saved
as a .pi1 in the current directoy with the filename 'GODLENES.PI1'.

The problem with .pi1 files is that they are only 320x200 pixels in size whereas
the NES screen is 256x240 so you will lose some pixels!

If you are running in 256 colour mode then the screen will be saved as a .pi9 in
the current directory.

This will give you a full 256x240 screenshot!



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 CONTROL
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

+---------------------------------------------+
| Keyboard     : Powerpad : Action            |
+---------------------------------------------+
| Cursor Up    : Up       : None              |
| Cursor Down  : Down     : Down              |
| Cursor Left  : Left     : Left              |
| Cursor Right : Right    : Right             |
| Alternate    : Fire A   : A                 |
| Left Shit    : Fire B   : B                 |
| Control      : Fire C   : Autofire          |
| Undo         : Pause    : Start             |
| Help         : Option   : Select            |
| 1            : 1        : Gfx Detail Low    |
| 2            : 2        : Gfx Detail Mid    |
| 3            : 3        : Gfx Detail Hi     |
| 4            : 4        : Toggle Widescreen |
| 5            : 5        : Toggle Clipping   |
| S            : *        : Save              |
| L            : #        : Load              |
| F9           :          : Save Screenshot   |
| *            :          : Quit              |
+---------------------------------------------+

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 GODLENES NEWS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Ed Cleveland has dicontinued work on his Nezulator so it remains for MrPink to
carry the banner of NESness!

Mapper types now supported by GodleNES:

* Mapper 0
* Mapper 1
* Mapper 2
* Mapper 3
* Mapper 4
* Mapper 7

Other mappers will be implemented when I get my sweaty hands on games that use
them!

A number of bugs have been fixed since version 1.0 :

* Palette Handling ( writes to NES palette now properly clipped )
* PPU reading ( any writes to PPU memory now validate reads )
* Bugs in Mapper 1 & Mapper 4 ( D1 now cleared after use )
* Videl setting ( screen now in right position! )

NESCAFE the NES debugger has been updated:

* Can now dissassemble whole cartridges
* Sprite display option
* Nicer formatted sprite memory display
* Improved search -any number of bytes can be found!
* Some nasty bugs fixed!
* NOW supports GAME GENIE code entry!

I have patched about 30 NES games so they run properly with GodleNES and we will
be training them and releasing them over the next few months. Keep an eye on our
homepages!

If you are an ST chap and want to see Ed Clevelands Nezulator released then mail
us and we will forward your pleas. If he still refuses we will batter him about
the head with wet lettuce until he begs for mercy.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 GODLENES RELEASES
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

  1 > Super Mario Brothers
  2 > Invaders
  3 > Rainbow Islands
  4 > Ice Climber
  5 > Final Fantasy
  6 > Tennis
  7 > MegaMan
  8 > Dig Dug
  9 > The Adventures Of Lolo
 10 > Mario Golf
 11 > Legendary Wings
 12 > Joust
 13 > Zelda
 14 > Flipull

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 LEGAL STUFFS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

If you play this game then Bob Charlotte will come round to your house with an
axe. You have been warned.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 CREDITS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

6502 Emulator     : Christian Bauer
ST NES Emulator   : Ed Cleveland
Falcon Conversion : Mr Pink
DSP Replay        : Tat of Avena
Graphics          : sh3
Music             : MSG

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 THANKS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

For invaluable NES information:

 Benzene
 Marat Fayzullin
 Loopy
 Martin Nielson
 Fredrik Olsson
 Matthe Richey
 Fanwen Yang
 Yoshi

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 CONTACT
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

mr pink : mrpink_rg@hotmail.com
sh3     :       sh3@zetnet.co.uk
MSG     :    msg_rg@hotmail.com
TaT     :       tat@avena.com

RG Homepage  : http://www.acs.bolton.ac.uk/~msg1css/maison.htm
sh3 Homepage : http://users.zetnet.co.uk/zmoe3/three.htm

Leon O'Reilly. Cwm Isaf. Abermule. Welshpool. Powys. Wales. SY15 6JL. UK




                    Reservoir Gods. We Bring You Happy-nes!


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
