4 >SDL_DisplayFormat</TITLE
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK
14 HREF="video.html"><LINK
17 HREF="sdlfillrect.html"><LINK
19 TITLE="SDL_DisplayFormatAlpha"
20 HREF="sdldisplayformatalpha.html"></HEAD
31 SUMMARY="Header navigation table"
40 >SDL Library Documentation</TH
48 HREF="sdlfillrect.html"
62 HREF="sdldisplayformatalpha.html"
73 NAME="SDLDISPLAYFORMAT"
75 >SDL_DisplayFormat</H1
83 >SDL_DisplayFormat -- Convert a surface to the display format</DIV
85 CLASS="REFSYNOPSISDIV"
99 CLASS="FUNCSYNOPSISINFO"
100 >#include "SDL.h"</PRE
107 >SDL_DisplayFormat</B
109 >(SDL_Surface *surface);</CODE
123 >This function takes a surface and copies it to a new surface of the
124 pixel format and colors of the video framebuffer, suitable for fast
125 blitting onto the display surface. It calls
127 HREF="sdlconvertsurface.html"
128 >SDL_ConvertSurface</A
131 >If you want to take advantage of hardware colorkey or alpha blit
132 acceleration, you should set the colorkey and alpha value before
133 calling this function.</P
135 >If you want an alpha channel, see <A
136 HREF="sdldisplayformatalpha.html"
137 >SDL_DisplayFormatAlpha</A
148 >If the conversion fails or runs out of memory, it returns
163 HREF="sdlconvertsurface.html"
166 >SDL_ConvertSurface</TT
170 HREF="sdldisplayformatalpha.html"
173 >SDL_DisplayFormatAlpha</TT
177 HREF="sdlsetalpha.html"
184 HREF="sdlsetcolorkey.html"
191 HREF="sdlsurface.html"
203 SUMMARY="Footer navigation table"
214 HREF="sdlfillrect.html"
232 HREF="sdldisplayformatalpha.html"
256 >SDL_DisplayFormatAlpha</TD