ShuriZma
/
stella
mirror of https://github.com/stella-emu/stella.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

ready for 2.3.5 

git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@1313 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba
This commit is contained in:
knakos 2007-01-29 21:08:31 +00:00
parent b1a5ea2495
commit c191db315e
1 changed files with 40 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
stella/README-WinCE.txt
View File

@ -1,54 +1,59 @@
PocketStella
(Last updated: 20 Apr 06)
v.2.2: native VGA support, better backlight handling
-=-=-=-=-=-=-=-=-=-=-=-=-=-= PocketStella -=-=-=-=-=-=-=-=-=-=-=-=-=-=
... is the official Windows CE port of the Stella emulator. It is coded
and maintained by Kostas Nakos (knakos@gmail.com). Currently, supported
and maintained by Kostas Nakos (knakos.AT.gmail.com). Currently, supported
devices are all Smartphones (176x220 & QVGA), and Pocket PCs (QVGA & VGA).
This port makes use of the excellent STLport cross platform C++ template library.
Here are some news for you:
(This file last updated: 29 Jan 07)
v.2.3.5 : support for QGVA landscape smartphones,
greatly improved UI rendering for low res smartphones,
keyboard events can be now arbitrarily remapped,
UI menus accessibility in smartphones
v.2.2 : native VGA support, better backlight handling
Installing and Running:
First create a directory for PocketStella, and copy the executable in it.
Also create a subdirectory called "Roms" (without the quotes, of course).
You should place your rom files there. On first run, this is where
PocketStella will look for roms. On Pocket PCs you can set an alternate
path using the dialogs. On Smartphones, you can edit the "romdir" variable
in stella.ini. You can run Stella now.
A Heads up ; PocketStella scans the rom files the first time it's run.
Depending on the number of rom files, this may take from a few seconds
to half an hour. Be patient. You can transfer the stella.cache file
from your PC to your device to save you this intial delay. Also,
for Smartphone users, there is no way to request a rescan of the rom
directory (when for example you add more roms in the directory).
Delete the stella.cache file and run the emulator to perform
a rescan action.
PocketStella will look for roms. You can set an alternate path using the
dialogs.
Warning for users of previous versions:
There have been two significant changes in PocketStella. First, you no
There have been three significant changes in PocketStella. First, you no
longer need the zlibce.dll inside the emulator directory. The library
is statically linked in the executable and can be safely deleted.
Second, the stella.pro is also no longer needed as its functionality
has been included in the emulator core. Please delete this file as well
as it leads to increased load times.
as it leads to increased load times. The stella.cache is also no longer
needed. You can delete this as well.
Third, it is best to delete your already existing stella.ini file when
upgrading to this version.
Controls:
A. Smartphones
You get limited functionality in Smartphones due to lack of proper
input devices. But this doesn't mean you can't enjoy your favorite games
(quite the contrary if I may say so :)
You can remap the action each button performs by using the UI menus.
The default keymap is:
DPad Up, Down, Left, Right : Launcher -> Up, Down, Page Up, Page Down
Emulation -> Joystick 0 or Paddle 0 emulation
Dpad Start (or Enter) : Launcher -> Load rom
Emulation -> Reset
Softkey A : Emulation -> Fire Joystick/Paddle 0
Softkey B : Emulation -> Select
Softkey C (usually *) : Launcher -> Quit PocketStella
Emulation -> Back to Launcher
A. Smartphones
DPad Up, Down, Left, Right : Menus -> Up, Down, Page Up, Page Down $
Emulation -> Joystick 0 or Paddle 0 emulation $
Dpad Start (or Enter) : Emulation -> Reset
Softkey A : Menus -> Select (mouse click)
Emulation -> Fire Joystick/Paddle 0
Softkey B : Menus -> Focus next item (tab) #
Emulation -> In game menu #
Softkey C (usually *) : Emulation -> Select
Backspace (arrow key) : Menus -> Cancel
Emulation -> Back to launcher
Call/Talk/Green button : Emulation -> Rotate display
($): These buttons follow screen orientation.
(#): This key cannot be reassigned.
B. Pocket PCs
Pocket PC users get the same actions as Smartphone users attributed to
their keys, except the Call key. You can use the stylus to fully access
@ -61,7 +66,7 @@ Tap bottom right : Emulation -> Rotate display
Build instructions:
The build environment is evc3 for maximum compatibility, but the emulator
The build environment of evc3 has maximum compatibility, but the emulator
can certainly be built using evc4 of higher. The following instructions
pertain to evc3. wince2002 does not include support for C++ STL, so I use
STLport. Get the latest release (I used the CVS version which has wince
@ -76,14 +81,14 @@ the default searched include directories. To do this use the dialog box:
Tools->Options->Directories->Include files. The stlport include dir should
be listed here before all other paths. To be able to emulate in the x86
emulator you also need the GAPI emulation.
Things are much easier in Visual Studio 2005. No external C++ STL library
is needed.
NOTE: PocketStella has also been built with success under Visual Studio 2005.
Have fun :-)
Links:
Stella project homepage: http://stella.sourceforge.net
contact the author : knakos@gmail.com
zlib for Windows CE : http://www.tenik.co.jp/~adachi/wince/
contact the author : knakos.AT.gmail.com
STLport library home : http://www.stlport.org/
PocketStella home : N/A yet
Microsoft eMbedded Visual Tools 3.0 : http://msdn.microsoft.com/mobility/windowsmobile/downloads/default.aspx