Manpages - SDL_JoystickOpen.3

Table of Contents

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

Author: dt

Created: 2022-02-20 Sun 19:43