3rdparty/SDL-1.3.0-5387/README.WinCE

Project files for embedded Visual C++ 3.0, 4.0 and 
Visual Studio 2005 can be found in VisualCE.zip

SDL supports GAPI and WinDib output for Windows CE.

GAPI driver supports:

- all possible WinCE devices (Pocket PC, Smartphones, HPC)
  with different orientations of video memory and resolutions.
- 4, 8 and 16 bpp devices
- special handling of 8bpp on 8bpp devices
- VGA mode, you can even switch between VGA and GAPI in runtime
  (between 240x320 and 480x640 for example). On VGA devices you can
  use either GAPI or VGA.
- Landscape mode and automatic rotation of buttons and stylus coordinates.
  To enable landscape mode make width of video screen bigger than height.
  For example: 
    SDL_SetVideoMode(320,240,16,SDL_FULLSCREEN)
- WM2005
- SDL_ListModes

NOTE:
There are several SDL features not available in the WinCE port of SDL.

- DirectX is not yet available
- Semaphores are not available
- Joystick support is not available
- CD-ROM control is not available

In addition, there are several features that run in "degraded" mode:

Preprocessor Symbol		Effect
===================		=================================

SDL_systimer.c:
USE_GETTICKCOUNT		Less accurate values for SDL time functions
USE_SETTIMER			Use only a single marginally accurate timer

SDL_syswm.c:
DISABLE_ICON_SUPPORT		Can't set the runtime window icon

SDL_sysmouse.c:
USE_STATIC_CURSOR		Only the arrow cursor is available

SDL_sysevents.c:
NO_GETKEYBOARDSTATE		Can't get modifier state on keyboard focus

SDL_dibevents.c:
NO_GETKEYBOARDSTATE		Very limited keycode translation

SDL_dibvideo.c:
NO_GETDIBITS			Can't distinguish between 15 bpp and 16 bpp
NO_CHANGEDISPLAYSETTINGS	No fullscreen support
NO_GAMMA_SUPPORT		Gamma correction not available

1	william	401	Project files for embedded Visual C++ 3.0, 4.0 and
2			Visual Studio 2005 can be found in VisualCE.zip
3
4			SDL supports GAPI and WinDib output for Windows CE.
5
6			GAPI driver supports:
7
8			- all possible WinCE devices (Pocket PC, Smartphones, HPC)
9			with different orientations of video memory and resolutions.
10			- 4, 8 and 16 bpp devices
11			- special handling of 8bpp on 8bpp devices
12			- VGA mode, you can even switch between VGA and GAPI in runtime
13			(between 240x320 and 480x640 for example). On VGA devices you can
14			use either GAPI or VGA.
15			- Landscape mode and automatic rotation of buttons and stylus coordinates.
16			To enable landscape mode make width of video screen bigger than height.
17			For example:
18			SDL_SetVideoMode(320,240,16,SDL_FULLSCREEN)
19			- WM2005
20			- SDL_ListModes
21
22			NOTE:
23			There are several SDL features not available in the WinCE port of SDL.
24
25			- DirectX is not yet available
26			- Semaphores are not available
27			- Joystick support is not available
28			- CD-ROM control is not available
29
30			In addition, there are several features that run in "degraded" mode:
31
32			Preprocessor Symbol Effect
33			=================== =================================
34
35			SDL_systimer.c:
36			USE_GETTICKCOUNT Less accurate values for SDL time functions
37			USE_SETTIMER Use only a single marginally accurate timer
38
39			SDL_syswm.c:
40			DISABLE_ICON_SUPPORT Can't set the runtime window icon
41
42			SDL_sysmouse.c:
43			USE_STATIC_CURSOR Only the arrow cursor is available
44
45			SDL_sysevents.c:
46			NO_GETKEYBOARDSTATE Can't get modifier state on keyboard focus
47
48			SDL_dibevents.c:
49			NO_GETKEYBOARDSTATE Very limited keycode translation
50
51			SDL_dibvideo.c:
52			NO_GETDIBITS Can't distinguish between 15 bpp and 16 bpp
53			NO_CHANGEDISPLAYSETTINGS No fullscreen support
54			NO_GAMMA_SUPPORT Gamma correction not available
55