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