Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_JoystickOpen.3 @ 3896:1a327643e741 SDL-1.2
X11 backend: tell app that mouse focus has been obtained when grabbing the
input. This allows us to enable DGA mode, even when the system cursor was
outside of the window when the grab was initiated.
Fixes Bugzilla #299, which has a more detailed explanation of the issue.
| author | Ryan C. Gordon <icculus@icculus.org> |
|---|---|
| date | Mon, 13 Nov 2006 03:58:22 +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 |