From c191db315ea01e5c4288201efb0cb0d02e1a9001 Mon Sep 17 00:00:00 2001 From: knakos Date: Mon, 29 Jan 2007 21:08:31 +0000 Subject: [PATCH] ready for 2.3.5 git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@1313 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba --- stella/README-WinCE.txt | 75 ++++++++++++++++++++++------------------- 1 file changed, 40 insertions(+), 35 deletions(-) diff --git a/stella/README-WinCE.txt b/stella/README-WinCE.txt index 2f0780aae..42a43d15b 100644 --- a/stella/README-WinCE.txt +++ b/stella/README-WinCE.txt @@ -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