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

259
include/SDL3/SDL_surface.h
View File

@@ -223,14 +223,14 @@ extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_GetSurfaceProperties(SDL_Surfac
* \param surface the SDL_Surface structure to update.
* \param colorspace an SDL_ColorSpace value describing the surface
* colorspace.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceColorspace
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceColorspace(SDL_Surface *surface, SDL_Colorspace colorspace);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceColorspace(SDL_Surface *surface, SDL_Colorspace colorspace);
/**
* Get the colorspace used by a surface.
@@ -284,15 +284,15 @@ extern SDL_DECLSPEC SDL_Palette * SDLCALL SDL_CreateSurfacePalette(SDL_Surface *
*
* \param surface the SDL_Surface structure to update.
* \param palette the SDL_Palette structure to use.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_CreatePalette
* \sa SDL_GetSurfacePalette
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfacePalette(SDL_Surface *surface, SDL_Palette *palette);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfacePalette(SDL_Surface *surface, SDL_Palette *palette);
/**
* Get the palette used by a surface.
@@ -321,8 +321,8 @@ extern SDL_DECLSPEC SDL_Palette * SDLCALL SDL_GetSurfacePalette(SDL_Surface *sur
* \param surface the SDL_Surface structure to update.
* \param image a pointer to an alternate SDL_Surface to associate with this
* surface.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
@@ -330,14 +330,13 @@ extern SDL_DECLSPEC SDL_Palette * SDLCALL SDL_GetSurfacePalette(SDL_Surface *sur
* \sa SDL_GetSurfaceImages
* \sa SDL_SurfaceHasAlternateImages
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_AddSurfaceAlternateImage(SDL_Surface *surface, SDL_Surface *image);
extern SDL_DECLSPEC bool SDLCALL SDL_AddSurfaceAlternateImage(SDL_Surface *surface, SDL_Surface *image);
/**
* Return whether a surface has alternate versions available.
*
* \param surface the SDL_Surface structure to query.
* \returns SDL_TRUE if alternate versions are available or SDL_TRUE
* otherwise.
* \returns true if alternate versions are available or true otherwise.
*
* \since This function is available since SDL 3.0.0.
*
@@ -345,7 +344,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_AddSurfaceAlternateImage(SDL_Surface *s
* \sa SDL_RemoveSurfaceAlternateImages
* \sa SDL_GetSurfaceImages
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasAlternateImages(SDL_Surface *surface);
extern SDL_DECLSPEC bool SDLCALL SDL_SurfaceHasAlternateImages(SDL_Surface *surface);
/**
* Get an array including all versions of a surface.
@@ -401,15 +400,15 @@ extern SDL_DECLSPEC void SDLCALL SDL_RemoveSurfaceAlternateImages(SDL_Surface *s
* format of the surface will not change.
*
* \param surface the SDL_Surface structure to be locked.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_MUSTLOCK
* \sa SDL_UnlockSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_LockSurface(SDL_Surface *surface);
extern SDL_DECLSPEC bool SDLCALL SDL_LockSurface(SDL_Surface *surface);
/**
* Release a surface after directly accessing the pixels.
@@ -429,8 +428,8 @@ extern SDL_DECLSPEC void SDLCALL SDL_UnlockSurface(SDL_Surface *surface);
* will result in a memory leak.
*
* \param src the data stream for the surface.
* \param closeio if SDL_TRUE, calls SDL_CloseIO() on `src` before returning,
* even in the case of an error.
* \param closeio if true, calls SDL_CloseIO() on `src` before returning, even
* in the case of an error.
* \returns a pointer to a new SDL_Surface structure or NULL on failure; call
* SDL_GetError() for more information.
*
@@ -440,7 +439,7 @@ extern SDL_DECLSPEC void SDLCALL SDL_UnlockSurface(SDL_Surface *surface);
* \sa SDL_LoadBMP
* \sa SDL_SaveBMP_IO
*/
extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_LoadBMP_IO(SDL_IOStream *src, SDL_bool closeio);
extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_LoadBMP_IO(SDL_IOStream *src, bool closeio);
/**
* Load a BMP image from a file.
@@ -471,17 +470,17 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_LoadBMP(const char *file);
*
* \param surface the SDL_Surface structure containing the image to be saved.
* \param dst a data stream to save to.
* \param closeio if SDL_TRUE, calls SDL_CloseIO() on `dst` before returning,
* even in the case of an error.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \param closeio if true, calls SDL_CloseIO() on `dst` before returning, even
* in the case of an error.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_LoadBMP_IO
* \sa SDL_SaveBMP
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SaveBMP_IO(SDL_Surface *surface, SDL_IOStream *dst, SDL_bool closeio);
extern SDL_DECLSPEC bool SDLCALL SDL_SaveBMP_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
/**
* Save a surface to a file.
@@ -494,15 +493,15 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SaveBMP_IO(SDL_Surface *surface, SDL_IO
*
* \param surface the SDL_Surface structure containing the image to be saved.
* \param file a file to save to.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_LoadBMP
* \sa SDL_SaveBMP_IO
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SaveBMP(SDL_Surface *surface, const char *file);
extern SDL_DECLSPEC bool SDLCALL SDL_SaveBMP(SDL_Surface *surface, const char *file);
/**
* Set the RLE acceleration hint for a surface.
@@ -511,10 +510,9 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SaveBMP(SDL_Surface *surface, const cha
* the surface must be locked before directly accessing the pixels.
*
* \param surface the SDL_Surface structure to optimize.
* \param enabled SDL_TRUE to enable RLE acceleration, SDL_FALSE to disable
* it.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \param enabled true to enable RLE acceleration, false to disable it.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*
@@ -522,21 +520,21 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SaveBMP(SDL_Surface *surface, const cha
* \sa SDL_LockSurface
* \sa SDL_UnlockSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceRLE(SDL_Surface *surface, SDL_bool enabled);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceRLE(SDL_Surface *surface, bool enabled);
/**
* Returns whether the surface is RLE enabled.
*
* It is safe to pass a NULL `surface` here; it will return SDL_FALSE.
* It is safe to pass a NULL `surface` here; it will return false.
*
* \param surface the SDL_Surface structure to query.
* \returns SDL_TRUE if the surface is RLE enabled, SDL_FALSE otherwise.
* \returns true if the surface is RLE enabled, false otherwise.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_SetSurfaceRLE
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasRLE(SDL_Surface *surface);
extern SDL_DECLSPEC bool SDLCALL SDL_SurfaceHasRLE(SDL_Surface *surface);
/**
* Set the color key (transparent pixel) in a surface.
@@ -549,11 +547,10 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasRLE(SDL_Surface *surface);
* SDL_MapRGB().
*
* \param surface the SDL_Surface structure to update.
* \param enabled SDL_TRUE to enable color key, SDL_FALSE to disable color
* key.
* \param enabled true to enable color key, false to disable color key.
* \param key the transparent pixel.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
@@ -561,22 +558,22 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasRLE(SDL_Surface *surface);
* \sa SDL_SetSurfaceRLE
* \sa SDL_SurfaceHasColorKey
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceColorKey(SDL_Surface *surface, SDL_bool enabled, Uint32 key);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceColorKey(SDL_Surface *surface, bool enabled, Uint32 key);
/**
* Returns whether the surface has a color key.
*
* It is safe to pass a NULL `surface` here; it will return SDL_FALSE.
* It is safe to pass a NULL `surface` here; it will return false.
*
* \param surface the SDL_Surface structure to query.
* \returns SDL_TRUE if the surface has a color key, SDL_FALSE otherwise.
* \returns true if the surface has a color key, false otherwise.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_SetSurfaceColorKey
* \sa SDL_GetSurfaceColorKey
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasColorKey(SDL_Surface *surface);
extern SDL_DECLSPEC bool SDLCALL SDL_SurfaceHasColorKey(SDL_Surface *surface);
/**
* Get the color key (transparent pixel) for a surface.
@@ -584,19 +581,19 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SurfaceHasColorKey(SDL_Surface *surface
* The color key is a pixel of the format used by the surface, as generated by
* SDL_MapRGB().
*
* If the surface doesn't have color key enabled this function returns -1.
* If the surface doesn't have color key enabled this function returns false.
*
* \param surface the SDL_Surface structure to query.
* \param key a pointer filled in with the transparent pixel.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_SetSurfaceColorKey
* \sa SDL_SurfaceHasColorKey
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceColorKey(SDL_Surface *surface, Uint32 *key);
extern SDL_DECLSPEC bool SDLCALL SDL_GetSurfaceColorKey(SDL_Surface *surface, Uint32 *key);
/**
* Set an additional color value multiplied into blit operations.
@@ -611,15 +608,15 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceColorKey(SDL_Surface *surface
* \param r the red color value multiplied into blit operations.
* \param g the green color value multiplied into blit operations.
* \param b the blue color value multiplied into blit operations.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceColorMod
* \sa SDL_SetSurfaceAlphaMod
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceColorMod(SDL_Surface *surface, Uint8 r, Uint8 g, Uint8 b);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceColorMod(SDL_Surface *surface, Uint8 r, Uint8 g, Uint8 b);
/**
@@ -629,15 +626,15 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceColorMod(SDL_Surface *surface
* \param r a pointer filled in with the current red color value.
* \param g a pointer filled in with the current green color value.
* \param b a pointer filled in with the current blue color value.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceAlphaMod
* \sa SDL_SetSurfaceColorMod
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceColorMod(SDL_Surface *surface, Uint8 *r, Uint8 *g, Uint8 *b);
extern SDL_DECLSPEC bool SDLCALL SDL_GetSurfaceColorMod(SDL_Surface *surface, Uint8 *r, Uint8 *g, Uint8 *b);
/**
* Set an additional alpha value used in blit operations.
@@ -649,30 +646,30 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceColorMod(SDL_Surface *surface
*
* \param surface the SDL_Surface structure to update.
* \param alpha the alpha value multiplied into blit operations.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceAlphaMod
* \sa SDL_SetSurfaceColorMod
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceAlphaMod(SDL_Surface *surface, Uint8 alpha);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceAlphaMod(SDL_Surface *surface, Uint8 alpha);
/**
* Get the additional alpha value used in blit operations.
*
* \param surface the SDL_Surface structure to query.
* \param alpha a pointer filled in with the current alpha value.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceColorMod
* \sa SDL_SetSurfaceAlphaMod
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceAlphaMod(SDL_Surface *surface, Uint8 *alpha);
extern SDL_DECLSPEC bool SDLCALL SDL_GetSurfaceAlphaMod(SDL_Surface *surface, Uint8 *alpha);
/**
* Set the blend mode used for blit operations.
@@ -683,28 +680,28 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceAlphaMod(SDL_Surface *surface
*
* \param surface the SDL_Surface structure to update.
* \param blendMode the SDL_BlendMode to use for blit blending.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceBlendMode
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceBlendMode(SDL_Surface *surface, SDL_BlendMode blendMode);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceBlendMode(SDL_Surface *surface, SDL_BlendMode blendMode);
/**
* Get the blend mode used for blit operations.
*
* \param surface the SDL_Surface structure to query.
* \param blendMode a pointer filled in with the current SDL_BlendMode.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_SetSurfaceBlendMode
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceBlendMode(SDL_Surface *surface, SDL_BlendMode *blendMode);
extern SDL_DECLSPEC bool SDLCALL SDL_GetSurfaceBlendMode(SDL_Surface *surface, SDL_BlendMode *blendMode);
/**
* Set the clipping rectangle for a surface.
@@ -718,14 +715,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceBlendMode(SDL_Surface *surfac
* \param surface the SDL_Surface structure to be clipped.
* \param rect the SDL_Rect structure representing the clipping rectangle, or
* NULL to disable clipping.
* \returns SDL_TRUE if the rectangle intersects the surface, otherwise
* SDL_FALSE and blits will be completely clipped.
* \returns true if the rectangle intersects the surface, otherwise false and
* blits will be completely clipped.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_GetSurfaceClipRect
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceClipRect(SDL_Surface *surface, const SDL_Rect *rect);
extern SDL_DECLSPEC bool SDLCALL SDL_SetSurfaceClipRect(SDL_Surface *surface, const SDL_Rect *rect);
/**
* Get the clipping rectangle for a surface.
@@ -737,26 +734,26 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_SetSurfaceClipRect(SDL_Surface *surface
* clipped.
* \param rect an SDL_Rect structure filled in with the clipping rectangle for
* the surface.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_SetSurfaceClipRect
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_GetSurfaceClipRect(SDL_Surface *surface, SDL_Rect *rect);
extern SDL_DECLSPEC bool SDLCALL SDL_GetSurfaceClipRect(SDL_Surface *surface, SDL_Rect *rect);
/**
* Flip a surface vertically or horizontally.
*
* \param surface the surface to flip.
* \param flip the direction to flip.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FlipSurface(SDL_Surface *surface, SDL_FlipMode flip);
extern SDL_DECLSPEC bool SDLCALL SDL_FlipSurface(SDL_Surface *surface, SDL_FlipMode flip);
/**
* Creates a new surface identical to the existing surface.
@@ -859,14 +856,14 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_ConvertSurfaceAndColorspace(SDL_Su
* \param dst_format an SDL_PixelFormat value of the `dst` pixels format.
* \param dst a pointer to be filled in with new pixel data.
* \param dst_pitch the pitch of the destination pixels, in bytes.
* \returns SDL_FALSE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns false on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_ConvertPixelsAndColorspace
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ConvertPixels(int width, int height, SDL_PixelFormat src_format, const void *src, int src_pitch, SDL_PixelFormat dst_format, void *dst, int dst_pitch);
extern SDL_DECLSPEC bool SDLCALL SDL_ConvertPixels(int width, int height, SDL_PixelFormat src_format, const void *src, int src_pitch, SDL_PixelFormat dst_format, void *dst, int dst_pitch);
/**
* Copy a block of pixels of one format and colorspace to another format and
@@ -888,14 +885,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ConvertPixels(int width, int height, SD
* properties, or 0.
* \param dst a pointer to be filled in with new pixel data.
* \param dst_pitch the pitch of the destination pixels, in bytes.
* \returns SDL_FALSE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \returns false on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_ConvertPixels
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ConvertPixelsAndColorspace(int width, int height, SDL_PixelFormat src_format, SDL_Colorspace src_colorspace, SDL_PropertiesID src_properties, const void *src, int src_pitch, SDL_PixelFormat dst_format, SDL_Colorspace dst_colorspace, SDL_PropertiesID dst_properties, void *dst, int dst_pitch);
extern SDL_DECLSPEC bool SDLCALL SDL_ConvertPixelsAndColorspace(int width, int height, SDL_PixelFormat src_format, SDL_Colorspace src_colorspace, SDL_PropertiesID src_properties, const void *src, int src_pitch, SDL_PixelFormat dst_format, SDL_Colorspace dst_colorspace, SDL_PropertiesID dst_properties, void *dst, int dst_pitch);
/**
* Premultiply the alpha on a block of pixels.
@@ -910,14 +907,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ConvertPixelsAndColorspace(int width, i
* \param dst_format an SDL_PixelFormat value of the `dst` pixels format.
* \param dst a pointer to be filled in with premultiplied pixel data.
* \param dst_pitch the pitch of the destination pixels, in bytes.
* \param linear SDL_TRUE to convert from sRGB to linear space for the alpha
* multiplication, SDL_FALSE to do multiplication in sRGB space.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \param linear true to convert from sRGB to linear space for the alpha
* multiplication, false to do multiplication in sRGB space.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_PremultiplyAlpha(int width, int height, SDL_PixelFormat src_format, const void *src, int src_pitch, SDL_PixelFormat dst_format, void *dst, int dst_pitch, SDL_bool linear);
extern SDL_DECLSPEC bool SDLCALL SDL_PremultiplyAlpha(int width, int height, SDL_PixelFormat src_format, const void *src, int src_pitch, SDL_PixelFormat dst_format, void *dst, int dst_pitch, bool linear);
/**
* Premultiply the alpha in a surface.
@@ -925,14 +922,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_PremultiplyAlpha(int width, int height,
* This is safe to use with src == dst, but not for other overlapping areas.
*
* \param surface the surface to modify.
* \param linear SDL_TRUE to convert from sRGB to linear space for the alpha
* multiplication, SDL_FALSE to do multiplication in sRGB space.
* \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError()
* for more information.
* \param linear true to convert from sRGB to linear space for the alpha
* multiplication, false to do multiplication in sRGB space.
* \returns true on success or false on failure; call SDL_GetError() for more
* information.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_PremultiplySurfaceAlpha(SDL_Surface *surface, SDL_bool linear);
extern SDL_DECLSPEC bool SDLCALL SDL_PremultiplySurfaceAlpha(SDL_Surface *surface, bool linear);
/**
* Clear a surface with a specific color, with floating point precision.
@@ -947,12 +944,12 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_PremultiplySurfaceAlpha(SDL_Surface *su
* \param g the green component of the pixel, normally in the range 0-1.
* \param b the blue component of the pixel, normally in the range 0-1.
* \param a the alpha component of the pixel, normally in the range 0-1.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ClearSurface(SDL_Surface *surface, float r, float g, float b, float a);
extern SDL_DECLSPEC bool SDLCALL SDL_ClearSurface(SDL_Surface *surface, float r, float g, float b, float a);
/**
* Perform a fast fill of a rectangle with a specific color.
@@ -970,14 +967,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ClearSurface(SDL_Surface *surface, floa
* \param rect the SDL_Rect structure representing the rectangle to fill, or
* NULL to fill the entire surface.
* \param color the color to fill with.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_FillSurfaceRects
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FillSurfaceRect(SDL_Surface *dst, const SDL_Rect *rect, Uint32 color);
extern SDL_DECLSPEC bool SDLCALL SDL_FillSurfaceRect(SDL_Surface *dst, const SDL_Rect *rect, Uint32 color);
/**
* Perform a fast fill of a set of rectangles with a specific color.
@@ -995,14 +992,14 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FillSurfaceRect(SDL_Surface *dst, const
* \param rects an array of SDL_Rects representing the rectangles to fill.
* \param count the number of rectangles in the array.
* \param color the color to fill with.
* \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.
*
* \since This function is available since SDL 3.0.0.
*
* \sa SDL_FillSurfaceRect
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FillSurfaceRects(SDL_Surface *dst, const SDL_Rect *rects, int count, Uint32 color);
extern SDL_DECLSPEC bool SDLCALL SDL_FillSurfaceRects(SDL_Surface *dst, const SDL_Rect *rects, int count, Uint32 color);
/**
* Performs a fast blit from the source surface to the destination surface.
@@ -1066,8 +1063,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FillSurfaceRects(SDL_Surface *dst, cons
* height are ignored, and are copied from `srcrect`. If you
* want a specific width and height, you should use
* SDL_BlitSurfaceScaled().
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1077,7 +1074,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_FillSurfaceRects(SDL_Surface *dst, cons
*
* \sa SDL_BlitSurfaceScaled
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurface(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurface(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
/**
* Perform low-level surface blitting only.
@@ -1091,8 +1088,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurface(SDL_Surface *src, const SDL
* \param dst the SDL_Surface structure that is the blit target.
* \param dstrect the SDL_Rect structure representing the target rectangle in
* the destination surface, may not be NULL.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1102,7 +1099,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurface(SDL_Surface *src, const SDL
*
* \sa SDL_BlitSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUnchecked(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurfaceUnchecked(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
/**
* Perform a scaled blit to a destination surface, which may be of a different
@@ -1116,8 +1113,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUnchecked(SDL_Surface *src,
* the destination surface, or NULL to fill the entire
* destination surface.
* \param scaleMode the SDL_ScaleMode to be used.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1127,7 +1124,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUnchecked(SDL_Surface *src,
*
* \sa SDL_BlitSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceScaled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurfaceScaled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode);
/**
* Perform low-level surface scaled blitting only.
@@ -1142,8 +1139,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceScaled(SDL_Surface *src, con
* \param dstrect the SDL_Rect structure representing the target rectangle in
* the destination surface, may not be NULL.
* \param scaleMode the SDL_ScaleMode to be used.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1153,7 +1150,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceScaled(SDL_Surface *src, con
*
* \sa SDL_BlitSurfaceScaled
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUncheckedScaled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurfaceUncheckedScaled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode);
/**
* Perform a tiled blit to a destination surface, which may be of a different
@@ -1168,8 +1165,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUncheckedScaled(SDL_Surface
* \param dst the SDL_Surface structure that is the blit target.
* \param dstrect the SDL_Rect structure representing the target rectangle in
* the destination surface, or NULL to fill the entire surface.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1179,7 +1176,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceUncheckedScaled(SDL_Surface
*
* \sa SDL_BlitSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurfaceTiled(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect);
/**
* Perform a scaled and tiled blit to a destination surface, which may be of a
@@ -1198,8 +1195,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiled(SDL_Surface *src, cons
* \param dst the SDL_Surface structure that is the blit target.
* \param dstrect the SDL_Rect structure representing the target rectangle in
* the destination surface, or NULL to fill the entire surface.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1209,7 +1206,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiled(SDL_Surface *src, cons
*
* \sa SDL_BlitSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiledWithScale(SDL_Surface *src, const SDL_Rect *srcrect, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurfaceTiledWithScale(SDL_Surface *src, const SDL_Rect *srcrect, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);
/**
* Perform a scaled blit using the 9-grid algorithm to a destination surface,
@@ -1235,8 +1232,8 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiledWithScale(SDL_Surface *
* \param dst the SDL_Surface structure that is the blit target.
* \param dstrect the SDL_Rect structure representing the target rectangle in
* the destination surface, or NULL to fill the entire surface.
* \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 The same destination surface should not be used from two
* threads at once. It is safe to use the same source surface
@@ -1246,7 +1243,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurfaceTiledWithScale(SDL_Surface *
*
* \sa SDL_BlitSurface
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_BlitSurface9Grid(SDL_Surface *src, const SDL_Rect *srcrect, int left_width, int right_width, int top_height, int bottom_height, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);
extern SDL_DECLSPEC bool SDLCALL SDL_BlitSurface9Grid(SDL_Surface *src, const SDL_Rect *srcrect, int left_width, int right_width, int top_height, int bottom_height, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);
/**
* Map an RGB triple to an opaque pixel value for a surface.
@@ -1329,12 +1326,12 @@ extern SDL_DECLSPEC Uint32 SDLCALL SDL_MapSurfaceRGBA(SDL_Surface *surface, Uint
* ignore this channel.
* \param a a pointer filled in with the alpha channel, 0-255, or NULL to
* ignore this channel.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ReadSurfacePixel(SDL_Surface *surface, int x, int y, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a);
extern SDL_DECLSPEC bool SDLCALL SDL_ReadSurfacePixel(SDL_Surface *surface, int x, int y, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a);
/**
* Retrieves a single pixel from a surface.
@@ -1353,12 +1350,12 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ReadSurfacePixel(SDL_Surface *surface,
* 0-1, or NULL to ignore this channel.
* \param a a pointer filled in with the alpha channel, normally in the range
* 0-1, or NULL to ignore this channel.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ReadSurfacePixelFloat(SDL_Surface *surface, int x, int y, float *r, float *g, float *b, float *a);
extern SDL_DECLSPEC bool SDLCALL SDL_ReadSurfacePixelFloat(SDL_Surface *surface, int x, int y, float *r, float *g, float *b, float *a);
/**
* Writes a single pixel to a surface.
@@ -1376,12 +1373,12 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_ReadSurfacePixelFloat(SDL_Surface *surf
* \param g the green channel value, 0-255.
* \param b the blue channel value, 0-255.
* \param a the alpha channel value, 0-255.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_WriteSurfacePixel(SDL_Surface *surface, int x, int y, Uint8 r, Uint8 g, Uint8 b, Uint8 a);
extern SDL_DECLSPEC bool SDLCALL SDL_WriteSurfacePixel(SDL_Surface *surface, int x, int y, Uint8 r, Uint8 g, Uint8 b, Uint8 a);
/**
* Writes a single pixel to a surface.
@@ -1396,12 +1393,12 @@ extern SDL_DECLSPEC SDL_bool SDLCALL SDL_WriteSurfacePixel(SDL_Surface *surface,
* \param g the green channel value, normally in the range 0-1.
* \param b the blue channel value, normally in the range 0-1.
* \param a the alpha channel value, normally in the range 0-1.
* \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.
*
* \since This function is available since SDL 3.0.0.
*/
extern SDL_DECLSPEC SDL_bool SDLCALL SDL_WriteSurfacePixelFloat(SDL_Surface *surface, int x, int y, float r, float g, float b, float a);
extern SDL_DECLSPEC bool SDLCALL SDL_WriteSurfacePixelFloat(SDL_Surface *surface, int x, int y, float r, float g, float b, float a);
/* Ends C function definitions when using C++ */
#ifdef __cplusplus