From b31c4b70b3031dc4eb873612d65595a31b439a30 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Thu, 23 Oct 2025 15:19:13 -0700
Subject: [PATCH] Updated version and documentation for 3.3.2 preview release
---
CMakeLists.txt | 2 +-
WhatsNew.txt | 59 +++++++++++++++++++
Xcode/SDL/Info-Framework.plist | 4 +-
Xcode/SDL/SDL.xcodeproj/project.pbxproj | 12 ++--
Xcode/SDL/pkg-support/SDL.info | 2 +-
.../main/java/org/libsdl/app/SDLActivity.java | 2 +-
include/SDL3/SDL.h | 2 +-
include/SDL3/SDL_events.h | 2 +-
include/SDL3/SDL_render.h | 2 +
include/SDL3/SDL_version.h | 2 +-
src/core/windows/version.rc | 8 +--
11 files changed, 79 insertions(+), 18 deletions(-)
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9e19336771eb4..c29d2667dda95 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -5,7 +5,7 @@ if(NOT DEFINED CMAKE_BUILD_TYPE)
endif()
# See docs/release_checklist.md
-project(SDL3 LANGUAGES C VERSION "3.3.0")
+project(SDL3 LANGUAGES C VERSION "3.3.2")
if(CMAKE_SOURCE_DIR STREQUAL PROJECT_SOURCE_DIR)
set(SDL3_MAINPROJECT ON)
diff --git a/WhatsNew.txt b/WhatsNew.txt
index 0d10ee672acad..50e6b8c6bd708 100644
--- a/WhatsNew.txt
+++ b/WhatsNew.txt
@@ -1,6 +1,65 @@
This is a list of major changes in SDL's version history.
+---------------------------------------------------------------------------
+3.4.0:
+---------------------------------------------------------------------------
+
+General:
+* Added SDL_CreateAnimatedCursor() to create animated color cursors
+* Added SDL_SetWindowProgressState(), SDL_SetWindowProgressValue(), SDL_GetWindowProgressState(), and SDL_GetWindowProgressValue() to show progress in the window's taskbar icon on Windows and Linux
+* Added SDL_GetGPUDeviceProperties() to get the properties of an SDL GPU device
+* Added SDL_GetPixelFormatFromGPUTextureFormat() and SDL_GetGPUTextureFormatFromPixelFormat()
+* Added SDL_CreateGPURenderer() and SDL_GetGPURendererDevice() to create a 2D renderer for use with GPU rendering.
+* Added SDL_CreateGPURenderState(), SDL_SetGPURenderStateFragmentUniforms(), SDL_SetGPURenderState(), and SDL_DestroyGPURenderState() to use fragment shaders with a GPU 2D renderer
+* Added support for YUV textures and HDR colorspaces to the GPU 2D renderer
+* Added support for textures with palettes, and SDL_GetTexturePalette() and SDL_SetTexturePalette() to interact with them
+* Added SDL_RenderTexture9GridTiled() to do tiled instead of stretched 9-grid texture rendering
+* Added SDL_GetDefaultTextureScaleMode() and SDL_SetDefaultTextureScaleMode() to set the texture scale mode for new textures
+* Added SDL_GetRenderTextureAddressMode() and SDL_SetRenderTextureAddressMode() to change the texture addressing mode
+* Added SDL_TEXTURE_ADDRESS_WRAP to allow wrapping of textures if the renderer has SDL_PROP_RENDERER_TEXTURE_WRAPPING_BOOLEAN set
+* Added SDL_LoadPNG(), SDL_LoadPNG_IO(), SDL_SavePNG(), and SDL_SavePNG_IO() to load and save PNG images
+* Added SDL_RotateSurface() to create a rotated copy of a surface
+* Added SDL_PutAudioStreamDataNoCopy() to do more efficient audio stream processing in some cases
+* Added SDL_PutAudioStreamPlanarData() to add planar audio data instead of interleaved data to an audio stream
+* Added SDL_HINT_AUDIO_DEVICE_RAW_STREAM to signal that the OS shouldn't do further audio processing, useful for applications that handle noise canceling, etc.
+* Added enhanced support for 8BitDo controllers
+* Added enhanced support for FlyDigi controllers
+* Added enhanced support for Hand Held Legend SInput controllers
+* Added SDL_hid_get_properties() to associate SDL properties with HID devices
+* Added SDL_SetRelativeMouseTransform() to add custom mouse input transformation
+* Added SDL_GetPenDeviceType() to determine whether a pen is on the screen or on a separate touchpad
+* Added SDL_GetEventDescription() to get an English description of an event, suitable for logging
+* Added verbose log output when the DEBUG_INVOCATION environment variable is set to "1"
+* Added SDL_AddAtomicU32()
+* Added SDL_GetSystemPageSize() to get the system page size
+
+Windows:
+* Added SDL_HINT_RENDER_DIRECT3D11_WARP to enable D3D11 software rasterization
+* SDL_HINT_AUDIO_DEVICE_STREAM_ROLE is used by the WASAPI audio driver to set the audio stream category
+* SDL_HINT_WINDOWS_GAMEINPUT is disabled by default
+
+Linux:
+* Added atomic support for KMSDRM
+* Added SDL_HINT_KMSDRM_ATOMIC to control whether KMSDRM will use atomic functionality
+
+Emscripten:
+* Added SDL_HINT_EMSCRIPTEN_FILL_DOCUMENT for applications that don't want to be fullscreen, but would like to fill the window
+
+PlayStation 2:
+* Added the following hints to control the display parameters: SDL_HINT_PS2_GS_WIDTH, SDL_HINT_PS2_GS_HEIGHT, SDL_HINT_PS2_GS_PROGRESSIVE, SDL_HINT_PS2_GS_MODE
+
+
+---------------------------------------------------------------------------
+3.2.22:
+---------------------------------------------------------------------------
+* SDL_HINT_JOYSTICK_WGI is disabled by default
+
+---------------------------------------------------------------------------
+3.2.16:
+---------------------------------------------------------------------------
+* SDL_HINT_JOYSTICK_RAWINPUT is disabled by default
+
---------------------------------------------------------------------------
3.2.10:
---------------------------------------------------------------------------
diff --git a/Xcode/SDL/Info-Framework.plist b/Xcode/SDL/Info-Framework.plist
index adf5f832ef3ce..0afd012e4864d 100644
--- a/Xcode/SDL/Info-Framework.plist
+++ b/Xcode/SDL/Info-Framework.plist
@@ -19,10 +19,10 @@
<key>CFBundlePackageType</key>
<string>FMWK</string>
<key>CFBundleShortVersionString</key>
- <string>3.3.0</string>
+ <string>3.3.2</string>
<key>CFBundleSignature</key>
<string>SDLX</string>
<key>CFBundleVersion</key>
- <string>3.3.0</string>
+ <string>3.3.2</string>
</dict>
</plist>
diff --git a/Xcode/SDL/SDL.xcodeproj/project.pbxproj b/Xcode/SDL/SDL.xcodeproj/project.pbxproj
index 4d3a891c3f54e..997efa1660c84 100644
--- a/Xcode/SDL/SDL.xcodeproj/project.pbxproj
+++ b/Xcode/SDL/SDL.xcodeproj/project.pbxproj
@@ -3141,8 +3141,8 @@
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
DEPLOYMENT_POSTPROCESSING = YES;
- DYLIB_COMPATIBILITY_VERSION = 301.0.0;
- DYLIB_CURRENT_VERSION = 301.0.0;
+ DYLIB_COMPATIBILITY_VERSION = 303.0.0;
+ DYLIB_CURRENT_VERSION = 303.0.0;
DYLIB_INSTALL_NAME_BASE = "@rpath";
ENABLE_STRICT_OBJC_MSGSEND = YES;
GCC_ALTIVEC_EXTENSIONS = YES;
@@ -3177,7 +3177,7 @@
"@loader_path/Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 10.13;
- MARKETING_VERSION = 3.3.0;
+ MARKETING_VERSION = 3.3.2;
OTHER_LDFLAGS = "$(CONFIG_FRAMEWORK_LDFLAGS)";
PRODUCT_BUNDLE_IDENTIFIER = org.libsdl.SDL3;
PRODUCT_NAME = SDL3;
@@ -3207,8 +3207,8 @@
ALLOW_TARGET_PLATFORM_SPECIALIZATION = YES;
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
- DYLIB_COMPATIBILITY_VERSION = 301.0.0;
- DYLIB_CURRENT_VERSION = 301.0.0;
+ DYLIB_COMPATIBILITY_VERSION = 303.0.0;
+ DYLIB_CURRENT_VERSION = 303.0.0;
DYLIB_INSTALL_NAME_BASE = "@rpath";
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_TESTABILITY = YES;
@@ -3240,7 +3240,7 @@
"@loader_path/Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 10.13;
- MARKETING_VERSION = 3.3.0;
+ MARKETING_VERSION = 3.3.2;
ONLY_ACTIVE_ARCH = YES;
OTHER_LDFLAGS = "$(CONFIG_FRAMEWORK_LDFLAGS)";
PRODUCT_BUNDLE_IDENTIFIER = org.libsdl.SDL3;
diff --git a/Xcode/SDL/pkg-support/SDL.info b/Xcode/SDL/pkg-support/SDL.info
index 196d956068e94..0a024b1c40272 100644
--- a/Xcode/SDL/pkg-support/SDL.info
+++ b/Xcode/SDL/pkg-support/SDL.info
@@ -1,4 +1,4 @@
-Title SDL 3.3.0
+Title SDL 3.3.2
Version 1
Description SDL Library for macOS (http://www.libsdl.org)
DefaultLocation /Library/Frameworks
diff --git a/android-project/app/src/main/java/org/libsdl/app/SDLActivity.java b/android-project/app/src/main/java/org/libsdl/app/SDLActivity.java
index bd2b52553588f..049f13aa4a17a 100644
--- a/android-project/app/src/main/java/org/libsdl/app/SDLActivity.java
+++ b/android-project/app/src/main/java/org/libsdl/app/SDLActivity.java
@@ -61,7 +61,7 @@ public class SDLActivity extends Activity implements View.OnSystemUiVisibilityCh
private static final String TAG = "SDL";
private static final int SDL_MAJOR_VERSION = 3;
private static final int SDL_MINOR_VERSION = 3;
- private static final int SDL_MICRO_VERSION = 0;
+ private static final int SDL_MICRO_VERSION = 2;
/*
// Display InputType.SOURCE/CLASS of events and devices
//
diff --git a/include/SDL3/SDL.h b/include/SDL3/SDL.h
index 7cfba76e61b9f..e10a6d692d01e 100644
--- a/include/SDL3/SDL.h
+++ b/include/SDL3/SDL.h
@@ -20,7 +20,7 @@
*/
/**
- * Main include header for the SDL library, version 3.3.0
+ * Main include header for the SDL library, version 3.3.2
*
* It is almost always best to include just this one header instead of
* picking out individual headers included here. There are exceptions to
diff --git a/include/SDL3/SDL_events.h b/include/SDL3/SDL_events.h
index 136129ca72e93..45b5f9aba4297 100644
--- a/include/SDL3/SDL_events.h
+++ b/include/SDL3/SDL_events.h
@@ -1604,7 +1604,7 @@ extern SDL_DECLSPEC Uint32 SDLCALL SDL_RegisterEvents(int numevents);
extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_GetWindowFromEvent(const SDL_Event *event);
/**
- * Generate a human-readable description of an event.
+ * Generate an English description of an event.
*
* This will fill `buf` with a null-terminated string that might look
* something like this:
diff --git a/include/SDL3/SDL_render.h b/include/SDL3/SDL_render.h
index 3bbdbb4158100..7ce9f245abd72 100644
--- a/include/SDL3/SDL_render.h
+++ b/include/SDL3/SDL_render.h
@@ -2390,6 +2390,7 @@ extern SDL_DECLSPEC bool SDLCALL SDL_RenderTextureTiled(SDL_Renderer *renderer,
* \since This function is available since SDL 3.2.0.
*
* \sa SDL_RenderTexture
+ * \sa SDL_RenderTexture9GridTiled
*/
extern SDL_DECLSPEC bool SDLCALL SDL_RenderTexture9Grid(SDL_Renderer *renderer, SDL_Texture *texture, const SDL_FRect *srcrect, float left_width, float right_width, float top_height, float bottom_height, float scale, const SDL_FRect *dstrect);
@@ -2427,6 +2428,7 @@ extern SDL_DECLSPEC bool SDLCALL SDL_RenderTexture9Grid(SDL_Renderer *renderer,
* \since This function is available since SDL 3.4.0.
*
* \sa SDL_RenderTexture
+ * \sa SDL_RenderTexture9Grid
*/
extern SDL_DECLSPEC bool SDLCALL SDL_RenderTexture9GridTiled(SDL_Renderer *renderer, SDL_Texture *texture, const SDL_FRect *srcrect, float left_width, float right_width, float top_height, float bottom_height, float scale, const SDL_FRect *dstrect, float tileScale);
diff --git a/include/SDL3/SDL_version.h b/include/SDL3/SDL_version.h
index e3fb742dfae4a..684e3e39acb74 100644
--- a/include/SDL3/SDL_version.h
+++ b/include/SDL3/SDL_version.h
@@ -62,7 +62,7 @@ extern "C" {
*
* \since This macro is available since SDL 3.2.0.
*/
-#define SDL_MICRO_VERSION 0
+#define SDL_MICRO_VERSION 2
/**
* This macro turns the version numbers into a numeric value.
diff --git a/src/core/windows/version.rc b/src/core/windows/version.rc
index 0ae85b71cf26b..90c90f86dbb79 100644
--- a/src/core/windows/version.rc
+++ b/src/core/windows/version.rc
@@ -9,8 +9,8 @@ LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
//
VS_VERSION_INFO VERSIONINFO
- FILEVERSION 3,3,0,0
- PRODUCTVERSION 3,3,0,0
+ FILEVERSION 3,3,2,0
+ PRODUCTVERSION 3,3,2,0
FILEFLAGSMASK 0x3fL
FILEFLAGS 0x0L
FILEOS 0x40004L
@@ -23,12 +23,12 @@ BEGIN
BEGIN
VALUE "CompanyName", "\0"
VALUE "FileDescription", "SDL\0"
- VALUE "FileVersion", "3, 3, 0, 0\0"
+ VALUE "FileVersion", "3, 3, 2, 0\0"
VALUE "InternalName", "SDL\0"
VALUE "LegalCopyright", "Copyright (C) 2025 Sam Lantinga\0"
VALUE "OriginalFilename", "SDL3.dll\0"
VALUE "ProductName", "Simple DirectMedia Layer\0"
- VALUE "ProductVersion", "3, 3, 0, 0\0"
+ VALUE "ProductVersion", "3, 3, 2, 0\0"
END
END
BLOCK "VarFileInfo"