SDL_JoystickOpen(3)						 SDL API Reference					       SDL_JoystickOpen(3)

NAME

       SDL_JoystickOpen- Opens a joystick for use.

SYNOPSIS

       #include "SDL.h"

       SDL_Joystick *SDL_JoystickOpen(int index);

DESCRIPTION

       Opens a joystick for use within SDL. The index refers to the N'th joystick in the system. A joystick must be opened before it game be used.

RETURN VALUE

       Returns a SDL_Joystick structure on success. NULL on failure.

EXAMPLES

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

SEE ALSO

       SDL_JoystickClose

SDL
							      Tue 11 Sep 2001, 23:00					       SDL_JoystickOpen(3)