docs.html
author Ben Avison <bavison@riscosopen.org>
Thu, 31 Oct 2019 14:00:28 +0300
branchSDL-1.2
changeset 13219 4f88e197acad
parent 13066 192c2a5fdd21
child 13224 9ed6ca274a7e
permissions -rw-r--r--
ARM: Create configure option --enable-arm-neon to govern assembly optimizations
---
configure.in | 39 +++++++++++++++++++++++++++++++++++++++
include/SDL_config.h.in | 1 +
include/SDL_cpuinfo.h | 3 +++
src/cpuinfo/SDL_cpuinfo.c | 37 +++++++++++++++++++++++++++++++++++++
4 files changed, 80 insertions(+)
     1 <HTML>
     2 <HEAD><TITLE>SDL Stable Release</TITLE></HEAD>
     3 <BODY BGCOLOR="#FFEBCD" TEXT="#000000">
     4 
     5 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
     6 <P>
     7 This source is stable, and is fully tested on all supported platforms.<br>
     8 Please send bug reports or questions to the SDL mailing list:<br>
     9 <a href="http://www.libsdl.org/mailing-list.php"
    10         >http://www.libsdl.org/mailing-list.php</a><br>
    11 The latest stable release may be found on the
    12 	<a href="http://www.libsdl.org/">SDL website</A>.
    13 </P>
    14 
    15 <H2> <A HREF="docs/index.html">API Documentation</A> </H2>
    16 
    17 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
    18 
    19 <H2> SDL 1.2.16 Release Notes </H2>
    20 <P>
    21 SDL 1.2.16 is mostly multiple bug fixes since the previous version.
    22 Changes include:
    23 </P>
    24 <BLOCKQUOTE>
    25 <P>
    26   Audio, wav loader: security fixes for ADPCM decoding (CVE-2019-7572,
    27   CVE-2019-7573, CVE-2019-7574, CVE-2019-7575, CVE-2019-7576,
    28   CVE-2019-7577, CVE-2019-7578 -- bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4490">4490</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4491">4491</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4492">4492</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4493">4493</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4494">4494</a>,
    29   <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4495">4495</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4496">4496</a>, and <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4522">4522</a>.)
    30 </P>
    31 <P>
    32   Video, bmp loader:  security fixes for CVE-2019-7635, CVE-2019-7636,
    33   CVE-2019-7638, CVE-2019-13616 (bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4498">4498</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4499">4499</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4500">4500</a>,
    34   <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4517">4517</a> and <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4538">4538</a>.)
    35 </P>
    36 <P>
    37   Video, blit: fix handling of alpha channel in Altivec accelerated
    38   blit functions (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1424">1424</a>.)
    39 </P>
    40 <P>
    41   Video, blit: correct vec_perm() application on little-endian 64-bit
    42   PowerPC (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4791">4791</a>.  cf.: RedHat bug <a href="https://bugzilla.redhat.com/show_bug.cgi?id=1392465">1392465</a>.)
    43 </P>
    44 <P>
    45   Video, blit: use fast path for RGB 565 -&gt; 32-bit XRGB 8888
    46 </P>
    47 <P>
    48   Video, blit: fix RGBA&lt;-&gt;RGBA blit broken with the optimization from
    49   <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=11">bug 11</a> (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2976">2976</a>.)
    50 </P>
    51 <P>
    52   Video: fix integer overflow in SDL_CalculatePitch (CVE-2019-7637,
    53   bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4497">4497</a>.)
    54 </P>
    55 <P>
    56   Mouse: fix SDL_ResetMouse() using a bogus mouse button causing a
    57   negative shift (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3593">3593</a>.)
    58 </P>
    59 <P>
    60   Cdrom: fix SDL_CDResume() and SDL_CDStop() not returning failure
    61   when they should (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4108">4108</a>.)
    62 </P>
    63 <P>
    64   Unix, pthread: Fix SDL_SemWaitTimeout() returning -1 instead of
    65   SDL_MUTEX_TIMEDOUT upon timeout (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1426">1426</a>.)
    66 </P>
    67 <P>
    68   NetBSD: wscons support.
    69 </P>
    70 <P>
    71   NetBSD, audio: use AUDIO_GETBUFINFO when available.
    72 </P>
    73 <P>
    74   OpenBSD, audio: add sndio support.
    75 </P>
    76 <P>
    77   Haiku/BeOS, audio: fix error in buffer size setting (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1679">1679</a>.)
    78 </P>
    79 <P>
    80   OpenBSD: fix dynamic loading of X libs (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1434">1434</a>.)
    81 </P>
    82 <P>
    83   X11video: fix missing symbol X11_KeyToUnicode in .so file (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1390">1390</a>.
    84   not being an official SDL function, the use of X11_KeyToUnicode() is
    85   strongly discouraged.)
    86 </P>
    87 <P>
    88   X11video: fix compilation with libX11 &gt;= 1.5.99.902 (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1769">1769</a>.)
    89 </P>
    90 <P>
    91   X11video: fix for XChangeProperty() crash (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1427">1427</a>.)
    92 </P>
    93 <P>
    94   X11video: fix SDL_EnableUNICODE sometimes dropping keyboard events
    95   completely (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2325">2325</a>.)
    96 </P>
    97 <P>
    98   X11video: fix no SDL_VIDEORESIZE event being generated when the
    99   window manager sets the window size (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1859">1859</a>.)
   100 </P>
   101 <P>
   102   X11video: fix X11_SetGammaRamp not checking the return value of
   103   XStoreColors (bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1979">1979</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3770">3770</a>.)
   104 </P>
   105 <P>
   106   X11video: fix SDL_VIDEORESIZE events not received when resizing
   107   window from the corner (inverted logic in X11 ConfigureNotify, i.e.
   108   resize handling - bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1430">1430</a>.)
   109 </P>
   110 <P>
   111   X11video: unblock SDL_WM_GrabInput() GrabNotViewable case (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1155">1155</a>.)
   112 </P>
   113 <P>
   114   Mac OS X: fix crash on any input in Quartz code (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2560">2560</a>.)
   115 </P>
   116 <P>
   117   Mac OS X: fix crash in Quartz gamma ramp code.
   118 </P>
   119 <P>
   120   Mac OS X: fix build for 10.9 Mavericks or newer (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2085">2085</a>.)
   121 </P>
   122 <P>
   123   Mac OS X, Quartz: fix cursor transparency (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4076">4076</a>.)
   124 </P>
   125 <P>
   126   Mac OS X, joystick: update to support Saitek p2500 gamepad (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2025">2025</a>)
   127 </P>
   128 <P>
   129   Mac OS X, main: updates for -psn_XXX command line arg for Finder
   130   launches in new macOS versions.
   131 </P>
   132 <P>
   133   Mac OS X, main: replace deprecated CPS apis in new OSX versions
   134   (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4114">4114</a>.)
   135 </P>
   136 <P>
   137   Windows, video: fix other window positions/sizes when exiting
   138   fullscreen (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3315">3315</a>.)
   139 </P>
   140 <P>
   141   Windows, keyboard: reset deadkeys upon SDL_EnableUNICODE() or upon
   142   quit (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3332">3332</a>.)
   143 </P>
   144 <P>
   145   Windows: Visual Studio project file updates.
   146 </P>
   147 <P>
   148   OS/2: Watcom makefile updates.
   149 </P>
   150 <P>
   151   FreeBSD, joystick: compile fixes.
   152 </P>
   153 <P>
   154   BSD, joystick: increase the number of uhid devices to scan (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1561">1561</a>)
   155 </P>
   156 <P>
   157   Linux, evdev: ignore joystick axis events if they aren't in a sane
   158   range.
   159 </P>
   160 <P>
   161   Linux, joystick: fix Dualshock 3's motion sensors overwrite analog
   162   stick: protect against any axis that isn't reported by EVIOCGBIT but
   163   still sending EV_ABS events (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3193">3193</a>.)
   164 </P>
   165 <P>
   166   FreeBSD, cdrom: fix CDROM detection misbehaviour for 7.x and newer
   167   (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1529">1529</a>.)
   168 </P>
   169 <P>
   170   Solaris, audio: fix pulseaudio dynamic linking.
   171 </P>
   172 <P>
   173   Solaris, cpuinfo: fix asm syntax error causing build failures.
   174 </P>
   175 <P>
   176   Atari: multiple platform code updates.
   177 </P>
   178 <P>
   179   RISC OS: cleanups to platform code.
   180 </P>
   181 <P>
   182   RISC OS: fix thread starvation in fullscreen mode.
   183 </P>
   184 <P>
   185   RISC OS: fix returning from full-screen to 16M colour modes.
   186 </P>
   187 <P>
   188   RISC OS: fix receiving PreQuit messages.
   189 </P>
   190 <P>
   191   RISC OS: ensure the window size is consistent at different DPIs.
   192 </P>
   193 <P>
   194   RISC OS, video: add support for more pixel formats.
   195 </P>
   196 <P>
   197   RISC OS: mouse fixes. restore mouse palette when exiting while mouse
   198   is in focus. don't reset mouse focus when recreating the window.
   199 </P>
   200 <P>
   201   RISC OS: support Windows and Menu key input.
   202 </P>
   203 <P>
   204   RISC OS: implement SDL_WM_IconifyWindow()
   205 </P>
   206 <P>
   207   RISC OS: send SDL_APPACTIVE events when iconizing the window.
   208 </P>
   209 <P>
   210   Configuration: fix library detection selecting wrong lib (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2795">2795</a>.)
   211 </P>
   212 <P>
   213   Configuration: fix detecting dynamic library support on powerpc64le
   214   (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3481">3481</a>.)
   215 </P>
   216 <P>
   217   SDL error: string formatting fixes to deal with nasty corner cases
   218   (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2049">2049</a>.)
   219 </P>
   220 <P>
   221   SDL_error: handle %lu, %li and %ld in format string (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3739">3739</a>.)
   222 </P>
   223 <P>
   224   stdlib: updated SDL_qsort() code.
   225 </P>
   226 <P>
   227   stdlib: use _strtoi64() and _strtoui64() when available for windows.
   228 </P>
   229 <P>
   230   headers, close_code.h: fix unbalanced #pragma pack(pop) for watcom
   231   builds (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3781">3781</a>.)
   232 </P>
   233 <P>
   234   headers, begin_code.h, close_code.h: updates to SDLCALL and DECLSPEC
   235   macros for OS/2.
   236 </P>
   237 <P>
   238   headers, endian: add Watcom inline asm for SDL_Swap16 and SDL_Swap32
   239 </P>
   240 <P>
   241   headers, config: updates to default windows and os2 config files.
   242 </P>
   243 <P>
   244   headers, SDL_syswm.h, SDL_stdinc.h: include system headers before
   245   packing alignment changes (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4149">4149</a>.)
   246 </P>
   247 </BLOCKQUOTE>
   248 
   249 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   250 
   251 <H2> SDL 1.2.15 Release Notes </H2>
   252 <P>
   253 SDL 1.2.15 is a minor bug fix release.
   254 </P>
   255 
   256 <H3> General Notes </H3>
   257 
   258 <BLOCKQUOTE>
   259 <P>
   260 	Fixed assembly register clobbering in CPU info routines
   261 </P>
   262 <P>
   263 	Fixed memory stomp when using stretch blit on large images
   264 </P>
   265 <P>
   266 	Fixed pixel corruption with overlapping blits
   267 </P>
   268 <P>
   269 	SDL_JOYSTICK_DEVICE can be a colon separated list of joystick devices
   270 </P>
   271 <P>
   272 	Disabled MMX blitters since they don't compile on modern compilers
   273 </P>
   274 </BLOCKQUOTE>
   275 
   276 <H3> Unix Notes </H3>
   277 
   278 <BLOCKQUOTE>
   279 <P>
   280 	Fixed crash in joystick code on newer Linux kernels
   281 </P>
   282 <P>
   283 	Fixed channel swizzling for ALSA target with 6-channel output
   284 </P>
   285 <P>
   286 	Use the OpenGL GLX_EXT_swap_control extension if available
   287 </P>
   288 <P>
   289 	XRandR support is disabled by default because it causes desktop reconfiguring.  It can be enabled with the SDL_VIDEO_X11_XRANDR=1 environment variable, or by applying this patch: <a href="http://hg.libsdl.org/SDL/raw-rev/8ec3036098df">http://hg.libsdl.org/SDL/raw-rev/8ec3036098df</a>
   290 </P>
   291 </BLOCKQUOTE>
   292 
   293 <H3> Windows Notes </H3>
   294 
   295 <BLOCKQUOTE>
   296 <P>
   297 	Fixed SDL_GL_ACCELERATED_VISUAL handling
   298 </P>
   299 <P>
   300 	Fixed application state handling with ALT-Tab
   301 </P>
   302 <P>
   303 	Fixed occasional crash handling WM_ACTIVATEAPP in Direct X code
   304 </P>
   305 <P>
   306 	Fixed UTF-8 decoding of Russian characters
   307 </P>
   308 </BLOCKQUOTE>
   309 
   310 <H3> Mac OS X Notes </H3>
   311 
   312 <BLOCKQUOTE>
   313 <P>
   314 	Fixed building and running on Mac OS X 10.7 (Lion)
   315 </P>
   316 </BLOCKQUOTE>
   317 
   318 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   319 
   320 <H2> SDL 1.2.14 Release Notes </H2>
   321 <P>
   322 SDL 1.2.14 is a significant bug fix release and a recommended update.
   323 </P>
   324 
   325 <H3> General Notes </H3>
   326 
   327 <BLOCKQUOTE>
   328 <P>
   329 	Fixed flicker when resizing the SDL window
   330 </P>
   331 <P>
   332 	Fixed crash in SDL_SetGammaRamp()
   333 </P>
   334 <P>
   335 	Fixed freeze in SDL_memset() with 0 length when assembly code is disabled.
   336 </P>
   337 <P>
   338 	Added SDL_DISABLE_LOCK_KEYS environment variable to enable normal up/down events for Caps-Lock and Num-Lock keys.
   339 </P>
   340 <P>
   341 	Fixed audio quality problem when converting between 22050 Hz and 44100 Hz.
   342 </P>
   343 <P>
   344 	Fixed a threading crash when a few threads are rapidly created and complete.
   345 </P>
   346 <P>
   347 	Increased accuracy of alpha blending routines.
   348 </P>
   349 <P>
   350 	Fixed crash loading BMP files saved with the scanlines inverted.
   351 </P>
   352 <P>
   353 	Fixed mouse coordinate clamping if SDL_SetVideoMode() isn't called in response to SDL_VIDEORESIZE event.
   354 </P>
   355 <P>
   356 	Added doxygen documentation for the SDL API headers.
   357 </P>
   358 </BLOCKQUOTE>
   359 
   360 <H3> Unix Notes </H3>
   361 
   362 <BLOCKQUOTE>
   363 <P>
   364 	Fixed potential memory corruption due to assembly bug with SDL_revcpy()
   365 </P>
   366 <P>
   367 	Fixed crashes trying to detect SSE features on x86_64 architecture.
   368 </P>
   369 <P>
   370 	Fixed assembly for GCC optimized 50% alpha blending blits.
   371 </P>
   372 <P>
   373 	Added configure option --enable-screensaver, to allow enabling the screensaver by default.
   374 </P>
   375 <P>
   376 	Use XResetScreenSaver() instead of disabling screensaver entirely.
   377 </P>
   378 <P>
   379 	Removed the maximum window size limitation on X11.
   380 </P>
   381 <P>
   382 	Fixed SDL_GL_SWAP_CONTROL on X11.
   383 </P>
   384 <P>
   385 	Fixed setting the X11 window input hint.
   386 </P>
   387 <P>
   388 	Fixed distorted X11 window icon for some visuals.
   389 </P>
   390 <P>
   391 	Fixed detecting X11 libraries for dynamic loading on 64-bit Linux.
   392 </P>
   393 <P>
   394 	SDL_GL_GetAttribute(SDL_GL_SWAP_CONTROL) returns the correct value with GLX_SGI_swap_control.
   395 </P>
   396 <P>
   397 	Added SDL_VIDEO_FULLSCREEN_DISPLAY as a preferred synonym for SDL_VIDEO_FULLSCREEN_HEAD on X11.
   398 </P>
   399 <P>
   400 	The SDL_VIDEO_FULLSCREEN_DISPLAY environment variable can be set to 0 to place fullscreen SDL windows on the first Xinerama screen.
   401 </P>
   402 <P>
   403 	Added the SDL_VIDEO_FBCON_ROTATION environment variable to control output orientation on the framebuffer console.
   404 	<BR>
   405 	Valid values are:
   406 	<UL>
   407 	<LI>not set   - Not rotating, no shadow.
   408 	<LI>"NONE"    - Not rotating, but still using shadow.
   409 	<LI>"CW"      - Rotating screen clockwise.
   410 	<LI>"UD"      - Rotating screen upside down.
   411 	<LI>"CCW"     - Rotating screen counter clockwise.
   412 	</UL>
   413 </P>
   414 <P>
   415 	Fixed DirectFB detection on some Linux distributions.
   416 </P>
   417 <P>
   418 	Added code to use the PS3 SPE processors for YUV conversion on Linux.
   419 </P>
   420 <P>
   421 	Updated ALSA support to the latest stable API
   422 </P>
   423 <P>
   424 	ALSA is now preferred over OSS audio.  (SDL_AUDIODRIVER=dsp will restore the previous behavior.)
   425 </P>
   426 <P>
   427 	Improved support for PulseAudio
   428 </P>
   429 <P>
   430 	The Network Audio System support is now dynamically loaded at runtime.
   431 </P>
   432 <P>
   433 	Fixed crash with the MP-8866 Dual USB Joypad on newer Linux kernels.
   434 </P>
   435 <P>
   436 	Fixed crash in SDL_Quit() when a joystick has been unplugged.
   437 </P>
   438 </BLOCKQUOTE>
   439 
   440 <H3> Windows Notes </H3>
   441 
   442 <BLOCKQUOTE>
   443 <P>
   444 	Verified 100% compatibility with Windows 7.
   445 </P>
   446 <P>
   447 	Prevent loss of OpenGL context when setting the video mode in response to a window resize event.
   448 </P>
   449 <P>
   450 	Fixed video initialization with SDL_WINDOWID on Windows XP.
   451 </P>
   452 <P>
   453 	Improved mouse input responsiveness for first-person-shooter games.
   454 </P>
   455 <P>
   456 	IME messages are now generated for localized input.
   457 </P>
   458 <P>
   459 	SDL_RWFromFile() takes a UTF-8 filename when opening a file.
   460 </P>
   461 <P>
   462 	The SDL_STDIO_REDIRECT environment variable can be used to override whether SDL redirects stdio to stdout.txt and stderr.txt.
   463 </P>
   464 <P>
   465 	Fixed dynamic object loading on Windows CE.
   466 </P>
   467 </BLOCKQUOTE>
   468 
   469 <H3> Mac OS X Notes </H3>
   470 
   471 <BLOCKQUOTE>
   472 <P>
   473 	SDL now builds on Mac OS X 10.6 (Snow Leopard).
   474 	<BR>
   475 	Eric Wing posted a good rundown on the numerous changes here: <A HREF="http://playcontrol.net/ewing/jibberjabber/big_behind-the-scenes_chang.html">http://playcontrol.net/ewing/jibberjabber/big_behind-the-scenes_chang.html</A>
   476 </P>
   477 <P>
   478 	The X11 video driver is built by default.
   479 </P>
   480 <P>
   481 	Fixed SDL_VIDEO_WINDOW_POS environment variable for Quartz target.
   482 </P>
   483 <P>
   484 	Fixed setting the starting working directory in release builds.
   485 </P>
   486 </BLOCKQUOTE>
   487 
   488 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   489 
   490 <H2> SDL 1.2.13 Release Notes </H2>
   491 <P>
   492 SDL 1.2.13 is a minor bug fix release.
   493 </P>
   494 
   495 <H3> General Notes </H3>
   496 
   497 <BLOCKQUOTE>
   498 <P>
   499 	Fixed link error when building with Intel Compiler 10.
   500 </P>
   501 <P>
   502 	Removed stray C++ comment from public headers.
   503 </P>
   504 </BLOCKQUOTE>
   505 
   506 <H3> Unix Notes </H3>
   507 
   508 <BLOCKQUOTE>
   509 <P>
   510 	Fixed crash in SDL_SoftStretch() on secure operating systems.
   511 </P>
   512 <P>
   513 	Fixed undefined symbol on X11 implementations without UTF-8 support.
   514 </P>
   515 <P>
   516 	Worked around BadAlloc error when using XVideo on the XFree86 Intel Integrated Graphics driver.
   517 </P>
   518 <P>
   519 	Scan for all joysticks on Linux instead of stopping at one that was removed.
   520 </P>
   521 <P>
   522 	Fixed use of sdl-config arguments in sdl.m4
   523 </P>
   524 </BLOCKQUOTE>
   525 
   526 <H3> Windows Notes </H3>
   527 
   528 <BLOCKQUOTE>
   529 <P>
   530 	Fixed crash when a video driver reports higher than 32 bpp video modes.
   531 </P>
   532 <P>
   533 	Fixed restoring the desktop after setting a 24-bit OpenGL video mode.
   534 </P>
   535 <P>
   536 	Fixed window titles on Windows 95/98/ME.
   537 </P>
   538 <P>
   539 	Added SDL_BUTTON_X1 and SDL_BUTTON_X2 constants for extended mouse buttons.
   540 </P>
   541 <P>
   542 	Added support for quoted command line arguments.
   543 </P>
   544 </BLOCKQUOTE>
   545 
   546 <H3> Mac OS X Notes </H3>
   547 
   548 <BLOCKQUOTE>
   549 <P>
   550 	SDL now builds on Mac OS X 10.5 (Leopard).
   551 </P>
   552 <P>
   553 	Fixed high frequency crash involving text input.
   554 </P>
   555 <P>
   556 	Fixed beeping when the escape key is pressed and UNICODE translation is enabled.
   557 </P>
   558 <P>
   559 	Improved trackpad scrolling support.
   560 </P>
   561 <P>
   562 	Fixed joystick hat reporting for certain joysticks.
   563 </P>
   564 </BLOCKQUOTE>
   565 
   566 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   567 
   568 <H2> SDL 1.2.12 Release Notes </H2>
   569 <P>
   570 SDL 1.2.12 is a minor bug fix release.
   571 </P>
   572 
   573 <H3> General Notes </H3>
   574 
   575 <BLOCKQUOTE>
   576 <P>
   577 	Added support for the PulseAudio sound server: http://www.pulseaudio.org/
   578 </P>
   579 <P>
   580 	Added SDL_VIDEO_ALLOW_SCREENSAVER to override SDL's disabling of the screensaver on Mac OS X, Windows, and X11.
   581 </P>
   582 <P>
   583 	Fixed buffer overrun crash when resampling audio rates.
   584 </P>
   585 <P>
   586 	Fixed audio bug where converting to mono was doubling the volume.
   587 </P>
   588 <P>
   589 	Fixed off-by-one error in the C implementation of SDL_revcpy()
   590 </P>
   591 <P>
   592 	Fixed compiling with Sun Studio.
   593 </P>
   594 <P>
   595 	Support for AmigaOS has been removed from the main SDL code.
   596 </P>
   597 <P>
   598 	Support for Nokia 9210 "EPOC" driver has been removed from the main SDL code.
   599 </P>
   600 <P>
   601 	Unofficial support for the S60/SymbianOS platform has been added.
   602 </P>
   603 <P>
   604 	Unofficial support for the Nintendo DS platform has been added.
   605 </P>
   606 <P>
   607 	Reenabled MMX assembly for YUV overlay processing (GNU C Compiler only).
   608 </P>
   609 </BLOCKQUOTE>
   610 
   611 <H3> Unix Notes </H3>
   612 
   613 <BLOCKQUOTE>
   614 <P>
   615 	Fixed detection of X11 DGA mouse support.
   616 </P>
   617 <P>
   618 	Improved XIM support for asian character sets.
   619 </P>
   620 <P>
   621 	The GFX_Display has been added to the X11 window information in SDL_syswm.h.
   622 </P>
   623 <P>
   624 	Fixed PAGE_SIZE compile error in the fbcon video driver on newer Linux kernels.
   625 </P>
   626 <P>
   627 	Fixed hang or crash at startup if aRts can't access the hardware.
   628 </P>
   629 <P>
   630 	Fixed relative mouse mode when the cursor starts outside the X11 window.
   631 </P>
   632 <P>
   633 	Fixed accidental free of stack memory in X11 mouse acceleration code.
   634 </P>
   635 <P>
   636 	Closed minor memory leak in XME code.
   637 </P>
   638 <P>
   639 	Fixed TEXTRELs in the library to resolve some PIC issues.
   640 </P>
   641 </BLOCKQUOTE>
   642 
   643 <H3> Windows Notes </H3>
   644 
   645 <BLOCKQUOTE>
   646 <P>
   647 	The GDI video driver makes better use of the palette in 8-bit modes.
   648 </P>
   649 <P>
   650 	The windib driver now supports more mouse buttons with WM_XBUTTON events.
   651 </P>
   652 <P>
   653 	On Windows, SDL_SetVideoMode() will re-create the window instead of failing if the multisample settings are changed.
   654 </P>
   655 <P>
   656 	Added support for UTF-8 window titles on Windows.
   657 </P>
   658 <P>
   659 	Fixed joystick detection on Windows.
   660 </P>
   661 <P>
   662 	Improved performance with Win32 file I/O.
   663 </P>
   664 <P>
   665 	Fixed HBITMAP leak in GAPI driver.
   666 </P>
   667 </BLOCKQUOTE>
   668 
   669 <H3> Mac OS X Notes </H3>
   670 
   671 <BLOCKQUOTE>
   672 <P>
   673 	Added support for multi-axis controllers like 3Dconnxion's SpaceNavigator on Mac OS X.
   674 </P>
   675 <P>
   676 	Fixed YUV overlay crash inside Quicktime on Intel Mac OS X.
   677 </P>
   678 <P>
   679 	Fixed blitting alignment in Altivec alpha blit functions.
   680 </P>
   681 <P>
   682 	Keys F13, F14, and F15 are now usable on Apple keyboards under Mac OS X.
   683 </P>
   684 <P>
   685 	Fixed joystick calibration code on Mac OS X.
   686 </P>
   687 <P>
   688 	Fixed mouse jitter when multiple motion events are queued up in Mac OS X.
   689 </P>
   690 <P>
   691 	Fixed changing the cursor in fullscreen mode on Mac OS X.
   692 </P>
   693 </BLOCKQUOTE>
   694 
   695 <H3> Mac OS Classic Notes </H3>
   696 
   697 <BLOCKQUOTE>
   698 <P>
   699 	Added support for gamma ramps to both toolbox and DrawSprocket video drivers.
   700 </P>
   701 </BLOCKQUOTE>
   702 
   703 <H3> BeOS Notes </H3>
   704 
   705 <BLOCKQUOTE>
   706 <P>
   707 	Implemented mouse grabbing and mouse relative mode on BeOS.
   708 </P>
   709 </BLOCKQUOTE>
   710 
   711 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   712 
   713 <H2> SDL 1.2.11 Release Notes </H2>
   714 <P>
   715 SDL 1.2.11 is a minor bug fix release.
   716 </P>
   717 
   718 <H3> Unix Notes </H3>
   719 
   720 <BLOCKQUOTE>
   721 <P>
   722 	Dynamic X11 loading is only enabled with gcc 4 supporting -fvisibility=hidden.  This fixes crashes related to symbol collisions, and allows building on Solaris and IRIX.
   723 </P>
   724 <P>
   725 	Fixed building SDL with Xinerama disabled.
   726 </P>
   727 <P>
   728 	Fixed DRI OpenGL library loading, using RTLD_GLOBAL in dlopen().
   729 </P>
   730 <P>
   731 	Added pkgconfig configuration support.
   732 </P>
   733 </BLOCKQUOTE>
   734 
   735 <H3> Windows Notes </H3>
   736 
   737 <BLOCKQUOTE>
   738 <P>
   739 	Setting SDL_GL_SWAP_CONTROL now works with Windows OpenGL.
   740 </P>
   741 <P>
   742 	The Win32 window positioning code works properly for windows with menus.
   743 </P>
   744 <P>
   745 	DirectSound audio quality has been improved on certain sound cards.
   746 </P>
   747 <P>
   748 	Fixed 5.1 audio channel ordering on Windows and Mac OS X.
   749 </P>
   750 <P>
   751 	Plugged a couple of minor memory leaks in the windib video driver.
   752 </P>
   753 <P>
   754 	Fixed type collision with stdint.h when building with gcc on Win32.
   755 </P>
   756 <P>
   757 	Fixed building with the Digital Mars Compiler on Win32.
   758 </P>
   759 </BLOCKQUOTE>
   760 
   761 <H3> Mac OS X Notes </H3>
   762 
   763 <BLOCKQUOTE>
   764 <P>
   765 	The Quartz video driver supports 32x32 cursors on Mac OS X 10.3 and above.
   766 </P>
   767 </BLOCKQUOTE>
   768 
   769 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   770 
   771 <H2> SDL 1.2.10 Release Notes </H2>
   772 <P>
   773 SDL 1.2.10 is a major release, featuring a revamp of the build system and many API improvements and bug fixes.
   774 </P>
   775 <H3> API enhancements </H3>
   776 <UL>
   777 <LI>
   778 	If SDL_OpenAudio() is passed zero for the desired format
   779 	fields, the following environment variables will be used
   780 	to fill them in:
   781 <pre><code>
   782 		SDL_AUDIO_FREQUENCY
   783 		SDL_AUDIO_FORMAT
   784 		SDL_AUDIO_CHANNELS
   785 		SDL_AUDIO_SAMPLES
   786 </code></pre>
   787 	If an environment variable is not specified, it will be set
   788 	to a reasonable default value.
   789 <LI>
   790 	SDL_SetVideoMode() now accepts 0 for width or height and will use
   791 	the current video mode (or the desktop mode if no mode has been set.)
   792 <LI>
   793 	Added current_w and current_h to the SDL_VideoInfo structure,
   794 	which is set to the desktop resolution during video intialization,
   795 	and then set to the current resolution when a video mode is set.
   796 <LI>
   797 	SDL_GL_LoadLibrary() will load the system default OpenGL library
   798 	if it is passed NULL as a parameter.
   799 <LI>
   800 	Added SDL_GL_SWAP_CONTROL to wait for vsync in OpenGL applications.
   801 <LI>
   802 	Added SDL_GL_ACCELERATED_VISUAL to guarantee hardware acceleration.
   803 <LI>
   804 	SDL_WM_SetCaption() now officially takes UTF-8 title and icon strings, and displays international characters on supported platforms.
   805 <LI>
   806 	Added SDL_GetKeyRepeat() to query the key repeat settings.
   807 <LI>
   808 	Added the "dummy" audio driver, which can be used to emulate audio
   809 	output without a sound card.
   810 <LI>
   811 	Added SDL_config.h, with defaults for various build environments.
   812 </UL>
   813 
   814 <H3> General Notes </H3>
   815 
   816 <BLOCKQUOTE>
   817 <P>
   818 	The SDL website now has an <A HREF="http://www.libsdl.org/rss/rss.xml">RSS feed</A>!
   819 <P>
   820 	The SDL development source code is now managed with <A HREF="http://www.libsdl.org/svn.php">Subversion</A>.
   821 <P>
   822 	SDL now uses the Bugzilla <A HREF="http://bugzilla.libsdl.org/">bug tracking system</A>, hosted by icculus.org.
   823 <P>
   824 	SDL is licensed under version 2.1 of the GNU Lesser General Public License.
   825 <P>
   826 	The entire build system has been revamped to make it much more portable, including versions of C library functions to make it possible to run SDL on a minimal embedded environment.  See README.Porting in the SDL source distribution for information on how to port SDL to a new platform.
   827 <P>
   828 	SDL_opengl.h has been updated with the latest glext.h from <A HREF="http://oss.sgi.com/projects/ogl-sample/registry/">http://oss.sgi.com/projects/ogl-sample/registry/</A>
   829 <P>
   830 	Alex Volkov contributed highly optimized RGB <-> RGBA blitters.
   831 </BLOCKQUOTE>
   832 
   833 <H3> Unix Notes </H3>
   834 
   835 <BLOCKQUOTE>
   836 <P>
   837 	The X11 libraries are dynamically loaded at runtime by default.  This allows the distributed version of SDL to run on systems without X11 libraries installed.
   838 <P>
   839 	The XiG XME extension code is now included in the X11 video driver by default.
   840 <P>
   841 	XRandR support for video mode switching has been added to the X11 driver, but is disabled because of undesired interactions with window managers.  You can enable this by setting the environment variable SDL_VIDEO_X11_XRANDR to 1.
   842 <P>
   843 	Xinerama multi-head displays are properly handled now, and the SDL_VIDEO_FULLSCREEN_HEAD environment variable can be used to select the screen used for fullscreen video modes.  Note that changing the video modes only works on screen 0.
   844 <P>
   845 	XVidMode video modes are now sorted so they maintain the refresh rates specified in the X11 configuration file.
   846 <P>
   847 	SDL windows are no longer transparent in X11 compositing systems like XGL.
   848 <P>
   849 	The mouse is properly released by the X11 video driver if the fullscreen window loses focus.
   850 <P>
   851 	The X11 input driver now uses XIM to handle international input.
   852 <P>
   853 	The screensaver and DPMS monitor blanking are disabled while SDL games are running under the X11 and DGA video drivers.  This behavior will be formalized and selectable in SDL 1.3.
   854 <P>
   855 	Fixed a bug preventing stereo OpenGL contexts from being selected on the X11 driver.
   856 <P>
   857 	The DGA video driver now waits for pending blits involving surfaces before they are freed.  This prevents display oddities when using SDL_DisplayFormat() to convert many images.
   858 <P>
   859 	The framebuffer console video driver now has a parser for /etc/fb.modes for improved video mode handling.
   860 <P>
   861 	The framebuffer console video driver now allows asynchronous VT switching, and restores the full contents of the screen when switched back.
   862 <P>
   863 	The framebuffer console now uses CTRL-ALT-FN to switch virtual terminals, to avoid collisions with application key bindings.
   864 <P>
   865 	The framebuffer console input driver correctly sets IMPS/2 mode for wheel mice.  It also properly detects when gpm is in IMPS/2 protocol mode, or passing raw protocol from an IMPS/2 mouse.
   866 <P>
   867 	The SVGAlib video driver now has support for banked (non-linear) video modes.
   868 <P>
   869 	A video driver for OpenBSD on the Sharp Zaurus has been contributed by Staffan Ulfberg.  See the file README.wscons in the SDL source distribution for details.
   870 <P>
   871 	Many patches have been incorporated from *BSD ports.
   872 </BLOCKQUOTE>
   873 
   874 <H3> Windows Notes </H3>
   875 
   876 <BLOCKQUOTE>
   877 <P>
   878 	The "windib" video driver is the default now, to prevent problems with certain laptops, 64-bit Windows, and Windows Vista.  The DirectX driver is still available, and can be selected by setting the environment variable SDL_VIDEODRIVER to "directx".
   879 <P>
   880 	SDL has been ported to 64-bit Windows.
   881 <P>
   882 	Dmitry Yakimov contributed a GAPI video driver for Windows CE.
   883 <P>
   884 	The default fullscreen refresh rate has been increased to match the desktop refresh rate, when using equivalent resolutions.  A full API for querying and selecting refresh rates is planned for SDL 1.3.
   885 <P>
   886 	Dialog boxes are now shown when SDL is in windowed OpenGL mode.
   887 <P>
   888 	The SDL window is recreated when necessary to maintain OpenGL context attributes, when switching between windowed and fullscreen modes.
   889 <P>
   890 	An SDL_VIDEORESIZE event is properly sent when the SDL window is maximized and restored.
   891 <P>
   892 	Window positions are retained when switching between fullscreen and windowed modes.
   893 <P>
   894 	ToUnicode() is used, when available, for improved handling of international keyboard input.
   895 <P>
   896 	The PrtScrn is now treated normally with both key down and key up events.
   897 <P>
   898 	Pressing ALT-F4 now delivers an SDL_QUIT event to SDL applications.
   899 <P>
   900 	Joystick names are now correct for joysticks which have been unplugged and then plugged back in since booting.
   901 <P>
   902 	An MCI error when playing the last track on a CD-ROM has been fixed.
   903 <P>
   904 	OpenWatcom projects for building SDL have been provided by Marc Peter.
   905 </BLOCKQUOTE>
   906 
   907 <H3> Mac OS X Notes </H3>
   908 
   909 <BLOCKQUOTE>
   910 <P>
   911 	SDL now supports building Universal binaries, both through Xcode projects and when using configure/make.  See README.MacOSX in the SDL source archive for details.
   912 <P>
   913 	The X11 video driver with GLX support can be built on Mac OS X, if the X11 development SDK is installed.
   914 <P>
   915 	Transitions between fullscreen resolutions and windowed mode now use a much faster asynchronous fade to hide desktop flicker.
   916 <P>
   917 	Icons set with SDL_WM_SetIcon() now have the proper colors on Intel Macs.
   918 </BLOCKQUOTE>
   919 
   920 <H3> OS/2 Notes </H3>
   921 
   922 <BLOCKQUOTE>
   923 <P>
   924 	Projects for building SDL on OS/2 with OpenWatcom have been contributed by Doodle.  See the file README.OS2 in the SDL source distribution for details.
   925 </BLOCKQUOTE>
   926 
   927 <IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">
   928 
   929 </BODY>
   930 </HTML>