_______                  _______
          |       |.-----.--------.|       |.-----.-----.
          |   -   ||__ --|        ||   -   ||__ --|  -__|
          |_______||_____|__|__|__||_______||_____|_____|
           _______                  __         __
          |    ___|.--------.--.--.|  |.---.-.|  |_.-----.----.
          |    ___||        |  |  ||  ||  _  ||   _|  _  |   _|
          |_______||__|__|__|_____||__||___._||____|_____|__|
       Version 0.9.2 14th public release, written by Bruno Vedder.
	 AmigaOS4 version by HunoPPC


Osmose means:
-------------

Object      Oriented       S.m.s.         Emulator.

In brief it's an Sega Master System / Game Gear emulator encapsulated into C++
classes :-)


19/05/2010:  Osmose-0.9.2, 14th public release.
--------------------------------------------------

Osmose is another Sega Master System / Gamegear emulator. The emulator is
released as open source project, under GPL license. For more information just
read the file 'license.txt'.

The emulator relies on SDL library and Zlib and Gilles Vollant unzip package and
OpenGL 3D graphic library.

Release notes for AmigaOS4 version:
-----------
-NEW: added a basic request to select ROM and Joypad (oSMoSe starts with -fs
-bilinear options)
-NEW: recompile with latest libs (as of july 10th 2010)

-First release for AmigaOS4
-Fix Big endian render OpenGL
-Fix Fullscreen mode
-Remove unused code (OsmoseConfiguration::findSDLKeySym); 
-Add possibility to change button assignement for Joystick
-Fix a bug in configuration file parsing
-Now uses a color terminal for reports
-Full speed game in fullscreen and window modes
-Effect bilinear support
-Full JoyPad support

*Due to the huge number of game gear/sms (around 1300) roms, games have not been
deeply tested.


Usage (if started from the SHELL):
------
* NOTE: osmose needs a 640x480 screenmode in your monitor *  
osmose rom_name.zip

osmose rom_name.zip -fs -bilinear (cool to play with this two options)


Options:
--------

Osmose > 0-8-0 implements embedded database, with game that needs specific
options to turn them on automatically. User don't need to use -cm, -km -pal or
-jap options. But i don't own all roms, that why these option are still usable
from command line.

    -paddle           Emulates one axis paddle (mapped on mouse).
    -joy              Use joystick as input device, instead of keyboard.
    -tracejoy         Output trace on joystick button press to help with
configuration (default off).
    -acceleration x.x Paddle acceleration (0.1 to 5 default 0.5)
    -fs               Run in fullscreen   (default: windowed).
    -bilinear         Bilinear filtering on screen (default: nearest neighbour)
    -nosound          Do not play sounds. (default: sound on).
    -dp               Use dark palette for screen emulation (default: off).
    -inifile xxx      Use xxx as configuration file (default: none).
    -fps              Display fps in title bar (default: off).
    -cm               Use codemaster games mem. mapper (default: off). 
    -km               Use korean games mem. mapper (default: off). 
    -irqhack          Enable irq hack (specific rom option. default: off).
    -pal              Emulates PAL/SECAM video timing (default: NTSC).
    -jap              Run as japanese machine (default: exp).
    -exp              Run as exported machine (already default).

Important notes:

       -You can combine -bilinear and -fs (fullscreen).
       -If your config file name contains some spaces chars, use -inifile
        like this: -inifile "Name with space.txt" (with double quotes).


Known bugs:
--------
- presence of black borders with some ROMS is not a bug but a trick made by lazy
games dev to get more fps !


To Do:
--------
- real GUI (any volunteer ?)


Notes:
--------
- tested on AOS4.1 update 2 (untested on AOS4.0 and AOS4.1) - tested on SAM Flex
800 Mhz and AmigaOneXEG4 800 Mhz (with ATI Radeon 9000PRO) - Bugreports for
AmigaOS 4x version at NOUVEL (HunoPPC) Hugues nouvel.hugues()orange.fr or in
directly at http://clubevolution4.com/HunoPortSDL/


Thanks to:
----------
My Wife and children to allow me time to develop 
Hyperion Entertainment  -  For the development of Amiga OS 4.0 and 4.1
ACube and Faranheit for my SAM EP440 / SAM FLEX
All my betatesters at http://www.clubevolution4.com/HunoPortSDL/
and the AMIGA community

--------------------------------------------------------------------
|  Contact: osmose_emulator()yahoo.fr                               |
|  Site   : http://bcz.emu-france.com                              |
--------------------------------------------------------------------