SDL_JoystickOpen - Man Page

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

Referenced By

SDL_JoystickClose(3), SDL_JoystickIndex(3), SDL_JoystickName(3), SDL_JoystickNumAxes(3), SDL_JoystickNumBalls(3), SDL_JoystickNumButtons(3), SDL_JoystickNumHats(3), SDL_JoystickOpened(3), SDL_NumJoysticks(3).

Tue 11 Sep 2001, 23:00 SDL API Reference