SysTutorials

Linux Manual Pages › Section 3

sdl_joystickopen(3)

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