WhatsNew.txt
author Ryan C. Gordon <icculus@icculus.org>
Sat, 13 Dec 2014 02:33:52 -0500
changeset 9276 2b9bf6b04595
parent 8833 ae720d61d14d
permissions -rw-r--r--
CMake: Replace "else(condition)" with "else()", etc. Bumped required CMake version to 2.8. Thanks to the SDL/Emscripten porting team for this cleanup.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
7228
9cf41f66562c Renamed WhatsNew so it can be easily read on Windows
Sam Lantinga <slouken@libsdl.org>
parents: 5046
diff changeset
     1
7878
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
     2
This is a list of major changes in SDL's version history.
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
     3
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
     4
---------------------------------------------------------------------------
8676
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
     5
2.0.4:
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
     6
---------------------------------------------------------------------------
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
     7
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
     8
General:
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
     9
* Added an event SDL_RENDER_DEVICE_RESET that is sent from the D3D renderers 
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
    10
  when the D3D device is lost, and from Android's event loop when the GLES
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
    11
  context had to be re created.
8833
ae720d61d14d Chrome's Native Client backend implementation
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8676
diff changeset
    12
* Native Client backend
8676
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
    13
e217c66375e5 Emit SDL_RENDER_DEVICE_RESET on Android when the GLES context is recreated
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8625
diff changeset
    14
---------------------------------------------------------------------------
8303
7ee46ffa9c24 Updated SDL to version 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8274
diff changeset
    15
2.0.3:
7ee46ffa9c24 Updated SDL to version 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8274
diff changeset
    16
---------------------------------------------------------------------------
7ee46ffa9c24 Updated SDL to version 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8274
diff changeset
    17
8625
f285b9487756 Added a patch note for 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8303
diff changeset
    18
Mac OS X:
f285b9487756 Added a patch note for 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8303
diff changeset
    19
* Fixed creating an OpenGL context by default on Mac OS X 10.6
f285b9487756 Added a patch note for 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8303
diff changeset
    20
8303
7ee46ffa9c24 Updated SDL to version 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8274
diff changeset
    21
7ee46ffa9c24 Updated SDL to version 2.0.3
Sam Lantinga <slouken@libsdl.org>
parents: 8274
diff changeset
    22
---------------------------------------------------------------------------
7907
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    23
2.0.2:
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    24
---------------------------------------------------------------------------
8044
e84427ef8244 Adding WhatsNew.txt changes
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7907
diff changeset
    25
General:
8197
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    26
* Added SDL_GL_ResetAttributes() to reset OpenGL attributes to default values
8220
7fff00b50032 Changed text in documentation.
Philipp Wiesemann <philipp.wiesemann@arcor.de>
parents: 8197
diff changeset
    27
* Added an API to load a database of game controller mappings from a file:
8270
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    28
    SDL_GameControllerAddMappingsFromFile(), SDL_GameControllerAddMappingsFromRW()
8197
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    29
* Added game controller mappings for the PS4 and OUYA controllers
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    30
* Added SDL_GetDefaultAssertionHandler() and SDL_GetAssertionHandler()
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    31
* Added SDL_DetachThread()
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    32
* Added SDL_HasAVX() to determine if the CPU has AVX features
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    33
* Added SDL_vsscanf(), SDL_acos(), and SDL_asin() to the stdlib routines
8062
4fc5f66d63cc Wayland support
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8057
diff changeset
    34
* EGL can now create/manage OpenGL and OpenGL ES 1.x/2.x contexts, and share
4fc5f66d63cc Wayland support
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8057
diff changeset
    35
  them using SDL_GL_SHARE_WITH_CURRENT_CONTEXT
8270
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    36
* Added a field "clicks" to the mouse button event which records whether the event is a single click, double click, etc.
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    37
* The screensaver is now disabled by default, and there is a hint SDL_HINT_VIDEO_ALLOW_SCREENSAVER that can change that behavior.
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    38
* Added a hint SDL_HINT_MOUSE_RELATIVE_MODE_WARP to specify whether mouse relative mode should be emulated using mouse warping.
8197
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    39
* testgl2 does not need to link with libGL anymore
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    40
* Added testgles2 test program to demonstrate working with OpenGL ES 2.0
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    41
* Added controllermap test program to visually map a game controller
8220
7fff00b50032 Changed text in documentation.
Philipp Wiesemann <philipp.wiesemann@arcor.de>
parents: 8197
diff changeset
    42
8044
e84427ef8244 Adding WhatsNew.txt changes
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7907
diff changeset
    43
Windows:
e84427ef8244 Adding WhatsNew.txt changes
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7907
diff changeset
    44
* Support for OpenGL ES 2.x contexts using either WGL or EGL (natively via
e84427ef8244 Adding WhatsNew.txt changes
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7907
diff changeset
    45
  the driver or emulated through ANGLE)
