SDL_JoystickOpen

Langue: en

Version: 45530 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

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