SDL_SetSurfaceColorKey - Man Page

Set the color key (transparent pixel) in a surface.

Synopsis

#include <SDL3/SDL_surface.h>

bool SDL_SetSurfaceColorKey(SDL_Surface *surface, bool enabled, Uint32 key);

Description

The color key defines a pixel value that will be treated as transparent in a blit. For example, one can use this to specify that cyan pixels should be considered transparent, and therefore not rendered.

It is a pixel of the format used by the surface, as generated by SDL_MapRGB().

Function Parameters

surface

the SDL_Surface structure to update.

enabled

true to enable color key, false to disable color key.

key

the transparent pixel.

Return Value

for more information.

Thread Safety

This function is not thread safe.

Availability

This function is available since SDL 3.2.0.

See Also

SDL_GetSurfaceColorKey(3), SDL_SetSurfaceRLE(3), SDL_SurfaceHasColorKey(3)

Referenced By

SDL_GetSurfaceColorKey(3), SDL_SurfaceHasColorKey(3).

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS