(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_SetSurfaceRLE

Set the RLE acceleration hint for a surface.

Header File

Defined in <SDL3/SDL_surface.h>

Syntax

bool SDL_SetSurfaceRLE(SDL_Surface *surface, bool enabled);

Function Parameters

SDL_Surface *	surface	the SDL_Surface structure to optimize.
bool	enabled	true to enable RLE acceleration, false to disable it.

Return Value

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

Remarks

If RLE is enabled, color key and alpha blending blits are much faster, but the surface must be locked before directly accessing the pixels.

Version

This function is available since SDL 3.1.3.

See Also

• SDL_BlitSurface
• SDL_LockSurface
• SDL_UnlockSurface

---

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.