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

2290 Commits

Author SHA1 Message Date
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
Eduard Gushchin 2ce21d1fed Fixed an inaccuracy in the documentation for SDL_CancelGPUCommandBuffer 2024-12-18 14:18:33 -08:00
Eduard Gushchin 0ca8027205 Fixed an inaccuracy in the documentation for SDL_PenProximityEvent and SDL_PenMotionEvent 2024-12-18 13:02:14 -08:00
SDL Wiki Bot 4d9e7a2a68 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-18 19:09:01 +00:00
cosmonaut b5eea03d1e GPU: Clarify presentation concerns in SDL_gpu.h 2024-12-18 11:08:14 -08:00
SDL Wiki Bot 7dd523fbb1 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-18 18:57:45 +00:00
SDL Wiki Bot 48a0adb2ac Sync SDL3 wiki -> header 
[ci skip]
 2024-12-18 15:41:13 +00:00
Ryan C. Gordon 4d4a2786bb render: Updates to format-string versions of SDL_RenderDebugText. 
- Removes SDL_RenderDebugTextV
- Changes SDL_RenderDebugTextF to SDL_RenderDebugTextFormat and tweaks it to
  work in a world without SDL_RenderDebugTextV.
- Tweaked rendering position of formatted text in the example program.
 2024-12-18 10:40:31 -05:00
williamistGitHub 1d0e28a5b3 Add SDL_RenderDebugTextF & SDL_RenderDebugTextV 
This should make it easier to quickly put important numbers and such on
the screen without having to format them into a string manually.
 2024-12-18 10:40:31 -05:00
SDL Wiki Bot 5608bf5866 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-18 06:22:41 +00:00
Ryan C. Gordon e957840d34
include: Filling in some more documentation gaps. 2024-12-18 01:18:40 -05:00
Ryan C. Gordon c9ab8ad8d9
SDL_intrin.h: Added missing NEON and Altivec documentation. 2024-12-17 23:33:05 -05:00
SDL Wiki Bot d38c09e5c4 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-18 04:26:44 +00:00
Ryan C. Gordon 6730cf7bed
SDL_intrin.h: Add documentation. 2024-12-17 23:25:25 -05:00
SDL Wiki Bot 19bdc01b8c Sync SDL3 wiki -> header 
[ci skip]
 2024-12-17 15:46:19 +00:00
Frank Praznik eda0261c4e video: Drop size and position requests for windows in a fixed size/position state 
It is not uncommon for clients to redundantly set the window size and position, either as a holdover from an SDL 1 port, when this was required, due to any window state change triggering a universal update function that sets all window state, even if unnecessary (e.g. always calling SDL_SetWindowSize(), even if the window is fullscreen), or due to the use of compatability layers. Historically, these clients expect that their behavior won't override the base window state, which is an assumption that the windowing changes in SDL 3 broke by caching size and position changes that can't be applied immediately.

This change drops size and position requests when the window is in the maximized and fullscreen states (fullscreen-desktop windows will be repositioned, but the non-fullscreen floating position will not be overwritten), which is behavior more in line with existing client assumptions, and should ease the porting process, as well as prevent annoying bugs when older software is run via sdl2-compat.

In the process of making these changes, pending window state has been moved to separate variables in the SDL_Window struct, as this fixes bugs regarding fullscreen display selection and centering windows immediately after resize on asynchronous platforms, which had issues due to pending state possibly being overwritten.
 2024-12-17 10:45:40 -05:00
SDL Wiki Bot a92eade183 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-16 17:20:27 +00:00
Ryan C. Gordon 35360ec4d7 alsa: Use more hints for opening default devices. 2024-12-16 12:19:48 -05:00
SDL Wiki Bot 3fa0537565 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-16 06:13:48 +00:00
Ryan C. Gordon 79316ca36e
Heavy work on improving category documentation. 
Still more to go!

Reference Issue #9440.
 2024-12-16 01:10:37 -05:00
