Mercurial > sdl-ios-xcode
annotate docs/html/sdldisplayformatalpha.html @ 4170:092c0bc69155 SDL-1.2
Fixed bug #618
Description From Tim Angus 2008-08-30 12:23:56 (-) [reply]
As we all know SDL 1.2 doesn't handle dead keys well since one key press
potentially equals two (or more) characters. For example, on many layouts,
keying <backquote>,<space> results in <no character>,<backquote><space>. Since
the unicode member of the SDL_keysym struct only has room for one character,
only one can be returned.
On Linux, the first character is returned. On Windows however, unless the exact
number of characters generated by the keypress is 1, nothing is returned. The
following patch addresses this inconsistency.
Updated patch which includes a further fix to the handling of the numpad when
numlock is on. This further fix is courtesy Amanieu d'Antras.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Mon, 13 Apr 2009 08:42:09 +0000 |
| parents | 355632dca928 |
| children |
| rev | line source |
|---|---|
| 0 | 1 <HTML |
| 2 ><HEAD | |
| 3 ><TITLE | |
| 4 >SDL_DisplayFormatAlpha</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_DisplayFormat" | |
| 17 HREF="sdldisplayformat.html"><LINK | |
| 18 REL="NEXT" | |
| 19 TITLE="SDL_WarpMouse" | |
| 20 HREF="sdlwarpmouse.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="sdldisplayformat.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="sdlwarpmouse.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="SDLDISPLAYFORMATALPHA" | |
|
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_DisplayFormatAlpha</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="AEN2432" |
| 0 | 80 ></A |
| 81 ><H2 | |
| 82 >Name</H2 | |
| 83 >SDL_DisplayFormatAlpha -- 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="AEN2435" |
| 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="AEN2436" |
| 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_DisplayFormatAlpha</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="AEN2442" |
| 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 plus an alpha channel, | |
| 125 suitable for fast 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 | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
134 ><P |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
135 >This function can be used to convert a colourkey to an alpha channel, |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
136 if the <TT |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
137 CLASS="LITERAL" |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
138 >SDL_SRCCOLORKEY</TT |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
139 > flag is set on the surface. |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
140 The generated surface will then be transparent (alpha=0) where the |
|
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
141 pixels match the colourkey, and opaque (alpha=255) elsewhere.</P |
| 0 | 142 ></DIV |
| 143 ><DIV | |
| 144 CLASS="REFSECT1" | |
| 145 ><A | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
146 NAME="AEN2449" |
| 0 | 147 ></A |
| 148 ><H2 | |
| 149 >Return Value</H2 | |
| 150 ><P | |
| 151 >If the conversion fails or runs out of memory, it returns | |
| 152 <SPAN | |
| 153 CLASS="RETURNVALUE" | |
| 154 >NULL</SPAN | |
| 155 ></P | |
| 156 ></DIV | |
| 157 ><DIV | |
| 158 CLASS="REFSECT1" | |
| 159 ><A | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
160 NAME="AEN2453" |
| 0 | 161 ></A |
| 162 ><H2 | |
| 163 >See Also</H2 | |
| 164 ><P | |
| 165 ><A | |
| 166 HREF="sdlconvertsurface.html" | |
| 167 >SDL_ConvertSurface</A | |
| 168 >, | |
| 169 <A | |
| 170 HREF="sdlsetalpha.html" | |
| 171 >SDL_SetAlpha</A | |
| 172 >, | |
| 173 <A | |
| 174 HREF="sdlsetcolorkey.html" | |
| 175 >SDL_SetColorKey</A | |
| 176 >, | |
| 177 <A | |
| 178 HREF="sdldisplayformat.html" | |
| 179 >SDL_DisplayFormat</A | |
| 180 >, | |
| 181 <A | |
| 182 HREF="sdlsurface.html" | |
| 183 >SDL_Surface</A | |
| 184 ></P | |
| 185 ></DIV | |
| 186 ><DIV | |
| 187 CLASS="NAVFOOTER" | |
| 188 ><HR | |
| 189 ALIGN="LEFT" | |
| 190 WIDTH="100%"><TABLE | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
191 SUMMARY="Footer navigation table" |
| 0 | 192 WIDTH="100%" |
| 193 BORDER="0" | |
| 194 CELLPADDING="0" | |
| 195 CELLSPACING="0" | |
| 196 ><TR | |
| 197 ><TD | |
| 198 WIDTH="33%" | |
| 199 ALIGN="left" | |
| 200 VALIGN="top" | |
| 201 ><A | |
| 202 HREF="sdldisplayformat.html" | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
203 ACCESSKEY="P" |
| 0 | 204 >Prev</A |
| 205 ></TD | |
| 206 ><TD | |
| 207 WIDTH="34%" | |
| 208 ALIGN="center" | |
| 209 VALIGN="top" | |
| 210 ><A | |
| 211 HREF="index.html" | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
212 ACCESSKEY="H" |
| 0 | 213 >Home</A |
| 214 ></TD | |
| 215 ><TD | |
| 216 WIDTH="33%" | |
| 217 ALIGN="right" | |
| 218 VALIGN="top" | |
| 219 ><A | |
| 220 HREF="sdlwarpmouse.html" | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
221 ACCESSKEY="N" |
| 0 | 222 >Next</A |
| 223 ></TD | |
| 224 ></TR | |
| 225 ><TR | |
| 226 ><TD | |
| 227 WIDTH="33%" | |
| 228 ALIGN="left" | |
| 229 VALIGN="top" | |
| 230 >SDL_DisplayFormat</TD | |
| 231 ><TD | |
| 232 WIDTH="34%" | |
| 233 ALIGN="center" | |
| 234 VALIGN="top" | |
| 235 ><A | |
| 236 HREF="video.html" | |
|
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
237 ACCESSKEY="U" |
| 0 | 238 >Up</A |
| 239 ></TD | |
| 240 ><TD | |
| 241 WIDTH="33%" | |
| 242 ALIGN="right" | |
| 243 VALIGN="top" | |
| 244 >SDL_WarpMouse</TD | |
| 245 ></TR | |
| 246 ></TABLE | |
| 247 ></DIV | |
| 248 ></BODY | |
| 249 ></HTML | |
| 250 > |