0df988389c
include: Add `\since` to all documentation that was missing it.
2024-04-11 13:34:29 -04:00
132cef91c8
Removing macro SDL_FColour from SDL_pixels.h
2024-04-09 18:20:03 -04:00
f687e0732a
Doxygen comment fixes in SDL_pixels.h
2024-04-09 16:57:34 -04:00
9b5944a14f
Removing SDL_Colour macro
2024-04-09 12:25:36 -04:00
e044318a8e
Sync SDL3 wiki -> headers
2024-04-09 00:50:03 -04:00
ad090d2444
include: A ton of little documentation tweaks, fixes, and improvements.
...
This is just stuff I noticed while working on the wikiheaders updates. A
thorough pass over all the docs would not be terrible, and maybe a simple
script to check for consistency (does everything have a `\since` on it? etc)
might be nice, too.
2024-04-09 00:50:02 -04:00
3f8dba3713
Including SD_error.h into headers with error-returning functions
2024-04-04 11:12:58 -07:00
171ff041d0
Removed invalid ascii from headers
2024-03-23 16:31:00 -07:00
d8a54cd4f8
Updated "see also" references to be more consistent
...
Fixes https://github.com/libsdl-org/SDL/issues/9282
2024-03-17 12:28:11 -07:00
59ab5c0824
Sync SDL3 wiki -> header
2024-03-07 00:20:27 +00:00
c70710cde8
SDL_GetPixelFormatEnumForMasks() returns SDL_PixelFormatEnum
2024-03-06 16:19:08 -08:00
424616e032
Use SDL_PixelFormatEnum as type
2024-03-06 15:02:13 -08:00
db24560387
Additional colorspace clarification
...
Note that SDL_MATRIX_COEFFICIENTS_BT470BG is functionally equivalent to SDL_MATRIX_COEFFICIENTS_BT601
2024-03-05 16:47:36 -08:00
b3858ec5f7
BT2020_CL is very different from BT2020_NCL, and not currently supported
2024-03-05 15:49:17 -08:00
f2cd361e25
testyuv: added validation of P010 YUV format
...
Also added conversion between RGB and P010, using XRGB2101010 as a bridging format in PQ space
2024-03-01 20:26:52 -08:00
220340e944
Remove SDL_PIXELFORMAT_P010
...
It's not supported by any renderer or pixel conversion path
2024-02-27 12:48:33 -08:00
4ba6aeee9d
A second take on HDR support with an SDR white point and HDR headroom
...
This better reflects how HDR content is actually used, e.g. most content is in the SDR range, with specular highlights and bright details beyond the SDR range, in the HDR headroom.
This more closely matches how HDR is handled on Apple platforms, as EDR.
This also greatly simplifies application code which no longer has to think about color scaling. SDR content is rendered at the appropriate brightness automatically, and HDR content is scaled to the correct range for the display HDR headroom.
2024-02-21 19:25:49 -08:00
cacac6cc34
Updated structure and field names for consistency
...
Type names are camel case and field names are snake case except for fields ending in id, which are capitalized.
Fixes https://github.com/libsdl-org/SDL/issues/6955
2024-02-11 08:27:56 -08:00
e74171b1ae
Added support for HDR10 video playback on direct3d11
...
Fixes https://github.com/libsdl-org/SDL/issues/8053
2024-02-05 09:45:39 -08:00
327b976bc4
SDL_COLORSPACE_JPEG is the default YUV colorspace
2024-02-04 13:09:40 -08:00
50a805cdd1
Use YUV colorspaces instead of a global YUV conversion mode
...
Fixes https://github.com/libsdl-org/SDL/issues/8669
2024-02-03 07:36:18 -08:00
9591b2cfb4
Finalized the SDL render API colorspaces
...
The renderer will always use the sRGB colorspace for drawing, and will default to the sRGB output colorspace. If you want blending in linear space and HDR support, you can select the scRGB output colorspace, which is supported by the direct3d11 and direct3d12
2024-02-02 13:13:53 -08:00
3c45544a14
Added a slow blit function to handle large pixel formats and colorspace conversion
2024-01-31 09:50:46 -08:00
4a759b340f
Fixes in SDL_ColorSpace (SDL_pixels.h)
2024-01-30 11:16:53 -08:00
f257eb4481
Added the concept of colorspace to the SDL renderer
...
This allows color operations to happen in linear space between sRGB input and sRGB output. This is currently supported on the direct3d11, direct3d12 and opengl renderers.
This is a good resource on blending in linear space vs sRGB space:
https://blog.johnnovak.net/2016/09/21/what-every-coder-should-know-about-gamma/
Also added testcolorspace to verify colorspace changes
2024-01-30 09:48:02 -08:00
554f0625d3
Renderer colors now have floating point precision
2024-01-30 09:48:02 -08:00
61a3a163db
Fixed typo (thanks @Akaricchi!)
2024-01-29 18:48:41 -08:00
61b5c38e6e
Added the initial concept of colorspace to SDL
2024-01-28 18:24:39 -08:00
aeac8774f7
Missed one
2024-01-25 16:53:19 -08:00
d0dd60c8ba
Updated new pixel format names to be more consistent with the others
2024-01-25 16:51:22 -08:00
0f78aa7c30
Add some high bit-depth pixel formats
...
These are not fully supported yet, just preparing for future work.
2024-01-25 16:40:46 -08:00
5b3ee51c6c
Updated copyright for 2024
2024-01-01 13:15:26 -08:00
30a2291d59
Fixed compatibility with sdl2-compat (thanks @sezero!)
2023-11-20 08:46:12 -08:00
753bbd199e
Add SDL_PIXELFORMAT_INDEX2LSB and SDL_PIXELFORMAT_INDEX2MSB
2023-11-17 08:45:32 -08:00
c53843a961
docs: Remove Doxygen `\brief` tags.
...
Doxygen and the wiki bridge don't need them; they'll both just use the first
line/sentence instead.
Fixes #8446 .
2023-11-06 10:26:06 -05:00
f7d40b7594
Added 10-bit pixel formats in addition to SDL_PIXELFORMAT_ARGB2101010
...
Added SDL_PIXELFORMAT_XRGB2101010, SDL_PIXELFORMAT_XBGR2101010, SDL_PIXELFORMAT_ABGR2101010
Fixes https://github.com/libsdl-org/SDL/issues/3553
2023-11-06 00:41:09 -08:00
3698630bbc
pixels: Document the naming convention
...
Whenever I have to fix something endianness-related, I always get
confused about whether the byte-oriented format that guarantees to put
red in byte 0 is RGBA8888 or RGBA32. (The answer is that it's RGBA32.)
Signed-off-by: Simon McVittie <smcv@collabora.com>
2023-10-10 03:24:43 -07:00
a2d594269c
Fixed pixel format compatibility with SDL2
2023-08-07 22:45:21 -07:00
666f81bace
Add more endian-specific aliases for 32 bit pixelformats
...
Add these for all the RGBX variants, just like all the RGBA variants already have.
2023-07-25 23:35:42 -07:00
e264bb5178
Rename SDL_PIXELFORMAT_RGB888 and SDL_PIXELFORMAT_BGR888 to SDL_PIXELFORMAT_XRGB8888 and SDL_PIXELFORMAT_XBGR8888 for clarity
...
Fixes https://github.com/libsdl-org/SDL/issues/7903
2023-07-01 17:58:34 -07:00
0f4679102c
Fixed pedantic warning: comma at end of enumerator list
...
Fixes https://github.com/libsdl-org/SDL/issues/7878
2023-06-27 21:52:33 -07:00
549cedfa88
include: add \brief to includes
2023-02-19 10:01:33 -08:00
49e47b523a
Update `\returns` to the generic form
2023-02-12 08:21:02 -08:00
e2e5e670bf
Remove returns int from Destroy/Close/Unlock functions
2023-02-09 07:57:14 -08:00
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
fde78d12f2
Updated copyright for 2023
2023-01-09 09:41:41 -08:00
083e436a1a
SDL API renaming: SDL_pixels.h
...
Fixes https://github.com/libsdl-org/SDL/issues/6886
2022-12-27 06:08:31 -08:00
63724c113b
Removed the vi format comments from the source
...
Vim users can use the [editorconfig plugin](https://github.com/editorconfig/editorconfig-vim ) to automatically set tab spacing for the SDL coding style.
Fixes https://github.com/libsdl-org/SDL/issues/6903
2022-12-26 11:17:23 -08:00
3197632347
include: Renamed begin_code.h and close_code.h to have SDL_ prefixes.
...
Fixes #6864 .
2022-12-22 11:39:26 -05:00
932f61348d
Remove mask versions of SDL_CreateRGBSurface* #6701 ( #6711 )
...
* Rename SDL_CreateRGBSurface{,From} to SDL_CreateSurface{,From}, which now takes a format parameter
2022-12-01 08:04:02 -08:00
Ryan C. Gordon
Petar Popovic
Sam Lantinga
SDL Wiki Bot
Susko3
Amun
Cameron Cawley
Simon McVittie
Starbuck5
Anonymous Maarten
Sylvain