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

3895 Commits

Author SHA1 Message Date
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
Caleb Cornett feb10434a1 Order by subsystem 2024-10-29 08:50:50 -07:00
Caleb Cornett b2f216f9e2 Add GPU to iOS build config 2024-10-29 08:50:50 -07: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
Ivan Epifanov 6da4d94abf VITA: implement camera subsystem 2024-10-17 10:24:17 -07:00
Daniel Ludwig 9a5420118a Define SDL_DIALOG_DUMMY in SDL_build_config_xbox.h 2024-10-17 12:45:37 +03:00
Sam Lantinga dd955332a2 Removed SDL_build_config_emscripten.h 
The Emscripten build uses cmake, so we don't need the standalone config header.

Fixes https://github.com/libsdl-org/SDL/issues/11236
 2024-10-16 18:16:46 -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
Sam Lantinga 9cf388f260 Re-added HAVE_FDATASYNC and HAVE_GETHOSTNAME for platforms that have them. 2024-10-16 11:25:57 -07:00
Sam Lantinga ed1ec236c1 Removed fdatasync and gethostname definitions from platforms that don't have them 
As verified by CMake builds in CI
 2024-10-16 07:39:30 -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
Anonymous Maarten 45dfdfbb7b Add parametrized build script 
[ci skip]
 2024-10-14 21:30:48 +02: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
Cameron Cawley aebb64efa1 Remove leftover ARM SIMD code 2024-10-12 11:13:37 -07: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
Sam Lantinga c8f5f6d47a Added SDL_DelayPrecise() 
SDL_DelayNS() now passes through to the high precision OS delay function, and SDL_DelayPrecise() tries to busy wait to get as close as possible to the desired wait time.

Fixes https://github.com/libsdl-org/SDL/issues/11141
 2024-10-10 08:06:18 -07:00
Sam Lantinga 28a70a5b71 Use the correct version for the \since field 2024-10-10 08:06:18 -07:00
SDL Wiki Bot 4707bb730e Sync SDL3 wiki -> header 
[ci skip]
 2024-10-10 00:32:39 +00:00
Sam Lantinga ee9b6204cf Updated to version 3.1.5 for development 
We should bump the version immediately before and after release so the release version corresponds to a fixed snapshot of code.
 2024-10-09 11:02:01 -07:00
SDL Wiki Bot 02f3a96476 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-09 16:49:57 +00:00
Sam Lantinga f8eac30276 Added SDL_StepBackUTF8() 2024-10-09 09:49:10 -07:00
Daniel Ludwig 5b6342a00d Default SDL_HINT_JOYSTICK_GAMEINPUT to "1" on GDK platforms 2024-10-09 07:30:13 -07:00
Delta 8e6ead2f7b
[GPU] Added ASTC texture format support (#11116) 2024-10-08 18:45:04 -04:00
Ryan C. Gordon 02434cd293
emscripten: Fixes for data addresses above 2gb 
This includes both wasm64 and wasm32 when addressing more than 2gb of memory.

Fixes: #9052

(Manually cherry-picked from 3deb07ea395373204462130c1e062bc1f71fe060.)
 2024-10-08 17:41:18 -04:00
Sam Lantinga c34790f9f1 Fixed spacing 2024-10-08 11:49:08 -07:00
Daniel Gibson 312ecc4a52 SDL_main.h: Remove dead code for hypothetical C++ platforms 
If WinRT returns after all, or a similarly bad platforms turns up,
the code can still be found in the git history.
But keep in mind that it then will have to be added *before* the
 #if ( defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_NEEDED) ...
case for platforms that support plain C to work correctly
 2024-10-08 11:47:33 -07:00
Daniel Gibson 823b218051 Simplify code to include SDL_main_impl.h in SDL_main.h 
Basically all platforms where SDL_main.h renames main() to SDL_main()
use the platform-specific main() (or WinMain() or whatever)
implementations in SDL_main_impl.h - and that renaming is enabled with:
  #if defined(SDL_MAIN_NEEDED) || defined(SDL_MAIN_AVAILABLE) \
      || defined(SDL_MAIN_USE_CALLBACKS)
    #define main SDL_main
  #endif

The only exception is Android, where main() *is* renamed, but
SDL_main_impl.h isn't used, because SDL_main() is called from Java.

So I think it's cleaner and less error-prone (for adding additional
platforms that need SDL_main() in the future), to use the same check
for including SDL_main_impl.h as is used for `#define main SDL_main`
and only list the exceptions (currently Android) there explicitly.

If new platforms like Android turn up, they can easily be added there
by inserting "|| defined(SDL_PLATFORM_WEIRDPLATFORM)" right next
to the Android check.

See also https://github.com/libsdl-org/SDL/issues/11068#issuecomment-2399907535
 2024-10-08 11:47:33 -07:00
SDL Wiki Bot d9f8474dd7 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-08 17:38:17 +00:00
SDL Wiki Bot 95aaaa3232 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-08 17:06:41 +00:00
Frank Praznik 158ba93d61
Update some window function documentation 
Updates some documentation to correspond with changes made since it was originally written, clarifies some function behavior, and includes some assorted typo fixes.
 2024-10-08 13:05:20 -04:00
SDL Wiki Bot 7acfdfd3e7 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-08 16:50:41 +00:00
SDL Wiki Bot 326ab439d7 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-08 15:09:24 +00:00
Sam Lantinga fb07ab91c6 Improved SDL_main documentation and remove extern "C" comment. 
It turns out that this is incorrect and any C linkage is already taken care of by SDL when redefining SDL_main.

Fixes https://github.com/libsdl-org/SDL/issues/11068
 2024-10-08 08:07:54 -07:00
SDL Wiki Bot 03fa9ff0b0 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-08 13:59:10 +00:00
Sam Lantinga f6fa617139 Define SDL_DIALOG_DUMMY in SDL_build_config.h as needed 2024-10-07 19:52:50 -07:00
Sam Lantinga 4627283eca Allow building both Cocoa and dummy dialog implementations 
This allows us to remove platformFilters from the Xcode project, which is not supported in Xcode 12.
 2024-10-07 18:01:39 -07:00
Frank Praznik 2fd12b2e8a
keyboard: Note that enabling text input can also enable an IME 
An active IME can potentially eat key events, particularly dead keys and parts of a compose sequence, so note this behavior in the documentation.
 2024-10-07 19:21:34 -04:00
Naman Dixit 54e622c2e6 Use the printf vararg verification macros when compiling with clang 2024-10-06 22:19:52 -07:00
SDL Wiki Bot d0ef58b442 Sync SDL3 wiki -> header 
[ci skip]
 2024-10-06 23:03:29 +00:00
SDL Wiki Bot cbb9a16367 Sync SDL3 wiki -> header 
'[ci skip]'
 2024-10-06 22:58:06 +00:00
Jan Sedivy bf54eddba9 macOS: Clarify when macOS hints need to be set 2024-10-06 12:36:42 -07:00
Jan Sedivy c2b98e21ba macOS: Add hint for smooth SDL_EVENT_MOUSE_WHEEL values 2024-10-06 12:36:42 -07:00
SDL Wiki Bot e59078ac6f Sync SDL3 wiki -> header 2024-10-06 18:31:17 +00:00
Ryan C. Gordon 9e74ada7b8
gpu: fixed formatting in docs. 2024-10-06 14:30:07 -04:00
Frank Praznik c9ffa3f9e1
Remove vestiges of the TAKE_FOCUS window event 
The event was removed, so remove the rename define and update the coccinelle script.
 2024-10-06 10:02:53 -04:00
David Fort e00b1fdd67 clipboard: include mime types in SDL_ClipboarUpdate 
This patch modifies the clipboard handling so that when we receive an external
clipboard update, the suppported mime types are included in the SDL_ClipboarUpdate
event. The patch also introduces the owner field that allows to know if the update
is because we own the clipboard (internal update) or if it was an external update.
 2024-10-05 18:19:10 -07:00
Sam Lantinga b8e72b0969 Note that creating a renderer will fail if the preferred renderer isn't available. 
Fixes https://github.com/libsdl-org/SDL/issues/11077
 2024-10-05 09:55:26 -07:00
