7164ca374e
Sync SDL3 wiki -> header
2024-05-22 00:06:36 +00:00
1f0884ffef
Sync SDL3 wiki -> header
2024-05-21 23:59:08 +00:00
45081db9d4
Build Android prefab in releaser.py script
...
[ci skip]
2024-05-22 01:28:44 +02:00
6f2621438a
Renamed DECLSPEC to SDL_DECLSPEC
2024-05-17 17:09:09 -07:00
b6b9d5508e
Renamed SDL_MixAudioFormat to SDL_MixAudio, and use float volume
2024-05-17 13:36:51 +01:00
7cddde32ac
Removed SDL_SWSURFACE, added unsigned suffix for surface flags
2024-05-16 11:40:38 -07:00
02ff85f2f3
Renamed SDL_SIMDGetAlignment() to SDL_GetSIMDAlignment()
2024-05-16 10:22:15 -07:00
4609af618a
Updated logging functions for SDL3 naming convention
2024-05-16 10:22:15 -07:00
241603b607
README-documentation-rules: Reorganized sections into a more-clear order.
...
(I hope.)
2024-05-16 12:58:14 -04:00
4b3b5fb56c
docs: Remove some mistakenly-generated pages.
2024-05-15 14:59:26 -04:00
d57f2afcaf
docs/README-documentation-rules.md: Added more content, fixed a typo.
2024-05-15 14:22:19 -04:00
661f2fc1fc
Removed the SDL_Version structure, moved SDL version to SDL.h
...
Inspired by https://github.com/libsdl-org/SDL/issues/9788
2024-05-15 10:43:31 -07:00
5a0879b7dd
Sync SDL3 wiki -> header
2024-05-15 17:17:31 +00:00
f9876b6b5c
Sync SDL3 wiki -> header
2024-05-15 16:46:12 +00:00
2066ee08c9
docs/README-documentation-rules.md: Initial shot at documenting this.
2024-05-15 12:33:53 -04:00
3baec8aab4
Renaming SDLK_QUOTEDBL to SDLK_DBLAPOSTROPHE
2024-05-14 08:46:38 -07:00
17520c2e6e
Removed SDL_RendererFlags
...
The flags parameter has been removed from SDL_CreateRenderer() and SDL_RENDERER_PRESENTVSYNC has been replaced with SDL_PROP_RENDERER_CREATE_PRESENT_VSYNC_NUMBER during window creation and SDL_PROP_RENDERER_VSYNC_NUMBER after renderer creation.
SDL_SetRenderVSync() now takes additional values besides 0 and 1.
The maximum texture size has been removed from SDL_RendererInfo, replaced with SDL_PROP_RENDERER_MAX_TEXTURE_SIZE_NUMBER.
2024-05-13 15:06:11 -07:00
94cbaaabbf
Renaming SDLK_QUOTE and SDLK_BACKQUOTE
...
Renaming SDLK_QUOTE to SDLK_APOSTROPHE.
Renaming SDLK_BACKQUOTE to SDLK_GRAVE.
This makes them similar to their scancode names.
2024-05-13 11:11:11 -07:00
a4371d28ac
doc: document how to use generator expressions + explain why we no longer provide CMake variables
2024-05-11 17:20:16 -04:00
bcbf09acde
Renamed SDL_AttachVirtualJoystickEx() to SDL_AttachVirtualJoystick()
...
The shorthand version of this function didn't allow specifying a controller name, which seems pretty important. It seems like anyone actually implementing a virtual joystick is going to want to use some of the extended functionality.
2024-05-09 14:05:58 -07:00
54fb629da5
SDL_WindowFlags is now 64-bit
...
Fixes https://github.com/libsdl-org/SDL/issues/7321
2024-05-09 10:39:54 -07:00
1944c009e9
SDL_Keycode is now Uint32
2024-05-09 10:00:46 -07:00
88fc529261
Removed misleading documentation for SDL_AppEvent()
...
Fixes https://github.com/libsdl-org/SDL/issues/9731
2024-05-09 09:01:27 -07:00
3a6d9c59f4
wayland: Add mouse pointer warp support
...
The pointer confinement protocol does allow attempted warping the pointer via a hint, provided that the pointer is locked at the time of the request, and the requested coordinates fall within the bounds of the window.
Toggle the pointer locked state and request the pointer warp when the required protocol is available. This is similar to what XWayland does internally.
2024-05-03 12:33:19 -04:00
b18a071639
Removed SDL_DROPEVENT_DATA_SIZE and SDL_TEXTEDITINGEVENT_TEXT_SIZE
...
Fixes https://github.com/libsdl-org/SDL/issues/9681
2024-05-03 09:19:49 -07:00
46b69af5a3
SDL_vulkan.h: Remove Tizen compatibility typedefs.
...
Any app for this system that wants to move to SDL3 will have to adjust to
all the other API changes anyhow, so there's no need to keep these anymore.
Fixes #9678 .
2024-05-02 23:25:44 -04:00
7bfecacc02
Removing function macro SDL_TABLESIZE()
2024-04-29 13:52:48 -07:00
d42d661498
Sync SDL3 wiki -> header
2024-04-26 18:04:12 +00:00
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
42579e2af1
docs: Remove README-hg.md
...
It's been a few years in general, and SDL3 has never been in Mercurial.
We'll leave this document alive in the SDL2 branch, though!
2024-04-23 15:48:29 -04:00
64d5fb6ab6
Sync SDL3 wiki -> header
2024-04-18 17:41:14 +00:00
093160904d
SDL_Keymod: Removed SDL_KMOD_RESERVED.
...
Fixes #9481 .
2024-04-17 17:30:10 -04:00
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
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
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
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
56e6f05440
SDL_RendererFlip rename fixes
2024-04-15 03:32:23 -10:00
239b34d760
docs: Added some notes about iOS and the main callbacks.
2024-04-13 15:14:32 -04:00
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
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
98e9f361a8
winrt: Remove SDL_WinRTGetFSPathUNICODE, rename SDL_WinRTGetFSPathUTF8.
...
Fixes #9470 .
2024-04-13 08:24:12 -04:00
d7dcf4916f
docs: Mention the SDL_HINT_VIDEO_SYNC_WINDOW_OPERATIONS hint in the migration guide
2024-04-10 21:51:03 -04:00
9b5944a14f
Removing SDL_Colour macro
2024-04-09 12:25:36 -04:00
c8a066019b
Renaming SDL_eventaction to SDL_EventAction
2024-04-08 14:28:52 -04:00
5fa87e29e7
Removed SDL_RENDERER_ACCELERATED and SDL_RENDERER_SOFTWARE
...
These flags are unnecessary and have always been a source of confusion.
2024-04-04 13:30:49 -07:00
8847b35244
Separate joystick power state into battery status and percentage
...
This allows you to see battery percentage while the controller is charging
2024-04-01 13:59:00 -07:00
5e624c2083
Moved display and window event renaming to the correct header section
...
Closes https://github.com/libsdl-org/SDL/pull/9396
2024-04-01 13:57:05 -07:00
74b58aebb9
README-migration: fix function signature on SDL_(Read|Write)IO docs.
2024-03-31 16:43:53 -04:00
6b20152bda
README-migration: Removed duplicate paragraph.
...
(Exact same text also exists earlier in the SDL_audio.h section.)
2024-03-31 16:26:08 -04:00
60cacc8277
README-migration: Fix wrong new name for SDL_WINDOWEVENT_ENTER and SDL_WINDOWEVENT_LEAVE
2024-03-31 12:47:55 -07:00
a5c892d2c3
stdlib: Improve Unicode support and consistency in string comparison functions.
...
SDL_strcasecmp (even when calling into a C runtime) does not work with
Unicode chars, and depending on the user's locale, might not work with
even basic ASCII strings.
This implements the function from scratch, using "case-folding,"
which is a more robust method that deals with various languages. It
involves a hashtable of a few hundred codepoints that are "uppercase" and
how to map them to lowercase equivalents (possibly increasing the size of
the string in the process). The vast majority of human languages (and
Unicode) do not have letters with different cases, but still, this static
table takes about 10 kilobytes on a 64-bit machine.
Even this will fail in one known case: the Turkish 'i' folds differently
if you're writing in Turkish vs other languages. Generally this is seen as
unfortunate collateral damage in cases where you can't specify the language
in use.
In addition to case-folding the codepoints, the new functions also know how
to decode the various formats to turn them into codepoints in the first
place, instead of blindly stepping by one byte (or one wchar_t) per
character.
Also included is casefolding.txt from the Unicode Consortium and a perl
script to generate the hashtable from that text file, so we can trivially
update this if new languages are added in the future.
A simple test using the new function:
```c
#include <SDL3/SDL.h>
int main(void)
{
const char *a = "α ε η";
const char *b = "Α Ε Η";
SDL_Log(" strcasecmp(\"%s\", \"%s\") == %d\n", a, b, strcasecmp(a, b));
SDL_Log("SDL_strcasecmp(\"%s\", \"%s\") == %d\n", a, b, SDL_strcasecmp(a, b));
return 0;
}
```
Produces:
```
INFO: strcasecmp("α ε η", "Α Ε Η") == 32
INFO: SDL_strcasecmp("α ε η", "Α Ε Η") == 0
```
glibc strcasecmp() fails to compare a Greek lowercase string to its uppercase
equivalent, even with a UTF-8 locale, but SDL_strcasecmp() works.
Other SDL_stdinc.h functions are changed to be more consistent, which is to
say they now ignore any C runtime and often dictate that only English-based
low-ASCII works with them.
Fixes Issue #9313 .
2024-03-29 15:01:40 -04:00
0aa1022358
Clarify that SDL_SetWindowKeyboardGrab() is only needed if you set SDL_HINT_GRAB_KEYBOARD
2024-03-28 09:25:22 -07:00
ad92c9e300
README-main-functions.md: Added notes about the new `appstate` parameter.
2024-03-27 23:04:36 -04:00
7a9f99cff3
Corrected migration documentation for SDL_GetDisplayDPI()
...
Fixes https://github.com/libsdl-org/SDL/issues/9386
2024-03-27 18:27:57 -07:00
a9dbdb1947
Removed SDL_RenderSetIntegerScale() renaming note
...
Fixes https://github.com/libsdl-org/SDL/issues/9384
2024-03-27 12:47:23 -07:00
cde2dcd0d4
Note that SDL_EVENT_SYSWM has been removed
...
Fixes https://github.com/libsdl-org/SDL/issues/9382
2024-03-27 11:39:10 -07:00
fed5f3a81b
We no longer automatically set up a logical presentation mode
2024-03-26 10:40:40 -07:00
b9a88bbecb
Removed SDL_TextInputShown()
...
This was only implemented on Windows and often confused with SDL_ScreenKeyboardShown()
2024-03-25 13:26:23 -07:00
6443c75eda
Removed SDL_TEXTINPUTEVENT_TEXT_SIZE
2024-03-25 13:26:23 -07:00
f14fb979c1
Remove legacy SDL2 input grab API
2024-03-24 16:53:23 -07:00
8f33f5cc33
Sync SDL3 wiki -> header
2024-03-24 18:34:24 +00:00
a20eec1415
Tweaking documentation for the SDL 3.0 preview release
2024-03-24 06:16:02 -07:00
72fc6f86e5
Text input is no longer automatically enabled when initializing video.
...
Fixes https://github.com/libsdl-org/SDL/issues/9309
Fixes https://github.com/libsdl-org/SDL/issues/9268
2024-03-23 16:31:00 -07:00
a1a0156756
Renamed SDL_SizeIO() SDL_GetIOSize()
2024-03-18 00:27:18 -04:00
d65ae710a1
Renamed SDL_LogGetOutputFunction() and SDL_LogSetOutputFunction() to match SDL 3.0 naming convention
2024-03-17 12:28:11 -07:00
c175eb488c
iostream: Note that the new name has nothing to do with C++'s iostream class.
2024-03-15 01:16:31 -04:00
5a21d87e69
rwops: Changed filenames that reference "rwops" to "iostream".
2024-03-14 23:30:59 -04:00
5440fd7d12
README-migration.md: Fixed some RWops mistakes.
2024-03-14 23:13:26 -04:00
3a344cf877
rwops: Fixed some SDL2 symbols that got missed.
2024-03-14 21:57:21 -04:00
fc7afa9cbf
rwops: Renamed SDL_RWops to SDL_IOStream, and other related symbols.
2024-03-14 19:38:12 -04:00
7d4d8ccde0
rwops: Rename everything from SDL_RWxxx to SDL_XxxRW.
2024-03-14 19:37:04 -04:00
655ceb3b31
rwops: Renamed SDL_CreateRW and SDL_DestroyRW to SDL_OpenRW and SDL_CloseRW.
2024-03-14 19:37:01 -04:00
525919b315
rwops: Reworked RWops for SDL3.
...
- SDL_RWops is now an opaque struct.
- SDL_AllocRW is gone. If an app is creating a custom RWops, they pass the
function pointers to SDL_CreateRW(), which are stored internally.
- SDL_RWclose is gone, there is only SDL_DestroyRW(), which calls the
implementation's `->close` method before freeing other things.
- There is only one path to create and use RWops now, so we don't have to
worry about whether `->close` will call SDL_DestroyRW, or if this will
risk any Properties not being released, etc.
- SDL_RWFrom* still works as expected, for getting a RWops without having
to supply your own implementation. Objects from these functions are also
destroyed with SDL_DestroyRW.
- Lots of other cleanup and SDL3ization of the library code.
2024-03-14 19:36:08 -04:00
efbbafb3f1
Re-added balls to the SDL joystick API
...
It turns out these were being used on Linux and at least one virtual driver was making use of them (thanks @mrfixit2001!)
2024-03-10 21:30:14 -07:00
5643fd683f
Added migration notes for enum type changes
2024-03-06 16:59:28 -08:00
4f58d18373
Typedef `SDL_WindowFlags`
...
Window flags were previously an enum with the same name.
See ebd7f9adbd
2024-03-06 15:08:12 -08:00
860155680d
SDL_RegisterEvents() now returns 0 if it couldn't allocate any user events.
2024-03-06 09:51:15 -08:00
e0dadba6f5
Sync SDL3 wiki -> header
2024-02-25 22:26:23 +00:00
e6d9251ecb
docs: improve CMake documentation for Apple
2024-02-25 23:25:11 +01:00
276566235c
Removed SDL_ClearHints() from the public API
...
Fixes https://github.com/libsdl-org/SDL/issues/9129
2024-02-24 21:07:50 -08:00
58e6eacf97
docs: SDL_INIT_EVERYTHING does not exist anymore
2024-02-21 00:52:04 +01:00
bc984f78bf
android: Remove blocking permission request code. Async only in SDL3!
...
(this actually still blocks at our internal points of usage, though, for
replacement at a later time.)
2024-02-13 12:06:51 -05:00
734d6fa1f3
Fixed documentation of SDL_PROP_WINDOW_CREATE_EXTERNAL_GRAPHICS_CONTEXT_BOOLEAN
2024-02-12 18:53:26 -08:00
dca2721b91
Removed SDL_HINT_VIDEO_EXTERNAL_CONTEXT
...
This is replaced with SDL_PROP_WINDOW_CREATE_EXTERNAL_GRAPHICS_CONTEXT in SDL_CreateWindowWithProperties()
2024-02-12 09:54:33 -08:00
2f7c24e4be
Removed SDL_HINT_RENDER_SCALE_QUALITY
...
Textures now default to linear filtering, use SDL_SetTextureScaleMode(texture, SDL_SCALEMODE_NEAREST) if you want nearest pixel mode instead.
2024-02-12 09:54:33 -08:00
20051f805f
Removed SDL_HINT_WINDOWS_NO_CLOSE_ON_ALT_F4
...
Replaced with SDL_HINT_WINDOWS_CLOSE_ON_ALT_F4, defaulting to SDL_TRUE
2024-02-12 09:54:33 -08:00
7cb1ca60ec
Removed SDL_HINT_RENDER_OPENGL_SHADERS
...
Shaders are always used if they are available.
2024-02-12 09:54:33 -08:00
9920e062d5
Removed SDL_HINT_THREAD_STACK_SIZE
...
The stack size can be specified using SDL_CreateThreadWithStackSize()
2024-02-12 09:54:33 -08:00
9e505252c0
Renamed SDL_HINT_PS2_DYNAMIC_VSYNC SDL_HINT_RENDER_PS2_DYNAMIC_VSYNC
2024-02-12 09:54:33 -08:00
a538936821
Renamed SDL_HINT_LINUX_JOYSTICK_DEADZONES to SDL_HINT_JOYSTICK_LINUX_DEADZONES
2024-02-12 09:54:33 -08:00
980c379a0b
Renamed SDL_HINT_LINUX_JOYSTICK_CLASSIC to SDL_HINT_JOYSTICK_LINUX_CLASSIC
2024-02-12 09:54:33 -08:00
1f7936d545
Renamed SDL_HINT_LINUX_HAT_DEADZONES to SDL_HINT_JOYSTICK_LINUX_HAT_DEADZONES
2024-02-12 09:54:33 -08:00
39cfb437ed
Renamed SDL_HINT_LINUX_DIGITAL_HATS to SDL_HINT_JOYSTICK_LINUX_DIGITAL_HATS
2024-02-12 09:54:33 -08:00
b557c15bcf
Renamed SDL_HINT_JOYSTICK_GAMECUBE_RUMBLE_BRAKE to SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE
2024-02-12 09:54:33 -08:00
4f628b5b62
Renamed SDL_HINT_GDK_TEXTINPUT_DEFAULT to SDL_HINT_GDK_TEXTINPUT_DEFAULT_TEXT
2024-02-12 09:54:33 -08:00
fd5d761128
Renamed SDL_HINT_DIRECTINPUT_ENABLED to SDL_HINT_JOYSTICK_DIRECTINPUT
2024-02-12 09:54:33 -08:00
a5da7d0dd5
Renamed SDL_HINT_ALLOW_TOPMOST to SDL_HINT_WINDOW_ALLOW_TOPMOST
2024-02-12 09:54:33 -08:00
9ce7fe2848
Removed SDL_HINT_ACCELEROMETER_AS_JOYSTICK
...
Sensors are a first-class object in SDL and we haven't gotten any feedback that this feature is useful these days.
Closes https://github.com/libsdl-org/SDL/pull/7879
2024-02-12 09:54:33 -08:00
cacac6cc34
Updated structure and field names for consistency
...
Type names are camel case and field names are snake case except for fields ending in id, which are capitalized.
Fixes https://github.com/libsdl-org/SDL/issues/6955
2024-02-11 08:27:56 -08:00
f95b7ee4da
Renamed SDL_HasWindowSurface to SDL_WindowHasSurface
...
Fixes https://github.com/libsdl-org/SDL/issues/9034
2024-02-09 17:42:18 -08:00
SDL Wiki Bot
Anonymous Maarten
Sam Lantinga
Brick
Ryan C. Gordon
Petar Popovic
Frank Praznik
Mirko Galimberti
Cameron Gutman
Susko3