c96bc8b1a2
Add missing includes for SDL_MouseID
...
Missed in f8844d387cd1eb4adb16
2024-03-31 16:11:23 -07:00
96c93d2252
Sync SDL3 wiki -> header
2024-03-29 19:02:25 +00:00
49029c8454
stdinc: Document a bunch of ctype/string functions.
...
This is intended to help codify the rules for locale and Unicode in SDL3,
which were less-well defined in SDL2.
2024-03-29 15:01:40 -04:00
6cf71ca9a9
SDL_stdinc.h: Android passes sizeof(ENUM) == sizeof(int) assertion
...
Reference issue: https://github.com/libsdl-org/SDL/issues/9392 .
2024-03-28 20:28:02 +03:00
0d007bbb01
psp: Fixed building with pspdev when not using CMake.
...
(psp-cmake defines `__PSP__` on the command line, but the compiler itself
only defines `__psp__` and some variations.
Fixes #9378 .
2024-03-28 09:27:21 -04:00
38e3c6a4aa
main: Add an optional `appstate` param to main callback entry points.
...
This allows apps to maintain state data without using global variables.
Fixes #9377 .
2024-03-27 17:22:08 -04:00
05b3605a41
Sync SDL3 wiki -> header
2024-03-27 18:02:23 +00:00
5abcfad352
video: Document that renderer lifetimes are tied to their associated windows
2024-03-27 11:01:41 -07:00
823ab13b9c
SDL_CreateTexture() takes a SDL_PixelFormatEnum format parameter
2024-03-26 10:40:40 -07:00
78c7834f90
Added SDL_HINT_WINDOWS_RAW_KEYBOARD to control whether raw keyboard is enabled on Windows
2024-03-25 20:41:05 -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
36e73bdda4
Updated to version 3.1.0 for the preview release
2024-03-24 06:16:02 -07:00
1d0e5286aa
Limit CPU features through a hint
2024-03-23 16:36:44 -07:00
675216e81b
Sync SDL3 wiki -> header
2024-03-23 23:32:24 +00: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
9eb87ca325
Note that many things are considered mice and keyboards that you might not expect
2024-03-23 16:31:00 -07:00
c0f4565552
Added SDL_GetKeyboardName() and SDL_GetMouseName()
2024-03-23 16:31:00 -07:00
d1eb4adb16
Be explicit about the event mouse and keyboard ID
2024-03-23 16:31:00 -07:00
2fe1a6a279
Initial support for hotplugging mice and keyboards
2024-03-23 16:31:00 -07:00
171ff041d0
Removed invalid ascii from headers
2024-03-23 16:31:00 -07:00
917d683811
Moved SDL_JoyBallEvent together with the other joystick events
2024-03-21 12:51:59 -07:00
888cc29df6
add missing `reserved` field to struct SDL_JoyBallEvent,
...
Fixes https://github.com/libsdl-org/SDL/issues/9327
2024-03-21 20:10:50 +03:00
b90fed094f
Standardise header includes
...
Changes "SDL_*.h" and "SDL3/SDL_*.h" to <SDL3/SDL_*.h>
2024-03-19 13:41:53 -07:00
ba0417db40
Sync SDL3 wiki -> header
2024-03-19 17:58:24 +00:00
a6fbf0488c
Add time and realtime clock functions
...
Adds functions to query the system's realtime clock, convert time intervals to/from a calendar date and time in either UTC or the local time, and perform time related calculations.
An SDL_Time type (a time interval represented in nanoseconds), and SDL_DateTime struct (broken down calendar date and time) were added to facilitate this functionality.
Querying the system time results in a value expressed in nanoseconds since the Unix epoch (Jan 1, 1970) in UTC +0000. Conversions to and from the various platform epochs and units are performed when required.
Any direct handling of timezones and DST were intentionally avoided. The offset from UTC is provided when converting from UTC to a local time by calculating the difference between the original UTC and the resulting local time, but no other timezone or DST information is used.
The preferred date formatting and 12/24 hour time for the system locale can be retrieved via global preferences.
Helper functions for obtaining the day of week or day or year for calendar date, and getting the number of days in a month in a given year are provided for convenience. These are simple, but useful for performing various time related calculations.
An automated test for time conversion is included, as is a simple standalone test to display the current system date and time onscreen along with a calendar, the rendering of which demonstrates the use of the utility functions (press up/down to increment or decrement the current month, and keys 1-5 to change the date and time formats).
2024-03-19 10:57:36 -07:00
b2682da035
Sync SDL3 wiki -> header
2024-03-19 04:57:27 +00:00
24ec1c09b9
Renamed SDL_PROP_IOSTREAM_STDIO_HANDLE_POINTER to SDL_PROP_IOSTREAM_STDIO_FILE_POINTER
2024-03-18 21:56:11 -07:00
1eb7b79986
video: Prepend global video property with "SDL"
2024-03-18 21:52:39 -04:00
0d0aaa2d75
Sync SDL3 wiki -> header
2024-03-18 15:57:23 +00:00
92d01ef12a
You can pass NULL to SDL_GetPathInfo() and SDL_GetStoragePathInfo() to test for the existence of a file.
2024-03-18 08:56:24 -07:00
ebb6582534
wayland: Handle the toplevel export property as a string
...
xdg-toplevel export handles are strings, so treat the property as one. Avoids the need to manually manage the string pointer.
2024-03-18 11:41:02 -04:00
fc26d5d328
Sync SDL3 wiki -> header
2024-03-18 04:28:30 +00:00
a1a0156756
Renamed SDL_SizeIO() SDL_GetIOSize()
2024-03-18 00:27:18 -04:00
df0f5deddf
Added SDL_IOFromDynamicMem()
2024-03-18 00:27:18 -04:00
747300b356
SDL file times are 64-bit integers representing nanoseconds since the Unix epoch
2024-03-17 13:21:04 -07:00
e7b9f75e62
Sync SDL3 wiki -> header
2024-03-17 19:29:22 +00:00
d65ae710a1
Renamed SDL_LogGetOutputFunction() and SDL_LogSetOutputFunction() to match SDL 3.0 naming convention
2024-03-17 12:28:11 -07:00
d8a54cd4f8
Updated "see also" references to be more consistent
...
Fixes https://github.com/libsdl-org/SDL/issues/9282
2024-03-17 12:28:11 -07:00
a206e1e3c0
Sync SDL3 wiki -> header
2024-03-17 15:40:25 +00:00
f460f42e70
Added filesystem operations to SDL_Storage
2024-03-17 08:39:43 -07:00
7a088527c1
Removed the reserved parameter from SDL_EnumerateDirectoryCallback
...
If someone needs to, say, include an SDL_Storage object, they can simply point userdata at a structure that includes the the storage and any other data needed in enumeration.
2024-03-17 08:39:43 -07:00
ec3ba387d1
Added SDL_OpenFileStorage() for local file storage
2024-03-17 08:39:43 -07:00
db0c1d7aeb
Added portable file and directory operations (thanks @icculus!)
2024-03-17 08:39:43 -07:00
fe5c34d4bd
Renamed storage functions to match SDL 3.0 naming convention
2024-03-17 08:39:43 -07:00
9ccde0def4
Sync SDL3 wiki -> header
2024-03-16 14:20:24 +00:00
744227e6ab
Add SDL_storage
2024-03-16 07:19:50 -07:00
19764ffcc8
wayland: Add the xdg-foreign-unstable-v2 protocol
...
Add the xdg-foreign-unstable-v2 protocol and use it to create export handles for toplevel windows, which will be used when an external component, such as the file chooser portal, requires it.
2024-03-15 18:30:05 -04:00
2b45452dd5
Adding comments to init-flags SDL_INIT_AUDIO and SDL_INIT_SENSOR that they imply SDL_INIT_EVENTS
...
When initializing SDL with the flag SDL_INIT_AUDIO or SDL_INIT_SENSOR the event subsystem also gets initialized(SDL_INIT_EVENTS). This isn't mentioned in the comments.
This commit adds these two comments.
2024-03-15 13:10:49 -07:00
fa7ec59ecd
Sync SDL3 wiki -> header
2024-03-15 19:59:26 +00:00
b7cda16613
iostream: Final fixes before merging.
...
- SDL_GetRWProperties -> SDL_GetIOProperties
- SDL_GetRWStatus -> SDL_GetIOStatus
- Some documentation corrections and improvements.
2024-03-15 15:37:03 -04: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
6776b6108a
iostream: "free*" params should be "closeio".
2024-03-14 23:14:46 -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
fe33b2a81b
rwops: Give implementations access to status value.
2024-03-14 19:37:07 -04:00
447c29e65c
include: Added missing RWops documentation.
2024-03-14 19:37:07 -04:00
cc58da4c63
rwops: Add SDL_GetRWStatus, make the statuses into an enum.
2024-03-14 19:37:06 -04:00
e35c304022
rwops: Add properties for some of the internal implementation details.
2024-03-14 19:37:05 -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
495e432fb9
Sync SDL3 wiki -> header
2024-03-14 22:41:24 +00:00
70c2e15615
Add file dialogs
2024-03-14 15:40:25 -07:00
6c11449cd4
Added a note for the SDL_CommonEvent type
2024-03-14 09:00:47 -07:00
442073f379
Added missing reserved field in SDL_CameraDeviceEvent (thanks @Saalvage!)
2024-03-14 08:51:48 -07:00
9bef331dc8
Note that SDL_UserEvent and SDL_Event type are intentionally Uint32
2024-03-14 08:49:02 -07:00
3875ef4552
Removed duplicated line (thanks @sechshelme!)
...
Fixes https://github.com/libsdl-org/SDL/issues/9264
2024-03-13 13:47:32 -07: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
6534029691
Add DualShock 3 HIDAPI support on Windows ( #9144 )
...
This adds HIDAPI support for DualShock 3 controllers on Windows, addressing the current absence of this feature in SDL. To utilize this functionality, the official Sony driver 'sixaxis.sys' must be installed. HID offers several advantages over DirectInput, including rumble support and the ability to control the LED lights that display the controller number.
2024-03-10 20:08:36 -07:00
fde420a645
Revert "Added SDL_FLIP_DIAGONAL"
...
This reverts commit b9ab326982
2024-03-10 15:20:36 -07:00
b9ab326982
Added SDL_FLIP_DIAGONAL
...
Since SDL_RenderFlip is an enum, SDL_FLIP_HORIZONTAL and SDL_FLIP_VERTICAL can not be OR'ed to get the "SDL_FLIP_DIAGONAL".
Render code is actually able to perform these 3 kind of "flipping" so I just added a new enum called SDL_FLIP_DIAGONAL with the OR'ed value (3) so it can be used.
2024-03-10 09:27:14 -07:00
2a775cad6f
Named typedef-ed structs Gave name to structs that were defined like anonymous struct with name given by typedef. Example 'typedef struct {...} Foo;' -> 'typedef struct Foo {...} Foo;'
2024-03-10 09:04:18 -07:00
37d066b99b
Clarify what pitch means (thanks @zlago!)
2024-03-10 09:02:59 -07:00
9e89f093d9
remove stale / wrong information from SDL_RWread() documentation
2024-03-08 18:55:19 +03:00
790cd395f5
Make sure the type in the SDL_Event aligns properly across the union
2024-03-07 06:58:43 -08:00
e9ab2d46de
Revert "Change `SDL_Keycode` type to an enum"
...
SDL_Keycode can actually be any printable character on the keyboard, so isn't limited to the enumerated values of SDL_KeyCode.
2024-03-07 06:58:43 -08:00
33eaddc565
Cleaned up various type conversion issues
...
This makes sure SDL_PixelFormatEnum flows through the internal code correctly, as well as fixing a number of other minor issues.
2024-03-07 06:58:43 -08:00
f53bdc9531
The pixel format in SDL_DisplayMode uses SDL_PixelFormatEnum
2024-03-07 03:39:06 -08:00
59ab5c0824
Sync SDL3 wiki -> header
2024-03-07 00:20:27 +00:00
c70710cde8
SDL_GetPixelFormatEnumForMasks() returns SDL_PixelFormatEnum
2024-03-06 16:19:08 -08:00
722f4104bf
Use enums as types in SDL_*Event structures
...
The main `SDL_Event` union is not using the enum as
valid user events types are not in the enum.
2024-03-06 15:40:05 -08:00
ce44eff3d2
Use `SDL_WindowFlags` in public headers
2024-03-06 15:08:12 -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
424616e032
Use SDL_PixelFormatEnum as type
2024-03-06 15:02:13 -08:00
f8cb3c742d
Change `SDL_Keycode` type to an enum
2024-03-06 12:17:53 -08:00
f8844d387c
Use specific types in SDL_touch.h
...
Missed when picking 7ff34249c753122a2ba67e78aa6e9f9b56aa4a65 from https://github.com/libsdl-org/SDL/pull/9191 .
2024-03-06 10:35:20 -08:00
2d0cd90171
Sync SDL3 wiki -> header
2024-03-06 17:52:26 +00:00
860155680d
SDL_RegisterEvents() now returns 0 if it couldn't allocate any user events.
2024-03-06 09:51:15 -08:00
95fbbc6f07
Fixed accidental use of tabs
2024-03-05 16:55:26 -08:00
e268cdbec6
Use specific types in public headers ( #9205 )
...
Uses specific typedef'd types instead of generic integral types where applicable.
2024-03-05 16:52:15 -08:00
db24560387
Additional colorspace clarification
...
Note that SDL_MATRIX_COEFFICIENTS_BT470BG is functionally equivalent to SDL_MATRIX_COEFFICIENTS_BT601
2024-03-05 16:47:36 -08:00
b3858ec5f7
BT2020_CL is very different from BT2020_NCL, and not currently supported
2024-03-05 15:49:17 -08:00
9db68f97f9
Reverted SDL_Vulkan_GetInstanceExtensions() API change
...
This function is commonly used with Vulkan structures that use uint32_t, so we should keep the Uint32 signature.
2024-03-05 13:39:42 -08:00
0b4a195f4b
Sync SDL3 wiki -> header
2024-03-05 21:32:25 +00:00
cea717e5d3
Removed some uneeded 'unsigned': renderer.num_texture_format and SDL_Vulkan_GetInstanceExtensions() prototype
2024-03-05 13:31:28 -08:00
ffef13e1e1
Sync SDL3 wiki -> header
2024-03-04 17:30:25 +00:00
48471f7dbd
Added SDL_AddVulkanRenderSemaphores() for external synchronization with SDL rendering
2024-03-04 09:29:36 -08:00
Susko3
SDL Wiki Bot
Ryan C. Gordon
Ozkan Sezer
Frank Praznik
Sam Lantinga
Cameron Gutman
Anonymous Maarten
Ethan Lee
Petar Popovic
Semphris
Riccardo Marcangelo
RPP-dev
Tolik708
Sylvain