.TH "SDL_JoystickOpen" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" +
−
.SH "NAME"+
−
SDL_JoystickOpen\- Opens a joystick for use\&.+
−
.SH "SYNOPSIS"+
−
.PP+
−
\fB#include "SDL\&.h"+
−
.sp+
−
\fBSDL_Joystick *\fBSDL_JoystickOpen\fP\fR(\fBint index\fR);+
−
.SH "DESCRIPTION"+
−
.PP+
−
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\&.+
−
.SH "RETURN VALUE"+
−
.PP+
−
Returns a \fBSDL_Joystick\fR structure on success\&. \fBNULL\fR on failure\&.+
−
.SH "EXAMPLES"+
−
.PP+
−
.PP+
−
.nf+
−
\f(CWSDL_Joystick *joy;+
−
// Check for joystick+
−
if(SDL_NumJoysticks()>0){+
−
  // Open joystick+
−
  joy=SDL_JoystickOpen(0);+
−
  +
−
  if(joy)+
−
  {+
−
    printf("Opened Joystick 0+
−
");+
−
    printf("Name: %s+
−
", SDL_JoystickName(0));+
−
    printf("Number of Axes: %d+
−
", SDL_JoystickNumAxes(joy));+
−
    printf("Number of Buttons: %d+
−
", SDL_JoystickNumButtons(joy));+
−
    printf("Number of Balls: %d+
−
", SDL_JoystickNumBalls(joy));+
−
  }+
−
  else+
−
    printf("Couldn\&'t open Joystick 0+
−
");+
−
  +
−
  // Close if opened+
−
  if(SDL_JoystickOpened(0))+
−
    SDL_JoystickClose(joy);+
−
}\fR+
−
.fi+
−
.PP+
−
.SH "SEE ALSO"+
−
.PP+
−
\fI\fBSDL_JoystickClose\fP\fR+
−
...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00+
−