Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_CreateCursor.3 @ 4393:9afe12fb4c41 SDL-1.2
Fixed bug #901
Tim Angus 2009-12-11 11:45:46 PST
Disable mouse event generation when state is not SDL_APPMOUSEFOCUS
If a Windows SDL application is minimised by using alt-tab, SDL_APPMOUSEFOCUS
is lost as part of the minimisation. Unfortunately, the directx driver doesn't
pay any attention to this state when generating mouse button events, so
clicking on the Desktop can cause mouse clicks in the SDL application, while
it's still minimised. The attached patch fixes this. It looks much more
complicated than it actually is due to indentation; here it is ignoring
whitespace:
tma@abraxas:~/sources/SDL-1.2-svn$ svn diff -x -b
Index: src/video/windx5/SDL_dx5events.c
===================================================================
--- src/video/windx5/SDL_dx5events.c (revision 5376)
+++ src/video/windx5/SDL_dx5events.c (working copy)
@@ -374,10 +374,9 @@
if ( !(SDL_GetAppState() & SDL_APPMOUSEFOCUS) ) {
mouse_lost = 1;
ClipCursor(NULL);
- }
-
+ } else {
/* If the mouse was lost, regain some sense of mouse state */
- if ( mouse_lost && (SDL_GetAppState() & SDL_APPMOUSEFOCUS) ) {
+ if ( mouse_lost ) {
POINT mouse_pos;
Uint8 old_state;
Uint8 new_state;
@@ -548,6 +547,7 @@
if ( xrel || yrel ) {
post_mouse_motion(1, xrel, yrel);
}
+ }
}
/* The main Win32 event handler */
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Mon, 14 Dec 2009 22:41:31 +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_CreateCursor" "3" "Tue 11 Sep 2001, 23:01" "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_CreateCursor \- Creates a new mouse cursor\&. |
0 | 4 .SH "SYNOPSIS" |
5 .PP | |
6 \fB#include "SDL\&.h" | |
7 .sp | |
8 \fBSDL_Cursor *\fBSDL_CreateCursor\fP\fR(\fBUint8 *data, Uint8 *mask, int w, int h, int hot_x, int hot_y\fR); | |
9 .SH "DESCRIPTION" | |
10 .PP | |
11 Create a cursor using the specified \fBdata\fR and \fBmask\fR (in MSB format)\&. The cursor width must be a multiple of 8 bits\&. | |
12 .PP | |
13 The cursor is created in black and white according to the following: | |
14 .TP 20 | |
15 \fBData / Mask\fR | |
16 \fBResulting pixel on screen\fR | |
17 .TP 20 | |
18 0 / 1 | |
19 White | |
20 .TP 20 | |
21 1 / 1 | |
22 Black | |
23 .TP 20 | |
24 0 / 0 | |
25 Transparent | |
26 .TP 20 | |
27 1 / 0 | |
28 Inverted color if possible, black if not\&. | |
29 .PP | |
30 Cursors created with this function must be freed with \fISDL_FreeCursor\fR\&. | |
31 .SH "EXAMPLE" | |
32 .PP | |
33 .nf | |
34 \f(CW/* Stolen from the mailing list */ | |
35 /* Creates a new mouse cursor from an XPM */ | |
36 | |
37 | |
38 /* XPM */ | |
39 static const char *arrow[] = { | |
40 /* width height num_colors chars_per_pixel */ | |
41 " 32 32 3 1", | |
42 /* colors */ | |
43 "X c #000000", | |
44 "\&. c #ffffff", | |
45 " c None", | |
46 /* pixels */ | |
47 "X ", | |
48 "XX ", | |
49 "X\&.X ", | |
50 "X\&.\&.X ", | |
51 "X\&.\&.\&.X ", | |
52 "X\&.\&.\&.\&.X ", | |
53 "X\&.\&.\&.\&.\&.X ", | |
54 "X\&.\&.\&.\&.\&.\&.X ", | |
55 "X\&.\&.\&.\&.\&.\&.\&.X ", | |
56 "X\&.\&.\&.\&.\&.\&.\&.\&.X ", | |
57 "X\&.\&.\&.\&.\&.XXXXX ", | |
58 "X\&.\&.X\&.\&.X ", | |
59 "X\&.X X\&.\&.X ", | |
60 "XX X\&.\&.X ", | |
61 "X X\&.\&.X ", | |
62 " X\&.\&.X ", | |
63 " X\&.\&.X ", | |
64 " X\&.\&.X ", | |
65 " XX ", | |
66 " ", | |
67 " ", | |
68 " ", | |
69 " ", | |
70 " ", | |
71 " ", | |
72 " ", | |
73 " ", | |
74 " ", | |
75 " ", | |
76 " ", | |
77 " ", | |
78 " ", | |
79 "0,0" | |
80 }; | |
81 | |
82 static SDL_Cursor *init_system_cursor(const char *image[]) | |
83 { | |
84 int i, row, col; | |
85 Uint8 data[4*32]; | |
86 Uint8 mask[4*32]; | |
87 int hot_x, hot_y; | |
88 | |
89 i = -1; | |
90 for ( row=0; row<32; ++row ) { | |
91 for ( col=0; col<32; ++col ) { | |
92 if ( col % 8 ) { | |
93 data[i] <<= 1; | |
94 mask[i] <<= 1; | |
95 } else { | |
96 ++i; | |
97 data[i] = mask[i] = 0; | |
98 } | |
99 switch (image[4+row][col]) { | |
100 case \&'X\&': | |
101 data[i] |= 0x01; | |
102 k[i] |= 0x01; | |
103 break; | |
104 case \&'\&.\&': | |
105 mask[i] |= 0x01; | |
106 break; | |
107 case \&' \&': | |
108 break; | |
109 } | |
110 } | |
111 } | |
112 sscanf(image[4+row], "%d,%d", &hot_x, &hot_y); | |
113 return SDL_CreateCursor(data, mask, 32, 32, hot_x, hot_y); | |
114 }\fR | |
115 .fi | |
116 .PP | |
117 .SH "SEE ALSO" | |
118 .PP | |
119 \fI\fBSDL_FreeCursor\fP\fR, \fI\fBSDL_SetCursor\fP\fR, \fI\fBSDL_ShowCursor\fP\fR | |
4311
1238da4a7112
Debian patch: f230_manpages.diff
Sam Lantinga <slouken@libsdl.org>
parents:
4107
diff
changeset
|
120 .\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01 |