mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-09-06 03:18:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Sync SDL2 wiki -> header

Browse Source 
[ci skip]
This commit is contained in:
SDL Wiki Bot
2024-10-20 00:51:30 +00:00
parent 4ca7a19348
commit 1af0b39833
1 changed files with 39 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
include/SDL_surface.h
View File

@@ -817,6 +817,45 @@ extern DECLSPEC int SDLCALL SDL_FillRects
* The blit semantics for surfaces with and without blending and colorkey are * The blit semantics for surfaces with and without blending and colorkey are
* defined as follows: * defined as follows:
* *
* RGBA to RGB:
*
* - Source surface blend mode set to SDL_BLENDMODE_BLEND: * alpha-blend
* (using the source alpha-channel and per-surface alpha) SDL_SRCCOLORKEY
* ignored.
* - Source surface blend mode set to SDL_BLENDMODE_NONE: * copy RGB. * if
* SDL_SRCCOLORKEY set, only copy the pixels matching the RGB values of the
* source color key, ignoring alpha in the comparison.
*
* RGB to RGBA:
*
* - Source surface blend mode set to SDL_BLENDMODE_BLEND: * alpha-blend
* (using the source per-surface alpha)
* - Source surface blend mode set to SDL_BLENDMODE_NONE: * copy RGB, set
* destination alpha to source per-surface alpha value.
* - both: * if SDL_SRCCOLORKEY set, only copy the pixels matching the source
* color key.
*
* RGBA to RGBA:
*
* - Source surface blend mode set to SDL_BLENDMODE_BLEND: * alpha-blend
* (using the source alpha-channel and per-surface alpha) * SDL_SRCCOLORKEY
* ignored.
* - Source surface blend mode set to SDL_BLENDMODE_NONE: * copy all of RGBA
* to the destination. * if SDL_SRCCOLORKEY set, only copy the pixels
* matching the RGB values of the source color key, ignoring alpha in the
* comparison.
*
* RGB to RGB:
*
* - Source surface blend mode set to SDL_BLENDMODE_BLEND: * alpha-blend
* (using the source per-surface alpha)
* - Source surface blend mode set to SDL_BLENDMODE_NONE: * copy RGB.
* - both: * if SDL_SRCCOLORKEY set, only copy the pixels matching the source
* color key.
*
* You should call SDL_BlitSurface() unless you know exactly how SDL blitting
* works internally and how to use the other blit functions.
*
* \returns 0 if the blit is successful, otherwise it returns -1. * \returns 0 if the blit is successful, otherwise it returns -1.
*/ */
#define SDL_BlitSurface SDL_UpperBlit #define SDL_BlitSurface SDL_UpperBlit