mirror of
https://github.com/Q3Rally-Team/q3rally.git
synced 2024-11-24 21:01:34 +00:00
22a0949a26
Upgrade to build and run from VS2019 Upgrades to Xcode project and Apple Silicon support Update SDL2 to 2.0.14 Updated SDL2 include files to fix Mac build in GitHub Actions Added another mention of arm64 to command line help Restored original opus sse files, excluded from Xcode Added arm64 to the post-build symlinking step Merge branch 'main' into xcode Merge branch 'main' into vs2019 Added shell script to compile Universal 2 binary (x86_64+arm64) Reverting alert style to deprecated methods Upgrades to Xcode project and Apple Silicon support Update SDL2 to 2.0.14 Added another mention of arm64 to command line help Restored original opus sse files, excluded from Xcode Added arm64 to the post-build symlinking step Added shell script to compile Universal 2 binary (x86_64+arm64) Reverting alert style to deprecated methods Merge branch 'xcode' of https://github.com/tomkidd/ioq3 into xcode Removed signature from SDL dylib, enabled dark mode on macOS. spaces > tabs Ad-hoc signed libSDL2-2.0.0.dylib Fix compiling against SDL 2.0.17 UB2 now signs and notarizes, upgraded to SDL 2.0.16 Architectures in libSDL2 restored for ppc and i386 Merge remote-tracking branch 'upstream/main' into vs2019 Update SDL2 to 2.0.16 Added rudimentary support for automatically finding Microsoft Store version of Quake 3 GHA deprecated Ubuntu 16.04 - update to 18.04 qsort cannot be called with NULL Merge remote-tracking branch 'upstream/main' into vs2019 Addressed string concatenation issue and added dummy method for Mac/Linux Added missing variable. Merge remote-tracking branch 'upstream/main' into xcode Updated SDL 2.0.16 headers and Mac version of libraries to fix GitHub actions Addressed PR suggestions Modified MS Store path handling to better follow the pattern of Steam/GOG Merge pull request #481 from tomkidd/xcode Merge pull request #482 from tomkidd/vs2019 OpenGL2: Fix r_grayscale 1 making everything solid black Print full GL_EXTENSIONS list for OpenGL contexts before 3.0 Fix being unable to enter Team Arena CD key OpenGL2: GL_DEPTH_TEXTURE_MODE was removed from OpenGL 3.0/Core Improve setting Microsoft Store path Update building for macOS in README Make macOS arm64 default to target macOS 11 in Makefile Fix error when cross-compiling for macOS arm64 using Makefile Fix passing arguments to VM dylib on Apple M1 Fix compiling on older macOS Fix memory corruption in S_TransferPaintBuffer Fix memset Fix hex digit Fix uninitialized variable some old URL and doc updates Update README.md Update FUNDING.yml code/curl: update ifdef condition for MCST-LCC compiler in mcst-lcc compiler => 1.25 added a new macro definition to determine compiler Revert "code/curl: update ifdef condition for MCST-LCC compiler" Revert "E2K: fixed build by MCST lcc compiler when using USE_CURL=1 option" More predictable mesh normals generation vm_x86.c: Add `defined(_M_IX86) || defined(_M_X64)` (fix for VS2019) Add keys for SDL 2.0.14's new gamepad buttons Fix in_availableJoysticks cvar not updating Fix (disabled) Wavelet sound decompression Update to SDL 2.24.0 and add separate macOS UB2 dylib Update macOS UB1 to SDL 2.0.22 Fix running make-macosx{,-ub2}.sh on Linux Update MSVC .lib files to SDL 2.24.0
644 lines
24 KiB
C
644 lines
24 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2022 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute it
|
|
freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
claim that you wrote the original software. If you use this software
|
|
in a product, an acknowledgment in the product documentation would be
|
|
appreciated but is not required.
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
misrepresented as being the original software.
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_pixels.h
|
|
*
|
|
* Header for the enumerated pixel format definitions.
|
|
*/
|
|
|
|
#ifndef SDL_pixels_h_
|
|
#define SDL_pixels_h_
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_endian.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \name Transparency definitions
|
|
*
|
|
* These define alpha as the opacity of a surface.
|
|
*/
|
|
/* @{ */
|
|
#define SDL_ALPHA_OPAQUE 255
|
|
#define SDL_ALPHA_TRANSPARENT 0
|
|
/* @} */
|
|
|
|
/** Pixel type. */
|
|
typedef enum
|
|
{
|
|
SDL_PIXELTYPE_UNKNOWN,
|
|
SDL_PIXELTYPE_INDEX1,
|
|
SDL_PIXELTYPE_INDEX4,
|
|
SDL_PIXELTYPE_INDEX8,
|
|
SDL_PIXELTYPE_PACKED8,
|
|
SDL_PIXELTYPE_PACKED16,
|
|
SDL_PIXELTYPE_PACKED32,
|
|
SDL_PIXELTYPE_ARRAYU8,
|
|
SDL_PIXELTYPE_ARRAYU16,
|
|
SDL_PIXELTYPE_ARRAYU32,
|
|
SDL_PIXELTYPE_ARRAYF16,
|
|
SDL_PIXELTYPE_ARRAYF32
|
|
} SDL_PixelType;
|
|
|
|
/** Bitmap pixel order, high bit -> low bit. */
|
|
typedef enum
|
|
{
|
|
SDL_BITMAPORDER_NONE,
|
|
SDL_BITMAPORDER_4321,
|
|
SDL_BITMAPORDER_1234
|
|
} SDL_BitmapOrder;
|
|
|
|
/** Packed component order, high bit -> low bit. */
|
|
typedef enum
|
|
{
|
|
SDL_PACKEDORDER_NONE,
|
|
SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDORDER_RGBX,
|
|
SDL_PACKEDORDER_ARGB,
|
|
SDL_PACKEDORDER_RGBA,
|
|
SDL_PACKEDORDER_XBGR,
|
|
SDL_PACKEDORDER_BGRX,
|
|
SDL_PACKEDORDER_ABGR,
|
|
SDL_PACKEDORDER_BGRA
|
|
} SDL_PackedOrder;
|
|
|
|
/** Array component order, low byte -> high byte. */
|
|
/* !!! FIXME: in 2.1, make these not overlap differently with
|
|
!!! FIXME: SDL_PACKEDORDER_*, so we can simplify SDL_ISPIXELFORMAT_ALPHA */
|
|
typedef enum
|
|
{
|
|
SDL_ARRAYORDER_NONE,
|
|
SDL_ARRAYORDER_RGB,
|
|
SDL_ARRAYORDER_RGBA,
|
|
SDL_ARRAYORDER_ARGB,
|
|
SDL_ARRAYORDER_BGR,
|
|
SDL_ARRAYORDER_BGRA,
|
|
SDL_ARRAYORDER_ABGR
|
|
} SDL_ArrayOrder;
|
|
|
|
/** Packed component layout. */
|
|
typedef enum
|
|
{
|
|
SDL_PACKEDLAYOUT_NONE,
|
|
SDL_PACKEDLAYOUT_332,
|
|
SDL_PACKEDLAYOUT_4444,
|
|
SDL_PACKEDLAYOUT_1555,
|
|
SDL_PACKEDLAYOUT_5551,
|
|
SDL_PACKEDLAYOUT_565,
|
|
SDL_PACKEDLAYOUT_8888,
|
|
SDL_PACKEDLAYOUT_2101010,
|
|
SDL_PACKEDLAYOUT_1010102
|
|
} SDL_PackedLayout;
|
|
|
|
#define SDL_DEFINE_PIXELFOURCC(A, B, C, D) SDL_FOURCC(A, B, C, D)
|
|
|
|
#define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes) \
|
|
((1 << 28) | ((type) << 24) | ((order) << 20) | ((layout) << 16) | \
|
|
((bits) << 8) | ((bytes) << 0))
|
|
|
|
#define SDL_PIXELFLAG(X) (((X) >> 28) & 0x0F)
|
|
#define SDL_PIXELTYPE(X) (((X) >> 24) & 0x0F)
|
|
#define SDL_PIXELORDER(X) (((X) >> 20) & 0x0F)
|
|
#define SDL_PIXELLAYOUT(X) (((X) >> 16) & 0x0F)
|
|
#define SDL_BITSPERPIXEL(X) (((X) >> 8) & 0xFF)
|
|
#define SDL_BYTESPERPIXEL(X) \
|
|
(SDL_ISPIXELFORMAT_FOURCC(X) ? \
|
|
((((X) == SDL_PIXELFORMAT_YUY2) || \
|
|
((X) == SDL_PIXELFORMAT_UYVY) || \
|
|
((X) == SDL_PIXELFORMAT_YVYU)) ? 2 : 1) : (((X) >> 0) & 0xFF))
|
|
|
|
#define SDL_ISPIXELFORMAT_INDEXED(format) \
|
|
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
|
|
((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX1) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX4) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX8)))
|
|
|
|
#define SDL_ISPIXELFORMAT_PACKED(format) \
|
|
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
|
|
((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED8) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED16) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED32)))
|
|
|
|
#define SDL_ISPIXELFORMAT_ARRAY(format) \
|
|
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
|
|
((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU8) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU16) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU32) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYF16) || \
|
|
(SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYF32)))
|
|
|
|
#define SDL_ISPIXELFORMAT_ALPHA(format) \
|
|
((SDL_ISPIXELFORMAT_PACKED(format) && \
|
|
((SDL_PIXELORDER(format) == SDL_PACKEDORDER_ARGB) || \
|
|
(SDL_PIXELORDER(format) == SDL_PACKEDORDER_RGBA) || \
|
|
(SDL_PIXELORDER(format) == SDL_PACKEDORDER_ABGR) || \
|
|
(SDL_PIXELORDER(format) == SDL_PACKEDORDER_BGRA))) || \
|
|
(SDL_ISPIXELFORMAT_ARRAY(format) && \
|
|
((SDL_PIXELORDER(format) == SDL_ARRAYORDER_ARGB) || \
|
|
(SDL_PIXELORDER(format) == SDL_ARRAYORDER_RGBA) || \
|
|
(SDL_PIXELORDER(format) == SDL_ARRAYORDER_ABGR) || \
|
|
(SDL_PIXELORDER(format) == SDL_ARRAYORDER_BGRA))))
|
|
|
|
/* The flag is set to 1 because 0x1? is not in the printable ASCII range */
|
|
#define SDL_ISPIXELFORMAT_FOURCC(format) \
|
|
((format) && (SDL_PIXELFLAG(format) != 1))
|
|
|
|
/* Note: If you modify this list, update SDL_GetPixelFormatName() */
|
|
typedef enum
|
|
{
|
|
SDL_PIXELFORMAT_UNKNOWN,
|
|
SDL_PIXELFORMAT_INDEX1LSB =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_4321, 0,
|
|
1, 0),
|
|
SDL_PIXELFORMAT_INDEX1MSB =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_1234, 0,
|
|
1, 0),
|
|
SDL_PIXELFORMAT_INDEX4LSB =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_4321, 0,
|
|
4, 0),
|
|
SDL_PIXELFORMAT_INDEX4MSB =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_1234, 0,
|
|
4, 0),
|
|
SDL_PIXELFORMAT_INDEX8 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX8, 0, 0, 8, 1),
|
|
SDL_PIXELFORMAT_RGB332 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED8, SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDLAYOUT_332, 8, 1),
|
|
SDL_PIXELFORMAT_XRGB4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDLAYOUT_4444, 12, 2),
|
|
SDL_PIXELFORMAT_RGB444 = SDL_PIXELFORMAT_XRGB4444,
|
|
SDL_PIXELFORMAT_XBGR4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
|
|
SDL_PACKEDLAYOUT_4444, 12, 2),
|
|
SDL_PIXELFORMAT_BGR444 = SDL_PIXELFORMAT_XBGR4444,
|
|
SDL_PIXELFORMAT_XRGB1555 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDLAYOUT_1555, 15, 2),
|
|
SDL_PIXELFORMAT_RGB555 = SDL_PIXELFORMAT_XRGB1555,
|
|
SDL_PIXELFORMAT_XBGR1555 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
|
|
SDL_PACKEDLAYOUT_1555, 15, 2),
|
|
SDL_PIXELFORMAT_BGR555 = SDL_PIXELFORMAT_XBGR1555,
|
|
SDL_PIXELFORMAT_ARGB4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
|
|
SDL_PACKEDLAYOUT_4444, 16, 2),
|
|
SDL_PIXELFORMAT_RGBA4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
|
|
SDL_PACKEDLAYOUT_4444, 16, 2),
|
|
SDL_PIXELFORMAT_ABGR4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
|
|
SDL_PACKEDLAYOUT_4444, 16, 2),
|
|
SDL_PIXELFORMAT_BGRA4444 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
|
|
SDL_PACKEDLAYOUT_4444, 16, 2),
|
|
SDL_PIXELFORMAT_ARGB1555 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
|
|
SDL_PACKEDLAYOUT_1555, 16, 2),
|
|
SDL_PIXELFORMAT_RGBA5551 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
|
|
SDL_PACKEDLAYOUT_5551, 16, 2),
|
|
SDL_PIXELFORMAT_ABGR1555 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
|
|
SDL_PACKEDLAYOUT_1555, 16, 2),
|
|
SDL_PIXELFORMAT_BGRA5551 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
|
|
SDL_PACKEDLAYOUT_5551, 16, 2),
|
|
SDL_PIXELFORMAT_RGB565 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDLAYOUT_565, 16, 2),
|
|
SDL_PIXELFORMAT_BGR565 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
|
|
SDL_PACKEDLAYOUT_565, 16, 2),
|
|
SDL_PIXELFORMAT_RGB24 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_RGB, 0,
|
|
24, 3),
|
|
SDL_PIXELFORMAT_BGR24 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_BGR, 0,
|
|
24, 3),
|
|
SDL_PIXELFORMAT_XRGB8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XRGB,
|
|
SDL_PACKEDLAYOUT_8888, 24, 4),
|
|
SDL_PIXELFORMAT_RGB888 = SDL_PIXELFORMAT_XRGB8888,
|
|
SDL_PIXELFORMAT_RGBX8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBX,
|
|
SDL_PACKEDLAYOUT_8888, 24, 4),
|
|
SDL_PIXELFORMAT_XBGR8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XBGR,
|
|
SDL_PACKEDLAYOUT_8888, 24, 4),
|
|
SDL_PIXELFORMAT_BGR888 = SDL_PIXELFORMAT_XBGR8888,
|
|
SDL_PIXELFORMAT_BGRX8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRX,
|
|
SDL_PACKEDLAYOUT_8888, 24, 4),
|
|
SDL_PIXELFORMAT_ARGB8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
|
|
SDL_PACKEDLAYOUT_8888, 32, 4),
|
|
SDL_PIXELFORMAT_RGBA8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBA,
|
|
SDL_PACKEDLAYOUT_8888, 32, 4),
|
|
SDL_PIXELFORMAT_ABGR8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ABGR,
|
|
SDL_PACKEDLAYOUT_8888, 32, 4),
|
|
SDL_PIXELFORMAT_BGRA8888 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRA,
|
|
SDL_PACKEDLAYOUT_8888, 32, 4),
|
|
SDL_PIXELFORMAT_ARGB2101010 =
|
|
SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
|
|
SDL_PACKEDLAYOUT_2101010, 32, 4),
|
|
|
|
/* Aliases for RGBA byte arrays of color data, for the current platform */
|
|
#if SDL_BYTEORDER == SDL_BIG_ENDIAN
|
|
SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_RGBA8888,
|
|
SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_ARGB8888,
|
|
SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_BGRA8888,
|
|
SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_ABGR8888,
|
|
#else
|
|
SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_ABGR8888,
|
|
SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_BGRA8888,
|
|
SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_ARGB8888,
|
|
SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_RGBA8888,
|
|
#endif
|
|
|
|
SDL_PIXELFORMAT_YV12 = /**< Planar mode: Y + V + U (3 planes) */
|
|
SDL_DEFINE_PIXELFOURCC('Y', 'V', '1', '2'),
|
|
SDL_PIXELFORMAT_IYUV = /**< Planar mode: Y + U + V (3 planes) */
|
|
SDL_DEFINE_PIXELFOURCC('I', 'Y', 'U', 'V'),
|
|
SDL_PIXELFORMAT_YUY2 = /**< Packed mode: Y0+U0+Y1+V0 (1 plane) */
|
|
SDL_DEFINE_PIXELFOURCC('Y', 'U', 'Y', '2'),
|
|
SDL_PIXELFORMAT_UYVY = /**< Packed mode: U0+Y0+V0+Y1 (1 plane) */
|
|
SDL_DEFINE_PIXELFOURCC('U', 'Y', 'V', 'Y'),
|
|
SDL_PIXELFORMAT_YVYU = /**< Packed mode: Y0+V0+Y1+U0 (1 plane) */
|
|
SDL_DEFINE_PIXELFOURCC('Y', 'V', 'Y', 'U'),
|
|
SDL_PIXELFORMAT_NV12 = /**< Planar mode: Y + U/V interleaved (2 planes) */
|
|
SDL_DEFINE_PIXELFOURCC('N', 'V', '1', '2'),
|
|
SDL_PIXELFORMAT_NV21 = /**< Planar mode: Y + V/U interleaved (2 planes) */
|
|
SDL_DEFINE_PIXELFOURCC('N', 'V', '2', '1'),
|
|
SDL_PIXELFORMAT_EXTERNAL_OES = /**< Android video texture format */
|
|
SDL_DEFINE_PIXELFOURCC('O', 'E', 'S', ' ')
|
|
} SDL_PixelFormatEnum;
|
|
|
|
/**
|
|
* The bits of this structure can be directly reinterpreted as an integer-packed
|
|
* color which uses the SDL_PIXELFORMAT_RGBA32 format (SDL_PIXELFORMAT_ABGR8888
|
|
* on little-endian systems and SDL_PIXELFORMAT_RGBA8888 on big-endian systems).
|
|
*/
|
|
typedef struct SDL_Color
|
|
{
|
|
Uint8 r;
|
|
Uint8 g;
|
|
Uint8 b;
|
|
Uint8 a;
|
|
} SDL_Color;
|
|
#define SDL_Colour SDL_Color
|
|
|
|
typedef struct SDL_Palette
|
|
{
|
|
int ncolors;
|
|
SDL_Color *colors;
|
|
Uint32 version;
|
|
int refcount;
|
|
} SDL_Palette;
|
|
|
|
/**
|
|
* \note Everything in the pixel format structure is read-only.
|
|
*/
|
|
typedef struct SDL_PixelFormat
|
|
{
|
|
Uint32 format;
|
|
SDL_Palette *palette;
|
|
Uint8 BitsPerPixel;
|
|
Uint8 BytesPerPixel;
|
|
Uint8 padding[2];
|
|
Uint32 Rmask;
|
|
Uint32 Gmask;
|
|
Uint32 Bmask;
|
|
Uint32 Amask;
|
|
Uint8 Rloss;
|
|
Uint8 Gloss;
|
|
Uint8 Bloss;
|
|
Uint8 Aloss;
|
|
Uint8 Rshift;
|
|
Uint8 Gshift;
|
|
Uint8 Bshift;
|
|
Uint8 Ashift;
|
|
int refcount;
|
|
struct SDL_PixelFormat *next;
|
|
} SDL_PixelFormat;
|
|
|
|
/**
|
|
* Get the human readable name of a pixel format.
|
|
*
|
|
* \param format the pixel format to query
|
|
* \returns the human readable name of the specified pixel format or
|
|
* `SDL_PIXELFORMAT_UNKNOWN` if the format isn't recognized.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*/
|
|
extern DECLSPEC const char* SDLCALL SDL_GetPixelFormatName(Uint32 format);
|
|
|
|
/**
|
|
* Convert one of the enumerated pixel formats to a bpp value and RGBA masks.
|
|
*
|
|
* \param format one of the SDL_PixelFormatEnum values
|
|
* \param bpp a bits per pixel value; usually 15, 16, or 32
|
|
* \param Rmask a pointer filled in with the red mask for the format
|
|
* \param Gmask a pointer filled in with the green mask for the format
|
|
* \param Bmask a pointer filled in with the blue mask for the format
|
|
* \param Amask a pointer filled in with the alpha mask for the format
|
|
* \returns SDL_TRUE on success or SDL_FALSE if the conversion wasn't
|
|
* possible; call SDL_GetError() for more information.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_MasksToPixelFormatEnum
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_PixelFormatEnumToMasks(Uint32 format,
|
|
int *bpp,
|
|
Uint32 * Rmask,
|
|
Uint32 * Gmask,
|
|
Uint32 * Bmask,
|
|
Uint32 * Amask);
|
|
|
|
/**
|
|
* Convert a bpp value and RGBA masks to an enumerated pixel format.
|
|
*
|
|
* This will return `SDL_PIXELFORMAT_UNKNOWN` if the conversion wasn't
|
|
* possible.
|
|
*
|
|
* \param bpp a bits per pixel value; usually 15, 16, or 32
|
|
* \param Rmask the red mask for the format
|
|
* \param Gmask the green mask for the format
|
|
* \param Bmask the blue mask for the format
|
|
* \param Amask the alpha mask for the format
|
|
* \returns one of the SDL_PixelFormatEnum values
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_PixelFormatEnumToMasks
|
|
*/
|
|
extern DECLSPEC Uint32 SDLCALL SDL_MasksToPixelFormatEnum(int bpp,
|
|
Uint32 Rmask,
|
|
Uint32 Gmask,
|
|
Uint32 Bmask,
|
|
Uint32 Amask);
|
|
|
|
/**
|
|
* Create an SDL_PixelFormat structure corresponding to a pixel format.
|
|
*
|
|
* Returned structure may come from a shared global cache (i.e. not newly
|
|
* allocated), and hence should not be modified, especially the palette. Weird
|
|
* errors such as `Blit combination not supported` may occur.
|
|
*
|
|
* \param pixel_format one of the SDL_PixelFormatEnum values
|
|
* \returns the new SDL_PixelFormat structure or NULL on failure; call
|
|
* SDL_GetError() for more information.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_FreeFormat
|
|
*/
|
|
extern DECLSPEC SDL_PixelFormat * SDLCALL SDL_AllocFormat(Uint32 pixel_format);
|
|
|
|
/**
|
|
* Free an SDL_PixelFormat structure allocated by SDL_AllocFormat().
|
|
*
|
|
* \param format the SDL_PixelFormat structure to free
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_AllocFormat
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_FreeFormat(SDL_PixelFormat *format);
|
|
|
|
/**
|
|
* Create a palette structure with the specified number of color entries.
|
|
*
|
|
* The palette entries are initialized to white.
|
|
*
|
|
* \param ncolors represents the number of color entries in the color palette
|
|
* \returns a new SDL_Palette structure on success or NULL on failure (e.g. if
|
|
* there wasn't enough memory); call SDL_GetError() for more
|
|
* information.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_FreePalette
|
|
*/
|
|
extern DECLSPEC SDL_Palette *SDLCALL SDL_AllocPalette(int ncolors);
|
|
|
|
/**
|
|
* Set the palette for a pixel format structure.
|
|
*
|
|
* \param format the SDL_PixelFormat structure that will use the palette
|
|
* \param palette the SDL_Palette structure that will be used
|
|
* \returns 0 on success or a negative error code on failure; call
|
|
* SDL_GetError() for more information.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_AllocPalette
|
|
* \sa SDL_FreePalette
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_SetPixelFormatPalette(SDL_PixelFormat * format,
|
|
SDL_Palette *palette);
|
|
|
|
/**
|
|
* Set a range of colors in a palette.
|
|
*
|
|
* \param palette the SDL_Palette structure to modify
|
|
* \param colors an array of SDL_Color structures to copy into the palette
|
|
* \param firstcolor the index of the first palette entry to modify
|
|
* \param ncolors the number of entries to modify
|
|
* \returns 0 on success or a negative error code if not all of the colors
|
|
* could be set; call SDL_GetError() for more information.
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_AllocPalette
|
|
* \sa SDL_CreateRGBSurface
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_SetPaletteColors(SDL_Palette * palette,
|
|
const SDL_Color * colors,
|
|
int firstcolor, int ncolors);
|
|
|
|
/**
|
|
* Free a palette created with SDL_AllocPalette().
|
|
*
|
|
* \param palette the SDL_Palette structure to be freed
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_AllocPalette
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_FreePalette(SDL_Palette * palette);
|
|
|
|
/**
|
|
* Map an RGB triple to an opaque pixel value for a given pixel format.
|
|
*
|
|
* This function maps the RGB color value to the specified pixel format and
|
|
* returns the pixel value best approximating the given RGB color value for
|
|
* the given pixel format.
|
|
*
|
|
* If the format has a palette (8-bit) the index of the closest matching color
|
|
* in the palette will be returned.
|
|
*
|
|
* If the specified pixel format has an alpha component it will be returned as
|
|
* all 1 bits (fully opaque).
|
|
*
|
|
* If the pixel format bpp (color depth) is less than 32-bpp then the unused
|
|
* upper bits of the return value can safely be ignored (e.g., with a 16-bpp
|
|
* format the return value can be assigned to a Uint16, and similarly a Uint8
|
|
* for an 8-bpp format).
|
|
*
|
|
* \param format an SDL_PixelFormat structure describing the pixel format
|
|
* \param r the red component of the pixel in the range 0-255
|
|
* \param g the green component of the pixel in the range 0-255
|
|
* \param b the blue component of the pixel in the range 0-255
|
|
* \returns a pixel value
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_GetRGB
|
|
* \sa SDL_GetRGBA
|
|
* \sa SDL_MapRGBA
|
|
*/
|
|
extern DECLSPEC Uint32 SDLCALL SDL_MapRGB(const SDL_PixelFormat * format,
|
|
Uint8 r, Uint8 g, Uint8 b);
|
|
|
|
/**
|
|
* Map an RGBA quadruple to a pixel value for a given pixel format.
|
|
*
|
|
* This function maps the RGBA color value to the specified pixel format and
|
|
* returns the pixel value best approximating the given RGBA color value for
|
|
* the given pixel format.
|
|
*
|
|
* If the specified pixel format has no alpha component the alpha value will
|
|
* be ignored (as it will be in formats with a palette).
|
|
*
|
|
* If the format has a palette (8-bit) the index of the closest matching color
|
|
* in the palette will be returned.
|
|
*
|
|
* If the pixel format bpp (color depth) is less than 32-bpp then the unused
|
|
* upper bits of the return value can safely be ignored (e.g., with a 16-bpp
|
|
* format the return value can be assigned to a Uint16, and similarly a Uint8
|
|
* for an 8-bpp format).
|
|
*
|
|
* \param format an SDL_PixelFormat structure describing the format of the
|
|
* pixel
|
|
* \param r the red component of the pixel in the range 0-255
|
|
* \param g the green component of the pixel in the range 0-255
|
|
* \param b the blue component of the pixel in the range 0-255
|
|
* \param a the alpha component of the pixel in the range 0-255
|
|
* \returns a pixel value
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_GetRGB
|
|
* \sa SDL_GetRGBA
|
|
* \sa SDL_MapRGB
|
|
*/
|
|
extern DECLSPEC Uint32 SDLCALL SDL_MapRGBA(const SDL_PixelFormat * format,
|
|
Uint8 r, Uint8 g, Uint8 b,
|
|
Uint8 a);
|
|
|
|
/**
|
|
* Get RGB values from a pixel in the specified format.
|
|
*
|
|
* This function uses the entire 8-bit [0..255] range when converting color
|
|
* components from pixel formats with less than 8-bits per RGB component
|
|
* (e.g., a completely white pixel in 16-bit RGB565 format would return [0xff,
|
|
* 0xff, 0xff] not [0xf8, 0xfc, 0xf8]).
|
|
*
|
|
* \param pixel a pixel value
|
|
* \param format an SDL_PixelFormat structure describing the format of the
|
|
* pixel
|
|
* \param r a pointer filled in with the red component
|
|
* \param g a pointer filled in with the green component
|
|
* \param b a pointer filled in with the blue component
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_GetRGBA
|
|
* \sa SDL_MapRGB
|
|
* \sa SDL_MapRGBA
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_GetRGB(Uint32 pixel,
|
|
const SDL_PixelFormat * format,
|
|
Uint8 * r, Uint8 * g, Uint8 * b);
|
|
|
|
/**
|
|
* Get RGBA values from a pixel in the specified format.
|
|
*
|
|
* This function uses the entire 8-bit [0..255] range when converting color
|
|
* components from pixel formats with less than 8-bits per RGB component
|
|
* (e.g., a completely white pixel in 16-bit RGB565 format would return [0xff,
|
|
* 0xff, 0xff] not [0xf8, 0xfc, 0xf8]).
|
|
*
|
|
* If the surface has no alpha component, the alpha will be returned as 0xff
|
|
* (100% opaque).
|
|
*
|
|
* \param pixel a pixel value
|
|
* \param format an SDL_PixelFormat structure describing the format of the
|
|
* pixel
|
|
* \param r a pointer filled in with the red component
|
|
* \param g a pointer filled in with the green component
|
|
* \param b a pointer filled in with the blue component
|
|
* \param a a pointer filled in with the alpha component
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_GetRGB
|
|
* \sa SDL_MapRGB
|
|
* \sa SDL_MapRGBA
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_GetRGBA(Uint32 pixel,
|
|
const SDL_PixelFormat * format,
|
|
Uint8 * r, Uint8 * g, Uint8 * b,
|
|
Uint8 * a);
|
|
|
|
/**
|
|
* Calculate a 256 entry gamma ramp for a gamma value.
|
|
*
|
|
* \param gamma a gamma value where 0.0 is black and 1.0 is identity
|
|
* \param ramp an array of 256 values filled in with the gamma ramp
|
|
*
|
|
* \since This function is available since SDL 2.0.0.
|
|
*
|
|
* \sa SDL_SetWindowGammaRamp
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_CalculateGammaRamp(float gamma, Uint16 * ramp);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* SDL_pixels_h_ */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|