mirror of
https://github.com/libsdl-org/SDL.git
synced 2026-02-17 00:54:06 +00:00
2ba76dbe80
SDL_Surface has been simplified and internal details are no longer in the public structure. The `format` member of SDL_Surface is now an enumerated pixel format value. You can get the full details of the pixel format by calling `SDL_GetPixelFormatDetails(surface->format)`. You can get the palette associated with the surface by calling SDL_GetSurfacePalette(). You can get the clip rectangle by calling SDL_GetSurfaceClipRect(). SDL_PixelFormat has been renamed SDL_PixelFormatDetails and just describes the pixel format, it does not include a palette for indexed pixel types. SDL_PixelFormatEnum has been renamed SDL_PixelFormat and is used instead of Uint32 for API functions that refer to pixel format by enumerated value. SDL_MapRGB(), SDL_MapRGBA(), SDL_GetRGB(), and SDL_GetRGBA() take an optional palette parameter for indexed color lookups.
81 lines
2.6 KiB
C
81 lines
2.6 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2024 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.
|
|
*/
|
|
#include "SDL_internal.h"
|
|
|
|
#ifndef SDL_surface_c_h_
|
|
#define SDL_surface_c_h_
|
|
|
|
/* Useful functions and variables from SDL_surface.c */
|
|
|
|
#include "../SDL_list.h"
|
|
|
|
/* Surface internal flags */
|
|
typedef Uint32 SDL_SurfaceDataFlags;
|
|
|
|
#define SDL_INTERNAL_SURFACE_DONTFREE 0x00000001u /**< Surface is referenced internally */
|
|
#define SDL_INTERNAL_SURFACE_STACK 0x00000002u /**< Surface is allocated on the stack */
|
|
#define SDL_INTERNAL_SURFACE_RLEACCEL 0x00000004u /**< Surface is RLE encoded */
|
|
|
|
/* Surface internal data definition */
|
|
struct SDL_SurfaceData
|
|
{
|
|
/** flags for this surface */
|
|
SDL_SurfaceDataFlags flags;
|
|
|
|
/** properties for this surface */
|
|
SDL_PropertiesID props;
|
|
|
|
/** detailed format for this surface */
|
|
const SDL_PixelFormatDetails *format;
|
|
|
|
/** palette for indexed surfaces */
|
|
SDL_Palette *palette;
|
|
|
|
/** information needed for surfaces requiring locks */
|
|
int locked;
|
|
|
|
/** clipping information */
|
|
SDL_Rect clip_rect;
|
|
|
|
/** info for fast blit mapping to other surfaces */
|
|
SDL_BlitMap map;
|
|
|
|
/** list of BlitMap that hold a reference to this surface */
|
|
SDL_ListNode *list_blitmap;
|
|
};
|
|
|
|
typedef struct SDL_InternalSurface
|
|
{
|
|
SDL_Surface surface;
|
|
SDL_SurfaceData internal;
|
|
|
|
} SDL_InternalSurface;
|
|
|
|
/* Surface functions */
|
|
extern SDL_bool SDL_SurfaceValid(SDL_Surface *surface);
|
|
extern void SDL_UpdateSurfaceLockFlag(SDL_Surface *surface);
|
|
extern float SDL_GetDefaultSDRWhitePoint(SDL_Colorspace colorspace);
|
|
extern float SDL_GetSurfaceSDRWhitePoint(SDL_Surface *surface, SDL_Colorspace colorspace);
|
|
extern float SDL_GetDefaultHDRHeadroom(SDL_Colorspace colorspace);
|
|
extern float SDL_GetSurfaceHDRHeadroom(SDL_Surface *surface, SDL_Colorspace colorspace);
|
|
|
|
#endif /* SDL_surface_c_h_ */
|