tuxnes-dc v0.2
--------------

tuxnes-dc is a port of TuxNES (tuxnes.sourceforge.net) to the Sega Dreamcast.
This version is based off v0.75 CVS as of 2001-07-18.

Features
--------

- Standard line-based renderer, locked to 30 fps (frameskip = 1).
- Experimental accelerated tile renderer.  Some games work great, some
  games don't.  If you see garbage on the screen, try pressing B to
  clear it up.  Generally runs at 60 fps.
- Sound.  Good, but subject to occasional artifacts.
- Save games.  Only to PC using dctool; VMU saving is not
  implemented yet.
- 6502 interpreted core written in C.
- Basic game select screen.

Installation from binary distribution
-------------------------------------

1 Untar the source file (creates directory tuxnes-dc-0.2-bin/).
2 Create a directory ng/ under tuxnes-dc-0.2-bin/cd/ and dump your ROMs in it.
3 Burn tuxnes-dc-0.2-bin/cd/ to CD the standard way (cdrecord, mkisofs).  
  I recommend specifying the -r option (Rock Ridge extensions) to mkisofs 
  to preserve ROM filename case.

Most DC sites have tutorials on how to burn CDs, or will provide
ready-to-burn images.

Installation from source (tested with KOS 1.1.6 CVS and gcc-3.0.3)
------------------------------------------------------------------

1 Untar the source file.
2 Set up your usual KOS environment.  I've provided the file that 
  I source, environ-dc.sh.
3 Tweak Makefiles if desired *
4 "make" (or "make bin" for scrambled 1ST_READ.BIN)

* Typical tweakable variables in the Makefiles:
  ROMDIR   - your rom directory 
  SAVDIR   - your save directory ("/pc" filesystem requires dcload)
  SCRAMBLE - path to scramble, if you want to create 1ST_READ.BIN
  BIN2C    - (in dc-aica/) path to bin2c, should be included with KOS

You can upload the resulting .elf file, tuxnes-dc, with dcload or
burn 1ST_READ.BIN to CD.

Operation
---------

- At the game select screen:
  A selects game
  B+START quits
  Y selects renderer:
     "dc"       ->  "classic" line renderer
	 "dc-tile"  ->  accelerated tile renderer
- During emulation:
  DC         Nintendo
  A       -> A
  X       -> B
  Y       -> SELECT
  START   -> START
  B+START -> return to game select
  B       -> attempt to fix screen garbage when using "dc-tile" renderer
- Save ram is automatically written out to filename.sav when you 
  return to the game select menu with B+START.


Author
------
Jim Ursetto
jim@3e8.org (http://3e8.org)