Squashed 'external/SDL/' changes from 8ec576dda..90fd2a3cb

90fd2a3cb Sync SDL3 wiki -> header edd08771a wayland: Add xdg_toplevel v7 edge constraint support 113475acb wayland: Add multi-seat support 4093e4a19 Fixed process I/O redirection to NUL on Windows c025fdbb7 Add the CREATE_NO_WINDOW flag for background processes 8a57c83ff Updated to GameInput v1.1 f35a2736b Don't reset the render target when invalidating GPU renderer cache state 47e52ab37 Sync SDL3 wiki -> header 6a3dbe34d Sync SDL3 wiki -> header d84c000ac Sync SDL3 wiki -> header 98e76d283 Fixed conflict when linking both SDL and hidapi statically f6db5ba4c Add Turtle Beach VelocityOne a1016bd06 Allow 01-joystick-polling example to be resizable 60fb1b554 Fix IMU orientations for 8bitdo wireless 2 controller in bluetooth mode b0860fb0c Disable EGL in Emscripten builds f303ccca6 Updated the report size for Ultimate 2 Wireless firmware v1.02 0add03780 [Windows]: dialog: Add `OFN_OVERWRITEPROMPT` to save dialogs (#12782) a390f5716 docs: improve man page generation 93ac1e689 Fixed non-XBox controllers being detected as Series X controllers d29bb902f Don't treat the Keychron K1 Pro System Control keyboard as a joystick ab57ef9d7 update sdlgenblit.pl after PR/12769 b0a0d236d fix sdlgenblit.pl so that it actually matches the generated source 0fdfa925f rename local pointer vars 'pixel' to 'pixels' 46c314cc3 Revert "bool is 4 bytes in Apple MacOS X 32 bit PPC ABI" 2abfb92c5 Sync SDL3 wiki -> header 97eddacd7 Use the actual value of EGL_PLATFORM_DEVICE_EXT if it's not defined 4c1a3ccd4 rename local vars 'pixel' to 'pixelvalue' 433704e77 rename 'pixel' params of SDL_GetRGB, SDL_GetRGBA and SDL_LookupRGBAColor 83b261ae8 Remove unused message box includes cccad933a Updated version documentation to match SDL 3.x practice adad7dcae x11/wayland: Ignore redundant restore and fullscreen leave requests when showing the window d7d6d8e28 Sync SDL3 wiki -> header f7b718883 Add SDL_CreateGPURenderer 5a59b5f32 bool is 4 bytes in Apple MacOS X 32 bit PPC ABI 3b9101768 pulseaudio: cleanup TLS every time we finish a threaded-mainloop callback. 646f1f243 x11: Only enable _NET_WM_SYNC_REQUEST for OpenGL windows 33f90f2e4 GPU Vulkan: Clean up in Submit in headless mode (#12744) 93b06cffd Sync SDL3 wiki -> header c2c3a930b Add STRING suffix to SDL_PROP_WINDOW_CREATE_EMSCRIPTEN_* string properties 44710a248 gpu: alpha-to-coverage support d6d2c958a Move global event handlers to SDL_VideoInit 05939909d SDL_gpu.h: SDL_GetGPUDeviceProperties() is thread-safe. 1687bc746 Sync SDL3 wiki -> header accd952c4 SDL_gpu.h: Another attempt to clean up SDL_GetGPUDeviceProperties() docs. c5f369f55 Sync SDL3 wiki -> header 0c9eccd0e Sync SDL3 wiki -> header 906c6c751 GPU: Add missing error code to VkErrorMessages() 205c34c62 GPU: The D3D12 blit shaders are DXIL 300013cea GPU: Don't pass null properties to SDL_CopyProperties() 8ad64aba1 GPU: Remove subheadings from SDL_GetGPUDeviceProperties() docs 94ab2b76a Sync SDL3 wiki -> header 85281be78 Re-added text removed by the wiki bridge b53e7b447 GPU Vulkan: Fix recursive Submit calls causing defrag to fail (#12718) b1919783c Sync SDL3 wiki -> header 39a3b14df Renamed SDL_GetGPUDeviceDebugProperties() to SDL_GetGPUDeviceProperties() ca613b9d8 x11: Send a restored event before entering fullscreen 667b706a9 x11: Don't set the hidden flag when minimizing windows 6430aed3d Removed SDL_XInputVersion, which isn't used 40e08ee7a Assume new XBox controllers have a share button 6bb16296b Added special handling for SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY ebb52973e cmake: make SDL_CPU_xxx variable visible when using CMAKE_OSX_ARCHITECTURES b4af01cd0 only build static library in some feature tests 756b455d3 Fixed building for Xbox One 25232c077 Sync SDL3 wiki -> header f78aa4d8e GPU: Expose debug information from devices 008690d01 Sync SDL3 wiki -> header df3282740 Note that you might get a different size window than you expect ab34ea5a2 Fixed documentation for SDL_GL_*_SIZE 87d6beb89 Rename cmake/sdltargets.cmake -> cmake/sdlcommands.cmake 208ec1829 Update README-documentation-rules.md 5709466dd Sync SDL3 wiki -> header b52140086 Note that the Emscripten window properties are strings 82b245d13 Added support for the HORI Taiko No Tatsujin Drum Controller 12ef57ede Sync SDL3 wiki -> header 735b68581 Fixed wiki reformatting cc8ec6cf1 Handle global mouse state for Emscripten (#12669) 53d053279 Sync SDL3 wiki -> header cbc26fe2c Add Emscripten window data to window properties 4aefde015 Only send sensor data if sensors are enabled for 8BitDo controllers 6d7827344 Return early in stead of goto c3ce216c4 Fixed crash at shutdown on Windows e87a00c07 tests: port failing SDL_Renderer test from pysdl2 to testautomation 10819273b tests: port failing SDL_Renderer test from pysdl2 to testautomation ffbd434a1 tests: port failing window test from pysdl2 to testautomation 2775e7a78 tests: port failing SDL_Rect tests from pysdl2 to testautomation 39eed1d23 tests: port failing SDL_Hint tests from pysdl2 to testautomation 366a5281b Fixed comment 79a41ca7f Implemented DEBUG_8BITDO_PROTOCOL 5922e2cb7 Corrected comment with 8BitDo controller report sizes 0d9ff082f 8BitDo HIDAPI driver cleanup e236a48e1 8BitDo 4de396734 More clarification for high DPI support 36fc1c2c9 Fixed texture colorspace when creating a texture from a surface 512485869 fix vulkan vertex buffer indexing 2e494fda3 Clarify high DPI support and best practices 44faac292 Fixed A/B/X/Y buttons on Nintendo 3DS 38c2081ae Temporarily default SDL_HINT_JOYSTICK_HIDAPI_8BITDO off bcacc37e3 Sync SDL3 wiki -> header e18c6bd2e 8BitDo (#12661) 6b1d6bfbe wayland: Commit the confinement region upon creation 266ee41c8 wayland: Defer creating cursor confinement regions until the surface is mapped cb1d79db3 Sync SDL3 wiki -> header 088ad66f7 Update include/SDL3/SDL_power.h 032d69602 Add performance disclaimer in `SDL_GetPowerInfo` documentation 0d04e9ea6 Fixed build 7bb95bde4 Set the alpha opaque when blending to an RGB format 8eb57c5a4 diskaudio: Use SDL_GetAudioFormatName instead of recreating it from scratch. f05bb7aae diskaudio: Log the raw PCM's format during "device" open. 210b317d8 x11: Popup positions after constraining are in the window-relative space, not global daa7a5ad7 Updated Visual Studio example projects f7a89d19c fix missing AVFoundation in CMakeLists.txt a23f97483 Temporarily disable DwmFlush() 536a1a236 coreaudio: Added some NULL pointer checks. 712c76fdc gamepad: Fix inability to disable SDL_EVENT_GAMEPAD_UPDATE_COMPLETE events 418acf629 Sync SDL3 wiki -> header 633b9f6fb Added SDL_SetRenderTextureAddressMode() and SDL_GetRenderTextureAddressMode() eb918af3d video: fix surface leak when duplicating mjpeg 567dfd2eb examples/renderer/19-affine-textures: add metadata for examples.libsdl.org. 5ab1aef36 examples/renderer/19-affine-textures: blue background so you can see the cube. 87e6d2250 examples, affine-textures: fix RISC-OS build. 254f34808 examples/renderer/19-affine-textures: Flip coords so SDL logo is right-side up. 391545105 examples/renderer/19-affine-textures: Whole source file was indented one space. 2ebcee203 examples: added examples/renderer/19-affine-textures to CMakeLists.txt. 2207f6bc9 examples/renderer/affine-textures: Fixed compiler warnings. 83eea00d6 Create affine-textures.c 401aaf3d2 video: Revert unnecessary member assignment eed94cb03 Updated link to PSP Hello World be2f7f206 Sync SDL3 wiki -> header 0f27c3aab Added SDL_PROP_PROCESS_CREATE_WORKING_DIRECTORY_STRING 289f5cfdb touch: Don't call ResetTouch() if SDL_GetTouch() can't find a virtual device. b00b08f83 touch: Keep state correct when removing virtual touch devices during quit. 09fff161e cocoa: Clear pending state on fullscreen switch failures 05d23cae7 cocoa: Re-add sync timeout 2e61b4165 Don't send relative motion while in a modal loop 4c035a1fd audio: Allow PipeWire and PulseAudio streams to migrate to other sinks. f3d4e6fe5 Sync SDL3 wiki -> header 8e6eaf12a wayland: Expose wl_output objects on video displays 1f917d523 Sync SDL3 wiki -> header 00f316737 Progress bar comment changes e28974124 Added mappings for the NSO N64/SEGA/SNES controllers b88200b79 Fixed face buttons for the NSO SNES controller under the HIDAPI driver f355c7f21 Allow the progress API to be used on all platforms b45ed98ae Fix spelling mistake in documentation 716e33f10 x11: Send the _XWAYLAND_MAY_GRAB_KEYBOARD message when grabbing the keyboard a5633ad0f Sync SDL3 wiki -> header 6cc00a31b WindowProgressState API getters and fixes (#12629) b520cde18 cocoa: Properly set the pending fullscreen spaces state when in a transition dd9b9d451 Check if GL_OES_EGL_image_external is supported before trying to use it 7ec13a2ea Document SDL_malloc alignment guarantees ae17b04c0 alsa: Don't start the hardware until the device thread is ready to do work. 41636959d audio: Feed output devices immediately, instead of waiting upfront. 48d4104ec pulseaudio: Fixed typo in commented-out debug logging. 8cb303126 wayland: Fix global mouse position retrieval d6f137b2b Added a note to tag the wiki when doing feature releases 7f927de1f x11: remove 'args' and 'ret' from SDL_X11_SYM macro b6ca03611 Fixed mixed trigger and body rumble for Xbox controllers on Windows c3a3a11db keyboard: Don't check text input on a null window 035d9179a WIN_SetWindowProgressState(): Unsupported parameter error message c217663fb SDL_SetWindowProgressState(): Add parameter validation check for `state` 3fa1bd81f Fixed previous commit renaming {add,remove}AudioDevice to native{Add,Remove}AudioDevice b8381b3a2 Sync SDL3 wiki -> header fa0a86409 Additions to progress bar comments 721476033 SDL_SetWindowProgressValue(): Move value clamp from `WIN_SetWindowProgressValue()` to `SDL_SetWindowProgressValue()` 69ad66b01 Fixed error messages in GetTaskbarList() a3be7a137 WIN_SetWindowProgressValue(): Fix value clamp 017783835 Native functions renamed: {add,remove}AudioDevice to native{Add,Remove}AudioDevice 6e875397f Proguard: remove onNativePen 027df89ed wayland: Scale accelerated relative pointer coordinates with emulated resolutions f52f982b1 chore: rename integer mode field names 8407a1625 Sync SDL3 wiki -> header 7a10fcdcc Add progress bar support for Windows (#12530) 6b13d6910 Improve move/resize visual smoothness on Windows 4fcef9074 audio: hold floating point exceptions when using neon b493e29a8 x11: Fix backwards _NET_WM_SYNC_REQUEST init check 2fbb58329 SDL_ClaimWindowForGPUDevice() should fail for transparent windows bde49abdb GPU: Support swapchain buffer transparency in Vulkan 79081a178 cocoa: Fix zoom check when leaving fullscreen 03cdd297e video: Fix boolean logic for getting the pending window position fbdb63797 Fixed build when virtual joysticks are disabled 758eb256b Fixed DebugLogRenderCommands() output 4ceb02434 We need to rebind D3D12 resources after updating them 3538abfb8 Revert "Don't update a texture twice in the same batch on D3D12" 0681d0881 Don't update a texture twice in the same batch on D3D12 ac5b2b610 Don't send text event while ctrl/alt is held on X11/Wayland 365b7837c add private definitions to SDL_build_config.h.cmake 817260c73 Updates SDL_SetEventFilter code snippet to SDL3 3fd61b053 Updated for SDL style 581b61429 Emscripten: Support Custom Message Boxes (#12583) 54f5b7333 emscripten: Don't use legacy JS library functions for assertions 03a53ce0d Always show the on-screen keyboard on Steam Deck 8caeaaacd A Steam Controller might be generating keyboard input cbb83be89 Show the on-screen keyboard if we don't have active keyboard input 67b4c3a15 Sync SDL3 wiki -> header 10072bb07 asyncio: SDL_LoadFileAsync was not null-terminating the file data. 85435d5a1 SDL_audio.h: Fixed typos in docs. 3ed61f203 Fixed applications that integrate Qt with SDL joystick support de60a5f39 Revert "Make native functions be public otherwise it fails at run-time." fe024b8fe Fixed typo in build.gradle 10fae8c34 Fixed Android build warnings bf7b9b020 Fixed gradle deprecation warnings ac2870250 Use the android-21 SDK as documented in README-android.md 476e7e54c Don't create surfaces with invalid pixel formats 6f456da63 GPU: Request sampleRateShading feature on Vulkan 4fd4d89b6 Make native functions be public otherwise it fails at run-time. (they are public such as the one in SDLActivity) f2ed5c7a1 Fix illegal calls to DwmGetWindowAttribute() 96bf12444 Windows allows windows to be resized to zero height. 47b0c7547 Make sure we're getting called for the correct window 3415bc920 Fixed crash if a window couldn't be created on Windows 07e4dea69 The posix4 library has been merged into the libc library 9820f655d android: reduce visiblity as much as possible c696e9318 GPU Vulkan: Fix render pass race (#12587) 7b93a744c time: Fix compilation on Solaris 14deef997 emscripten: Fix undefined behavior in opengles2 renderer 5283f7374 storage: Declare a private bootstrap for NDA user storage 8b924df48 Use an autoreleasepool in Cocoa_GetDisplayUsableBounds() 82335fd0e Fixed building with SDL_LEAN_AND_MEAN a551c2a6d Fix Vulkan error check 5985f0a32 Fixed infinite recursion in SDL_IsGamepad() 6d0fb0a2e gpu: Fix MTLLibrary dispatch data destructor 3e5664a5b Fix return type in SDL_CreateGPURenderState 4fc9509ab Fixed raw input device GUIDs changing randomly between runs 0bd70684b GPU: Fix Vulkan backend never checking deallocations (#12567) 715301cef Fixed crash if info->path is NULL f5eea7efa remove status message for SDL_STATIC_PIC PIC is controlled through CMAKE_POSITION_INDEPENDENT_CODE and not by an SDL option 35c03774f [SDL3] Adding input and FFB support for Logitech G29(PS3) on hidapi (#11598) d66483dfc video: Send pending coordinates for moved, hidden windows b9504f247 opengl: pixelart fragment shader uses GLSL version 1.30 05531c5f4 release: use NDK r21e for building Android release artifact 18185e30e Remove breaks under return 80ff0f45f Move default 3b58ad9d4 Add breaks and defaults to switch statements 8b6e9936e Missed a bracket 36ec4cd39 Align spacing 3b90ce499 Fix spacing; tabs to 4 spaces 60857935c Add preliminary joystick support for snake example aad1e3516 mouse: Allow use of integer coordinates with fractional wheel events 501e71f25 Added unaligned version of SDL_ConvertPixels_SwapNV_std() ad9f9af4e Removed accidentally enabled debug code efe122be4 Removed width/height parameters from LoadTexture() dcb97a5f4 Set a default shader entry point 1a2fccc56 hints: The auto mode switching hint is for 3.4.0 285fa671a Sync SDL3 wiki -> header 0bfe0497f video: Add a hint to disable auto mode switching if an exclusive fullscreen window moves between displays 58f6e9c27 Fix trailing doc comments f15832c68 Sync SDL3 wiki -> header 17b84dbcf emscripten: add window properties for canvas ID and keyboard element (#12509) ffe69fc35 Fixed SDL_GPUTextureSupportsSampleCount() documentation e671bc265 Sync SDL3 wiki -> header 02faa8f75 Rename SDL_SetGPURenderStateFragmentUniformData() to SDL_SetGPURenderStateFragmentUniforms() 96194347b Added an example of fullscreen shader effects with the GPU renderer 2aee105b4 Added support for custom shaders with the GPU renderer eb56c8af8 Sync SDL3 wiki -> header 1ae4ef65e Fixed incorrect assert 3e9e22f17 Added SDL_SCALEMODE_PIXELART 853375da6 Removed texture_size from the GPU renderer vertex shader 28ec461eb Organize the GPU renderer draw code af0420d89 Switched GPU renderer shaders to shadercross and HLSL c318b1f92 SDL_mutex.h: Fixed code example. 0e29c6295 gpu: Clean up unused code in Vulkan and D3D12 drivers 71c4de190 Sync SDL3 wiki -> header 512d97eab cocoa: Set the internal window data before calling methods that may result in referencing the internal data 5e951a230 windows: Fix WIN_SetWindowAlwaysOnTop causing owner window z-order changes when child windows are created or change top-level status 50a397bb4 Removed help for obsolete (and removed) command line option 3235a4eb4 Initialize the padding of aligned allocations to zero efaafd766 VITA: Remove unused/duplicate headers 7746a9656 Fixup the mingw readme cmakelists 2ce3dfdf1 Fixed Nintendo controller face button layout under Steam be6ed6e9c Fixed sscanf("026", "%1x%1x%1x", &r, &g, &b) 24339524c Use sized types when fixing undefined behavior f1d16e9b4 avoid UB (left shift of negative number) in SDL_windowsevents.c 9fcca8351 gpu: Validate that CopyGPUTextureToTexture formats match f2866418d wayland: Fix enum/boolean comparison and assignment 597bfe6b2 mouse: Add internal integer mouse mode hint for sdl2-compat 65cd2256c emscripten: Fix handling of special HTML targets 5d804a39d Implement SDL_GetSystemRAM and SDL_GetNumLogicalCPUCores for the 3ds (#12494) 99336ea37 Fixed memory leak in memory leak tracking 0306b5a86 Fix n3ds/SDL_syssem.c:SDL_SignalSemaphore (libsdl-org/SDL#12411) 3353b92a9 Fixed pen events on iOS after reinitializing SDL ad2584813 cocoa: Ignore both clicks and motion on tooltip windows fe245c6e0 x11: Always synthesize size events for external windows 84d047cc1 wayland: Rollback the round trip when reading data offers fc3510785 Sync SDL3 wiki -> header d631a3add Add a link to docs/INTRO-mingw.md 04b4577b5 Added MinGW Intro readme, touched up CMake and Visual Studio readmes. (#12485) b99ff00a9 Removed logic forcing vsync on if setting it off fails 55695d372 Sync SDL3 wiki -> header 9c7c11f25 wayland: Roundtrip when receiving data offers c4be7f77a wayland: Add additional MIME types for text drag & drop e20e27e1f Added SIMD blitters for 8888 -> 8888 format conversion 4c82b5843 Added support for SDL_PIXELFORMAT_MJPG to SDL_DuplicateSurface() cb099ebd4 Make texture scale mode a part of the 2D renderer draw state 6e2d3c9b5 x11: Enable legacy synchronization for external window resize and move events bdde07468 Sync SDL3 wiki -> header 49af57694 Disable XTest by default 794ff283e Added support for using XTest to warp the mouse fae324dac Update XSync code to match SDL3 conventions f01bcaeb1 Sync SDL3 wiki -> header fe9bdcf50 Added SDL_HINT_VIDEO_X11_EXTERNAL_WINDOW_INPUT 9f557941f Sync SDL3 wiki -> header 8f40dad46 Document the thread safety of SDL surface functions aef240b2e Fixed continuous logging if returning to desktop mode fails on X11 e9632c83c Handle XWayland not sending display disconnected events ca9bc6b16 Revert "Ignore BadRROutput errors from XRRGetOutputInfo()" 0c8ddc1f0 Ignore BadRROutput errors from XRRGetOutputInfo() 80ae3a751 Fixed crash when restoring the desktop mode on macOS 5f07347e4 Fixed crash unplugging a HIDAPI controller 82552e5b7 Make SDL_RegisterEvents() thread-safe 9f9a44282 video: Synthesize fullscreen related moves if the driver does not. e7abbf158 x11: Synthesize fullscreen size events on Openbox 5d20bbf34 Presenting while drawing to a render target should fail. debbe1cf7 Fix for Message Box failing to init on X11 (#12455) 4bb46e93c Fixed clip rect when logical presentation is enabled 7df0ffd43 Sync SDL3 wiki -> header 7c29c8b26 Added fullscreen_active to better track fullscreen state 3b9f0dff1 Use _this pointer to reference the video device 0ccf272ee Check the display device before dereferencing 6c347cbf3 video: Handle Cocoa desktop mode switch inhibition in the video layer 24ec2ed78 Don't save temporary mode changes to the desktop mode d57aa6f7a pipewire: Don't require pw_check_library_version() with Pipewire < 0.3.75 113eb6f01 gpu: Add BC2_RGBA_UNORM_SRGB to GetBlockWidth/Height functions 2c7c3d4d7 Only use VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR on Android ca3c5fd40 fix build: s/SDL_DetectSandbox/SDL_GetSandbox/ eac63b473 Add the definition for DBUS_TYPE_UNIX_FD to SDL_dbus.h 16f12c0d5 Implement the XDP Camera portal c3b415641 Sync SDL3 wiki -> header 2a0223487 Sync SDL3 wiki -> header 1a7c20698 Save and restore error messages when rolling back after failed init 2c46c3d5b Updated dynamic API for new functions 5373271a1 forbid transform change while relative mode active 428f0dcd6 add SDL_SetRelativeMouseTransform 67127afe3 Fix from #12118 e25ee2246 Added tiled 9-grid texture rendering function 954675b32 Sync SDL3 wiki -> header 44bca81fd Change default texture scale mode per renderer b0d2a4f35 gpu: Fix Z offset for D3D12 realigned 3D texture uploads b69201dae cocoa: Don't overwrite the desktop mode when changing the fullscreen mode 078d737a2 cocoa: Run pending events to completion b0df1cbbe Updated to version 3.3.0 for development 65864190c Added testpen to the Xcode test project 292e43174 Updated to version 3.2.6 for release f0cb78e08 Handle XCreateIC() failing when composition UI is enabled 55484ef02 Moved WIN_UpdateMouseCapture() to be with the other mouse functions 020664bd1 Update mouse button state when re-entering a window b836ad4d4 Fix a root signature mismatch for the D3D12 renderer a88105784 camera: Delete some failure code that should have been removed before. f868408a3 Ceil the audio resampling rate to avoid over-estimating output samples. cbdc93b17 cmake: make sure a SDL3 library is present when not using COMPONENTs 8a7beca12 camera: clear the spec when closing, so re-opening can probe again ee5f5c917 Sync SDL3 wiki -> header 6e4193b74 Note that the file names are UTF-8 encoded 60c65f9fa SDL_camera.c: fix failure-return in SDL_PrepareCameraSurfaces(). b8c2bc143 Added build dependencies for Arch Linux 7ab1412e2 Sync SDL3 wiki -> header 725af6ad1 camera: Fixed surface formats, etc, for Emscripten backend. ef23ebfb5 Fixed the cursor clip rect when toggling window borders on macOS c68259944 GPU_d3d12: Switched the default swapchain scaling mode to none. ea513fd47 Fixed vulkan gpu backend android orientation behaviour to just work like on iOS. 87b1c9736 Fix pen generated mouse events not having SDL_PEN_MOUSEID (#12392) a44107540 sysjoystick: don't leak fd on error 9a802797d SDL_pen: fix eraser check 54c7aa9c9 Sync SDL3 wiki -> header 35e8cf8ee render: allow render targets to use logical presentation. 281f0fae1 Include the VID/PID of generic keyboard/mouse devices on Windows d09bf5681 clipboard: Cleanup coding style edaf44767 tests: Add showing/setting the primary selection text to testclipboard 7b9036bea wayland: Don't overwrite clipboard data with the primary selection text f7cadcba8 examples: Use SDL_GetAudioStreamQueued, not SDL_GetAudioStreamAvailable. b3336c5a7 Match style 2b784b5bf Fix SDL_GlobDirectory eb89d0c8c Don't put wired Switch Pro controllers into simple report mode 1ea99bc90 Early out if setting a duplicate window title 56e2955b6 Sync SDL3 wiki -> header cc984c973 Added a mapping for the 8BitDo SN30 Pro+ controller on macOS ba88b6aa0 Fixed reliability of initializing Switch controllers on macOS 66ecdc69a Don't update the report mode until the related hint is set fab52b578 wayland: Ensure that color descriptions are always retrieved 9464aaa8a Change D3D12 GPU backend to respect has_depth_stencil_target cf819ca81 Don't allow further operations on properties while we're destroying them e01257376 Don't fixup mappings for Joy-Con controllers 34c373495 Fixed opening one Joy-Con when the other is visible but disconnected 049a7a04d Wake the main thread for main function dispatch f0f593f04 Embed a description about Wayland clipboard instead of a link bb748ef2d Don't cleanup clipboard in SDL_SendClipboardUpdate on Wayland 38a73a178 Sync SDL3 wiki -> header 85a302550 Set an error message if the rect passed to SDL_RenderReadPixels() is entirely outside the viewport 29df99ee3 Clarified SDL_RenderReadPixels() documentation 2f77558ba fix comment 44f1ec35c GPU: Make Vulkan transfer buffers dedicated allocs 1c2189c7c strings.h isn't available in Windows environments ffdca343f Sync SDL3 wiki -> header ac5fca4ae Clarify the expected usage of SDL_StorageReady() fc365e945 Sync SDL3 wiki -> header ad840e879 Better document that main functionality is in SDL_main.h bb8dcf08e Sync SDL3 wiki -> header 698032531 Added support for the "%n" sscanf format specifier e6a24fcbb fix stbi__parse_png_file() reading too much bytes (thanks @miniupnp!) db4e6c193 Cocoa metal layers need their size updated before renderer updates 0a592b78c Sync SDL3 wiki -> header 58388e8db Add SDL_HINT_JOYSTICK_HAPTIC_AXES db817a37f gpu: Fix forward declaration and inclusion of PrivateGPUDriver a7bc6c5e0 gpu: initialize VkDebugUtilsLabelEXT::color 60b7faa98 gpu: Validate that reserved struct members are unset 2990d142c Map additonal Linux keycodes to SDL scancodes a0086a5cc Add missing scancode names 35544df83 Changed PULSEAUDIO_FlushRecording() to only flush audio present when called. deadfe0c9 Sync SDL3 wiki -> header 0815637cf vulkan build fix ea77472d7 Document/ignore GPU features without universal support ad11c6988 src/io/SDL_asyncio.c:SDL_AsyncIOFromFile(): Fix null-dereference warning 8bfde6755 Remove unnecessary fcitx's devel package dependency in linux doc 52af81ea1 wayland: Fix mapping borderless windows under libdecor 1a0a94b50 x11: Accommodate the borders when setting the initial window position 52e64f816 Use SDL C runtime functions in OpenVR driver 7224b4040 Fix errors when building stb_image with -DSDL_LIBC=OFF 945da099a pipewire: Fix possible deadlock when opening a device 70f657e52 ci: farewell, clang32 on msys2 e50db698e Disable all camera drivers if SDL_CAMERA_DISABLED is defined 1ddba3ad5 Replace "8BitDo Tech Ltd" with "8BitDo" in the manufacturer string fdf72d1e4 Use the keyboard/mouse vendor if available a811e0ef0 Added support for the 8BitDo Micro gamepad bc85c5535 testcontroller: create window with high pixel density 75bbcbf87 Added support for Motion JPEG pipewire camera capture 5c214e5e9 testcamera: SDL_AppQuit destroys state and SDL 03e00cd34 v4l2: map SDL_PIXELFORMAT_MJPG to V4L2_PIX_FMT_MJPEG fcd41c1d2 Check desired window area when checking zoom state b5297de56 Add 'const' to pointer parameters 911e53dec Retain mouse focus as long as we're getting mouse events 3b8cb6228 Make it easier to enable IME debug logs 9a607e886 make start&length represent utf32 indices 9d06145d6 ci: fix type + names of intel compiler artifacts fa380a400 Update include/SDL3/SDL_assert.h 2a1b617fb Update include/SDL3/SDL_assert.h 69e03094b fallback to defining SDL_TriggerBreakpoint as __builtin_trap in older linux arm64 environments that do not have a __has_builtin facility c70f54e28 Remove redundant casts 2e346d716 Added 32-bit texture formats to Texture_GetBlockWidth() and Texture_GetBlockHeight() 5d776c070 Refactored SDL_CreateJoystickName() into a general SDL_CreateDeviceName() 3293eb1a1 use hidapi to get mouse/keyboard string 785584230 ci: disable precompiled headers for classic intel compiler 71d1de5d9 ci: add cppflags to CMAKE_(C|CXX)_FLAGS 28f086794 SPA_FALLTHROUGH expands to nothing when using the Intel compiler 8d3db06ff ci: GitHub is retiring Ubuntu 20.04 support c153f83df ci: enable ccache 52ee0c105 Sync SDL3 wiki -> header 9267930fe Added a fast path for converting the same format and pitch f24f9d3be Revert "testcamera: added support for Motion JPEG camera frames" 2e89c53eb Added support for decoding MJPG into NV12 textures 06602f4e8 Document that the pitch is the length of the image data for SDL_PIXELFORMAT_MJPG a792434a3 Added initial MJPG support using stb_image baf69edfc Revert "cmake: build SDL_uclibc with -fPIC" fdf8e5a70 ci: build static loongarch libraries with -fPIC 9784414dd cmake: build SDL_uclibc with -fPIC b48de48ef wayland: Add support for high-DPI icons 6e0264d38 x11: Use the current or last-requested window position when setting the size hint 1a38960ee Call SDL_DiscardAllCommands() for the software renderer as well 8f4c5e15f Finish any drawing when destroying a software renderer 1a853973a thread/windows: fix stack overflow in exception naming a40b2de94 Fix SDL_emscriptenaudio.c under wasm64 523e6530a SDL_test: fix "'function': different 'const' qualifiers" warning in SDL_test_harness 9e4c657ed wayland: Fix color manager protocol string check 7500a758b Remove usages of `restrict` keyword in SDL_render.c a7f01cd73 x11: Set the pending window position immediately after mapping 1fd626939 Renamed DreamPort to DreamPicoPort 31f9cb480 Unchecked Return Value in WIN_SuspendScreenSaver (#12316) 057c3602e Removing Double-free Issue 5c79f4cae Incorrect bfOffBits Calculation in WIN_ConvertDIBtoBMP 70d23b234 README-migration: Remove errant reference to SDL_FALSE_ 6aef6ae9a AddPulseAudioDevice(): Fix use-after-free 3b4cfc11f wayland: Update copyright dates in added color manager source files fadb261b6 wayland: Add color manager protocol support 6ef687c86 Simplified and fixed media foundation buffer handling de12cb92d Fixed crash at shutdown with new hashtable code a51316890 Fixed Memory/Resource Leaks (#12304) 045a4492f test/testaudio.c: Fix use-after-free warning da2460f9e test/testautomation_audio.c: Free variables before returning 7ea0ffb74 update 06eb10c51 haiku: check if the returned _SDL_GLView is null or not dea99e54f Sync SDL3 wiki -> header 175494359 Fixed camera frame acquisition on Windows 7 e3d9f1172 Remove the reference to the thread when it is detached 831fc7092 test/testautomation_intrinsics.c: Free variables before returning c6a3b5b6e src/test/SDL_test_harness.c: Free variables before returning 84a236c92 hashtable: Redesign the hashtable API. 4a9b57919 joystick: remove dead udev code ba4525694 Sync SDL3 wiki -> header fd4e6d294 Don't render 0 sized texture rectangles 6f3b14a6d audio/video: Fix uninitialized field warnings 5b98c4a52 Fixed motion events with TOOL_TYPE_UNKNOWN 8a648dfd9 emscripten: Fixed unregistering of key event handlers c16b7bcb7 SDL_Get*Driver() functions: Set error message on failure ed0a03e9b Fixed Cursor Icon State for SYSTEM_CURSOR_PROGRESS 5dce8c748 SDL_GetRelativeMouseState(): Get relative mouse position also when relative mouse mode is disabled cedf53bbc Sync SDL3 wiki -> header 3de975884 Document the "trace" log priority b9d018f2a Fixed wayland cursor use-after-free at shutdown 041894a52 Sync SDL3 wiki -> header 3be67ced6 Fix GTK tray icon without menu + lifetime 1354affd2 haiku: Fixed keyboard input. d2b7a8465 Fixed SDL_GetNumGamepadTouchpads() returning 1 for a NULL gamepad ca29304ce Fixed continually resetting keyboard and mouse readings f67c64464 Fixed reporting hat positions for GameInput controllers 1b35ca9c3 Refactored GameInput initialization 706de78a9 audio/video: Skip preferred drivers when loading a driver on demand 715c18739 Added an internal hint "SDL_VIDEO_X11_XINPUT2" for sdl2-compat ce69e9898 Copy SDL2_SYSWMEVENT data into temporary memory for the event 55fd205ba Add missing integer texture formats to SDL_GPUTextureFormatTexelBlockSize (#12151) e6029401d Check for non-NULL icon for trays on Unix b03332b68 updated bytepusher demo to be C++ compatible 5dd249264 updated the snake demo to be C++ compatible 78f816d74 x11: Apply the modifier state from key events 99cf16287 Fixed the name of SDL_SYSWMEVENT 6c3797152 Removed the mapping for the Sanwa Supply JY-P76USV 9b18e8438 [GPU] D3D12 backend debug markers were being cut 0bce19cf1 The 10-bit texture formats have alpha on Direct3D 3cfa476d3 Added support for SDL_PIXELFORMAT_ABGR8888 textures 5ccee7719 testcamera: added support for Motion JPEG camera frames cf41ccc6c Removed stb_image.h from SDL 9308404e9 Removed functions not used by SDL 5e31bbf05 Remove functions not used when STBI_NO_PNG and STBI_NO_HDR are defined 84b0c13c4 Added support for Motion JPEG camera capture 3bc53b9ad wayland: Don't set libdecor frame visibility before the first commit c03258626 wayland: Scale-to-display mode requires both viewports and xdg-output for proper functionality b63d3afc1 Sync SDL3 wiki -> header 0bc1f8712 Added SDL_PROP_SURFACE_HOTSPOT_X_NUMBER and SDL_PROP_SURFACE_HOTSPOT_Y_NUMBER da464e9e5 win32: Keep the window on the last maximized display when leaving fullscreen bf01cc8ce Renamed "Dreamcast Controller Usb" to "DreamPort" ecd089bb6 Don't return short waits from SDL_IOReady() 4fd0b2a85 Fix #12142 - the problem was if the size of the vertex buffer was exceeded, the currentVertexBuffer would be reset to zero and thus we'd leave it pointing to an in-use VB that would get overwritten on the next present before the vkQueueSubmit occurred. f6126e9ea Centered joystick axis values should be 0 d35bef64e pipewire: Ensure that the correct struct is used for enumeration APIs 9bd6d3647 Added SDL_DEPS_SHARED option to control default dynamic loading of shared libraries (#12215) 78721d720 joystick: Fix PS5 player LED hint change callback name 7aba6c4c7 Proper Resource Cleanup in WIN_UpdateWindowShape e29ebb9f1 Update geometry renderer example ca9a044b3 Memory Leak in WIN_CreateHCursor When CreateColorBitmap Fails 69d28027a Fix for 500ms hang after user clicks on the title bar, but before moving (#12217) a0b6c0fd8 x11: Don't wait for events when the connection errored out (#8392) 864bb65ce Removed crc 006605c3b Corrected alphabetical order dc035c5ca Added mapping for Dreamcast Controller USB 5d1bbd9b2 Fix SSE 4.2 test 7c12c63f6 Add generic SDL_syscond to N3DS threads source list 2ced6b09f Delete src/thread/n3ds/SDL_syscond.c 7af17f874 Sync SDL3 wiki -> header 982094c85 Updated to version 3.2.5 for development b5c3eab6b Updated to version 3.2.4 for release 48c00bfe6 Fixed creating a window with both software and hardware renderer attached 3c6e6645f Sync SDL3 wiki -> header ad8429f1b Let the renderer always see window events c59ac249d Revert "wayland: Don't send size events while the window is hidden" 6cb3d37a2 Sync SDL3 wiki -> header 80653a42c Remove non-ASCII character from public header SDL_hints.h a646dc89e Note that SDL_GUIDToString() and SDL_StringToGUID() are thread-safe. 8730f6a56 dynapi: Don't use SDL_getenv; it might malloc before the app sets an allocator. c9341489c Fix #12197: Force set /utf-8 for msvc compilers (#12198) 8397e1fcc Fix up SDL2 style mappings for HIDAPI controllers 7691cabe4 Removed incorrect HIDAPI gamepad mapping 86691d325 GPU: Remove stencil bit from sampler aspect mask on Vulkan (#12196) 6782cfe2c Don't use the HIDAPI driver for Thrustmaster wheels 1c0e2b7f9 SDL_OpenHapticFromJoystick() returns a valid haptic object c4550d906 testcontroller: show the gamepad device type 5ad033768 Sync SDL3 wiki -> header 68dabd48c SDL_GetTrayEntries(): Rename parameter `size` to `count` b99e19c0a Fixed potential double-free 8ba8cca69 Fixed memory leak looking up pen tool names 2cd2834df Fixed memory leak in the pen cleanup c4c185283 dbus: fix spurious leak reports with SDL_SHUTDOWN_DBUS_ON_QUIT=0 691a6133d Remove #undef __3DS__ 33c0654d5 Allow OpenGL initialization on XB1 and XSX. eb5ab2203 Check nullptr before calling the windows message hook for WM_ENTERSIZEMOVE and WM_ENTERMENULOOP e7f326a84 bmp: Removed debug printf call. 61b1c25ee x11: SDL_SetWindowPosition on an unmapped window will do the actual move later. f1b3523c6 Remove redundant parenthesis in SDL_MUSTLOCK macro 8527d042b Remove const from parameter of inline function SDL_RectsEqualEpsilon() 07c22da46 Fixed decoding 4-bit RLE encoded BMP files 8ccf85c59 Formatting spaces around pointer symbol. 94409d350 Added Switch Input-only controller entries for Zuiki MasCon controller for Nintendo Switch. a8a2874ef Added distinct VID/PIDs for the PS4 vs Xbox eSwap Pro controllers 84bc2abda Corrected the entry for the PXN V900 racing wheel eac07bda0 Sort the controller lists by VID/PID 6243a0653 Call the windows message hook for WM_ENTERSIZEMOVE and WM_ENTERMENULOOP ec959a434 Sync SDL3 wiki -> header 8e51b2468 Renamed SDL_SoftStretch() to SDL_StretchSurface() f40ef62a2 Sync SDL3 wiki -> header 614ae843a Sync SDL3 wiki -> header 8848f8656 Corrected the version where SDL_SoftStretch() was added a98a4b8a6 Re-added SDL_SoftStretch() to the API 842f85da0 Sync SDL3 wiki -> header c06172dc1 Track mouse button state by real mouse ID 73a814358 timer, windows: allow building high resolution code with old SDKs. be991239d Updated to version 3.2.3 for development 2fa1e7258 Updated to version 3.2.2 for release c92276279 proposed fix: set curr_src.h is to bottom_height before drawing bottom edges / corners in SDL_RenderTexture9Grid, to avoid issue where inadvertently using top height if the npatch existed on a larger texture than the drawn edge would cause too many pixels to be included in the bottom part of the render. 235022fe2 Fixed error C2059: syntax error: '}' dc13a6ae9 SDL_SaveBMP_IO: Write bitmap header v5 values fe6bd8e9b Sync SDL3 wiki -> header bc3264130 Fixed mouse motion events while the mouse is grabbed 69d361dee Ignore SDL_HINT_RENDER_DRIVER set to software when creating a window surface 70a239210 GPU: Describe "readonly storage" images as sampled images on Vulkan backend (#12149) 4c6d949e6 wayland: make sure the desktop mode is in the fullscreen mode list ab5cb707a Fixed enabling call logging 16f8122a0 Keep the simplest mapping of scancode + modifer for a given keycode 6beda3421 do not build camera drivers if camera support is disabled 0825d07a4 wayland: Don't send size events while the window is hidden 8e766c925 GPU: Resource binding state shadowing (#12138) 43924ec87 Sync SDL3 wiki -> header 8c2682a21 Sync SDL3 wiki -> header e4fcc7b6e gpu/vulkan/SDL_gpu_vulkan.c: fix type redefinition error 14edb21ae check for backslashes as well as the forward slash 50b8c6cdf Sync SDL3 wiki -> header 943c4abcb pipewire: Report correct device default formats instead of hardcoding Float32. 943579a54 Fix inverted pen Y tilt on macOS and add tilt display to example - Negate tilt.y in Cocoa pen handling to correct inverted Y tilt axis - Update drawing example to display X/Y tilt values for visualization - see 0f128fd7c5/src/plugins/platforms/cocoa/qnsview_tablet.mm (L63) - see https://source.chromium.org/chromium/chromium/src/+/main:components/input/web_input_event_builders_mac.mm;drc=0af5ffa1e4cc4cc4f818725f8fee93ec57855e4b;l=421 31364477f Rename parameter of type SDL_CameraID from devid to instance_id 36758d70c Rename parameters of type SDL_AudioDeviceID from dev to devid 2abc7735a Free XIDeviceInfo in X11_MaybeAddPenByDeviceID 8298d60e4 Dynamically load CreateWaitableTimerExW and SetWaitableTimerEx 409f3ade8 Removed SDF test program 4176e188b Enable testgles2 on all platforms cf249b0cb fix -Wformat problem in 32 bit builds 11dbff246 Sync SDL3 wiki -> header ccd5fcef1 audio: Fix potential NULL dereference in AudioStream gain adjustment. 48f555065 wayland: Don't send keyboard and mouse added events during initialization 2a946e91b android: updated release build SDK to match documented requirements 44edbf713 Use templates for the package support files 1c008d8ed Change DBUS introspection timer from INFINITE -> DEFAULT when introspecting available dialog services c21bc48a7 Fix undefined behavior in SDL_windowsmouse.c 1c7cc6028 Skip IsRegularFileOrPipe() check on Emscripten 8f958953f audio: Fix audio stream gain going wrong in certain scenarios. 3b3af7105 audio: Fix a minor code style thing. 725ee7665 Documentation: fixed typos around floats precision 6f098a920 Avoid a crash when a tray without a menu is clicked on Windows. 09f900f66 audio: Remove resampling limits. 5f8e0ebf5 Fixed memory leak at shutdown 913e0a5e5 SDL_migration.cocci: handle more renamed event fields 628130ec8 SDL_migration.cocci: fix incorrect SDL3 API name fa8c0f055 Sync SDL3 wiki -> header 17c4bdd75 Sync SDL3 wiki -> header ad8a09000 Sync SDL3 wiki -> header 8df17c97d GPU: Add notes about shader resource requirements to documentation 303fd5ed5 release: rename resources/cmake -> resources/CMake in dmg fdf33f904 xcode+cmake: Use SDL3.framework/SDL3 as IMPORTED_LOCATION cb3d6dc46 .wikiheaders-options: Removed wikipreamble setting. 84c4ff2f1 Sync SDL3 wiki -> header 2e381a717 Fix possible integer overflow of size + 1 129ebc77b Sync SDL3 wiki -> header a336b62d8 Remove newlines from error messages d0ae09368 x11: Don't force position windows with an undefined position 72a3eae0d Fix buffer overrun in ConvertAudio with different src/dst channel count 983cfe8b1 Remove even more newlines from log messages 718034f5f Remove newlines from log messages 17625e20d Removed redundant step in Visual Studio instructions c806c271c Tweaked emscripten introduction 74536243d Emscripten works well using the normal CMake workflow 98c447802 ci: bump to NetBSD 10.1 a437dbc7e Improve log documentation 1c21a72bd Sync SDL3 wiki -> header 73fc2b03a Copy pen handling code from `SDLSurface` to `SDLControllerManager` 6f3d0b3cd Fixed build when using an older Xcode SDK cb3cc2880 emscripten: pass --no-sandbox to the chrome web driver df3cfbc79 Sync SDL3 wiki -> header 799093799 GPU: Note buffer alignment requirements 5bf077f1f Sync SDL3 wiki -> header 5d6a78045 Sync SDL3 wiki -> header 77b520e93 Updated to version 3.2.1 for development bb3c5b4f3 Fix multiple occurences of typo "an simple" to "a simple" efa6e7aec android: add style to test apk's 535d80bad Include the README and related files in the SDL framework ed2920afe All SDL 3.0 release symbols are at version 3.2.0 7a5604cf0 Sync SDL3 wiki -> headers. 7e130e27b fnsince.pl: Remove prerelease version tapdancing. b775135b4 Removed temporary debug code a52fc209b Updated to version 3.2.0 for release f16c67115 Sync SDL3 wiki -> header 90bda6548 video: Don't let SDL_CreateWindowTexture use the software renderer. c45c4a5e5 render: SDL_HINT_RENDER_DRIVER now accepts a comma-separated list. 670a7d812 Sync SDL3 wiki -> header 8a67896d9 docs: Note the preferred function for getting the content scale of a window 852686856 dialog: cleaned up D-Bus portal implementation 071bebf23 coreaudio: Add a note about why this uses 3 buffers instead of 2. c0a9d220b vulkan: Fixes for swapchain resize crash on X11. ea9880b76 Sync SDL3 wiki -> header bcf7ead6e documentation typo: SFLOAT -> FLOAT 6d5815db5 vulkan: Deal with VK_ERROR_OUT_OF_DATE_KHR returns from vkAcquireNextImageKHR. 6b7dad7d8 vulkan: move temporary pointer to its own field to prevent a bad dereference. 3e530c6db cmake: remove superfluous cmake_minimum_required 7bff36e4b ci: add ubuntu arm job 37140aa9f cmake: expand libunwind abe6d9db9 Automatically detect SDL_main_private.h 10c9fbf41 Use proper polar direction when creating FF_RUMBLE effect c6c746970 Translate conditional effect direction instead of hardcoding it to 0 b476695e6 Call the windows message hook while inside a modal message loop b6d0bc043 coreaudio: Use three buffers for the audioqueue, not two. aa10e51c7 audio: Added some minor missing comments in struct SDL_AudioDevice. 10a5b388d win32: Retain the WS_MAXIMIZEDBOX style while in fullscreen 6449339ae win32: Restore the base size of a window when leaving fullscreen 075c0337c Removed debug print statement a036aeda3 The Vulkan renderer doesn't actually support RGB texture formats 9b454a762 Revert "testautomation: don't validate alpha values on XRGB formats" dcadd23ba render: Prevent division by zero if logical presentation is 0 pixels. adb91fd3d process: Don't use vfork() on Apple platforms. 819628c6b testautomation: Remove Win32 borderless resizable hint 759e01bd6 testautomation: don't validate alpha values on XRGB formats c698c61f0 renderer: initialize the surface colorspace correctly c975f77b0 Update joysticks and so forth during live resize 362f96a6c testcontroller: use SDL_MAIN_USE_CALLBACKS so updates happen during live resizing f8040b2e0 Use UIKeyboardTypeDecimalPad for number fields on iOS 90b2e2527 include: Added a tiny bit to SDL_sensor.h's category documentation. 2be749b23 include: More category documentation. 642262e30 cocoa: Fix mousegrab when going fullscreen. d5766bc4b include: More category documentation. b809da52f assert: Try using __builtin_trap() for SDL_TriggerBreakpoint(). c4c0bfdfb Sync SDL3 wiki -> header 7133969e3 Feature add hint to remap option as alt key (#12021) 53a535029 Sync SDL3 wiki -> header 5f2dd5f04 tray: fixed multi-threading issues with GTk implementation dfdc12026 tray: document thread-safety d4cda5105 tray: renamed SDL_HasNoActiveTrays() to SDL_HasActiveTrays() a974888aa tray: fixed icon colors on Windows 7570ab106 tray: improved error checking b716eeefe testtray: minor cleanup 3afd1e7ea windows: use WIN_UTF8ToStringW() for dialog titles 78023500f Sync SDL3 wiki -> header 34c12d0db include: Add category documentation to SDL_timer.h. b088e8919 Sync SDL3 wiki -> header 0851322fb include: Add category documentation to SDL_power.h. 43b54b3d7 Fix Windows dialog folder titles 32965b4bf pen: Send virtual mouse motion without a button press when a pen is hovering. 5da9d4ecc cocoa: Slightly better display hotplugging detection. 19f42094b Fix Windows fie dialog args freeing 721fc7de0 Correct spacing of pointers ('a* b;' -> 'a *b;') cd269730e Fix Windows dialog memory management 049a8f0e5 Use SDL_calloc() instead of SDL_malloc() 354d2c390 Initialize invalid parent_{tray,entry} to NULL b79ada6aa Windows trays: Fix ParentEntry & Enabling ba95c54f9 macOS: get the correct display name on macOS 10.15+ 42e0fb10f wayland: Set the mouse state before calling the hit test callback cd0db8d35 Added Linux evdev mappings for the Wireless HORIPAD For Steam 1d7a681e4 Revert "emscripten: resizable windows take whole page, resize with browser window." e054f3c08 Sync SDL3 wiki -> header 75317dae5 include: Added category docs for SDL_mouse.h c7d1fd90e Added support for the 8BitDo Ultimate 2C Wireless in Bluetooth mode dbe3baeb0 release: document using the xcframework with CMake ad3c7b92f xcode+cmake: use SDL3.framework folder as IMPORTED_LOCATION 0401b07ee Fixed typo 08e74d29b Fixed typo 923123a52 emscripten: Let SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT accept "#none" c603a9c94 Moved flag documentation 90b7174a7 Respect the SDL_BORDERLESS_RESIZABLE_STYLE hint, but default it to true. 6a72d32d4 emscripten: Let SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT accept "". f3a39074b windows: use WS_THICKFRAME style on borderless windows. 842f6dc40 Fixed wrong type of `phase` (#12014) b95989d14 Fixed sine wave distortion over time. 010f27dc7 storage: enumerate and glob on storage can accept a NULL path. a6a8598b9 storage: deal with paths with Windows '\\' path separators appended. 7c6adc1ca gpu renderer: removed unused sampler slots feeea6a77 Sync SDL3 wiki -> headers. e9f7f11f1 fnsince.pl: Fix script once bump to 3.1.10 exposed a bug. d2fc394a2 Sync SDL3 wiki -> header d317fc9c0 emscripten: resizable windows take whole page, resize with browser window. ee469c6af Sync SDL3 wiki -> header d4d22dd8d GPU: Add remarks about point topology 59ea078ee x11: check to see if displays moved when connected/disconnected 1848ce680 win32: Use the window coordinates to get the monitor when de-minimizing a maximized window 656c519cc Fixed warning C6313: Incorrect operator. Use an equality test to check for zero-valued flags. 9ed96f392 Sync SDL3 wiki -> header ae8df1dcb Note that the primary monitor isn't always at 0,0 4b429b9fa Updated README-platforms.md 616ae9906 Removed README-git.md c2dac95f5 Revert "Add CategoryAPICategory to the complete API index" dd4f5df82 release: support android-X-ext-Y directories cdc5483cf Vita: Fix off-by-one error for synthetic mouse events 07a5c144c Sync SDL3 wiki -> header eb168e410 Updated to version 3.1.11 for development b96bb152c wayland: Don't redundantly set the border state when showing a window 5a564a718 wayland: Add a dummy function for the libdecor dismiss popup callback 9f6eeb109 wayland: Set the border state before the initial configure 274bc95df Sync SDL3 wiki -> header 07f7c4046 Sync SDL3 wiki -> header 22d8e7353 include: filled in category documentation for SDL_messagebox.h. 21a42d2b0 Add CategoryAPICategory to the complete API index 1006236aa ci: add summary to release.yml 326ce9bb8 gpu: D3D12 buildfix for Xbox c95b842b3 video: Xbox does not use CreateIconFromSurface d8e1ad0eb release: skip extended Android SDK versions 7ee2ab383 wayland: Fix return value check from int-to-bool conversion 1dd8fadca Updated to version 3.1.10 for the release candidate 9225a421b Sync SDL3 wiki -> header 3ffb1a8cb storage: generic title storage allows override paths without '/' appended. 874c07f8d storage: Don't allow "." and ".." paths, enforce '/' dir separators. 67664a042 testfilesystem: test some Storage APIs, too. eb793dede filesystem: SDL_GetCurrentDirectory() should add a path separator at the end. 87e1b0eb8 filesystem: SDL_EnumerateDirectory() gives dirs with path seperators appended. e98ee9bb0 Adjust testgl.c to test gl_release_behavior 3424ec948 video: SDL_GL_GetAttribute gets correct SDL_GL_CONTEXT_RELEASE_BEHAVIOR value. 05877f2ce cmake: Add the IoRing async i/o code to the Windows build. 4d63a2b88 io: Renamed src/file to src/io ea642fe9f cocoa: clear mouse focus based on NSEventTypeMouseExited events (#11991) 5f4696ce6 Updating documentation for the 3.2.0 release 2c7b7d1d3 Keep the lifecycle observer active while there are windows active 355f69ebf GPU: Ensure thread safety of Vulkan resource creation c9d602307 cocoa: Only process hit tests on left clicks dd0bdc256 win32: Pass through non-left mouse button presses when over draggable areas 84d35587e filesystem: SDL_SYS_EnumerateDirectory inexplicably takes the same arg twice. fc9b2478d windows: don't set focus click pending if SDL_HINT_MOUSE_FOCUS_CLICKTHROUGH is set 18d21b36f windows: use the initial rect to anchor fixed aspect ratio resizing 199547192 cocoa: fixed resizing windows with fixed aspect ratio 67382e9c8 Fixed detection of function keys on Emscripten 23410debf SDL_GetKeyboardNameForID(): Set an error message for invalid keyboard IDs 8ce176b59 SDL_GetMouseNameForID(): Set an error message for invalid mouse IDs. 51fa076fd Don't send normal keyboard events if no application window has focus a446381ea Tooltips and unfocusable windows can't become main windows ebb24eedc mouse: Clean up virtual touch devices as appropriate. dabc93a63 pen: Send virtual mouse and touch events for pen input. 169c8d514 Fix incorrect hotspot calculation for cursor positioning 8e9c44bc3 Fixed accidental removal of optional delegate interface check 4dd585fb6 coreaudio: convert MPEG channel layout to WAVE channel layout 81e57147f Child windows shouldn't take focus if the parent window is in relative mouse mode 3bea84531 Sync SDL3 wiki -> header 9ed23a4b7 Updated SDL_SetEventFilter() documentation e19a56f4d Don't send fake key events while processing real ones on Android 1ab61635a Use SDL_Log() for keyboard debugging. 29c684c62 Removed debug logging 0eaa6197c Removed unnecessary __builtin_available check ffe194c52 Fixed build when SDL_JOYSTICK_MFI isn't enabled a4547fe77 Updated weak framework dependencies for new deployment targets 49dd24e19 Fixed potentially overlapping memcpy() to use memmove() 191a6417d events: use SDL_memmove instead of SDL_memcpy for overlapping memory bf793bf43 Sync SDL3 wiki -> header 9e60a8994 audio: Allow streams to change the device-side channels maps. b2793a2ce Removed obsolete Raspberry Pi documentation 04e3b6770 Removed outdated Visual Studio instructions a41f93bd1 Added https://github.com/Ravbug/sdl3-sample as a more complete Android example 5ca735b40 Only use WAVE surround sound channel layouts on macOS 10.15+ cdde6dd7b Bumped deployment requirements for Apple platforms 8f8af918b Removed CMakeLists.txt example that says you shouldn't use it 8feb21a1d Updated README-cmake.md with build instructions for several platforms 4294c0683 GPU: Check texture format support in pipeline creation 31dd4fe81 Sync SDL3 wiki -> header 417ed7f35 Fix references in docs 0aa319e4f Added support for custom tray icon on Windows via SDL hints. 581537220 minor update to mingw-w64 build instructions. 5d079c9a2 GPU: Remove bogus property from header docs d590e1f12 GPU: Align D3D12 clear properties to naming convention 7098e525d Sync SDL3 wiki -> header fb6df9338 GPU: Add name properties to resources (#11946) a2b0ddcca Sync SDL3 wiki -> header d28e95322 Added thread safety documentation for SDL_iostream.h f731741ea Sync SDL3 wiki -> header 0eaa8c6d8 Added INTRO-emscripten.md 21b433536 Scale up the text for large displays 6bc7e88ca Added INTRO-androidstudio.md e4e76ac72 Added INTRO-xcode.md 1b30a01b4 Added INTRO-visualstudio.md 191b9d502 Added INTRO-cmake.md 7d2a1c5f8 Mention the tests in INSTALL.md b6b939044 Simplified INSTALL.md 55e094f7a Updated INSTALL.md with simple intro breadcrumbs 584c1d579 Tweaking the README 995a6a033 Minor readability improvement for README-contributing.md 86b46c678 Removed README-git.md 96414fa56 Removed obsolete Raspberry Pi documentation 670db4d24 Made the README links in INSTALL.md markdown links b08d04581 Added a Discord link to BUGS.txt 2ad0f1e1f Updated the credits for SDL 3.0 41d48db4a Removed the runtime README 922b73195 Simplified the README 5e4a2974a Removed obsolete warnings about MIT licensed SIMD code 3766a3940 emscripten: double the audio buffer size. e10e42c81 Sync SDL3 wiki -> header 2b8fb0bdd wikiheaders: Maybe fix perl warning. efaf3739c Sync SDL3 wiki -> header 4bddf521d emscripten: Override emscripten's fullscreen button with SDL's implementation. 569de8490 better numerical precision for playback example e5a4f0936 Call SDL_UDEV_Quit() if we don't end up using it 7d7a76c07 Sync SDL3 wiki -> header 66408308b Added documentation for mouse handling in relative mode 438075a83 Sync SDL3 wiki -> header b4562c024 cocoa: Add a hint to control menu visibility in fullscreen spaces windows 611f132fd Don't use a hint callback for SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY 03a3c19c2 examples: use doubles to generate sine waves and avoid distortion 307e6f2ca emscripten: simulate mouse autocapture. f79083d9b release: don't add test directory to mingw release archives 4ba4f0a10 release: add Android aar to devel zip archive c4f2f7b35 Removed redundant information in example pages 949ec0c50 Sync SDL3 wiki -> header 839227b4b Sync SDL3 wiki -> header c04b739df GPU: Note that resource naming functions are not thread safe. 3df0767e3 gpu: Initialize Metal stencil format even if stencil test is disabled 307dac97a testcontroller.c: fix build errors due to -Wformat after commit b524af1 21cc1878f Reset enhanced mode state when closing a controller b524af1b4 testcontroller: log the ID of gamepads as they are added and removed 9a83fa026 apply multiplier scale after system scale ea859fba3 Sync SDL3 wiki -> header 551510c0e SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE can be combined with SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE 95c158438 README-migration: note SDL2 brightness/gamma ramp APIs that have been removed. f0af6c348 emscripten: Add SDL_EVENT_DISPLAY_ORIENTATION support. 3ad9c38a4 emscripten: Don't set OpenGL swap intervals until first PumpEvents. d42b4ed96 Leave SDL_TriggerBreakpoint undefined on unknown platforms 9a7cfbc2d Add onNativePen to proguard-rules.pro 82125ec1d x11: Be more aggressive about finding _any_ usable messagebox font. 423184879 Revert "Separate android initialization from Activity (#11891)" 61f13b94d add a fallback SDL_TriggerBreakpoint() for MSVC after commit ebaa30d3. d14c93c4b Separate android initialization from Activity (#11891) c64197be1 Sync SDL3 wiki -> header 042898995 Added SDL_ClickTrayEntry() fb0f6a119 cocoa: Display mode changes set Desktop display mode, not current. 38176bfe9 cocoa: Implemented display hotplugging support. 0e2ca934b events: Remove unused function declaration 715897aea Added support for displaying XIM composition strings a8a65b6fc Use XIM for IME input on X11 1f3b40797 Sync SDL3 wiki -> header fb94a79f8 stdinc: define SDL_NOLONGLONG for old Visual Studios, document the symbol. bda90c3cb cmake: rename SDL_DISABLE_* CMake options to SDL_xxx 90aff306c gpu: Show a debug error when pipelines are not given the right shader stages 00b23a012 Sync SDL3 wiki -> header 6b776a998 keyboard: Add some SDL keycodes for common Xkb keys e5966bbdb x11: Add support for Mod3 and more esoteric Xkb configurations 73ee99978 wayland: Add support for Mod3 and more esoteric Xkb configurations ebaa30d33 __debugbreak was introduced in Microsoft Visual Studio 2003 c8f3f1b46 _BitScanReverse was introduced in Microsoft Visual Studio 2005 a78104a47 Disable long long support in the headers with SDL_NOLONGLONG 6cdde10ed gpu: Metal depth write should behave like Vulkan/D3D12 dd0dc64d5 Sync SDL3 wiki -> header c688853a8 Sync SDL3 wiki -> header 507593f48 wikiheaders: Allow symbols to be filtered from manpage generation by regex. 7acf78ba9 storage: Trim the title storage root from enumerated paths 037cd25a2 win32: Use the pending size during NCCALCSIZE e8916b260 pipewire: Use byte order pixel format aliases d2090d1c8 Sync SDL3 wiki -> header 3f7f632e1 audio: Added SDL_AudioDeviceStreamPaused. f61860fa9 testautomation: fixed incorrect test. 4bb3c2a1c render: Some cleanups. 61bdbacda render: SDL_RenderTextureTiled shouldn't try to drop draw calls, either. f044a3d6c Revert "render: GetRenderViewportSize shouldn't use scale, just logical presentation." fa7a52991 render: GetRenderViewportSize shouldn't scale viewport dimensions. 163600951 Sync SDL3 wiki -> header bf8532094 render: Don't try to drop draws outside of the viewport. f2f04e825 tests: Fix get/set window size test being skipped cbdbd66e1 Sync SDL3 wiki -> header ef1fdf11b tray: Create tray icons for libappindicator securely e6bb50a71 Updated to version 3.1.9 for development 6b34c9fe7 Sync SDL3 wiki -> header 22422f774 Fixed ABI compatibility with 3.1.6 d7b10d05b Updated to version 3.1.8 for the preview release 4290fc8bd tray: Load GTK and libappindicator by versioned names, except on OpenBSD 6b38d250a tray: Don't try to use GTK 2 versions of libappindicator bba066c44 tray: Don't call g_object_unref(NULL) 0bc370dfb Android doc cleanup 6934c910b opengl: use GL_UNSIGNED_BYTE instead of GL_UNSIGNED_INT_8_8_8_8_REV. 0176a19ae Fixed platform define condition for Windows phone 0180ca541 windows: Catch WM_POINTERCAPTURECHANGED events. git-subtree-dir: external/SDL git-subtree-split: 90fd2a3cbee5b7ead1f0517d7cc0eba1f3059207
2025-04-15 09:23:03 +02:00
parent 51245fc0c5
commit 28d94e8b86
751 changed files with 60484 additions and 32976 deletions
--- a/docs/INTRO-androidstudio.md
+++ b/docs/INTRO-androidstudio.md
@@ -0,0 +1,17 @@
+
+# Introduction to SDL with Android Studio
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+- Use our handy script to create a template project:
+```sh
+./build-scripts/create-android-project.py org.libsdl.hello docs/hello.c
+```
+- Run Android Studio and open the newly created build/org.libsdl.hello directory
+- Build and run!
+
+A more complete example is available at:
+
+https://github.com/Ravbug/sdl3-sample
+
+Additional information and troubleshooting is available in [README-android.md](README-android.md)
--- a/docs/INTRO-cmake.md
+++ b/docs/INTRO-cmake.md
@@ -0,0 +1,57 @@
+
+# Introduction to SDL with CMake
+
+The easiest way to use SDL is to include it as a subproject in your project.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+# Get a copy of the SDL source:
+```sh
+git clone https://github.com/libsdl-org/SDL.git vendored/SDL
+```
+
+# Create the file CMakeLists.txt
+```cmake
+cmake_minimum_required(VERSION 3.16)
+project(hello)
+
+# set the output directory for built objects.
+# This makes sure that the dynamic library goes into the build directory automatically.
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/$<CONFIGURATION>")
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/$<CONFIGURATION>")
+
+# This assumes the SDL source is available in vendored/SDL
+add_subdirectory(vendored/SDL EXCLUDE_FROM_ALL)
+
+# Create your game executable target as usual
+add_executable(hello WIN32 hello.c)
+
+# Link to the actual SDL3 library.
+target_link_libraries(hello PRIVATE SDL3::SDL3)
+```
+
+# Configure and Build:
+```sh
+cmake -S . -B build
+cmake --build build
+```
+
+# Run:
+The executable should be in the `build` directory:
+
+```sh
+cd build
+./hello
+```
+
+If there wasn't an executable there despite the above Build section running successfully, it's likely because you're following this guide using the Visual Studio toolchain, it should instead be in the `build/Debug` directory:
+```sh
+cd build/Debug
+./hello
+```
+
+A more complete example is available at:
+
+https://github.com/Ravbug/sdl3-sample
+
+Additional information and troubleshooting is available in [README-cmake.md](README-cmake.md)
--- a/docs/INTRO-emscripten.md
+++ b/docs/INTRO-emscripten.md
@@ -0,0 +1,50 @@
+
+# Introduction to SDL with Emscripten
+
+The easiest way to use SDL is to include it as a subproject in your project.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+First, you should have the Emscripten SDK installed from:
+
+https://emscripten.org/docs/getting_started/downloads.html
+
+Create the file CMakeLists.txt
+```cmake
+cmake_minimum_required(VERSION 3.16)
+project(hello)
+
+# set the output directory for built objects.
+# This makes sure that the dynamic library goes into the build directory automatically.
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/$<CONFIGURATION>")
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/$<CONFIGURATION>")
+
+# This assumes the SDL source is available in vendored/SDL
+add_subdirectory(vendored/SDL EXCLUDE_FROM_ALL)
+
+# on Web targets, we need CMake to generate a HTML webpage. 
+if(EMSCRIPTEN)
+  set(CMAKE_EXECUTABLE_SUFFIX ".html" CACHE INTERNAL "")
+endif()
+
+# Create your game executable target as usual
+add_executable(hello WIN32 hello.c)
+
+# Link to the actual SDL3 library.
+target_link_libraries(hello PRIVATE SDL3::SDL3)
+```
+
+Build:
+```sh
+emcmake cmake -S . -B build
+cd build
+emmake make
+```
+
+You can now run your app by pointing a webserver at your build directory and connecting a web browser to it, opening hello.html
+
+A more complete example is available at:
+
+https://github.com/Ravbug/sdl3-sample
+
+Additional information and troubleshooting is available in [README-emscripten.md](README-emscripten.md)
--- a/docs/INTRO-mingw.md
+++ b/docs/INTRO-mingw.md
@@ -0,0 +1,95 @@
+# Introduction to SDL with MinGW
+
+Without getting deep into the history, MinGW is a long running project that aims to bring gcc to Windows. That said, there's many distributions, versions, and forks floating around. We recommend installing [MSYS2](https://www.msys2.org/), as it's the easiest way to get a modern toolchain with a package manager to help with dependency management. This would allow you to follow the MSYS2 section below. 
+
+Otherwise you'll want to follow the "Other Distributions" section below.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c).
+
+# MSYS2
+
+Open the `MSYS2 UCRT64` prompt and then ensure you've installed the following packages. This will get you working toolchain, CMake, Ninja, and of course SDL3.
+
+```sh
+pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-ninja mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-sdl3
+```
+
+## Create the file CMakeLists.txt
+```cmake
+cmake_minimum_required(VERSION 3.26)
+project(hello C CXX)
+
+find_package(SDL3 REQUIRED)
+
+add_executable(hello)
+
+target_sources(hello
+PRIVATE
+    hello.c
+)
+
+target_link_libraries(hello SDL3::SDL3)
+```
+
+## Configure and Build:
+```sh
+cmake -S . -B build
+cmake --build build
+```
+
+## Run:
+
+The executable is in the `build` directory:
+```sh
+cd build
+./hello
+```
+
+# Other Distributions
+
+Things can get quite complicated with other distributions of MinGW. If you can't follow [the cmake intro](INTRO-cmake.md), perhaps due to issues getting cmake to understand your toolchain, this section should work.
+
+## Acquire SDL
+
+Download the `SDL3-devel-<version>-mingw.zip` asset from [the latest release.](https://github.com/libsdl-org/SDL/releases/latest) Then extract it inside your project folder such that the output of `ls SDL3-<version>` looks like `INSTALL.md  LICENSE.txt  Makefile  README.md  cmake  i686-w64-mingw32  x86_64-w64-mingw32`.
+
+## Know your Target Architecture
+
+It is not uncommon for folks to not realize their distribution is targeting 32bit Windows despite things like the name of the toolchain, or the fact that they're running on a 64bit system. We'll ensure we know up front what we need:
+
+Create a file named `arch.c` with the following contents:
+```c
+#include <stddef.h>
+#include <stdio.h>
+int main() {
+    #if defined(__x86_64__) || defined(_M_X64) || defined(i386) || defined(__i386__) || defined(__i386) || defined(_M_IX86)
+        size_t ptr_size = sizeof(int*);
+        if (4 == ptr_size) puts("i686-w64-mingw32");
+        else if (8 == ptr_size) puts("x86_64-w64-mingw32");
+        else puts("Unknown Architecture");
+    #else
+        puts("Unknown Architecture");
+    #endif
+    return 0;
+}
+```
+
+Then run
+
+```sh
+gcc arch.c
+./a.exe
+```
+
+This should print out which library directory we'll need to use when compiling, keep this value in mind, you'll need to use it when compiling in the next section as `<arch>`. If you get "Unknown Architecture" please [report a bug](https://github.com/libsdl-org/SDL/issues).
+
+
+## Build and Run
+
+Now we should have everything needed to compile and run our program. You'll need to ensure to replace `<version>` with the version of the release of SDL3 you downloaded, as well as use the `<arch>` we learned in the previous section.
+
+```sh
+gcc hello.c -o hello.exe -I SDL3-<version>/<arch>/include -L SDL3-<version>/<arch>/lib -lSDL3 -mwindows 
+cp SDL3-<version>/<arch>/bin/SDL3.dll SDL3.dll
+./hello.exe
+```
--- a/docs/INTRO-visualstudio.md
+++ b/docs/INTRO-visualstudio.md
@@ -0,0 +1,16 @@
+
+# Introduction to SDL with Visual Studio
+
+The easiest way to use SDL is to include it as a subproject in your project.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+- Get a copy of the SDL source, you can clone the repo, or download the "Source Code" asset from [the latest release.](https://github.com/libsdl-org/SDL/releases/latest)
+  - If you've downloaded a release, make sure to extract the contents somewhere you can find it.
+- Create a new project in Visual Studio, using the C++ Empty Project template
+- Add hello.c to the Source Files
+- Right click the solution, select add an existing project, navigate to `VisualC/SDL` from within the source you cloned or downloaded above and add SDL.vcxproj
+- Select your main project and go to Project -> Add -> Reference and select SDL3
+- Select your main project and go to Project -> Properties, set the filter at the top to "All Configurations" and "All Platforms", select C/C++ -> General and add the SDL include directory to "Additional Include Directories"
+- Build and run!
+
--- a/docs/INTRO-xcode.md
+++ b/docs/INTRO-xcode.md
@@ -0,0 +1,16 @@
+
+# Introduction to SDL with Xcode
+
+The easiest way to use SDL is to include it as a subproject in your project.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+- Create a new project in Xcode, using the App template and selecting Objective C as the language
+- Remove the .h and .m files that were automatically added to the project
+- Remove the main storyboard that was automatically added to the project
+- On iOS projects, select the project, select the main target, select the Info tab, look for "Custom iOS Target Properties", and remove "Main storyboard base file name" and "Application Scene Manifest"
+- Right click the project and select "Add Files to [project]", navigate to the SDL docs directory and add the file hello.c
+- Right click the project and select "Add Files to [project]", navigate to the SDL Xcode/SDL directory and add SDL.xcodeproj
+- Select the project, select the main target, select the General tab, look for "Frameworks, Libaries, and Embedded Content", and add SDL3.framework
+- Build and run!
+
--- a/docs/README-android.md
+++ b/docs/README-android.md
@@ -37,7 +37,7 @@ dispatches to native functions implemented in the SDL library:
 src/core/android/SDL_android.c


-Building an app
+Building a simple app
 ================================================================================

 For simple projects you can use the script located at build-scripts/create-android-project.py
@@ -67,40 +67,38 @@ Finally, a word of caution: re running create-android-project.py wipes any chang
 done in the build directory for the app!


+Building a more complex app
+================================================================================
+
 For more complex projects, follow these instructions:

-1. Get the source code for SDL and copy the 'android-project' directory located at SDL/android-project to a suitable location. Also make sure to rename it to your project name (In these examples: YOURPROJECT).
+1. Get the source code for SDL and copy the 'android-project' directory located at SDL/android-project to a suitable location in your project.

-   (The 'android-project' directory can basically be seen as a sort of starting point for the android-port of your project. It contains the glue code between the Android Java 'frontend' and the SDL code 'backend'. It also contains some standard behaviour, like how events should be handled, which you will be able to change.)
+   The 'android-project' directory can basically be seen as a sort of starting point for the android-port of your project. It contains the glue code between the Android Java 'frontend' and the SDL code 'backend'. It also contains some standard behaviour, like how events should be handled, which you will be able to change.

-2. Move or [symlink](https://en.wikipedia.org/wiki/Symbolic_link) the SDL directory into the "YOURPROJECT/app/jni" directory
+2. If you are _not_ already building SDL as a part of your project (e.g. via CMake add_subdirectory() or FetchContent) move or [symlink](https://en.wikipedia.org/wiki/Symbolic_link) the SDL directory into the 'android-project/app/jni' directory. Alternatively you can [use the SDL3 Android Archive (.aar)](#using-the-sdl3-android-archive-aar), see bellow for more details.

-(This is needed as the source of SDL has to be compiled by the Android compiler)
+    This is needed as SDL has to be compiled by the Android compiler.

-3. Edit "YOURPROJECT/app/jni/src/Android.mk" to include your source files.
+3. Edit 'android-project/app/build.gradle' to include any assets that your app needs by adding 'assets.srcDirs' in 'sourceSets.main'.

-(They should be separated by spaces after the "LOCAL_SRC_FILES := " declaration)
+    For example: `assets.srcDirs = ['../../assets', '../../shaders']`

-4a. If you want to use Android Studio, simply open your 'YOURPROJECT' directory and start building.
+If using CMake:

-4b. If you want to build manually, run './gradlew installDebug' in the project directory. This compiles the .java, creates an .apk with the native code embedded, and installs it on any connected Android device
+4. Edit 'android-project/app/build.gradle' to set 'buildWithCMake' to true and set 'externalNativeBuild' cmake path to your top level CMakeLists.txt.

+    For example: `path '../../CMakeLists.txt'`

-If you already have a project that uses CMake, the instructions change somewhat:
+5. Change the target containing your main function to be built as a shared library called "main" when compiling for Android. (e.g. add_executable(MyGame main.c) should become add_library(main SHARED main.c) on Android)

-1. Do points 1 and 2 from the instruction above.
-2. Edit "YOURPROJECT/app/build.gradle" to comment out or remove sections containing ndk-build
-   and uncomment the cmake sections. Add arguments to the CMake invocation as needed.
-3. Edit "YOURPROJECT/app/jni/CMakeLists.txt" to include your project (it defaults to
-   adding the "src" subdirectory). Note that you'll have SDL3 and SDL3-static
-   as targets in your project, so you should have "target_link_libraries(yourgame SDL3)"
-   in your CMakeLists.txt file. Also be aware that you should use add_library() instead of
-   add_executable() for the target containing your "main" function.
+If using Android Makefiles:

-If you wish to use Android Studio, you can skip the last step.
+4. Edit 'android-project/app/jni/src/Android.mk' to include your source files. They should be separated by spaces after the 'LOCAL_SRC_FILES := ' declaration.

-4. Run './gradlew installDebug' or './gradlew installRelease' in the project directory. It will build and install your .apk on any
-   connected Android device
+To build your app, run `./gradlew installDebug` or `./gradlew installRelease` in the project directory. It will build and install your .apk on any connected Android device. If you want to use Android Studio, simply open your 'android-project' directory and start building.
+
+Additionally the [SDL_helloworld](https://github.com/libsdl-org/SDL_helloworld) project contains a small example program with a functional Android port that you can use as a reference.

 Here's an explanation of the files in the Android project, so you can customize them:

@@ -151,7 +149,7 @@ target_link_libraries(yourgame PRIVATE SDL3::SDL3)

 If you use ndk-build, add the following before `include $(BUILD_SHARED_LIBRARY)` to your `Android.mk`:
 ```
-LOCAL_SHARED_LIBARARIES := SDL3 SDL3-Headers
+LOCAL_SHARED_LIBRARIES := SDL3 SDL3-Headers
 ```
 And add the following at the bottom:
 ```
@@ -244,7 +242,7 @@ not give you any processing time after the events are delivered.

 e.g.

-    int HandleAppEvents(void *userdata, SDL_Event *event)
+    bool HandleAppEvents(void *userdata, SDL_Event *event)
    {
        switch (event->type)
        {
@@ -252,12 +250,12 @@ e.g.
            /* Terminate the app.
               Shut everything down before returning from this function.
            */
-            return 0;
+            return false;
        case SDL_EVENT_LOW_MEMORY:
            /* You will get this when your app is paused and iOS wants more memory.
               Release as much memory as possible.
            */
-            return 0;
+            return false;
        case SDL_EVENT_WILL_ENTER_BACKGROUND:
            /* Prepare your app to go into the background.  Stop loops, etc.
               This gets called when the user hits the home button, or gets a call.
@@ -266,15 +264,15 @@ e.g.
               in addition, you should set the render target to NULL, if you're using
               it, e.g. call SDL_SetRenderTarget(renderer, NULL).
            */
-            return 0;
+            return false;
        case SDL_EVENT_DID_ENTER_BACKGROUND:
            /* Your app is NOT active at this point. */
-            return 0;
+            return false;
        case SDL_EVENT_WILL_ENTER_FOREGROUND:
            /* This call happens when your app is coming back to the foreground.
               Restore all your state here.
            */
-            return 0;
+            return false;
        case SDL_EVENT_DID_ENTER_FOREGROUND:
            /* Restart your loops here.
               Your app is interactive and getting CPU again.
@@ -285,10 +283,10 @@ e.g.
               event SDL_EVENT_RENDER_DEVICE_RESET and recreate your OpenGL context and
               restore your textures when you get it, or quit the app.
            */
-            return 0;
+            return false;
        default:
            /* No special processing, add it to the event queue */
-            return 1;
+            return true;
        }
    }

--- a/docs/README-bsd.md
+++ b/docs/README-bsd.md
@@ -0,0 +1,6 @@
+# FreeBSD / OpenBSD / NetBSD
+
+SDL is fully supported on BSD platforms, and is built using [CMake](README-cmake.md).
+
+If you want to run on the console, you can take a look at [KMSDRM support on BSD](README-kmsbsd.md)
+
--- a/docs/README-cmake.md
+++ b/docs/README-cmake.md
@@ -2,60 +2,72 @@

 [www.cmake.org](https://www.cmake.org/)

-The CMake build system is supported on the following platforms:
+The CMake build system is supported with the following environments:

-* FreeBSD
-* Linux
-* Microsoft Visual C
-* MinGW and Msys
-* macOS, iOS, tvOS, and visionOS with support for XCode
 * Android
 * Emscripten
-* NetBSD
+* FreeBSD
 * Haiku
+* Linux
+* macOS, iOS, tvOS, and visionOS with support for XCode
+* Microsoft Visual Studio
+* MinGW and Msys
+* NetBSD
 * Nintendo 3DS
 * PlayStation 2
 * PlayStation Portable
 * PlayStation Vita
-* QNX 7.x/8.x
-* RiscOS
+* RISC OS

-## Building SDL
+## Building SDL on Windows

-Assuming the source tree of SDL is located at `~/sdl`,
-this will configure and build SDL in the `~/build` directory:
+Assuming you're in the SDL source directory, building and installing to C:/SDL can be done with:
 ```sh
-cmake -S ~/sdl -B ~/build
-cmake --build ~/build
+cmake -S . -B build
+cmake --build build --config RelWithDebInfo
+cmake --install build --config RelWithDebInfo --prefix C:/SDL
 ```

-Installation can be done using:
+## Building SDL on UNIX
+
+SDL will build with very few dependencies, but for full functionality you should install the packages detailed in [README-linux.md](README-linux.md).
+
+Assuming you're in the SDL source directory, building and installing to /usr/local can be done with:
 ```sh
-cmake --install ~/build --prefix /usr/local        # '--install' requires CMake 3.15, or newer
+cmake -S . -B build
+cmake --build build
+sudo cmake --install build --prefix /usr/local
 ```

-This will install SDL to /usr/local.
+## Building SDL on macOS

-### Building SDL tests
+Assuming you're in the SDL source directory, building and installing to ~/SDL can be done with:
+```sh
+cmake -S . -B build -DSDL_FRAMEWORK=ON -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64"
+cmake --build build
+cmake --install build --prefix ~/SDL
+```
+
+## Building SDL tests

 You can build the SDL test programs by adding `-DSDL_TESTS=ON` to the first cmake command above:
 ```sh
-cmake -S ~/sdl -B ~/build -DSDL_TEST_LIBRARY=ON -DSDL_TESTS=ON
+cmake -S . -B build -DSDL_TESTS=ON
 ```
-and then building normally. In this example, the test programs will be built and can be run from `~/build/tests/`.
+and then building normally. The test programs will be built and can be run from `build/test/`.

-### Building SDL examples
+## Building SDL examples

 You can build the SDL example programs by adding `-DSDL_EXAMPLES=ON` to the first cmake command above:
 ```sh
-cmake -S ~/sdl -B ~/build -DSDL_EXAMPLES=ON
+cmake -S . -B build -DSDL_EXAMPLES=ON
 ```
-and then building normally. In this example, the example programs will be built and can be run from `~/build/examples/`.
+and then building normally. The example programs will be built and can be run from `build/examples/`.

 ## Including SDL in your project

 SDL can be included in your project in 2 major ways:
- using a system SDL library, provided by your (*nix) distribution or a package manager
+- using a system SDL library, provided by your (UNIX) distribution or a package manager
 - using a vendored SDL library: this is SDL copied or symlinked in a subfolder.

 The following CMake script supports both, depending on the value of `MYGAME_VENDORED`.
@@ -131,6 +143,13 @@ Exceptions exist:
 - some platforms don't support dynamic libraries, so only `-DSDL_STATIC=ON` makes sense.
 - a static Apple framework is not supported

+### Man pages
+
+Configuring with `-DSDL_INSTALL_DOCS=TRUE` installs man pages.
+
+We recommend package managers of unix distributions to install SDL3's man pages.
+This adds an extra build-time dependency on Perl.
+
 ### Pass custom compile options to the compiler

 - Use [`CMAKE_<LANG>_FLAGS`](https://cmake.org/cmake/help/latest/variable/CMAKE_LANG_FLAGS.html) to pass extra
@@ -174,7 +193,7 @@ Only shared frameworks are supported, no static ones.

 #### Platforms

-Use `-DCMAKE_PLATFORM_NAME=<value>` to configure the platform. CMake can target only one platform at a time.
+Use `-DCMAKE_SYSTEM_NAME=<value>` to configure the platform. CMake can target only one platform at a time.

 | Apple platform  | `CMAKE_SYSTEM_NAME` value |
 |-----------------|---------------------------|
@@ -310,7 +329,7 @@ Configure your project with `-DSDL_LIBC=ON` to make use of sanitizers.

 Install the required system packages prior to running CMake.
 See [README-linux](linux#build-dependencies) for the list of dependencies on Linux.
-Other unix operationg systems should provide similar packages.
+Other unix operating systems should provide similar packages.

 If you **really** don't need to show windows, add `-DSDL_UNIX_CONSOLE_BUILD=ON` to the CMake configure command.

@@ -343,114 +362,3 @@ However, by default CMake builds static libraries as non-relocatable.
 Configuring SDL with `-DCMAKE_POSITION_INDEPENDENT_CODE=ON` will result in a static `libSDL3.a` library
 which you can link against to create a shared library.

-## Help, it doesn't work!
-
-Below, a SDL3 CMake project can be found that builds 99.9% of time (assuming you have internet connectivity).
-When you have a problem with building or using SDL, please modify it until it reproduces your issue.
-
-```cmake
-cmake_minimum_required(VERSION 3.16)
-project(sdl_issue)
-
-# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-# !!!!!!                                                                            !!!!!!
-# !!!!!!     This CMake script is not using "CMake best practices".                 !!!!!!
-# !!!!!!                 Don't use it in your project.                              !!!!!!
-# !!!!!!                                                                            !!!!!!
-# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-
-# 1. Try system SDL3 package first
-find_package(SDL3 QUIET)
-if(SDL3_FOUND)
-    message(STATUS "Using SDL3 via find_package")
-endif()
-
-# 2. Try using a vendored SDL library
-if(NOT SDL3_FOUND AND EXISTS "${CMAKE_CURRENT_LIST_DIR}/SDL/CMakeLists.txt")
-    add_subdirectory(SDL EXCLUDE_FROM_ALL)
-    message(STATUS "Using SDL3 via add_subdirectory")
-    set(SDL3_FOUND TRUE)
-endif()
-
-# 3. Download SDL, and use that.
-if(NOT SDL3_FOUND)
-    include(FetchContent)
-    set(SDL_SHARED TRUE CACHE BOOL "Build a SDL shared library (if available)")
-    set(SDL_STATIC TRUE CACHE BOOL "Build a SDL static library (if available)")
-    FetchContent_Declare(
-        SDL
-        GIT_REPOSITORY https://github.com/libsdl-org/SDL.git
-        GIT_TAG main  # Replace this with a particular git tag or git hash
-        GIT_SHALLOW TRUE
-        GIT_PROGRESS TRUE
-    )
-    message(STATUS "Using SDL3 via FetchContent")
-    FetchContent_MakeAvailable(SDL)
-    set_property(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/_deps/sdl-src" PROPERTY EXCLUDE_FROM_ALL TRUE)
-endif()
-
-file(WRITE main.c [===========================================[
-/**
- * Modify this source such that it reproduces your problem.
- */
-
-/* START of source modifications */
-
-#include <SDL3/SDL.h>
-/*
- * SDL3/SDL_main.h is explicitly not included such that a terminal window would appear on Windows.
- */
-
-int main(int argc, char *argv[]) {
-    (void)argc;
-    (void)argv;
-
-    if (!SDL_Init(SDL_INIT_VIDEO)) {
-        SDL_Log("SDL_Init failed (%s)", SDL_GetError());
-        return 1;
-    }
-
-    SDL_Window *window = NULL;
-    SDL_Renderer *renderer = NULL;
-
-    if (!SDL_CreateWindowAndRenderer("SDL issue", 640, 480, 0, &window, &renderer)) {
-        SDL_Log("SDL_CreateWindowAndRenderer failed (%s)", SDL_GetError());
-        SDL_Quit();
-        return 1;
-    }
-
-    while (1) {
-        int finished = 0;
-        SDL_Event event;
-        while (SDL_PollEvent(&event)) {
-            if (event.type == SDL_EVENT_QUIT) {
-                finished = 1;
-                break;
-            }
-        }
-        if (finished) {
-            break;
-        }
-
-        SDL_SetRenderDrawColor(renderer, 80, 80, 80, SDL_ALPHA_OPAQUE);
-        SDL_RenderClear(renderer);
-        SDL_RenderPresent(renderer);
-    }
-
-    SDL_DestroyRenderer(renderer);
-    SDL_DestroyWindow(window);
-
-    SDL_Quit();
-    return 0;
-}
-
-/* END of source modifications */
-
-]===========================================])
-
-add_executable(sdl_issue main.c)
-
-target_link_libraries(sdl_issue PRIVATE SDL3::SDL3)
-# target_link_libraries(sdl_issue PRIVATE SDL3::SDL3-shared)
-# target_link_libraries(sdl_issue PRIVATE SDL3::SDL3-static)
-```
--- a/docs/README-contributing.md
+++ b/docs/README-contributing.md
@@ -57,7 +57,7 @@ If you had already forked the repository, you may update it from the web page us

 Code formatting is done using a custom `.clang-format` file, you can learn more about how to run it [here](https://clang.llvm.org/docs/ClangFormat.html).

-Some legacy code may not be formatted, as such avoid formatting the whole file at once and only format around your changes.
+Some legacy code may not be formatted, so please avoid formatting the whole file at once and only format around your changes.

 For your commit message to be properly displayed on GitHub, it should contain:

--- a/docs/README-documentation-rules.md
+++ b/docs/README-documentation-rules.md
@@ -156,6 +156,23 @@ wikiheaders will wordwrap header comments so they fit in 80 columns, so if you
 don't leave a blank line between paragraphs, they will smush into a single
 block of text when wordwrapping.

+## Lists must be the start of a new paragraph.
+
+If you write this:
+
+```
+Here is some text without a blank line
+before an unordered list!
+- item a
+- item b
+- item c
+```
+
+...then wikiheaders will word wrap this as a single paragraph, mangling the list.
+
+Put a blank line before the list, and everything will format and wrap correctly.
+
+This is a limitation of wikiheaders. Don't get bit by it!

 ## Don't worry about word wrapping.

@@ -304,6 +321,11 @@ to the headers:
 - "Version"
 - "See Also"

+## Unrecognized sections are removed from the headers!
+
+If you add Doxygen with a `##` (`###`, etc) section header, it'll
+migrate to the wiki and be _removed_ from the headers. Generally
+the correct thing to do is _never use section headers in the Doxygen_.

 ## It's okay to repeat yourself.

--- a/docs/README-emscripten.md
+++ b/docs/README-emscripten.md
@@ -239,13 +239,13 @@ If you want to build with thread support, something like this works:
 ```bash
 mkdir build
 cd build
-emcmake cmake -DSDL_THREADS=On ..
+emcmake cmake -DSDL_THREADS=ON ..
 # you can also do `emcmake cmake -G Ninja ..` and then use `ninja` instead of this command.
 emmake make -j4
 ```

-To build the tests, add `-DSDL_TESTS=On` to the `emcmake cmake` command line.
-To build the examples, add `-DSDL_EXAMPLES=On` to the `emcmake cmake` command line.
+To build the tests, add `-DSDL_TESTS=ON` to the `emcmake cmake` command line.
+To build the examples, add `-DSDL_EXAMPLES=ON` to the `emcmake cmake` command line.


 ## Building your app
--- a/docs/README-git.md
+++ b/docs/README-git.md
@@ -1,16 +0,0 @@
-git
-=========
-
-The latest development version of SDL is available via git.
-Git allows you to get up-to-the-minute fixes and enhancements;
-as a developer works on a source tree, you can use "git" to mirror that
-source tree instead of waiting for an official release. Please look
-at the Git website ( https://git-scm.com/ ) for more
-information on using git, where you can also download software for
-macOS, Windows, and Unix systems.
-
-    git clone https://github.com/libsdl-org/SDL
-
-There is a web interface to the Git repository at:
-	http://github.com/libsdl-org/SDL/
-
--- a/docs/README-haiku.md
+++ b/docs/README-haiku.md
@@ -0,0 +1,4 @@
+# Haiku OS
+
+SDL is fully supported on Haiku OS, and is built using [CMake](README-cmake.md).
+
--- a/docs/README-highdpi.md
+++ b/docs/README-highdpi.md
@@ -1,32 +1,6 @@

 SDL 3.0 has new support for high DPI displays. Interfaces provided by SDL uses the platform's native coordinates unless otherwise specified.

-To reconcile platform differences in their approach to high-density scaling, SDL provides the following interfaces:
- `SDL_GetWindowSize()`          retrieves the window dimensions in native coordinates.
- `SDL_GetWindowSizeInPixels()`  retrieves the window dimensions in pixels-addressable.
- `SDL_GetDisplayContentScale()` retrieves the suggested amplification factor when drawing in native coordinates.
- `SDL_GetWindowDisplayScale()`  retrieves the suggested amplification factor when drawing in pixels-addressable.
- `SDL_GetWindowPixelDensity()`  retrieves how many addressable pixels correspond to one unit of native coordinates.
- `SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED`    is emitted when the value retrievable from `SDL_GetWindowSizeInPixels()` changes.
- `SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED` is emitted when the value retrievable from `SDL_GetWindowDisplayScale()` changes.
- Windows created with `SDL_WINDOW_HIGH_PIXEL_DENSITY` will ask the platform to display addressable pixels at their natural scale.
-
-## Numeric example
-
-Given a fullscreen window spanning a 3840x2160 monitor set to 2x display or 200% scaling, the following tabulates the effect of creating a window with or without `SDL_WINDOW_HIGH_PIXEL_DENSITY` on MacOS and Win32:
-
-| Value                          | MacOS (Default) | MacOS (HD) | Win32 (Default & HD) |
-|--------------------------------|-----------------|------------|----------------------|
-| `SDL_GetWindowSize()`          | 1920x1080       | 1920x1080  | 3840x2160            |
-| `SDL_GetWindowSizeInPixels()`  | 1920x1080       | 3840x2160  | 3840x2160            |
-| `SDL_GetDisplayContentScale()` | 1.0             | 1.0        | 2.0                  |
-| `SDL_GetWindowDisplayScale()`  | 1.0             | 2.0        | 2.0                  |
-| `SDL_GetWindowPixelDensity()`  | 1.0             | 2.0        | 1.0                  |
-
-Observe the philosophical difference between the approaches taken by MacOS and Win32:
- Win32 coordinate system always deals in physical device pixels, high DPI support is achieved by providing an advisory hint for the developer to enlarge drawn objects. Ignoring the advisory scale factor results in graphics appearing tiny.
- MacOS coordinate system always deals in physical content sizes, high DPI support is achieved by providing an optional flag for the developer to request finer granularity. Omitting the granularity request results in graphics appearing coarse.
-
 ## Explanation

 Displays now have a content display scale, which is the expected scale for content based on the DPI settings of the display. For example, a 4K display might have a 2.0 (200%) display scale, which means that the user expects UI elements to be twice as big on this display, to aid in readability. You can query the display content scale using `SDL_GetDisplayContentScale()`, and when this changes you get an `SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED` event.
@@ -34,3 +8,33 @@ Displays now have a content display scale, which is the expected scale for conte
 The window size is now distinct from the window pixel size, and the ratio between the two is the window pixel density. If the window is created with the `SDL_WINDOW_HIGH_PIXEL_DENSITY` flag, SDL will try to match the native pixel density for the display, otherwise it will try to have the pixel size match the window size. You can query the window pixel density using `SDL_GetWindowPixelDensity()`. You can query the window pixel size using `SDL_GetWindowSizeInPixels()`, and when this changes you get an `SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED` event. You are guaranteed to get a `SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED` event when a window is created and resized, and you can use this event to create and resize your graphics context for the window.

 The window has a display scale, which is the scale from the pixel resolution to the desired content size, e.g. the combination of the pixel density and the content scale. For example, a 3840x2160 window displayed at 200% on Windows, and a 1920x1080 window with the high density flag on a 2x display on macOS will both have a pixel size of 3840x2160 and a display scale of 2.0.  You can query the window display scale using `SDL_GetWindowDisplayScale()`, and when this changes you get an `SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED` event.
+
+## Numeric example
+
+Given a window spanning a 3840x2160 monitor set to 2x display or 200% scaling, the following tabulates the effect of creating a window with or without `SDL_WINDOW_HIGH_PIXEL_DENSITY` on macOS and Windows:
+
+| Value                          | macOS (Default) | macOS (HD) | Windows (Default & HD) |
+|--------------------------------|-----------------|------------|------------------------|
+| `SDL_GetWindowSize()`          | 1920x1080       | 1920x1080  | 3840x2160              |
+| `SDL_GetWindowSizeInPixels()`  | 1920x1080       | 3840x2160  | 3840x2160              |
+| `SDL_GetDisplayContentScale()` | 1.0             | 1.0        | 2.0                    |
+| `SDL_GetWindowDisplayScale()`  | 1.0             | 2.0        | 2.0                    |
+| `SDL_GetWindowPixelDensity()`  | 1.0             | 2.0        | 1.0                    |
+
+Observe the difference between the approaches taken by macOS and Windows:
+- The Windows and Android coordinate system always deals in physical device pixels, high DPI support is achieved by providing a content scale that tells the developer to draw objects larger. Ignoring this scale factor results in graphics appearing tiny.
+- The macOS and iOS coordinate system always deals in window coordinates, high DPI support is achieved by providing an optional flag for the developer to request more pixels. Omitting this flag results in graphics having low detail.
+- On Linux, X11 uses a similar approach to Windows and Wayland uses a similar approach to macOS.
+
+## Solution
+
+Proper high DPI support takes into account both the content scale and the pixel density.
+
+First, you'd create your window with the `SDL_WINDOW_HIGH_PIXEL_DENSITY` flag, assuming you want the highest detail possible. Then you'd get the window display scale to see how much your UI elements should be enlarged to be readable.
+
+If you're using the SDL 2D renderer, SDL provides the function `SDL_ConvertEventToRenderCoordinates()` to convert mouse coordinates between window coordinates and rendering coordinates, and the more general functions `SDL_RenderCoordinatesFromWindow()` and `SDL_RenderCoordinatesToWindow()` to do other conversion between them.
+
+If you're not using the 2D renderer, you can implement this yourself using `SDL_GetWindowPixelDensity()` as scale factor to convert from window coordinates to pixels.
+
+Finally you'll want to test on both Windows and macOS if possible to make sure your high DPI support works in all environments.
+
--- a/docs/README-ios.md
+++ b/docs/README-ios.md
@@ -1,10 +1,10 @@
 iOS
 ======

-Building the Simple DirectMedia Layer for iOS 9.0+
+Building the Simple DirectMedia Layer for iOS 11.0+
 ==============================================================================

-Requirements: macOS 10.9 or later and the iOS 9.0 or newer SDK.
+Please note that building SDL requires at least Xcode 12.2 and the iOS 14.2 SDK.

 Instructions:

@@ -65,7 +65,7 @@ not give you any processing time after the events are delivered.

 e.g.

-    int HandleAppEvents(void *userdata, SDL_Event *event)
+    bool HandleAppEvents(void *userdata, SDL_Event *event)
    {
        switch (event->type)
        {
@@ -73,37 +73,37 @@ e.g.
            /* Terminate the app.
               Shut everything down before returning from this function.
            */
-            return 0;
+            return false;
        case SDL_EVENT_LOW_MEMORY:
            /* You will get this when your app is paused and iOS wants more memory.
               Release as much memory as possible.
            */
-            return 0;
+            return false;
        case SDL_EVENT_WILL_ENTER_BACKGROUND:
            /* Prepare your app to go into the background.  Stop loops, etc.
               This gets called when the user hits the home button, or gets a call.
            */
-            return 0;
+            return false;
        case SDL_EVENT_DID_ENTER_BACKGROUND:
            /* This will get called if the user accepted whatever sent your app to the background.
               If the user got a phone call and canceled it, you'll instead get an SDL_EVENT_DID_ENTER_FOREGROUND event and restart your loops.
               When you get this, you have 5 seconds to save all your state or the app will be terminated.
               Your app is NOT active at this point.
            */
-            return 0;
+            return false;
        case SDL_EVENT_WILL_ENTER_FOREGROUND:
            /* This call happens when your app is coming back to the foreground.
               Restore all your state here.
            */
-            return 0;
+            return false;
        case SDL_EVENT_DID_ENTER_FOREGROUND:
            /* Restart your loops here.
               Your app is interactive and getting CPU again.
            */
-            return 0;
+            return false;
        default:
            /* No special processing, add it to the event queue */
-            return 1;
+            return true;
        }
    }

@@ -185,9 +185,6 @@ Windows:
 Textures:
 	The optimal texture formats on iOS are SDL_PIXELFORMAT_ABGR8888, SDL_PIXELFORMAT_ABGR8888, SDL_PIXELFORMAT_XBGR8888, and SDL_PIXELFORMAT_RGB24 pixel formats.

-Loading Shared Objects:
-	This is disabled by default since it seems to break the terms of the iOS SDK agreement for iOS versions prior to iOS 8. It can be re-enabled in SDL_config_ios.h.
-

 Notes -- CoreBluetooth.framework
 ==============================================================================
@@ -249,7 +246,7 @@ Note that if you are using main callbacks instead of a standard C main() functio
 Deploying to older versions of iOS
 ==============================================================================

-SDL supports deploying to older versions of iOS than are supported by the latest version of Xcode, all the way back to iOS 8.0
+SDL supports deploying to older versions of iOS than are supported by the latest version of Xcode, all the way back to iOS 11.0

 In order to do that you need to download an older version of Xcode:
 https://developer.apple.com/download/more/?name=Xcode
--- a/docs/README-linux.md
+++ b/docs/README-linux.md
@@ -17,9 +17,9 @@ Ubuntu 18.04, all available features enabled:
    sudo apt-get install build-essential git make \
    pkg-config cmake ninja-build gnome-desktop-testing libasound2-dev libpulse-dev \
    libaudio-dev libjack-dev libsndio-dev libx11-dev libxext-dev \
-    libxrandr-dev libxcursor-dev libxfixes-dev libxi-dev libxss-dev \
+    libxrandr-dev libxcursor-dev libxfixes-dev libxi-dev libxss-dev libxtst-dev \
    libxkbcommon-dev libdrm-dev libgbm-dev libgl1-mesa-dev libgles2-mesa-dev \
-    libegl1-mesa-dev libdbus-1-dev libibus-1.0-dev libudev-dev fcitx-libs-dev
+    libegl1-mesa-dev libdbus-1-dev libibus-1.0-dev libudev-dev

 Ubuntu 22.04+ can also add `libpipewire-0.3-dev libwayland-dev libdecor-0-dev liburing-dev` to that command line.

@@ -28,7 +28,7 @@ Fedora 35, all available features enabled:
    sudo yum install gcc git-core make cmake \
    alsa-lib-devel pulseaudio-libs-devel nas-devel pipewire-devel \
    libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXfixes-devel \
-    libXi-devel libXScrnSaver-devel dbus-devel ibus-devel fcitx-devel \
+    libXi-devel libXScrnSaver-devel dbus-devel ibus-devel \
    systemd-devel mesa-libGL-devel libxkbcommon-devel mesa-libGLES-devel \
    mesa-libEGL-devel vulkan-devel wayland-devel wayland-protocols-devel \
    libdrm-devel mesa-libgbm-devel libusb-devel libdecor-devel \
@@ -45,6 +45,10 @@ openSUSE Tumbleweed:
    sudo zypper in libunwind-devel libusb-1_0-devel Mesa-libGL-devel libxkbcommon-devel libdrm-devel \
    libgbm-devel pipewire-devel libpulse-devel sndio-devel Mesa-libEGL-devel

+Arch:
+    sudo pacman -S alsa-lib cmake hidapi ibus jack libdecor libgl libpulse libusb libx11 libxcursor libxext libxinerama libxkbcommon libxrandr libxrender libxss libxtst mesa ninja pipewire sndio vulkan-driver vulkan-headers wayland wayland-protocols
+
+
 Joystick does not work
 --------------------------------------------------------------------------------

--- a/docs/README-macos.md
+++ b/docs/README-macos.md
@@ -13,7 +13,7 @@ To build SDL using the command line, use the CMake build script:
 ```bash
 mkdir build
 cd build
-cmake .. -DCMAKE_OSX_DEPLOYMENT_TARGET=10.11
+cmake .. -DCMAKE_OSX_DEPLOYMENT_TARGET=10.13
 cmake --build .
 sudo cmake --install .
 ```
@@ -25,15 +25,12 @@ You can also build SDL as a Universal library (a single binary for both
 ```bash
 mkdir build
 cd build
-cmake .. "-DCMAKE_OSX_ARCHITECTURES=arm64;x86_64" -DCMAKE_OSX_DEPLOYMENT_TARGET=10.11
+cmake .. "-DCMAKE_OSX_ARCHITECTURES=arm64;x86_64" -DCMAKE_OSX_DEPLOYMENT_TARGET=10.13
 cmake --build .
 sudo cmake --install .
 ```

-Please note that building SDL requires at least Xcode 12.2 and the 11.0 SDK.
-PowerPC support for macOS has been officially dropped as of SDL 2.0.2.
-32-bit Intel and macOS 10.8 runtime support has been officially dropped as
-of SDL 2.24.0.
+Please note that building SDL requires at least Xcode 12.2 and the macOS 11.0 SDK.

 To use the library once it's built, you essential have two possibilities:
 use the traditional autoconf/automake/make method, or use Xcode.
--- a/docs/README-migration.md
+++ b/docs/README-migration.md
@@ -193,7 +193,7 @@ Rather than iterating over audio devices using a device index, there are new fun
        if (devices) {
            for (i = 0; i < num_devices; ++i) {
                SDL_AudioDeviceID instance_id = devices[i];
-                SDL_Log("AudioDevice %" SDL_PRIu32 ": %s\n", instance_id, SDL_GetAudioDeviceName(instance_id));
+                SDL_Log("AudioDevice %" SDL_PRIu32 ": %s", instance_id, SDL_GetAudioDeviceName(instance_id));
            }
            SDL_free(devices);
        }
@@ -411,7 +411,7 @@ The iscapture field of SDL_AudioDeviceEvent has been renamed recording.

 SDL_QUERY, SDL_IGNORE, SDL_ENABLE, and SDL_DISABLE have been removed. You can use the functions SDL_SetEventEnabled() and SDL_EventEnabled() to set and query event processing state.

-SDL_AddEventWatch() now returns SDL_FALSE_ if it fails because it ran out of memory and couldn't add the event watch callback.
+SDL_AddEventWatch() now returns false if it fails because it ran out of memory and couldn't add the event watch callback.

 SDL_RegisterEvents() now returns 0 if it couldn't allocate any user events.

@@ -749,7 +749,7 @@ Rather than iterating over haptic devices using device index, there is a new fun
        if (haptics) {
            for (i = 0; i < num_haptics; ++i) {
                SDL_HapticID instance_id = haptics[i];
-                SDL_Log("Haptic %" SDL_PRIu32 ": %s\n", instance_id, SDL_GetHapticNameForID(instance_id));
+                SDL_Log("Haptic %" SDL_PRIu32 ": %s", instance_id, SDL_GetHapticNameForID(instance_id));
            }
            SDL_free(haptics);
        }
@@ -917,7 +917,7 @@ Rather than iterating over joysticks using device index, there is a new function
                const char *name = SDL_GetJoystickNameForID(instance_id);
                const char *path = SDL_GetJoystickPathForID(instance_id);

-                SDL_Log("Joystick %" SDL_PRIu32 ": %s%s%s VID 0x%.4x, PID 0x%.4x\n",
+                SDL_Log("Joystick %" SDL_PRIu32 ": %s%s%s VID 0x%.4x, PID 0x%.4x",
                        instance_id, name ? name : "Unknown", path ? ", " : "", path ? path : "", SDL_GetJoystickVendorForID(instance_id), SDL_GetJoystickProductForID(instance_id));
            }
            SDL_free(joysticks);
@@ -1031,6 +1031,9 @@ The following structures have been removed:

 SDL_Keycode is now Uint32 and the SDLK_* constants are now defines instead of an enum, to more clearly reflect that they are a subset of the possible values of an SDL_Keycode.

+In addition to the `SDLK_SCANCODE_MASK` bit found on key codes that directly map to scancodes, there is now the
+`SDLK_EXTENDED_MASK` bit used to denote key codes that don't have a corresponding scancode, and aren't a unicode value.
+
 The following symbols have been removed:

 * KMOD_RESERVED - No replacement. A bit named "RESERVED" probably shouldn't be used in an app, but if you need it, this was equivalent to KMOD_SCROLL (0x8000) in SDL2.
@@ -1262,6 +1265,7 @@ The following symbols have been renamed:
 The following functions have been removed:
 * SDL_FreeFormat()
 * SDL_SetPixelFormatPalette()
+* SDL_CalculateGammaRamp()

 The following macros have been removed:
 * SDL_Colour - use SDL_Color instead
@@ -1455,7 +1459,7 @@ The following symbols have been removed:
 * SDL_RENDERER_PRESENTVSYNC - replaced with SDL_PROP_RENDERER_CREATE_PRESENT_VSYNC_NUMBER during renderer creation and SDL_PROP_RENDERER_VSYNC_NUMBER after renderer creation
 * SDL_RENDERER_SOFTWARE - you can check whether the name of the renderer is `SDL_SOFTWARE_RENDERER`
 * SDL_RENDERER_TARGETTEXTURE - all renderers support target texture functionality
-* SDL_ScaleModeBest = use SDL_SCALEMODE_LINEAR instead
+* SDL_ScaleModeBest - use SDL_SCALEMODE_LINEAR instead

 ## SDL_rwops.h

@@ -1692,7 +1696,7 @@ Rather than iterating over sensors using device index, there is a new function S
        SDL_SensorID *sensors = SDL_GetSensors(&num_sensors);
        if (sensors) {
            for (i = 0; i < num_sensors; ++i) {
-                SDL_Log("Sensor %" SDL_PRIu32 ": %s, type %d, platform type %d\n",
+                SDL_Log("Sensor %" SDL_PRIu32 ": %s, type %d, platform type %d",
                        sensors[i],
                        SDL_GetSensorNameForID(sensors[i]),
                        SDL_GetSensorTypeForID(sensors[i]),
@@ -1841,8 +1845,6 @@ SDL_BlitSurface() and SDL_BlitSurfaceScaled() now have a const `dstrect` paramet

 SDL_BlitSurfaceScaled() and SDL_BlitSurfaceUncheckedScaled() now take a scale parameter.

-SDL_SoftStretch() now takes a scale parameter.
-
 SDL_PixelFormat is used instead of Uint32 for API functions that refer to pixel format by enumerated value.

 SDL_SetSurfaceColorKey() takes an bool to enable and disable colorkey. RLE acceleration isn't controlled by the parameter, you should use SDL_SetSurfaceRLE() to change that separately.
@@ -1876,8 +1878,8 @@ The following functions have been removed:
 * SDL_GetYUVConversionMode()
 * SDL_GetYUVConversionModeForResolution()
 * SDL_SetYUVConversionMode() - use SDL_SetSurfaceColorspace() to set the surface colorspace and SDL_PROP_TEXTURE_CREATE_COLORSPACE_NUMBER with SDL_CreateTextureWithProperties() to set the texture colorspace. The default colorspace for YUV pixel formats is SDL_COLORSPACE_JPEG.
-* SDL_SoftStretch() - use SDL_BlitSurfaceScaled() with SDL_SCALEMODE_NEAREST
-* SDL_SoftStretchLinear() - use SDL_BlitSurfaceScaled() with SDL_SCALEMODE_LINEAR
+* SDL_SoftStretch() - use SDL_StretchSurface() with SDL_SCALEMODE_NEAREST
+* SDL_SoftStretchLinear() - use SDL_StretchSurface() with SDL_SCALEMODE_LINEAR

 The following symbols have been renamed:
 * SDL_PREALLOC => SDL_SURFACE_PREALLOCATED
@@ -2117,7 +2119,7 @@ Rather than iterating over displays using display index, there is a new function
                SDL_DisplayID instance_id = displays[i];
                const char *name = SDL_GetDisplayName(instance_id);

-                SDL_Log("Display %" SDL_PRIu32 ": %s\n", instance_id, name ? name : "Unknown");
+                SDL_Log("Display %" SDL_PRIu32 ": %s", instance_id, name ? name : "Unknown");
            }
            SDL_free(displays);
        }
@@ -2163,7 +2165,7 @@ Rather than iterating over display modes using an index, there is a new function
    if (modes) {
        for (i = 0; i < num_modes; ++i) {
            SDL_DisplayMode *mode = modes[i];
-            SDL_Log("Display %" SDL_PRIu32 " mode %d: %dx%d@%gx %gHz\n",
+            SDL_Log("Display %" SDL_PRIu32 " mode %d: %dx%d@%gx %gHz",
                    display, i, mode->w, mode->h, mode->pixel_density, mode->refresh_rate);
        }
        SDL_free(modes);
@@ -2177,7 +2179,7 @@ Windows now have an explicit fullscreen mode that is set, using SDL_SetWindowFul

 SDL_WINDOW_FULLSCREEN_DESKTOP has been removed, and you can call SDL_GetWindowFullscreenMode() to see whether an exclusive fullscreen mode will be used or the borderless fullscreen desktop mode will be used when the window is fullscreen.

-SDL_SetWindowBrightness and SDL_SetWindowGammaRamp have been removed from the API, because they interact poorly with modern operating systems and aren't able to limit their effects to the SDL window.
+SDL_SetWindowBrightness(), SDL_GetWindowBrightness, SDL_SetWindowGammaRamp(), and SDL_GetWindowGammaRamp have been removed from the API, because they interact poorly with modern operating systems and aren't able to limit their effects to the SDL window.

 Programs which have access to shaders can implement more robust versions of those functions using custom shader code rendered as a post-process effect.

@@ -2221,6 +2223,10 @@ The following functions have been removed:
 * SDL_CreateWindowFrom() - use SDL_CreateWindowWithProperties() with the properties that allow you to wrap an existing window
 * SDL_SetWindowInputFocus() - use SDL_RaiseWindow() instead
 * SDL_SetWindowModalFor() - use SDL_SetWindowParent() with SDL_SetWindowModal() instead
+* SDL_SetWindowBrightness() - use a shader or other in-game effect.
+* SDL_GetWindowBrightness() - use a shader or other in-game effect.
+* SDL_SetWindowGammaRamp() - use a shader or other in-game effect.
+* SDL_GetWindowGammaRamp() - use a shader or other in-game effect.

 The SDL_Window id type is named SDL_WindowID

--- a/docs/README-platforms.md
+++ b/docs/README-platforms.md
@@ -1,8 +1,40 @@
-Platforms
-=========
+# Platforms

-We maintain the list of supported platforms on our wiki now, and how to
-build and install SDL for those platforms:
+## Supported Platforms

-    https://wiki.libsdl.org/Installation
+- [Android](README-android.md)
+- [Emscripten](README-emscripten.md)
+- [FreeBSD](README-bsd.md)
+- [Haiku OS](README-haiku.md)
+- [iOS](README-ios.md)
+- [Linux](README-linux.md)
+- [macOS](README-macos.md)
+- [NetBSD](README-bsd.md)
+- [Nintendo Switch](README-switch.md)
+- [Nintendo 3DS](README-3ds.md)
+- [OpenBSD](README-bsd.md)
+- [PlayStation 2](README-ps2.md)
+- [PlayStation 4](README-ps4.md)
+- [PlayStation 5](README-ps5.md)
+- [PlayStation Portable](README-psp.md)
+- [PlayStation Vita](README-vita.md)
+- [RISC OS](README-riscos.md)
+- [SteamOS](README-steamos.md)
+- [tvOS](README-ios.md)
+- [Windows](README-windows.md)
+- [Windows GDK](README-gdk.md)
+- [Xbox](README-gdk.md)

+## Unsupported Platforms
+
+If your favorite system is listed below, we aren't working on it. However, if you send reasonable patches and are willing to support the port in the long term, we are happy to take a look!
+
+All of these still work with [SDL2](/SDL2), which is an incompatible API, but an option if you need to support these platforms still.
+
+- Google Stadia
+- NaCL
+- Nokia N-Gage
+- OS/2
+- QNX
+- WinPhone
+- WinRT/UWP
--- a/docs/README-ps4.md
+++ b/docs/README-ps4.md
@@ -0,0 +1,3 @@
+# Sony PlayStation 4
+
+SDL3 runs on the PS4! There are commercial games shipping with this port. This port is kept in a separate repository, but is available for free, under the zlib license, to anyone that is under NDA for PlayStation development with Sony. Please contact Ryan (icculus at icculus dot org) for details.
--- a/docs/README-ps5.md
+++ b/docs/README-ps5.md
@@ -0,0 +1,3 @@
+# Sony PlayStation 5
+
+SDL3 runs on the PS5! There are commercial games shipping with this port. This port is kept in a separate repository, but is available for free, under the zlib license, to anyone that is under NDA for PlayStation development with Sony. Please contact Ryan (icculus at icculus dot org) for details.
--- a/docs/README-psp.md
+++ b/docs/README-psp.md
@@ -1,13 +1,13 @@
 PSP
 ======
 SDL port for the Sony PSP contributed by:
- Captian Lex
+- Captain Lex
 - Francisco Javier Trujillo Mata
 - Wouter Wijsman


 Credit to
-   Marcus R.Brown,Jim Paris,Matthew H for the original SDL 1.2 for PSP
+   Marcus R.Brown, Jim Paris, Matthew H for the original SDL 1.2 for PSP
   Geecko for his PSP GU lib "Glib2d"

 ## Building
@@ -29,7 +29,7 @@ cmake --install build


 ## Compiling a HelloWorld
-[PSP Hello World](https://psp-dev.org/doku.php?id=tutorial:hello_world)
+[PSP Hello World](https://pspdev.github.io/basic_programs.html#hello-world)

 ## To Do
 - PSP Screen Keyboard
--- a/docs/README-raspberrypi.md
+++ b/docs/README-raspberrypi.md
@@ -1,188 +0,0 @@
-Raspberry Pi
-============
-
-Requirements:
-
-Raspberry Pi OS (other Linux distros may work as well).
-
-In modern times, the Raspberry Pi works mostly like any other Linux device:
-for video, you can use X11, Wayland, or KMSDRM. For audio, you can use ALSA,
-PulseAudio, or PipeWire, etc. OpenGL, OpenGL ES, and Vulkan are known to work.
-
-There is a video backend in SDL called "rpi" that uses a deprecated Broadcom
-interface (named "dispmanx") to draw directly to the console without X11.
-Newer Raspberry Pi OS releases don't support this (and work fine with our
-"kmsdrm" backend for the same purposes, a standard Linux interface). Don't
-panic if you can't use this backend, or CMake says it can't find libraries it
-needs for this.
-
-SDL has, in past times, worked on the original Raspberry Pi and the RPi 2, but
-these devices are no longer targets we actively test; if they broke, please
-report bugs or send patches!
-
-The Raspberry Pi 3 and later (in 32-bit and 64-bit mode) are still known to
-work well at the time of this writing. The Raspberry Pi Zero and Zero 2 are
-also known to work well.
-
-
-## Documentation Out Of Date
-
-The rest of this document is likely out of date; a lot has changed in recent
-years in both SDL and the Raspberry Pi universe, and this document has not
-been updated to reflect those details. Take the rest of this information with
-a grain of salt!
-
-
-
-NEON
----
-
-If your Pi has NEON support, make sure you add -mfpu=neon to your CFLAGS so
-that SDL will select some otherwise-disabled highly-optimized code. The
-original Pi and Pi Zero units don't have NEON; everything from the Pi2/PiZero2
-and later do.
-
-
-Cross compiling from x86 Linux
------------------------------
-
-To cross compile SDL for Raspbian from your desktop machine, you'll need a
-Raspbian system root and the cross compilation tools. We'll assume these tools
-will be placed in /opt/rpi-tools
-
-    sudo git clone --depth 1 https://github.com/raspberrypi/tools /opt/rpi-tools
-
-You'll also need a Raspbian binary image.
-Get it from: http://downloads.raspberrypi.org/raspbian_latest
-After unzipping, you'll get file with a name like: "<date>-wheezy-raspbian.img"
-Let's assume the sysroot will be built in /opt/rpi-sysroot.
-
-    export SYSROOT=/opt/rpi-sysroot
-    sudo kpartx -a -v <path_to_raspbian_image>.img
-    sudo mount -o loop /dev/mapper/loop0p2 /mnt
-    sudo cp -r /mnt $SYSROOT
-    sudo apt-get install qemu binfmt-support qemu-user-static
-    sudo cp /usr/bin/qemu-arm-static $SYSROOT/usr/bin
-    sudo mount --bind /dev $SYSROOT/dev
-    sudo mount --bind /proc $SYSROOT/proc
-    sudo mount --bind /sys $SYSROOT/sys
-
-Now, before chrooting into the ARM sysroot, you'll need to apply a workaround,
-edit $SYSROOT/etc/ld.so.preload and comment out all lines in it.
-
-    sudo chroot $SYSROOT
-    apt-get install libudev-dev libasound2-dev libdbus-1-dev libraspberrypi0 libraspberrypi-bin libraspberrypi-dev libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev libxss-dev
-    exit
-    sudo umount $SYSROOT/dev
-    sudo umount $SYSROOT/proc
-    sudo umount $SYSROOT/sys
-    sudo umount /mnt
-
-There's one more fix required, as the libdl.so symlink uses an absolute path
-which doesn't quite work in our setup.
-
-    sudo rm -rf $SYSROOT/usr/lib/arm-linux-gnueabihf/libdl.so
-    sudo ln -s ../../../lib/arm-linux-gnueabihf/libdl.so.2 $SYSROOT/usr/lib/arm-linux-gnueabihf/libdl.so
-
-The final step is compiling SDL itself.
-
-    export CC="/opt/rpi-tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian/bin/arm-linux-gnueabihf-gcc --sysroot=$SYSROOT -I$SYSROOT/opt/vc/include -I$SYSROOT/usr/include -I$SYSROOT/opt/vc/include/interface/vcos/pthreads -I$SYSROOT/opt/vc/include/interface/vmcs_host/linux"
-    cd <SDL SOURCE>
-    mkdir -p build;cd build
-    LDFLAGS="-L$SYSROOT/opt/vc/lib" ../configure --with-sysroot=$SYSROOT --host=arm-raspberry-linux-gnueabihf --prefix=$PWD/rpi-sdl3-installed --disable-pulseaudio --disable-esd
-    make
-    make install
-
-To be able to deploy this to /usr/local in the Raspbian system you need to fix up a few paths:
-
-    perl -w -pi -e "s#$PWD/rpi-sdl3-installed#/usr/local#g;" ./rpi-sdl3-installed/lib/libSDL3.la ./rpi-sdl3-installed/lib/pkgconfig/sdl3.pc
-
-Apps don't work or poor video/audio performance
-----------------------------------------------
-
-If you get sound problems, buffer underruns, etc, run "sudo rpi-update" to
-update the RPi's firmware. Note that doing so will fix these problems, but it
-will also render the CMA - Dynamic Memory Split functionality useless.
-
-Also, by default the Raspbian distro configures the GPU RAM at 64MB, this is too
-low in general, specially if a 1080p TV is hooked up.
-
-See here how to configure this setting: http://elinux.org/RPiconfig
-
-Using a fixed gpu_mem=128 is the best option (specially if you updated the
-firmware, using CMA probably won't work, at least it's the current case).
-
-No input
--------
-
-Make sure you belong to the "input" group.
-
-    sudo usermod -aG input `whoami`
-
-No HDMI Audio
-------------
-
-If you notice that ALSA works but there's no audio over HDMI, try adding:
-
-    hdmi_drive=2
-
-to your config.txt file and reboot.
-
-Reference: http://www.raspberrypi.org/phpBB3/viewtopic.php?t=5062
-
-Text Input API support
----------------------
-
-The Text Input API is supported, with translation of scan codes done via the
-kernel symbol tables. For this to work, SDL needs access to a valid console.
-If you notice there's no SDL_EVENT_TEXT_INPUT message being emitted, double check that
-your app has read access to one of the following:
-
-* /proc/self/fd/0
-* /dev/tty
-* /dev/tty[0...6]
-* /dev/vc/0
-* /dev/console
-
-This is usually not a problem if you run from the physical terminal (as opposed
-to running from a pseudo terminal, such as via SSH). If running from a PTS, a
-quick workaround is to run your app as root or add yourself to the tty group,
-then re-login to the system.
-
-    sudo usermod -aG tty `whoami`
-
-The keyboard layout used by SDL is the same as the one the kernel uses.
-To configure the layout on Raspbian:
-
-    sudo dpkg-reconfigure keyboard-configuration
-
-To configure the locale, which controls which keys are interpreted as letters,
-this determining the CAPS LOCK behavior:
-
-    sudo dpkg-reconfigure locales
-
-
-OpenGL problems
---------------
-
-If you have desktop OpenGL headers installed at build time in your RPi or cross
-compilation environment, support for it will be built in. However, the chipset
-does not actually have support for it, which causes issues in certain SDL apps
-since the presence of OpenGL support supersedes the ES/ES2 variants.
-The workaround is to disable OpenGL at configuration time:
-
-    ./configure --disable-video-opengl
-
-Or if the application uses the Render functions, you can use the SDL_RENDER_DRIVER
-environment variable:
-
-    export SDL_RENDER_DRIVER=opengles2
-
-Notes
-----
-
-* When launching apps remotely (via SSH), SDL can prevent local keystrokes from
-  leaking into the console only if it has root privileges. Launching apps locally
-  does not suffer from this issue.
-
-
--- a/docs/README-steamos.md
+++ b/docs/README-steamos.md
@@ -0,0 +1,10 @@
+# SteamOS
+
+SteamOS is literally a Linux system, and uses the same binaries you distribute to generic Linux Steam users, so generally speaking, all the other [Linux advice](README-linux.md) applies.
+
+If you are shipping a Linux game on Steam, or explicitly targeting SteamOS, the system is guaranteed to provide SDL. The Steam Client will set up the dynamic loader path so that a known-good copy of SDL is available to any program that needs it before launching a game. Steam provides all major versions of SDL to date, in this manner, for both x86 and amd64, in addition to several add-on libraries like `SDL_image` and `SDL_mixer`. When shipping a Linux game on Steam, do not ship a build of SDL with your game. Link against SDL as normal, and expect it to be available on the player's system. This allows Valve to make fixes and improvements to their SDL and those fixes to flow on to your game.
+
+We are obsessive about SDL3 having a backwards-compatible ABI. Whether you build your game using the Steam Runtime SDK or just about any other copy of SDL, it _should_ work with the one that ships with Steam.
+
+In fact, it's not a bad idea to just copy the SDL build out of the Steam Runtime if you plan to ship a Linux game for non-Steam platforms, too, since you know it's definitely well-built.
+
--- a/docs/README-switch.md
+++ b/docs/README-switch.md
@@ -0,0 +1,3 @@
+# Nintendo Switch
+
+SDL3 runs on the Nintendo Switch! There are commercial games shipping with this port. This port is kept in a separate repository, but is available for free, under the zlib license, to anyone that is under NDA for Switch development with Nintendo. Please contact Ryan (icculus at icculus dot org) for details.
--- a/docs/README-versions.md
+++ b/docs/README-versions.md
@@ -1,60 +1,48 @@
 # Versioning

-## Since 2.23.0
+## Since 3.2.0

 SDL follows an "odd/even" versioning policy, similar to GLib, GTK, Flatpak
 and older versions of the Linux kernel:

-* The major version (first part) increases when backwards compatibility
-    is broken, which will happen infrequently.
-
-* If the minor version (second part) is divisible by 2
-    (for example 2.24.x, 2.26.x), this indicates a version of SDL that
-    is believed to be stable and suitable for production use.
+* If the minor version (second part) and the patch version (third part) is
+    divisible by 2 (for example 3.2.6, 3.4.0), this indicates a version of
+    SDL that is believed to be stable and suitable for production use.

    * In stable releases, the patchlevel or micro version (third part)
-        indicates bugfix releases. Bugfix releases should not add or
-        remove ABI, so the ".0" release (for example 2.24.0) should be
-        forwards-compatible with all the bugfix releases from the
-        same cycle (for example 2.24.1).
+        indicates bugfix releases. Bugfix releases may add small changes
+        to the ABI, so newer patch versions are backwards-compatible but
+        not fully forwards-compatible. For example, programs built against
+        SDL 3.2.0 should work fine with SDL 3.2.8, but programs built against
+        SDL 3.2.8 may not work with 3.2.0.

-    * The minor version increases when new API or ABI is added, or when
-        other significant changes are made. Newer minor versions are
-        backwards-compatible, but not fully forwards-compatible.
-        For example, programs built against SDL 2.24.x should work fine
-        with SDL 2.26.x, but programs built against SDL 2.26.x will not
-        necessarily work with 2.24.x.
+    * The minor version increases when significant changes are made that
+        require longer development or testing time, e.g. major new functionality,
+        or revamping support for a platform. Newer minor versions are
+        backwards-compatible, but not fully forwards-compatible. For example,
+        programs built against SDL 3.2.x should work fine with SDL 3.4.x,
+        but programs built against SDL 3.4.x may not work with 3.2.x.

-* If the minor version (second part) is not divisible by 2
-    (for example 2.23.x, 2.25.x), this indicates a development prerelease
-    of SDL that is not suitable for stable software distributions.
+* If the minor version (second part) or patch version (third part) is not
+    divisible by 2 (for example 3.2.9, 3.3.x), this indicates a development
+    prerelease of SDL that is not suitable for stable software distributions.
    Use with caution.

-    * The patchlevel or micro version (third part) increases with
-        each prerelease.
-
-    * Each prerelease might add new API and/or ABI.
+    * The patchlevel or micro version (third part) increases with each prerelease.

    * Prereleases are backwards-compatible with older stable branches.
-        For example, 2.25.x will be backwards-compatible with 2.24.x.
+        For example, programs built against SDL 3.2.x should work fine with
+        SDL 3.3.x, but programs built against SDL 3.3.x may not work with 3.2.x.

-    * Prereleases are not guaranteed to be backwards-compatible with
-        each other. For example, new API or ABI added in 2.25.1
-        might be removed or changed in 2.25.2.
-        If this would be a problem for you, please do not use prereleases.
+    * Prereleases are not guaranteed to be backwards-compatible with each other.
+        For example, new API or ABI added in 3.3.0 might be removed or changed in
+        3.3.1. If this would be a problem for you, please do not use prereleases.

-    * Only upgrade to a prerelease if you can guarantee that you will
-        promptly upgrade to the stable release that follows it.
-        For example, do not upgrade to 2.23.x unless you will be able to
-        upgrade to 2.24.0 when it becomes available.
+    * Only use a prerelease if you can guarantee that you will promptly upgrade
+        to the stable release that follows it. For example, do not use 3.3.x
+        unless you will be able to upgrade to 3.4.0 when it becomes available.

    * Software distributions that have a freeze policy (in particular Linux
        distributions with a release cycle, such as Debian and Fedora)
-        should usually only package stable releases, and not prereleases.
+        should only package stable releases, and not prereleases.

-## Before 2.23.0
-
-Older versions of SDL followed a similar policy, but instead of the
-odd/even rule applying to the minor version, it applied to the patchlevel
-(micro version, third part). For example, 2.0.22 was a stable release
-and 2.0.21 was a prerelease.
--- a/docs/README-visualc.md
+++ b/docs/README-visualc.md
@@ -1,113 +0,0 @@
-Using SDL with Microsoft Visual C++
-===================================
-
-#### by Lion Kimbro with additions by James Turk
-
-You can either use the precompiled libraries from the [SDL](https://www.libsdl.org/download.php) web site, or you can build SDL
-yourself.
-
-### Building SDL
-
-0. To build SDL, your machine must, at a minimum, have the DirectX9.0c SDK installed. It may or may not be retrievable from
-the [Microsoft](https://www.microsoft.com) website, so you might need to locate it [online](https://duckduckgo.com/?q=directx9.0c+sdk+download&t=h_&ia=web).
-_Editor's note: I've been able to successfully build SDL using Visual Studio 2019 **without** the DX9.0c SDK_
-
-1. Open the Visual Studio solution file at `./VisualC/SDL.sln`.
-
-2. Your IDE will likely prompt you to upgrade this solution file to whatever later version of the IDE you're using. In the `Retarget Projects` dialog,
-all of the affected project files should be checked allowing you to use the latest `Windows SDK Version` you have installed, along with
-the `Platform Toolset`.
-
-If you choose *NOT* to upgrade to use the latest `Windows SDK Version` or `Platform Toolset`, then you'll need the `Visual Studio 2010 Platform Toolset`.
-
-3. Build the `.dll` and `.lib` files by right clicking on each project in turn (Projects are listed in the _Workspace_
-panel in the _FileView_ tab), and selecting `Build`.
-
-You may get a few warnings, but you should not get any errors.
-
-Later, we will refer to the following `.lib` and `.dll` files that have just been generated:
-
-   `./VisualC/Win32/Debug/SDL3.dll` or `./VisualC/Win32/Release/SDL3.dll`
-   `./VisualC/Win32/Debug/SDL3.lib` or `./VisualC/Win32/Release/SDL3.lib`
-
-_Note for the `x64` versions, just replace `Win32` in the path with `x64`_
-
-### Creating a Project with SDL
-
- Create a project as a `Win32 Application`.
-
- Create a C++ file for your project.
-
- Set the C runtime to `Multi-threaded DLL` in the menu:
-  `Project|Settings|C/C++ tab|Code Generation|Runtime Library `.
-
- Add the SDL `include` directory to your list of includes in the menu:
-  `Project|Settings|C/C++ tab|Preprocessor|Additional include directories `
-
-*VC7 Specific: Instead of doing this, I find it easier to add the
-include and library directories to the list that VC7 keeps. Do this by
-selecting Tools|Options|Projects|VC++ Directories and under the "Show
-Directories For:" dropbox select "Include Files", and click the "New
-Directory Icon" and add the [SDLROOT]\\include directory (e.g. If you
-installed to c:\\SDL\\ add c:\\SDL\\include). Proceed to change the
-dropbox selection to "Library Files" and add [SDLROOT]\\lib.*
-
-The "include directory" I am referring to is the `./include` folder.
-
-Now we're going to use the files that we had created earlier in the *Build SDL* step.
-
-Copy the following file into your Project directory:
-
-   `SDL3.dll`
-
-Add the following file to your project (It is not necessary to copy it to your project directory):
-
-   `SDL3.lib`
-
-To add them to your project, right click on your project, and select
-`Add files to project`.
-
-**Instead of adding the files to your project, it is more desirable to add them to the linker options: Project|Properties|Linker|Command Line
-and type the names of the libraries to link with in the "Additional Options:" box. Note: This must be done for each build configuration
-(e.g. Release,Debug).**
-
-### Hello SDL
-
-Here's a sample SDL snippet to verify everything is setup in your IDE:
-
-```c
-#include <SDL3/SDL.h>
-#include <SDL3/SDL_main.h> // only include this one in the source file with main()!
-
-int main( int argc, char* argv[] )
-{
-	const int WIDTH = 640;
-	const int HEIGHT = 480;
-	SDL_Window* window = NULL;
-	SDL_Renderer* renderer = NULL;
-
-	SDL_Init(SDL_INIT_VIDEO);
-	window = SDL_CreateWindow("Hello SDL", WIDTH, HEIGHT, 0);
-	renderer = SDL_CreateRenderer(window, NULL);
-
-	SDL_DestroyRenderer(renderer);
-	SDL_DestroyWindow(window);
-	SDL_Quit();
-	return 0;
-}
-```
-
-### That's it!
-
-I hope that this document has helped you get through the most difficult part of using the SDL: installing it.
-Suggestions for improvements should be posted to the [Github Issues](https://github.com/libsdl-org/SDL/issues).
-
-### Credits
-
-Thanks to [Paulus Esterhazy](mailto:pesterhazy@gmx.net), for the work on VC++ port.
-
-This document was originally called "VisualC.txt", and was written by [Sam Lantinga](mailto:slouken@libsdl.org).
-
-Later, it was converted to HTML and expanded into the document that you see today by [Lion Kimbro](mailto:snowlion@sprynet.com).
-
-Minor Fixes and Visual C++ 7 Information (in italic) was added by [James Turk](mailto:james@conceptofzero.net)
--- a/docs/README-vita.md
+++ b/docs/README-vita.md
@@ -10,10 +10,10 @@ Credit to
 Building
 --------
 To build for the PSVita, make sure you have vitasdk and cmake installed and run:
-```
-   cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=${VITASDK}/share/vita.toolchain.cmake -DCMAKE_BUILD_TYPE=Release
-   cmake --build build
-   cmake --install build
+```sh
+cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=${VITASDK}/share/vita.toolchain.cmake -DCMAKE_BUILD_TYPE=Release
+cmake --build build
+cmake --install build
 ```


--- a/docs/README-wayland.md
+++ b/docs/README-wayland.md
@@ -59,6 +59,10 @@ encounter limitations or behavior that is different from other windowing systems
  `SDL_APP_ID` hint string, the desktop entry file name should match the application ID. For example, if your
  application ID is set to `org.my_org.sdl_app`, the desktop entry file should be named `org.my_org.sdl_app.desktop`.

+### Keyboard grabs don't work when running under XWayland
+
+- On GNOME based desktops, the dconf setting `org/gnome/mutter/wayland/xwayland-allow-grabs` must be enabled.
+
 ## Using custom Wayland windowing protocols with SDL windows

 Under normal operation, an `SDL_Window` corresponds to an XDG toplevel window, which provides a standard desktop window.
--- a/docs/README-windows.md
+++ b/docs/README-windows.md
@@ -18,7 +18,9 @@ Details are here: https://github.com/libsdl-org/SDL/issues/5186

 ## MinGW-w64 compiler support

-SDL can be built with MinGW-w64 and CMake. First, you need to install and set up the MSYS2 environment, which provides the MinGW-w64 toolchain. Install MSYS2, typically to `C:\msys64`, and follow the instructions on the MSYS2 wiki to use the MinGW-w64 shell to update all components in the MSYS2 environment. This generally amounts to running `pacman -Syuu` from the mingw64 shell, but refer to MSYS2's documentation for more details. Once the MSYS2 environment has been updated, install the x86_64 MinGW toolchain from the mingw64 shell with the command `pacman -S mingw-w64-x86_64-toolchain`. (You can additionally install `mingw-w64-i686-toolchain` if you intend to build 32-bit binaries as well. The remainder of this section assumes you only want to build 64-bit binaries.)
+SDL can be built with MinGW-w64 and CMake. Minimum tested MinGW-w64 version is 8.0.3.
+
+On a Windows host, you first need to install and set up the MSYS2 environment, which provides the MinGW-w64 toolchain. Install MSYS2, typically to `C:\msys64`, and follow the instructions on the MSYS2 wiki to use the MinGW-w64 shell to update all components in the MSYS2 environment. This generally amounts to running `pacman -Syuu` from the mingw64 shell, but refer to MSYS2's documentation for more details. Once the MSYS2 environment has been updated, install the x86_64 MinGW toolchain from the mingw64 shell with the command `pacman -S mingw-w64-x86_64-toolchain`. (You can additionally install `mingw-w64-i686-toolchain` if you intend to build 32-bit binaries as well. The remainder of this section assumes you only want to build 64-bit binaries.)

 To build and install SDL, you can use PowerShell or any CMake-compatible IDE. First, install CMake, Ninja, and Git. These tools can be installed using any number of tools, such as the MSYS2's `pacman`, `winget`, `Chocolatey`, or by manually downloading and running the installers. Clone SDL to an appropriate location with `git` and run the following commands from the root of the cloned repository:

--- a/docs/README.md
+++ b/docs/README.md
@@ -7,8 +7,7 @@ to provide low level access to audio, keyboard, mouse, joystick, and graphics
 hardware. It is used by video playback software, emulators, and popular games
 including Valve's award winning catalog and many Humble Bundle games.

-SDL officially supports Windows, macOS, Linux, iOS, and Android.
-Support for other platforms may be found in the source code.
+SDL officially supports Windows, macOS, Linux, iOS, Android, Xbox, PlayStation 4/5, Nintendo Switch, and many other platforms.

 SDL is written in C, works natively with C++, and there are bindings 
 available for several other languages, including C# and Python.
@@ -19,36 +18,19 @@ in the file "LICENSE.txt".
 Information on building SDL with CMake is available in [README-cmake.md](README-cmake.md)

 The best way to learn how to use SDL is to check out the header files in
-the "include" subdirectory and the programs in the "test" subdirectory.
+the "include" subdirectory and the programs in the "examples" subdirectory.
 The header files and test programs are well commented and always up to date.

 Information on reporting bugs and contributing is available in [README-contributing.md](README-contributing.md)

-More documentation and FAQs are available online at [the wiki](http://wiki.libsdl.org/)
+More documentation and FAQs are available online at the [wiki](http://wiki.libsdl.org/)

- [High DPI Support](README-highdpi.md)
- [main()](README-main-functions.md)
- [Porting information](README-porting.md)
 - [Migrating from SDL 2.0](README-migration.md)
- [Supported Platforms](README-platforms.md)
+- [main()](README-main-functions.md)
+- [High DPI Support](README-highdpi.md)
 - [Touch](README-touch.md)
- [Versions](README-versions.md)
- [Visual Studio](README-visualc.md)
-
- [Android](README-android.md)
- [Emscripten](README-emscripten.md)
- [iOS](README-ios.md)
- [KMSDRM support on BSD](README-kmsbsd.md)
- [Linux](README-linux.md)
- [macOS](README-macos.md)
- [Nintendo 3DS](README-n3ds.md)
- [PS2](README-ps2.md)
- [PSP](README-psp.md)
- [PSVita](README-vita.md)
- [Raspberry Pi](README-raspberrypi.md)
- [RISC OS](README-riscos.md)
- [Windows GDK](README-gdk.md)
- [Windows](README-windows.md)
+- [Supported platforms](README-platforms.md)
+- [Porting information](README-porting.md)

 If you need help with the library, or just want to discuss SDL related
 issues, you can join the [SDL Discourse](https://discourse.libsdl.org/),
--- a/docs/hello.c
+++ b/docs/hello.c
@@ -0,0 +1,68 @@
+/*
+  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely.
+*/
+#define SDL_MAIN_USE_CALLBACKS 1  /* use the callbacks instead of main() */
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_main.h>
+
+static SDL_Window *window = NULL;
+static SDL_Renderer *renderer = NULL;
+
+/* This function runs once at startup. */
+SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[])
+{
+    /* Create the window */
+    if (!SDL_CreateWindowAndRenderer("Hello World", 800, 600, SDL_WINDOW_FULLSCREEN, &window, &renderer)) {
+        SDL_Log("Couldn't create window and renderer: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+    return SDL_APP_CONTINUE;
+}
+
+/* This function runs when a new event (mouse input, keypresses, etc) occurs. */
+SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event)
+{
+    if (event->type == SDL_EVENT_KEY_DOWN ||
+        event->type == SDL_EVENT_QUIT) {
+        return SDL_APP_SUCCESS;  /* end the program, reporting success to the OS. */
+    }
+    return SDL_APP_CONTINUE;
+}
+
+/* This function runs once per frame, and is the heart of the program. */
+SDL_AppResult SDL_AppIterate(void *appstate)
+{
+    const char *message = "Hello World!";
+    int w = 0, h = 0;
+    float x, y;
+    const float scale = 4.0f;
+
+    /* Center the message and scale it up */
+    SDL_GetRenderOutputSize(renderer, &w, &h);
+    SDL_SetRenderScale(renderer, scale, scale);
+    x = ((w / scale) - SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE * SDL_strlen(message)) / 2;
+    y = ((h / scale) - SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE) / 2;
+
+    /* Draw the message */
+    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
+    SDL_RenderClear(renderer);
+    SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255);
+    SDL_RenderDebugText(renderer, x, y, message);
+    SDL_RenderPresent(renderer);
+
+    return SDL_APP_CONTINUE;
+}
+
+/* This function runs once at shutdown. */
+void SDL_AppQuit(void *appstate, SDL_AppResult result)
+{
+}
+
--- a/docs/release_checklist.md
+++ b/docs/release_checklist.md
@@ -15,6 +15,8 @@

 * Create a GitHub release and attach the archives you just generated.

+* If this is a feature release, also tag the sdlwiki with the same tag.
+
 ## New feature release

 * Update `WhatsNew.txt`