Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_keysym.3 @ 4391:07b330419439 SDL-1.2
Fixed bug #849 some more:
Tim Angus 2009-11-26 14:41:04 PST
Fix to the cursor not being responsive when the app doesn't have
SDL_APPINPUTFOCUS
The problems with the directx driver are similar to the ones I introduced in
the windib driver with r4478. Basically if the application did not have focus,
the mouse position is not updated. It's not really that the mouse cursor was
invisible, it's that it is stuck underneath another window where you can't see
it. This behaviour predates my r4478 changes and is the reason I unwittingly
broke the windib driver as I had been replicating the way the directx driver
deals with focus. Prior to r4478 the directx driver could not be used in
windowed mode, so the broken focusing would not have actually been observable.
Anyway, the attached patch makes the directx driver behaves like the windib
driver in terms of focus.
Time for 1.2.15? ;)
I've added an additional change of moving the calls to WIN_GrabInput that are
made on WM_ACTIVATE messages so that they only occur when the state is
SDL_APPINPUTFOCUS. When a fullscreen application is minimised using alt-tab, it
still receives WM_ACTIVATE messages when other applications are selected. If
WIN_GrabInput is called when the SDL application doesn't have input focus, bad
things happen; it shouldn't be being called at all.
I've also added a line to make sure that SDL_APPMOUSEFOCUS state is dropped
when the application is minimised following an alt-tab.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Fri, 11 Dec 2009 15:24:53 +0000 |
parents | 1238da4a7112 |
children |
rev | line source |
---|---|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
1 .TH "SDL_keysym" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" |
0 | 2 .SH "NAME" |
4107
4e3b250c950e
Erik Heckers fixed bug #493
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
3 SDL_keysym \- Keysym structure |
0 | 4 .SH "STRUCTURE DEFINITION" |
5 .PP | |
6 .nf | |
7 \f(CWtypedef struct{ | |
8 Uint8 scancode; | |
9 SDLKey sym; | |
10 SDLMod mod; | |
11 Uint16 unicode; | |
12 } SDL_keysym;\fR | |
13 .fi | |
14 .PP | |
15 .SH "STRUCTURE DATA" | |
16 .TP 20 | |
17 \fBscancode\fR | |
18 Hardware specific scancode | |
19 .TP 20 | |
20 \fBsym\fR | |
21 SDL virtual keysym | |
22 .TP 20 | |
23 \fBmod\fR | |
24 Current key modifiers | |
25 .TP 20 | |
26 \fBunicode\fR | |
27 Translated character | |
28 .SH "DESCRIPTION" | |
29 .PP | |
30 The \fBSDL_keysym\fR structure is used by reporting key presses and releases since it is a part of the \fI\fBSDL_KeyboardEvent\fR\fR\&. | |
31 .PP | |
32 The \fBscancode\fR field should generally be left alone, it is the hardware dependent scancode returned by the keyboard\&. The \fBsym\fR field is extremely useful\&. It is the SDL-defined value of the key (see \fISDL Key Syms\fR\&. This field is very useful when you are checking for certain key presses, like so: | |
33 .PP | |
34 .nf | |
35 \f(CW\&. | |
36 \&. | |
37 while(SDL_PollEvent(&event)){ | |
38 switch(event\&.type){ | |
39 case SDL_KEYDOWN: | |
40 if(event\&.key\&.keysym\&.sym==SDLK_LEFT) | |
41 move_left(); | |
42 break; | |
43 \&. | |
44 \&. | |
45 \&. | |
46 } | |
47 } | |
48 \&. | |
49 \&.\fR | |
50 .fi | |
51 .PP | |
52 \fBmod\fR stores the current state of the keyboard modifiers as explained in \fI\fBSDL_GetModState\fP\fR\&. The \fBunicode\fR is only used when UNICODE translation is enabled with \fI\fBSDL_EnableUNICODE\fP\fR\&. If \fBunicode\fR is non-zero then this a the UNICODE character corresponding to the keypress\&. If the high 9 bits of the character are 0, then this maps to the equivalent ASCII character: | |
53 .PP | |
54 .nf | |
55 \f(CWchar ch; | |
56 if ( (keysym\&.unicode & 0xFF80) == 0 ) { | |
57 ch = keysym\&.unicode & 0x7F; | |
58 } | |
59 else { | |
60 printf("An International Character\&. | |
61 "); | |
62 }\fR | |
63 .fi | |
64 .PP | |
65 UNICODE translation does have a slight overhead so don\&'t enable it unless its needed\&. | |
66 .SH "SEE ALSO" | |
67 .PP | |
68 \fI\fBSDLKey\fR\fR | |
4311
1238da4a7112
Debian patch: f230_manpages.diff
Sam Lantinga <slouken@libsdl.org>
parents:
4107
diff
changeset
|
69 .\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00 |