Wiki Page Content

SDL_GetPixelFormatName

Use this function to get the human readable name of a pixel format.

Syntax

const char* SDL_GetPixelFormatName(Uint32 format)

Function Parameters

format

the pixel format to query

Return Value

Returns the human readable name of the specified pixel format or "SDL_PIXELFORMAT_UNKNOWN" if the format isn't recognized.

Code Examples

SDL_Surface* surface = ...; // a valid surface from wherever.
SDL_PixelFormat* pixelFormat = surface->format;
Uint32 pixelFormatEnum = pixelFormat->format;
const char* surfacePixelFormatName = SDL_GetPixelFormatName(pixelFormatEnum);
SDL_Log("The surface's pixelformat is %s", surfacePixelFormatName);
// prints something like "The surface's pixelformat is SDL_PIXELFORMAT_ABGR8888"

Remarks

You can add useful comments here

Version

This function is available since SDL 2.0.0.


CategoryAPI, CategoryPixels

None: SDL_GetPixelFormatName (last edited 2016-10-20 20:48:44 by PhilippWiesemann)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit