Function Parameters

the flags are unused and should be set to 0; this is a leftover from SDL 1.2's API

Return Value

Returns the new SDL_Surface structure that is created or NULL if it fails; call SDL_GetError() for more information.

Code Examples

Youcanaddyourcodeexamplehere

Remarks

This function is used to optimize images for faster repeat blitting. This is accomplished by converting the original and storing the result as a new surface. The new, optimized surface can then be used as the source for future blits, making them faster.