sdl_joystick

### Header File

The header file may include additional information sdl_joystick.hrl

### Exports

numJoysticks()

Args: none
Returns: Number of joysticks
C-API: int SDL_NumJoysticks(void);
Desc:
Count the number of joysticks attached to the system

name(Index)

Args: JoystickIndex
Returns: Name (List)
C-API: char *SDL_JoystickName(int device_index);
Desc:
Get the implementation dependent name of a joystick. This can be called before any joysticks are opened. If no name can be found, this function returns NULL.

open(Index)

Args: JoystickIndex
Returns: Joystick or exits
C-API: SDL_Joystick *SDL_JoystickOpen(int device_index);
Desc:
Open a joystick for use - the index passed as an argument refers to the N'th joystick on the system. This index is the value which will identify this joystick in future joystick events. This function returns a joystick identifier, or NULL if an error occurred.

opened(Index)

Args: JoystickIndex
Returns: true or false
C-API: int SDL_JoystickOpened(int device_index);
Desc:
Returns true if the joystick has been opened, or false if it has not.

index(Joystick)

Args: Joystick
Returns: index
C-API: int SDL_JoystickIndex(SDL_Joystick *joystick);
Desc:
Get the device index of an opened joystick.

numAxes(Joystick)

Args: Joystick
Returns: no of axes
C-API: int SDL_JoystickNumAxes(SDL_Joystick *joystick);
Desc:
Get the number of general axis controls on a joystick

numBalls(Joystick)

Args: Joystick
Returns: no of balls
C-API: int SDL_JoystickNumBalls(SDL_Joystick *joystick);
Desc:
Get the number of trackballs on a joystick Joystick trackballs have only relative motion events associated with them and their state cannot be polled.

numHats(Joystick)

Args: Joystick
Returns: no of Hats
C-API: int SDL_JoystickNumHats(SDL_Joystick *joystick);
Desc:
Get the number of POV hats on a joystick

numButtons(Joystick)

Args: Joystick
Returns: no of Buttons
C-API: int SDL_JoystickNumButtons(SDL_Joystick *joystick);
Desc:
Get the number of buttons on a joystick

update()

Args: none
Returns: none
C-API: void SDL_JoystickUpdate(void);
Desc:
Update the current state of the open joysticks. This is called automatically by the event loop if any joystick events are enabled.

eventState(State)

Args: State
Returns: NewState
C-API: int SDL_JoystickEventState(int state);
Desc:
Enable/disable joystick event polling. If joystick events are disabled, you must call SDL_JoystickUpdate() yourself and check the state of the joystick when you want joystick information. The state can be one of SDL_QUERY, SDL_ENABLE or SDL_IGNORE.

getAxis(Joystick, Axis)

Args: Joystick, Axis
Returns: State (Int range: -32768 to 32767)
C-API: Sint16 SDL_JoystickGetAxis(SDL_Joystick *joystick, int axis);
Desc:
Get the current state of an axis control on a joystick The state is a value ranging from -32768 to 32767. The axis indices start at index 0.

getHat(Joystick, Hat)

Args: Joystick, Hat
Returns: HatState
C-API: Uint8 SDL_JoystickGetHat(SDL_Joystick *joystick, int hat);
Desc:
Get the current state of a POV hat on a joystick The return value is one of the following positions in sdl_joystick.hrl The hat indices start at index 0.

getButton(Joystick, Button)

Args: Joystick, Button
Returns: State
C-API: Uint8 SDL_JoystickGetButton(SDL_Joystick *joystick, int button);
Desc:
Get the current state of a button on a joystick The button indices start at index 0.

getBall(Joystick, Ball)

Args: Joystick, Ball
Returns: {DX, DY} or badarg
C-API: int SDL_JoystickGetBall(SDL_Joystick *joystick, int ball, int *dx, int *dy);
Desc:
Get the ball axis change since the last poll This returns 0, or -1 if you passed it invalid parameters. The ball indices start at index 0.

close(Joystick)

Args: Joystick
Returns: none
C-API: void SDL_JoystickClose(SDL_Joystick *joystick);
Desc:
Close a joystick previously opened with SDL_JoystickOpen()