Short:        Atari VCS 2600 emulator
Author:       Stella team, Morphos port by AmiFreak
Uploader:     lanch tiscali it (Fabrizio Bartoloni)
Type:         misc/emu
Version:      1.2
Requires:     PowerSDL.library
Architecture: ppc-morphos

Note from uploader: this is the latest version I had on my HD, if you have any
newer feel free to upgrade this archive.


This is a quick and dirty port of the Stella Atari 2600 emulator
to WarpOS and MorphOS. The only thing I did was writing the SDL
soundplayback routines.


All the real/hard work was done by the following people:

Jarmo Laakkonen  - WarpOS version of GCC 2.95.3
Sigbjørn Skjæret - MorphOS version of GCC 2.95.3
Bradford W. Mott - Creating Stella
Gabriele Greco   - Amiga port of SDL
Glenn Hisdal     - GCC WarpOS SDL linker library
The people who are maintaining Stella at http://stella.sourceforge.net.
And probably some other people.


Usage:

simply copy the stella.wos exe to any place on your harddrive.
Place the stella.pro file in the envarc:stella/ directory (if
it is not found there Stella will check the current directory).
See docs directory for more info and don't forget to read the licence
conditions.


Amiga/MorphOS specific:

Sound is enabled by default use -volume 0 to disable sound.
If the value for -volume is higher than 0 it determines the
size of the audio buffer play around with it to get the best
results (values between 30-40 work best for my bppc 603@210
/040@25) default is 34.
Use F10 or the start button on a CD³² pad to pause/unpause a
game.

history:

12-08-2002: - Now SndSDL uses SDL_LockAudio()/ SDL_UnlockAudio()
	      to protect callback function. *might* prevent freezes
	      reported by some people (well one guy actually).
07-08-2002: - Relinked the WarpOS version using AmigaSDL 1.2.4
	      thanks to Glen Hisdal for his work! Unforunately most
	      of the extra buttons on a CD³² pad can no longer be used.
22-07-2002: - Swapped joysticks, now you no longer need to swap your
	      mouse to use a joystick/pad.
	    - Some small changes in the joystick code, should work better
	      now.
	    - the extra buttons on a CD³² joypad now do some stuff.
20-07-2002: - Recompiled with more optimization options making it
	      much faster.
	    - Completely removed M6502Low CPU core, didn't work for
	      some reason.
	    - Implemented SndSDL::mute as a result pause now works,
	      press p to pause or unpause the game.
	    - -volume value now determines the audio buffer play around
	      with it to get the best results.
19-07-2002: - Great speed improvements in the SDL sound playback
	      routines. Now no longer processes 1 audio command
	      at a time and no longer uses SDL_Mutexes.
	    - Compiled a MorphOS version.
	    - Released source code changes.
17-07-2002: - First WarpOS version with my SDL sound playback
	      routines.
16-07-2002: - initial WarpOS compile with sound disabled


future:

- There is still a lot of room for improvement
  in SndSDL.cxx
- recompile using warpsdl (if and when the
  devarchive is released). Should give a nice
  speed boost.


contact:

Email: AmiFreak@chello.nl