Sam Lantinga
5e513ecc7f
Don't automatically free temporary memory, let the application call SDL_FreeTemporaryMemory() when it's ready.
...
Also mark up all functions that return temporary memory with SDL_DECLSPEC_TEMP, to help people implementing language bindings.
Fixes https://github.com/libsdl-org/SDL/issues/10378
2024-07-26 10:05:03 -07:00
Eduard Gushchin
2f38a4bf5e
Fixed a typo in the link to the GetTouchFingers function
2024-07-26 07:59:08 -07:00
SDL Wiki Bot
a1a8278029
Sync SDL3 wiki -> header
2024-07-26 00:47:35 +00:00
Sam Lantinga
750aef2bee
Clarified that temporary memory shouldn't be kept beyond the current function scope or event handling.
2024-07-25 17:47:00 -07:00
SDL Wiki Bot
a880410cb2
Sync SDL3 wiki -> header
2024-07-25 23:58:09 +00:00
Frank Praznik
66eb2ea443
mouse: Make pointer warp emulation via relative mode available to all platforms
...
Move the Wayland pointer warp emulation code up to the SDL mouse layer, and activate it when a client attempts to warp a hidden mouse cursor when the hint is set.
testrelative adds the ability to test the warp emulation activation/deactivation with the --warp parameter and 'c' key for toggling cursor visibility.
2024-07-25 19:57:39 -04:00
Eduard Gushchin
92667e3066
Update SDL_keycode.h
...
Removed the link referring to yourself
2024-07-25 14:12:04 -07:00
Eduard Gushchin
3ee59359c4
Fix documentation references and update method usage for SDL_GetGamepadGUIDForID in SDL_gamepad.h
...
In the documentation for the SDL_GetGamepadGUIDForID method in the SDL_gamepad.h file, there are two references to the methods SDL_GetGamepadGUID and SDL_GetGamepadGUIDString, but there are no methods of its own. I replaced these two methods with the existing SDL_GUIDToString.
2024-07-25 11:43:41 -07:00
SDL Wiki Bot
ba8495c214
Sync SDL3 wiki -> header
2024-07-25 00:41:44 +00:00
Sam Lantinga
cf8b158ccb
Added SDL_GetRenderSafeArea()
2024-07-24 17:40:41 -07:00
Sam Lantinga
b98e1e9ef0
Fixed the render viewport not updating when the metal view resizes
...
When the phone is in portrait mode and the window is in landscape mode, the view changes orientation after layoutSubviews runs. In this case we need some way of notifying the application that the Metal view has changed.
2024-07-24 16:12:29 -07:00
Sam Lantinga
f562a6d9f7
Added Android API level 35 to the table
2024-07-24 14:09:54 -07:00
Sam Lantinga
a7c0192017
Renamed SDL_PostSemaphore() to SDL_SignalSemphore()
2024-07-24 13:37:40 -07:00
Sam Lantinga
ca4bd4b63c
Android life cycle behavior more closely matches iOS
...
This change also decouples the pause/resume handling from the video subsystem on Android, so applications that don't use SDL for video can get application life cycle events.
The semantics for the life cycle events are that they need to be handled in an event watch callback, and once they've been delivered, the application will block until it's been resumed. SDL_HINT_ANDROID_BLOCK_ON_PAUSE can be used to control that behavior, and if that's set to "0", then the application will continue to run in the background at low CPU usage until being resumed or stopped.
SDL_HINT_ANDROID_BLOCK_ON_PAUSE_PAUSEAUDIO has been removed, and the audio will be paused when the application is paused.
Fixes https://github.com/libsdl-org/SDL/issues/3193
2024-07-24 05:11:13 -07:00
Sam Lantinga
fa0918a686
Renamed SDL life cycle functions
...
This maps better to how SDL delivers the events, and the iOS delegate methods are in the documentation for reference.
2024-07-24 05:11:13 -07:00
Sam Lantinga
f0363a0466
Functions that return display modes return temporary memory.
...
Also use the real pointer to display modes for internal mode processing
Fixes https://github.com/libsdl-org/SDL/issues/10353
2024-07-23 19:26:19 -07:00
SDL Wiki Bot
10dcae784b
Sync SDL3 wiki -> header
2024-07-24 00:07:31 +00:00
Sam Lantinga
457ca3995c
Added SDL_GetWindowSafeArea()
...
Fixes https://github.com/libsdl-org/SDL/issues/3243
2024-07-23 17:06:04 -07:00
SDL Wiki Bot
230161a50c
Sync SDL3 wiki -> header
2024-07-23 22:49:23 +00:00
Sam Lantinga
66011e497d
Removed duplication in SDL_EGL_* function names
2024-07-23 13:11:37 -07:00
Eduard Gushchin
86934975b9
Update SDL_video.h
...
Fixed a typo in the function name in the documentation for SDL_EGL_GetProcAddress
2024-07-23 12:48:10 -07:00
SDL Wiki Bot
2aea74aa84
Sync SDL3 wiki -> header
2024-07-22 22:19:38 +00:00
Sam Lantinga
a36be94ad1
More clarification on temporary memory
2024-07-22 15:19:26 -07:00
Sam Lantinga
29f0fd33dc
SDL_getenv() should return const
...
This also allows us to use SDL_FreeLater() and make SDL_getenv() thread-safe on Windows.
2024-07-22 13:00:39 -07:00
Sam Lantinga
ef21e31a9a
SDL_GUIDFromString() renamed SDL_StringToGUID()
2024-07-22 12:39:15 -07:00
SDL Wiki Bot
5e12706ae0
Sync SDL3 wiki -> header
2024-07-22 17:05:52 +00:00
Eduard Gushchin
24bb95f60c
Fixed a typo in the name of the method in the documentation for SDL_GetDisplayProperties
2024-07-22 10:04:59 -07:00
Sam Lantinga
c4bf5f9f59
SDL_CreateTexture() uses the SDL_TextureAccess type for the access parameter
2024-07-22 09:32:02 -07:00
SDL Wiki Bot
3e943090d0
Sync SDL3 wiki -> header
2024-07-22 14:50:48 +00:00
Eduard Gushchin
61565b7f61
Update SDL_video.h
...
Led to the actual list of WindowsFlag in the documentation of the SDL_CreateWindow method
2024-07-22 07:50:07 -07:00
SDL Wiki Bot
40cb3fb74a
Sync SDL3 wiki -> header
2024-07-22 14:35:35 +00:00
Sam Lantinga
ff1d351390
Removed SDL_FreeTemporaryMemory()
...
This was just causing confusion and anxiety. SDL temporary memory will be automatically freed on the main thread when processing events and on other threads when it ages out after a second. The application can free it directly by calling SDL_ClaimTemporaryMemory() to get ownership of the pointer, if necessary.
2024-07-22 07:34:25 -07:00
Ozkan Sezer
70c1012e8c
SDL_stdinc.h (SDL_COMPILE_TIME_ASSERT): Keep C++ case alone (after PR/10331)
...
Some versions of gcc will define __STDC_VERSION__ even when compiling in C++ mode.
Reference issue: https://github.com/libsdl-org/SDL/issues/6078 which was fixed by
f6b81125b3
2024-07-22 16:00:37 +03:00
SDL Wiki Bot
230f2a684d
Sync SDL3 wiki -> header
2024-07-22 12:59:19 +00:00
Sam Lantinga
685e381735
Add an overview of how to handle temporary memory
2024-07-22 05:58:19 -07:00
Sam Lantinga
9bfd0d901c
Audio device IDs are unsigned
2024-07-22 05:48:01 -07:00
Sam Lantinga
033c9c5951
Added SDL_CopyFile() and SDL_CopyStorageFile()
...
Fixes https://github.com/libsdl-org/SDL/issues/9553
2024-07-21 19:58:23 -07:00
Anonymous Maarten
22bfbdbc02
stdinc: c23 deprecated _Static_assert in favor of static_assert
2024-07-21 21:51:55 +03:00
Sam Lantinga
c040a02d6c
Removed SDL_PROP_SURFACE_COLORSPACE_NUMBER
...
Now that we have surface internal data, we can store it there. This slightly improves performance in the surface blitting paths.
2024-07-21 09:36:22 -07:00
SDL Wiki Bot
4a7e95402f
Sync SDL3 wiki -> header
2024-07-21 15:09:24 +00:00
Sam Lantinga
e0fd59de64
Fixed floating point rectangles to be mathematically correct.
...
* A floating point rectangle contains all points >= x and <= x + w
* A floating point rectangle is only empty if it has negative width. The zero rectangle contains the zero point.
* Adjacent floating point rectangles intersect along their shared side
Fixes https://github.com/libsdl-org/SDL/issues/6791
2024-07-21 08:08:15 -07:00
Sam Lantinga
b0a6afaa35
Updated documentation for SDL_GetPreferredLocales()
2024-07-20 20:12:55 -07:00
SDL Wiki Bot
979c71b18b
Sync SDL3 wiki -> header
2024-07-21 01:22:39 +00:00
Sam Lantinga
6209c71f54
Added SDL_BlitSurface9Grid() and SDL_RenderTexture9Grid()
2024-07-20 18:21:19 -07:00
Sam Lantinga
9294476788
Added SDL_WriteSurfacePixel() and SDL_WriteSurfacePixelFloat()
2024-07-20 18:21:19 -07:00
Sam Lantinga
12e50d17a2
Removed SDL_SoftStretch() from the public API
...
SDL_BlitSurfaceScaled() is more flexible and uses the SDL_SoftStretch() fast path when possible. Having two surface scaling APIs was confusing, especially when one of them has unexpected limitations.
2024-07-20 18:21:19 -07:00
Sam Lantinga
5ce81ebcc9
Corrected blit colorkey documentation
...
Fixes https://github.com/libsdl-org/sdlwiki/issues/576
2024-07-20 18:21:19 -07:00
Sam Lantinga
67fa7a9138
SDL_BlitSurface() and SDL_BlitSurfaceScaled() now have a const dstrect parameter
...
This was originally to avoid duplicating clipping work in Maelstrom on a 486 computer. This has been confusing for users and computers are a little faster these days, so we'll make it work the way people expect.
2024-07-20 18:21:19 -07:00
Sam Lantinga
198caa54a1
Added SDL_RenderTextureTiled()
2024-07-20 18:21:19 -07:00
Sam Lantinga
9e55ee9391
Added SDL_BlitSurfaceTiledWithScale()
2024-07-20 18:21:19 -07:00
Sam Lantinga
f47ddbf1ac
Added SDL_BlitSurfaceTiled()
...
Fixes https://gamedev.stackexchange.com/questions/136792/is-there-a-way-to-set-texture-wrap-mode-as-repeat-in-sdl-2
2024-07-20 18:21:19 -07:00
hwsmm
6a62c54b93
Remove a duplicate definition that is already in SDL_guid.h
2024-07-20 12:23:50 +03:00
Anonymous Maarten
476b987f1b
intrinsics: avx, avx2 and avx512f are (currently) unsupported on arm64ec
2024-07-20 00:59:58 +02:00
Sam Lantinga
f0a839b9b7
Removed SDL 2.1 note, we're not going to revisit this for SDL 3.0
...
Closes https://github.com/libsdl-org/SDL/issues/9480
2024-07-19 13:39:22 -07:00
SDL Wiki Bot
fc8cd657a5
Sync SDL3 wiki -> header
2024-07-19 20:08:05 +00:00
Sam Lantinga
b80784fced
SDL_GetGamepadBindings() follows the SDL_GetStringRule
2024-07-19 13:06:54 -07:00
Sam Lantinga
93db5ef135
Fixed documentation for SDL_GlobDirectory()
2024-07-19 13:06:54 -07:00
Sam Lantinga
0079b6d45f
SDL_GetTouchFingers() follows the SDL_GetStringRule
2024-07-19 13:06:54 -07:00
SDL Wiki Bot
975457cfb6
Sync SDL3 wiki -> header
2024-07-19 19:23:24 +00:00
Sam Lantinga
71a60d4c0e
Updated documentation for functions that return temporary memory
2024-07-19 12:22:03 -07:00
Sam Lantinga
68322ac851
Ensure that all functions that follow the SDL_GetStringRule return temporary memory
2024-07-19 12:22:03 -07:00
Sam Lantinga
fd9fe1bb7b
Renamed event memory to temporary memory, since it's not just used for events
2024-07-19 12:22:03 -07:00
Sam Lantinga
c4eac60000
SDL_GetClipboardData() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
61a7a0e579
SDL_GUIDToString() follows the SDL_GetStringRule
...
Also removed the distinction between SDL_GUID and SDL_JoystickGUID
2024-07-19 12:22:03 -07:00
Sam Lantinga
892df4bf4b
SDL_GetWindowICCProfile() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
eb22fcce35
SDL_GetTouchDevices() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
856d598d6e
SDL_GetSensors() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
4f8c348402
SDL_GetPreferredLocales() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
9be73ed7c5
SDL_GetMice() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
6ca18ed0e5
SDL_GetKeyboards() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
5ce0aacaa4
SDL_GetGamepads() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
4961af4569
SDL_GetJoysticks() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
b32c9615a7
SDL_GetHaptics() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
9de8cb888a
SDL_GetFullscreenDisplayModes() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
9758e102bc
SDL_GetDisplays() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
01199469de
SDL_GetCameras() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
0fe6603747
SDL_GetCameraSupportedFormats() follows the SDL_GetStringRule
...
Also changed the function to return an array of pointers and added example usage to testcamera
2024-07-19 12:22:03 -07:00
Sam Lantinga
637e9700dd
Standardize placement of '*' in function declarations
...
Implemented using these sed commands on the headers:
sed -E -i'' '/SDLCALL|;/ s,([a-z])\* ,\1 *,g' *
sed -E -i'' 's,(\(.*[^\*])\* ([a-z])(.*\)),\1*\2\3,g' *
sed -E -i'' 's,\*const,* const,g' *
sed -E -i'' 's,\*SDLCALL,* SDLCALL,g' *
sed -E -i'' 's,void\(,void (,g' *
git checkout *gl*
2024-07-19 12:22:03 -07:00
Sam Lantinga
bdafc8e212
SDL_GetWindows() follows the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
8ca6caeda5
SDL_GetAudioPlaybackDevices() and SDL_GetAudioRecordingDevices() follow the SDL_GetStringRule
2024-07-19 12:22:03 -07:00
Sam Lantinga
ef884c8aa6
Transfer event memory between the local pool and the event queue
...
This allows threads to free memory from their local pool without affecting events that are queued, and to transfer memory ownership cleanly between threads that are queuing and dequeuing events.
2024-07-19 12:22:03 -07:00
Sam Lantinga
f95ecac300
Added SDL_ClaimEventMemory()
2024-07-19 12:22:03 -07:00
Sam Lantinga
2816745f48
Allow passing a pointer to SDL_FreeEventMemory()
...
Also clarify in the documentation that you should not call SDL_FreeEventMemory(NULL) from your main thread.
2024-07-19 12:22:03 -07:00
Sam Lantinga
217330a7b3
Made return value descriptions more consistent across the API
2024-07-19 12:22:03 -07:00
Sam Lantinga
d73c7311d5
Clarify that the SDL_GetStringRule means that SDL will automatically free the memory later.
2024-07-19 12:22:03 -07:00
SDL Wiki Bot
e949f12f63
Sync SDL3 wiki -> header
2024-07-18 01:04:46 +00:00
Sam Lantinga
02a072a1b7
Added SDL_ClearSurface() and SDL_ReadSurfacePixelFloat()
2024-07-17 18:04:16 -07:00
Sam Lantinga
de6595bda6
SDL_MUSTLOCK() should return true if the surface needs locking even if it's currently locked.
...
There's a bunch of code that assumes this in SDL, and presumably in applications as well.
2024-07-17 18:04:16 -07:00
Sam Lantinga
334962b056
Enhancements for SDL_PremultiplyAlpha()
...
The function can now convert between pixels of different formats, and takes a parameter to control whether the premultiplication is done in sRGB or linear space.
Also added SDL_PremultiplySurfaceAlpha(), which can premultiply the pixels of a surface in-place.
2024-07-17 18:04:16 -07:00
Frank Praznik
b99ea1ff75
wayland: Add SDL_VIDEO_DOUBLE_BUFFER support
...
Manual cherry-pick of 9e6b8d56e3
thanks @vanfanel
2024-07-17 18:27:46 -04:00
Sam Lantinga
5f5e91eab6
Reverted 3d2e5a0b66
...
Applying these changes to external code doesn't actually improve anything, and within the context of the other Get* functions for renderers and surfaces, these stand out as outliers, so I'm going to back this change out.
2024-07-17 10:27:37 -07:00
Sam Lantinga
8c25129458
SDL_EVENT_WINDOW_LAST should be SDL_EVENT_WINDOW_HDR_STATE_CHANGED
...
Fixes https://github.com/libsdl-org/SDL/issues/10299
2024-07-16 22:43:02 -07:00
SDL Wiki Bot
b92ec25147
Sync SDL3 wiki -> header
2024-07-17 04:33:30 +00:00
Sam Lantinga
3d2e5a0b66
Fixed a few remaining functions to directly return their values instead of an error code.
2024-07-16 21:32:17 -07:00
Sam Lantinga
b7ec2119dd
Use a dither palette when converting RGB images to indexed formats
2024-07-16 17:57:12 -07:00
Sam Lantinga
9ca1792848
Renamed driverdata to internal
...
This was done to SDL_DisplayMode for consistency with SDL_Surface and gives it a type so we don't have to do casts in SDL code.
I considered switching to an ID and hashing the driver data, etc. but all of that involved a lot of internal code churn and this solution gives us flexibility in how we handle this in the future.
After consideration, I made this renaming global across the project, for consistency.
Fixes https://github.com/libsdl-org/SDL/issues/10198
2024-07-16 17:17:13 -07:00
SDL Wiki Bot
fe183872ee
Sync SDL3 wiki -> header
2024-07-16 20:45:34 +00:00
Ryan C. Gordon
4dda785c69
gamepad: Several gamepad mapping functions now follow the SDL_GetStringRule.
...
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
ed1f93cd11
filesystem: `SDL_Glob*Directory()` functions now follow the SDL_GetStringRule.
...
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
52bf7ff42d
filesystem: SDL_GetPrefPath() now follows the SDL_GetStringRule.
...
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
2321726ff1
filesystem: SDL_GetUserFolder() now follows the SDL_GetStringRule.
...
It also now caches at the higher level, so the platform-specific bits don't
change their interface much.
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
d40b89dff6
clipboard: SDL_GetPrimarySelectionText() now follows the SDL_GetStringRule.
...
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
158fc459f1
clipboard: SDL_GetClipboardText() now follows the SDL_GetStringRule.
...
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
Ryan C. Gordon
3bc81a81f5
filesystem: SDL_GetBasePath() now follows the SDL_GetStringRule.
...
It also now caches at the higher level, so the platform-specific bits don't
change their interface much.
A little code hygiene work was applied to some of the platform bits on top of
this.
Reference Issue #10229 .
2024-07-16 16:44:36 -04:00
SDL Wiki Bot
d65a8146b9
Sync SDL3 wiki -> header
2024-07-16 19:03:15 +00:00
Sam Lantinga
4aeabb3c3b
Made event and temporary string memory thread-local and added SDL_FreeEventMemory()
...
Fixes https://github.com/libsdl-org/SDL/issues/10283
2024-07-16 12:01:51 -07:00
Sam Lantinga
ec3bb4c029
Removed the need for SDL_CreateTLS()
...
This eliminates the tap dancing needed for allocating TLS slots, we'll automatically allocate them as needed, in a thread-safe way.
2024-07-16 12:01:51 -07:00
SDL Wiki Bot
70727d36b2
Sync SDL3 wiki -> header
2024-07-16 16:37:08 +00:00
Sam Lantinga
027671bedb
SDL_GetWindowOpacity() directly returns the opacity instead of using an out parameter.
...
Fixes https://github.com/libsdl-org/SDL/issues/10286
2024-07-16 09:36:11 -07:00
Sam Lantinga
58270ef3f2
Finished renaming functions in SDL_system.h
2024-07-16 09:35:49 -07:00
SDL Wiki Bot
4ac67f5ba6
Sync SDL3 wiki -> header
2024-07-16 01:38:55 +00:00
Sam Lantinga
033df70d4c
SDL_DelayNS() will attempt to sleep exactly the requested amount of time
...
This provides a highly accurate sleep function for your application, although you are still subject to being switched out occasionally.
Fixes https://github.com/libsdl-org/SDL/issues/10210
2024-07-15 18:38:09 -07:00
Sam Lantinga
54366181c3
Rename functions in SDL_system.h to match SDL 3.0 naming convention
...
Fixes https://github.com/libsdl-org/SDL/issues/10277
2024-07-15 16:27:48 -07:00
Sam Lantinga
70c8fe61d7
Align SDL_BLENDMODE_INVALID with the other constants
2024-07-15 15:00:09 -07:00
Sam Lantinga
bf501ab2d4
Made the SDL_BlendMode values wiki-friendly
2024-07-15 14:46:56 -07:00
Sam Lantinga
df573391b1
Added SDL_BLENDMODE_BLEND_PREMULTIPLIED and SDL_BLENDMODE_ADD_PREMULTIPLIED
...
Fixes https://github.com/libsdl-org/SDL/issues/2485
2024-07-15 14:12:33 -07:00
SDL Wiki Bot
9406a9d527
Sync SDL3 wiki -> header
2024-07-14 23:42:33 +00:00
Sam Lantinga
5c875e1183
Renamed *FromID() to *ForID()
...
While it makes sense to get an object pointer from an object ID, you want to get object attributes for an ID, otherwise e.g. GetNameFromID() sounds like it's a name ID, not an object ID. This is also consistent with the function naming convention in SDL2.
2024-07-14 15:56:50 -07:00
SDL Wiki Bot
0cdc60666b
Sync SDL3 wiki -> header
2024-07-14 21:04:37 +00:00
Ryan C. Gordon
f61900465c
stdinc: Fixed up documentation details for standard types.
2024-07-14 17:03:15 -04:00
SDL Wiki Bot
cb854d1bc9
Sync SDL3 wiki -> header
2024-07-14 20:02:23 +00:00
Sam Lantinga
9797c5d0c0
Renamed CameraDevice to Camera
...
This is consistent with the rest of the SDL API
2024-07-14 13:01:53 -07:00
Sam Lantinga
9358333286
Renamed SDL_GetKeyboardInstanceName() and SDL_GetMouseInstanceName()
...
For consistency with other device APIs
2024-07-14 13:01:53 -07:00
Sam Lantinga
d154b37b41
Renamed *FromInstanceID() to *FromID()
2024-07-14 13:01:53 -07:00
Sam Lantinga
cad9e6ea20
Fixed SDL_SINT64_C typo
...
Apparently all the platforms we compile on have INT64_C defined?
Fixes https://github.com/libsdl-org/SDL/issues/10268
2024-07-14 12:53:32 -07:00
Ryan C. Gordon
90e69f81e5
SDL_hidapi.h: Fixed something that apparently upset wikiheaders.
2024-07-14 15:20:26 -04:00
Ryan C. Gordon
15f850babc
SDL_hidapi.h: remove struct predeclaration before typedef.
2024-07-14 15:18:08 -04:00
Sam Lantinga
a17b742e34
Added documentation references to the components of a colorspace
2024-07-14 11:43:39 -07:00
SDL Wiki Bot
abaef81615
Sync SDL3 wiki -> header
2024-07-14 18:04:00 +00:00
Sam Lantinga
6217094c40
Updated colorspace documentation for the wiki
2024-07-14 11:02:56 -07:00
Sam Lantinga
1fecef5e4b
Assign numeric values to pixel format enums
...
This makes it easier to generate language bindings for these.
2024-07-14 11:02:56 -07:00
Sam Lantinga
cb395f7e80
Change SDL_AudioFormat into an enum
...
This makes it easier to understand in the debugger, and is consistent with SDL_PixelFormat and SDL_Colorspace
2024-07-14 10:04:31 -07:00
Sam Lantinga
e90060d07f
Renamed functions to get information from device IDs
...
Fixes https://github.com/libsdl-org/SDL/issues/10237
2024-07-14 09:03:59 -07:00
Sam Lantinga
bfee544685
Changed SDL_GetWindowPixelFormat() to return SDL_PixelFormat
...
Fixes https://github.com/libsdl-org/SDL/issues/10257
Closes https://github.com/libsdl-org/SDL/pull/10258
2024-07-14 07:19:20 -07:00
SDL Wiki Bot
2596482c3f
Sync SDL3 wiki -> header
2024-07-13 21:32:39 +00:00
Sam Lantinga
650271af46
Added SDL_CreateSurfacePalette()
2024-07-13 14:31:28 -07:00
captain0xff
0506cf18ab
android: enable vulkan renderer
2024-07-13 08:16:26 -07:00
Sam Lantinga
730d5cf2f8
Added fractional representation of refresh rate to SDL_DisplayMode
2024-07-12 18:09:14 -07:00
Sam Lantinga
1162a1cb8e
Added SDL_EVENT_DISPLAY_DESKTOP_MODE_CHANGED and SDL_EVENT_DISPLAY_CURRENT_MODE_CHANGED
2024-07-12 18:09:14 -07:00
SDL Wiki Bot
3f446a12df
Sync SDL3 wiki -> header
2024-07-12 19:42:55 +00:00
Ryan C. Gordon
8779c95905
android: Added SDL_AndroidGetCachePath().
...
Fixes #8408 .
2024-07-12 15:41:54 -04:00
SDL Wiki Bot
d949673bc9
Sync SDL3 wiki -> header
2024-07-12 18:25:57 +00:00
Sam Lantinga
4c88ddf86d
More property documentation clarification
2024-07-12 11:24:40 -07:00
SDL Wiki Bot
cf441332c4
Sync SDL3 wiki -> header
2024-07-12 18:21:05 +00:00
Sam Lantinga
0e56f6a3ca
Clarify property group documentation
...
Fixes https://github.com/libsdl-org/SDL/issues/10241
2024-07-12 11:20:15 -07:00
SDL Wiki Bot
d6fe06bb5d
Sync SDL3 wiki -> header
2024-07-12 17:42:22 +00:00
Sam Lantinga
5bf6bc4d7d
Renamed SDL_Get/SetProperty() to SDL_Get/SetPointerProperty()
...
This is consistent with the naming for the functions that affect other data types
Fixes https://github.com/libsdl-org/SDL/issues/10241
2024-07-12 10:41:02 -07:00
Ryan C. Gordon
bf03dee866
Remove `struct SDL_Camera` predeclare.
...
This is unnecessary and confuses the wiki bridge.
2024-07-12 13:25:06 -04:00
SDL Wiki Bot
f531003776
Sync SDL3 wiki -> header
2024-07-12 15:37:23 +00:00
SDL Wiki Bot
68dfae1322
Sync SDL3 wiki -> header
2024-07-12 15:35:05 +00:00
Sam Lantinga
282cf286fc
SDL_GetPixelFormatName() returns a string
2024-07-12 05:59:45 -07:00
SDL Wiki Bot
50589cbff6
Sync SDL3 wiki -> header
2024-07-12 12:33:26 +00:00
SDL Wiki Bot
f0ceb92dca
Sync SDL3 wiki -> header
2024-07-11 19:01:27 +00:00
Ethan Lee
1993ef664e
Add SDL_Vulkan_GetPresentationSupport
2024-07-11 15:00:59 -04:00
Ryan C. Gordon
af2dbf3ff3
video: Rename SDL_GL_DeleteContext to SDL_GL_DestroyContext.
...
Turns out that there isn't a strong OpenGL naming convention for "Delete" ...
WGL offers "wglDeleteContext" but the GLX equivalent is "glxDestroyContext"
and then EGL sealed the deal by going with Destroy as well! Since it matches
SDL3 naming conventions (Create/Destroy), we're renaming it.
Fixes #10197 .
2024-07-10 15:54:08 -04:00
SDL Wiki Bot
29b0076659
Sync SDL3 wiki -> header
2024-07-10 19:45:01 +00:00
Ryan C. Gordon
4755055bc3
audio: Separate channel maps out of SDL_AudioSpec.
2024-07-10 15:43:57 -04:00
SDL Wiki Bot
fdc04708f1
Sync SDL3 wiki -> header
2024-07-10 07:48:48 +00:00
Sam Lantinga
2ba76dbe80
Simplified SDL_Surface
...
SDL_Surface has been simplified and internal details are no longer in the public structure.
The `format` member of SDL_Surface is now an enumerated pixel format value. You can get the full details of the pixel format by calling `SDL_GetPixelFormatDetails(surface->format)`. You can get the palette associated with the surface by calling SDL_GetSurfacePalette(). You can get the clip rectangle by calling SDL_GetSurfaceClipRect().
SDL_PixelFormat has been renamed SDL_PixelFormatDetails and just describes the pixel format, it does not include a palette for indexed pixel types.
SDL_PixelFormatEnum has been renamed SDL_PixelFormat and is used instead of Uint32 for API functions that refer to pixel format by enumerated value.
SDL_MapRGB(), SDL_MapRGBA(), SDL_GetRGB(), and SDL_GetRGBA() take an optional palette parameter for indexed color lookups.
2024-07-10 00:48:18 -07:00
Sam Lantinga
4fa5196820
Revert "Switch pixel format loss fields to number of bits"
...
This reverts commit 3c90b1c1f6
.
It turns out this is problematic for sdl2-compat. We're investigating a more complete separation between SDL2 and SDL3 surfaces, but in the meantime, I'll fix the breakage.
2024-07-07 19:41:05 -07:00
SDL Wiki Bot
bfa4e71284
Sync SDL3 wiki -> header
2024-07-07 18:05:35 +00:00
SDL Wiki Bot
e37d6f71b3
Sync SDL3 wiki -> header
2024-07-07 18:02:15 +00:00
Sam Lantinga
3c90b1c1f6
Switch pixel format loss fields to number of bits
...
This makes more sense and handles pixel formats with > 8 bits per channel
Fixes https://github.com/libsdl-org/SDL/issues/10168
2024-07-06 11:37:16 -07:00
SDL Wiki Bot
f3ac2d9d4f
Sync SDL3 wiki -> header
2024-07-06 15:46:41 +00:00
Frank Praznik
fbb5652d3e
video: Document that SDL_RaiseWindow is a request and subject to window manager policy
...
The result of SDL_RaiseWindow is ultimately subject to window manager policy, particularly if the request would result in stealing focus from another window. Document that this is only a request, and if successful, will result in a focus gained event along with the input focus flag being set on the window.
2024-07-06 11:45:43 -04:00
Sam Lantinga
0fa74d8aa8
Wiki-compatible documentation for SDL_ALPHA_OPAQUE and SDL_ALPHA_TRANSPARENT
2024-07-06 05:53:40 -07:00
SDL Wiki Bot
d5a0f60963
Sync SDL3 wiki -> header
2024-07-05 15:59:26 +00:00
Sam Lantinga
8412f52853
Clarified that the renderer should be destroyed before the window
...
I didn't add a note to SDL_DestroyWindow() because we actually protect against this case now, but it's useful information to know conceptually when working with the renderer.
2024-07-05 08:57:30 -07:00
SDL Wiki Bot
b43f1688d9
Sync SDL3 wiki -> header
2024-07-04 15:12:07 +00:00
Ryan C. Gordon
c3bf874abf
stdlib: Clean up and export SDL_UCS4ToUTF8().
...
Also fix internal usage of the function.
Fixes #10157 .
2024-07-04 11:10:50 -04:00
Ryan C. Gordon
f338fa20dd
emscripten: Let SDL hints be set by URL parameters.
...
Any parameters (key/value pairs after the '?' in a URL) that have a keyname
that starts with `SDL_` will be put into Emscripten's environment variable
emulation table at startup, before SDL_main runs.
This lets users set hints the same way they might set them from a shell's
command line on a desktop platform:
For example:
`https://example.com/my_sdl3_application.html?SDL_RENDER_DRIVER=software `
Fixes #10154 .
2024-07-04 11:09:42 -04:00
SDL Wiki Bot
d7a875432b
Sync SDL3 wiki -> header
2024-07-03 20:07:11 +00:00
Ryan C. Gordon
2a8f1e11ca
audio: Add gain support to audio streams and logical audio devices.
...
Fixes #10028 .
2024-07-03 16:05:55 -04:00
Frank Praznik
74cc06db1b
Remove the SDL_EVENT_WINDOW_TAKE_FOCUS event
...
This was added by the Unreal Engine to handle the input focus for popups and dialogs, window types for which SDL3 has built-in, cross-platform support.
This was only ever implemented in X11, and the only purpose was to hint that a client application may want to call the SDL_SetWindowInputFocus() function, which has since been removed, rendering it pointless now.
2024-07-03 15:08:21 -04:00
Frank Praznik
be13328cb1
Remove SDL_SetWindowInputFocus
...
This was added to SDL2 for the Unreal Engine's implementation of menus and dialogs on X11, window types for which SDL3 has added built-in, cross-platform support.
Remove this function, as it was only ever implemented for X11 and is now basically useless aside from allowing annoying or malicious client apps to discretely steal focus. As the documentation states: "You almost certainly want SDL_RaiseWindow() instead of this function."
2024-07-03 15:08:21 -04:00
SDL Wiki Bot
98f27b8f2e
Sync SDL3 wiki -> header
2024-07-03 18:39:46 +00:00
Ryan C. Gordon
16e7fdc4f2
audio: Add channel remapping to SDL_AudioSpec and SDL_AudioStream.
...
Fixes #8367 .
2024-07-03 14:38:33 -04:00
SDL Wiki Bot
b948d1446a
Sync SDL3 wiki -> header
2024-07-03 01:35:19 +00:00
Sam Lantinga
ed9bbb2dca
Restore default behavior for keypad keycodes
...
Added a hint to translate numpad keycodes into their non-numpad versions based on the NumLock state
2024-07-02 18:34:35 -07:00
Ryan C. Gordon
e290d16c47
include: Clean up SDL_GetKeyName documentation.
2024-07-02 12:29:33 -04:00
SDL Wiki Bot
f787790243
Sync SDL3 wiki -> header
2024-07-01 20:57:56 +00:00
Sam Lantinga
d4497ecdbd
Numpad scancodes have non-numpad keycodes
...
This allows the numpad to work as the user expects based on the numlock state. If the application needs to distinguish the keys, it can check to see whether the scancode is a numpad key or not.
2024-07-01 13:56:49 -07:00
Sam Lantinga
78dbf9be50
Document that SDL_GetKeyName() always returns uppercase names for alphabetic keycodes
2024-07-01 13:56:49 -07:00
Sam Lantinga
e8dbbf8380
Renamed SDLK_a-z to SDLK_A-Z
...
Made the symbols uppercase for consistency with the other SDLK_* constants, but the values are still lowercase.
2024-07-01 13:56:49 -07:00
Sam Lantinga
d9dc4b320a
The keycode in key events is the base, unmodified, keycode for the current keyboard layout
2024-07-01 13:56:49 -07:00
SDL Wiki Bot
ede4483420
Sync SDL3 wiki -> header
2024-06-29 21:26:31 +00:00
Sam Lantinga
473257cce6
Added SDL_GetRenderLogicalPresentationRect()
...
Fixes https://github.com/libsdl-org/SDL/issues/8815
2024-06-29 14:25:59 -07:00
Sam Lantinga
6f199eabb8
Removed SDL_RenderGeometryRawFloat()
...
After discussion with @ocornut, SDL_RenderGeometryRaw() will take floating point colors and conversion from 8-bit color can happen on the application side. We can always add an 8-bit color fast path in the future if we need it on handheld platforms.
If you need code to do this in your application, you can use the following:
int SDL_RenderGeometryRaw8BitColor(SDL_Renderer *renderer, SDL_Texture *texture, const float *xy, int xy_stride, const SDL_Color *color, int color_stride, const float *uv, int uv_stride, int num_vertices, const void *indices, int num_indices, int size_indices)
{
int i, retval, isstack;
const Uint8 *color2 = (const Uint8 *)color;
SDL_FColor *color3;
if (num_vertices <= 0) {
return SDL_InvalidParamError("num_vertices");
}
if (!color) {
return SDL_InvalidParamError("color");
}
color3 = (SDL_FColor *)SDL_small_alloc(SDL_FColor, num_vertices, &isstack);
if (!color3) {
return -1;
}
for (i = 0; i < num_vertices; ++i) {
color3[i].r = color->r / 255.0f;
color3[i].g = color->g / 255.0f;
color3[i].b = color->b / 255.0f;
color3[i].a = color->a / 255.0f;
color2 += color_stride;
color = (const SDL_Color *)color2;
}
retval = SDL_RenderGeometryRaw(renderer, texture, xy, xy_stride, color3, sizeof(*color3), uv, uv_stride, num_vertices, indices, num_indices, size_indices);
SDL_small_free(color3, isstack);
return retval;
}
Fixes https://github.com/libsdl-org/SDL/issues/9009
2024-06-29 00:10:08 -07:00
SDL Wiki Bot
2cfcb144e4
Sync SDL3 wiki -> header
2024-06-29 02:42:49 +00:00
Sam Lantinga
212a491f7c
Renamed SDL_HINT_IME_NATIVE_UI to SDL_HINT_IME_IMPLEMENTED_UI
...
This inverts the logic to make more sense from an application perspective.
2024-06-28 19:41:37 -07:00
SDL Wiki Bot
9332de9f25
Sync SDL3 wiki -> header
2024-06-29 00:09:51 +00:00
Sam Lantinga
4c7db129df
SDL_HINT_IME_INTERNAL_EDITING and SDL_HINT_IME_SHOW_UI are replaced with SDL_HINT_IME_NATIVE_UI
2024-06-28 17:09:22 -07:00
Sam Lantinga
bdd531986b
SDL_SetTextInputRect() has been renamed to SDL_SetTextInputArea()
...
The new function includes the cursor position so IME UI elements can be placed relative to the cursor, as well as having the whole text area available so on-screen keyboards can avoid it.
2024-06-28 17:09:22 -07:00
Sam Lantinga
ed2022a175
Added SDL_EVENT_TEXT_EDITING_CANDIDATES
...
This allows applications that have set SDL_HINT_IME_SHOW_UI to "0" to get candidates lists they can draw themselves.
Fixes https://github.com/libsdl-org/SDL/issues/4855
2024-06-28 17:09:22 -07:00
Ryan C. Gordon
ecfa363889
begin_code: Solaris Studio has `__has_attribute` defined by isn't usable here.
...
Fixes #10095 .
(cherry picked from commit d96f1d5360
)
2024-06-27 22:13:48 -07:00
Ryan C. Gordon
d7ee9ce455
SDL_endian.h: Fix byte order detection on Solaris (and some SPARC compilers).
...
Fixes #10093 .
(Sort of cherry-picked from 14183f8ecac099982883331ae7e405f82e42aa6b.)
2024-06-28 00:14:26 -04:00
SDL Wiki Bot
b7ab5182d3
Sync SDL3 wiki -> header
2024-06-27 21:37:27 +00:00
Ryan C. Gordon
a9cfcf6bde
stdinc: Drastically improve SDL_StepUTF8() and make it a public API.
...
Fixes #10105 .
2024-06-27 17:36:09 -04:00
Ryan C. Gordon
982feb7a65
vulkan: SDL_Vulkan_CreateSurface now returns the usual int (0=ok, -1=error).
...
Fixes #10091 .
2024-06-27 15:25:10 -04:00
Sam Lantinga
c7f7464174
Updated scancode documentation
2024-06-26 12:33:16 -07:00
Ryan C. Gordon
9fd54b724f
include: Added documentation for SDL_PRESSED and SDL_RELEASED.
...
Fixes #10069 .
2024-06-26 14:08:56 -04:00
SDL Wiki Bot
3d121d9bc7
Sync SDL3 wiki -> header
2024-06-25 03:32:46 +00:00
Sam Lantinga
def7a43a2e
SDL_HINT_IME_SHOW_UI defaults to SDL_TRUE
...
This hint is currently only used on Windows, and this matches the behavior of other platforms.
2024-06-24 20:32:03 -07:00
Sam Lantinga
377014c430
Added some documentation to the SDL_EVENT_TEXT_EDITING event
2024-06-24 20:32:03 -07:00
Anonymous Maarten
d52ea20916
cmake: check for valid isinf/isinff/isnan/isnanf macros
2024-06-24 22:00:53 +02:00
SDL Wiki Bot
ea11c9e0c7
Sync SDL3 wiki -> header
2024-06-24 19:23:37 +00:00
Sam Lantinga
0ff5c05486
Added SDL_GetWindows()
2024-06-24 12:22:12 -07:00
SDL Wiki Bot
2c745dbd3c
Sync SDL3 wiki -> header
2024-06-24 18:50:19 +00:00
Sam Lantinga
2f5b20fcb5
Updated based on feedback from @JKaniarz
2024-06-24 11:49:15 -07:00
Sam Lantinga
a938e2b979
Replaced test framework random code with SDL random functions
2024-06-24 11:49:15 -07:00
Sam Lantinga
96f2f23240
Simplified SDL random function names and added thread-safe versions
2024-06-24 11:49:15 -07:00
Sam Lantinga
89cdadf7c3
Added SDL_isinf(), SDL_isinff(), SDL_isnan(), and SDL_isnanf()
2024-06-24 11:49:15 -07:00
SDL Wiki Bot
410bed20ba
Sync SDL3 wiki -> header
2024-06-24 18:21:18 +00:00
Sam Lantinga
76631a0978
The text input state has been changed to be window-specific.
...
SDL_StartTextInput(), SDL_StopTextInput(), SDL_TextInputActive(), SDL_ClearComposition(), and SDL_SetTextInputRect() all now take a window parameter.
This change also fixes IME candidate positioning when SDL_SetTextInputRect() is called before SDL_StartTextInput(), as is recommended in the documentation.
2024-06-24 11:20:08 -07:00
Anonymous Maarten
5217c040be
Sort possible SDL_KeyCode values (swap SDLK_PERCENT and SDLK_DOLLAR)
2024-06-23 22:52:17 +02:00
Frank Praznik
974bbea20b
x11: Add keymap support
...
XkbKeycodeToKeySym is replaced with XkbLookupKeySym, which can take the modifier states. The associated cmake check has been renamed for consistency.
Only the XKB path is currently handled. The deprecated XKeycodeToKeysym path is TODO.
2024-06-23 15:40:55 -04:00
Sam Lantinga
fd3143f445
Added more documentation for SDL_HINT_MOUSE_RELATIVE_CURSOR_VISIBLE and SDL_HINT_MOUSE_RELATIVE_CLIP_INTERVAL
2024-06-23 00:11:56 -07:00
SDL Wiki Bot
398391b01e
Sync SDL3 wiki -> header
2024-06-23 07:11:23 +00:00
expikr
3b504c4a89
Add SDL_HINT_MOUSE_RELATIVE_CLIP_INTERVAL ( #10085 )
2024-06-23 00:09:59 -07:00
SDL Wiki Bot
ba188e7555
Sync SDL3 wiki -> header
2024-06-22 07:20:00 +00:00
Sam Lantinga
90034b16dc
The keycode in key events is affected by modifiers by default.
...
This behavior can be customized with SDL_HINT_KEYCODE_OPTIONS.
2024-06-22 00:19:06 -07:00
SDL Wiki Bot
1e81424b3d
Sync SDL3 wiki -> header
2024-06-22 05:06:38 +00:00
Sam Lantinga
c9cfa4688e
Use unsigned constants for SDL_Keycode values
...
Fixes https://github.com/libsdl-org/SDL/issues/10020
Closes https://github.com/libsdl-org/SDL/pull/10070
2024-06-21 22:06:08 -07:00
Sam Lantinga
0dd579d40d
Removed SDL_Keysym
2024-06-21 22:06:08 -07:00
Sam Lantinga
679e4471ed
Added the ability to query the keymap for keycodes based on modifier state
2024-06-21 22:06:08 -07:00
Sam Lantinga
ef9bd8b609
Add the raw platform specific key code to SDL_Keysym
...
This allows applications to handle keys that SDL doesn't recognize, in a platform dependent way.
Fixes https://github.com/libsdl-org/SDL/issues/6390
2024-06-21 22:06:08 -07:00
Sam Lantinga
9d816c72ef
Updated SDL3 scancode list
...
This adds more app editing and audio control keys and removes keys that launch applications
Work in progress on https://github.com/libsdl-org/SDL/issues/6390
2024-06-21 22:06:08 -07:00
Sam Lantinga
306c4164bc
Added SDL_AllocateEventString()
2024-06-21 22:06:08 -07:00
Sam Lantinga
fa5367d379
Enable virtual joystick support for Emscripten
2024-06-21 12:06:53 -07:00
SDL Wiki Bot
83933fdfa0
Sync SDL3 wiki -> header
2024-06-20 19:55:37 +00:00
Frank Praznik
2f276a2eea
video: Expose HDR metadata per-window
...
Moves the HDR properties from the display to be per-window, and adds the frog_color protocol to enable HDR under Wayland.
2024-06-20 15:55:07 -04:00
SDL Wiki Bot
e6944584a0
Sync SDL3 wiki -> header
2024-06-20 00:01:27 +00:00
John Kaniarz
8f29f8cae5
Renamed SDL_rand() to SDL_rand_bits() and updated tests
2024-06-19 17:00:58 -07:00
SDL Wiki Bot
237bbfcb9d
Sync SDL3 wiki -> header
2024-06-19 18:02:45 +00:00
John Kaniarz
16e69cb4c9
Removed SDL_rand_r()
2024-06-19 11:02:02 -07:00
John Kaniarz
86b06f74dc
Updated docs
2024-06-19 11:02:02 -07:00
John Kaniarz
83d21e20df
Added SDL_rand_float and SDL_rand_n to API
2024-06-19 11:02:02 -07:00
SDL Wiki Bot
ab98d51b9f
Sync SDL3 wiki -> header
2024-06-19 14:15:46 +00:00
Hubert Maier
81d8fcb5d8
JANITORIAL: Fix judgement typos ( #10059 )
2024-06-19 07:14:58 -07:00
Hubert Maier
3acdb8a90b
JANITORIAL: Fix typos in comments in various files ( #10058 )
2024-06-19 07:13:46 -07:00
Zack Middleton
5ecf125456
Update descriptions for window resize cursors
...
The SIZENWSE, SIZENS, etc cursors were renamed.
2024-06-18 12:22:02 -04:00
Sam Lantinga
d7391394d3
Switched the camera format to use framerate ratio instead of interval ratio
...
This is more intuitive for game developers and users.
Fixes https://github.com/libsdl-org/SDL/issues/9896
2024-06-18 07:39:52 -07:00
Sam Lantinga
aeea819494
Added colorspace to SDL_CameraSpec
2024-06-16 17:47:16 -07:00
Sam Lantinga
182a28b343
Fixed documentation typo
2024-06-16 08:01:16 -07:00
SDL Wiki Bot
4e5ed569c3
Sync SDL3 wiki -> header
2024-06-16 14:42:00 +00:00
Sam Lantinga
d1d484ddbe
Added SDL_srand(), SDL_rand(), and SDL_rand_r() (thanks @JKaniarz!)
...
These are simple random functions that should not be used for serious random number generation.
Fixes https://github.com/libsdl-org/SDL/issues/4968
2024-06-16 07:41:00 -07:00
SDL Wiki Bot
65f0691866
Sync SDL3 wiki -> header
2024-06-16 13:21:56 +00:00
expikr
ee559d51be
Add SDL_MOUSE_RELATIVE_CURSOR_VISIBLE ( #7947 )
2024-06-16 06:21:29 -07:00
Anonymous Maarten
a64960cfc0
SDL_GLContext is not a void* pointer anymore
2024-06-15 14:44:09 +02:00
SDL Wiki Bot
63138c79af
Sync SDL3 wiki -> header
2024-06-15 05:09:09 +00:00
Ryan C. Gordon
38f0214e8a
audio: Refer to audio devices to "playback" and "recording".
...
Fixes #9619 .
2024-06-15 01:08:12 -04:00
Anonymous Maarten
031dc0743f
Use an opaque struct typedef for SDL_GLContext
...
Using a struct typedef instead of a void pointer results in extra C typechecks
2024-06-15 01:43:22 +02:00
Ryan C. Gordon
51902d4ac5
Updated headers with latest wikiheaders tweaks.
2024-06-14 02:09:55 -04:00
Ryan C. Gordon
5bc654aad3
camera: SDL_GetCameraDeviceName() now follows the SDL_GetStringRule.
2024-06-13 18:13:51 -04:00
Ryan C. Gordon
2ad7c70ac6
documentation: clean up a minor syntax issue.
2024-06-13 18:10:28 -04:00
Ryan C. Gordon
466886049c
SDL_main.h: fix up SDL_main_func documentation to match SDL_main.
2024-06-13 18:08:40 -04:00
SDL Wiki Bot
2253c3cacf
Sync SDL3 wiki -> header
2024-06-13 21:49:55 +00:00
Sam Lantinga
0635112119
Added SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE (thanks @lostgoat!)
2024-06-13 14:54:36 -07:00
SDL Wiki Bot
d46b8bc54e
Sync SDL3 wiki -> header
2024-06-13 21:31:58 +00:00
SDL Wiki Bot
fa3e22c5da
Sync SDL3 wiki -> header
2024-06-13 21:04:27 +00:00
Ryan C. Gordon
12119cbaad
include: Several documentation tweaks; cleaned up new wikiheaders warnings.
2024-06-13 17:03:31 -04:00
SDL Wiki Bot
49f2a3463f
Sync SDL3 wiki -> header
2024-06-13 19:34:29 +00:00
SDL Wiki Bot
674cc04ef4
Sync SDL3 wiki -> header
2024-06-13 02:25:45 +00:00
Sam Lantinga
80a907e0e6
Backed out the viewport and cliprect changes in 9fb5a9ccac
...
This ended up being lots of application code churn without any real benefit in practice.
2024-06-12 19:25:15 -07:00
SDL Wiki Bot
99f0309ac1
Sync SDL3 wiki -> header
2024-06-12 23:34:42 +00:00
SDL Wiki Bot
9e3e489012
Sync SDL3 wiki -> header
2024-06-12 19:10:53 +00:00
Ryan C. Gordon
5416bd5fdc
ios: Move animation callback to its own typedef.
2024-06-12 15:10:16 -04:00
SDL Wiki Bot
5b0f14a936
Sync SDL3 wiki -> header
2024-06-12 17:19:08 +00:00
Sam Lantinga
9fb5a9ccac
Use floating point values for viewport, clip rectangle, and texture sizes
...
These are integer values internally, but the API has been changed to make it easier to mix other render code with querying those values.
Fixes https://github.com/libsdl-org/SDL/issues/7519
2024-06-12 10:18:39 -07:00
SDL Wiki Bot
2d13fefc20
Sync SDL3 wiki -> header
2024-06-12 02:20:21 +00:00
SDL Wiki Bot
a4bb93e8e4
Sync SDL3 wiki -> header
2024-06-12 01:34:03 +00:00
Anonymous Maarten
32907a9606
Rename SDL_Swap(16|32|64)(LE|BE) to SDL_Swap(LE|BE)(16|32|64)
2024-06-12 02:29:39 +02:00
Anonymous Maarten
ef6123886e
Add SDL_ReadS8 and SDL_WriteS8
2024-06-12 01:39:08 +02:00
SDL Wiki Bot
f003461a0b
Sync SDL3 wiki -> header
2024-06-11 16:23:27 +00:00
Ryan C. Gordon
96f2ef77ab
include: Make function pointer params into typedefs.
...
This is easier to read and document in general, but will also make some
new parsing work in wikiheaders much easier.
2024-06-11 12:22:46 -04:00
Ryan C. Gordon
8e782602de
wikiheaders: Fixes and cleanups to fix SDL_ReportAssertion's wiki page.
2024-06-11 11:29:44 -04:00
Sam Lantinga
66aac9aced
Fixed channel order typo
2024-06-10 18:05:31 -07:00
SDL Wiki Bot
454d890bef
Sync SDL3 wiki -> header
2024-06-11 00:57:54 +00:00
Ryan C. Gordon
d3a62d8298
audio: Update docs on channel ordering.
2024-06-10 20:56:50 -04:00
Sam Lantinga
4fc68a48f2
Keep track of whether a controller was a gamepad
...
Fixes https://github.com/libsdl-org/SDL/issues/9996
2024-06-09 17:45:20 -07:00
Ryan C. Gordon
8ddf05855b
iostream: clarified SDL_IO_STATUS_READY documentation.
2024-06-09 13:21:31 -04:00
SDL Wiki Bot
9651ca5918
Sync SDL3 wiki -> header
2024-06-09 05:52:14 +00:00
Ryan C. Gordon
6110405c07
include: Fill in some documentation gaps.
2024-06-09 01:51:30 -04:00
Ryan C. Gordon
7d54a37d74
iostream: Make seeking's `whence` value a real enum.
2024-06-09 01:50:48 -04:00
SDL Wiki Bot
35adef17a8
Sync SDL3 wiki -> header
2024-06-09 05:33:28 +00:00
Ryan C. Gordon
40e8d0155e
SDL_joystick.h: Add some notes to the category documentation.
2024-06-09 01:32:41 -04:00
Ryan C. Gordon
8af58b4bec
SDL_FLT_EPSILON: Updated documentation to be wikiheaders-friendly.
2024-06-08 23:15:21 -04:00
Green Sky
997dd3e6eb
reword SDL_FlashWindow params
...
so they link the types in the wiki
2024-06-08 17:25:27 -04:00
Anthony
e9982bf1b5
Filter Android drivers according to SDL_***_DISABLED macros to help reduce APK size ( #9986 )
2024-06-08 08:55:15 -07:00
Sam Lantinga
e69272344c
Added documentation for SDL_FLT_EPSILON (thanks @MrOnlineCoder!)
...
Closes https://github.com/libsdl-org/sdlwiki/pull/549
2024-06-08 08:29:17 -07:00
SDL Wiki Bot
9a4fc81bff
Sync SDL3 wiki -> header
2024-06-06 17:59:48 +00:00
Sam Lantinga
5701c4f4bc
Added migration documentation for iOS window properties
...
Fixes https://github.com/libsdl-org/SDL/issues/9430
2024-06-06 10:59:15 -07:00
SDL Wiki Bot
a5356f9b45
Sync SDL3 wiki -> header
2024-06-06 17:08:43 +00:00
Sam Lantinga
23db1062fc
Document that you can pass NULL to SDL_PeepEvents()
...
Fixes https://github.com/libsdl-org/sdlwiki/issues/547
2024-06-06 10:08:20 -07:00
Sam Lantinga
9b2debb131
Renamed old function reference
2024-06-04 22:25:37 -07:00
SDL Wiki Bot
e5101ebae6
Sync SDL3 wiki -> header
2024-06-04 04:11:34 +00:00
Sam Lantinga
a0d1445ccb
Replaced SDL_GetRendererInfo() with SDL_GetRendererName()
...
The texture formats are available via the SDL_PROP_RENDERER_TEXTURE_FORMATS_POINTER property
Fixes https://github.com/libsdl-org/SDL/issues/9851
2024-06-03 21:10:58 -07:00
SDL Wiki Bot
74c9c9a325
Sync SDL3 wiki -> header
2024-06-04 01:23:30 +00:00
Semphris
8c8ee2174d
Dialog: Add filter number, remove NULL termination
2024-06-03 18:22:26 -07:00
Sam Lantinga
a9a51cebde
Disable raw keyboard input by default
...
It interferes with keyboard hooks and most applications don't expect key events coming from another thread
2024-06-03 14:43:46 -07:00