8270
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    46
* Added a hint SDL_HINT_VIDEO_WIN_D3DCOMPILER to specify which D3D shader compiler to use for OpenGL ES 2 support through ANGLE
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    47
* Added a hint SDL_HINT_VIDEO_WINDOW_SHARE_PIXEL_FORMAT that is useful when creating multiple windows that should share the same OpenGL context.
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    48
* Added an event SDL_RENDER_TARGETS_RESET that is sent when D3D9 render targets are reset after the device has been restored.
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    49
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    50
Mac OS X:
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    51
* Added a hint SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK to control whether Ctrl+click should be treated as a right click on Mac OS X. This is off by default.
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    52
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    53
Linux:
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    54
* Fixed fullscreen and focused behavior when receiving NotifyGrab events
75a296e647e7 Updated with the latest 2.0.2 API changes
Sam Lantinga <slouken@libsdl.org>
parents: 8220
diff changeset
    55
* Added experimental Wayland and Mir support, disabled by default
7907
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    56
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    57
Android:
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    58
* Joystick support (minimum SDK version required to build SDL is now 12, 
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    59
  the required runtime version remains at 10, but on such devices joystick 
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    60
  support won't be available).
8057
801d84e26f91 [Android] Hotplugging support for joysticks
Gabriel Jacobo <gabomdq@gmail.com>
parents: 8044
diff changeset
    61
* Hotplugging support for joysticks
8274
8b1f8feb42a6 Changed SDL_HINT_ACCEL_AS_JOY to SDL_HINT_ACCELEROMETER_AS_JOYSTICK to be more clear.
Sam Lantinga <slouken@libsdl.org>
parents: 8270
diff changeset
    62
* Added a hint SDL_HINT_ACCELEROMETER_AS_JOYSTICK to control whether the accelerometer should be listed as a 3 axis joystick, which it will by default.
8197
7e9a477d3e07 Updated SDL to version 2.0.2
Sam Lantinga <slouken@libsdl.org>
parents: 8062
diff changeset
    63
7907
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    64
24b4e98c6010 Adds Joystick support for Android
Gabriel Jacobo <gabomdq@gmail.com>
parents: 7878
diff changeset
    65
---------------------------------------------------------------------------
7878
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    66
2.0.1:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    67
---------------------------------------------------------------------------
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    68
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    69
General:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    70
* Added an API to get common filesystem paths in SDL_filesystem.h:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    71
    SDL_GetBasePath(), SDL_GetPrefPath()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    72
* Added an API to do optimized YV12 and IYUV texture updates:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    73
    SDL_UpdateYUVTexture()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    74
* Added an API to get the amount of RAM on the system:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    75
    SDL_GetSystemRAM()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    76
* Added a macro to perform timestamp comparisons with SDL_GetTicks():
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    77
    SDL_TICKS_PASSED()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    78
* Dramatically improved OpenGL ES 2.0 rendering performance
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    79
* Added OpenGL attribute SDL_GL_FRAMEBUFFER_SRGB_CAPABLE
7228
9cf41f66562c Renamed WhatsNew so it can be easily read on Windows
Sam Lantinga <slouken@libsdl.org>
parents: 5046
diff changeset
    80
7878
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    81
Windows:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    82
* Created a static library configuration for the Visual Studio 2010 project
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    83
* Added a hint to create the Direct3D device with support for multi-threading:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    84
    SDL_HINT_RENDER_DIRECT3D_THREADSAFE
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    85
* Added a function to get the D3D9 adapter index for a display:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    86
    SDL_Direct3D9GetAdapterIndex()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    87
* Added a function to get the D3D9 device for a D3D9 renderer:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    88
    SDL_RenderGetD3D9Device()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    89
* Fixed building SDL with the mingw32 toolchain (mingw-w64 is preferred)
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    90
* Fixed crash when using two XInput controllers at the same time
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    91
* Fixed detecting a mixture of XInput and DirectInput controllers
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    92
* Fixed clearing a D3D render target larger than the window
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    93
* Improved support for format specifiers in SDL_snprintf()
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    94
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    95
Mac OS X:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    96
* Added support for retina displays:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    97
  Create your window with the SDL_WINDOW_ALLOW_HIGHDPI flag, and then use SDL_GL_GetDrawableSize() to find the actual drawable size. You are responsible for scaling mouse and drawing coordinates appropriately.
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    98
* Fixed mouse warping in fullscreen mode
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
    99
* Right mouse click is emulated by holding the Ctrl key while left clicking
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   100
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   101
Linux:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   102
* Fixed float audio support with the PulseAudio driver
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   103
* Fixed missing line endpoints in the OpenGL renderer on some drivers
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   104
* X11 symbols are no longer defined to avoid collisions when linking statically
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   105
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   106
iOS:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   107
* Fixed status bar visibility on iOS 7
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   108
* Flipped the accelerometer Y axis to match expected values
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   109
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   110
Android:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   111
IMPORTANT: You MUST get the updated SDLActivity.java to match C code
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   112
* Moved EGL initialization to native code 
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   113
* Fixed the accelerometer axis rotation relative to the device rotation
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   114
* Fixed race conditions when handling the EGL context on pause/resume
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   115
* Touch devices are available for enumeration immediately after init
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   116
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   117
Raspberry Pi:
b331f16f3fe0 Added patch notes for 2.0.1
Sam Lantinga <slouken@libsdl.org>
parents: 7874
diff changeset
   118
* Added support for the Raspberry Pi, see README-raspberrypi.txt for details