mirror
/
SDL
mirror of https://github.com/libsdl-org/SDL.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
19,673 Commits 8 Branches 73 Tags 197 MiB
Commit Graph

2483 Commits

Author SHA1 Message Date
SDL Wiki Bot b63d3afc18 Sync SDL3 wiki -> header 
[ci skip]
 2025-02-10 20:15:51 +00:00
Sam Lantinga 0bc1f87120 Added SDL_PROP_SURFACE_HOTSPOT_X_NUMBER and SDL_PROP_SURFACE_HOTSPOT_Y_NUMBER 2025-02-10 12:15:03 -08:00
SDL Wiki Bot 7af17f874c Sync SDL3 wiki -> header 
[ci skip]
 2025-02-07 02:00:45 +00:00
Sam Lantinga 982094c85c Updated to version 3.2.5 for development 2025-02-06 16:40:59 -08:00
Sam Lantinga b5c3eab6b4 Updated to version 3.2.4 for release 2025-02-06 16:03:43 -08:00
SDL Wiki Bot 3c6e6645fa Sync SDL3 wiki -> header 
[ci skip]
 2025-02-06 22:54:21 +00:00
SDL Wiki Bot 6cb3d37a2b Sync SDL3 wiki -> header 
[ci skip]
 2025-02-06 20:11:12 +00:00
Petar Popovic 80653a42c7 Remove non-ASCII character from public header SDL_hints.h 2025-02-06 12:10:16 -08:00
Sam Lantinga a646dc89e5 Note that SDL_GUIDToString() and SDL_StringToGUID() are thread-safe. 2025-02-06 10:44:21 -08:00
SDL Wiki Bot 5ad0337685 Sync SDL3 wiki -> header 
[ci skip]
 2025-02-05 15:45:41 +00:00
Petar Popovic 68dabd48c4 SDL_GetTrayEntries(): Rename parameter `size` to `count` 2025-02-05 07:44:46 -08:00
Cameron Cawley 691a6133d3 Remove #undef __3DS__ 2025-02-04 13:57:41 -08:00
Petar Popovic f1b3523c67 Remove redundant parenthesis in SDL_MUSTLOCK macro 2025-02-03 19:47:16 -08:00
Petar Popovic 8527d042bc Remove const from parameter of inline function SDL_RectsEqualEpsilon() 2025-02-03 19:46:36 -08:00
Petar Popovic 8ccf85c59e Formatting spaces around pointer symbol. 2025-02-03 17:03:26 -08:00
SDL Wiki Bot ec959a4349 Sync SDL3 wiki -> header 
[ci skip]
 2025-02-03 16:52:24 +00:00
Sam Lantinga 8e51b2468a Renamed SDL_SoftStretch() to SDL_StretchSurface() 
Fixes https://github.com/libsdl-org/SDL/issues/12168
 2025-02-03 08:51:32 -08:00
SDL Wiki Bot f40ef62a2a Sync SDL3 wiki -> header 
[ci skip]
 2025-02-02 23:14:17 +00:00
SDL Wiki Bot 614ae843a9 Sync SDL3 wiki -> header 
[ci skip]
 2025-02-02 22:14:15 +00:00
Sam Lantinga 8848f86560 Corrected the version where SDL_SoftStretch() was added 2025-02-02 14:13:13 -08:00
Sam Lantinga a98a4b8a68 Re-added SDL_SoftStretch() to the API 
This is needed for sdl2-compat, since a blit is not quite equivalent.
 2025-02-02 13:41:36 -08:00
SDL Wiki Bot 842f85da05 Sync SDL3 wiki -> header 
[ci skip]
 2025-02-02 21:17:22 +00:00
Sam Lantinga be991239d9 Updated to version 3.2.3 for development 2025-02-01 17:43:38 -08:00
Sam Lantinga 2fa1e7258a Updated to version 3.2.2 for release 2025-02-01 17:01:45 -08:00
SDL Wiki Bot fe6bd8e9bf Sync SDL3 wiki -> header 
[ci skip]
 2025-02-01 10:40:21 +00:00
SDL Wiki Bot 43924ec873 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-31 01:04:48 +00:00
SDL Wiki Bot 8c2682a219 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-31 00:56:29 +00:00
SDL Wiki Bot 50b8c6cdfb Sync SDL3 wiki -> header 
[ci skip]
 2025-01-30 19:31:13 +00:00
Petar Popovic 31364477f2 Rename parameter of type SDL_CameraID from devid to instance_id 2025-01-29 17:49:53 -08:00
Petar Popovic 36758d70c9 Rename parameters of type SDL_AudioDeviceID from dev to devid 2025-01-29 14:44:08 -08:00
SDL Wiki Bot 11dbff246f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-28 19:01:16 +00:00
mausimus 725ee7665c Documentation: fixed typos around floats precision 2025-01-27 14:12:24 -05:00
SDL Wiki Bot fa8c0f0552 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-26 03:57:15 +00:00
SDL Wiki Bot 17c4bdd754 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-24 21:19:18 +00:00
SDL Wiki Bot ad8a09000f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-24 20:06:31 +00:00
cosmonaut 8df17c97d1 GPU: Add notes about shader resource requirements to documentation 2025-01-24 12:04:00 -08:00
SDL Wiki Bot 84c4ff2f10 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-24 04:47:03 +00:00
SDL Wiki Bot 129ebc77b9 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-23 23:20:22 +00:00
nightmareci a437dbc7e3 Improve log documentation 2025-01-22 10:37:54 -08:00
SDL Wiki Bot 1c21a72bda Sync SDL3 wiki -> header 
[ci skip]
 2025-01-22 17:20:25 +00:00
