132cef91c8
Removing macro SDL_FColour from SDL_pixels.h
2024-04-09 18:20:03 -04:00
534c44b156
Sync SDL3 wiki -> header
2024-04-09 22:04:21 +00:00
a15a46340f
SDL_revision: Added documentation.
2024-04-09 18:02:30 -04:00
f687e0732a
Doxygen comment fixes in SDL_pixels.h
2024-04-09 16:57:34 -04:00
196d123c66
Sync SDL3 wiki -> header
2024-04-09 16:36:25 +00:00
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
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
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
9b5944a14f
Removing SDL_Colour macro
2024-04-09 12:25:36 -04:00
baf09904b3
Sync SDL3 wiki -> header
2024-04-09 13:59:22 +00:00
79dc6af98f
SDL_endian.h: Documented SDL_Swap* macros.
2024-04-09 09:58:01 -04:00
e044318a8e
Sync SDL3 wiki -> headers
2024-04-09 00:50:03 -04:00
ad090d2444
include: A ton of little documentation tweaks, fixes, and improvements.
...
This is just stuff I noticed while working on the wikiheaders updates. A
thorough pass over all the docs would not be terrible, and maybe a simple
script to check for consistency (does everything have a `\since` on it? etc)
might be nice, too.
2024-04-09 00:50:02 -04:00
6906c50e8b
assert: SDL_AssertData::always_ignore should be an SDL_bool, not an int.
2024-04-09 00:50:01 -04:00
c8a066019b
Renaming SDL_eventaction to SDL_EventAction
2024-04-08 14:28:52 -04:00
1efadcc5d4
Revert renaming SDL_eventaction. adding it again in next commit with
...
scripts
This reverts commit f08c31060a
2024-04-08 14:28:52 -04:00
764fe72449
SDL_time.h: Renaming enums SDL_DATE_FORMAT and SDL_TIME_FORMAT to SDL_DateFormat and SDL_TimeFormat
2024-04-07 23:03:01 -04:00
f08c31060a
Renaming SDL_eventaction to SDL_EventAction
2024-04-07 12:04:32 -04:00
5c9dbf65a3
SDL_version.h: Fix some whitespace.
2024-04-06 02:09:48 -04:00
6ad390fc50
File dialog improvements
...
- Add a globally-accessible function to handle the parsing of filter extensions
- Remove the ability of putting the wildcard ('*') among other patterns; it's either a list of patterns or a single '*' now
- Add a hint to select between portals and Zenity on Unix
2024-04-04 22:07:14 -07: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
3f8dba3713
Including SD_error.h into headers with error-returning functions
2024-04-04 11:12:58 -07:00
e12b8e767a
SDL_filesystem.h: Fixed some whitespace.
2024-04-04 10:44:19 -04:00
1a97d1f649
Sync SDL3 wiki -> header
2024-04-04 14:42:26 +00:00
de91aaa452
SDL_locale.h - SDL_GetPreferredLocales() - adding SDL_GetError() comment
2024-04-04 07:41:50 -07:00
7ae5474305
SDL_quit.h - removing SDL_error.h inclusion
2024-04-04 07:41:50 -07:00
0abdc1a343
Renamed GLOBDIR to GLOB
2024-04-04 07:40:48 -07:00
ac372e99fe
Sync SDL3 wiki -> header
2024-04-04 13:41:27 +00:00
764207d873
filesystem: Added SDL_GlobDirectory() and SDL_GlobStorageDirectory().
...
Fixes #9287 .
2024-04-04 09:40:13 -04:00
9192485746
filesystem: SDL_EnumerateDirectory should return -1 or 0.
...
The callback requesting a non-error stop should not return a special value.
2024-04-04 09:40:13 -04:00
c7787a9191
The hint environment variables don't have the word "HINT" in them
...
Fixes https://github.com/libsdl-org/SDL/issues/9436
2024-04-02 19:24:07 -07:00
17d4f8d699
Updated to version 3.1.1 for the preview release
2024-04-01 17:03:46 -07:00
a82ed82bc7
SDL_QueryTexture() fills in a pointer to SDL_PixelFormatEnum
2024-04-01 15:45:22 -07:00
18c8af6e48
Sync SDL3 wiki -> header
2024-04-01 21:00:26 +00: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
5f763083fc
Use SDL_EventType and fix event name in comment
2024-04-01 11:04:02 -07:00
c40e9cc634
Sort includes
2024-04-01 11:04:02 -07:00
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
Petar Popovic
SDL Wiki Bot
Ryan C. Gordon
David Gow
Henry Wilson
Semphris
Sam Lantinga
Susko3
Ozkan Sezer
Frank Praznik
Cameron Gutman
Anonymous Maarten
Ethan Lee