mirror of https://github.com/encounter/SDL.git
118 lines
4.7 KiB
C
118 lines
4.7 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2014 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.
|
|
*/
|
|
#include "../SDL_internal.h"
|
|
|
|
/* This is the system specific header for the SDL joystick API */
|
|
|
|
#include "SDL_joystick.h"
|
|
#include "SDL_joystick_c.h"
|
|
|
|
/* The SDL joystick structure */
|
|
struct _SDL_Joystick
|
|
{
|
|
SDL_JoystickID instance_id; /* Device instance, monotonically increasing from 0 */
|
|
char *name; /* Joystick name - system dependent */
|
|
|
|
int naxes; /* Number of axis controls on the joystick */
|
|
Sint16 *axes; /* Current axis states */
|
|
|
|
int nhats; /* Number of hats on the joystick */
|
|
Uint8 *hats; /* Current hat states */
|
|
|
|
int nballs; /* Number of trackballs on the joystick */
|
|
struct balldelta {
|
|
int dx;
|
|
int dy;
|
|
} *balls; /* Current ball motion deltas */
|
|
|
|
int nbuttons; /* Number of buttons on the joystick */
|
|
Uint8 *buttons; /* Current button states */
|
|
|
|
struct joystick_hwdata *hwdata; /* Driver dependent information */
|
|
|
|
int ref_count; /* Reference count for multiple opens */
|
|
|
|
Uint8 closed; /* 1 if this device is no longer valid */
|
|
Uint8 uncentered; /* 1 if this device needs to have its state reset to 0 */
|
|
struct _SDL_Joystick *next; /* pointer to next joystick we have allocated */
|
|
};
|
|
|
|
/* Function to scan the system for joysticks.
|
|
* Joystick 0 should be the system default joystick.
|
|
* This function should return the number of available joysticks, or -1
|
|
* on an unrecoverable fatal error.
|
|
*/
|
|
extern int SDL_SYS_JoystickInit(void);
|
|
|
|
/* Function to return the number of joystick devices plugged in right now */
|
|
extern int SDL_SYS_NumJoysticks();
|
|
|
|
/* Function to cause any queued joystick insertions to be processed */
|
|
extern void SDL_SYS_JoystickDetect();
|
|
|
|
/* Function to determine if the joystick loop needs to run right now */
|
|
extern SDL_bool SDL_SYS_JoystickNeedsPolling();
|
|
|
|
/* Function to get the device-dependent name of a joystick */
|
|
extern const char *SDL_SYS_JoystickNameForDeviceIndex(int device_index);
|
|
|
|
/* Function to get the current instance id of the joystick located at device_index */
|
|
extern SDL_JoystickID SDL_SYS_GetInstanceIdOfDeviceIndex(int device_index);
|
|
|
|
/* Function to open a joystick for use.
|
|
The joystick to open is specified by the index field of the joystick.
|
|
This should fill the nbuttons and naxes fields of the joystick structure.
|
|
It returns 0, or -1 if there is an error.
|
|
*/
|
|
extern int SDL_SYS_JoystickOpen(SDL_Joystick * joystick, int device_index);
|
|
|
|
/* Function to query if the joystick is currently attached
|
|
* It returns 1 if attached, 0 otherwise.
|
|
*/
|
|
extern SDL_bool SDL_SYS_JoystickAttached(SDL_Joystick * joystick);
|
|
|
|
/* Function to update the state of a joystick - called as a device poll.
|
|
* This function shouldn't update the joystick structure directly,
|
|
* but instead should call SDL_PrivateJoystick*() to deliver events
|
|
* and update joystick device state.
|
|
*/
|
|
extern void SDL_SYS_JoystickUpdate(SDL_Joystick * joystick);
|
|
|
|
/* Function to close a joystick after use */
|
|
extern void SDL_SYS_JoystickClose(SDL_Joystick * joystick);
|
|
|
|
/* Function to perform any system-specific joystick related cleanup */
|
|
extern void SDL_SYS_JoystickQuit(void);
|
|
|
|
/* Function to return the stable GUID for a plugged in device */
|
|
extern SDL_JoystickGUID SDL_SYS_JoystickGetDeviceGUID(int device_index);
|
|
|
|
/* Function to return the stable GUID for a opened joystick */
|
|
extern SDL_JoystickGUID SDL_SYS_JoystickGetGUID(SDL_Joystick * joystick);
|
|
|
|
#if defined(SDL_JOYSTICK_DINPUT) || defined(SDL_JOYSTICK_XINPUT)
|
|
/* Function to get the current instance id of the joystick located at device_index */
|
|
extern SDL_bool SDL_SYS_IsXInputDeviceIndex( int device_index );
|
|
extern SDL_bool SDL_SYS_IsXInputJoystick(SDL_Joystick * joystick);
|
|
#endif
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|