SDL Wiki Bot df3cfbc797 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 23:08:39 +00:00
cosmonaut 799093799a GPU: Note buffer alignment requirements 2025-01-21 15:07:34 -08:00
SDL Wiki Bot 5bf077f1f1 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 23:04:33 +00:00
SDL Wiki Bot 5d6a780453 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 23:00:08 +00:00
Sam Lantinga 77b520e93e Updated to version 3.2.1 for development 2025-01-21 14:02:06 -08:00
Sam Lantinga ed2920afef All SDL 3.0 release symbols are at version 3.2.0 2025-01-21 10:19:21 -08:00
Ryan C. Gordon 7a5604cf0c
Sync SDL3 wiki -> headers. 2025-01-21 13:12:25 -05:00
Sam Lantinga a52fc209bb Updated to version 3.2.0 for release 2025-01-21 08:52:28 -08:00
SDL Wiki Bot f16c67115d Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 16:29:55 +00:00
Ryan C. Gordon c45c4a5e51
render: SDL_HINT_RENDER_DRIVER now accepts a comma-separated list. 
Fixes #11077.
 2025-01-21 11:29:00 -05:00
SDL Wiki Bot 670a7d8126 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 16:11:20 +00:00
Frank Praznik 8a67896d9a
docs: Note the preferred function for getting the content scale of a window 
SDL_GetWindowDisplayScale() should be preferred over SDL_GetDisplayForWindow() + SDL_GetDisplayContentScale() for querying the per-window content scale, as the former provides a more accurate and current value for individual windows, as the per-window value can differ from the base display scale value, particularly on high-DPI and multi-monitor desktops.
 2025-01-21 11:07:11 -05:00
SDL Wiki Bot ea9880b760 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-21 04:01:28 +00:00
Quinn X. J. bcf7ead6e4 documentation typo: SFLOAT -> FLOAT 2025-01-20 20:00:40 -08:00
Caleb Cornett abe6d9db97 Automatically detect SDL_main_private.h 2025-01-20 20:48:17 -05:00
Tomasz Pakuła c6c7469708 Translate conditional effect direction instead of hardcoding it to 0 
Provious code wrongly assumed that direction is not an important part
of conditional effect. Moreover, if there's need to hardcode polar
direction, the default should be 0x4000 (north).

For one axis affects, a direction of 0 means complete lack of force, if
a FFB-enabled device takes direction into force calculation. A sine function
graph can be used to represent the resulting forces where X is the input
direction and Y is the force multiplier (360 degrees equals to 1).

This fixes conditional effect playback on Moza Racing devices, which do
not ignore direction field.
 2025-01-20 16:52:40 -08:00
Ryan C. Gordon 90b2e2527e
include: Added a tiny bit to SDL_sensor.h's category documentation. 
Reference Issue #11847.
 2025-01-20 01:39:37 -05:00
Ryan C. Gordon 2be749b23b
include: More category documentation. 
Reference Issue #11847.
 2025-01-20 01:37:25 -05:00
Ryan C. Gordon d5766bc4b8
include: More category documentation. 
Reference Issue #11847.
 2025-01-20 01:02:30 -05:00
Ryan C. Gordon b809da52fd
assert: Try using __builtin_trap() for SDL_TriggerBreakpoint(). 
This was necessary on an arm64 install of Raspberry Pi OS.
 2025-01-20 01:02:30 -05:00
