From 5ea4e02afc39b2ac242da7d1f9c3d8a46baaea70 Mon Sep 17 00:00:00 2001
From: stephena
A multi-platform Atari 2600 VCS emulator
Release 1.3
+ Release 1.4
User's Guide
+
-
+
-
FIXME - add feature list
+
Note that for this version of Stella, you are required to have a stella.pro file. It is no longer optional as it was for past versions.
--
The DOS version of Stella is designed to work on an IBM-PC or 100% - compatible system with the following:
- -
+
FIXME
+ ++
FIXME
+ +-
The DOS version of Stella is distributed as a ZIP archive containing the DOS - executable as well as some other files. The DOS version of Stella - works with DOS as well as Windows 9x. The DOS version will run under - Windows NT, 2000, and XP, however, the sound may not operate correctly. - You should install it as follows:
- -CD C:\
unzip strelease.zip
SET PATH=%PATH%;C:\STELLA
SET BLASTER=A220 I7 D1
For the second step you'll need a program for extracting ZIP archive files. - You can use PKUNZIP for DOS, the Info-Zip UnZip tool for DOS, or a number of - other programs available for extracting ZIP files.
- --
The Linux versions of Stella are distributed in both executable and source code form, and in compressed tar files as well as (S)RPM's. -
If you're using the executables from a compressed tar file, follow these instructions: -
tar -jxvf stella-release-linux-arch.tar.bz2
cp stella.sdl /usr/local/bin
cp stella.pro /etcor to your home directory: -
mkdir ~/.stella
cp stella.pro ~/.stella
If you're compiling the source from a compressed tar file, follow these instructions:
tar -jxvf stella-release-src.tar.bz2
tar jxvf stella-release-src.tar.bz2
make linux-sdl
make linux (or make linux-gl)
cp stella.sdl /usr/local/bin
cp stella /usr/local/bin
cp stella.pro /etcor to your home directory: @@ -444,23 +413,25 @@
If you're using the binary RPM's or source SRPM's, consult your distribution on how to proceed.
-If you have a supported joystick and driver installed, +
If you have a supported joystick and driver installed and SDL can see the device, you can play games using joysticks. For additional information about the Linux joystick driver see the following web site: Linux Input Drivers.
-Currently, sound is supported using the ALSA v0.9 API (-sound alsa), the Open Sound - System or OSS emulation under ALSA (-sound oss), or SDL (-sound sdl). Sound has been - tested and is known to work under Linux and BSDI. For additional information on - OSS or ALSA see the following web sites:
+Currently, sound is supported using SDL. As long as SDL can see your sound card, Stella + will be able to produce sound.
-4Front Technologies (OSS)
- Advanced Linux Sound Architecture (ALSA)
-
+
FIXME - add info for Mac
+ ++
FIXME - add info for Windows
-Support for the external sound server has been deprecated as of Stella 1.3. The sound - code has been integrated into the core.
-
The DOS version of Stella uses command line arguments to specify the game - you'd like to play as well as other options. To see the list of available - arguments, simply run stella without any options or filename. The options are - provided here for reference. To run Stella use a command line - of the following format:
- -stella.exe [options ...] filename.bin- -
Options
- -Argument | -Description | -
---|---|
-fps <number> |
- Attempt to display n frames per second instead of the default 60 - frames per second (if the computer isn't fast enough then it may - be unable to display the desired number of frames per second) | -
-modex |
- Indicates that the 320x240 graphics mode should be used instead of - the default 320x200 graphics mode | -
-nosound |
- Indicates that the sound blaster support should be disabled | -
-paddle <0|1|2|3|real> |
- Indicates which paddle the mouse should emulate or that real Atari - 2600 paddles are being used (defaults to paddle 0) | -
-pro <props file> |
- Use the given properties file instead of stella.pro | -
-showinfo |
- Shows some game info on exit | -
-vsync |
- Indicates that the emulation should synchronize with the video card instead - of the system timer | -
Emulator Game Shells
- -Instead of using the command line to run Stella you may find it easier to - use an emulator game shell. An emulator game shell allows you to pick games - from a menu without having to type everything at the command line. One such - game shell is Jim Pragit's "Game Menu". Other frontends can be found at the - Atari Age website under - - 2600 - Emulation.
- --
The Linux version of Stella uses command line arguments to specify the game you'd like to play as well as other options. To see the list of available arguments, simply run stella without any options or filename. To run Stella use a command line of the following format:
-stella.sdl [options ...] filename.bin+
stella [options ...] filename.bin
Options (0 indicates false, 1 indicates true, others are self-explanatory) The words 'true' and 'false' can also be used.
@@ -643,8 +545,8 @@-sound <0|alsa|oss|sdl>
-sound <0|1>
-joyleft <number>
-joyright <number>
-altpro <props file>
Emulator Game Shells
-There are at least three Stella frontends for Unix/Linux: -
KStella, which concentrates on Stella only and includes manuals, snapshots, cartridge labels, etc.
-Kemulator, which concentrates - on several different emulators (Super Nintendo, Stella, MESS, etc.)
- -- Stella Shell, which has been around the longest.
-INI File
This version of Stella has support for INI files. This file can contain your @@ -820,6 +704,22 @@
See the sample stellarc file for more information.
++
The Mac version of Stella is a native Cocoa-based application.
+FIXME - add more info
+ ++
The Windows version of Stella is either commandline based or can use a GUI. + If you wish to use the commandline version, the options are the same as for the + Linux version (described above).
+ +FIXME - add more info about GUI StellaX launcher
+ +Other Keys (cannot be remapped)
-The following keys are not present in all versions, so they are listed by - version here:
-Function | Key | -Version |
---|---|---|
Resize window to next larger size | Alt + = | -SDL |
Resize window to next smaller size | Alt + - | -SDL |
Grab mouse (keep mouse in game window) | Control + g | -SDL |
Hide cursor (hide cursor in game window) | Control + h | -SDL |
Toggle fullscreen/windowed mode | Alt + Enter | -SDL |
Toggle OpenGL filtering modes | Alt + f | -SDL |
-
The DOS version of Stella looks for a property file stella.pro in the - current working directory. If this file isn't found then the emulator will - try to guess the best settings for the game.
- --
The Linux and Unix versions of Stella looks for the property file stella.pro in your $HOME/.stella directory. If this file is not found there, @@ -1440,6 +1323,19 @@ If the file isn't found in either place, then the emulator wil try to guess the best settings for the game.
++
The Mac version of Stella looks for the property file in the $HOME directory.
+FIXME - check to see where the Mac port looks for the properties file.
+ ++
The Windows version of Stella looks for the property file in the directory + containing the application. In the future, support may be added for storing the + property file in the users profile (Windows 2000 and higher).
+
The DOS and Linux versions of Stella support real Atari 2600 paddles using - a special adaptor which connects to the PC game port. The adaptor requires the - following parts:
+Stella supports real Atari 2600 joysticks and paddles using the + Stelladaptor device. + The 1.4 release of Stella does not yet support driving controllers connected + to a Stelladaptor.
+ +Stella can use up to two Stelladaptors; any extra ones are ignored. + Stelladaptor devices will be automatically detected and configured. The + detection and configuration is as follows:
Most of these parts can be found at Radio Shack. I could not find a DB15 - connector there or the 115k resistors, however, if you're willing to sacrifice - a joystick extension cable you can do without the DB15 connector and you can - always place a 100k resistor and 15k resistor in series to make a 115k - resistor. A schematic of the adaptor is shown below:
- - - -As you build the adaptor be careful not to short the +5V and GND - connections. Although several people have built this adaptor and use it - no guarantee is given that the circuit is error free therefore - USE IT AT YOUR OWN RISK!