zshoals 1ca45c5891 Fix typo: DiretMedia->DirectMedia 2024-10-05 00:08:01 -04:00
Ryan C. Gordon 8c3f88b495
docs: Wrote CategoryVulkan. 2024-10-04 16:55:50 -04:00
SDL Wiki Bot 369b93771b Sync SDL3 wiki -> header 2024-10-04 20:38:03 +00:00
SDL Wiki Bot deeffaa8d6 Sync SDL3 wiki -> header 2024-10-04 20:36:26 +00:00
Ryan C. Gordon 84ecf7fd3e
docs: Add CategorySurface text. 2024-10-04 16:35:49 -04:00
SDL Wiki Bot e292d1f5ac Sync SDL3 wiki -> header 2024-10-04 20:27:58 +00:00
Sam Lantinga d5af0c7e09 Added missing parentheses 2024-10-04 13:27:13 -07:00
SDL Wiki Bot 5a60d073c0 Sync SDL3 wiki -> header 2024-10-04 20:24:40 +00:00
SDL Wiki Bot a3413e050b Sync SDL3 wiki -> header 2024-10-04 20:23:29 +00:00
Ryan C. Gordon c25423b94c
docs: Filled in some category pages. 2024-10-04 16:22:00 -04:00
Sam Lantinga a57ecad648 Fixed documentation typos 2024-10-04 13:04:27 -07:00
SDL Wiki Bot 37315110c1 Sync SDL3 wiki -> header 2024-10-04 19:50:14 +00:00
Anonymous Maarten f26dd52090 SDL_GetProcessProperties is missing a SDLCALL 2024-10-04 21:48:27 +02:00
SDL Wiki Bot 64cbf02dbf Sync SDL3 wiki -> header 2024-10-04 19:35:00 +00:00
Ryan C. Gordon ffe4e571d1
wikiheaders: regex hack to make a URL not confuse wikilink genertion. 2024-10-04 15:34:18 -04:00
SDL Wiki Bot a7e4e9219a Sync SDL3 wiki -> header 2024-10-04 19:29:06 +00:00
cosmonaut e8c852d77c GPU: re-add parens to wiki intro 2024-10-04 12:28:05 -07:00
SDL Wiki Bot f592a35439 Sync SDL3 wiki -> header 2024-10-04 18:32:44 +00:00
cosmonaut 12d007038c GPU: wiki header link typo 2024-10-04 11:31:52 -07:00
SDL Wiki Bot f275731e18 Sync SDL3 wiki -> header 2024-10-04 18:30:06 +00:00
cosmonaut f3285b01c8 GPU: Intro fixes 2024-10-04 11:29:27 -07:00
SDL Wiki Bot 93c7521dd5 Sync SDL3 wiki -> header 2024-10-04 18:22:19 +00:00
Evan Hemsley c1084bfaa3
GPU Introduction (#11062) 2024-10-04 11:21:36 -07:00
cosmonaut 21e7fa45e8 GPU: fix padding field typo 2024-10-04 10:45:47 -07:00
SDL Wiki Bot f859d69c44 Sync SDL3 wiki -> header 2024-10-04 16:14:38 +00:00
Sam Lantinga 6c64c62114 Rename SDL_BUTTON() to SDL_BUTTON_MASK() 
Fixes https://github.com/libsdl-org/SDL/issues/11056
 2024-10-04 09:13:59 -07:00
SDL Wiki Bot d529407ce7 Sync SDL3 wiki -> header 2024-10-04 15:58:03 +00:00
Sam Lantinga fe2880fcda Rename SDL_SetThreadPriority() to SDL_SetCurrentThreadPriority() 
Fixes https://github.com/libsdl-org/SDL/issues/11055
 2024-10-04 08:57:03 -07:00
Sam Lantinga 43e7ce7dfc Updated to version 3.1.3 for the preview release 2024-10-03 23:01:55 -07:00
SDL Wiki Bot ca0b1eaf5a Sync SDL3 wiki -> header 2024-10-04 05:54:33 +00:00
Sam Lantinga 93c27a6675 Fixed the documentation for consistency. 2024-10-03 22:54:05 -07:00
SDL Wiki Bot 3ae2af8aa1 Sync SDL3 wiki -> header 2024-10-04 05:53:50 +00:00
Ryan C. Gordon 9a5d5a2839 video: Improve the EGL attribute callbacks. 
Now it has access to information it needs and it's clear who is reponsible
for memory management.

Fixes #11039.
 2024-10-03 22:52:52 -07:00
Ryan C. Gordon 191f3ecbbc render: Restore previous policy for converting window/render coordinates. 
Before this commit, it would adjust for the logical presentation settings.
Now, it works as it did before the logical presentation render target was
removed: it takes current viewport and scale into account, as well.

Fixes #10978.
 2024-10-03 16:31:56 -04:00
Ethan Lee a0de6c4abf Add properties to SDL_IOStreams returned by IOFromMem 2024-10-02 22:09:09 -07:00
Ryan C. Gordon d287feaddf
render: Remove non-pointer args' const qualifiers on SDL_RenderTextureRotated. 
Reference Issue #11032.
 2024-10-02 15:31:20 -04:00
SDL Wiki Bot e3757f072b Sync SDL3 wiki -> header 2024-10-02 19:28:35 +00:00
Ryan C. Gordon 35b002be82
audio: Clarified SDL_GetAudioStreamQueued docs. 2024-10-02 15:27:46 -04:00
Sam Lantinga d5fe6dd627 Don't use const for non-pointer API parameters 2024-10-02 09:17:31 -04:00
Sam Lantinga 91b074beb7 Removed SDL_IPHONE_MAX_GFORCE 
We no longer support interpreting the accelerometer as a joystick.

Fixes https://github.com/libsdl-org/SDL/issues/11005
 2024-10-01 18:00:22 -07:00
SDL Wiki Bot 34033d5838 Sync SDL3 wiki -> header 2024-10-01 18:45:52 +00:00
Sam Lantinga eced9f58a9 Added a userdata parameter for EGL attribute callbacks 
Fixes https://github.com/libsdl-org/SDL/issues/11013
 2024-10-01 11:45:19 -07:00
SDL Wiki Bot 798c9574d0 Sync SDL3 wiki -> header 2024-10-01 17:46:16 +00:00
Sam Lantinga 89e68aa801 Added missing return value documentation for bsearch() 2024-10-01 10:45:32 -07:00
Sam Lantinga 4fa92d233d Include stdbool.h when using Visual Studio 2017+ 
Also cleaned up some incorrect return values from bool functions.
 2024-10-01 09:57:59 -07:00
Anthony 5f5379dc99
Add `SDL_IsTV()` (#11004) 
Moved SDL_IsAndroidTV() out of public API, to match SDL_IsAndroidTablet().

Added SDL_IsTV(), to mirror existing SDL_IsTablet().
 2024-10-01 09:20:00 -07:00
SDL Wiki Bot 6bcf2f919a Sync SDL3 wiki -> header 2024-10-01 16:16:44 +00:00
Ryan C. Gordon 0b5e01a305 loadso: library handles are now `SDL_SharedObject*` instead of `void*`. 
Improved the SDL_loadso.h documentation a little, too.

Fixes #11009.
 2024-10-01 12:16:10 -04:00
SDL Wiki Bot f351395c46 Sync SDL3 wiki -> header 2024-10-01 15:10:40 +00:00
Sam Lantinga 3234a3b902 Simplified internal SDL_Surface structure 2024-10-01 08:10:04 -07:00
Sam Lantinga 1f3a0d12e6 Made texture size and format public in the API 
Also added refcount to textures so they can be retained by application code.
 2024-10-01 08:10:04 -07:00
Ryan C. Gordon b4fcd1f345
pen: Corrected some documentation. 
Fixes #10863.
 2024-10-01 10:24:17 -04:00
Sam Lantinga e3dbd74fe7 Improved documentation for SDL_Surface fields 2024-09-30 21:34:00 -07:00
SDL Wiki Bot c16d7c87d6 Sync SDL3 wiki -> header 2024-09-30 18:18:49 +00:00
Sam Lantinga ab832f1be0 Added documentation for qsort and bsearch functions 2024-09-30 11:18:17 -07:00
SDL Wiki Bot dcc7560a5c Sync SDL3 wiki -> header 2024-09-30 17:23:50 +00:00
Evan Hemsley afdf325fb4
GPU: Add swapchain dimension out params (#11003) 2024-09-30 10:23:19 -07:00
Ryan C. Gordon 1787d6ca5c main: SDL_AppQuit() now reports the result value. 
Fixes #10994.
 2024-09-29 23:24:04 -04:00
SDL Wiki Bot 62938837c2 Sync SDL3 wiki -> header 2024-09-29 01:10:39 +00:00
Evan Hemsley fc242abbd2
GPU: recreate swapchain on window pixel size change event (#10985) 2024-09-28 18:09:56 -07:00
Sam Lantinga a923771978 Added SDL_murmur3_32() 2024-09-28 17:19:01 -07:00
Sam Lantinga 039148fb0e Updated check for stdbool.h 
If you're building in a C99 or newer environment, we'll automatically include stdbool.h.

If you're building in a C89 or C90 environment, we'll assume that stdbool.h isn't available and define bool as an unsigned char. If you have a working stdbool.h and want SDL to use it, you can either include stdbool.h before SDL headers, or define SDL_INCLUDE_STDBOOL_H in your project.

Closes https://github.com/libsdl-org/SDL/pull/10980
 2024-09-28 16:55:09 -07:00
Petar Popovic dee62e1b47 Remove trailing comma in enum 2024-09-28 17:47:37 +03:00
Ryan C. Gordon 7d21a49c9c filesystem: SDL_EnumerateDirectoryCallback uses an enum now, not an int. 
Fixes #10955.
 2024-09-28 01:33:40 -04:00
SDL Wiki Bot 0542bbbf1a Sync SDL3 wiki -> header 2024-09-27 22:55:29 +00:00
Ryan C. Gordon 428f2f35be filesystem: SDL_CreateDirectory should make parent directories. 
Fixes #10502.
 2024-09-27 18:54:18 -04:00
SDL Wiki Bot 8d6b397cd8 Sync SDL3 wiki -> header 2024-09-27 21:11:58 +00:00
Sam Lantinga 3f446d8fb5 Minor cleanup 2024-09-27 14:10:46 -07:00
SDL Wiki Bot 8377cad974 Sync SDL3 wiki -> header 2024-09-27 20:50:17 +00:00
cosmonaut c39e8298b7 GPU: Document swapchain dimensions 2024-09-27 13:49:27 -07:00
SDL Wiki Bot 0e5a49542d Sync SDL3 wiki -> header 2024-09-27 20:39:24 +00:00
David Fort f32e96f5e2 clipboard: add SDL_ClipboardMimeTypes 
This function allows to retrieve the available mime types without doing any
synthesizing.
 2024-09-27 13:38:40 -07:00
SDL Wiki Bot 0befa7d8e9 Sync SDL3 wiki -> header 2024-09-27 20:27:48 +00:00
cosmonaut eedd2039f9 GPU: 32-bit component texture formats 2024-09-27 16:26:43 -04:00
SDL Wiki Bot 769ff47461 Sync SDL3 wiki -> header 2024-09-27 19:50:13 +00:00
Evan Hemsley 05d0656bd6
GPU: Simultaneous compute pass read-write (#10965) 2024-09-27 12:49:37 -07:00
Caleb Cornett 5ff6e8d522
GPU: Add enable_depth_clip to RasterizerState (#10964) 2024-09-27 11:18:54 -05:00
Sam Lantinga 04bb105d09 Added header for SDL_ThreadID type 2024-09-27 08:16:49 -07:00
SDL Wiki Bot c7442b04f0 Sync SDL3 wiki -> header 2024-09-27 07:30:57 +00:00
Evan Hemsley be401dd1e3
GPU: More robust error reporting (#10958) 
---------

Co-authored-by: Ethan Lee <flibitijibibo@gmail.com>
Co-authored-by: Caleb Cornett <caleb.cornett@outlook.com>
 2024-09-27 00:30:18 -07:00
SDL Wiki Bot 0d593cf39a Sync SDL3 wiki -> header 2024-09-26 23:29:38 +00:00
Ryan C. Gordon f267ec7681
filesystem: Improve docs, make some promises about overwrites and file caches. 
Note that SDL_FlushIO() doesn't make promises about file data sync but that
is intended to be changed in the IOStream code in a later commit.

Fixes #10886.
 2024-09-26 19:29:03 -04:00
SDL Wiki Bot c1587b1eac Sync SDL3 wiki -> header 2024-09-26 23:26:52 +00:00
Sam Lantinga 125e592844 Added SDL_ShouldInit() and SDL_ShouldQuit() 
These are handy functions to support thread-safe initialization and shutdown.
 2024-09-26 16:26:12 -07:00
Ryan C. Gordon 4e09e58f62
include: Small clarification on directory enumeration documentation. 2024-09-26 16:39:35 -04:00
Anonymous Maarten 345cae361d Document mode parameter of SDL_GetRenderLogicalPresentation 2024-09-26 16:12:13 +02:00
SDL Wiki Bot 59d69a3ba3 Sync SDL3 wiki -> header 2024-09-26 04:21:40 +00:00
Sam Lantinga d9a7da4fac Optimized SDL_HasEvent() and SDL_HasEvents() 
Also document the counting behavior of SDL_PEEKEVENT.

Fixes https://github.com/libsdl-org/SDL/issues/6209
 2024-09-25 21:20:00 -07:00
SDL Wiki Bot 81644d260f Sync SDL3 wiki -> header 2024-09-25 20:31:24 +00:00
Ryan C. Gordon 122cd4db2b
include: Added `\threadsafety` notes to all SDL_render.h functions. 2024-09-25 16:30:04 -04:00
SDL Wiki Bot 276969cd58 Sync SDL3 wiki -> header 2024-09-25 20:27:11 +00:00
Ryan C. Gordon 4c48ff51f8 render: SDL_RenderPresent now behaves when a render target is currently set. 
It'll temporarily unbind it, draw letterboxing if necessary, present, and
then rebind the previous render target.
 2024-09-25 16:26:36 -04:00
Ryan C. Gordon 7a6a0becb8 render: Fixed a FIXME for SDL_SetRenderViewport with a negative size. 2024-09-25 16:26:36 -04:00
Ryan C. Gordon 54459def69 render: Remove the logical presentation render target. 
Now we render directly to the window, scaling as appropriate. This fixes some
concerns the render target introduced, like the quality of the final scaled
output, how to step outside of the logical size temporarily to draw some
things sharply at the native resolution, and loss of sub-pixel precision.

Fixes #8736.
 2024-09-25 16:26:36 -04:00
Petar Popovic 043c876a15 Move default colorspace aliases into enum 2024-09-23 07:37:02 -07:00
Susko3 0478a6ee3b Move endian pixel format aliases into enum 
Matches the same thing in `SDL_AudioFormat`.
 2024-09-22 16:34:42 -07:00
Sam Lantinga b0e528cc88 Switched ifdef from negative to positive 2024-09-21 20:12:54 -07:00
Ozkan Sezer 254b36361e Add SDL_PRILL? format specifiers specifically for long long type. 2024-09-21 23:03:50 +03:00
Sam Lantinga 6f80d47d64 Use hexidecimal code for ± 2024-09-21 10:43:34 -07:00
Petar Popovic 4392233007 Removed tabs from headers 2024-09-21 10:39:53 -07:00
SDL Wiki Bot 1f727b61f3 Sync SDL3 wiki -> header 2024-09-18 21:04:36 +00:00
Sam Lantinga 398dff7c25 Added support for the HORI licensed Steam Controller 2024-09-18 14:08:32 -07:00
Ozkan Sezer 7edf7fad66 fix bool define when SDL_DEFINE_STDBOOL is defined: 
it should be unsigned.
 2024-09-18 12:17:22 -07:00
Ozkan Sezer ff90570a3c define SDL_DEFINE_STDBOOL for gcc < 3 2024-09-18 12:17:22 -07:00
Sam Lantinga ea640894d3 Fixed SDL_DEFINE_STDBOOL logic if __bool_true_false_are_defined is defined 2024-09-18 10:50:52 -07:00
Sam Lantinga 32fd1878a0 Provide a definition of bool if needed for your environment 2024-09-18 10:37:11 -07:00
SDL Wiki Bot 026d3c2306 Sync SDL3 wiki -> header 2024-09-18 15:33:11 +00:00
Sam Lantinga a90ad3b0e2 Removed SDL_bool in favor of plain bool 
We require stdbool.h in the build environment, so we might as well use the plain bool type.

If your environment doesn't have stdbool.h, this simple replacement will suffice:
typedef signed char bool;
 2024-09-18 08:32:30 -07:00
SDL Wiki Bot 9dd8859240 Sync SDL3 wiki -> header 2024-09-18 15:19:01 +00:00
Sam Lantinga bd04459cde Fix typos (thanks @qndel!) 
Fix typos in comments and in one case in a returned error ("insuffient -> insufficient" fb273eb)
codespell src/ *.cpp *.h *.hpp --ignore-words-list unknwn,thid,algebric,statics,pixelX,pEvents,caf,ptd,parms,pEvent,parm,TextureRS,TE,HDA,LOD,datas,UE,xwindows,IIF
cd src; git checkout \
    events/imKStoUCS.* \
    hidapi \
    joystick/controller_type.c \
    joystick/controller_type.h \
    joystick/hidapi/steam/controller_constants.h \
    joystick/hidapi/steam/controller_structs.h \
    libm \
    stdlib/SDL_malloc.c \
    stdlib/SDL_qsort.c \
    stdlib/SDL_strtokr.c \
    video/khronos \
    video/x11/edid.h \
    video/x11/edid-parse.c \
    video/x11/xsettings-client.* \
    video/yuv2rgb
 2024-09-18 08:18:26 -07:00
SDL Wiki Bot 8481d1a12b Sync SDL3 wiki -> header 2024-09-17 15:54:09 +00:00
Sam Lantinga d0edf68774 Added Uint32 versions of the atomic functions 2024-09-17 08:53:27 -07:00
Sam Lantinga 8d223b3037 Renamed atomic functions to match SDL 3.0 naming convention 
This will also allow us to cleanly add atomic operations for other types in the future.
 2024-09-17 08:53:27 -07:00
Sam Lantinga f3e419596b Removed SDL_INIT_TIMER 
This is no longer necessary before calling SDL_AddTimer()
 2024-09-17 08:53:27 -07:00
Sam Lantinga 231ea07617 Added SDL_LogTrace() 2024-09-17 02:04:54 -07:00
SDL Wiki Bot 926d143966 Sync SDL3 wiki -> header 2024-09-16 20:12:52 +00:00
Sam Lantinga 1bbc897e48 Updated documentation for bool return type 
Also updated the test CRC functions to return bool.
 2024-09-16 13:12:15 -07:00
SDL Wiki Bot 4a2683e2c1 Sync SDL3 wiki -> header 2024-09-16 20:09:54 +00:00
Sam Lantinga dc639956ba Improve logging performance and make log priorities thread-safe 
Fixes https://github.com/libsdl-org/SDL/issues/9679
 2024-09-16 13:09:17 -07:00
SDL Wiki Bot f006d61bd1 Sync SDL3 wiki -> header 2024-09-16 17:57:51 +00:00
SDL Wiki Bot fd1fcfc951 Sync SDL3 wiki -> header 2024-09-16 17:19:42 +00:00
Caleb Cornett 9416917353
GPU: Rework MSAA (#10859) 2024-09-16 12:19:09 -05:00
Caleb Cornett 4f722d372a
GPU: Metal vertex buffer indices should grow upward (#10837) 2024-09-15 20:17:43 -05:00
Sam Lantinga 97d40b9218 Removed SDL_CleanupEnvironment() 2024-09-15 10:00:21 -07:00
SDL Wiki Bot a7f1deae8d Sync SDL3 wiki -> header 2024-09-15 16:38:38 +00:00
Sam Lantinga 28b94c4758 Re-added SDL_getenv() as a thread-safe getenv() implementation 2024-09-15 09:37:04 -07:00
Sam Lantinga 19243092c6 Renamed SDL_GpuGraphicsPipelineTargetInfo to SDL_GPUGraphicsPipelineTargetInfo 
Fixes https://github.com/libsdl-org/SDL/issues/10855
 2024-09-15 07:46:26 -07:00
Carl Åstholm 1f3fd65c4c cpuinfo: Rename SDL_GetCPUCount to SDL_GetNumLogicalCPUCores 
This was the only API that broke the "GetNumThings" convention
used elsewhere, so renaming it helps with consistency.
Adding "logical cores" to the name also makes it a bit
more immediately obvious what the count actually represents.
 2024-09-14 19:33:30 -07:00
Maia e5bd3bbcd6 add missing includes 2024-09-14 14:38:44 -07:00
Sam Lantinga 8569bde053 Fixed typo 2024-09-14 14:35:57 -07:00
SDL Wiki Bot 706aaaf280 Sync SDL3 wiki -> header 2024-09-14 20:23:16 +00:00
Ryan C. Gordon 3bc0347761
Revert "Sync SDL3 wiki -> header" 
This reverts commit 35427ff9ec.
 2024-09-14 16:22:16 -04:00
Ryan C. Gordon c2e4b14a82
Revert "stdinc: Added missing `\param` to SDL_CreateEnvironment." 
This reverts commit 919f8d3e2b.
 2024-09-14 16:22:09 -04:00
Ryan C. Gordon 11c9975caa
Revert "Sync SDL3 wiki -> header" 
This reverts commit ba65767afa.
 2024-09-14 16:22:00 -04:00
SDL Wiki Bot ba65767afa Sync SDL3 wiki -> header 2024-09-14 20:18:20 +00:00
Ryan C. Gordon 919f8d3e2b
stdinc: Added missing `\param` to SDL_CreateEnvironment. 2024-09-14 16:17:29 -04:00
SDL Wiki Bot 35427ff9ec Sync SDL3 wiki -> header 2024-09-14 20:11:24 +00:00
Sam Lantinga e97f636590 SDL_PROP_PROCESS_CREATE_ENVIRONMENT_POINTER is an SDL_Environment pointer 2024-09-14 12:27:22 -07:00
Sam Lantinga e673479449 Removed SDL_WriteProcess() 
This had the unfortunate side-effect of blocking if you tried to write too much. Instead you can use SDL_GetProcessInput() and handle SDL_IO_STATUS_NOT_READY as needed.

Fixes https://github.com/libsdl-org/SDL/issues/10834
 2024-09-14 11:15:50 -07:00
ritalat f6f49de134 Add convenience functions to get process IOStreams 2024-09-14 10:33:29 -07:00
Sam Lantinga aa7357a14d SDL_CreateEnvironment() fills the environment with a non-zero parameter 2024-09-14 10:29:02 -07:00
Sam Lantinga 76c469910e Added SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN 2024-09-14 10:29:02 -07:00
Sam Lantinga 90e01040c5 Added thread-safe environment functions 
Also marked the existing functions as unsafe, as they can cause crashes if used in multi-threaded applications.

As a bonus, since the new functions are hashtable based, hint environment lookups are much faster.
 2024-09-13 22:14:54 -07:00
Ethan Lee 16ff7503b7 gpu: Update GPU support queries to better match naming conventions 2024-09-13 23:08:44 -04:00
SDL Wiki Bot d21c1de651 Sync SDL3 wiki -> header 2024-09-13 22:20:35 +00:00
Semphris 9eea8234e6 Add SDL_Process subsystem 2024-09-13 15:19:32 -07:00
Sam Lantinga 6c83491116 Added SDL_FlushIO() 
Also added SDL_PROP_IOSTREAM_FILE_DESCRIPTOR_NUMBER and refactored the internal API to be able to create SDL_IOStream objects from native file handles.
 2024-09-13 15:19:32 -07:00
Sam Lantinga 93caf1cd21 Fixed typo 2024-09-13 14:59:52 -07:00
SDL Wiki Bot 1c5b063ade Sync SDL3 wiki -> header 2024-09-13 20:56:16 +00:00
Sam Lantinga f1d0a71629 Fixed the documentation for SDL_SetError() 2024-09-13 13:54:54 -07:00
SDL Wiki Bot d483886ec5 Sync SDL3 wiki -> header 2024-09-13 19:32:14 +00:00
Carl Åstholm 7d94bf528d stdlib: Document SDL_strtox functions 2024-09-13 12:30:58 -07:00
Carl Åstholm fb82772fb3 stdlib: Rewrite SDL_strtoull impl 2024-09-13 12:30:58 -07:00
Carl Åstholm 4efbe1ca28 stdlib: Assert that signed integers use two's complement arithmetic 2024-09-13 12:30:58 -07:00
Carl Åstholm fd53b3e112 stdlib: Rewrite SDL_wcstol impl 
SDL_wcstol should now fully adhere to the libc spec.
 2024-09-13 12:30:58 -07:00
Anonymous Maarten ee65176eec SDL_test: add SDLTest_LogEscapedString 2024-09-13 20:52:32 +02:00
Ethan Lee 0160e9eac6 gpu: Add SDL_QueryGPUSupport 2024-09-13 13:42:07 -04:00
SDL Wiki Bot 262ffa27e7 Sync SDL3 wiki -> header 2024-09-13 16:30:11 +00:00
Ethan Lee 96e147b2b9 gpu: Rework driver name queries, add GetGPUShaderFormats 2024-09-13 12:29:40 -04:00
Ethan Lee 371cfaf8fe gpu: Implement support for SDL_GPU_DISABLED 2024-09-13 10:32:12 -04:00
SDL Wiki Bot d3932b1ba2 Sync SDL3 wiki -> header 2024-09-12 23:03:48 +00:00
Caleb Cornett a45a2caf49
GPU: Rename VertexBinding to VertexBufferDescription (#10811) 2024-09-12 18:02:39 -05:00
Evan Hemsley 66489f91bb
GPU: Cube Arrays (#10800) 
---------

Co-authored-by: Caleb Cornett <caleb.cornett@outlook.com>
 2024-09-12 13:41:46 -07:00
SDL Wiki Bot f8d4c49264 Sync SDL3 wiki -> header 2024-09-12 14:11:07 +00:00
Caleb Cornett d5e1385c91 Fixed typos in SDL_gpu.h 2024-09-12 09:10:20 -05:00
SDL Wiki Bot 6e2f2428ba Sync SDL3 wiki -> header 2024-09-12 06:31:07 +00:00
Caleb Cornett ddd5723e2e
GPU: Remove pitch parameters from indirect draw calls (#10803) 2024-09-11 23:30:14 -07:00
Sam Lantinga b15fab0207 Fixed typo in SDL_dialog.h 2024-09-11 17:35:23 -07:00
cosmonaut d62e3c3791 Fix SDL_GPUShaderFormat flag values 
Fixes #10797
 2024-09-11 15:40:13 -07:00
Sam Lantinga 77c569496d SDL_GPUShaderFormat isn't an enum anymore 2024-09-11 09:32:17 -07:00
Sam Lantinga 37c9fb490e Changed enums to use XXX_COUNT for the count or number of values 
Fixes https://github.com/libsdl-org/SDL/issues/10763
 2024-09-11 09:32:17 -07:00
SDL Wiki Bot eeb465e2fc Sync SDL3 wiki -> header 2024-09-11 02:20:48 +00:00
Evan Hemsley 2b8a349b26
Add SDL_BindGPUComputeSamplers (#10778) 
---------

Co-authored-by: Caleb Cornett <caleb.cornett@outlook.com>
 2024-09-10 19:20:14 -07:00
Evan Hemsley 0b6f993dea
GPU: Zero-init handling (#10786) 2024-09-10 18:17:08 -07:00
Sam Lantinga 817f1b3da8 Revert "Changed SDL_GPU_TEXTUREFORMAT_INVALID to 0" 
This reverts commit b51c6551d6.
 2024-09-10 09:22:49 -07:00
Sam Lantinga b51c6551d6 Changed SDL_GPU_TEXTUREFORMAT_INVALID to 0 
This is more in line with SDL's convention and makes it easier to do zero-based structure initialization.
 2024-09-10 08:37:52 -07:00
Sam Lantinga 4eb4370500 SDL_strtoll(), SDL_strtoull(), SDL_lltoa(), and SDL_ulltoa() use long long values 2024-09-09 15:46:26 -07:00
SDL Wiki Bot 68c61ff3a8 Sync SDL3 wiki -> header 2024-09-09 21:01:45 +00:00
Sam Lantinga 6fc6e3dc7e Use SDL_bool where appropriate in SDL events 
This involved changing button state from Uint8 to SDL_bool, and made SDL_PRESSED and SDL_RELEASED unnecessary.

Fixes https://github.com/libsdl-org/SDL/issues/10069
 2024-09-09 14:00:19 -07:00
SDL Wiki Bot 7d1bbae6b2 Sync SDL3 wiki -> header 2024-09-09 20:51:57 +00:00
Carl Åstholm af37056c0d stdinc: Fix typos and reword comments about aliasing 2024-09-09 13:51:16 -07:00
Carl Åstholm 8eb194b6f8 stdinc: Document number parsing APIs 2024-09-09 13:51:16 -07:00
Carl Åstholm eda459ac49 stdinc: Fix up some printf definitions 2024-09-09 13:51:16 -07:00
Carl Åstholm d6caf2abe7 Remove SDL_RESTRICT in favor of doc comments 2024-09-09 13:51:16 -07:00
Carl Åstholm 731939fca1 stdinc: Document memcpy APIs 2024-09-09 13:51:16 -07:00
Carl Åstholm 8cea4bd3c9 stdinc: Document memory allocation APIs 2024-09-09 13:51:16 -07:00
Simon McVittie 7713a7eec7 x11vulkan: Use the correct SONAME of libX11-xcb.so.1 on Linux, etc. 
On most Unix platforms supported by SDL, the canonical name used to load
a library at runtime includes its ABI major version, and the name
without a version is not guaranteed to exist on non-developer systems.
libX11-xcb.so.1 is correct on Linux, and probably on other Unix
platforms like FreeBSD.

A notable exception is OpenBSD, which apparently does not use
ABI-suffixed names, so continue to use libX11-xcb.so there.

Signed-off-by: Simon McVittie <smcv@collabora.com>
 2024-09-09 12:27:54 -07:00
Ryan C. Gordon 412a8244b6 audio: Make system-specific audio format types part of SDL_AudioFormat. 
This keeps them all in the same place, and merges them into the documentation.
 2024-09-09 15:17:18 -04:00
cosmonaut d3091b9538 Remove SDL_GPUDepthStencilValue struct 2024-09-09 10:55:05 -07:00
Evan Hemsley 668e2f82d2
Add load op and clear color to SDL_BlitGPUTexture (#10767) 2024-09-09 10:19:52 -07:00
SDL Wiki Bot 6e885d9619 Sync SDL3 wiki -> header 2024-09-09 06:56:45 +00:00
SDL Wiki Bot 301f3ffa9d Sync SDL3 wiki -> header 2024-09-09 06:50:28 +00:00
Ryan C. Gordon 050aa4d084
include: Filling in more documentation gaps. 2024-09-09 02:49:43 -04:00
Maia 0da2bd49c8 Remove unused includes. This only removes includes that aren't used at all, not even in comments. 2024-09-08 17:11:23 -07:00
Sam Lantinga 7df1caba7c Clarified that the contents of new textures aren't defined. 2024-09-08 07:23:17 -07:00
Anonymous Maarten ac0b1b207f SDL_hints: fix gpu direct3d11 driver name in documentation 
This was renamed in b17ca32d8c
 2024-09-08 15:56:17 +02:00
SDL Wiki Bot 1ba99c53d4 Sync SDL3 wiki -> header 2024-09-08 04:22:26 +00:00
SDL Wiki Bot 2b77b2e4ef Sync SDL3 wiki -> header 2024-09-08 04:18:26 +00:00
Ryan C. Gordon 4f6e81cf62
include: Fixed up some minor documentation gaps. 2024-09-08 00:17:53 -04:00
SDL Wiki Bot 7ec998819d Sync SDL3 wiki -> header 2024-09-07 23:13:46 +00:00
Maia fd6056307f fix trailing doc comments 2024-09-07 09:11:13 -07:00
cosmonaut 1a13acac09 Always blit to the swapchain in GPU_RenderPresent 
Fixes #10744
 2024-09-07 08:43:02 -07:00
Maia fa892d15b7 include files with required types directly 2024-09-07 08:37:46 -07:00
SDL Wiki Bot e9c7b36fbd Sync SDL3 wiki -> header 2024-09-07 15:30:40 +00:00
Evan Hemsley 68a9991ec9
GPU: Document structs (#10742) 2024-09-07 08:29:14 -07:00
Sam Lantinga a01e8a5e10 The GPU log category ate one of the SDL reserved categories 
Fixes https://github.com/libsdl-org/SDL/issues/10739
 2024-09-07 07:54:13 -07:00
SDL Wiki Bot f42da35ef9 Sync SDL3 wiki -> header 2024-09-06 23:39:48 +00:00
Caleb Cornett 9730f62e8c
GPU: Rename struct members and parameters for SDL3 naming conventions (#10730) 
---------

Co-authored-by: Evan Hemsley <2342303+thatcosmonaut@users.noreply.github.com>
 2024-09-06 16:38:23 -07:00
Ryan C. Gordon 845855d657
Revert "stdinc: Document more symbols." 
This reverts commit c93f76436f.

This looked better with the #defines attached to the typedef symbols.
 2024-09-06 15:33:27 -04:00
Ryan C. Gordon c93f76436f
stdinc: Document more symbols. 2024-09-06 15:30:56 -04:00
Ryan C. Gordon 73b294cb1c
SDL_platform_defines.h: Added documentation, and a little whitespace. 
wikiheaders needs the documentation in the first row of the line, at least
currently, so I've only indented things I could get away with, but it might
be a little easier to follow the preprocessor logic now.
 2024-09-06 15:09:29 -04:00
Ryan C. Gordon ac08dde1b2 windows: Clean out things that should be using `defined(SDL_PLATFORM_WINDOWS)`. 2024-09-06 13:28:39 -04:00
Ryan C. Gordon 154452a726 winrt: Removed WinRT/Windows Phone/UWP support. 
Fixes #10724.
 2024-09-06 13:28:39 -04:00
Anonymous Maarten 360bc667a8 SDL_Log: restore SDL2's SDL_LogCategory order 2024-09-06 17:40:59 +02:00
Anonymous Maarten 26728c321f SDL_test: add include for SDLTest_CommonState 2024-09-06 14:23:08 +02:00
Anonymous Maarten b4c3df1189 SDL_test: whitespace header fixes 2024-09-06 14:19:05 +02:00
Anonymous Maarten db96ddca34 SDL_test: use SDLCALL calling convention 
This is needed when using a pre-built static SDL3_test library.
 2024-09-06 14:19:05 +02:00
SDL Wiki Bot e7969553f8 Sync SDL3 wiki -> header 2024-09-06 02:17:29 +00:00
Sam Lantinga 702ed83f72 Initialize interface structures so they can be extended in the future 
We guarantee that we will only add to the end of these interfaces, and any new fields will be optional.
 2024-09-05 19:16:00 -07:00
Anonymous Maarten 102b3b480b SDL_test: move argument parsing into SDL_test 2024-09-06 03:06:40 +02:00
Anonymous Maarten 09af4a8086 SDL_test: make argument parsing extendable 2024-09-06 03:06:40 +02:00
Anonymous Maarten 872608b8af Don't allocate in SDLTest_GenerateRunSeed 2024-09-06 03:06:40 +02:00
Anonymous Maarten 2f4b2df595 SDL_test: pass data pointer to unit tests 2024-09-06 03:06:40 +02:00
SDL Wiki Bot 741c04b339 Sync SDL3 wiki -> header 2024-09-05 23:36:17 +00:00
Anonymous Maarten baa1a5e2f4 Add SDL_strpbrk 2024-09-06 01:35:43 +02:00
Anonymous Maarten 55934bc85e include: add SDL_RESTRICT for restricted pointer aliasing 2024-09-06 01:35:43 +02:00
Caleb Cornett 2d4eb29c37
Add SDL_SetGPUBlendConstants, SDL_SetGPUStencilReference (#10704) 2024-09-05 17:41:23 -05:00
Sam Lantinga 04a732881a Add a test to verify structure alignment 2024-09-05 15:27:56 -07:00
SDL Wiki Bot 22aeb1bbba Sync SDL3 wiki -> header 2024-09-05 19:23:35 +00:00
Frank Praznik a46e7027ce video: Allow setting the parents of toplevel windows 
Allow setting a parent/child relationship on toplevel windows, which allows raising sets of windows together, and allows child windows to always float above their parents.

Modal windows are now set by setting the parent, then toggling modal status, as the previous interface duplicated functionality now handled by SDL_SetWindowParent().
 2024-09-05 15:22:23 -04:00
SDL Wiki Bot af4c6682ce Sync SDL3 wiki -> header 2024-09-05 16:59:20 +00:00
cosmonaut cba5ccb9cf GPU: Fix documentation formatting 2024-09-05 09:57:54 -07:00
Evan Hemsley 42a0df91bf
Add padding for non-32-bit-aligned types in structs (#10701) 2024-09-05 09:52:57 -07:00
Sam Lantinga 387774ab8a Build config flags are either defined or undefined, never 0 
This is for consistency with CMake build configuration

Also added SDL_VIDEO_RENDER_GPU to the non-CMake build configurations
 2024-09-05 09:52:40 -07:00
Quinn X. J. f61d4db39a GPU: `colorAttachmentDescriptions` should be `const` 
The `colorAttachmentDescriptions` field of `SDL_GPUGraphicsPipelineAttachmentInfo` should be marked `const`,
similarly to the `vertexBindings` and `vertexAttributes` fields of `SDL_GPUVertexInputState`.
 2024-09-05 05:22:52 -07:00
SDL Wiki Bot 249a74e436 Sync SDL3 wiki -> header 2024-09-05 01:25:36 +00:00
Evan Hemsley 1c8c014481
GPU: Document opaque handles and enums (#10700) 2024-09-04 18:24:11 -07:00
Evan Hemsley 1788be8547
GPU: Add const to some function parameters (#10694) 2024-09-04 13:53:41 -07:00
Ozkan Sezer f317581c91 SDL_log.h: Use ASCII characters. 
(was missed in commit 7ca676aeed for issue #10636)
 2024-09-04 14:56:40 +03:00
Sam Lantinga 7ca676aeed Use ASCII characters in SDL source and headers 
Fixes https://github.com/libsdl-org/SDL/issues/10636
 2024-09-03 12:52:27 -07:00
Sam Lantinga 575d9cda6f The parameter to SDL_AppEvent() should be non-const 
This allows functions like SDL_ConvertEventToRenderCoordinates() to work without having to copy the event.

Fixes https://github.com/libsdl-org/SDL/issues/10691
 2024-09-03 08:18:36 -07:00
Sam Lantinga 73898a0a64 Renamed NDA platform constants to "PRIVATE" 2024-09-02 21:00:34 -07:00
Caleb Cornett b233beca47 GPU: Minor documentation cleanup 2024-09-02 18:01:43 -07:00
SDL Wiki Bot 19fb43b94f Sync SDL3 wiki -> header 2024-09-03 00:19:03 +00:00
Sam Lantinga 46ffa82f4e Added SDL_ALPHA_OPAQUE_FLOAT and SDL_ALPHA_TRANSPARENT_FLOAT 
Fixes https://github.com/libsdl-org/SDL/issues/10684
 2024-09-02 17:17:48 -07:00
Sam Lantinga 18c46a3313 Fixed SDL_pen.h for SDL3 bit flag conventions 2024-09-02 17:17:48 -07:00
Sam Lantinga eacf119923 Renamed SDL_size_add_overflow() and SDL_size_mul_overflow() 2024-09-02 17:17:48 -07:00
Andrei Alexeyev fb7245fb93
GPU: Add support for more texture formats (#10641) 2024-09-02 19:14:48 -05:00
Caleb Cornett f405def691
Change GPU flag enums to defines (#10681) 2024-09-02 15:19:43 -07:00
Petar Popovic 1751e127c8 Removed trailing commas in enums 2024-09-01 06:23:20 -07:00
Maia 35ebaf4a45 Fix multiple definitions of SDL_assert* when SDL_WIKI_DOCUMENTATION_SECTION is defined 2024-08-31 20:08:36 -07:00
Petar Popovic 0f59d2f8c9 SDL_test_memory.h: Added void to function prototype 2024-08-31 20:03:25 -07:00
Petar Popovic d1739ce3a8 Added headers to some SDL_test_*.h files 2024-08-31 11:56:27 -07:00
Sam Lantinga 92d1689eb4 Added missing SDL_begin_code.h and SDL_close_code.h to SDL_gpu.h 2024-08-31 10:02:46 -07:00
Sam Lantinga 60760b9abb Sort headers in SDL_gpu.h 2024-08-31 10:00:11 -07:00
Petar Popovic 3f05e9cd58 Added includes to SDL_gpu.h 2024-08-31 09:59:17 -07:00
Sam Lantinga f827c1322c Renamed SDL_Del* to SDL_Remove* 2024-08-31 07:46:28 -07:00
Sam Lantinga cf1d8e2dfd Renamed SDL_AtomicSetPtr() and SDL_AtomicGetPtr() 
Fixes https://github.com/libsdl-org/SDL/issues/10601
 2024-08-31 07:46:28 -07:00
Evan Hemsley 12ecdb9dde
GPU: Rename some awkwardly named functions (#10642) 2024-08-30 15:31:10 -07:00
Sam Lantinga b602c449e5 Remove SDL_SCALEMODE_BEST 
Fixes https://github.com/libsdl-org/SDL/issues/10619
 2024-08-30 10:30:14 -07:00
SDL Wiki Bot 04845bd39c Sync SDL3 wiki -> header 2024-08-30 13:27:33 +00:00
Sam Lantinga 138f3a3c91 Fixed documentation for SDL_SetAudioStreamGetCallback() 
Fixes https://github.com/libsdl-org/SDL/issues/10633
 2024-08-30 06:26:23 -07:00
Anonymous Maarten 88fe52df7b SDL_test: add --gpu option 2024-08-30 13:43:38 +02:00
Sam Lantinga f1b4c2bbbb Removed Unicode BOM from SDL_gpu.h 2024-08-29 18:03:59 -07:00
SDL Wiki Bot 9f0b23d3ad Sync SDL3 wiki -> header 2024-08-30 00:35:24 +00:00
Sam Lantinga d86f504637 Fix potential cases where we define SDL_GPU_* as an undefined symbol 2024-08-29 17:33:52 -07:00
Sam Lantinga 62f6e6b701 Removed the preferLowPower parameter from SDL_CreateGPUDevice() 2024-08-29 17:33:52 -07:00
Sam Lantinga 3046335f28 Fixed device creation property documentation formatting 2024-08-29 17:33:52 -07:00
Sam Lantinga b8e7ef27f3 Renamed GPU device creation properties 2024-08-29 17:33:52 -07:00
Sam Lantinga d70578b9aa Renamed Gpu to GPU 2024-08-29 17:33:52 -07:00
SDL Wiki Bot 717f4f6fb4 Sync SDL3 wiki -> header 2024-08-29 23:54:57 +00:00
Ryan C. Gordon 8ea38ebedc gpu: Fix wiki category capitalization. 2024-08-29 19:45:03 -04:00
SDL Wiki Bot 68038394d1 Sync SDL3 wiki -> header 2024-08-29 22:58:01 +00:00
cosmonaut 2e7d5bb429 Add the SDL_GPU API 
Project Lead: Evan Hemsley <evan@moonside.games>

Co-designer, Metal Port, Console Ports:

Co-authored-by: Caleb Cornett <caleb.cornett@outlook.com>

Production, QA, Debug:

Co-authored-by: Ethan Lee <flibitijibibo@gmail.com>

SDL_Render Driver, Bugfixes:

Co-authored-by: Andrei Alexeyev <akari@taisei-project.org>

Additional D3D12 Programming, Bugfixes:

Co-authored-by: Bart van der Werf <bluelive@gmail.com>

Bugfixes and Feedback:

Co-authored-by: Zakary Strange <zakarystrange@gmail.com>
Co-authored-by: meyraud705 <meyraud705@gmail.com>
Co-authored-by: Joshua T. Fisher <playmer@gmail.com>
Co-authored-by: Topi Ritala <ritalat@fastmail.com>
Co-authored-by: David Gow <david@ingeniumdigital.com>

Original API Proposal:

Co-authored-by: Ryan C. Gordon <icculus@icculus.org>
 2024-08-29 15:57:29 -07:00
hwsmm 940f7535ef Remove SDL_PEN hints that are no longer used 2024-08-28 07:04:48 -07:00
Maia a24c164956 Fix trailing doc comments 2024-08-27 13:23:26 -07:00
SDL Wiki Bot 85bbc6028a Sync SDL3 wiki -> header 2024-08-27 17:33:28 +00:00
Sam Lantinga 47926d7bd0 Added a cleanup function for virtual joysticks 2024-08-27 10:31:46 -07:00
Sam Lantinga 00c409cff8 Additional cleanup exposed by building with a C++ compiler 2024-08-27 10:31:46 -07:00
Sam Lantinga f08ac438ed Use stdbool for SDL_bool 
This helps the compiler warn people when they're doing something like "if (SDL_Init(0) < 0)"
 2024-08-27 10:31:46 -07:00
Sam Lantinga 9ff3446f03 Use SDL_bool instead an int return code in the SDL API 
Most SDL functions used to indicate success or failure using an int return code. These functions have been changed to return SDL_bool.

Here is a coccinelle patch to change code that previously compared the return value to 0 and changes it to a boolean test:
@ bool_return_type  @
identifier func =~ "^(SDL_AddEventWatch|SDL_AddHintCallback|SDL_AddSurfaceAlternateImage|SDL_AddVulkanRenderSemaphores|SDL_BindAudioStream|SDL_BindAudioStreams|SDL_BlitSurface|SDL_BlitSurface9Grid|SDL_BlitSurfaceScaled|SDL_BlitSurfaceTiled|SDL_BlitSurfaceTiledWithScale|SDL_BlitSurfaceUnchecked|SDL_BlitSurfaceUncheckedScaled|SDL_CaptureMouse|SDL_ClearAudioStream|SDL_ClearClipboardData|SDL_ClearComposition|SDL_ClearError|SDL_ClearProperty|SDL_ClearSurface|SDL_CloseIO|SDL_CloseStorage|SDL_ConvertAudioSamples|SDL_ConvertEventToRenderCoordinates|SDL_ConvertPixels|SDL_ConvertPixelsAndColorspace|SDL_CopyFile|SDL_CopyProperties|SDL_CopyStorageFile|SDL_CreateDirectory|SDL_CreateStorageDirectory|SDL_CreateWindowAndRenderer|SDL_DateTimeToTime|SDL_DestroyWindowSurface|SDL_DetachVirtualJoystick|SDL_DisableScreenSaver|SDL_EnableScreenSaver|SDL_EnumerateDirectory|SDL_EnumerateProperties|SDL_EnumerateStorageDirectory|SDL_FillSurfaceRect|SDL_FillSurfaceRects|SDL_FlashWindow|SDL_FlipSurface|SDL_FlushAudioStream|SDL_FlushRenderer|SDL_GL_DestroyContext|SDL_GL_GetAttribute|SDL_GL_GetSwapInterval|SDL_GL_LoadLibrary|SDL_GL_MakeCurrent|SDL_GL_SetAttribute|SDL_GL_SetSwapInterval|SDL_GL_SwapWindow|SDL_GetAudioDeviceFormat|SDL_GetAudioStreamFormat|SDL_GetCameraFormat|SDL_GetClosestFullscreenDisplayMode|SDL_GetCurrentRenderOutputSize|SDL_GetCurrentTime|SDL_GetDXGIOutputInfo|SDL_GetDateTimeLocalePreferences|SDL_GetDisplayBounds|SDL_GetDisplayUsableBounds|SDL_GetGDKDefaultUser|SDL_GetGDKTaskQueue|SDL_GetGamepadSensorData|SDL_GetGamepadTouchpadFinger|SDL_GetHapticEffectStatus|SDL_GetJoystickBall|SDL_GetMasksForPixelFormat|SDL_GetPathInfo|SDL_GetRectUnion|SDL_GetRectUnionFloat|SDL_GetRenderClipRect|SDL_GetRenderColorScale|SDL_GetRenderDrawBlendMode|SDL_GetRenderDrawColor|SDL_GetRenderDrawColorFloat|SDL_GetRenderLogicalPresentation|SDL_GetRenderLogicalPresentationRect|SDL_GetRenderOutputSize|SDL_GetRenderSafeArea|SDL_GetRenderScale|SDL_GetRenderVSync|SDL_GetRenderViewport|SDL_GetSensorData|SDL_GetStorageFileSize|SDL_GetStoragePathInfo|SDL_GetSurfaceAlphaMod|SDL_GetSurfaceBlendMode|SDL_GetSurfaceClipRect|SDL_GetSurfaceColorKey|SDL_GetSurfaceColorMod|SDL_GetTextInputArea|SDL_GetTextureAlphaMod|SDL_GetTextureAlphaModFloat|SDL_GetTextureBlendMode|SDL_GetTextureColorMod|SDL_GetTextureColorModFloat|SDL_GetTextureScaleMode|SDL_GetTextureSize|SDL_GetWindowAspectRatio|SDL_GetWindowBordersSize|SDL_GetWindowMaximumSize|SDL_GetWindowMinimumSize|SDL_GetWindowPosition|SDL_GetWindowRelativeMouseMode|SDL_GetWindowSafeArea|SDL_GetWindowSize|SDL_GetWindowSizeInPixels|SDL_GetWindowSurfaceVSync|SDL_HideCursor|SDL_HideWindow|SDL_Init|SDL_InitHapticRumble|SDL_InitSubSystem|SDL_LoadWAV|SDL_LoadWAV_IO|SDL_LockAudioStream|SDL_LockProperties|SDL_LockSurface|SDL_LockTexture|SDL_LockTextureToSurface|SDL_MaximizeWindow|SDL_MinimizeWindow|SDL_MixAudio|SDL_OpenURL|SDL_OutOfMemory|SDL_PauseAudioDevice|SDL_PauseAudioStreamDevice|SDL_PauseHaptic|SDL_PlayHapticRumble|SDL_PremultiplyAlpha|SDL_PremultiplySurfaceAlpha|SDL_PushEvent|SDL_PutAudioStreamData|SDL_RaiseWindow|SDL_ReadStorageFile|SDL_ReadSurfacePixel|SDL_ReadSurfacePixelFloat|SDL_RegisterApp|SDL_ReloadGamepadMappings|SDL_RemovePath|SDL_RemoveStoragePath|SDL_RemoveTimer|SDL_RenamePath|SDL_RenameStoragePath|SDL_RenderClear|SDL_RenderCoordinatesFromWindow|SDL_RenderCoordinatesToWindow|SDL_RenderFillRect|SDL_RenderFillRects|SDL_RenderGeometry|SDL_RenderGeometryRaw|SDL_RenderLine|SDL_RenderLines|SDL_RenderPoint|SDL_RenderPoints|SDL_RenderPresent|SDL_RenderRect|SDL_RenderRects|SDL_RenderTexture|SDL_RenderTexture9Grid|SDL_RenderTextureRotated|SDL_RenderTextureTiled|SDL_RequestAndroidPermission|SDL_RestoreWindow|SDL_ResumeAudioDevice|SDL_ResumeAudioStreamDevice|SDL_ResumeHaptic|SDL_RumbleGamepad|SDL_RumbleGamepadTriggers|SDL_RumbleJoystick|SDL_RumbleJoystickTriggers|SDL_RunHapticEffect|SDL_SaveBMP|SDL_SaveBMP_IO|SDL_SendAndroidMessage|SDL_SendGamepadEffect|SDL_SendJoystickEffect|SDL_SendJoystickVirtualSensorData|SDL_SetAppMetadata|SDL_SetAppMetadataProperty|SDL_SetAudioDeviceGain|SDL_SetAudioPostmixCallback|SDL_SetAudioStreamFormat|SDL_SetAudioStreamFrequencyRatio|SDL_SetAudioStreamGain|SDL_SetAudioStreamGetCallback|SDL_SetAudioStreamInputChannelMap|SDL_SetAudioStreamOutputChannelMap|SDL_SetAudioStreamPutCallback|SDL_SetBooleanProperty|SDL_SetClipboardData|SDL_SetClipboardText|SDL_SetCursor|SDL_SetFloatProperty|SDL_SetGamepadLED|SDL_SetGamepadMapping|SDL_SetGamepadPlayerIndex|SDL_SetGamepadSensorEnabled|SDL_SetHapticAutocenter|SDL_SetHapticGain|SDL_SetJoystickLED|SDL_SetJoystickPlayerIndex|SDL_SetJoystickVirtualAxis|SDL_SetJoystickVirtualBall|SDL_SetJoystickVirtualButton|SDL_SetJoystickVirtualHat|SDL_SetJoystickVirtualTouchpad|SDL_SetLinuxThreadPriority|SDL_SetLinuxThreadPriorityAndPolicy|SDL_SetLogPriorityPrefix|SDL_SetMemoryFunctions|SDL_SetNumberProperty|SDL_SetPaletteColors|SDL_SetPointerProperty|SDL_SetPointerPropertyWithCleanup|SDL_SetPrimarySelectionText|SDL_SetRenderClipRect|SDL_SetRenderColorScale|SDL_SetRenderDrawBlendMode|SDL_SetRenderDrawColor|SDL_SetRenderDrawColorFloat|SDL_SetRenderLogicalPresentation|SDL_SetRenderScale|SDL_SetRenderTarget|SDL_SetRenderVSync|SDL_SetRenderViewport|SDL_SetScancodeName|SDL_SetStringProperty|SDL_SetSurfaceAlphaMod|SDL_SetSurfaceBlendMode|SDL_SetSurfaceColorKey|SDL_SetSurfaceColorMod|SDL_SetSurfaceColorspace|SDL_SetSurfacePalette|SDL_SetSurfaceRLE|SDL_SetTLS|SDL_SetTextInputArea|SDL_SetTextureAlphaMod|SDL_SetTextureAlphaModFloat|SDL_SetTextureBlendMode|SDL_SetTextureColorMod|SDL_SetTextureColorModFloat|SDL_SetTextureScaleMode|SDL_SetThreadPriority|SDL_SetWindowAlwaysOnTop|SDL_SetWindowAspectRatio|SDL_SetWindowBordered|SDL_SetWindowFocusable|SDL_SetWindowFullscreen|SDL_SetWindowFullscreenMode|SDL_SetWindowHitTest|SDL_SetWindowIcon|SDL_SetWindowKeyboardGrab|SDL_SetWindowMaximumSize|SDL_SetWindowMinimumSize|SDL_SetWindowModalFor|SDL_SetWindowMouseGrab|SDL_SetWindowMouseRect|SDL_SetWindowOpacity|SDL_SetWindowPosition|SDL_SetWindowRelativeMouseMode|SDL_SetWindowResizable|SDL_SetWindowShape|SDL_SetWindowSize|SDL_SetWindowSurfaceVSync|SDL_SetWindowTitle|SDL_SetiOSAnimationCallback|SDL_ShowAndroidToast|SDL_ShowCursor|SDL_ShowMessageBox|SDL_ShowSimpleMessageBox|SDL_ShowWindow|SDL_ShowWindowSystemMenu|SDL_StartTextInput|SDL_StartTextInputWithProperties|SDL_StopHapticEffect|SDL_StopHapticEffects|SDL_StopHapticRumble|SDL_StopTextInput|SDL_SyncWindow|SDL_TimeToDateTime|SDL_TryLockMutex|SDL_TryLockRWLockForReading|SDL_TryLockRWLockForWriting|SDL_TryWaitSemaphore|SDL_UnlockAudioStream|SDL_UpdateHapticEffect|SDL_UpdateNVTexture|SDL_UpdateTexture|SDL_UpdateWindowSurface|SDL_UpdateWindowSurfaceRects|SDL_UpdateYUVTexture|SDL_Vulkan_CreateSurface|SDL_Vulkan_LoadLibrary|SDL_WaitConditionTimeout|SDL_WaitSemaphoreTimeout|SDL_WarpMouseGlobal|SDL_WriteStorageFile|SDL_WriteSurfacePixel|SDL_WriteSurfacePixelFloat)$";
@@
(
  func(
  ...
  )
- == 0
|
- func(
+ !func(
  ...
  )
- < 0
|
- func(
+ !func(
  ...
  )
- != 0
|
- func(
+ !func(
  ...
  )
- == -1
)
 2024-08-27 10:31:46 -07:00
Sam Lantinga fa2c9c46c5 Default SDL_HINT_JOYSTICK_GAMEINPUT to SDL_FALSE 
This was causing crashes in IGameInput_RegisterSystemButtonCallback(), presumably on older systems with runtimes using a different function signature. We'll just disable it for now until the GameInput runtime has stabilized and we can tell when it's safe to use.
 2024-08-23 11:34:15 -07:00
Sam Lantinga 8f546bb3c9 Use C99 bool internally in SDL 2024-08-22 13:30:02 -07:00
Sam Lantinga 9c7c0646c9 Fixed typo 2024-08-22 09:04:30 -07:00
Sam Lantinga 03ace96e5b Document that new surfaces are initialized to zero. 
Fixes https://github.com/libsdl-org/SDL/issues/10577
 2024-08-22 06:27:56 -07:00
Sam Lantinga d29276e625 Include SDL_events.h in SDL_init.h for SDL_AppEvent_func() 2024-08-20 07:53:07 -07:00
Ryan C. Gordon eb212ac4ed
main: Emscripten needs SDL_main_impl.h now that it has its own SDL_RunApp. 
Reference PR #10171.
 2024-08-18 23:54:55 -04:00
SDL Wiki Bot 1f34f35b25 Sync SDL3 wiki -> header 2024-08-19 00:55:27 +00:00