#pragma section-numbers off
#pragma camelcase off

= SDL_ConvertSurfaceFormat =
Use this function to copy an existing surface to a new surface of the specified format.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
SDL_Surface* SDL_ConvertSurfaceFormat(SDL_Surface* src,
                                      Uint32       pixel_format,
                                      Uint32       flags)
}}}

== Function Parameters ==
||'''src'''||the [[SDL_Surface]] structure representing the surface to convert||
||'''pixel_format'''||one of the enumerated values in [[SDL_PixelFormatEnum]]; see [[#format|Remarks]] for details||
||'''flags'''||the flags are unused and should be set to 0||

== Return Value ==
Returns the new surface, or NULL on failure; call [[SDL_GetError]]() for more information.

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

== Remarks ==
<<Anchor(format)>> '''format''' may be one of the following:
<<Include(SDL_PixelFormatEnum, , , from="=== Pixel Format Values ===", to="== Code Examples ==")>>

== Related Functions ==
 .[[SDL_ConvertSurface]]

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