Mercurial > sdl-ios-xcode
annotate docs/html/sdldisplayformat.html @ 1614:6162b8d921ce
Date: Wed, 29 Mar 2006 17:26:55 +0200 CEST
From: "Fran���is Revol"
Subject: [SDL] BeOS port fix: PrintScreen key crashing
It seems the latest SDL crashes when someone hits the PrtScrn key in
ZETA (BeOS R6), somewhere it gets a negative value as key code (or a
big unsigned maybe ?), and uses it as an index in the keysym table...
I'll investigate the cause for the negative value, but it's always
better to check for bounds correctly when indexing a table. The
attached diff fixes it.
Fran���is Revol
--
Software Architect
yellowTAB GmbH
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Fri, 31 Mar 2006 06:16:20 +0000 |
parents | 355632dca928 |
children |
rev | line source |
---|---|
0 | 1 <HTML |
2 ><HEAD | |
3 ><TITLE | |
4 >SDL_DisplayFormat</TITLE | |
5 ><META | |
6 NAME="GENERATOR" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
0 | 8 "><LINK |
9 REL="HOME" | |
10 TITLE="SDL Library Documentation" | |
11 HREF="index.html"><LINK | |
12 REL="UP" | |
13 TITLE="Video" | |
14 HREF="video.html"><LINK | |
15 REL="PREVIOUS" | |
16 TITLE="SDL_FillRect" | |
17 HREF="sdlfillrect.html"><LINK | |
18 REL="NEXT" | |
19 TITLE="SDL_DisplayFormatAlpha" | |
20 HREF="sdldisplayformatalpha.html"></HEAD | |
21 ><BODY | |
22 CLASS="REFENTRY" | |
23 BGCOLOR="#FFF8DC" | |
24 TEXT="#000000" | |
25 LINK="#0000ee" | |
26 VLINK="#551a8b" | |
27 ALINK="#ff0000" | |
28 ><DIV | |
29 CLASS="NAVHEADER" | |
30 ><TABLE | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
31 SUMMARY="Header navigation table" |
0 | 32 WIDTH="100%" |
33 BORDER="0" | |
34 CELLPADDING="0" | |
35 CELLSPACING="0" | |
36 ><TR | |
37 ><TH | |
38 COLSPAN="3" | |
39 ALIGN="center" | |
40 >SDL Library Documentation</TH | |
41 ></TR | |
42 ><TR | |
43 ><TD | |
44 WIDTH="10%" | |
45 ALIGN="left" | |
46 VALIGN="bottom" | |
47 ><A | |
48 HREF="sdlfillrect.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
49 ACCESSKEY="P" |
0 | 50 >Prev</A |
51 ></TD | |
52 ><TD | |
53 WIDTH="80%" | |
54 ALIGN="center" | |
55 VALIGN="bottom" | |
56 ></TD | |
57 ><TD | |
58 WIDTH="10%" | |
59 ALIGN="right" | |
60 VALIGN="bottom" | |
61 ><A | |
62 HREF="sdldisplayformatalpha.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
63 ACCESSKEY="N" |
0 | 64 >Next</A |
65 ></TD | |
66 ></TR | |
67 ></TABLE | |
68 ><HR | |
69 ALIGN="LEFT" | |
70 WIDTH="100%"></DIV | |
71 ><H1 | |
72 ><A | |
73 NAME="SDLDISPLAYFORMAT" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
74 ></A |
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
75 >SDL_DisplayFormat</H1 |
0 | 76 ><DIV |
77 CLASS="REFNAMEDIV" | |
78 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
79 NAME="AEN2394" |
0 | 80 ></A |
81 ><H2 | |
82 >Name</H2 | |
83 >SDL_DisplayFormat -- Convert a surface to the display format</DIV | |
84 ><DIV | |
85 CLASS="REFSYNOPSISDIV" | |
86 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
87 NAME="AEN2397" |
0 | 88 ></A |
89 ><H2 | |
90 >Synopsis</H2 | |
91 ><DIV | |
92 CLASS="FUNCSYNOPSIS" | |
93 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
94 NAME="AEN2398" |
0 | 95 ></A |
96 ><P | |
97 ></P | |
98 ><PRE | |
99 CLASS="FUNCSYNOPSISINFO" | |
100 >#include "SDL.h"</PRE | |
101 ><P | |
102 ><CODE | |
103 ><CODE | |
104 CLASS="FUNCDEF" | |
105 >SDL_Surface *<B | |
106 CLASS="FSFUNC" | |
107 >SDL_DisplayFormat</B | |
108 ></CODE | |
109 >(SDL_Surface *surface);</CODE | |
110 ></P | |
111 ><P | |
112 ></P | |
113 ></DIV | |
114 ></DIV | |
115 ><DIV | |
116 CLASS="REFSECT1" | |
117 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
118 NAME="AEN2404" |
0 | 119 ></A |
120 ><H2 | |
121 >Description</H2 | |
122 ><P | |
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 | |
126 <A | |
127 HREF="sdlconvertsurface.html" | |
128 >SDL_ConvertSurface</A | |
129 ></P | |
130 ><P | |
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 | |
134 ><P | |
135 >If you want an alpha channel, see <A | |
136 HREF="sdldisplayformatalpha.html" | |
137 >SDL_DisplayFormatAlpha</A | |
138 >.</P | |
139 ></DIV | |
140 ><DIV | |
141 CLASS="REFSECT1" | |
142 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
143 NAME="AEN2411" |
0 | 144 ></A |
145 ><H2 | |
146 >Return Value</H2 | |
147 ><P | |
148 >If the conversion fails or runs out of memory, it returns | |
149 <SPAN | |
150 CLASS="RETURNVALUE" | |
151 >NULL</SPAN | |
152 ></P | |
153 ></DIV | |
154 ><DIV | |
155 CLASS="REFSECT1" | |
156 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
157 NAME="AEN2415" |
0 | 158 ></A |
159 ><H2 | |
160 >See Also</H2 | |
161 ><P | |
162 ><A | |
163 HREF="sdlconvertsurface.html" | |
164 ><TT | |
165 CLASS="FUNCTION" | |
166 >SDL_ConvertSurface</TT | |
167 ></A | |
168 >, | |
169 <A | |
170 HREF="sdldisplayformatalpha.html" | |
171 ><TT | |
172 CLASS="FUNCTION" | |
173 >SDL_DisplayFormatAlpha</TT | |
174 ></A | |
175 > | |
176 <A | |
177 HREF="sdlsetalpha.html" | |
178 ><TT | |
179 CLASS="FUNCTION" | |
180 >SDL_SetAlpha</TT | |
181 ></A | |
182 >, | |
183 <A | |
184 HREF="sdlsetcolorkey.html" | |
185 ><TT | |
186 CLASS="FUNCTION" | |
187 >SDL_SetColorKey</TT | |
188 ></A | |
189 >, | |
190 <A | |
191 HREF="sdlsurface.html" | |
192 ><SPAN | |
193 CLASS="STRUCTNAME" | |
194 >SDL_Surface</SPAN | |
195 ></A | |
196 ></P | |
197 ></DIV | |
198 ><DIV | |
199 CLASS="NAVFOOTER" | |
200 ><HR | |
201 ALIGN="LEFT" | |
202 WIDTH="100%"><TABLE | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
203 SUMMARY="Footer navigation table" |
0 | 204 WIDTH="100%" |
205 BORDER="0" | |
206 CELLPADDING="0" | |
207 CELLSPACING="0" | |
208 ><TR | |
209 ><TD | |
210 WIDTH="33%" | |
211 ALIGN="left" | |
212 VALIGN="top" | |
213 ><A | |
214 HREF="sdlfillrect.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
215 ACCESSKEY="P" |
0 | 216 >Prev</A |
217 ></TD | |
218 ><TD | |
219 WIDTH="34%" | |
220 ALIGN="center" | |
221 VALIGN="top" | |
222 ><A | |
223 HREF="index.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
224 ACCESSKEY="H" |
0 | 225 >Home</A |
226 ></TD | |
227 ><TD | |
228 WIDTH="33%" | |
229 ALIGN="right" | |
230 VALIGN="top" | |
231 ><A | |
232 HREF="sdldisplayformatalpha.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
233 ACCESSKEY="N" |
0 | 234 >Next</A |
235 ></TD | |
236 ></TR | |
237 ><TR | |
238 ><TD | |
239 WIDTH="33%" | |
240 ALIGN="left" | |
241 VALIGN="top" | |
242 >SDL_FillRect</TD | |
243 ><TD | |
244 WIDTH="34%" | |
245 ALIGN="center" | |
246 VALIGN="top" | |
247 ><A | |
248 HREF="video.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
249 ACCESSKEY="U" |
0 | 250 >Up</A |
251 ></TD | |
252 ><TD | |
253 WIDTH="33%" | |
254 ALIGN="right" | |
255 VALIGN="top" | |
256 >SDL_DisplayFormatAlpha</TD | |
257 ></TR | |
258 ></TABLE | |
259 ></DIV | |
260 ></BODY | |
261 ></HTML | |
262 > |