###### (This is the documentation for SDL3, which is the current stable version. [SDL2](https://wiki.libsdl.org/SDL2/) was the previous version!) # SDL_WriteSurfacePixelFloat Writes a single pixel to a surface. ## Header File Defined in [](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_surface.h) ## Syntax ```c bool SDL_WriteSurfacePixelFloat(SDL_Surface *surface, int x, int y, float r, float g, float b, float a); ``` ## Function Parameters | | | | | ---------------------------- | ----------- | --------------------------------------------------- | | [SDL_Surface](SDL_Surface) * | **surface** | the surface to write. | | int | **x** | the horizontal coordinate, 0 <= x < width. | | int | **y** | the vertical coordinate, 0 <= y < height. | | float | **r** | the red channel value, normally in the range 0-1. | | float | **g** | the green channel value, normally in the range 0-1. | | float | **b** | the blue channel value, normally in the range 0-1. | | float | **a** | the alpha channel value, normally in the range 0-1. | ## Return Value (bool) Returns true on success or false on failure; call [SDL_GetError](SDL_GetError)() for more information. ## Remarks This function prioritizes correctness over speed: it is suitable for unit tests, but is not intended for use in a game engine. ## Version This function is available since SDL 3.0.0. ---- [CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategorySurface](CategorySurface)