move ce port to its new home

svn-id: r23366

1 files changed, 0 insertions, 506 deletions

diff --git a/backends/wince/README-WinCE b/backends/wince/README-WinCE
deleted file mode 100644
index b1fc585e22..0000000000
--- a/backends/wince/README-WinCE
+++ /dev/null
@@ -1,506 +0,0 @@
-ScummVM Windows CE FAQ
-Last updated:    2006-06-20
-Release version: 0.9.0
-------------------------------------------------------------------------
-
-This document is intended to give common answers to specific ScummVM
-issues on Windows CE, in 3 sections
-  * "General questions"       : browse this section to get started and see
-    general issues
-  * "Game specific questions" : lists some common game specific issues
-  * "Support and links"       : how to get support if you're still puzzled
-
-------------------------------------------------------------------------
-General questions
-------------------------------------------------------------------------
-
-Which devices are supported ?
------------------------------
-
-Official build
---------------
-
-The official build is based on the ARM architecture and should work with any
-Pocket PC 2000, Pocket PC 2002, Pocket PC 2003, Pocket PC 2003 SE, Smartphone
-2002, Smartphone 2003 or Windows Mobile based device.
-
-Support for old ARM architectures (Handheld PCs, Palm Size PCs) and other CPUs 
-(MIPS, SH3) is discontinued. Feel free to generate builds for these 
-architectures and contact me to include them on ScummVM website.
-
-Full support
-------------
-
-* ARM based Windows Mobile handhelds with QVGA resolution (240x320) slower
-  than 200 MHz (PocketPC platform)
-
-All AdLib first generation games should work properly on these devices.
-Sam'n'Max will be a bit too slow to be played with music.
-More recent games (The Dig, Curse of Monkey Island, Broken Sword series)
-and all VGA games will probably be too slow to be enjoyable.
-
-* ARM based Windows Mobile handhelds with QVGA resolution (240x320) faster
-  than 200 MHz
-
-All games should work properly on these devices.
-VGA games will be resized and the font gets hard to read in this case (be sure
-to install the talkie version the game :p)
-
-* ARM based Windows Mobile handhelds with VGA resolution (640x480) 
-
-All non VGA games should work properly on these devices. They can be resized
-with different scalers (not all desktop scalers are supported due to Embedded
-Visual C++ very personal interpretation of the C++ standard).
-VGA games will be displayed in true VGA mode, which can takes a lot of memory
-and slow down the game (especially during scrollings). It will get better in
-the next releases or with faster devices.
-
-* Windows Mobile Smartphones (176x220 or 240x320)
-
-Early support is provided for all 320x200 games.
-The font can get hard to read (you should prefer talkie games, or wear glasses)
-
-* Support for Windows Mobile 5 is experimental but should work. "Flipping" devices
-such as the HTC Wizard or HTC Universal work only in portait (closed) mode for the
-moment.
-
-Partial / Discontinued support
-------------------------------
-
-Support for the following devices is not complete, not working properly or
-discontinued because the device is now obsolete. Feel free to contribute and
-improve the port for your favorite device, or use the last release built with
-the previous port architecture (0.5.1) which was less resource hungry and
-supported more exotic devices.
-
-* "Paletted" devices (non "true color")
-
-These devices will be supported through the GDI layer which will slow down the
-games a lot. You can try to disable the music/sound effects to get a better
-game experience.
-
-* "Mono" devices
-
-I don't even think anything will be displayed on these devices :) you can try
-and report your success ...
-
-* MIPS/SH3 devices with QVGA resolution (240x320), "true color"
-
-Some devices may be a bit too slow, especially if direct screen access (GAPI)
-is not supported on these devices.  
-
-* ARM/MIPS/SH3 devices with VGA resolution (640x480) (Palm Size PC / Handheld 
-  PC platform)
-
-True VGA games will probably be too slow to run properly on these devices even
-if they can support them ...
-
-* ARM/MIPS/SH3 devices with desktop resolution (800x600) (Handheld PC platform)
-
-No, there will never be ANY scaler supporting 800x600 resolution, because
-320x200 games CANNOT be resized to a 800x600 by a simple operation.
-
-And the device will probably be too slow to perform any kind of graphic
-transform anyway :)
-
-How do I install ScummVM for Windows CE ?
------------------------------------------
-
-If the current release includes a .EXE installer, ScummVM for Windows CE
-will be installed without hassle.
-Otherwise, you'll unzip the release on your desktop computer, and copy 
-all files on your device.
-
-If you're using a Pocket PC 2000 operating system, be sure to have GAPI
-installed - it's available on Microsoft website http://www.microsoft.com
-
-How do I install a game ?
--------------------------
-
-You'll at least need to copy all the data files from your game, in a 
-sub-directory of your game directory. 
-
-You'll need to put the data files in a directory named after ScummVM game
-name (see "Supported Game" section in ScummVM readme) for the games having
-"generic" data files (.LFL files). Recent games can be put in any directory.
-
-You can compress the multimedia files (sound/video) as described in the
-ScummVM readme.
-
-You can compress the audio tracks of Loom or Monkey Island 1 as described in
-the ScummVM readme. If you are running these games on a slow device with Ogg
-Vorbis compression, it's recommended to sample the files to 11 kHz (this sample
-rate is not supported by other versions of ScummVM).
-
-If you need more details, you can check SirDave's mini-manual online available 
-at: http://forums.scummvm.org/viewtopic.php?t=936
-and at: http://www.pocketmatrix.com/forums/viewtopic.php?t=8606
-
-How do I run a game ?
----------------------
-
-If it's the first time you're running ScummVM for Windows CE, have installed or
-removed games, you need to rescan your game directory. 
- * Select Scan, tap the root directory of your games, and tap "Yes" to begin
-   an automatic scan of the installed games. 
-
-Usually all games are detected and you can start playing right away. If your 
-game is not detected check its directory name and your data files.
-
-To play a game, tap on its name then tap the "Play" button or double tap its 
-name.
-
-How do I play a game on a Pocket PC or Handheld PC device ?
------------------------------------------------------------
-
-The stylus is your mouse cursor, and a tap is a left mouse button click.
-
-As the Pocket PC lacks some keys, a toolbar is displayed at the bottom of the
-screen to make the most common functions just a tap away
-  * The disk icon opens ScummVM options menu to save your game, or change your
-    current game settings.
-  * The movie icon skips a non interactive sequence, the current dialog or 
-    behaves like the ESC key on a regular keyboard
-  * The sound icon turns all sound effects and music off and on
-  * The key icon allow you to map a key action to a device button.
-  * The monkey icon switches between portrait, landscape and inverse landscape
-    mode.
-
-You can map additional actions on your device hardware buttons using the 
-"Options" / "Key" menu in the ScummVM options menu. To associate an action to
-a key, tap the action, then the "Map" button and press the hardware key.
-The following actions are available 
-  * Pause       : pause the game
-  * Save        : open ScummVM option menu
-  * Quit        : quit ScummVM (without saving, be careful when using it)
-  * Skip        : skip a non interactive sequence, the current dialog or 
-    behaves like the ESC key on a regular keyboard
-  * Hide        : hide or display the toolbar
-    - YOU MUST HIDE THE TOOLBAR TO SCROLL THROUGH THE INVENTORY IN ZAK -
-  * Keyboard    : hide or display the virtual keyboard
-    - YOU MUST DISPLAY THE KEYBOARD TO FIGHT IN INDIANA JONES 3 -
-  * Sound       : turns all sound effects and music off and on
-  * Right click : acts as a right mouse button click
-    - YOU MUST MAP THIS ACTION TO PLAY THE FOLLOWING GAMES -
-    - SAM & MAX, BENEATH A STEEL SKY, CURSE OF MONKEY ISLAND -
-  * Cursor      : hide or display the mouse cursor
-  * Free look   : go in or out of free-look mode. In this mode, you can tap 
-    the screen to look for interesting locations without walking.
-  * Zoom up     : magnify the upper part of the screen for 640x480 games 
-    rendered on a 320x240 device.
-  * Zoom down   : magnify the lower part of the screen for 640x480 games
-    rendered on a 320x240 device.
-  * FT Cheat    : win a Full Throttle action sequence
-  * Bind keys   : map a key action to a device button
-  * Up,Down,Left:
-    Right,      : emulate mouse/stylus behavior
-    Left Click  :
-
-If you start a game when a Right click mapping is necessary, ScummVM will ask
-you to map one of your hardware key to this action before playing. Just press
-the key you want to map if you see this message.
-
-How do I hide the toolbar ?
-----------------------------
-
-A shortcut is available to hide the toolbar directly from the game screen from
-release 0.8.0. Double tapping the stylus at the top of the screen will switch
-between a visible toolbar panel, a virtual keyboard, and an invisible panel.
-If any part of the screen is obscured by the toolbar (like the load/save game
-dialogs) you can use the invisible panel mode to get to it. For 320x200 games 
-on QVGA Pocket PCs, when the panel is hidden the game screen is resized to 
-320x240 for better gaming experience.
-
-How do I play a game on a Microsoft Smartphone device ?
--------------------------------------------------------
-
-When playing on a Smartphone, the cursor and mouse buttons are emulated by
-a set of default keys :
-      4              Move up
-      6              Move down
-      8		     Move left
-      2 	     Move right
-      Hotkey 1       Left mouse button click
-      Hotkey 2       Right mouse button click
-      Return/Action  Open the key mapping menu
-
-Note that this means that the input will be "inversed" on a 240x320 (Windows
-Mobile 2005) Smartphone. You'll have to remap the keys.
-
-A few options are also emulated by a set of default keys :
-
-      0		   Options menu
-      Back	   Skip
-      #		   Zone option
-
-The cursor will move faster if you keep the key down. You can tweak this
-behaviour in the configuration file described below.
-
-The "Zone" key is a *very* valuable addition allowing you to jump quickly 
-between three screen zones : the game zone, the verbs zone and the inventory 
-zone. When you switch to a zone the cursor will be reset to its former location
-in this zone. 
-
-There are two more actions available for mapping:
-   - Keyboard: Shows hides a virtual keyboard which can be use whenever text
-               input is required in a game, or a dialog.
-   - Rotate  : Flips the screen orientation between normal and inverse landscape.
-
-You can change the keys mapping during the game in the key mapping menu.
-
-Note that you'll need to push the Action button (center of the pad) to quit
-a Simon game.
-
-How can I apply a ScummVM command line option (f.e. to change the language) 
----------------------------------------------------------------------------
-
-See the section regarding the configuration file (scummvm.ini) in ScummVM
-README file - the same keywords apply.
-
-Some parameters are specific to this port :
-
-game specific section (f.e. [monkey2]) - performance options
-
-high_sample_rate       bool      Desktop quality (22 kHz) sound output if set. 
-				11 kHz otherwise.
-                                The default is 11 kHz. 
-				If you have a fast device, you can set this to
-                                true to enjoy better sound effects and music.
-FM_high_quality        bool     Desktop quality FM synthesis if set. Lower 
-				quality otherwise. The default is low quality.
-			        You can change this if you have a fast device.
-sound_thread_priority  int      Set the priority of the sound thread 
-                                (given to SetThreadPriority API)
-Smush_force_redraw     int      Force a Smush frame redraw every X missed
-                                frames. Mainly used for Full Throttle action
-                                sequences. Setting it lower gives more 
-                                priority to screen redraws. Setting it higher
-                                gives more priority to stylus/keyboard input.
-                                The default is 30.
-
-game specific section (f.e. [monkey2]) - game options
-
-landscape	       int      0: Portrait, 1: Landscape, 2: Inverse Landscape
-
-[scummvm] section - keys definition
-
-You usually do not wish to modify these values directly, as they are set 
-by the option dialog, and are only given here for reference.
-
-action_mapping_version int       Mapping version linked to ScummVM version.
-action_mapping         string    Hex codes describing the key associated to
-                                 each different action.
-
-[scummvm] section - mouse emulation tuning
-
-You can tweak these parameters to customize how the cursor is handled.
-
-repeatTrigger         int       Number of milliseconds a key must be held to
-                                consider being repeated.
-
-repeatX               int       Number of key repeat events before changing
-                                horizontal cursor behaviour.
-stepX1                int       Horizontal cursor offset value when the key is
-                                not repeated.
-stepX2                int       Horizontal cursor offset value when the key is
-                                repeated less than repeatX.
-stepX3                int       Horizontal cursor offset value when the key is
-                                repeated more than repeatX.
-
-
-repeatY               int       Number of key repeat events before changing
-                                vertical cursor behaviour.
-stepY1                int       Vertical cursor offset value when the key is
-                                not repeated.
-stepY2                int       Horizontal cursor offset value when the key is
-                                repeated less than repeatY.
-stepY3                int       Vertical cursor offset value when the key is
-                                repeated more than repeatY.
-
-Game xxx is too slow on my device
----------------------------------
-
-Even if it shouldn't happen (this port is running almost correctly on a 
-80 / 120 MHz first generation SPV phone), you can try some things :
-
-  * Disable sound in the engine (see the global README)
-  * Play with the priority of the sound thread (change the 
-    sound_thread_priority value - the higher the lower priority)
-
-And don't forget to report your progress in the ScummVM forum !
-
-------------------------------------------------------------------------
-Game specific questions 
-------------------------------------------------------------------------
-
---------------------------
--- Beneath a Steel Sky --
---------------------------
-
-Introduction movie is too slow or never ends ...
--------------------------------------------------
-
-Skip it :)
-
-How can I open the inventory in Beneath a Steel Sky ?
----------------------------------------------------
-
-Tap the top of the screen. Check your stylus calibration if you still cannot
-open it.
-
-How can I use an item in Beneath a Steel Sky ?
-----------------------------------------------
-
-You need to map the right click button (see the General Questions section).
-
-----------------------------
--- Curse of Monkey Island --
-----------------------------
-
-How can I open the inventory in Curse of Monkey Island ?
-------------------------------------------------------
-
-You need to map the right click button (see the General Questions section).
-
-I'm experiencing random crashes ...
-------------------------------------
-
-This game has high memory requirements, and may crash sometimes on low 
-memory devices. Continue your game with the latest automatically saved
-game and everything should be fine. 
-You can consider removing the music and voice files (VOXDISK.BUN, MUSDISK.BUN)
-to lower these requirements.
-
-Sound synchronization is lost in Curse of Monkey Island videos
---------------------------------------------------------------
-
-This is a port bug which is very noticeable in VGA mode. It can probably be
-fixed with a faster blitting routine or a faster device.
-
---------------------
--- Full Throttle --
---------------------
-
-I'm experiencing random crashes ...
-------------------------------------
-
-This game has high memory requirements, and may crash sometimes on low 
-memory devices. Continue your game with the latest automatically saved
-game and everything should be fine. 
-You can consider removing the voice file (MONSTER.SOU) and disable the 
-music to lower these requirements.
-
-----------------------------------------
--- Indiana Jones and the Last Crusade --
-----------------------------------------
-
-How can I fight in Indiana Jones and the Last Crusade ?
------------------------------------------------------
-
-You need to map the keyboard button (see the General Questions section).
-
----------------
--- Sam & Max --
----------------
-
-How can I change the current action ?
--------------------------------------
-
-You need to map the right click button (see the General Questions section).
-
-How can I exit a mini game ?
-----------------------------
-
-Use the skip toolbar icon (see the General Questions section).
-
--------------------
--- Simon 1 and 2 --
---------------------
-
-How can I save or quit in Simon ?
---------------------------------
-
-"Use" (use the use verb :p) the postcard. The ScummVM option dialog is disabled
-in Simon games.
-
-On Smartphone, you'll need to push the Action button (center of the pad) to
-quit the game.
-
--------------
--- The Dig --
--------------
-
-I'm experiencing random crashes ...
-------------------------------------
-
-This game has high memory requirements, and may crash sometimes on low 
-memory devices. Continue your game with the latest automatically saved
-game and everything should be fine. 
-You can consider removing the music and voice files (VOXDISK.BUN, MUSDISK.BUN)
-to lower these requirements.
-
---------------------
--- Zak Mc Kracken --
---------------------
-
-How can I scroll through my inventory items in Zak Mc Kracken ?
--------------------------------------------------------------
-
-You need to map the hide toolbar button (see the General Questions section) or
-double tap at the top of the screen (from 0.8.0+)
-
---------------------
--- Broken Sword 2 --
---------------------
-
-I've installed the movies pack but they are not playing
--------------------------------------------------------
-
-MPEG 2 playback takes too much memory in the current release, and may prevent
-movies from playing in VGA mode. This may get better in the next releases.
-
-----------------
--- Gobliiins --
-----------------
-
-Cursor is grabled after loading a game 
---------------------------------------
-
-Due to a bug in 0.8.0, you'll have to tap the stylus somewhere on the game
-screen between 2 letters when entering a code. Otherwise the cursor will get
-garbled.
-
-This has not been retested for 0.8.1 but should be fixed.
-
-------------------------------------------------------------------------
-Support
-------------------------------------------------------------------------
-
-Help, I've read everything and ...
------------------------------------
-
-Luckily, as there is a huge variety of Windows Mobile devices, a specific forum 
-is dedicated to this ScummVM port. You can ask your question on the WinCE
-ScummVM forum available at http://forums.scummvm.org/viewforum.php?f=6 
-
-Some older questions and very nice tutorials are still available on the historic
-PocketMatrix forum at http://www.pocketmatrix.com/forums/viewforum.php?f=20
-where  the community is always glad to help and have dealt with all my bugs for more 
-than three years now :)
-
-I think I found a bug, ScummVM crashes in ...
----------------------------------------------
-
-See the "Reporting Bugs" section in ScummVM readme. 
-
-If you have a Pocket PC or Handheld PC, be sure to include its resolution (obtained
-on the second dialog displayed on the "About" menu) in your bug report.
-
-If you cannot reproduce this bug on another ScummVM version, you can cross
-post your bug report on ScummVM forums.
-
-------------------------------------------------------------------------
-Good Luck and Happy Adventuring!
-The ScummVM team.
-http://www.scummvm.org/
-------------------------------------------------------------------------