#pragma section-numbers off
#pragma disable-camelcase

= SDL_SetSurfaceRLE =
Use this function to set the RLE acceleration hint for a surface.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_SetSurfaceRLE(SDL_Surface* surface,
                      int          flag)
}}}

== Function Parameters ==
||'''surface'''||the [[SDL_Surface]] structure to optimize||
||'''flag'''||0 to disable, non-zero to enable RLE acceleration||

== Return Value ==
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.

== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

== 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. 

== Related Functions ==
 .[[SDL_BlitSurface]]
 .[[SDL_LockSurface]]
 .[[SDL_UnlockSurface]]

----
[[CategoryAPI]], [[CategorySurface]]