SDL Wiki Bot c4c0bfdfb1 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-20 04:34:56 +00:00
William Hou 7133969e3a
Feature add hint to remap option as alt key (#12021) 2025-01-19 20:34:04 -08:00
SDL Wiki Bot 53a5350292 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-20 02:54:44 +00:00
Sam Lantinga 5f2dd5f04e tray: fixed multi-threading issues with GTk implementation 
GTK+ documentation states that all GDK and GTK+ calls should be made from the main thread.

Fixes https://github.com/libsdl-org/SDL/issues/11984
 2025-01-19 18:53:55 -08:00
Sam Lantinga dfdc120268 tray: document thread-safety 2025-01-19 18:53:55 -08:00
SDL Wiki Bot 78023500fa Sync SDL3 wiki -> header 
[ci skip]
 2025-01-19 23:59:37 +00:00
Ryan C. Gordon 34c12d0db8
include: Add category documentation to SDL_timer.h. 
Reference Issue #11847.
 2025-01-19 12:19:30 -05:00
SDL Wiki Bot b088e89191 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-19 17:12:43 +00:00
Ryan C. Gordon 0851322fb1
include: Add category documentation to SDL_power.h. 
Reference Issue #11847.
 2025-01-19 12:11:49 -05:00
SDL Wiki Bot e054f3c085 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-18 15:12:47 +00:00
Ryan C. Gordon 75317dae59
include: Added category docs for SDL_mouse.h 
Reference Issue #11847.
 2025-01-18 10:11:53 -05:00
Sam Lantinga 923123a527 emscripten: Let SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT accept "#none" 
This is used to say "don't even try to listen for keypresses," for apps that
are managing this outside of SDL.

Fixes #10292.
 2025-01-18 06:19:27 -08:00
Ryan C. Gordon 6a72d32d41
emscripten: Let SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT accept "". 
This is used to say "don't even try to listen for keypresses," for apps that
are managing this outside of SDL.

Fixes #10292.
 2025-01-18 08:43:55 -05:00
Ryan C. Gordon 010f27dc70
storage: enumerate and glob on storage can accept a NULL path. 
This will be treated as the root of the storage tree.
 2025-01-17 20:11:50 -05:00
Ryan C. Gordon feeea6a776
Sync SDL3 wiki -> headers. 2025-01-17 18:42:04 -05:00
SDL Wiki Bot d2fc394a2a Sync SDL3 wiki -> header 
[ci skip]
 2025-01-17 23:11:30 +00:00
SDL Wiki Bot ee469c6aff Sync SDL3 wiki -> header 
[ci skip]
 2025-01-17 22:26:32 +00:00
cosmonaut d4d22dd8de GPU: Add remarks about point topology 2025-01-17 14:25:14 -08:00
SDL Wiki Bot 9ed96f392d Sync SDL3 wiki -> header 
[ci skip]
 2025-01-17 19:46:20 +00:00
Sam Lantinga ae8df1dcbd Note that the primary monitor isn't always at 0,0 2025-01-17 11:52:33 -08:00
SDL Wiki Bot 07a5c144c6 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-16 19:43:08 +00:00
Sam Lantinga eb168e410c Updated to version 3.1.11 for development 2025-01-16 11:41:28 -08:00
SDL Wiki Bot 274bc95dfd Sync SDL3 wiki -> header 
[ci skip]
 2025-01-16 18:29:57 +00:00
SDL Wiki Bot 07f7c40464 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-16 18:18:47 +00:00
Ryan C. Gordon 22d8e73530
include: filled in category documentation for SDL_messagebox.h. 
Reference Issue #11847.
 2025-01-16 13:16:18 -05:00
Sam Lantinga 1dd8fadca2 Updated to version 3.1.10 for the release candidate 2025-01-16 08:33:18 -08:00
SDL Wiki Bot 9225a421b7 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-16 13:20:18 +00:00
Ryan C. Gordon 874c07f8de storage: Don't allow "." and ".." paths, enforce '/' dir separators. 
Also clarify what characters are valid for Storage paths in the category docs.

Fixes #11079.
Fixes #11370.
Fixes #11369.
 2025-01-16 08:19:28 -05:00
Ryan C. Gordon eb793dede7 filesystem: SDL_GetCurrentDirectory() should add a path separator at the end. 2025-01-16 08:19:28 -05:00
Ryan C. Gordon 87e1b0eb89 filesystem: SDL_EnumerateDirectory() gives dirs with path seperators appended. 
Fixes #11065.
Fixes #11427.
 2025-01-16 08:19:28 -05:00
Ramez Ragaa e98ee9bb04 Adjust testgl.c to test gl_release_behavior 2025-01-16 08:19:05 -05:00
Ryan C. Gordon dabc93a631 pen: Send virtual mouse and touch events for pen input. 
Fixes #11948.
 2025-01-15 02:19:59 -05:00
SDL Wiki Bot 3bea84531d Sync SDL3 wiki -> header 
[ci skip]
 2025-01-15 03:27:28 +00:00
Sam Lantinga 9ed23a4b79 Updated SDL_SetEventFilter() documentation 2025-01-14 19:25:31 -08:00
SDL Wiki Bot bf793bf439 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-14 21:44:52 +00:00
Ryan C. Gordon 9e60a8994f
audio: Allow streams to change the device-side channels maps. 
Fixes #11881.
 2025-01-14 16:42:53 -05:00
SDL Wiki Bot 31dd4fe81f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-14 17:58:27 +00:00
Maia 417ed7f35f Fix references in docs 2025-01-14 09:56:39 -08:00
cosmonaut 5d079c9a26 GPU: Remove bogus property from header docs 2025-01-13 17:46:31 -08:00
cosmonaut d590e1f122 GPU: Align D3D12 clear properties to naming convention 2025-01-13 17:38:21 -08:00
SDL Wiki Bot 7098e525d0 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-14 01:30:53 +00:00
Evan Hemsley fb6df93384
GPU: Add name properties to resources (#11946) 2025-01-13 17:29:08 -08:00
SDL Wiki Bot a2b0ddcca6 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-14 01:19:09 +00:00
Sam Lantinga d28e953222 Added thread safety documentation for SDL_iostream.h 
Fixes https://github.com/libsdl-org/SDL/issues/11942
 2025-01-13 17:17:17 -08:00
SDL Wiki Bot e10e42c814 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-13 20:58:20 +00:00
SDL Wiki Bot efaf3739c6 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-13 19:42:26 +00:00
SDL Wiki Bot 7d7a76c077 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-13 17:53:40 +00:00
Sam Lantinga 66408308b8 Added documentation for mouse handling in relative mode 
Fixes https://github.com/libsdl-org/SDL/issues/11805
 2025-01-13 09:52:21 -08:00
SDL Wiki Bot 438075a83a Sync SDL3 wiki -> header 
[ci skip]
 2025-01-13 17:38:58 +00:00
Frank Praznik b4562c0243 cocoa: Add a hint to control menu visibility in fullscreen spaces windows 
Adds SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY to control whether or not the menu can be accessed when the cursor is moved to the top of the screen when a window is in fullscreen spaces mode.

The three values are true, false, and 'auto' (default), with auto resulting in a hidden menu if fullscreen was toggled programmatically, and the menu being accessible if fullscreen was toggled via the button on the window title bar, so the user has an easy way back out of fullscreen if the client app/game doesn't have a readily available option to toggle it.
 2025-01-13 12:37:16 -05:00
SDL Wiki Bot 949ec0c501 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-12 23:52:58 +00:00
SDL Wiki Bot 839227b4b0 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-12 22:24:11 +00:00
cosmonaut c04b739df6 GPU: Note that resource naming functions are not thread safe. 2025-01-12 14:22:26 -08:00
expikr 9a83fa026d apply multiplier scale after system scale 2025-01-12 08:24:41 -08:00
SDL Wiki Bot ea859fba3a Sync SDL3 wiki -> header 
[ci skip]
 2025-01-12 16:07:12 +00:00
Sam Lantinga 551510c0eb SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE can be combined with SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE 2025-01-12 08:05:51 -08:00
Anonymous Maarten d42b4ed961 Leave SDL_TriggerBreakpoint undefined on unknown platforms 2025-01-11 17:29:27 +01:00
Ozkan Sezer 61f13b94d1 add a fallback SDL_TriggerBreakpoint() for MSVC after commit ebaa30d3. 2025-01-11 02:11:50 +03:00
SDL Wiki Bot c64197be1a Sync SDL3 wiki -> header 
[ci skip]
 2025-01-10 20:56:33 +00:00
Sam Lantinga 042898995c Added SDL_ClickTrayEntry() 
Also removed the app delegate from the tray code on Cocoa and folded that into SDL3AppDelegate.

Fixes https://github.com/libsdl-org/SDL/issues/11906
 2025-01-10 12:55:50 -08:00
SDL Wiki Bot 1f3b40797d Sync SDL3 wiki -> header 
[ci skip]
 2025-01-10 06:39:06 +00:00
Ryan C. Gordon fb94a79f89 stdinc: define SDL_NOLONGLONG for old Visual Studios, document the symbol. 
Reference PR #11900.
 2025-01-10 01:37:25 -05:00
SDL Wiki Bot 00b23a012c Sync SDL3 wiki -> header 
[ci skip]
 2025-01-09 22:27:31 +00:00
Frank Praznik 6b776a9989 keyboard: Add some SDL keycodes for common Xkb keys 
Add SDL keycodes for keys found commonly found in the default Xkb layout, such as left tab and compose, and keys frequently used for custom modifiers such as Meta, Hyper, and Level5 Shift.

As these keys aren't Unicode code points and don't have associated scancodes (at least on modern keyboards), they are placed in the new extended key code space, with bit 30 set as a flag.
 2025-01-09 17:26:41 -05:00
Frank Praznik 73ee99978d wayland: Add support for Mod3 and more esoteric Xkb configurations 
Adds support for Mod3, which is usually Level 5 shift, but can vary, as well as not altering the functionality of the more esoteric modifier keys, such as meta and hyper.
 2025-01-09 17:26:41 -05:00
Anonymous Maarten ebaa30d339 __debugbreak was introduced in Microsoft Visual Studio 2003 2025-01-09 16:04:14 -05:00
Anonymous Maarten c8f3f1b461 _BitScanReverse was introduced in Microsoft Visual Studio 2005 2025-01-09 16:04:14 -05:00
Anonymous Maarten a78104a47f Disable long long support in the headers with SDL_NOLONGLONG 
Some older toolchains don't support 'long long'.
 2025-01-09 16:04:14 -05:00
SDL Wiki Bot c688853a82 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-09 19:47:47 +00:00
SDL Wiki Bot d2090d1c80 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-09 06:38:16 +00:00
Ryan C. Gordon 3f7f632e14
audio: Added SDL_AudioDeviceStreamPaused. 
We had the other two wrapper functions to pause and resume, and forgot query.
 2025-01-09 01:36:57 -05:00
SDL Wiki Bot 1636009511 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-08 19:57:05 +00:00
SDL Wiki Bot cbdbd66e18 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-08 15:33:53 +00:00
Sam Lantinga e6bb50a710 Updated to version 3.1.9 for development 2025-01-07 17:51:00 -08:00
SDL Wiki Bot 6b34c9fe7f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-08 01:50:36 +00:00
Sam Lantinga d7b10d05b1 Updated to version 3.1.8 for the preview release 2025-01-07 17:04:05 -08:00
Sam Lantinga 0176a19aee Fixed platform define condition for Windows phone 
Fixes https://github.com/libsdl-org/SDL/issues/11876
 2025-01-07 08:47:54 -08:00
Ryan C. Gordon 6473de59b7
SDL_keyboard.h: Note that SDL_GetKeyName() returns uppercase letters. 
Reference Issue #11434.
 2025-01-06 12:47:44 -05:00
SDL Wiki Bot c7584df999 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-06 16:17:26 +00:00
Ryan C. Gordon 1f54b228ff
video: Convert some EGL environment variables to SDL hints. 
Fixes #10479.
 2025-01-06 11:15:26 -05:00
SDL Wiki Bot 19ddb29d2d Sync SDL3 wiki -> header 
[ci skip]
 2025-01-06 02:54:14 +00:00
Ryan C. Gordon 742f2a2fad SDL_render.h: Improve SDL_ConvertEventToRenderCoordinates documentation. 
Fixes #9424.
 2025-01-05 20:55:42 -05:00
SDL Wiki Bot ece6a6ed8f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-05 19:12:20 +00:00
Ryan C. Gordon 7f9ee31024
include: Fill in more category documentation. 
Reference Issue #11874.
 2025-01-05 14:11:11 -05:00
SDL Wiki Bot d8c679416b Sync SDL3 wiki -> header 
[ci skip]
 2025-01-04 19:04:41 +00:00
Semphris 7673b84f52 Make SDL_GetTrayEntires() NULL-terminated 2025-01-04 10:56:19 -08:00
Ryan C. Gordon 3519ef3b3b
SDL_asyncio.h: Fixed various datatype's `\since` documentation. 2025-01-04 04:10:15 -05:00
Ryan C. Gordon 56d7cc7a02
SDL_video.h: Added a note about platform quirks to SDL_DestroyWindow docs. 
Fixes #10081.
 2025-01-04 03:48:10 -05:00
SDL Wiki Bot 04f3bdb118 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-04 08:24:05 +00:00
Ryan C. Gordon 18c6958cae
SDL_vulkan.h: Improve SDL_Vulkan_LoadLibrary/SDL_Vulkan_UnloadLibrary docs. 
Fixes #9541.
 2025-01-04 03:22:34 -05:00
SDL Wiki Bot 9b40d43b1f Sync SDL3 wiki -> header 
[ci skip]
 2025-01-03 22:37:37 +00:00
Frank Praznik 85851459d6
docs: Note that using the Wayland display scaling mode can have imprecision when positioning due to unit conversion and rounding 2025-01-03 17:36:36 -05:00
SDL Wiki Bot 011454b237 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-03 03:10:47 +00:00
Sam Lantinga c077b7a918 Fixed the version availability of SDL_HINT_JOYSTICK_ENHANCED_REPORTS 2025-01-02 17:28:45 -08:00
SDL Wiki Bot 0b520cd4b4 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-03 01:18:56 +00:00
Sam Lantinga 2c0a8363a5 Added SDL_HINT_JOYSTICK_ENHANCED_REPORTS 
This hint defaults on, enabling advanced controller features.

This replaces SDL_HINT_JOYSTICK_HIDAPI_PS4_RUMBLE and SDL_HINT_JOYSTICK_HIDAPI_PS5_RUMBLE, and is supported by PlayStation and Nintendo Switch controllers.

Fixes https://github.com/libsdl-org/SDL/issues/10086
 2025-01-02 17:18:09 -08:00
SDL Wiki Bot 95d44f11c7 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-02 20:40:15 +00:00
SDL Wiki Bot 16dfaca728 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-02 20:06:39 +00:00
SDL Wiki Bot 32ab09ba21 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-02 19:44:57 +00:00
Frank Praznik 1461f893c3
video: Correct the window position property documentation 
Windows are only relative to the parent if the "tooltip" or "menu" property is set.
 2025-01-02 14:44:08 -05:00
SDL Wiki Bot a63052db96 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-02 19:17:51 +00:00
Sam Lantinga dd6b484359 Document platform gamepad hotplug requirements 
Fixes https://github.com/libsdl-org/SDL/issues/11742
 2025-01-02 11:16:35 -08:00
Sam Lantinga 4797970bfa Enable SDL_HINT_JOYSTICK_THREAD by default 
If you're not using SDL for video you won't get raw input messages without this hint, and this is tripping up enough people it makes sense to have this enabled by default. There isn't much downside to this, other than having another thread processing Xbox controller input.

Fixes https://github.com/libsdl-org/SDL/issues/10576
 2025-01-02 10:25:18 -08:00
SDL Wiki Bot 6d554a9ea3 Sync SDL3 wiki -> header 
[ci skip]
 2025-01-01 16:06:00 +00:00
Sam Lantinga 9fbc767d4f Fixed formatting of SDL_storage documentation 2025-01-01 08:05:20 -08:00
Sam Lantinga c0e5901c42 Reverted accidentally committed work in progress 2025-01-01 07:54:55 -08:00
Sam Lantinga f2074d7af3 Updated copyright for 2025 2025-01-01 07:45:52 -08:00
Sam Lantinga b902b0527b Renamed n_mime_types to num_mime_types 2024-12-31 19:27:11 -08:00
SDL Wiki Bot a37f993a07 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-31 22:56:38 +00:00
Ethan Lee 65e0fed5b3 gpu: Document why VertexID/InstanceID builtins are unreliable 2024-12-31 17:56:02 -05:00
SDL Wiki Bot 99ad53ec3f Sync SDL3 wiki -> header 
[ci skip]
 2024-12-31 19:44:29 +00:00
SDL Wiki Bot 18fc13c20d Sync SDL3 wiki -> header 
[ci skip]
 2024-12-31 18:00:37 +00:00
SDL Wiki Bot 6d20b65a9e Sync SDL3 wiki -> header 
[ci skip]
 2024-12-31 17:58:37 +00:00
SDL Wiki Bot 6ca2a48595 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-31 16:20:17 +00:00
Ryan C. Gordon fa9c3331d5 main: Adjust how SDL_HINT_MAIN_CALLBACK_RATE works. 
Now (only in the generic backend, where it is implemented), this hint is
always respected. Previously it would only be used if no windows were created,
to help reduce CPU load on things like loopwave.

Since it's always used now, the default has changed from 60 (Hz) to 0 (run as
fast as possible). Things like loopwave should still likely force this way
lower than the previous default (and already do: loopwave explicitly sets it
to 5).

The hint can now also be set to "waitevent" which will cause SDL_AppIterate
to only be called after new events have arrived, for apps that are entirely
driven by input and want to consume (almost) no power or CPU time until then.

Fixes #11093.
Fixes #11387.
 2024-12-31 08:19:38 -08:00
Ethan Lee cd1bd0ac2e
storage: Remove an outdated FIXME. 
Woops ended up doing GPU stuff instead, maybe after 3.2!
 2024-12-31 10:46:42 -05:00
Sam Lantinga 1c04ebe423 Renamed SDL_ASYNCIO_CANCELLED to SDL_ASYNCIO_CANCELED 2024-12-30 19:13:02 -08:00
Sam Lantinga d4d5faedab Added SDL_EVENT_FINGER_CANCELED 
Fixes https://github.com/libsdl-org/SDL/issues/10528
 2024-12-30 19:13:02 -08:00
Petar Popovic f3cbd04a81 Fix C99 trailing enum comma warning. 2024-12-30 17:21:02 +03:00
Semphris 2d91f096ca Remove libc function from Windows tray 2024-12-30 01:20:12 +03:00
SDL Wiki Bot 78c1dc3e2c Sync SDL3 wiki -> header 
[ci skip]
 2024-12-29 20:32:50 +00:00
Anonymous Maarten d5f08b8f4b stdinc: use __has_include to detect <stdbool.h> 
Newer emscripten SDK does an unconditional #include <stdbool.h>,
which clashes with our custom bool.h typedef
 2024-12-29 20:54:12 +01:00
SDL Wiki Bot 4ffcb8ebab Sync SDL3 wiki -> header 
[ci skip]
 2024-12-28 07:58:04 +00:00
Carl Åstholm 49153ebfc4 audio: Add NULL check to SDL_UnbindAudioStreams 2024-12-28 00:10:58 -05:00
Carl Åstholm 1b99467c71 audio: Make SDL_Bind/UnbindAudioStreams take const arrays 2024-12-28 00:10:58 -05:00
SDL Wiki Bot 609b147432 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-28 01:12:59 +00:00
SDL Wiki Bot 1701208f32 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-27 17:25:19 +00:00
Semphris 0461180e25 SDL_EVENT_QUIT when no window nor tray 
SDL_HINT_QUIT_ON_LAST_WINDOW_CLOSE will not fire if there are active tray icons. This impacts only applications that create tray icons, and that at least one icon outlives the last visible top-level window. SDL_EVENT_QUIT will fire when the last active tray is destroyed if there are no active windows.
 2024-12-27 09:22:27 -08:00
SDL Wiki Bot ff139fe71b Sync SDL3 wiki -> header 
[ci skip]
 2024-12-27 17:20:36 +00:00
SDL Wiki Bot a773558517 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-27 02:32:08 +00:00
Sam Lantinga c744c8fc0b Document how to check for gamepad capabilities 
Fixes https://github.com/libsdl-org/SDL/issues/10593
 2024-12-26 17:49:56 -08:00
Sam Lantinga a8d585aac3 Don't try to enumerate possible texture failure reasons. 
This can cause misunderstanding about how texture creation works, as seen in https://github.com/libsdl-org/SDL/issues/9504. Instead let people check the error for more information on why creation may have failed.
 2024-12-26 17:17:08 -08:00
Ryan C. Gordon 8fde28813e
SDL_tray.h: Filled in doxygen for a few minor missing things. 2024-12-26 14:10:53 -05:00
SDL Wiki Bot 17df3fe836 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-26 18:26:48 +00:00
Sam Lantinga eb1be89e70 Cleaned up thread state handling and added thread object validation 2024-12-26 10:26:08 -08:00
SDL Wiki Bot 7647f16ae1 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-26 18:03:51 +00:00
Lucas Murray b2c2a483e8 GPU: Rename HDR10_ST2048 to HDR10_ST2084 2024-12-26 09:47:13 -08:00
Lucas Murray fe39509b85 GPU: Doc touch ups 2024-12-26 09:47:13 -08:00
SDL Wiki Bot b8036bdd41 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-25 21:15:58 +00:00
Moritz ca4f5dd40d Added SDL_GetThreadState 2024-12-25 13:15:18 -08:00
Maia 0becdad392 Add missing includes to SDL_tray.h 2024-12-25 07:54:54 -08:00
Brody Eller 5bf742daa6 Fix documentation for SDL_sinf 2024-12-24 20:41:41 -08:00
SDL Wiki Bot 4c70aa33ae Sync SDL3 wiki -> header 
[ci skip]
 2024-12-24 18:50:21 +00:00
Semphriss 01b9b0edb7
Add system tray support (#10873) 2024-12-24 10:36:39 -08:00
SDL Wiki Bot 17a029502a Sync SDL3 wiki -> header 
[ci skip]
 2024-12-24 17:37:33 +00:00
Caleb Cornett aa817a67d1 GPU: Document system requirements for each driver 2024-12-24 12:36:52 -05:00
Sam Lantinga ed75d9d22a Document that the mouse ID is only valid in mouse relative mode 
Fixes https://github.com/libsdl-org/SDL/issues/11259
 2024-12-23 17:12:50 -08:00
SDL Wiki Bot 4d301b88d6 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-24 00:54:10 +00:00
Sam Lantinga 969f03d9f0 Added SDL_PROP_RENDERER_GPU_DEVICE_POINTER 
Fixes https://github.com/libsdl-org/SDL/issues/11600
 2024-12-23 16:51:43 -08:00
SDL Wiki Bot 7a22076a7c Sync SDL3 wiki -> header 
[ci skip]
 2024-12-23 23:58:24 +00:00
SDL Wiki Bot 18115ef6bd Sync SDL3 wiki -> header 
[ci skip]
 2024-12-23 23:01:15 +00:00
Sam Lantinga 8691408baf Clarify that you shouldn't make any assumptions about the an SDL_FingerID value. 
Fixes https://github.com/libsdl-org/SDL/issues/11667
 2024-12-23 14:28:54 -08:00
Eduard Gushchin 3ac28bae6a Removed references to non-existent method SDL_GetAsyncIOTaskResult 2024-12-23 08:02:03 -08:00
SDL Wiki Bot da37e1541b Sync SDL3 wiki -> header 
[ci skip]
 2024-12-23 05:32:13 +00:00
SDL Wiki Bot ecea3471f6 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-22 20:20:41 +00:00
Anonymous Maarten f8d8bf8066 SDL_GetNumAllocations returns -1 when allocation counting is disabled 2024-12-22 12:20:04 -08:00
SDL Wiki Bot 478ac0b9bf Sync SDL3 wiki -> header 
[ci skip]
 2024-12-22 19:01:42 +00:00
SDL Wiki Bot 03d6e4b69e Sync SDL3 wiki -> header 
[ci skip]
 2024-12-22 18:53:26 +00:00
Maia ca4ffc8a00 Fix missing parens in preprocessor defined op 2024-12-22 10:36:03 -05:00
Maia 8475c496b4 Fix typo 2024-12-22 10:35:35 -05:00
SDL Wiki Bot 56cf8d8dc9 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-22 07:09:56 +00:00
Ryan C. Gordon f0fad41f2c
include: Filled in all remaining missing documentation! 2024-12-22 01:58:13 -05:00
SDL Wiki Bot 4d8f5758cf Sync SDL3 wiki -> header 
[ci skip]
 2024-12-22 06:18:11 +00:00
Sam Lantinga f37eef948c Removed raw mouse events 
It's too close the 3.2.0 release for an API change like this.

If/when we re-add these, some things for consideration:
* What use cases does this enable that aren't currently possible?
* What cross-platform API guarantees do we make about the availability of these events? e.g. do we try to simulate them where raw input isn't actually available?
* How is this different from the existing relative mode, and how do we clearly explain when you want these events vs wanting relative mode?

Notes from @expikr:
First observation: the reason I originally passed denominators instead of multipliers was because some rational values cannot be exactly represented by floats (e.g 1/120) so instead let the end-developer decide how to do the dividing themselves. It was the reason why it was using split values with an integer numerator to begin with, instead of having both as floats or even just normalize it in advance.

On the other hand, passing them as multipliers might have hypothetical uses for dynamically passing end-user controlled scaling in a transparent manner without coupling? (Though in that case why not just do that as additional fields appended to `motion` structs in an API-compatible layout?)

So it’s somewhat of a philosophical judgement of what this API of optional availability do we intend for it to present itself as:
- should it be a bit-perfect escape hatch with the absolute minimally-denominal abstraction over platform details just enough to be able to serve the full information (á la HIDPIAPI),
- or a renewed ergonomic API for splitting relative motion from cursor motion (in light of The Great Warping Purge) so that it is unburdened by legacy RelativeMode state machines, in which case it would be more appropriate to just call it `RELATIVE` instead of `RAW` and should be added alongside another new event purely for cursor events?

This alternate API stream was conceived in the context of preserving compatibility of the existing RelativeMode state machine by adding an escape hatch. So given the same context, my taste leans towards the former designation.

However, as The Great Warping Purge has made it potentially viable to do so, if I were allowed to break ABI by nuking the RelativeMode state machine entirely, I would prefer the latter designation unified as one of three separate components split from the old state machine, each independently controlled by platform-dependent availability without any state switching of a leaky melting pot:
- cursor visibility controls (if platform has cursor)
- cursor motion events (if platform has cursor)
- relative motion events (if the platform reports hardware motion)
 2024-12-21 05:18:42 -08:00
Sam Lantinga d07bb0e679 Removed raw key events 
They weren't adding any value over the existing keyboard events
 2024-12-21 05:18:42 -08:00
Sam Lantinga c44fa5bb07 Updated raw input events to match SDL style 
Also added raw keyboard events, and implemented raw input events on iOS, OpenBSD console, Linux console, and X11
 2024-12-21 05:18:42 -08:00
SDL Wiki Bot 1025087c2e Sync SDL3 wiki -> header 
[ci skip]
 2024-12-21 13:15:56 +00:00
Ethan Lee f7580374a1 include: Always declare SDL_GDKSuspendComplete. 
This is always defined in the symbol table and the function safely does nothing
on non-GDK targets, so treat it like any other SDL_system function.
 2024-12-20 13:14:55 -05:00
SDL Wiki Bot 232c2970d3 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-20 15:57:39 +00:00
SDL Wiki Bot b815123cf2 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-20 07:48:16 +00:00
Ryan C. Gordon 819e1cc95b
SDL_stdinc.h: A couple wikiheaders fixes. 2024-12-20 02:45:04 -05:00
Ryan C. Gordon b2eb23a617
SDL_filesystem.h: Fill in missing documentation. 2024-12-20 02:39:28 -05:00
Ryan C. Gordon 0b401137d2
SDL_stdinc.h: Document more stuff. 
There's only a handful of C runtime wrappers left in this header now!
 2024-12-20 02:28:34 -05:00
Ryan C. Gordon b83dd793fd
SDL_stdinc.h: Tons of documentation updates. 
Almost everything in this header is now documented! The remaining gaps are
literal C runtime wrappers like SDL_strdup, and the analyzer macros like
SDL_INOUT_Z_CAP.
 2024-12-20 01:09:40 -05:00
SDL Wiki Bot b2c15a8c2a Sync SDL3 wiki -> header 
[ci skip]
 2024-12-20 00:35:23 +00:00
SDL Wiki Bot c9e22d4672 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-20 00:13:34 +00:00
Ryan C. Gordon ff366fba87
include: Move SDL_HAS_BUILTIN to SDL_begin_code.h, document it. 
This macro fits better here, since most of the other macros in this file are
for testing similar compiler/target features, etc.
 2024-12-19 19:12:56 -05:00
Ryan C. Gordon 401c8f8e4e
SDL_timer.h: Fixed doxygen typo. 2024-12-19 16:46:42 -05:00
SDL Wiki Bot 2f9a45af60 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-19 21:44:12 +00:00
Ryan C. Gordon 0c42891826
include: Filled in more documentation gaps. 2024-12-19 16:42:14 -05:00
SDL Wiki Bot d6a95ae198 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-19 18:54:59 +00:00
Sam Lantinga 42de2ac6a9 Fixed typo 2024-12-19 10:51:02 -08:00
Sam Lantinga e08f34c3be Removed SDL_HINT_MOUSE_RELATIVE_MODE_WARP 
This complicated mouse handling and is a rarely tested path. Real relative mode is much better performance and higher precision.
 2024-12-19 10:33:02 -08:00
SDL Wiki Bot 519923ea80 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-19 17:20:47 +00:00
Ryan C. Gordon 624a4d5f26
include: Documented important SDL_begin_code symbols. 2024-12-19 12:19:46 -05:00
expikr 5c0f8dc179
add alternate raw mouse motion events with windows implementation (#10042) 2024-12-18 17:29:27 -08:00
expikr 345cab1e36
streamline cursor clipping logic on windows (#11237) 
This commit does the following:
- add logic in the `WM_MOUSEMOVE` case of the Window to conditionally call `WIN_UpdateClipCursor` upon receiving cursor motion if SDL is expecting the mouse to be clipped in some way (Fixes #7890)
- remove Windows-specific periodic refresh of cursor clipping and its `SDL_HINT_MOUSE_RELATIVE_CLIP_INTERVAL` hint (superceded by the above bullet point)
- streamline the processing logic within `WIN_UpdateClipCursor` for better readability of each branch, and avoid calling the Platform API until it is absolutely necessary.
- move `relative_mouse_center` field from Windows-specific per-window `SDL_WindowData` to the global `SDL_Mouse` struct, and the corresponding hint callbacks to `SDL_mouse.c` instead of `SDL_windowswindow.c`
 2024-12-18 17:25:06 -08:00
SDL Wiki Bot 10f868abf4 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-19 01:06:43 +00:00
Sam Lantinga f81472d767 Document that you should read from processes before waiting for them to exit. 
Fixes https://github.com/libsdl-org/SDL/issues/11645
 2024-12-18 16:18:44 -08:00
Eduard Gushchin da80b9bce5 Fixed an inaccuracy in the documentation for SDL_ConvertPixelsAndColorspace 2024-12-18 14:20:24 -08:00