1<HTML 2><HEAD 3><TITLE 4>SDL_ConvertSurface</TITLE 5><META 6NAME="GENERATOR" 7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8"><LINK 9REL="HOME" 10TITLE="SDL Library Documentation" 11HREF="index.html"><LINK 12REL="UP" 13TITLE="Video" 14HREF="video.html"><LINK 15REL="PREVIOUS" 16TITLE="SDL_GetClipRect" 17HREF="sdlgetcliprect.html"><LINK 18REL="NEXT" 19TITLE="SDL_BlitSurface" 20HREF="sdlblitsurface.html"></HEAD 21><BODY 22CLASS="REFENTRY" 23BGCOLOR="#FFF8DC" 24TEXT="#000000" 25LINK="#0000ee" 26VLINK="#551a8b" 27ALINK="#ff0000" 28><DIV 29CLASS="NAVHEADER" 30><TABLE 31SUMMARY="Header navigation table" 32WIDTH="100%" 33BORDER="0" 34CELLPADDING="0" 35CELLSPACING="0" 36><TR 37><TH 38COLSPAN="3" 39ALIGN="center" 40>SDL Library Documentation</TH 41></TR 42><TR 43><TD 44WIDTH="10%" 45ALIGN="left" 46VALIGN="bottom" 47><A 48HREF="sdlgetcliprect.html" 49ACCESSKEY="P" 50>Prev</A 51></TD 52><TD 53WIDTH="80%" 54ALIGN="center" 55VALIGN="bottom" 56></TD 57><TD 58WIDTH="10%" 59ALIGN="right" 60VALIGN="bottom" 61><A 62HREF="sdlblitsurface.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLCONVERTSURFACE" 74></A 75>SDL_ConvertSurface</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN2258" 80></A 81><H2 82>Name</H2 83>SDL_ConvertSurface -- Converts a surface to the same format as another surface.</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN2261" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN2262" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL/SDL.h"</PRE 101><P 102><CODE 103><CODE 104CLASS="FUNCDEF" 105>SDL_Surface *<B 106CLASS="FSFUNC" 107>SDL_ConvertSurface</B 108></CODE 109>(SDL_Surface *src, SDL_PixelFormat *fmt, Uint32 flags);</CODE 110></P 111><P 112></P 113></DIV 114></DIV 115><DIV 116CLASS="REFSECT1" 117><A 118NAME="AEN2268" 119></A 120><H2 121>Description</H2 122><P 123>Creates a new surface of the specified format, and then copies and maps 124the given surface to it. If this function fails, it returns 125<TT 126CLASS="LITERAL" 127>NULL</TT 128>.</P 129><P 130>The <TT 131CLASS="PARAMETER" 132><I 133>flags</I 134></TT 135> parameter is passed to 136<A 137HREF="sdlcreatergbsurface.html" 138><TT 139CLASS="FUNCTION" 140>SDL_CreateRGBSurface</TT 141></A 142> 143and has those semantics.</P 144><P 145>This function is used internally by 146<A 147HREF="sdldisplayformat.html" 148><TT 149CLASS="FUNCTION" 150>SDL_DisplayFormat</TT 151></A 152>.</P 153><P 154>This function can only be called after SDL_Init.</P 155></DIV 156><DIV 157CLASS="REFSECT1" 158><A 159NAME="AEN2280" 160></A 161><H2 162>Return Value</H2 163><P 164>Returns either a pointer to the new surface, or 165<TT 166CLASS="LITERAL" 167>NULL</TT 168> on error.</P 169></DIV 170><DIV 171CLASS="REFSECT1" 172><A 173NAME="AEN2284" 174></A 175><H2 176>See Also</H2 177><P 178><A 179HREF="sdlcreatergbsurface.html" 180><TT 181CLASS="FUNCTION" 182>SDL_CreateRGBSurface</TT 183></A 184>, 185<A 186HREF="sdldisplayformat.html" 187><TT 188CLASS="FUNCTION" 189>SDL_DisplayFormat</TT 190></A 191>, 192<A 193HREF="sdlpixelformat.html" 194><SPAN 195CLASS="STRUCTNAME" 196>SDL_PixelFormat</SPAN 197></A 198>, 199<A 200HREF="sdlsurface.html" 201><SPAN 202CLASS="STRUCTNAME" 203>SDL_Surface</SPAN 204></A 205></P 206></DIV 207><DIV 208CLASS="NAVFOOTER" 209><HR 210ALIGN="LEFT" 211WIDTH="100%"><TABLE 212SUMMARY="Footer navigation table" 213WIDTH="100%" 214BORDER="0" 215CELLPADDING="0" 216CELLSPACING="0" 217><TR 218><TD 219WIDTH="33%" 220ALIGN="left" 221VALIGN="top" 222><A 223HREF="sdlgetcliprect.html" 224ACCESSKEY="P" 225>Prev</A 226></TD 227><TD 228WIDTH="34%" 229ALIGN="center" 230VALIGN="top" 231><A 232HREF="index.html" 233ACCESSKEY="H" 234>Home</A 235></TD 236><TD 237WIDTH="33%" 238ALIGN="right" 239VALIGN="top" 240><A 241HREF="sdlblitsurface.html" 242ACCESSKEY="N" 243>Next</A 244></TD 245></TR 246><TR 247><TD 248WIDTH="33%" 249ALIGN="left" 250VALIGN="top" 251>SDL_GetClipRect</TD 252><TD 253WIDTH="34%" 254ALIGN="center" 255VALIGN="top" 256><A 257HREF="video.html" 258ACCESSKEY="U" 259>Up</A 260></TD 261><TD 262WIDTH="33%" 263ALIGN="right" 264VALIGN="top" 265>SDL_BlitSurface</TD 266></TR 267></TABLE 268></DIV 269></BODY 270></HTML 271>