1 .TH "SDL_JoystickOpen" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" 

     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));

    31     printf("Number of Axes: %d

    32 ", SDL_JoystickNumAxes(joy));

    33     printf("Number of Buttons: %d

    34 ", SDL_JoystickNumButtons(joy));

    35     printf("Number of Balls: %d

    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

    51 ...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00