(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_ClearSurface

Clear a surface with a specific color, with floating point precision.

Header File

Defined in <SDL3/SDL_surface.h>

Syntax

SDL_bool SDL_ClearSurface(SDL_Surface *surface, float r, float g, float b, float a);

Function Parameters

SDL_Surface *	surface	the SDL_Surface to clear.
float	r	the red component of the pixel, normally in the range 0-1.
float	g	the green component of the pixel, normally in the range 0-1.
float	b	the blue component of the pixel, normally in the range 0-1.
float	a	the alpha component of the pixel, normally in the range 0-1.

Return Value

(SDL_bool) Returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information.

Remarks

This function handles all surface formats, and ignores any clip rectangle.

If the surface is YUV, the color is assumed to be in the sRGB colorspace, otherwise the color is assumed to be in the colorspace of the suface.

Version

This function is available since SDL 3.0.0.

---

CategoryAPI, CategoryAPIFunction, CategorySurface

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.