*********************************************
	jEnesisDS 0.4 Preview release
		2007/07/07
*********************************************


-------------------
1. About jEnesisDS |
-------------------

"jEnesisDS" is a Sega MegaDrive/Genesis Emulator for the Nintendo DS.
It started as a port of my Java Genesis/32X emulator jEnesis. By now, the code has been 
completely rewritten and many parts (CPU core, parts of GPU) are written in ARM assembler.

It didnt quite want to release it yet, but decided to do so entering it in the GBAX competition.
There is no sound emulation yet, just some code to fake the Z80 and make more games boot. 
Unfortunately this can affect some games, that use the Z80 for timing, but should be O.K for most
games.

Compatibility is already quite good, but not anywhere near the Java version, due to the missing
Z80 emulation and some "shortcuts" taken to speed up the emulation.

jEnesisDS has a quite accurate software renderer, which i decided to disable for this release, 
because it is a compile time option atm and cannot be choosen in the settings yet.
The hardware renderer is not complete and shows certain glitches with some games, but is already
quite usable with most games. If a game is missing sprites (Eliminate DOwn) try disabling
H-INT emulation.

You have to play a bit with the settings to make some games boot or work better.
Some games work faster with "Idle Loop Detection", others without (Castlevania, Gunstar Heroes),
and some games just boot if it is disabled.
The same goes for H-INT emulation. If a game doesnt boot just try changing those options.

Very few games will just boot, if checksum autofixing is disabled (Dynamite Heady, Thunder Force IV).

Currently i see no way to include scaling into the HW renderer, so you have to live 
with parts of the screen being cut off or use the SW renderer (once it is enabled in a future release).


Changelog:


********
v0.4   * Initial Preview Release
********
  - Custom ARM asm Motorola68000 CPU core
  - Hardware and Software renderer (this release defaults to the HW renderer and the SW
    renderer can not yet been choosen through the settings.
  - VDP emulation with all DMA modes
  - Horizontal & Vertical Interrupts
  - Support for PAL/NTSC and all country codes (all games will run at 60Hz though)
  - .smd, .bin & .gen support
  - partial SRAM save/load support (doesnt work for all games yet)
  - Line based renderer
  - Scroll Layers A+B & Window rendering with priorities (horizontal Windows arenot emulated in the
    HW renderer yet)



--------------
2. How to use |
--------------

If you downloaded this, you probably know how to use an emulator. It
should be self-explanatory ;)

jEnesisDS uses DLDI for accessing your cards filesystem, so you have to patch the file
with the appropriate DLDI patch found here:
http://chishm.drunkencoders.com/DLDI/

There is no way to edit the key settings yet, so here is the layout:

PAD1:
A=	 [Y]
B=	 [B]
C=	 [A]
X=	 [X]
Y=	 [L]
Z=       [R]
START=	 [START]
L,R,D,U= directional keys

[SELECT]: Enter File Browser (Also accessible by the cartridge icon)

Touch the Joypad icon to enter Setting ingame.



----------------
3. Thanks go to |
----------------

-Stphane Dallongeville (for helping and being extremely nice and patient ;) )
	http://gens.consolemul.com/
-Charles McDonald (for helping and all the great work and documentation
on the Genesis hardware).
	http://cgfm2.emuviews.com


-------------------------------
4. Licence and Acknowledgement |
-------------------------------

jEnesisDS is a released under no special kind of licence, it is completely free, the sources
are closed and it is provided as is, without any kind of guarantees or support.
Use it at your own risk.
jEnesisDS is developed by me, Stephan Dittrich and i hold the copyright to it. Dont modify it, 
dont sell it, dont do anything illegal with it, or distribute it without this document.
If you want to host jEnesisDS on your website, do so, if you provide the original archive including
this document, as found on my website www.workingdesign.de.

jEnesisDS was entirely written by me, without using any existing sources

-----------
5. Contact |
-----------

If you want to leave a comment about jEnesisDS, do it here:

dittiman@gmx.net

or visit my website: www.workingdesign.de

Anyway, hope you enjoy it...


