SDL Wiki Bot
10c2682647
Sync SDL3 wiki -> header
2024-05-03 02:54:35 +00:00
Ryan C. Gordon
760d7d276b
include: Filled in some missing documentation.
2024-05-02 22:53:08 -04:00
Ryan C. Gordon
9f842e9b5a
wikiheaders: Bind `#define`s below a function to it, like typedefs.
...
This effectively adds the property symbols for various functions to the
function's wiki page.
2024-05-02 12:49:30 -04:00
Sam Lantinga
d95f5bad24
Updated to version 3.1.2 for the preview release
2024-05-01 09:34:25 -07:00
Semphris
b9d3d746a0
Add trailing path separator to SDL_GetUserFolder()
2024-04-30 18:01:16 -07:00
SDL Wiki Bot
97d0e78842
Sync SDL3 wiki -> header
2024-04-30 17:48:27 +00:00
Semphris
c6a70d6898
Add support for modal windows to more platforms
...
- Adds support for modal windows to Win32, Mac, and Haiku, and enhances functionality on Wayland and X11, which previous set only the parent window, but not the modal state.
- Windows can be declared modal at creation time, and the modal state can be toggled at any time via SDL_SetWindowModalFor() (tested with UE5 through sdl2-compat).
- Allows dynamic unparenting/reparenting of windows.
- Includes a modal window test.
2024-04-30 13:47:57 -04:00
Ravbug
2f8cfce154
Fix SDL_main on UWP with C++20
...
/ZW is incompatible with C++20, so disable the #error in that case. In addition, define a main function because UWP in C++20 mode links to standard main.
2024-04-30 10:16:32 -07:00
Nhalrath
8eeaa815d9
docs: rename num to size in SDL_iostream
2024-04-30 10:16:10 -07:00
SDL Wiki Bot
556d9b8497
Sync SDL3 wiki -> header
2024-04-30 10:45:12 +00:00
SDL Wiki Bot
8b06473a11
Sync SDL3 wiki -> header
2024-04-29 20:53:27 +00:00
Petar Popovic
7bfecacc02
Removing function macro SDL_TABLESIZE()
2024-04-29 13:52:48 -07:00
Petar Popovic
8d0ad44edd
Adding tag names to enums
...
Adding tag names to following enums:
SDL_JoystickType, SDL_JoystickConnectionState, SDL_TouchDeviceType, SDL_DUMMY_ENUM
2024-04-28 16:09:37 -07:00
Petar Popovic
dffbb574ea
renaming SDL_eventaction tag to SDL_EventAction
2024-04-28 16:09:09 -07:00
SDL Wiki Bot
3f2f712fff
Sync SDL3 wiki -> header
2024-04-28 12:29:13 +00:00
Sam Lantinga
14f584a94b
SDL_CreateWindowAndRenderer() takes the window title as the first parameter
...
Fixes https://github.com/libsdl-org/SDL/issues/9626
2024-04-25 20:00:14 -07:00
SDL Wiki Bot
57f96fb124
Sync SDL3 wiki -> header
2024-04-25 21:23:14 +00:00
SDL Wiki Bot
1b8d4d77d6
Sync SDL3 wiki -> header
2024-04-25 21:01:12 +00:00
Ryan C. Gordon
6b1a98e664
wikiheaders: Allow basic typedefs to pull in some preprocessor logic.
...
Reference Issue #9557 .
This lets SDL_AudioFormat have the `#if byteorder == lilendian` section.
2024-04-25 16:44:09 -04:00
SDL Wiki Bot
a13bdeee8a
Sync SDL3 wiki -> header
2024-04-25 20:40:14 +00:00
Ryan C. Gordon
d29b861a76
wikiheaders: Allow blank lines in post-typedef `#define` blocks.
...
Reference Issue #9557 .
2024-04-25 14:26:49 -04:00
Ryan C. Gordon
2fb024ab8e
wikiheaders: Defines directly following a non-struct typedef are documented.
...
The idea is that if you have a `typedef Uint32 MyFlags` that has a bunch of
defines that are meant to be bitflags, you can pack them into the same wiki
page automatically.
This only works with `typedef`s that are _not_ struct/union/enums, and it
only pulls in `#define` lines that immediately follow the typedef line.
Even a blank line or a comment will signal to stop including lines for
this page!
2024-04-25 03:02:27 -04:00
SDL Wiki Bot
47ff4addd4
Sync SDL3 wiki -> header
2024-04-25 06:37:31 +00:00
Ryan C. Gordon
2733345422
SDL_audio.h: Documentation updates.
2024-04-25 02:36:08 -04:00
SDL Wiki Bot
ceeefb0512
Sync SDL3 wiki -> header
2024-04-24 20:43:29 +00:00
Ryan C. Gordon
cdb3cea76d
SDL_atomic.h: Documentation updates.
2024-04-24 16:42:16 -04:00
Ryan C. Gordon
ec97857a87
SDL_assert.h: Documentation improvements.
2024-04-24 15:17:31 -04:00
SDL Wiki Bot
5fbc038375
Sync SDL3 wiki -> header
2024-04-24 17:20:14 +00:00
Sam Lantinga
30d93fb29b
Relax, it's not that exciting :)
2024-04-24 09:19:38 -07:00
Ryan C. Gordon
4a11809370
SDL_TextInputEvent: Note that `text` field is UTF-8 encoded.
...
Reference Issue https://github.com/libsdl-org/sdlwiki/issues/516
2024-04-24 11:18:35 -04:00
Petar Popovic
b98116a996
Removing trailing commas in enums in SDL headers
...
Trailing commas in enums is a C99 feature.
This commit removes them in SDL headers for ANSI compatibility.
2024-04-24 09:44:41 -04:00
Ryan C. Gordon
30970780a9
include: Fixed some old Doxygen markup to be Markdown instead.
2024-04-23 14:38:04 -04:00
Ryan C. Gordon
7a36504952
storage: SDL_WriteStorageFile() wasn't marked as SDLCALL.
...
Fixes #9594 .
2024-04-21 09:26:07 -04:00
Erik Scholz
c623bd2fdc
reword SDL_BlitSurfaceScaled param
...
so it will link to the type in the docs/wiki
2024-04-20 07:51:40 -07:00
Frank Praznik
bede245395
Remove references to renderers being destroyed with windows in the documentation
2024-04-19 12:23:40 -04:00
Anonymous Maarten
7dd4f1ec22
SDL3 removed SDL_HINT_RENDER_SCALE_QUALITY hint
...
textures now default to linear filtering, use SDL_SetTextureScaleMode(texture, SDL_SCALEMODE_NEAREST) if you want nearest pixel mode instead
2024-04-17 16:38:15 -07:00
Ryan C. Gordon
093160904d
SDL_Keymod: Removed SDL_KMOD_RESERVED.
...
Fixes #9481 .
2024-04-17 17:30:10 -04:00
SDL Wiki Bot
2c183c602d
Sync SDL3 wiki -> header
2024-04-17 21:09:29 +00:00
Ryan C. Gordon
a18f3d55b7
SDL_iostream.h: Corrected documentation for SDL_ReadIO and SDL_WriteIO.
...
Fixes #9443 .
2024-04-17 17:08:05 -04:00
SDL Wiki Bot
bf0bf80df6
Sync SDL3 wiki -> header
2024-04-16 17:30:27 +00:00
Ryan C. Gordon
db6b6bd75e
include: Fixed up some sensor documentation.
...
Fixes #9468 .
2024-04-16 13:29:26 -04:00
Sam Lantinga
650d3b44e1
Removed the word "other" since the version has been removed
2024-04-16 08:52:21 -07:00
Ryan C. Gordon
235bfe2631
SDL_log.h: Remove SDL_MAX_LOG_MESSAGE.
...
The message length limit was removed in 2.0.24, so there's no need for
this define in SDL3 at all.
Fixes #9467 .
2024-04-16 00:31:57 -04:00
Brick
edaab8ad9f
Refactored audio conversion to reduce copying
...
More of the logic has been moved into SDL_AudioQueue,
allowing data to be converted directly from the input buffer.
2024-04-15 11:47:18 -10:00
Sam Lantinga
d69e6714a8
Document that tooltip windows don't get mouse or keyboard focus
2024-04-15 14:38:00 -07:00
Sam Lantinga
bfde7294f5
Added a note that the joystick should be initialized on the main thread on Windows
...
Fixes https://github.com/libsdl-org/SDL/issues/9533
2024-04-15 14:19:44 -07:00
SDL Wiki Bot
7000a112a3
Sync SDL3 wiki -> header
2024-04-15 21:13:12 +00:00
Sam Lantinga
70ce808c09
Changed SDL_KeyCode values to defines
...
This clears up confusion about whether to use SDL_KeyCode or SDL_Keycode and makes it clear that the values aren't the full set of possible keycodes.
Fixes https://github.com/libsdl-org/SDL/issues/9493
2024-04-15 11:08:51 -10:00
Sam Lantinga
2fa4937e1a
Removed obsolete padding
2024-04-15 13:55:01 -07:00
SDL Wiki Bot
35c08c828b
Sync SDL3 wiki -> header
2024-04-15 19:23:27 +00:00
Sam Lantinga
1862a62b5d
Replaced SDL_GetNumTouchFingers() and SDL_GetTouchFinger() with SDL_GetTouchFingers()
...
Fixes https://github.com/libsdl-org/SDL/issues/9484
2024-04-15 09:22:41 -10:00
SDL Wiki Bot
cdcd346575
Sync SDL3 wiki -> header
2024-04-15 19:13:11 +00:00
SDL Wiki Bot
69ee186a1e
Sync SDL3 wiki -> header
2024-04-15 16:56:12 +00:00
Ozkan Sezer
f06f761c2f
remove SDL_quit.h include from SDL.h
2024-04-15 18:47:24 +03:00
Ryan C. Gordon
9c8c254af2
include: Removed SDL_quit.h
...
It only had one (sort of scary) macro in it.
Fixes #9534 .
2024-04-15 11:35:39 -04:00
SDL Wiki Bot
0397d23ed8
Sync SDL3 wiki -> header
2024-04-15 14:36:12 +00:00
Petar Popovic
56e6f05440
SDL_RendererFlip rename fixes
2024-04-15 03:32:23 -10:00
Anonymous Maarten
07b7ec68eb
Add SDLTest_CompareMemory function to compare memory ranges
2024-04-15 03:05:05 -10:00
Petar Popovic
875ddb4969
SDL_atomic.h rename fixes
...
Adding following macro to SDL_oldnames.h:
SDL_atomic_t SDL_atomic_t_renamed_SDL_AtomicInt
2024-04-15 09:02:39 -04:00
SDL Wiki Bot
1731d53d02
Sync SDL3 wiki -> header
2024-04-15 13:01:12 +00:00
SDL Wiki Bot
11de629dd2
Sync SDL3 wiki -> header
2024-04-14 05:50:22 +00:00
Ryan C. Gordon
291edc073c
include: Document SDL_TriggerBreakpoint.
2024-04-14 01:48:52 -04:00
SDL Wiki Bot
59c332e569
Sync SDL3 wiki -> header
2024-04-14 05:35:26 +00:00
Ryan C. Gordon
041de0c2eb
include: Some documentation improvements.
2024-04-14 01:33:56 -04:00
Ryan C. Gordon
21bc72bef1
wikiheaders: Allow parts of the headers to be ignored.
...
The specific cases here were SDL_size_mul_overflow_builtin and
SDL_size_add_overflow_builtin, which are forced-inline symbols in
SDL_stdinc.h that have to exist, but aren't really part of the public API,
and thus shouldn't be exported as documentation.
2024-04-13 22:57:23 -04:00
SDL Wiki Bot
e4f097805b
Sync SDL3 wiki -> header
2024-04-14 00:22:23 +00:00
Ryan C. Gordon
081a94e321
include: Updated a bunch of documentation.
2024-04-13 20:10:13 -04:00
Ryan C. Gordon
239b34d760
docs: Added some notes about iOS and the main callbacks.
2024-04-13 15:14:32 -04:00
SDL Wiki Bot
9c5ae7293f
Sync SDL3 wiki -> header
2024-04-13 18:59:10 +00:00
SDL Wiki Bot
cae90ef489
Sync SDL3 wiki -> header
2024-04-13 18:38:11 +00:00
Ryan C. Gordon
6e1ed94913
ios: Renamed APIs that referred to "iPhone" to refer to "iOS".
...
Macros that papered over this difference in SDL2 have been removed for SDL3.
Fixes #9527 .
2024-04-13 14:30:30 -04:00
Ryan C. Gordon
d252a8fe12
joystick: SDL_VirtualJoystickDesc no longer takes a struct version.
...
If we need to extend this in the future, we'll make a second struct and
a second SDL_AttachVirtualJoystickEx-style function that uses it.
Just zero the struct and don't set a version.
Fixes #9489 .
2024-04-13 14:16:12 -04:00
SDL Wiki Bot
202bd7b0ff
Sync SDL3 wiki -> header
2024-04-13 13:24:25 +00:00
Ryan C. Gordon
f01b34fd8d
include: Removed some SDL2 references in the documentation.
2024-04-13 09:23:37 -04:00
Ryan C. Gordon
98e9f361a8
winrt: Remove SDL_WinRTGetFSPathUNICODE, rename SDL_WinRTGetFSPathUTF8.
...
Fixes #9470 .
2024-04-13 08:24:12 -04:00
SDL Wiki Bot
02da4acf0f
Sync SDL3 wiki -> header
2024-04-13 12:07:27 +00:00
Ryan C. Gordon
3f4ac1a3c7
winrt: Implemented SDL_GetUserFolder() for WinRT/UWP.
2024-04-13 08:05:43 -04:00
SDL Wiki Bot
cbb3c69cb0
Sync SDL3 wiki -> header
2024-04-13 01:10:12 +00:00
anon
03bc53fe31
include: Fixes the improper fix I made before of documentation, SDL_SensorType.
2024-04-12 14:51:52 -04:00
SDL Wiki Bot
935b6502ac
Sync SDL3 wiki -> header
2024-04-11 19:40:25 +00:00
anon
7ab8e4797e
include: Add documentation to SDL_MessageBoxColorType.
2024-04-11 15:39:58 -04:00
anon
1abaacedb2
include: Fix documentation generation for SDL_SensorType.
2024-04-11 15:38:54 -04:00
SDL Wiki Bot
2f4f1f6923
Sync SDL3 wiki -> header
2024-04-11 17:35:27 +00:00
Ryan C. Gordon
0df988389c
include: Add `\since` to all documentation that was missing it.
2024-04-11 13:34:29 -04:00
SDL Wiki Bot
073d2378dc
Sync SDL3 wiki -> header
2024-04-11 12:59:41 +00:00
Ryan C. Gordon
9421a01400
SDL_AudioStreamCallback: Note that there's no _requirement_ to do anything.
...
This is as opposed to something like the SDL2 audio callback, where you
_must_ supply data or disaster occurs.
2024-04-11 08:56:10 -04:00
Ryan C. Gordon
e47f2956cf
include: Documented SDL_bool a little.
2024-04-11 00:48:11 -04:00
Ryan C. Gordon
407e54e188
include: More improved docs for the wikibridge!
2024-04-11 00:37:11 -04:00
Ryan C. Gordon
f121553082
include: Fixed up SDL_AudioFormat documentation.
...
(this is not currently bridged to the wiki, but will be soon!)
2024-04-10 18:45:29 -04:00
SDL Wiki Bot
b2239cb7ba
Sync SDL3 wiki -> header
2024-04-10 19:59:14 +00:00
Ryan C. Gordon
557f26e6f0
include: Fixed up some more documentation.
2024-04-10 15:58:28 -04:00
Anonymous Maarten
06758685a5
stdinc: modify default alloca prototype
...
For compatibilty with TinyCC.
2024-04-10 08:03:46 +00:00
Petar Popovic
132cef91c8
Removing macro SDL_FColour from SDL_pixels.h
2024-04-09 18:20:03 -04:00
SDL Wiki Bot
534c44b156
Sync SDL3 wiki -> header
2024-04-09 22:04:21 +00:00
Ryan C. Gordon
a15a46340f
SDL_revision: Added documentation.
2024-04-09 18:02:30 -04:00
Petar Popovic
f687e0732a
Doxygen comment fixes in SDL_pixels.h
2024-04-09 16:57:34 -04:00
SDL Wiki Bot
196d123c66
Sync SDL3 wiki -> header
2024-04-09 16:36:25 +00:00
David Gow
d321e19ee5
stdinc: Document maths functions
...
SDL_stdinc.h has a documentation comment for SDL_acos(), but nothing else. Expand on
that comment, and add comments for the remaining maths functions.
2024-04-09 12:35:42 -04:00
David Gow
afd91b5e9c
stdinc: Note that these functions match their C runtime equivalents
...
This header basically just consists of C runtime #defines and functions, but with
an SDL_ prefix. Note this in the documentation so people don't waste their time
reading through things they already understand.
2024-04-09 12:35:42 -04:00
Henry Wilson
629c694bd6
Fixed Doxygen comments
...
Added '*' to the start of Doxygen comments for SDL_FlipSurface and SDL_DuplicateSurface so they highlight properly in IDEs
2024-04-09 12:30:13 -04:00