SDL Wiki Bot 9aca97f4e7 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-16 05:03:54 +00:00
Ryan C. Gordon c0803f7683
SDL_dialog.h: Improvements and fixes to the documentation. 2024-12-16 00:02:50 -05:00
Ryan C. Gordon a55686ce61
hints: Clarify when joystick hints should be set. 
Fixes #9490.
 2024-12-15 21:28:28 -05:00
SDL Wiki Bot a1e8d5c327 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-11 19:17:12 +00:00
Evan Hemsley 3ee39f6c3f
GPU: Revise swapchain acquisition (#11633) 
---------

Co-authored-by: Lucas Murray <22484+lmurray@users.noreply.github.com>
 2024-12-11 11:16:35 -08:00
Ryan C. Gordon f45ce45603 ngage: Remove Nokia N-Gage support. 
This can be reverted if a toolchain arrives that can handle C99 features like
variables declared in the middle of a scope, but for now we literally can't
compile SDL3 for this platform.

Fixes #11243.
 2024-12-11 13:29:43 -05:00
SDL Wiki Bot e6e468d0c4 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-11 00:28:23 +00:00
Ryan C. Gordon be5fba963a
wikiheaders: optionally generate a Quick Reference page. 
Plus some fixes to SDL's headers this brought up.
 2024-12-10 11:25:15 -05:00
SDL Wiki Bot f64e9a52dc Sync SDL3 wiki -> header 
[ci skip]
 2024-12-07 04:33:05 +00:00
SDL Wiki Bot d25cdc0fef Sync SDL3 wiki -> header 
[ci skip]
 2024-12-07 00:20:38 +00:00
Sam Lantinga 08de6656fc Document the pixel layout of YUV format surfaces 
Fixes https://github.com/libsdl-org/SDL/issues/10530
 2024-12-06 16:14:05 -08:00
SDL Wiki Bot 2ac62d8c67 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-06 22:17:01 +00:00
SDL Wiki Bot 7278399366 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-06 22:15:20 +00:00
expikr d0f1910918 add SDL_RenderTextureAffine 2024-12-06 14:14:47 -08:00
SDL Wiki Bot 2c4fc2e549 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-06 21:46:49 +00:00
Evan Hemsley fa5f84fb6e
GPU: Add SetGPUAllowedFramesInFlight (#11599) 2024-12-06 11:56:20 -08:00
SDL Wiki Bot c49f4ceeb2 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-06 00:49:29 +00:00
Sam Lantinga 23828b62d4 Added SDL_IsMainThread() and SDL_RunOnMainThread() 2024-12-05 13:53:51 -08:00
Sam Lantinga bc4185c685 Document that video and input functions should be called on the main thread. 
This is a hard requirement on Apple platforms and while most other platforms don't have a concept of main thread, all video and input functions should be called on the same thread.
 2024-12-05 13:53:51 -08:00
SDL Wiki Bot 9f8157f42c Sync SDL3 wiki -> header 
[ci skip]
 2024-12-05 08:29:19 +00:00
Ryan C. Gordon 951ca96dc9
asyncio: Added more category documentation. 2024-12-04 23:08:36 -05:00
SDL Wiki Bot a74693c9a5 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-04 23:10:49 +00:00
Semphris a4852f3a10 SDL_ShowFileDialogWithProperties with more options 2024-12-04 15:10:15 -08:00
SDL Wiki Bot 2ad5836d02 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-04 00:12:42 +00:00
SDL Wiki Bot 31d09909b6 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-03 23:04:47 +00:00
Ryan C. Gordon 46f43c2e6e asyncio: Remove `SDL_AsyncIOTask` from the public API. 2024-12-03 17:32:20 -05:00
Ryan C. Gordon 3ca629ceb5 asyncio: Allow file closes to request a flush/fsyncdata. 2024-12-03 17:32:20 -05:00
Ryan C. Gordon e79ce2a200 asyncio: Added async i/o APIs. 2024-12-03 17:32:20 -05:00
Eduard Gushchin 7293c18314 Fixed an inaccuracy in the return parameter information in the SDL_ConvertPixels function 2024-12-03 11:32:04 -08:00
Eduard Gushchin 401187eb6c Removed extra sa in SDL_ConvertSurfaceAndColorspace 2024-12-03 09:38:56 -08:00
Nicolas Allemand b7a31ead08 added "gpu" to the list of possible values of SDL_HINT_RENDER_DRIVER in SDL_hints.h 2024-12-03 09:06:40 -08:00
Eduard Gushchin 9fb8661684 Fixed an inaccuracy in the return parameter information in the SDL_SurfaceHasAlternateImages function 2024-12-03 08:41:30 -08:00
SDL Wiki Bot 068d9cc7d6 Sync SDL3 wiki -> header 
[ci skip]
 2024-12-02 00:37:15 +00:00
Ryan C. Gordon 2f59a1ce44
SDL_audio.h: Fixed a documentation typo (thanks, @JBetz!). 2024-12-01 19:36:03 -05:00
SDL Wiki Bot 3a1d76d298 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-29 22:32:15 +00:00
Ryan C. Gordon ce573b01f8 audio: Added SDL_IsAudioDevicePhysical and SDL_IsAudioDevicePlayback. 
Fixes #11529.
 2024-11-29 17:31:37 -05:00
Ryan C. Gordon bf9fa38920
SDL_audio.h: Fixed two typos. 2024-11-28 00:12:03 -05:00
Ryan C. Gordon f5ad66ef4b audio: Allow channel maps to specify -1 to mute a channel. 
Fixes #11373.
 2024-11-28 00:00:30 -05:00
SDL Wiki Bot 3303e9843f Sync SDL3 wiki -> header 
[ci skip]
 2024-11-28 04:42:44 +00:00
Ryan C. Gordon f852038384 filesystem: Added SDL_GetCurrentDirectory(). 
Fixes #11531.
 2024-11-27 23:42:11 -05:00
SDL Wiki Bot c0f1fe8e7f Sync SDL3 wiki -> header 
[ci skip]
 2024-11-28 04:36:33 +00:00
SDL Wiki Bot b8bbd29ce9 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-27 06:11:04 +00:00
SDL Wiki Bot 03d15c031b Sync SDL3 wiki -> header 
[ci skip]
 2024-11-25 22:44:00 +00:00
expikr d55e6dfc5e hint for which system cursor to use as default 
Co-Authored-By: Sam Lantinga <slouken@libsdl.org>
 2024-11-25 13:08:37 -08:00
SDL Wiki Bot 3c13bae64f Sync SDL3 wiki -> header 
[ci skip]
 2024-11-25 19:07:53 +00:00
SDL Wiki Bot e9fdcf6c60 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-25 17:20:21 +00:00
SDL Wiki Bot e14d939ead Sync SDL3 wiki -> header 
[ci skip]
 2024-11-24 17:41:07 +00:00
SDL Wiki Bot b02285d495 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-22 20:53:04 +00:00
Maia 97ddc9adf2 Fix outdated references to SDL symbols in docs. Fixes #11503 2024-11-22 15:52:31 -05:00
Ryan C. Gordon 615c935d11 events: Added SDL_RenderEvent. 
Fixes #11465.
 2024-11-22 15:01:09 -05:00
SDL Wiki Bot e94ba6e700 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-22 03:38:20 +00:00
SDL Wiki Bot 631c30527b Sync SDL3 wiki -> header 
[ci skip]
 2024-11-22 03:22:50 +00:00
Ryan C. Gordon 2e70944c44
gpu: Added an initial FAQ to the category documentation. 
Fixes #11478.
 2024-11-21 19:57:14 -05:00
Eduard Gushchin a4006e654e Fixed typo in the name of the SDL_GetAppMetadataProperty function in the description of the SDL_SetAppMetadataProperty function 2024-11-21 05:53:06 -08:00
SDL Wiki Bot fef001cb48 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-21 04:53:43 +00:00
Ryan C. Gordon e770b4e266
dialog: Clean up filter param documentation. 
The apostrophe was incorrect, but the type is auto linked in the wiki anyhow,
so don't write it out ourselves.
 2024-11-20 23:52:49 -05:00
SDL Wiki Bot 795ceae520 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-21 04:50:57 +00:00
Ryan C. Gordon ecae3789ab
SDL_dialog.h: Remove verbose docs on callback param from several functions. 
In the wiki, one can click on SDL_DialogFileCallback for these details, or
grep for the symbol in the headers to find the information.

Fixes #11504.
 2024-11-20 23:46:26 -05:00
SDL Wiki Bot d2dc0fa920 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-19 02:19:43 +00:00
Sam Lantinga d8f8cf3e99 Added SDL_HINT_JOYSTICK_HIDAPI_STEAM_HOME_LED 2024-11-18 14:50:37 -08:00
Sam Lantinga e027b85cc4 Validate that pixel formats have the correct attributes 
Also added a test to save and load as BMP format to make sure pixel transformations are working correctly.

Fixes https://github.com/libsdl-org/SDL/issues/11483
 2024-11-17 11:58:57 -08:00
SDL Wiki Bot 572cc7af63 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-16 04:44:23 +00:00
ChillerDragon 7d7ee43ddb stdinc: document SDL_strnlen and SDL_strlen 
See https://github.com/libsdl-org/sdlwiki/issues/635
 2024-11-15 23:43:51 -05:00
SDL Wiki Bot 7c5a2cd462 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-14 01:12:18 +00:00
Ryan C. Gordon 95c8a1cf7c
iostream: Update docs about return values and SDL_GetIOStatus(). 
Fixes #11395.
 2024-11-13 20:11:18 -05:00
SDL Wiki Bot c021c75737 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-14 00:30:41 +00:00
Ryan C. Gordon d20936b544
camera: Add some category docs about camera device warmup delays. 
Fixes #11454.
 2024-11-13 19:29:14 -05:00
SDL Wiki Bot 3877bf55a3 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-13 20:44:45 +00:00
SDL Wiki Bot c26dda10e0 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-13 20:38:45 +00:00
SDL Wiki Bot 20cd4290d7 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-13 04:49:12 +00:00
SDL Wiki Bot dcf6dd19c3 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-13 04:41:26 +00:00
SDL Wiki Bot 6c99a4b783 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-13 04:29:53 +00:00
Evan Hemsley 119b4fa5f5
GPU: Remove D3D11 backend and allow D3D12 to ingest DXBC (#11456) 2024-11-12 10:55:21 -08:00
Zack Middleton 8a2cac7aaa Fix SDL_PRIs64 to use standard PRId64 
PRIs64 doesn't exist in C standards.
 2024-11-08 12:37:14 +03:00
SDL Wiki Bot dbe82e685d Sync SDL3 wiki -> header 
[ci skip]
 2024-11-08 01:55:37 +00:00
Semphris 3e2ef64c98 Add SDL_SaveFile and SDL_SaveFile_IO functions 2024-11-07 17:55:02 -08:00
SDL Wiki Bot b0140fb1b4 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-08 00:35:43 +00:00
Sam Lantinga 97dac37373 Added SDL_HINT_ANDROID_LOW_LATENCY_AUDIO 2024-11-07 16:34:34 -08:00
SDL Wiki Bot fb2145f731 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-04 05:04:44 +00:00
Petar Popovic 96729e745a SDL_GetClosestFullscreenDisplayMode(): Rename parameter `mode` to `closest` 
Also: Check, if the parameter is NULL inside the function.
 2024-11-03 21:03:44 -08:00
SDL Wiki Bot cacfdc8cfa Sync SDL3 wiki -> header 
[ci skip]
 2024-11-03 05:23:05 +00:00
Sam Lantinga 7031b240df Added SDL_PROP_WINDOW_WAYLAND_VIEWPORT_POINTER 2024-11-02 22:22:29 -07:00
SDL Wiki Bot 0508f100e2 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-01 22:50:16 +00:00
Sam Lantinga 927d297161 Updated to version 3.1.7 for development 2024-11-01 15:49:31 -07:00
Sam Lantinga 78cc5c1734 Updated to version 3.1.6 for the preview release 2024-11-01 14:27:01 -07:00
SDL Wiki Bot 19af3a2b34 Sync SDL3 wiki -> header 
[ci skip]
 2024-11-01 19:42:29 +00:00
SDL Wiki Bot 68cc173d92 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-30 20:47:55 +00:00
expikr 7c968f1510 Update SDL_hints.h 2024-10-30 12:01:51 -07:00
expikr e2857fc5a2 Update SDL_mouse.c 2024-10-30 12:01:51 -07:00
SDL Wiki Bot 6647345be0 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-29 21:43:56 +00:00
Evan Hemsley b4dff42dcd
GPU: Add SDL_CancelGPUCommandBuffer (#11316) 
---------

Co-authored-by: Caleb Cornett <caleb.cornett@outlook.com>
 2024-10-29 14:43:22 -07:00
dv-senna 149ecffd6f
SDL_vulkan.h: undefine VK_DEFINE_HANDLER and VK_DEFINE_NON_DISPATCHABLE_HANDLE 
Allows including vulkan.hpp in user code in C++ before SDL_vulkan.h w/o errors.
Fixes:  https://github.com/libsdl-org/SDL/issues/11328 .
 2024-10-29 20:30:10 +03:00
SDL Wiki Bot e0d019c941 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-28 07:00:30 +00:00
SDL Wiki Bot 3922bcec95 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-27 21:42:48 +00:00
Petar Popovic 04a478b6a9 SDL_Enumerate[Storage]Directory() comments: Use enum constant names instead of integers. 2024-10-27 14:41:33 -07:00
SDL Wiki Bot dcd4ddb043 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-24 18:38:45 +00:00
Ryan C. Gordon 10e52e1899
docs: Added more '\threadsafety` tags. 
Reference Issue #7140.
 2024-10-24 14:37:23 -04:00
Petar Popovic db4e2ccbac Allow redefinition of only one macro SDL_SINT64_C SDL_UINT64_C 2024-10-24 07:37:44 -07:00
Susko3 d0cf2c19d1
Allow defining custom SDL_SINT64_C and SDL_UINT64_C macros (#11315) 2024-10-23 17:03:13 -07:00
Ryan C. Gordon 7108291d0b video: Change SDL_GLattr to SDL_GLAttr. 2024-10-23 18:50:52 -04:00
Ryan C. Gordon c0e9205a92 video: Change capitalization on various OpenGL attribute typedefs. 2024-10-23 18:50:52 -04:00
Ryan C. Gordon 3c506630c3 video: Turn several OpenGL attribute enums into integer typedefs. 
Fixes #11308.
 2024-10-23 18:50:52 -04:00
SDL Wiki Bot a04fda211c Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 21:01:26 +00:00
Petar Popovic 540db0d164 Bumped version of macro 'main' to 3.1.3 2024-10-23 16:16:07 -04:00
SDL Wiki Bot 370521363a Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 19:57:33 +00:00
SDL Wiki Bot 299587fa64 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 19:31:40 +00:00
Petar Popovic 5e855d82e3 Manually bump versions of non-function identifiers introduced after 3.1.3 to 3.2.0 2024-10-23 11:17:46 -07:00
SDL Wiki Bot acfc223e15 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 16:37:46 +00:00
Evan Hemsley 423337796c
GPU Vulkan: Use dedicated allocation for download buffers (#11298) 2024-10-23 09:37:06 -07:00
SDL Wiki Bot 24b376ef18 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 16:30:58 +00:00
Ryan C. Gordon 1c1706a00b
fnsince: update `\since` policy for documentation. 
Everything in SDL3 up to the ABI lock is reported as available since 3.1.3.
Everything else will be reported as since 3.2.0 (what will be the first
official release).

Also ran a Perl script over the headers to change everything to 3.1.3 that
wasn't an API function, since fnsince.pl can't manage those. If there's a
macro or datatype that has snuck in that needs to be 3.2.0 instead, we'll
have to manually fix it up, but it shouldn't be a big deal in any case.

Reference PR #11304.
 2024-10-23 12:22:43 -04:00
SDL Wiki Bot 63ef5a2369 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 05:42:03 +00:00
Petar Popovic fd530d029f Fixed typo in SDL_clipboard.h 2024-10-22 22:41:30 -07:00
SDL Wiki Bot 7b6416add0 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-23 05:41:03 +00:00
Petar Popovic af1c165352 Set version of new identifiers after 3.1.3 release to 3.1.6 2024-10-22 22:40:07 -07:00
Sam Lantinga c134dd6e5e Fixed typo in the channel layout documentation 2024-10-22 17:46:57 -07:00
Ryan C. Gordon 4a8eadf167
include: Fixed typo in SDL_CopyFile's documentation. 
Fixes https://github.com/libsdl-org/sdlwiki/issues/623
 2024-10-22 20:12:04 -04:00
SDL Wiki Bot d9e6fe0b7a Sync SDL3 wiki -> header 
[ci skip]
 2024-10-22 20:03:14 +00:00
Ryan C. Gordon f5c27a3a2c
render: Corrected docs for SDL_SetRenderVSync(). 2024-10-22 16:01:58 -04:00
SDL Wiki Bot a42c9ec5f7 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-22 17:49:11 +00:00
Ryan C. Gordon 2318961b6f
docs: Add `\threadsafety` to some low-hanging fruit across a few headers. 
Reference Issue #7140.
 2024-10-22 13:48:35 -04:00
Ryan C. Gordon eed11ad6d6
docs: Fixed example code for SDL_qsort_r() and SDL_bsearch_r(). 2024-10-22 13:48:35 -04:00
Ryan C. Gordon 19a1175c02
include: Updated docs on SDL_TouchFingerEvent. 
Fixes #4159.
 2024-10-22 10:41:31 -04:00
Sam Lantinga 3d47877bb4 Added SDL_EVENT_RENDER_DEVICE_LOST 
This is sent when the device is lost and can't be recovered.

Also fixed the vulkan renderer so it returns errors appropriately and will log and break if debug mode is enabled.
 2024-10-21 13:28:40 -07:00
SDL Wiki Bot 54e52d055f Sync SDL3 wiki -> header 
[ci skip]
 2024-10-21 18:06:39 +00:00
Jordan Christiansen 9c848e08e4
docs: Explain events for already plugged in controllers (#11286) 2024-10-21 11:06:05 -07:00
Petar Popovic 4b54e32231 Tweak android path functions comment tag \sa 2024-10-20 16:38:07 -07:00
Petar Popovic 679dd4b181 SDL_RequestAndroidPermission() comment: Add link to android permissions website 2024-10-20 10:13:03 -04:00
SDL Wiki Bot eb1451536e Sync SDL3 wiki -> header 
[ci skip]
 2024-10-20 14:12:45 +00:00
Petar Popovic 5819d4b360 SDL_CreateRenderer() comment: Remove mention of flags 2024-10-20 10:12:14 -04:00
Frank Praznik 541ba33714
Fix SDL_GetClosestFullscreenDisplayMode documentation 
It returns false on failure, not NULL.
 2024-10-19 16:01:08 -04:00
SDL Wiki Bot 2668558c5c Sync SDL3 wiki -> header 
[ci skip]
 2024-10-19 17:21:09 +00:00
Sam Lantinga 153f90a725 Revert "Use the correct return type for SDL_GetAndroidJNIEnv()" 
This reverts commit 2d3fa03d53.

Different JDK implementations define JNIEnv differently for C++, so we can't provide the definition here.

Fixes:
/usr/lib/jvm/temurin-11-jdk-amd64/include/jni.h:195:17: error: conflicting declaration ‘typedef struct JNIEnv_ JNIEnv’
/home/runner/work/sdlwiki/sdlwiki/.github/../external/SDL3/include/SDL3/SDL_system.h:266:24: note: previous declaration as ‘typedef struct _JNIEnv JNIEnv’
 2024-10-19 10:20:50 -07:00
Maia a48fa675be Fix formatting 2024-10-18 13:45:04 -07:00
Sam Lantinga 1d23d2c3c2 Renamed SDL_SANDBOX_UNKNOWN to SDL_SANDBOX_UNKNOWN_CONTAINER 2024-10-18 12:45:07 -07:00
Frank Praznik a7da3ad59b x11: Support sorting displays via the priority hint 
Store the connector name for displays and use it for sorting them according to priority, if the hint is set.
 2024-10-18 13:09:08 -04:00
Frank Praznik 0faf9dc4a4 kmsdrm: Support sorting displays via the priority hint 
Use the connector name for displays and sort them according to priority, if the hint is set.
 2024-10-18 13:09:08 -04:00
SDL Wiki Bot 2654d5d48b Sync SDL3 wiki -> header 
[ci skip]
 2024-10-18 02:34:29 +00:00
Sam Lantinga e81e917c5e Added an OpenVR video driver (thanks @cnlohr!) 2024-10-17 19:38:04 -07:00
Sam Lantinga 2d3fa03d53 Use the correct return type for SDL_GetAndroidJNIEnv() 
This prevents application code from having to cast to JNIEnv everywhere.
 2024-10-17 12:02:24 -07:00
SDL Wiki Bot c48fbbb067 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-16 23:48:38 +00:00
Sam Lantinga d6981da5a4 Added SDL_GetSandbox() 
This adds support for detecting whether you're running in a sandbox on macOS
 2024-10-16 16:47:29 -07:00
Ozkan Sezer 3ebfdb04be SDL_stdinc.h: provide a prototype for strdup for __clang_analyzer__ case 
Because strdup is not ANSI but POSIX, and its prototype might be hidden..

... and re-enable clang-tidy in CI for LoongArch64.

Fixes:  https://github.com/libsdl-org/SDL/issues/11219.
 2024-10-16 21:50:40 +03:00
Maia d9df87f19f Fix syntax of trailing doc comments 2024-10-16 11:28:00 -07:00
SDL Wiki Bot b4554a8a75 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-15 22:37:00 +00:00
Sam Lantinga 97f1da73da Rename GPU properties for consistency 2024-10-15 15:36:26 -07:00
Caleb Cornett 9af5ffcfbe
Improve support for private platforms (#11220) 2024-10-15 18:02:07 -04:00
SDL Wiki Bot dede2ab86f Sync SDL3 wiki -> header 
[ci skip]
 2024-10-15 17:53:13 +00:00
Frank Praznik 553fc5fe0e wayland: Expose displays in a deterministic order, and attempt to better handle selecting a primary display. 
Wayland can expose displays in any arbitrary order, and doesn't have the native concept of a primary display. However, there are games that presume that the first listed display is the primary, which can lead to problems if that output isn't necessarily the ideal one, as they may use that display to build a resolution list or as the default fullscreen output. This sorts displays by position, then attempts to find the primary display, first by querying the explicit ordering hint, then the GNOME DBus property, then tries to determine the 'best' display according to the criteria that is generally ideal for games and media playback.

The makes the list of displays deterministic, as long as the desktop configuration remains static, with a reasonably appropriate one prioritized as primary, even if there is no explicit way to retrieve the primary display. In the case where a user has a particularly esoteric physical display configuration, the new hint enables explicitly overriding the sorting and selection logic, allowing the entire display order to be customized, if necessary.
 2024-10-15 13:52:35 -04:00
SDL Wiki Bot ce49465b13 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-15 03:30:54 +00:00
Sam Lantinga 72bae5167e Updated documentation 
Fixes https://github.com/libsdl-org/sdlwiki/issues/616
 2024-10-14 20:30:22 -07:00
SDL Wiki Bot b865708039 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-14 16:02:54 +00:00
Sam Lantinga 0b6ad8bf62 Improved the documentation for SDL_SetWindowShape() 
Fixes https://github.com/libsdl-org/SDL/issues/11199
 2024-10-14 09:02:04 -07:00
SDL Wiki Bot 3733b1d5d8 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-14 06:46:10 +00:00
Ryan C. Gordon c20918b0fb render: Add SDL_RenderDebugText(). 
Fixes #11201.
 2024-10-14 02:45:33 -04:00
SDL Wiki Bot db78c0f563 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-13 19:15:18 +00:00
Sam Lantinga a8ca024495 Added SDL_GetDefaultLogOutputFunction() 
Fixes https://github.com/libsdl-org/SDL/issues/10603
Closes https://github.com/libsdl-org/SDL/pull/11106
 2024-10-13 12:14:46 -07:00
SDL Wiki Bot aed1f76248 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-13 16:27:10 +00:00
Sam Lantinga a567786762 Added SDL_SetErrorV() 2024-10-13 09:26:25 -07:00
Sam Lantinga d5e02474ac Fixed SDL_oldnames.h to use the correct new names 2024-10-13 09:06:46 -07:00
SDL Wiki Bot fd9f2ae5b5 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-13 00:14:05 +00:00
Maia 01c9c1d0eb Document main callbacks API thread safety 2024-10-12 20:13:30 -04:00
Semphris 05c53b5ab0 Add macro guards for OpenGL <=1.3 function prototypes 
- `#define SDL_OPENGL_1_NO_PROTOTYPES` to hide function prototypes
- `#define SDL_OPENGL_1_FUNCTION_TYPEDEFS` to add PFNGL*PROC function types
 2024-10-12 11:21:07 -04:00
SDL Wiki Bot 365dba6de8 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-12 15:08:54 +00:00
Daniel Gibson 33366b0a4e Fix SDL_MAIN_USE_CALLBACKS with Android, introduce SDL_MAIN_EXPORTED 
My simplification of the conditions for including SDL_main_impl.h
had one problem: I forgot that SDL_main_impl.h must be included
even on Android when SDL_MAIN_USE_CALLBACKS is used, because then a
SDL_main() function that makes sure the callbacks get called is needed,
and that function is implemented in SDL_main_impl.h

But OTOH, even when SDL_MAIN_USE_CALLBACKS is used, SDL_main_impl.h
should not implement a standard `int main(...)` function on Android
(because there the SDL-using native code is compiled as a library and
 the entry point is in SDLActivity.java, which calls SDL_main()
 in said library).

So the check for platforms that don't have *any* native main function
but just SDL_main() called from the outside should be handled in
SDL_main_impl.h, so both the normal and the callback case can avoid
generating a standard main() in the same way.
To do this, SDL_MAIN_EXPORTED is defined for platforms like Android,
where the real entry point (main() function) is outside of the code
that uses SDL, so
- SDL_main() must be visibly exported with SDL_DECLSPEC, so the outside
  code can call it
- SDL_main_impl.h must not implement a "real" main() function

Another small change based on this is defining SDLMAIN_DECLSPEC
at a more general place.

If another platform like Android (where the entry point is somewhere
else entirely, possibly implemented in a different programming language)
turns up, defining SDL_MAIN_NEEDED (so the users main() is renamed
to SDL_main()) and SDL_MAIN_EXPORTED should be all that's needed on the
SDL_main.h side - and if not then at least the implementation is
cleaner and clearer now, IMHO.

fixes #11162
 2024-10-11 18:54:29 -07:00
Andrei Rafael Brongel 86ef790a23 explicit cast to int in SDL_bits 2024-10-11 18:52:06 -07:00
Petar Popovic 3086b25c4e Set hint SDL_HINT_MAC_SCROLL_MOMENTUM version to SDL 3.1.4. 2024-10-11 17:33:52 -07:00
SDL Wiki Bot e31c68427a Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 23:35:37 +00:00
Evan Hemsley 6ea4a66451
GPU: Add SDL_CalculateGPUTextureFormatSize (#11146) 
---------

Co-authored-by: Sam Lantinga <slouken@libsdl.org>
 2024-10-10 16:34:38 -07:00
Petar Popovic 6d85127560 Rename hint string literal SDL_HINT_MAC_SCROLL_MOMENTUM 2024-10-10 16:16:36 -07:00
SDL Wiki Bot 8aaaeb7560 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 17:02:43 +00:00
SDL Wiki Bot 2a9cb68b91 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 16:43:29 +00:00
SDL Wiki Bot e4b1a9f382 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 15:24:38 +00:00
SDL Wiki Bot ac6b9e2d19 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 15:06:56 +00:00