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
SDL Wiki Bot
39c2dacc8f
Sync SDL3 wiki -> header
2024-06-03 18:21:49 +00:00
Ryan C. Gordon
e23257307e
Introduce formal policy for APIs that return strings.
...
This declares that any `const char *` returned from SDL is owned by SDL, and
promises to be valid _at least_ until the next time the event queue runs, or
SDL_Quit() is called, even if the thing that owns the string gets destroyed
or changed before then.
This is noted in the headers as "the SDL_GetStringRule", so this will both be
greppable to find a detailed explaination in docs/README-strings.md and
wikiheaders will automatically turn it into a link we can point at the
appropriate documentation.
Fixes #9902 .
(and several FIXMEs, both known and yet-undocumented.)
2024-06-03 14:20:49 -04:00
Carlo Bramini
b1f3682216
SDL_assert: add support for aarch64-w64-mingw32
...
GCC 15 development branch provides an experimental support for Windows on ARM64, which will be officially released next year, according to latest news.
I tried to compile SDL2 with this new compiler but I got a tiny problem into SDL_assert.h because it couldn't find the right platform.
However, it has been easy to fix and I included it into this PR.
More details can be also found here:
https://learn.microsoft.com/en-us/cpp/intrinsics/debugbreak?view=msvc-170
(cherry picked from commit 2cb1a2d0a7 )
2024-06-03 10:55:14 -07:00
Ryan C. Gordon
9a9a3d1a33
SDL_SystemCursor: rename enum items to match CSS.
...
Fixes #9079 .
2024-06-01 22:32:43 -04:00
Ozkan Sezer
49b6c24722
always define PRI?64 using 'I64' when targeting windows
...
avoids -Wformat warnings from mingw toolchains -- e.g.:
src/test/SDL_test_harness.c:581:37: warning: unknown conversion type character 'l' in format [-Wformat=]
2024-06-01 22:35:40 +03:00
Sam Lantinga
b1b4638cac
Add basic vulkan support to offscreen video driver so it doesn't crash if you happen to get the offscreen driver and try to use vulkan.
...
Enable offscreen video driver in windows to make it easier to test.
Enable offscreen video driver in macos just to complete the desktop computer trio.
2024-05-28 20:02:55 -07:00
SDL Wiki Bot
04a0a85d92
Sync SDL3 wiki -> header
2024-05-29 02:48:51 +00:00
Sam Lantinga
542a3663de
Added SDL_GetDefaultKeyFromScancode() to the public API
...
This is useful when getting the English name of a key for a non-Latin keyboard layout, for example.
2024-05-28 19:48:24 -07:00
Ozkan Sezer
2b374e6c0f
check dxgi1_6.h before enabling sdr/hdr code in SDL_windowsmodes.c
...
thanks @madebr
2024-05-28 22:11:56 +03:00
SDL Wiki Bot
98fdef75bb
Sync SDL3 wiki -> header
2024-05-28 18:54:02 +00:00
Sam Lantinga
c74886ab00
Added SDL_SetWindowAspectRatio() and SDL_GetWindowAspectRatio()
...
Fixes https://github.com/libsdl-org/SDL/issues/1573
2024-05-28 11:52:31 -07:00
Sam Lantinga
36015ad5e5
Fixed compiling SDL_platform_defines.h on macOS with older compilers (thanks @sezero!)
...
Fixes #9632
2024-05-27 14:34:21 -07:00
Ryan C. Gordon
e508d82f74
include: Tweaked some vsync-related documentation.
...
Reference PR #9903 .
2024-05-27 16:57:32 -04:00
SDL Wiki Bot
6524f9c9b8
Sync SDL3 wiki -> header
2024-05-27 20:12:47 +00:00
Sam Lantinga
dfe4445214
Added SDL_SetWindowSurfaceVSync() and SDL_GetWindowSurfaceVSync()
...
Fixes https://github.com/libsdl-org/SDL/issues/9347
2024-05-27 13:12:17 -07:00
SDL Wiki Bot
7c75801571
Sync SDL3 wiki -> header
2024-05-27 20:04:46 +00:00
Ryan C. Gordon
3364aff757
main: Make the main callback return value symbols smaller (thanks, @Lzard!).
...
Reference #9901 .
2024-05-27 16:03:45 -04:00
SDL Wiki Bot
a086144dad
Sync SDL3 wiki -> header
2024-05-27 16:59:55 +00:00
Ryan C. Gordon
0fe9900429
main: Main callback docs recommend returning the symbols instead of -1, 0, 1.
...
Reference #9901 .
2024-05-27 12:58:22 -04:00
Sam Lantinga
7d81e9d46c
Note that you can redraw in response to SDL_EVENT_WINDOW_EXPOSED from an event watch callback
2024-05-27 08:06:13 -07:00
SDL Wiki Bot
54fcacae31
Sync SDL3 wiki -> header
2024-05-27 14:58:03 +00:00
Sam Lantinga
14667cc0a3
Document that the timer callback can potentially be called before the timer returns.
2024-05-27 07:57:33 -07:00
Sam Lantinga
99599d9236
Added SDL_AddTimerNS()
2024-05-27 07:57:33 -07:00
Sam Lantinga
b6360516e4
Added the timerID to the SDL timer callback
...
Fixes https://github.com/libsdl-org/SDL/issues/2593
2024-05-27 07:57:33 -07:00
Sam Lantinga
df25e4022d
Removed short aliases for 16-bit pixel formats
...
These were potentially misleading in the same way the RGB888/BGR888 aliases were
Fixes https://github.com/libsdl-org/SDL/issues/4994
2024-05-27 07:24:46 -07:00
SDL Wiki Bot
5fa9432b7d
Sync SDL3 wiki -> header
2024-05-27 02:54:30 +00:00
Ryan C. Gordon
066f49da1a
main: Add some macros for main callback return codes.
...
Fixes #9883 .
2024-05-26 22:53:06 -04:00
SDL Wiki Bot
c168ccc3c3
Sync SDL3 wiki -> header
2024-05-27 02:00:01 +00:00
Anonymous Maarten
ddb826d1a0
VC+d3d12: spread test for __has_include and d3d12.h test over multiple lines
2024-05-27 03:02:10 +02:00
Anonymous Maarten
4fa5006247
VC+d3d12: use __has_include to detect presence of d3d12 ehaders
2024-05-27 00:44:53 +02:00
Sam Lantinga
606903c02f
Updated window event names
2024-05-26 11:13:34 -07:00
Ryan C. Gordon
a4ccace9c5
include: Fix warnings from gendynapi.py.
...
Fixes #9890 .
2024-05-26 13:44:16 -04:00
Ryan C. Gordon
a0376ab057
SDL_MouseButtonFlags: Clarified some documentation.
2024-05-26 13:23:21 -04:00
Ryan C. Gordon
10bbf9d1da
Fixed SDL_PenCapabilityFlags from Uint64 to Uint32.
2024-05-26 13:23:21 -04:00
Ryan C. Gordon
0e6db371e8
pen: Make the `\since` field in SDL_PenCapabilityFlags match everything else.
2024-05-26 13:23:21 -04:00
Ryan C. Gordon
cf2874080f
mouse: Move mouse button state from a Uint32 to a formal typedef.
...
Reference Issue #9812 .
2024-05-26 13:23:21 -04:00
Ryan C. Gordon
13b18e3c41
test: Moved some `Uint32` bitfields over to typedefs.
...
Reference Issue #9812 .
2024-05-26 13:23:21 -04:00
Ryan C. Gordon
0f0570b060
pen: Change a Uint32 bitfield into a typedef.
...
Reference Issue #9812 .
2024-05-26 13:23:21 -04:00
SDL Wiki Bot
8e3ff8c3a1
Sync SDL3 wiki -> header
2024-05-26 17:21:54 +00:00
Sam Lantinga
534768c7c5
Added SDL_PauseAudioStreamDevice() and SDL_ResumeAudioStreamDevice()
2024-05-26 13:21:23 -04:00
SDL Wiki Bot
a6da2e6f8b
Sync SDL3 wiki -> header
2024-05-26 16:19:32 +00:00
Ryan C. Gordon
2626304e70
properties: add formal SDL_CleanupPropertyCallback type, improve docs.
2024-05-26 12:17:34 -04:00
SDL Wiki Bot
84cb065da2
Sync SDL3 wiki -> header
2024-05-26 03:34:35 +00:00
Ryan C. Gordon
033793faed
audio: SDL_OpenAudioDeviceStream() now allows a NULL spec.
2024-05-25 23:34:01 -04:00
Ryan C. Gordon
6a40a8eb12
audio: Minor documentation clarifications.
2024-05-25 23:34:00 -04:00
Sam Lantinga
7a043d9958
Note that SDL_BlitSurface() was renamed SDL_BlitSurfaceScaled()
2024-05-24 05:33:51 -07:00
Sam Lantinga
89caa88b73
Get the definition for SDL_PropertiesID in SDL_thread.h
2024-05-23 17:14:07 -07:00
SDL Wiki Bot
66fbbdf46a
Sync SDL3 wiki -> header
2024-05-23 17:09:44 +00:00
SDL Wiki Bot
3e8d8f81b4
Sync SDL3 wiki -> header
2024-05-23 17:04:35 +00:00
SDL Wiki Bot
be5d4e5857
Sync SDL3 wiki -> header
2024-05-22 21:40:15 +00:00
SDL Wiki Bot
6429806dce
Sync SDL3 wiki -> header
2024-05-22 19:47:56 +00:00
Ryan C. Gordon
daf5009395
dialog: fixed typo in docs.
2024-05-22 14:26:50 -04:00
Semphris
93a0db597a
Add documentation about dialogs and events
2024-05-22 11:26:03 -07:00
Ryan C. Gordon
f2e3437311
include: Fixed headers to not break with wikiheaders. This is a hack for now.
...
I broke the "Don't taunt wikiheaders" rule. :)
https://wiki.libsdl.org/SDL3/README/documentation-rules#dont-taunt-wikiheaders
2024-05-22 12:29:30 -04:00
SDL Wiki Bot
b7bb220e60
Sync SDL3 wiki -> header
2024-05-22 15:40:15 +00:00
Ryan C. Gordon
b2ca8fe458
thread: Simplified docs, moved some technical details to a non-wiki comment.
2024-05-22 11:39:43 -04:00
Ryan C. Gordon
b83bb035e6
thread: SDL_CreateThreadWithStackSize is now SDL_CreateThreadWithProperties.
2024-05-22 11:39:43 -04:00