1/*
2 Simple DirectMedia Layer
3 Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
4
5 This software is provided 'as-is', without any express or implied
6 warranty. In no event will the authors be held liable for any damages
7 arising from the use of this software.
8
9 Permission is granted to anyone to use this software for any purpose,
10 including commercial applications, and to alter it and redistribute it
11 freely, subject to the following restrictions:
12
13 1. The origin of this software must not be misrepresented; you must not
14 claim that you wrote the original software. If you use this software
15 in a product, an acknowledgment in the product documentation would be
16 appreciated but is not required.
17 2. Altered source versions must be plainly marked as such, and must not be
18 misrepresented as being the original software.
19 3. This notice may not be removed or altered from any source distribution.
20*/
21#include "SDL_internal.h"
22
23#ifndef SDL_pixels_c_h_
24#define SDL_pixels_c_h_
25
26// Useful functions and variables from SDL_pixel.c
27
28#include "SDL_blit.h"
29
30
31// Pixel format functions
32extern bool SDL_CalculateSurfaceSize(SDL_PixelFormat format, int width, int height, size_t *size, size_t *pitch, bool minimalPitch);
33extern SDL_Colorspace SDL_GetDefaultColorspaceForFormat(SDL_PixelFormat pixel_format);
34extern void SDL_QuitPixelFormatDetails(void);
35
36// Colorspace conversion functions
37extern float SDL_sRGBtoLinear(float v);
38extern float SDL_sRGBfromLinear(float v);
39extern float SDL_PQtoNits(float v);
40extern float SDL_PQfromNits(float v);
41extern const float *SDL_GetYCbCRtoRGBConversionMatrix(SDL_Colorspace colorspace, int w, int h, int bits_per_pixel);
42extern const float *SDL_GetColorPrimariesConversionMatrix(SDL_ColorPrimaries src, SDL_ColorPrimaries dst);
43extern void SDL_ConvertColorPrimaries(float *fR, float *fG, float *fB, const float *matrix);
44
45// Blit mapping functions
46extern bool SDL_ValidateMap(SDL_Surface *src, SDL_Surface *dst);
47extern void SDL_InvalidateMap(SDL_BlitMap *map);
48extern bool SDL_MapSurface(SDL_Surface *src, SDL_Surface *dst);
49
50// Miscellaneous functions
51extern void SDL_DitherPalette(SDL_Palette *palette);
52extern Uint8 SDL_FindColor(const SDL_Palette *pal, Uint8 r, Uint8 g, Uint8 b, Uint8 a);
53extern Uint8 SDL_LookupRGBAColor(SDL_HashTable *palette_map, Uint32 pixel, const SDL_Palette *pal);
54extern void SDL_DetectPalette(const SDL_Palette *pal, bool *is_opaque, bool *has_alpha_channel);
55extern SDL_Surface *SDL_DuplicatePixels(int width, int height, SDL_PixelFormat format, SDL_Colorspace colorspace, void *pixels, int pitch);
56
57#endif // SDL_pixels_c_h_
58