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