                            SNEmul release 0.73
                          (c) 1997-98 by Archeide and v0x

  1. DISCLAIMER

  WE (Archeide and v0x) DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
  SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  FITNESS FOR A CERTAIN PURPOSE; IN NO EVENT SHALL WE BE LIABLE FOR ANY
  SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  CONNECTION WITH THE USE OF THIS SOFTWARE.  Short: use at your own risk.

  2. Introduction

  Welcome to the wonderful world of emulation. SNEmul is a Super Nintendo
  emulator. That means that this software is (in theory ;) able to run
  rom dumps of SNES softwares on your PC. As SNEmul is in a middle stage of
  development, don't expect all your roms running with it. The reason we
  make this release is to have bugs/failures/success reports. If you want
  to help, then experience it, and give us a feedback.

  Our first goal was to make a solid 65c816 cpu emulation. Sound is 
  implemented but still lacks some DSP fx like echo-fx. Tranparence effects
  are also implemented although they need some optimizations. In the future,
  perfect sound and faster emulation will be supported. We are working every
  days on SNEmul and it becomes more stable and faster weeks after weeks, so
  expect it to reach the achievement of leading emulators very soon.

  3. Installation and usage

  For the DOS version, Unzip all the files in the directory of your choise
  and just type "SNEmul romfile" to start. You'll need to start SNEmul in
  its own directory, ortherwise it will crash because of missing files.

  To install the Linux version, just un-gzip-tar the archive in your
  home directory and run it as root (SNEmul needs to have superuser
  privileges to switch graphic modes). NOTE: you don't need anymore the
  liblge.so file since it is now staticaly linked into the binary.
  With the new XFree86 version, you need to start X-Windows first.
  Also, it will only work correctly and fast with 16bits(not 15bits)
  video modes(and 640x480 resolution is *STRONGLY* recommanded). 

  4. What is implemented

  - 65816 CPU (a few bugs remain, and 6502 emulation is not supported)
  - SRAM support
  - LoROM/HiROM support
  - Line by line graphics engine
  - Graphics Modes 0,1,2,3,4,5,6,7 
  - Mode 7 effects
  - 512 horizontal resolution with Mode 5
  - 8x8, 16x16 tiles (priority per tile is implemented)
  - 32x32, 64x32, 32x64, 64x64 screen modes
  - 8x8, 16x16, 32x32, 64x64 sprites
  - Window clipping(only support for first window is implemented)
  - BG priorities
  - BACK color
  - Sprite priorities (still doesn't work perfectly)
  - Mosaic effects
  - Full DMA support
  - HDMA support(uncomplete)
  - HIRQ/VIRQ/NMI interrupts
  - PAL/NTSC detection
  - SPC700 CPU (some bugs remain)
  - Sound DSP (lakes most effects)
  Linux user READ THIS:
  The sound is very trashy and slow under Linux. The problem comes from
  the SEAL sound library. If you know how to use it under Linux, or if you
  know another Linux sound library, please tell us. 

for 16 bits mode only :
  - Palette alteration between scanlines
  - Fixed color Add/sub for BG/sprites/BACK (may not work in all case)
  - Subscren Add/sub for BG/sprites/BACK
  - Some 1/2 transparence effects are implemented
  - Window color clipping is also implemented for a few effects

  5. Misc

  We, Archeide and v0x, expect feedback from you. Send us a mail even if you
  likes/dislikes it; it shows us that people are trying our emulator, and
  we don't work only for us...

  Mail at: cassiop@mygale.org
        or archeide@yahoo.com

  Web site is: http://www.mygale.org/09/cassiop/

  We hope you would have as much fun using SNEmul as we have ourself making
  it.

  6. Keyboard

  - Cursor keys : joypad direction
  - A, Z        : LEFT & RIGHT buttons
  - S, X        : X & Y buttons
  - D, C        : A & B buttons
  - SPACE       : START button
  - TAB         : SELECT button
  - ESC         : switch Full screen / GUI
  - 1-5         : toggle BG1-4,sprites
  - 0           : toggle HDMA
  - P           : save screen shot 'SNEMUL??.PCX'
  - K + digit   : save snapshot
  - L + digit   : load snapshot

  7. Credits

  Shawn Hargreaves - Allegro 3.0 libray(much faster then 2.2)
  Carlos Hasan     - SEAL sound library(very good in DOS port
                                        but not in Linux port :(

  The Teach        - Thanks for the great help
  Trepalium        - The TrepSNES sources helped us a lot...
  Y0shi            - Thanks for all your docs...
  Pan/ANTHROX      - They made the MODE 7 demo
  ZoOp             - Thanks for LoROM/HiROM informations
  Lord ESNES       - Thanks for your mails
  all the other guys who made the docs.

  Greets and good luck for all the other authors of SNES emulators:
  ZSNES team, SNES9X team, NLKE team, SNEeSe team, TheSE team, SNEqr author, 
  etc.
