Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_JoystickOpen.3 @ 816:428f688f2ad2
Date: Fri, 13 Feb 2004 17:03:16 +0100
From: Max Horn
Subject: Modifier key fix
The internal modifier state can get out of sync with reality. To
trigger this, do for example this:
1) Launch an SDL app
2) Alt-click on the desktop (this will hide the SDL app).
3) Bring the SDL app back to the front
4) SDL will still think alt is pressed (and as such will treat left
clicks like middle clicks). If you press and release alt, it'll be fine
again.
The attached patch cures this by rechecking the modifier state whenever
we process an event.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Fri, 13 Feb 2004 17:57:16 +0000 |
| parents | e5bc29de3f0a |
| children | 546f7c1eb755 |
| rev | line source |
|---|---|
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
1 .TH "SDL_JoystickOpen" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" |
| 0 | 2 .SH "NAME" |
| 3 SDL_JoystickOpen\- Opens a joystick for use\&. | |
| 4 .SH "SYNOPSIS" | |
| 5 .PP | |
| 6 \fB#include "SDL\&.h" | |
| 7 .sp | |
| 8 \fBSDL_Joystick *\fBSDL_JoystickOpen\fP\fR(\fBint index\fR); | |
| 9 .SH "DESCRIPTION" | |
| 10 .PP | |
| 11 Opens a joystick for use within SDL\&. The \fBindex\fR refers to the N\&'th joystick in the system\&. A joystick must be opened before it game be used\&. | |
| 12 .SH "RETURN VALUE" | |
| 13 .PP | |
| 14 Returns a \fBSDL_Joystick\fR structure on success\&. \fBNULL\fR on failure\&. | |
| 15 .SH "EXAMPLES" | |
| 16 .PP | |
| 17 .PP | |
| 18 .nf | |
| 19 \f(CWSDL_Joystick *joy; | |
| 20 // Check for joystick | |
| 21 if(SDL_NumJoysticks()>0){ | |
| 22 // Open joystick | |
| 23 joy=SDL_JoystickOpen(0); | |
| 24 | |
| 25 if(joy) | |
| 26 { | |
| 27 printf("Opened Joystick 0 | |
| 28 "); | |
| 29 printf("Name: %s | |
| 30 ", SDL_JoystickName(0)); | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
31 printf("Number of Axes: %d |
| 0 | 32 ", SDL_JoystickNumAxes(joy)); |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
33 printf("Number of Buttons: %d |
| 0 | 34 ", SDL_JoystickNumButtons(joy)); |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
35 printf("Number of Balls: %d |
| 0 | 36 ", SDL_JoystickNumBalls(joy)); |
| 37 } | |
| 38 else | |
| 39 printf("Couldn\&'t open Joystick 0 | |
| 40 "); | |
| 41 | |
| 42 // Close if opened | |
| 43 if(SDL_JoystickOpened(0)) | |
| 44 SDL_JoystickClose(joy); | |
| 45 }\fR | |
| 46 .fi | |
| 47 .PP | |
| 48 .SH "SEE ALSO" | |
| 49 .PP | |
| 50 \fI\fBSDL_JoystickClose\fP\fR | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
51 ...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00 |