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