Ryan C. Gordon
9f8425a7a9
include: Fixed wiki formatting that got mangled into the headers.
2023-02-26 21:47:17 -05:00
Ryan C. Gordon
0598ecc150
Sync wiki -> headers.
2023-02-24 11:49:41 -05:00
Ozkan Sezer
2eb4ab5bb0
SDL_revision.h: added missing newline at end of file.
2023-02-23 23:55:56 +03:00
Sam Lantinga
a758f87f6f
Fixed compile error on Android when assert is defined as SDL_assert
2023-02-22 15:32:49 -08:00
Anonymous Maarten
213fbd01c5
SDL_endian.h: improve doxygen documentation
2023-02-19 10:01:33 -08:00
Anonymous Maarten
549cedfa88
include: add \brief to includes
2023-02-19 10:01:33 -08:00
Anonymous Maarten
18f38bef03
Remove include/SDL3/SDL_name.h
2023-02-18 12:33:54 -08:00
Sam Lantinga
284ae91734
Include SDL_events.h for SDL_ConvertEventToRenderCoordinates()
2023-02-13 17:50:29 -08:00
Sylvain
81c94a165c
Add \since docs where missing and resets some to 3.0.0
...
- remove a \returns
2023-02-12 20:43:11 +01:00
Sylvain
3d93b07d5b
Documentation \param fixes
2023-02-12 08:21:36 -08:00
Sylvain
49e47b523a
Update `\returns` to the generic form
2023-02-12 08:21:02 -08:00
Sylvain
612584277c
Fix build documentation
2023-02-12 09:54:36 +01:00
Sylvain
e9af964cf4
More `\param` added for SDL function in stdinc.h
2023-02-12 09:50:38 +01:00
Sylvain
43c08170af
Add missing '\param' documentation
2023-02-12 09:42:13 +01:00
Sylvain
ce366facaa
Add missing \returns, change "return" to "returns" to have same naming
2023-02-12 09:22:25 +01:00
Sam Lantinga
144390f8fc
Fixed renaming suggestion for SDL_WINDOWEVENT_CLOSE
2023-02-10 06:48:54 -08:00
Sam Lantinga
13d9e41c3f
SDL_WINDOWEVENT_SIZE_CHANGED was renamed SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED
2023-02-10 06:38:14 -08:00
Sam Lantinga
69a6796476
Note that the coordinates in SDL_GetDisplayForPoint() and SDL_GetDisplayForRect() are screen coordinates
2023-02-10 06:31:10 -08:00
Sylvain
32d30944a1
SDL_GetNumTouchFingers(): 0 is a valid value. negative is automatically an error
2023-02-10 09:30:31 +01:00
Sylvain
a2f3711c80
SDL_AndroidGetExternalStorageState(): return 0 on success, and fills *state with flags
2023-02-10 09:30:31 +01:00
Sam Lantinga
5b77ad54c4
Fixed order and constness of parameters to SDL_ConvertAudioSamples()
2023-02-09 17:49:35 -08:00
Sam Lantinga
e65e2c8ed7
SDL_CloseJoystick() should return void, not int
2023-02-09 17:26:16 -08:00
Sylvain
dc74a67a57
SDL_UnlockTexture: change from 'int' to 'void'
2023-02-09 20:17:27 +01:00
Sylvain
cee245b6a9
SDL_*SceenSaver(): change return value to int. // add SDL_Unsupported() errors
2023-02-09 08:16:46 -08:00
Sylvain
e2e5e670bf
Remove returns int from Destroy/Close/Unlock functions
2023-02-09 07:57:14 -08:00
Linus Probert
3bd737d44c
Add error returns to void functions that can fail/set errors.
...
This takes care of the last set of void functions that could
potentially be shifted to instead return an int indicating success and
setting an error in case of an error.
2023-02-09 07:23:21 -08:00
Sylvain
b305d9e3c0
Change return type from void to int for audio function. Eventually set invalid parameter error.
2023-02-08 17:43:44 -08:00
Sam Lantinga
824b9b0a58
Removed SDL_GetDisplayDPI()
...
This function wasn't consistently correct across platforms and devices.
If you want the UI scale factor, you can use display_scale in the structure returned by SDL_GetDesktopDisplayMode(). If you need an approximate DPI, you can multiply this value times 160 on iPhone and Android, and 96 on other platforms.
2023-02-08 17:35:54 -08:00
Sylvain
c5c94a6be6
Change return type from void to int, for functions that set an error
...
(SDL_SetError(), SDL_OutOfMemory(), SDL_Unsupported(), SDL_InvalidParam())
Update prototype to forward errors to generic layer, for the functions:
MoveCursor, WarpMouse, GL_DeleteContext, GetDisplayModes.
Check invalid parameter in SDL_SetTextInputRect() generic layer.
2023-02-07 13:51:45 -08:00
Ozkan Sezer
7f3036c353
make sure to not enable SDL_PASSED_BEGINTHREAD_ENDTHREAD for WinRT
2023-02-07 00:22:37 +03:00
Linus Probert
375bde8a4f
[SDL3] Cleanup void functions ( #7253 )
...
Some functions that do call SDL_SetError but return void changed to instead return non-zero in case of errors.
2023-02-06 08:53:52 -08:00
Ozkan Sezer
02fbf2cf99
replaced line comments in public header.
2023-02-04 10:02:10 +03:00
Anonymous Maarten
d6fdb842b0
include: add comment documenting the change(s) to SDL_opengl_glext.h
2023-02-04 02:44:10 +01:00
Sam Lantinga
a34a84ba98
Rename int versions of the SDL2 render functions ( #7235 )
...
This makes it clear what the new versions are, and in the case of SDL_RenderDrawPoint() and SDL_RenderDrawLine(), the coccinelle script actually does the (float) casts for you.
2023-02-03 14:55:32 -08:00
Sam Lantinga
14a4ce8b59
Fixed SDL_ScaleMode values for consistency
2023-02-03 14:20:51 -08:00
Sam Lantinga
dcd17f5473
Renderer logical size is now implemented as a render target
...
This fixes rounding errors with coordinate scaling and gives more flexibility in the presentation, as well as making it easy to maintain device independent resolution as windows move between different pixel density displays.
By default when a renderer is created, it will match the window size so window coordinates and render coordinates are 1-1.
Mouse and touch events are no longer filtered to change their coordinates, instead you can call SDL_ConvertEventToRenderCoordinates() to explicitly map event coordinates into the rendering viewport.
SDL_RenderWindowToLogical() and SDL_RenderLogicalToWindow() have been renamed SDL_RenderCoordinatesFromWindow() and SDL_RenderCoordinatesToWindow() and take floating point coordinates in both directions.
The viewport, clipping state, and scale for render targets are now persistent and will remain set whenever they are active.
2023-02-03 12:57:37 -08:00
Anonymous Maarten
93fc72a405
opengl: make SDL_opengl_glext.h's include compatible with macos
...
- Mesa defines __gl_glext_h_
- Apple defines __glext_h_
2023-02-03 20:58:05 +01:00
Ozkan Sezer
e7ea47a1b4
add version check to SDL_MALLOC macro (for correctness)
2023-02-03 17:40:40 +03:00
Anonymous Maarten
69aede6c9e
Add missing _ in SDL_EVENT_LOCALECHANGED and SSDL_EVENT_TEXTEDITING_EXT
2023-02-02 00:49:09 +01:00
Sam Lantinga
ac75fe9324
Folded SDL_WINDOW_FULLSCREEN_EXCLUSIVE and SDL_WINDOW_FULLSCREEN_DESKTOP into a single SDL_WINDOW_FULLSCREEN flag
...
The fullscreen video mode used by the window can be used to determine whether it's in exclusive fullscreen or fullscreen desktop mode.
2023-02-01 12:05:25 -08:00
Sam Lantinga
14338ab459
Removed display mode flags
...
They weren't really adding any value and added complexity to the API
2023-02-01 12:05:25 -08:00
Sam Lantinga
6b137579ea
Windows default to fullscreen desktop mode if they don't pick an explicit video mode
...
Rather than iterating over display modes using an index, there is a new function SDL_GetFullscreenDisplayModes() to get the list of available fullscreen modes on a display.
{
SDL_DisplayID display = SDL_GetPrimaryDisplay();
int num_modes = 0;
SDL_DisplayMode **modes = SDL_GetFullscreenDisplayModes(display, &num_modes);
if (modes) {
for (i = 0; i < num_modes; ++i) {
SDL_DisplayMode *mode = modes[i];
SDL_Log("Display %" SDL_PRIu32 " mode %d: %dx%d@%gHz, %d%% scale\n",
display, i, mode->pixel_w, mode->pixel_h, mode->refresh_rate, (int)(mode->display_scale * 100.0f));
}
SDL_free(modes);
}
}
SDL_GetDesktopDisplayMode() and SDL_GetCurrentDisplayMode() return pointers to display modes rather than filling in application memory.
Windows now have an explicit fullscreen mode that is set, using SDL_SetWindowFullscreenMode(). The fullscreen mode for a window can be queried with SDL_GetWindowFullscreenMode(), which returns a pointer to the mode, or NULL if the window will be fullscreen desktop. SDL_SetWindowFullscreen() just takes a boolean value, setting the correct fullscreen state based on the selected mode.
2023-02-01 12:05:25 -08:00
Vladyslav Serhiienko
47deebe23f
Fixes for Android builds
2023-01-31 08:39:51 -08:00
Sam Lantinga
1ffc09c6e6
Changed SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED to be the same value as SDL_EVENT_WINDOW_SIZE_CHANGED so SDL2 applications continue to work as expected.
2023-01-29 21:37:51 -08:00
SDL Wiki Bot
87af6c0019
Sync SDL3 wiki -> header
2023-01-30 03:26:14 +00:00
Sam Lantinga
22c69bccdf
Displays are now referenced by instance ID instead of index
2023-01-29 19:25:15 -08:00
Anonymous Maarten
758c0dd6d8
Rename mouse BUTTON(DOWN|UP) event to BUTTON_(DOWN|UP)
2023-01-29 19:24:48 -08:00
Sasha Szpakowski
90795291e4
Remove SDL_GL/Metal/Vulkan_GetDrawableSize().
...
SDL_GetWindowSizeInPixels supersedes those functions.
2023-01-29 11:20:33 -08:00
Sam Lantinga
bf4095359c
Removed duplicated window size events, and added SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED
2023-01-28 15:56:02 -08:00
SDL Wiki Bot
8814bedc3b
Sync SDL3 wiki -> header
2023-01-28 18:57:14 +00:00
Sam Lantinga
31f464153d
SDL_WINDOW_INPUT_GRABBED has been renamed SDL_WINDOW_MOUSE_GRABBED
2023-01-28 10:56:38 -08:00
Sam Lantinga
e83c54f271
SDL_WINDOW_FULLSCREEN and SDL_WINDOW_FULLSCREEN_DESKTOP are now distinct flags
2023-01-28 10:56:38 -08:00
Sam Lantinga
24fec13ac1
Add full high DPI information to SDL_DisplayMode
...
SDL_DisplayMode now includes the pixel size, the screen size and the relationship between the two. For example, a 4K display at 200% scale could have a pixel size of 3840x2160, a screen size of 1920x1080, and a display scale of 2.0.
2023-01-27 12:38:46 -08:00
Sam Lantinga
364db52ca3
Moved testautomation data out of SDL_test library
2023-01-26 10:25:44 -08:00
Ozkan Sezer
be2afeec84
SDL_loadso.h: add missing SDLCALL to SDL_LoadFunction()
2023-01-26 18:01:10 +03:00
Jiří Malák
54540a82a0
SDL_atomic.h: Update SDL_CPUPauseInstruction for Watcom. ( #7157 )
...
Appropriate CPU directive can be used in #pragma aux so that it is not
necessary to hardcode instruction bytes.
(cherry picked from commit 507fc462db1ede9f3ca2c581809a7f1492ac1ff5)
2023-01-26 17:01:56 +03:00
Ryan C. Gordon
79cca812cb
include: make SDL_RenderPresent thread safety notes less verbose.
...
Reference Issue #7140 .
2023-01-25 13:15:34 -05:00
SDL Wiki Bot
43e3daace3
Sync SDL3 wiki -> header
2023-01-25 18:02:19 +00:00
Ryan C. Gordon
197340ea1c
Sync wiki -> headers.
2023-01-25 13:01:40 -05:00
Ryan C. Gordon
01cba48d18
wikiheaders: Add a `\threadsafety` tag to document threading details.
...
Reference Issue #7140 .
2023-01-25 12:59:25 -05:00
Sam Lantinga
6a27188023
SDL_DisplayMode now represents physical pixels and has added a display scaling factor
...
Work in progress on https://github.com/libsdl-org/SDL/issues/7134
2023-01-25 09:26:59 -08:00
Sam Lantinga
4696c9556b
SDL 3.0 is going to be high DPI aware and officially separates screen… ( #7145 )
...
* SDL 3.0 is going to be high DPI aware and officially separates screen coordinates from client pixel area
The public APIs to disable high DPI support have been removed
Work in progress on https://github.com/libsdl-org/SDL/issues/7134
2023-01-25 01:23:17 -08:00
Sylvain
724d92fd65
Rename SDL_GetDisplayDPI to SDL_GetDisplayPhysicalDPI
...
to avoid confusion with logical DPI
2023-01-25 00:04:00 -08:00
Sam Lantinga
d496d187c5
Document that the pitch value may be zero for surfaces that will be filled in by the application later.
...
Also verify that the pitch isn't zero for surfaces with valid pixels
Fixes https://github.com/libsdl-org/SDL/issues/7143
2023-01-24 22:51:16 -08:00
Anonymous Maarten
3cb819ac48
vita: fix PVR_PSP2 (GLES) + gl4es4fita (GL)
2023-01-25 00:23:05 +01:00
Sam Lantinga
a06a593aa6
Renamed SDL_GetGamepadNumTouchpads and SDL_GetGamepadNumTouchpadFingers to match the new convention
2023-01-24 13:47:30 -08:00
Sylvain
052b14eb65
Add SDL_ConvertAudioSamples() helper function
2023-01-24 08:26:09 -08:00
Sam Lantinga
7b50bae524
Renamed SDL events for clarity
...
Fixes https://github.com/libsdl-org/SDL/issues/6877
2023-01-24 07:26:48 -08:00
Lokathor
74697bc351
group init flag defines into an enum ( #7137 )
2023-01-24 06:04:43 +00:00
David Carlier
b379c910d4
SDL_CPUPauseInstruction RISCV-64 version proposal.
2023-01-22 13:58:59 -08:00
Sam Lantinga
9c8642ded9
Removed SDL_INIT_NOPARACHUTE
...
Fixes https://github.com/libsdl-org/SDL/issues/7121
2023-01-22 09:14:12 -08:00
Sylvain
64bc0a1612
Remove AudioCVT interface in favor of SDL_AudioStream
2023-01-22 11:31:30 -05:00
Sam Lantinga
4becca4fc9
Clarify that SDL_GetJoystickFromInstanceID() and SDL_GetGamepadFromInstanceID() return NULL if the associated device hasn't been opened yet.
...
Fixes https://github.com/libsdl-org/SDL/issues/7100
2023-01-19 07:42:04 -08:00
Eric Wasylishen
67c91353e0
Handle DPI scaling in SDL_GetWindowSurface
...
Fixes DPI awareness of testdrawchessboard (previously, the surface was
being created in points instead of pixels, resulting in the demo app
only drawing in a corner of the screen on High-DPI displays)
*_CreateWindowFramebuffer()/*_UpdateWindowFramebuffer(): are updated
to use SDL_GetWindowSizeInPixels instead of SDL_GetWindowSize() or
window->w/window->h.
Most of the _CreateWindowFramebuffer backends are untested except
for Windows.
Fixes #7047
2023-01-15 12:57:42 -08:00
Sam Lantinga
bf53183c8b
Fixed building on Raspberry Pi
2023-01-13 14:20:57 -08:00
Sam Lantinga
7c16fe6d69
Default to use the built-in EGL definitions
2023-01-12 16:17:00 -08:00
Ozkan Sezer
85924687fd
fix SDL_GetSensorInstanceID() return code upon failure.
...
Reference issue: https://github.com/libsdl-org/SDL/issues/7051
2023-01-11 21:56:50 +03:00
Ozkan Sezer
0621a67350
fix SDL_GetJoystickInstanceID() return code upon failure
...
Reference issue: https://github.com/libsdl-org/SDL/issues/7051
2023-01-11 21:56:50 +03:00
Sam Lantinga
0ead89747a
Fixed filename comment in SDL_intrin.h
2023-01-10 21:05:38 -08:00
Sam Lantinga
95faeab96c
SDL_GetNumJoysticks() and SDL_GetNumSensors() are no longer in the API
2023-01-10 18:07:40 -08:00
Sam Lantinga
dc280c17a0
Moved SDL_intrin.h back into the public headers for application use
2023-01-10 15:50:35 -08:00
Sam Lantinga
56522034db
Fixed building with Visual Studio 2010
2023-01-09 18:30:23 -08:00
Sam Lantinga
2aa9569b3e
Replaced SDL_SIMDAlloc(), SDL_SIMDRealloc(), and SDL_SIMDFree() with SDL_aligned_alloc() and SDL_aligned_free()
...
Fixes https://github.com/libsdl-org/SDL/issues/5641
2023-01-09 18:01:59 -08:00
Sam Lantinga
5ed00d34aa
Document that condition variable mutexes can't be locked recursively.
...
Fixes https://github.com/libsdl-org/SDL/issues/5497
2023-01-09 15:59:39 -08:00
Sam Lantinga
e9b86eebf3
Functions which return function pointers now return SDL_FunctionPointer instead of void*
...
This fixes the clang warning "Cast between pointer-to-function and pointer-to-object is an extension"
You can define SDL_FUNCTION_POINTER_IS_VOID_POINTER in your project to restore the previous behavior.
Fixes https://github.com/libsdl-org/SDL/issues/2866
2023-01-09 15:46:21 -08:00
Sylvain
7275b2b352
SDL_GetTicks64: entry added in SDL_ENABLE_OLD_NAMES
2023-01-09 21:59:50 +01:00
Sam Lantinga
5feebcdce0
SDL_AddHintCallback() now returns a standard int result instead of void
...
Fixes https://github.com/libsdl-org/SDL/issues/7035
2023-01-09 12:09:30 -08:00
Sam Lantinga
fde78d12f2
Updated copyright for 2023
2023-01-09 09:41:41 -08:00
Sam Lantinga
dbd4b88abc
Generally removed generally
2023-01-09 09:04:05 -08:00
Sam Lantinga
40833d2526
Documented thread starvation issue raised in https://github.com/libsdl-org/SDL/pull/7023
2023-01-09 09:01:41 -08:00
Sam Lantinga
59308cb3e9
SDL_platform_defines.h is already included in SDL_platform.h
2023-01-09 08:40:11 -08:00
Sylvain
4798c36197
Add oldname entry: GetTicks64() is renamed GetTicks()
2023-01-09 13:43:39 +01:00
Anonymous Maarten
f91a747549
include: SDL_dynapi.h depends on platform defines
2023-01-08 21:37:54 +01:00
Anonymous Maarten
f53d797cca
cmake: generate git hash using GetRevisionDescription CMake module
...
This allows the build system (ninja/make/VS) to detect whether the current
checkout git commit has changed. If so, SDL_revision.h will be updated.
2023-01-08 18:20:56 +01:00
Hunter Kvalevog
a2b2464b46
SDL_Vulkan_GetInstanceExtensions: Require Vulkan
...
Document that this function will fail if the user doesn't call
SDL_Vulkan_LoadLibrary (either explicitly or via SDL_CreateWindow)
beforehand.
2023-01-08 07:55:34 -08:00
Hunter Kvalevog
0953367967
SDL_Vulkan_GetInstanceExtensions: Remove window
...
Remove the unused `window` parameter from
SDL_Vulkan_GetInstanceExtensions, which is never used by any of the
backends.
2023-01-08 07:55:34 -08:00
Sam Lantinga
7f0801377b
Separate wmain() and main() implementations
...
Fixes https://github.com/libsdl-org/SDL/issues/7010
2023-01-07 08:28:07 -08:00
Sam Lantinga
5a2a91cb05
Fixed compile warnings with unused parameters
2023-01-06 16:24:20 -08:00
Sam Lantinga
5dd07a5773
The alloc_size attribute isn't supported in clang 3.x
2023-01-06 12:10:21 -08:00
Sam Lantinga
6b5855e990
Removed SDL_REVISION_NUMBER
2023-01-06 09:53:18 -08:00