iris/kaizen
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Squashed 'external/SDL/' changes from f317581c919..95c3ee77c10

Browse Source 
95c3ee77c10 Removed testing code
ea640894d32 Fixed SDL_DEFINE_STDBOOL logic if __bool_true_false_are_defined is defined
46fb2c6f1bf Added a script to help with the bool rename
23f855a9703 render: Integrate fix-shaders.sh into build-shaders.sh
d658ef66279 Don't guess about the size of an int, assert it!
32fd1878a09 Provide a definition of bool if needed for your environment
1834c83d5a2 testplatform: make sure bool is 1 byte
026d3c2306f Sync SDL3 wiki -> header
95f7e532331 Added the examples directory to the API renaming tool
a90ad3b0e28 Removed SDL_bool in favor of plain bool
9dd88592407 Sync SDL3 wiki -> header
32cf23d392f Added video/x11/edid.h to third party code list
407ccadfd72 Added copyright header to edid.h
bd04459cde1 Fix typos (thanks @qndel!)
e4f987f2996 tests: Fix testdropfile on high-DPI displays
8caf25f7b30 testautomation_stdlib.c (stdlib_strtox): fix warning from gcc-4.9:
03ae792df35 Fixed the recording field in audio device events
c68e9e157cd Fixed typo
bc9780299c0 Don't define backends if SDL_GPU_DISABLED is set
8481d1a12b0 Sync SDL3 wiki -> header
807b8a9d4de Allow initializing hints and properties from any thread
d0edf687741 Added Uint32 versions of the atomic functions
8d223b3037e Renamed atomic functions to match SDL 3.0 naming convention
f3e419596b1 Removed SDL_INIT_TIMER
9275c533ca2 Added thread-safe initialization/cleanup support
7edd43c276e Don't define render_drivers if SDL_RENDER_DISABLED is set
98cd8b34a76 Close the other file descriptors after redirection has taken place
4b3058d58db render: Don't try to rebuild D3D11, D3D12, Metal shaders without spirv-cross
13500bbf508 render: Fix detection of fxc, dxc in build-shaders.sh
11129761e7e v4l2: return success if the device is ready
ab9c68d9ffc pipewire: Always destroy hotplug loop during deinitialization
1ffb9f22aa5 build-release.py fixes from SDL2 port
231ea07617d Added SDL_LogTrace()
6180da00e1d Skip a lock/unlock when logging known categories
c499f79fe93 GPU: Fix multisample texture usage validation
926d1439660 Sync SDL3 wiki -> header
1bbc897e48e Updated documentation for bool return type
4a2683e2c10 Sync SDL3 wiki -> header
dc639956baa Improve logging performance and make log priorities thread-safe
f006d61bd12 Sync SDL3 wiki -> header
fd1fcfc951b Sync SDL3 wiki -> header
9416917353c GPU: Rework MSAA (#10859)
e59344ad469 Update proguard-rules.pro in-line with commit 9ff3446
0f85fdefc84 Fixed warning: "SDL_VIDEO_RENDER_D3D12" is not defined, evaluates to 0
4f722d372ae GPU: Metal vertex buffer indices should grow upward (#10837)
0548050fc5a Verify that the subsystems were successfully initialized
5b5b1a89267 Fixed cleaning up dependent subsystems if initialization fails
97d40b92180 Removed SDL_CleanupEnvironment()
a7f1deae8d1 Sync SDL3 wiki -> header
28b94c47585 Re-added SDL_getenv() as a thread-safe getenv() implementation
718845a33d0 Fixed warning C4701: potentially uninitialized local variable 'startup_info' used
19243092c67 Renamed SDL_GpuGraphicsPipelineTargetInfo to SDL_GPUGraphicsPipelineTargetInfo
604d0c519ec If posix_spawn() is available, so is sigaction
ec5d280c900 Make sure we ignore SIGPIPE so we don't crash if we write when the pipe is closed
34b2f4ffcab Use non-blocking pipes for process I/O on Windows
dd07cc89910 SDL_Process: WAIT_TIMEOUT means the process has not exited yet
1f3fd65c4c7 cpuinfo: Rename SDL_GetCPUCount to SDL_GetNumLogicalCPUCores
93bf5342684 testgpu_simple_clear: Fixed AppInit return values.
e5bd3bbcd6e add missing includes
8569bde053f Fixed typo
706aaaf2802 Sync SDL3 wiki -> header
3bc03477618 Revert "Sync SDL3 wiki -> header"
c2e4b14a828 Revert "stdinc: Added missing `\param` to SDL_CreateEnvironment."
11c9975caa9 Revert "Sync SDL3 wiki -> header"
ba65767afa2 Sync SDL3 wiki -> header
919f8d3e2b9 stdinc: Added missing `\param` to SDL_CreateEnvironment.
35427ff9ec7 Sync SDL3 wiki -> header
dcb2a8c2fe2 Use CreateProcessW() to handle non-ASCII file paths and arguments
e97f6365906 SDL_PROP_PROCESS_CREATE_ENVIRONMENT_POINTER is an SDL_Environment pointer
56fc4b790c4 Reduce strcmp() calls in hashtable lookup
e6734794491 Removed SDL_WriteProcess()
a833ee2e63e SDL_gpu.c: fixed build when SDL_GPU_DISABLED is defined.
f6f49de1342 Add convenience functions to get process IOStreams
7ff015ceaee Close file descriptors not used by the child process
fed0149172e Switched wayland messageboxes to use the new process API
aa7357a14d7 SDL_CreateEnvironment() fills the environment with a non-zero parameter
76c469910ee Added SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN
44c6cfda053 Switched zenity dialogs to use the new process API
3166a05c18b cmake: don't prepend absolute CMAKE_INSTALL_{INCLUDE,LIB}DIR with ${prefix}
27862907c65 Update src/process/windows/SDL_windowsprocess.c
82b33a7d3f6 Update src/process/windows/SDL_windowsprocess.c
3cf54675bb0 Windows process: escape backslashes before quotes
90e01040c52 Added thread-safe environment functions
16ff7503b7b gpu: Update GPU support queries to better match naming conventions
d21c1de6518 Sync SDL3 wiki -> header
9eea8234e67 Add SDL_Process subsystem
6c83491116e Added SDL_FlushIO()
93caf1cd21a Fixed typo
1c5b063ade7 Sync SDL3 wiki -> header
f1d0a716292 Fixed the documentation for SDL_SetError()
d483886ec57 Sync SDL3 wiki -> header
84361bcf0ab stdlib: Remove test cases with impl-defined results
eb199176e68 stdlib: Conditionally undef some SDL_strtox tests
59ec0344128 stdlib: Use macros to define SDL_strtox tests
7d94bf528db stdlib: Document SDL_strtox functions
8092e35287e stdlib: Improve SDL_strtod
a78f612d4b2 stdlib: Add some tests for SDL_strtod
56a48763cd7 stdlib: Bring SDL_wcstol in line with SDL_strtol
61bc856b043 stdlib: Use new parser for scanf %p specifier
e109aa09aa3 stdlib: Rewrite SDL_strto(ll?|ul) impl
e326540a45d stdlib: Add failing tests for SDL_strto(ll?|ul)
fb82772fb31 stdlib: Rewrite SDL_strtoull impl
5331f36789d stdlib: Add failing tests for SDL_strtoull
88d3cb4f900 Remove unnecessary include from SDL_pen_c.h
4efbe1ca285 stdlib: Assert that signed integers use two's complement arithmetic
fd53b3e112b stdlib: Rewrite SDL_wcstol impl
5d30980df46 stdlib: Add failing tests for SDL_wcstol
ee377793fe0 Spell "unknown" correctly
ee65176eec3 SDL_test: add SDLTest_LogEscapedString
6a305e1532e SDL_test: fix SDLTest_CommonQuit with NULL state
0160e9eac64 gpu: Add SDL_QueryGPUSupport
262ffa27e7f Sync SDL3 wiki -> header
96e147b2b95 gpu: Rework driver name queries, add GetGPUShaderFormats
6d92de5d3a6 wayland: Ensure that a NULL internal structure isn't dereferenced when destroying a window
9d9721cd4c8 wayland: Fix some incorrect buffer scale calculations
94436a938d0 GPU: Remove unused and incorrect D16 format checks from Vulkan driver
5771b502f84 GPU: Fix D3D11/D3D12 vertex strides for multiple vertex buffers (#10818)
371cfaf8fe4 gpu: Implement support for SDL_GPU_DISABLED
d3932b1ba2e Sync SDL3 wiki -> header
a45a2caf493 GPU: Rename VertexBinding to VertexBufferDescription (#10811)
446ee3e7c54 Fix bug with SDL_ShowMessageBox not working with wayland (#10810)
b7dc30ca246 pulseaudio: Hotplug thread fixes.
c36982d45c2 vulkan: Avoid redundant commands for dynamic states
66489f91bb4 GPU: Cube Arrays (#10800)
9ea0a837aeb vulkan: Use a spinlock instead of a mutex for descriptor pools
f8d4c492641 Sync SDL3 wiki -> header
d5e1385c91d Fixed typos in SDL_gpu.h
6e2f2428bac Sync SDL3 wiki -> header
ddd5723e2ee GPU: Remove pitch parameters from indirect draw calls (#10803)
3d7e8c9bb7b Add missing SDL_WPRINTF_VARARG_FUNCV in gendynapi.py
d03c7cdf17b Removing extra semicolons
fd2a266549f Adding void to empty function prototype parenthesis
b15fab02070 Fixed typo in SDL_dialog.h
d62e3c3791e Fix SDL_GPUShaderFormat flag values
4d135fb696d Fixed color scale when rendering to an sRGB render target
3f7f6f624b0 testcolorspace: don't tonemap from HDR to SDR when reading pixels
4e43da684c7 Added texture colorspace testing
86e393b5235 Clarify that INPUTTYPE_UNSPECIFIED is correct for RGB textures
92255d36d4b We already have functions for converting between sRGB and linear space
667a3e40e9a Use the correct namespace for structures
77c569496df SDL_GPUShaderFormat isn't an enum anymore
37c9fb490ef Changed enums to use XXX_COUNT for the count or number of values
64f12bea4a9 GPU: Remove unnecessary texture format swizzles in Vulkan (#10693)
4123023d3ed Renamed sdlgpu to gpu
c77e51c0844 Use SDL_unsetenv()
3166f912826 GPU: Defer setting blend state on D3D11
6fca867ffe3 Fix testoffscreen.c: bool literal returned from 'main'
eeb465e2fcb Sync SDL3 wiki -> header
2b8a349b262 Add SDL_BindGPUComputeSamplers (#10778)
323b60abf1a SDL_test_harness.c: Fix warning -Wcast-function-type-strict
0b6f993deac GPU: Zero-init handling (#10786)
b8dbc7086d4 Disable GameInput mouse and keyboard support
76ce83801ad Removed pipewire client version check
9c8c6da4760 pipewire: If hotplug initialization fails, clean up any partial success
817f1b3da81 Revert "Changed SDL_GPU_TEXTUREFORMAT_INVALID to 0"
b51c6551d6e Changed SDL_GPU_TEXTUREFORMAT_INVALID to 0
1e9ff723adb GPU: fix SDL_GetGPUSwapchainTextureFormat error return value
640559eba68 Added migration documentation for SDL_strtoll(), SDL_strtoull(), SDL_lltoa(), and SDL_ulltoa().
4eb43705000 SDL_strtoll(), SDL_strtoull(), SDL_lltoa(), and SDL_ulltoa() use long long values
68c61ff3a8f Sync SDL3 wiki -> header
6fc6e3dc7eb Use SDL_bool where appropriate in SDL events
7d1bbae6b25 Sync SDL3 wiki -> header
af37056c0d0 stdinc: Fix typos and reword comments about aliasing
8eb194b6f86 stdinc: Document number parsing APIs
eda459ac49e stdinc: Fix up some printf definitions
d6caf2abe78 Remove SDL_RESTRICT in favor of doc comments
731939fca16 stdinc: Document memcpy APIs
8cea4bd3c94 stdinc: Document memory allocation APIs
f4c2c09f782 examples: Link to SDL integer types in code examples, too.
7713a7eec7d x11vulkan: Use the correct SONAME of libX11-xcb.so.1 on Linux, etc.
412a8244b66 audio: Make system-specific audio format types part of SDL_AudioFormat.
d3091b95389 Remove SDL_GPUDepthStencilValue struct
80e541d1fcb Fixed calling SDL_utf8strlcpy() with dst_bytes of 0
668e2f82d21 Add load op and clear color to SDL_BlitGPUTexture (#10767)
47283250442 pipewire: Give hotplug threads a more indicative name
c797ae16192 Fix -Wtype-limits warning
6e885d96193 Sync SDL3 wiki -> header
301f3ffa9dd Sync SDL3 wiki -> header
050aa4d084a include: Filling in more documentation gaps.
a57f6c4af30 Fix additional calloc-transposed-args warnings
d2ef15d8e6a Fix warnings: calloc-transposed-args
0da2bd49c8c Remove unused includes. This only removes includes that aren't used at all, not even in comments.
aa6a0be7a87 Fix warning: redefinition of typedef 'SDLTest_TestSuiteRunner'
7df1caba7cf Clarified that the contents of new textures aren't defined.
ac0b1b207f6 SDL_hints: fix gpu direct3d11 driver name in documentation
257385277d3 SDL_realloc() with size 0 now always defaults to size 1
4c0cb94b961 vulkan: VULKAN_CreateTexture returns a boolean
3eb49ac8627 vulken: VULKAN_CreateTexture returns a boolean
1ba99c53d48 Sync SDL3 wiki -> header
2b77b2e4ef0 Sync SDL3 wiki -> header
4f6e81cf622 include: Fixed up some minor documentation gaps.
7ec998819d1 Sync SDL3 wiki -> header
090e30dbca3 docs: Remove README-winrt.md, again.
fd6056307f0 fix trailing doc comments
1a13acac092 Always blit to the swapchain in GPU_RenderPresent
fa892d15b7d include files with required types directly
e9c7b36fbd7 Sync SDL3 wiki -> header
68a9991ec99 GPU: Document structs (#10742)
cf9613fe632 The GPU log category ate one of the SDL reserved categories
a01e8a5e105 The GPU log category ate one of the SDL reserved categories
18492057331 Fix GDK builds after renames done in #10730
0a44ea1b0b3 Amend use of non-standard compiler syntax
0a8bf663b7d Fix VisualC project filter
1d59be67fc7 Fixed crash if PIPEWIRE_PREFERRED_Init() fails and then pipewire is used anyway
f42da35ef96 Sync SDL3 wiki -> header
9730f62e8cb GPU: Rename struct members and parameters for SDL3 naming conventions (#10730)
e21f70c5936 pipewire : check minimum client library version early
845855d6573 Revert "stdinc: Document more symbols."
c93f76436fc stdinc: Document more symbols.
73b294cb1cd SDL_platform_defines.h: Added documentation, and a little whitespace.
4c8357a37da Clarified why the WINDOWS driver is lower than the RAWINPUT driver
66b4c080c06 Clarified why the WGI driver is lower than the WINDOWS driver
8f46cb771c7 SDL_XINPUT_Enabled() returns false until XInput DLL is successfully loaded
6da97c63da9 Sync SDL3 wiki -> header
ac08dde1b22 windows: Clean out things that should be using `defined(SDL_PLATFORM_WINDOWS)`.
154452a7263 winrt: Removed WinRT/Windows Phone/UWP support.
6d7c211fafd Fixed race condition at startup that could cause a crash in the XInput driver
6e5bd58c4cc Include the Steam controller driver on Android
1381cc85543 Add a step to fix generated shader code
104642ffe79 Sorted API symbols
4c382aafcdc Fixed building on Raspberry Pi
360bc667a82 SDL_Log: restore SDL2's SDL_LogCategory order
26728c321fa SDL_test: add include for SDLTest_CommonState
b4c3df1189c SDL_test: whitespace header fixes
db96ddca344 SDL_test: use SDLCALL calling convention
379aea5c2df Fixed warnings building with Visual Studio
8edb901724a Fixed crashes in Metal renderer due to ARC releasing references on random memory in newly allocated structs
e7969553f88 Sync SDL3 wiki -> header
702ed83f72a Initialize interface structures so they can be extended in the future
434193d1534 testmultiaudio: initialize audio through SDL_test framework
102b3b480bb SDL_test: move argument parsing into SDL_test
09af4a80866 SDL_test: make argument parsing extendable
396dd16471d SDL_test: Remove unused common_usage_* static char pointers
872608b8af2 Don't allocate in SDLTest_GenerateRunSeed
2f4b2df5959 SDL_test: pass data pointer to unit tests
741c04b339f Sync SDL3 wiki -> header
baa1a5e2f47 Add SDL_strpbrk
55934bc85e4 include: add SDL_RESTRICT for restricted pointer aliasing
2d4eb29c379 Add SDL_SetGPUBlendConstants, SDL_SetGPUStencilReference (#10704)
04a732881a3 Add a test to verify structure alignment
9e850bdcfaa docs: Update the migration doc with SDL_SetWindowModalFor() changes
c0b15e57f46 cmake: disable GPU backends for winrt
f494658f9c4 SDL_gpu.c: remove BOM.
cb2919ac55f [GPU] MinGW build fixes:
22aeb1bbba2 Sync SDL3 wiki -> header
a46e7027ce7 video: Allow setting the parents of toplevel windows
af4c6682ce6 Sync SDL3 wiki -> header
cba5ccb9cf3 GPU: Fix documentation formatting
42a0df91bfe Add padding for non-32-bit-aligned types in structs (#10701)
387774ab8a3 Build config flags are either defined or undefined, never 0
e3fd581acac GPU: vulkan: Respect swapchain minImageCount
b00bb215074 Added -Wl,--no-undefined-version to Android.mk
5db00cef96c Android.mk: allow to compile with storage functions
a0f36fb85b4 Use atomic variables for thread communication
41810c823d6 Compilation without vulkan: SDL_GPU_VULKAN is always defined for some plateform (at android, macos), test against 0 or 1
defbf673069 SDL_migration.cocci: add SDL_TTF/mixer/image function names to be upgraded from int returned type to bool.
f61d4db39af GPU: `colorAttachmentDescriptions` should be `const`
249a74e4363 Sync SDL3 wiki -> header
1c8c0144811 GPU: Document opaque handles and enums (#10700)
20d0a1a3d1a Added a defensive check against XINPUTGETCAPABILITIES being NULL
ff1e2524134 testautomation: remove SDLTest_TestCaseFp casts
abd2ac5992c Set the desired channel count when opening audio on Android
e2c9a0a4273 Updated Android audio log messages
1788be85477 GPU: Add const to some function parameters (#10694)

git-subtree-dir: external/SDL
git-subtree-split: 95c3ee77c101c60aab69663be2bc4eee3d4302b2
This commit is contained in:
SimoneN64
2024-09-18 20:42:08 +02:00
parent 8821e99ab5
commit 3a7f96fd99
641 changed files with 31269 additions and 30646 deletions
Download Patch File Download Diff File Expand all files Collapse all files

159
include/SDL3/SDL_hints.h
View File

@@ -1011,8 +1011,8 @@ extern "C" {
*
* By default, SDL will try all available GPU backends in a reasonable order
* until it finds one that can work, but this hint allows the app or user to
* force a specific target, such as "d3d11" if, say, your hardware supports
* D3D12 but want to try using D3D11 instead.
* force a specific target, such as "direct3d11" if, say, your hardware
* supports D3D12 but want to try using D3D11 instead.
*
* This hint should be set before SDL_GPUSelectBackend() is called.
*
@@ -1730,8 +1730,8 @@ extern "C" {
* - "0": HIDAPI driver is not used.
* - "1": HIDAPI driver is used.
*
* This driver doesn't work with the dolphinbar, so the default is SDL_FALSE
* for now.
* This driver doesn't work with the dolphinbar, so the default is false for
* now.
*
* This hint should be set before enumerating controllers.
*
@@ -2497,11 +2497,11 @@ extern "C" {
* system while relative mode is active, in case the desired confinement state
* became out-of-sync due to interference from other running programs.
*
* The variable can be integers representing miliseconds between each refresh.
* A value of zero means SDL will not automatically refresh the confinement.
* The default value varies depending on the operating system, this variable
* might not have any effects on inapplicable platforms such as those without
* a cursor.
* The variable can be integers representing milliseconds between each
* refresh. A value of zero means SDL will not automatically refresh the
* confinement. The default value varies depending on the operating system,
* this variable might not have any effects on inapplicable platforms such as
* those without a cursor.
*
* This hint can be set anytime.
*
@@ -3938,119 +3938,6 @@ extern "C" {
*/
#define SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE "SDL_WINDOWS_ERASE_BACKGROUND_MODE"
/**
* A variable controlling whether back-button-press events on Windows Phone to
* be marked as handled.
*
* Windows Phone devices typically feature a Back button. When pressed, the OS
* will emit back-button-press events, which apps are expected to handle in an
* appropriate manner. If apps do not explicitly mark these events as
* 'Handled', then the OS will invoke its default behavior for unhandled
* back-button-press events, which on Windows Phone 8 and 8.1 is to terminate
* the app (and attempt to switch to the previous app, or to the device's home
* screen).
*
* Setting the SDL_HINT_WINRT_HANDLE_BACK_BUTTON hint to "1" will cause SDL to
* mark back-button-press events as Handled, if and when one is sent to the
* app.
*
* Internally, Windows Phone sends back button events as parameters to special
* back-button-press callback functions. Apps that need to respond to
* back-button-press events are expected to register one or more callback
* functions for such, shortly after being launched (during the app's
* initialization phase). After the back button is pressed, the OS will invoke
* these callbacks. If the app's callback(s) do not explicitly mark the event
* as handled by the time they return, or if the app never registers one of
* these callback, the OS will consider the event un-handled, and it will
* apply its default back button behavior (terminate the app).
*
* SDL registers its own back-button-press callback with the Windows Phone OS.
* This callback will emit a pair of SDL key-press events (SDL_EVENT_KEY_DOWN
* and SDL_EVENT_KEY_UP), each with a scancode of SDL_SCANCODE_AC_BACK, after
* which it will check the contents of the hint,
* SDL_HINT_WINRT_HANDLE_BACK_BUTTON. If the hint's value is set to "1", the
* back button event's Handled property will get set to 'true'. If the hint's
* value is set to something else, or if it is unset, SDL will leave the
* event's Handled property alone. (By default, the OS sets this property to
* 'false', to note.)
*
* SDL apps can either set SDL_HINT_WINRT_HANDLE_BACK_BUTTON well before a
* back button is pressed, or can set it in direct-response to a back button
* being pressed.
*
* In order to get notified when a back button is pressed, SDL apps should
* register a callback function with SDL_AddEventWatch(), and have it listen
* for SDL_EVENT_KEY_DOWN events that have a scancode of SDL_SCANCODE_AC_BACK.
* (Alternatively, SDL_EVENT_KEY_UP events can be listened-for. Listening for
* either event type is suitable.) Any value of
* SDL_HINT_WINRT_HANDLE_BACK_BUTTON set by such a callback, will be applied
* to the OS' current back-button-press event.
*
* More details on back button behavior in Windows Phone apps can be found at
* the following page, on Microsoft's developer site:
* http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj247550(v=vs.105).aspx
*
* \since This hint is available since SDL 3.0.0.
*/
#define SDL_HINT_WINRT_HANDLE_BACK_BUTTON "SDL_WINRT_HANDLE_BACK_BUTTON"
/**
* A variable specifying the label text for a WinRT app's privacy policy link.
*
* Network-enabled WinRT apps must include a privacy policy. On Windows 8,
* 8.1, and RT, Microsoft mandates that this policy be available via the
* Windows Settings charm. SDL provides code to add a link there, with its
* label text being set via the optional hint,
* SDL_HINT_WINRT_PRIVACY_POLICY_LABEL.
*
* Please note that a privacy policy's contents are not set via this hint. A
* separate hint, SDL_HINT_WINRT_PRIVACY_POLICY_URL, is used to link to the
* actual text of the policy.
*
* The contents of this hint should be encoded as a UTF8 string.
*
* The default value is "Privacy Policy".
*
* For additional information on linking to a privacy policy, see the
* documentation for SDL_HINT_WINRT_PRIVACY_POLICY_URL.
*
* This hint should be set before SDL is initialized.
*
* \since This hint is available since SDL 3.0.0.
*/
#define SDL_HINT_WINRT_PRIVACY_POLICY_LABEL "SDL_WINRT_PRIVACY_POLICY_LABEL"
/**
* A variable specifying the URL to a WinRT app's privacy policy.
*
* All network-enabled WinRT apps must make a privacy policy available to its
* users. On Windows 8, 8.1, and RT, Microsoft mandates that this policy be
* available in the Windows Settings charm, as accessed from within the app.
* SDL provides code to add a URL-based link there, which can point to the
* app's privacy policy.
*
* To setup a URL to an app's privacy policy, set
* SDL_HINT_WINRT_PRIVACY_POLICY_URL before calling any SDL_Init() functions.
* The contents of the hint should be a valid URL. For example,
* "http://www.example.com".
*
* The default value is "", which will prevent SDL from adding a privacy
* policy link to the Settings charm. This hint should only be set during app
* init.
*
* The label text of an app's "Privacy Policy" link may be customized via
* another hint, SDL_HINT_WINRT_PRIVACY_POLICY_LABEL.
*
* Please note that on Windows Phone, Microsoft does not provide standard UI
* for displaying a privacy policy link, and as such,
* SDL_HINT_WINRT_PRIVACY_POLICY_URL will not get used on that platform.
* Network-enabled phone apps should display their privacy policy through some
* other, in-app means.
*
* \since This hint is available since SDL 3.0.0.
*/
#define SDL_HINT_WINRT_PRIVACY_POLICY_URL "SDL_WINRT_PRIVACY_POLICY_URL"
/**
* A variable controlling whether X11 windows are marked as override-redirect.
*
@@ -4092,7 +3979,7 @@ extern "C" {
/**
* Specify the XCB library to load for the X11 driver.
*
* This defaults to "libX11-xcb.so"
* The default is platform-specific, often "libX11-xcb.so.1".
*
* This hint should be set before initializing the video subsystem.
*
@@ -4162,8 +4049,8 @@ typedef enum SDL_HintPriority
* \param name the hint to set.
* \param value the value of the hint variable.
* \param priority the SDL_HintPriority level for the hint.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \threadsafety It is safe to call this function from any thread.
*
@@ -4173,7 +4060,7 @@ typedef enum SDL_HintPriority
* \sa SDL_ResetHint
* \sa SDL_SetHint
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHintWithPriority(const char *name, const char *value, SDL_HintPriority priority);
extern SDL_DECLSPEC bool SDLCALL SDL_SetHintWithPriority(const char *name, const char *value, SDL_HintPriority priority);
/**
* Set a hint with normal priority.
@@ -4184,8 +4071,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHintWithPriority(const char *name, c
*
* \param name the hint to set.
* \param value the value of the hint variable.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \threadsafety It is safe to call this function from any thread.
*
@@ -4195,7 +4082,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHintWithPriority(const char *name, c
* \sa SDL_ResetHint
* \sa SDL_SetHintWithPriority
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHint(const char *name, const char *value);
extern SDL_DECLSPEC bool SDLCALL SDL_SetHint(const char *name, const char *value);
/**
* Reset a hint to the default value.
@@ -4205,8 +4092,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHint(const char *name, const char *v
* change.
*
* \param name the hint to set.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \threadsafety It is safe to call this function from any thread.
*
@@ -4215,7 +4102,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetHint(const char *name, const char *v
* \sa SDL_SetHint
* \sa SDL_ResetHints
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ResetHint(const char *name);
extern SDL_DECLSPEC bool SDLCALL SDL_ResetHint(const char *name);
/**
* Reset all hints to the default values.
@@ -4267,7 +4154,7 @@ extern SDL_DECLSPEC const char *SDLCALL SDL_GetHint(const char *name);
* \sa SDL_GetHint
* \sa SDL_SetHint
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetHintBoolean(const char *name, SDL_bool default_value);
extern SDL_DECLSPEC bool SDLCALL SDL_GetHintBoolean(const char *name, bool default_value);
/**
* A callback used to send notifications of hint value changes.
@@ -4300,8 +4187,8 @@ typedef void(SDLCALL *SDL_HintCallback)(void *userdata, const char *name, const
* \param callback An SDL_HintCallback function that will be called when the
* hint value changes.
* \param userdata a pointer to pass to the callback function.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \threadsafety It is safe to call this function from any thread.
*
@@ -4309,7 +4196,7 @@ typedef void(SDLCALL *SDL_HintCallback)(void *userdata, const char *name, const
*
* \sa SDL_RemoveHintCallback
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_AddHintCallback(const char *name, SDL_HintCallback callback, void *userdata);
extern SDL_DECLSPEC bool SDLCALL SDL_AddHintCallback(const char *name, SDL_HintCallback callback, void *userdata);
/**
* Remove a function watching a particular hint.