mirror of
https://github.com/Q3Rally-Team/q3rally.git
synced 2024-11-26 13:51:42 +00:00
96a9e2a9aa
This updates from SDL 2.0.4 to SDL 2.0.8. Fix nullptr dereference in front of nullptr check in FS_CheckPak0 Fix undefined behaviour due to shifting signed in snd_mem.c Fix shifting bits out of byte in tr_font.c Fix shift into sign in cl_cin.c Fix signed bit operations in MSG_ReadBits Add missing address operator in cm_polylib.c OpenGL1: Decay float[8] to float * in tr_marks.c Avoid srcList[-1] in snd_openal.c Fix the behaviour of CVAR_LATCH|CVAR_CHEAT cvars Maximize cURL buffer size Fix mouse grab after toggling fullscreen Fix q3history buffer not cleared between mods and OOB-access Revert "Removed "Color Depth" from q3_ui system settings, it didn't control anything." Fix displayed color/depth/stencil bits values Restore setting r_colorbits in q3_ui Make setting r_stencilbits more consistent in Team Arena UI Fix map list in Team Arena start server menu after entering SP menu Support SDL audio devices that require float32 samples. sdl_snd.c should just initialize SDL audio without checking SDL_WasInit(). There's no need to SDL_PauseAudio(1) before calling SDL_CloseAudio(). Added audio capture support to SDL backend. Use the SDL2 audio device interface instead of the legacy 1.2 API. Disable SDL audio capture until prebuilt SDL libraries are updated to 2.0.8. Update SDL2 to 2.0.8 Add SDL 2.0.1 headers for macOS PPC Make macOS Universal Bundle target 10.6 for x86 and x86_64 Fix possible bot goal state NULL pointer dereference Fix uninitialized bot_goal_t fields Remove unnecessary NULL pointer check in Cmd_RemoveCommand Make UI_DrawProportionalString handle NULL string Fix compiling against macOS system OpenAL and SDL2 frameworks Fix array index in CanDamage() function - discovered by MARTY Fix compiling Makefile (broke in macOS frameworks commit) Fix clearing keys for control in Team Arena UI Make s_useOpenAL be CVAR_LATCH Improvements for dedicated camera followers (team follow1/2) Fix not closing description.txt and fix path seperator Fix duplicate bots displayed in Team Arena ingame add bot menu OpenGL2: Fix parsing specularScale in shaders Don't allow SDL audio capture using pulseaudio Isolate the Altivec code so non-Altivec PPC targets can use the same binary. Limit -maltivec to specific source files on OpenBSD too (untested) Use SDL 2.0.1 headers for macOS ppc64 Fix console offset while Team Arena voiceMenu is open OpenGL2: Readd r_deluxeSpecular. Fix client kicked as unpure when missing the latest cgame/ui pk3s Don't create multiple windows when GL context creation fails Require OpenGL 1.2 for GL_CLAMP_TO_EDGE Fix Linux uninstaller requiring Bash Fix Linux uninstaller redirecting stderr to stdout in preuninstall.sh Reported by @illwieckz. Fix in_restart causing fatal error while video is shutdown Allow pkg-config binary to be overridden with PKG_CONFIG Make testgun command without argument disable test gun model Remove unused renderer_buffer variable Don't upload 8 bit grayscale images as 16 bit luminance OpenGL1: Use RE_UploadCinematic() instead of duplicate code Don't load non-core GL functions for OpenGL 3.2 core context Load OpenGL ES 2.0 function procs Don't check fixed function GL extensions when using shader pipeline OpenGL2: Fix world VAO cache drawing when glIndex_t is unsigned short OpenGL2: Misc fixes and cleanup Fix IQM root joint backlerp when joint number is more than 0 Improve IQM loading Improve IQM CPU vertex skinning performance OpenGL2: Add GPU vertex skinning for IQM models
1518 lines
48 KiB
C
1518 lines
48 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* Include file for SDL joystick event handling
|
|
*
|
|
* The term "device_index" identifies currently plugged in joystick devices between 0 and SDL_NumJoysticks, with the exact joystick
|
|
* behind a device_index changing as joysticks are plugged and unplugged.
|
|
*
|
|
* The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
|
|
* then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
|
|
*
|
|
* The term JoystickGUID is a stable 128-bit identifier for a joystick device that does not change over time, it identifies class of
|
|
* the device (a X360 wired controller for example). This identifier is platform dependent.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef _SDL_joystick_h
|
|
#define _SDL_joystick_h
|
|
|
|
#include "SDL_stdinc.h"
|
|
#include "SDL_error.h"
|
|
|
|
#include "begin_code.h"
|
|
/* Set up for C function definitions, even when using C++ */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \file SDL_joystick.h
|
|
*
|
|
* In order to use these functions, SDL_Init() must have been called
|
|
* with the ::SDL_INIT_JOYSTICK flag. This causes SDL to scan the system
|
|
* for joysticks, and load appropriate drivers.
|
|
*
|
|
* If you would like to receive joystick updates while the application
|
|
* is in the background, you should set the following hint before calling
|
|
* SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
|
|
*/
|
|
|
|
/* The joystick structure used to identify an SDL joystick */
|
|
struct _SDL_Joystick;
|
|
typedef struct _SDL_Joystick SDL_Joystick;
|
|
|
|
/* A structure that encodes the stable unique id for a joystick device */
|
|
typedef struct {
|
|
Uint8 data[16];
|
|
} SDL_JoystickGUID;
|
|
|
|
typedef Sint32 SDL_JoystickID;
|
|
|
|
|
|
/* Function prototypes */
|
|
/**
|
|
* Count the number of joysticks attached to the system right now
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_NumJoysticks(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickNameForIndex(int device_index);
|
|
|
|
/**
|
|
* Open a joystick for use.
|
|
* The index passed as an argument refers tothe N'th joystick on the system.
|
|
* This index is the value which will identify this joystick in future joystick
|
|
* events.
|
|
*
|
|
* \return A joystick identifier, or NULL if an error occurred.
|
|
*/
|
|
extern DECLSPEC SDL_Joystick *SDLCALL SDL_JoystickOpen(int device_index);
|
|
|
|
/**
|
|
* Return the name for this currently opened joystick.
|
|
* If no name can be found, this function returns NULL.
|
|
*/
|
|
extern DECLSPEC const char *SDLCALL SDL_JoystickName(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return the GUID for the joystick at this index
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/**
|
|
* Return the GUID for this opened joystick
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Return a string representation for this guid. pszGUID must point to at least 33 bytes
|
|
* (32 for the string plus a NULL terminator).
|
|
*/
|
|
extern DECLSPEC void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID);
|
|
|
|
/**
|
|
* convert a string into a joystick formatted guid
|
|
*/
|
|
extern DECLSPEC SDL_JoystickGUID SDLCALL SDL_JoystickGetGUIDFromString(const char *pchGUID);
|
|
|
|
/**
|
|
* Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.
|
|
*/
|
|
extern DECLSPEC SDL_bool SDLCALL SDL_JoystickGetAttached(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the instance ID of an opened joystick or -1 if the joystick is invalid.
|
|
*/
|
|
extern DECLSPEC SDL_JoystickID SDLCALL SDL_JoystickInstanceID(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of general axis controls on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumAxes(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of trackballs on a joystick.
|
|
*
|
|
* Joystick trackballs have only relative motion events associated
|
|
* with them and their state cannot be polled.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumBalls(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of POV hats on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumHats(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Get the number of buttons on a joystick.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickNumButtons(SDL_Joystick * joystick);
|
|
|
|
/**
|
|
* Update the current state of the open joysticks.
|
|
*
|
|
* This is called automatically by the event loop if any joystick
|
|
* events are enabled.
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickUpdate(void);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickEventState(int state);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
extern DECLSPEC Sint16 SDLCALL SDL_JoystickGetAxis(SDL_Joystick * joystick,
|
|
int axis);
|
|
|
|
/**
|
|
* \name Hat positions
|
|
*/
|
|
/* @{ */
|
|
#define SDL_HAT_CENTERED 0x00
|
|
#define SDL_HAT_UP 0x01
|
|
#define SDL_HAT_RIGHT 0x02
|
|
#define SDL_HAT_DOWN 0x04
|
|
#define SDL_HAT_LEFT 0x08
|
|
#define SDL_HAT_RIGHTUP (SDL_HAT_RIGHT|SDL_HAT_UP)
|
|
#define SDL_HAT_RIGHTDOWN (SDL_HAT_RIGHT|SDL_HAT_DOWN)
|
|
#define SDL_HAT_LEFTUP (SDL_HAT_LEFT|SDL_HAT_UP)
|
|
#define SDL_HAT_LEFTDOWN (SDL_HAT_LEFT|SDL_HAT_DOWN)
|
|
/* @} */
|
|
|
|
/**
|
|
* Get the current state of a POV hat on a joystick.
|
|
*
|
|
* The hat indices start at index 0.
|
|
*
|
|
* \return The return value is one of the following positions:
|
|
* - ::SDL_HAT_CENTERED
|
|
* - ::SDL_HAT_UP
|
|
* - ::SDL_HAT_RIGHT
|
|
* - ::SDL_HAT_DOWN
|
|
* - ::SDL_HAT_LEFT
|
|
* - ::SDL_HAT_RIGHTUP
|
|
* - ::SDL_HAT_RIGHTDOWN
|
|
* - ::SDL_HAT_LEFTUP
|
|
* - ::SDL_HAT_LEFTDOWN
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetHat(SDL_Joystick * joystick,
|
|
int hat);
|
|
|
|
/**
|
|
* Get the ball axis change since the last poll.
|
|
*
|
|
* \return 0, or -1 if you passed it invalid parameters.
|
|
*
|
|
* The ball indices start at index 0.
|
|
*/
|
|
extern DECLSPEC int SDLCALL SDL_JoystickGetBall(SDL_Joystick * joystick,
|
|
int ball, int *dx, int *dy);
|
|
|
|
/**
|
|
* Get the current state of a button on a joystick.
|
|
*
|
|
* The button indices start at index 0.
|
|
*/
|
|
extern DECLSPEC Uint8 SDLCALL SDL_JoystickGetButton(SDL_Joystick * joystick,
|
|
int button);
|
|
|
|
/**
|
|
* Close a joystick previously opened with SDL_JoystickOpen().
|
|
*/
|
|
extern DECLSPEC void SDLCALL SDL_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
|
|
/* Ends C function definitions when using C++ */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#include "close_code.h"
|
|
|
|
#endif /* _SDL_joystick_h */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|