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

@@ -1,54 +1,59 @@
-PocketStella
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=  PocketStella -=-=-=-=-=-=-=-=-=-=-=-=-=-=
-
-(Last updated: 20 Apr 06)
-v.2.2: native VGA support, better backlight handling
 
 ... 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
+PocketStella will look for roms. You can set an alternate path using the 
-path using the dialogs. On Smartphones, you can edit the "romdir" variable
+dialogs.
-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. 
 
 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 can remap the action each button performs by using the UI menus.
-You get limited functionality in Smartphones due to lack of proper
+The default keymap is:
-input devices. But this doesn't mean you can't enjoy your favorite games
-(quite the contrary if I may say so :)
 
-DPad Up, Down, Left, Right : Launcher  -> Up, Down, Page Up, Page Down
+A. Smartphones
-                             Emulation -> Joystick 0 or Paddle 0 emulation
+
-Dpad Start (or Enter)      : Launcher  -> Load rom
+DPad Up, Down, Left, Right : Menus     -> Up, Down, Page Up, Page Down      $
-                             Emulation -> Reset
+                             Emulation -> Joystick 0 or Paddle 0 emulation  $
-Softkey A                  : Emulation -> Fire Joystick/Paddle 0
+Dpad Start (or Enter)      : Emulation -> Reset
-Softkey B                  : Emulation -> Select
+Softkey A                  : Menus     -> Select (mouse click)
-Softkey C (usually *)      : Launcher  -> Quit PocketStella
+                             Emulation -> Fire Joystick/Paddle 0
-                             Emulation -> Back to Launcher
+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
+contact the author     : knakos.AT.gmail.com
-zlib for Windows CE    : http://www.tenik.co.jp/~adachi/wince/
 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