2015-06-21 15:33:46 +00:00
|
|
|
/*
|
|
|
|
Simple DirectMedia Layer
|
2020-01-17 04:49:25 +00:00
|
|
|
Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
|
2015-06-21 15:33:46 +00:00
|
|
|
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
|
|
warranty. In no event will the authors be held liable for any damages
|
|
|
|
arising from the use of this software.
|
|
|
|
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
|
|
including commercial applications, and to alter it and redistribute it
|
|
|
|
freely, subject to the following restrictions:
|
|
|
|
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
|
|
claim that you wrote the original software. If you use this software
|
|
|
|
in a product, an acknowledgment in the product documentation would be
|
|
|
|
appreciated but is not required.
|
|
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
|
|
misrepresented as being the original software.
|
|
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
|
|
*/
|
2018-10-28 20:36:48 +00:00
|
|
|
|
|
|
|
#ifndef SDL_joystick_c_h_
|
|
|
|
#define SDL_joystick_c_h_
|
|
|
|
|
2015-06-21 15:33:46 +00:00
|
|
|
#include "../SDL_internal.h"
|
|
|
|
|
|
|
|
/* Useful functions and variables from SDL_joystick.c */
|
2019-11-22 21:12:12 +00:00
|
|
|
#include "SDL_gamecontroller.h"
|
2015-06-21 15:33:46 +00:00
|
|
|
#include "SDL_joystick.h"
|
|
|
|
|
2018-08-09 23:00:17 +00:00
|
|
|
struct _SDL_JoystickDriver;
|
|
|
|
|
2015-06-21 15:33:46 +00:00
|
|
|
/* Initialization and shutdown functions */
|
|
|
|
extern int SDL_JoystickInit(void);
|
|
|
|
extern void SDL_JoystickQuit(void);
|
|
|
|
|
2018-08-09 23:00:17 +00:00
|
|
|
/* Function to get the next available joystick instance ID */
|
|
|
|
extern SDL_JoystickID SDL_GetNextJoystickInstanceID(void);
|
|
|
|
|
2015-06-21 15:33:46 +00:00
|
|
|
/* Initialization and shutdown functions */
|
2017-08-09 18:59:29 +00:00
|
|
|
extern int SDL_GameControllerInitMappings(void);
|
|
|
|
extern void SDL_GameControllerQuitMappings(void);
|
2015-06-21 15:33:46 +00:00
|
|
|
extern int SDL_GameControllerInit(void);
|
|
|
|
extern void SDL_GameControllerQuit(void);
|
|
|
|
|
2018-08-09 23:00:17 +00:00
|
|
|
/* Function to get the joystick driver and device index for an API device index */
|
|
|
|
extern SDL_bool SDL_GetDriverAndJoystickIndex(int device_index, struct _SDL_JoystickDriver **driver, int *driver_index);
|
|
|
|
|
|
|
|
/* Function to return the device index for a joystick ID, or -1 if not found */
|
|
|
|
extern int SDL_JoystickGetDeviceIndexFromInstanceID(SDL_JoystickID instance_id);
|
|
|
|
|
2017-08-09 18:59:29 +00:00
|
|
|
/* Function to extract information from an SDL joystick GUID */
|
|
|
|
extern void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version);
|
|
|
|
|
2020-03-13 02:47:30 +00:00
|
|
|
/* Function to standardize the name for a controller
|
|
|
|
This should be freed with SDL_free() when no longer needed
|
|
|
|
*/
|
|
|
|
extern char *SDL_CreateJoystickName(Uint16 vendor, Uint16 product, const char *vendor_name, const char *product_name);
|
2019-12-12 01:47:01 +00:00
|
|
|
|
2019-11-22 21:12:12 +00:00
|
|
|
/* Function to return the type of a controller */
|
2019-11-22 22:09:24 +00:00
|
|
|
extern SDL_GameControllerType SDL_GetJoystickGameControllerTypeFromGUID(SDL_JoystickGUID guid, const char *name);
|
2020-01-18 19:21:14 +00:00
|
|
|
extern SDL_GameControllerType SDL_GetJoystickGameControllerType(const char *name, Uint16 vendor, Uint16 product, int interface_number, int interface_class, int interface_subclass, int interface_protocol);
|
2018-08-09 23:00:17 +00:00
|
|
|
|
|
|
|
/* Function to return whether a joystick is a Nintendo Switch Pro controller */
|
2019-10-17 23:59:05 +00:00
|
|
|
extern SDL_bool SDL_IsJoystickNintendoSwitchProInputOnly(Uint16 vendor_id, Uint16 product_id);
|
2018-08-09 23:00:17 +00:00
|
|
|
|
|
|
|
/* Function to return whether a joystick is a Steam Controller */
|
|
|
|
extern SDL_bool SDL_IsJoystickSteamController(Uint16 vendor_id, Uint16 product_id);
|
|
|
|
|
2018-09-17 18:35:22 +00:00
|
|
|
/* Function to return whether a joystick guid comes from the XInput driver */
|
|
|
|
extern SDL_bool SDL_IsJoystickXInput(SDL_JoystickGUID guid);
|
|
|
|
|
|
|
|
/* Function to return whether a joystick guid comes from the HIDAPI driver */
|
|
|
|
extern SDL_bool SDL_IsJoystickHIDAPI(SDL_JoystickGUID guid);
|
|
|
|
|
2018-08-09 23:00:17 +00:00
|
|
|
/* Function to return whether a joystick should be ignored */
|
|
|
|
extern SDL_bool SDL_ShouldIgnoreJoystick(const char *name, SDL_JoystickGUID guid);
|
|
|
|
|
2017-08-09 18:59:29 +00:00
|
|
|
/* Function to return whether a joystick name and GUID is a game controller */
|
|
|
|
extern SDL_bool SDL_IsGameControllerNameAndGUID(const char *name, SDL_JoystickGUID guid);
|
|
|
|
|
|
|
|
/* Function to return whether a game controller should be ignored */
|
|
|
|
extern SDL_bool SDL_ShouldIgnoreGameController(const char *name, SDL_JoystickGUID guid);
|
|
|
|
|
2018-03-19 21:42:51 +00:00
|
|
|
/* Handle delayed guide button on a game controller */
|
|
|
|
extern void SDL_GameControllerHandleDelayedGuideButton(SDL_Joystick *joystick);
|
|
|
|
|
2015-06-21 15:33:46 +00:00
|
|
|
/* Internal event queueing functions */
|
2018-08-09 23:00:17 +00:00
|
|
|
extern void SDL_PrivateJoystickAdded(SDL_JoystickID device_instance);
|
2016-08-26 19:18:08 +00:00
|
|
|
extern void SDL_PrivateJoystickRemoved(SDL_JoystickID device_instance);
|
2015-06-21 15:33:46 +00:00
|
|
|
extern int SDL_PrivateJoystickAxis(SDL_Joystick * joystick,
|
|
|
|
Uint8 axis, Sint16 value);
|
|
|
|
extern int SDL_PrivateJoystickBall(SDL_Joystick * joystick,
|
|
|
|
Uint8 ball, Sint16 xrel, Sint16 yrel);
|
|
|
|
extern int SDL_PrivateJoystickHat(SDL_Joystick * joystick,
|
|
|
|
Uint8 hat, Uint8 value);
|
|
|
|
extern int SDL_PrivateJoystickButton(SDL_Joystick * joystick,
|
|
|
|
Uint8 button, Uint8 state);
|
2016-08-26 19:18:08 +00:00
|
|
|
extern void SDL_PrivateJoystickBatteryLevel(SDL_Joystick * joystick,
|
|
|
|
SDL_JoystickPowerLevel ePowerLevel);
|
2015-06-21 15:33:46 +00:00
|
|
|
|
|
|
|
/* Internal sanity checking functions */
|
2019-12-21 04:12:03 +00:00
|
|
|
extern SDL_bool SDL_PrivateJoystickValid(SDL_Joystick * joystick);
|
2015-06-21 15:33:46 +00:00
|
|
|
|
2018-10-28 20:36:48 +00:00
|
|
|
#endif /* SDL_joystick_c_h_ */
|
|
|
|
|
2015-06-21 15:33:46 +00:00
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|