gitea/SDL3_fork
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync SDL3 wiki -> header

Browse Source
This commit is contained in:
SDL Wiki Bot
2024-01-27 21:01:19 +00:00
parent 3b55c7d1f4
commit aba3038353
3 changed files with 131 additions and 138 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
include/SDL3/SDL_surface.h
View File

@@ -262,21 +262,21 @@ extern DECLSPEC void SDLCALL SDL_DestroySurface(SDL_Surface *surface);
*
* The following properties are understood by SDL:
*
* - `SDL_PROP_SURFACE_COLOR_PRIMARIES_NUMBER`: an SDL_ColorPrimaries
* value describing the surface colorspace
* - `SDL_PROP_SURFACE_COLOR_PRIMARIES_NUMBER`: an SDL_ColorPrimaries value
* describing the surface colorspace
* - `SDL_PROP_SURFACE_TRANSFER_CHARACTERISTICS_NUMBER`: an
* SDL_TransferCharacteristics value describing the surface colorspace
* - `SDL_PROP_SURFACE_MAXCLL_NUMBER`: MaxCLL (Maximum Content Light
* Level) indicates the maximum light level of any single pixel (in cd/m2 or
* nits) of the entire playback sequence. MaxCLL is usually measured off the
* final delivered content after mastering. If one uses the full light level
* of the HDR mastering display and adds a hard clip at its maximum value,
* - `SDL_PROP_SURFACE_MAXCLL_NUMBER`: MaxCLL (Maximum Content Light Level)
* indicates the maximum light level of any single pixel (in cd/m2 or nits)
* of the entire playback sequence. MaxCLL is usually measured off the final
* delivered content after mastering. If one uses the full light level of
* the HDR mastering display and adds a hard clip at its maximum value,
* MaxCLL would be equal to the peak luminance of the mastering monitor.
* - `SDL_PROP_SURFACE_MAXFALL_NUMBER`: MaxFALL (Maximum Frame Average
* Light Level) indicates the maximum value of the frame average light level
* (in cd/m2 or nits) of the entire playback sequence. MaxFALL is calculated
* by averaging the decoded luminance values of all the pixels within a
* frame. MaxFALL is usually much lower than MaxCLL.
* - `SDL_PROP_SURFACE_MAXFALL_NUMBER`: MaxFALL (Maximum Frame Average Light
* Level) indicates the maximum value of the frame average light level (in
* cd/m2 or nits) of the entire playback sequence. MaxFALL is calculated by
* averaging the decoded luminance values of all the pixels within a frame.
* MaxFALL is usually much lower than MaxCLL.
*
* \param surface the SDL_Surface structure to query
* \returns a valid property ID on success or 0 on failure; call