BUGS
author Sam Lantinga <slouken@libsdl.org>
Fri, 14 Dec 2001 12:37:34 +0000
changeset 250 74a8f672f2f8
parent 172 37e3ca9254c7
child 279 04351f59b051
permissions -rw-r--r--
Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
     1 
     2 All:
     3 	Audio rate conversion is only implemented by multiplying or dividing
     4 	by a power of two.  This is a side-effect of the requirement that the
     5 	raw audio buffer size be a power of two, and can hopefully be fixed.
     6 	This means 8 KHz audio converted to 22 KHz ends up being 16 KHz. :-/
     7 
     8 	When the implementation is writing directly to video memory the mouse
     9 	cursor doesn't work properly.  Applications which do this should use
    10 	their own mouse cursor and call SDL_ShowCursor(0) to hide the system
    11 	cursor.
    12 
    13 Linux:
    14 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
    15 	It requires handling of keyboard mapping events and using the XIM
    16 	input translation extension.  I will implement it as requested.
    17 	Latin-1 keyboard input works fine.
    18 
    19 	The keyboard modifiers are not set to the correct state on startup.
    20 
    21 	The AAlib, GGI, and SVGAlib video drivers are not heavily tested.
    22 
    23 Win32:
    24 	The MCI driver can't tell if the CD-ROM drive is paused or stopped.
    25 
    26 	The SDL_INIT_EVENTTHREAD flag is not supported on Win32
    27 	(Idea: create a separate DirectInput polling thread)
    28 	The main purpose of this flag is for smooth cursor motion in
    29 	fullscreen environments.
    30 
    31 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
    32 	This requires the ToUnicode() API which is only implemented on
    33 	Windows NT/2000, not on Windows 95/98.
    34 	Latin-1 keyboard input works fine.
    35 
    36 	Joysticks are only supported under the Win32 MultiMedia API,
    37 	DirectInput support is not yet implemented.
    38 
    39 BeOS:
    40 	BePPC is not supported, apparently not even by Be Inc.
    41 
    42 	SDL_WM_GrabInput() is not implemented.
    43 	Does anyone know how to do this?  SDL_WM_GrabInput() is designed
    44 	to prevent the user from switching input and mouse focus away from
    45 	the SDL application.
    46 
    47 	Continuous relative mouse motion is not implemented.
    48 
    49 	Wide UNICODE character input (Kanji, etc.) has not been tested.
    50 	Latin-1 keyboard input works fine.
    51 
    52 MacOS:
    53 	Palette handling isn't implemented in windowed mode yet.
    54 
    55 	Audio hasn't been extensively tested, in particular the locking
    56 	isn't implemented and mixer routines may not call malloc() or free()
    57 	because they are called at interrupt time.
    58 
    59 	SDL_WM_GrabInput() is not implemented.
    60 	Does anyone know how to do this?  SDL_WM_GrabInput() is designed
    61 	to prevent the user from switching input and mouse focus away from
    62 	the SDL application.
    63 
    64 	Continuous relative mouse motion is not implemented.
    65 
    66 	SDL_AddTimer() and SDL_RemoveTimer() haven't been implemented yet.
    67 
    68 	Not all of the keys are properly recognized on the keyboard.
    69 
    70 MacOS X:
    71 	CD-ROM functions are not implemented yet.
    72 
    73 	Joystick code is not extensively tested yet.
    74 
    75 	Window may not close when unsetting video mode and resetting.
    76 
    77 	Resizeable windows aren't implemented yet.
    78 
    79 	Depth switching for windowed mode isn't implemented yet.
    80 	
    81 	Palette handling isn't implemented in windowed mode yet.
    82 	
    83 	Command-line arguments Dialog is not implemented yet.
    84 
    85 	Fullscreen drawing has some artifacts.
    86 	
    87 	Fullscreen window covers *all* other windows - even force quit.
    88 	
    89 	Fullscreen OpenGL for the software renderer is broken.
    90 
    91 	Some OpenGL parameters are not accounted for, for example color bits customization.
    92 	
    93 	Getting OpenGL context parameters is not implemented.
    94 	
    95 	Continuous mouse motion perhaps is not as smooth as it should be.
    96 
    97 	SDL_WM_GrabInput() is implemented, but it "freezes" the hardware
    98 	cursor in the center of the window/screen.  Also, mouse moved events
    99 	are not generated, and the keyboard cannot be grabbed.
   100 
   101 	MacOS X seems to have a broken pthread_cancel() implementation.
   102 
   103 FreeBSD:
   104 	pthread_cancel() isn't supported by FreeBSD 3.X, so threads don't
   105 	work on versions of FreeBSD earlier than 4.0.
   106 
   107 	The CD-ROM handling doesn't work completely.
   108 
   109 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   110 	It requires handling of keyboard mapping events and using the XIM
   111 	input translation extension.  I will implement it as requested.
   112 	Latin-1 keyboard input works fine.
   113 
   114 	The keyboard modifiers are not set to the correct state on startup.
   115 
   116 Solaris:
   117 	The joystick functions are not implemented yet.
   118 
   119 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   120 	It requires handling of keyboard mapping events and using the XIM
   121 	input translation extension.  I will implement it as requested.
   122 	Latin-1 keyboard input works fine.
   123 
   124 	The keyboard modifiers are not set to the correct state on startup.
   125 
   126 IRIX:
   127 	The CD-ROM handling doesn't work completely.
   128 
   129 	The joystick functions are not implemented yet.
   130 
   131 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   132 	It requires handling of keyboard mapping events and using the XIM
   133 	input translation extension.  I will implement it as requested.
   134 	Latin-1 keyboard input works fine.
   135 
   136 	The keyboard modifiers are not set to the correct state on startup.
   137 
   138 EPOC:
   139     Only Crystal version of Epoc/SymbianOS is currently supported.
   140 
   141     SDL is implemented in static library only. SDL uses static/global
   142     variables and that is not allowed in EPOC dll libraries.
   143 
   144     Sound is not yet supported.
   145 
   146     Joystick, OpenGL and cdrom is not supported (think about cdrom in a cell phone:-).
   147     
   148     No console output screen. Printing to stdout do not have any effect.
   149 
   150 OpenBSD:  -= NOT YET SUPPORTED =-
   151 	This is reported to work, but I haven't verified this.
   152 
   153 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   154 	It requires handling of keyboard mapping events and using the XIM
   155 	input translation extension.  I will implement it as requested.
   156 	Latin-1 keyboard input works fine.
   157 
   158 	The keyboard modifiers are not set to the correct state on startup.
   159 
   160 OSF/Tru64:  -= NOT YET SUPPORTED =-
   161 	The audio functions are not implemented yet.
   162 
   163 	Joysticks and CD-ROM functions are not implemented yet.
   164 
   165 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   166 	It requires handling of keyboard mapping events and using the XIM
   167 	input translation extension.  I will implement it as requested.
   168 	Latin-1 keyboard input works fine.
   169 
   170 	The keyboard modifiers are not set to the correct state on startup.
   171 
   172 AIX:  -= NOT YET SUPPORTED =-
   173 	This port has only been tested with AIX 4.3.3
   174 
   175 	The OpenGL support doesn't work yet.
   176 
   177 	The joystick subsystem isn't implemented yet.
   178 
   179 	Endian detection doesn't work yet - needs a unique CPP symbol.
   180 
   181 	Wide UNICODE character input (Kanji, etc.) is not yet supported.
   182 	It requires handling of keyboard mapping events and using the XIM
   183 	input translation extension.  I will implement it as requested.
   184 	Latin-1 keyboard input works fine.
   185 
   186 	The keyboard modifiers are not set to the correct state on startup.
   187 
   188 	The AIX port was done by Carsten.Griwodz@KOM.tu-darmstadt.de
   189 	More information on this port is available at:
   190 	http://www.kom.e-technik.tu-darmstadt.de/~griff/SDL/
   191 
   192 QNX:  -= NOT YET SUPPORTED =-
   193 	Configuration doesn't work right, Makefiles still need to be
   194 	tweaked (need to add libraries to any apps that use sdl_config
   195 	to figure out what libs they need).
   196  
   197 	Only static libraries are being made, no shared ones.
   198  
   199 	The only hardware surface is the primary view surface.
   200  
   201 	Mouse events don't seem to be working right.
   202  
   203 	Fullscreen doesn't display correctly.
   204  
   205 	The software surfaces could use some speed up.
   206  
   207 	It doesn't look like the OpenGL stuff is there. (did a grep for
   208 	PdCreateOpenGLContext, nothing found).
   209  
   210 	The mouse cursor doesn't look right.
   211 
   212 AmigaOS:  -= NOT YET SUPPORTED =-
   213 	The OpenGL support isn't implemented yet.
   214 
   215 	SDL_WM_GrabInput() is not implemented.
   216 	Does anyone know how to do this?  SDL_WM_GrabInput() is designed
   217 	to prevent the user from switching input and mouse focus away from
   218 	the SDL application.
   219 
   220 	Continuous relative mouse motion is not implemented.
   221 
   222 	The AmigaOS port was done by Gabriele.Greco@galactica.it
   223