You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
461 lines
20 KiB
461 lines
20 KiB
//====== Copyright 1996-2013, Valve Corporation, All rights reserved. ======= |
|
// |
|
// Purpose: interface to valve controller |
|
// |
|
//============================================================================= |
|
|
|
#ifndef ISTEAMCONTROLLER_H |
|
#define ISTEAMCONTROLLER_H |
|
#ifdef _WIN32 |
|
#pragma once |
|
#endif |
|
|
|
#include "isteamclient.h" |
|
|
|
#define STEAM_CONTROLLER_MAX_COUNT 16 |
|
|
|
#define STEAM_CONTROLLER_MAX_ANALOG_ACTIONS 16 |
|
|
|
#define STEAM_CONTROLLER_MAX_DIGITAL_ACTIONS 128 |
|
|
|
#define STEAM_CONTROLLER_MAX_ORIGINS 8 |
|
|
|
// When sending an option to a specific controller handle, you can send to all controllers via this command |
|
#define STEAM_CONTROLLER_HANDLE_ALL_CONTROLLERS UINT64_MAX |
|
|
|
#define STEAM_CONTROLLER_MIN_ANALOG_ACTION_DATA -1.0f |
|
#define STEAM_CONTROLLER_MAX_ANALOG_ACTION_DATA 1.0f |
|
|
|
enum ESteamControllerPad |
|
{ |
|
k_ESteamControllerPad_Left, |
|
k_ESteamControllerPad_Right |
|
}; |
|
|
|
enum EControllerSource |
|
{ |
|
k_EControllerSource_None, |
|
k_EControllerSource_LeftTrackpad, |
|
k_EControllerSource_RightTrackpad, |
|
k_EControllerSource_Joystick, |
|
k_EControllerSource_ABXY, |
|
k_EControllerSource_Switch, |
|
k_EControllerSource_LeftTrigger, |
|
k_EControllerSource_RightTrigger, |
|
k_EControllerSource_Gyro, |
|
k_EControllerSource_CenterTrackpad, // PS4 |
|
k_EControllerSource_RightJoystick, // Traditional Controllers |
|
k_EControllerSource_DPad, // Traditional Controllers |
|
k_EControllerSource_Key, // Keyboards with scan codes |
|
k_EControllerSource_Mouse, // Traditional mouse |
|
k_EControllerSource_Count |
|
}; |
|
|
|
enum EControllerSourceMode |
|
{ |
|
k_EControllerSourceMode_None, |
|
k_EControllerSourceMode_Dpad, |
|
k_EControllerSourceMode_Buttons, |
|
k_EControllerSourceMode_FourButtons, |
|
k_EControllerSourceMode_AbsoluteMouse, |
|
k_EControllerSourceMode_RelativeMouse, |
|
k_EControllerSourceMode_JoystickMove, |
|
k_EControllerSourceMode_JoystickMouse, |
|
k_EControllerSourceMode_JoystickCamera, |
|
k_EControllerSourceMode_ScrollWheel, |
|
k_EControllerSourceMode_Trigger, |
|
k_EControllerSourceMode_TouchMenu, |
|
k_EControllerSourceMode_MouseJoystick, |
|
k_EControllerSourceMode_MouseRegion, |
|
k_EControllerSourceMode_RadialMenu, |
|
k_EControllerSourceMode_SingleButton, |
|
k_EControllerSourceMode_Switches |
|
}; |
|
|
|
enum EControllerActionOrigin |
|
{ |
|
// Steam Controller |
|
k_EControllerActionOrigin_None, |
|
k_EControllerActionOrigin_A, |
|
k_EControllerActionOrigin_B, |
|
k_EControllerActionOrigin_X, |
|
k_EControllerActionOrigin_Y, |
|
k_EControllerActionOrigin_LeftBumper, |
|
k_EControllerActionOrigin_RightBumper, |
|
k_EControllerActionOrigin_LeftGrip, |
|
k_EControllerActionOrigin_RightGrip, |
|
k_EControllerActionOrigin_Start, |
|
k_EControllerActionOrigin_Back, |
|
k_EControllerActionOrigin_LeftPad_Touch, |
|
k_EControllerActionOrigin_LeftPad_Swipe, |
|
k_EControllerActionOrigin_LeftPad_Click, |
|
k_EControllerActionOrigin_LeftPad_DPadNorth, |
|
k_EControllerActionOrigin_LeftPad_DPadSouth, |
|
k_EControllerActionOrigin_LeftPad_DPadWest, |
|
k_EControllerActionOrigin_LeftPad_DPadEast, |
|
k_EControllerActionOrigin_RightPad_Touch, |
|
k_EControllerActionOrigin_RightPad_Swipe, |
|
k_EControllerActionOrigin_RightPad_Click, |
|
k_EControllerActionOrigin_RightPad_DPadNorth, |
|
k_EControllerActionOrigin_RightPad_DPadSouth, |
|
k_EControllerActionOrigin_RightPad_DPadWest, |
|
k_EControllerActionOrigin_RightPad_DPadEast, |
|
k_EControllerActionOrigin_LeftTrigger_Pull, |
|
k_EControllerActionOrigin_LeftTrigger_Click, |
|
k_EControllerActionOrigin_RightTrigger_Pull, |
|
k_EControllerActionOrigin_RightTrigger_Click, |
|
k_EControllerActionOrigin_LeftStick_Move, |
|
k_EControllerActionOrigin_LeftStick_Click, |
|
k_EControllerActionOrigin_LeftStick_DPadNorth, |
|
k_EControllerActionOrigin_LeftStick_DPadSouth, |
|
k_EControllerActionOrigin_LeftStick_DPadWest, |
|
k_EControllerActionOrigin_LeftStick_DPadEast, |
|
k_EControllerActionOrigin_Gyro_Move, |
|
k_EControllerActionOrigin_Gyro_Pitch, |
|
k_EControllerActionOrigin_Gyro_Yaw, |
|
k_EControllerActionOrigin_Gyro_Roll, |
|
|
|
// PS4 Dual Shock |
|
k_EControllerActionOrigin_PS4_X, |
|
k_EControllerActionOrigin_PS4_Circle, |
|
k_EControllerActionOrigin_PS4_Triangle, |
|
k_EControllerActionOrigin_PS4_Square, |
|
k_EControllerActionOrigin_PS4_LeftBumper, |
|
k_EControllerActionOrigin_PS4_RightBumper, |
|
k_EControllerActionOrigin_PS4_Options, //Start |
|
k_EControllerActionOrigin_PS4_Share, //Back |
|
k_EControllerActionOrigin_PS4_LeftPad_Touch, |
|
k_EControllerActionOrigin_PS4_LeftPad_Swipe, |
|
k_EControllerActionOrigin_PS4_LeftPad_Click, |
|
k_EControllerActionOrigin_PS4_LeftPad_DPadNorth, |
|
k_EControllerActionOrigin_PS4_LeftPad_DPadSouth, |
|
k_EControllerActionOrigin_PS4_LeftPad_DPadWest, |
|
k_EControllerActionOrigin_PS4_LeftPad_DPadEast, |
|
k_EControllerActionOrigin_PS4_RightPad_Touch, |
|
k_EControllerActionOrigin_PS4_RightPad_Swipe, |
|
k_EControllerActionOrigin_PS4_RightPad_Click, |
|
k_EControllerActionOrigin_PS4_RightPad_DPadNorth, |
|
k_EControllerActionOrigin_PS4_RightPad_DPadSouth, |
|
k_EControllerActionOrigin_PS4_RightPad_DPadWest, |
|
k_EControllerActionOrigin_PS4_RightPad_DPadEast, |
|
k_EControllerActionOrigin_PS4_CenterPad_Touch, |
|
k_EControllerActionOrigin_PS4_CenterPad_Swipe, |
|
k_EControllerActionOrigin_PS4_CenterPad_Click, |
|
k_EControllerActionOrigin_PS4_CenterPad_DPadNorth, |
|
k_EControllerActionOrigin_PS4_CenterPad_DPadSouth, |
|
k_EControllerActionOrigin_PS4_CenterPad_DPadWest, |
|
k_EControllerActionOrigin_PS4_CenterPad_DPadEast, |
|
k_EControllerActionOrigin_PS4_LeftTrigger_Pull, |
|
k_EControllerActionOrigin_PS4_LeftTrigger_Click, |
|
k_EControllerActionOrigin_PS4_RightTrigger_Pull, |
|
k_EControllerActionOrigin_PS4_RightTrigger_Click, |
|
k_EControllerActionOrigin_PS4_LeftStick_Move, |
|
k_EControllerActionOrigin_PS4_LeftStick_Click, |
|
k_EControllerActionOrigin_PS4_LeftStick_DPadNorth, |
|
k_EControllerActionOrigin_PS4_LeftStick_DPadSouth, |
|
k_EControllerActionOrigin_PS4_LeftStick_DPadWest, |
|
k_EControllerActionOrigin_PS4_LeftStick_DPadEast, |
|
k_EControllerActionOrigin_PS4_RightStick_Move, |
|
k_EControllerActionOrigin_PS4_RightStick_Click, |
|
k_EControllerActionOrigin_PS4_RightStick_DPadNorth, |
|
k_EControllerActionOrigin_PS4_RightStick_DPadSouth, |
|
k_EControllerActionOrigin_PS4_RightStick_DPadWest, |
|
k_EControllerActionOrigin_PS4_RightStick_DPadEast, |
|
k_EControllerActionOrigin_PS4_DPad_North, |
|
k_EControllerActionOrigin_PS4_DPad_South, |
|
k_EControllerActionOrigin_PS4_DPad_West, |
|
k_EControllerActionOrigin_PS4_DPad_East, |
|
k_EControllerActionOrigin_PS4_Gyro_Move, |
|
k_EControllerActionOrigin_PS4_Gyro_Pitch, |
|
k_EControllerActionOrigin_PS4_Gyro_Yaw, |
|
k_EControllerActionOrigin_PS4_Gyro_Roll, |
|
|
|
// XBox One |
|
k_EControllerActionOrigin_XBoxOne_A, |
|
k_EControllerActionOrigin_XBoxOne_B, |
|
k_EControllerActionOrigin_XBoxOne_X, |
|
k_EControllerActionOrigin_XBoxOne_Y, |
|
k_EControllerActionOrigin_XBoxOne_LeftBumper, |
|
k_EControllerActionOrigin_XBoxOne_RightBumper, |
|
k_EControllerActionOrigin_XBoxOne_Menu, //Start |
|
k_EControllerActionOrigin_XBoxOne_View, //Back |
|
k_EControllerActionOrigin_XBoxOne_LeftTrigger_Pull, |
|
k_EControllerActionOrigin_XBoxOne_LeftTrigger_Click, |
|
k_EControllerActionOrigin_XBoxOne_RightTrigger_Pull, |
|
k_EControllerActionOrigin_XBoxOne_RightTrigger_Click, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_Move, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_Click, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_DPadNorth, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_DPadSouth, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_DPadWest, |
|
k_EControllerActionOrigin_XBoxOne_LeftStick_DPadEast, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_Move, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_Click, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_DPadNorth, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_DPadSouth, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_DPadWest, |
|
k_EControllerActionOrigin_XBoxOne_RightStick_DPadEast, |
|
k_EControllerActionOrigin_XBoxOne_DPad_North, |
|
k_EControllerActionOrigin_XBoxOne_DPad_South, |
|
k_EControllerActionOrigin_XBoxOne_DPad_West, |
|
k_EControllerActionOrigin_XBoxOne_DPad_East, |
|
|
|
// XBox 360 |
|
k_EControllerActionOrigin_XBox360_A, |
|
k_EControllerActionOrigin_XBox360_B, |
|
k_EControllerActionOrigin_XBox360_X, |
|
k_EControllerActionOrigin_XBox360_Y, |
|
k_EControllerActionOrigin_XBox360_LeftBumper, |
|
k_EControllerActionOrigin_XBox360_RightBumper, |
|
k_EControllerActionOrigin_XBox360_Start, //Start |
|
k_EControllerActionOrigin_XBox360_Back, //Back |
|
k_EControllerActionOrigin_XBox360_LeftTrigger_Pull, |
|
k_EControllerActionOrigin_XBox360_LeftTrigger_Click, |
|
k_EControllerActionOrigin_XBox360_RightTrigger_Pull, |
|
k_EControllerActionOrigin_XBox360_RightTrigger_Click, |
|
k_EControllerActionOrigin_XBox360_LeftStick_Move, |
|
k_EControllerActionOrigin_XBox360_LeftStick_Click, |
|
k_EControllerActionOrigin_XBox360_LeftStick_DPadNorth, |
|
k_EControllerActionOrigin_XBox360_LeftStick_DPadSouth, |
|
k_EControllerActionOrigin_XBox360_LeftStick_DPadWest, |
|
k_EControllerActionOrigin_XBox360_LeftStick_DPadEast, |
|
k_EControllerActionOrigin_XBox360_RightStick_Move, |
|
k_EControllerActionOrigin_XBox360_RightStick_Click, |
|
k_EControllerActionOrigin_XBox360_RightStick_DPadNorth, |
|
k_EControllerActionOrigin_XBox360_RightStick_DPadSouth, |
|
k_EControllerActionOrigin_XBox360_RightStick_DPadWest, |
|
k_EControllerActionOrigin_XBox360_RightStick_DPadEast, |
|
k_EControllerActionOrigin_XBox360_DPad_North, |
|
k_EControllerActionOrigin_XBox360_DPad_South, |
|
k_EControllerActionOrigin_XBox360_DPad_West, |
|
k_EControllerActionOrigin_XBox360_DPad_East, |
|
|
|
// SteamController V2 |
|
k_EControllerActionOrigin_SteamV2_A, |
|
k_EControllerActionOrigin_SteamV2_B, |
|
k_EControllerActionOrigin_SteamV2_X, |
|
k_EControllerActionOrigin_SteamV2_Y, |
|
k_EControllerActionOrigin_SteamV2_LeftBumper, |
|
k_EControllerActionOrigin_SteamV2_RightBumper, |
|
k_EControllerActionOrigin_SteamV2_LeftGrip, |
|
k_EControllerActionOrigin_SteamV2_RightGrip, |
|
k_EControllerActionOrigin_SteamV2_LeftGrip_Upper, |
|
k_EControllerActionOrigin_SteamV2_RightGrip_Upper, |
|
k_EControllerActionOrigin_SteamV2_LeftBumper_Pressure, |
|
k_EControllerActionOrigin_SteamV2_RightBumper_Pressure, |
|
k_EControllerActionOrigin_SteamV2_LeftGrip_Pressure, |
|
k_EControllerActionOrigin_SteamV2_RightGrip_Pressure, |
|
k_EControllerActionOrigin_SteamV2_LeftGrip_Upper_Pressure, |
|
k_EControllerActionOrigin_SteamV2_RightGrip_Upper_Pressure, |
|
k_EControllerActionOrigin_SteamV2_Start, |
|
k_EControllerActionOrigin_SteamV2_Back, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_Touch, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_Swipe, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_Click, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_Pressure, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_DPadNorth, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_DPadSouth, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_DPadWest, |
|
k_EControllerActionOrigin_SteamV2_LeftPad_DPadEast, |
|
k_EControllerActionOrigin_SteamV2_RightPad_Touch, |
|
k_EControllerActionOrigin_SteamV2_RightPad_Swipe, |
|
k_EControllerActionOrigin_SteamV2_RightPad_Click, |
|
k_EControllerActionOrigin_SteamV2_RightPad_Pressure, |
|
k_EControllerActionOrigin_SteamV2_RightPad_DPadNorth, |
|
k_EControllerActionOrigin_SteamV2_RightPad_DPadSouth, |
|
k_EControllerActionOrigin_SteamV2_RightPad_DPadWest, |
|
k_EControllerActionOrigin_SteamV2_RightPad_DPadEast, |
|
k_EControllerActionOrigin_SteamV2_LeftTrigger_Pull, |
|
k_EControllerActionOrigin_SteamV2_LeftTrigger_Click, |
|
k_EControllerActionOrigin_SteamV2_RightTrigger_Pull, |
|
k_EControllerActionOrigin_SteamV2_RightTrigger_Click, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_Move, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_Click, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_DPadNorth, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_DPadSouth, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_DPadWest, |
|
k_EControllerActionOrigin_SteamV2_LeftStick_DPadEast, |
|
k_EControllerActionOrigin_SteamV2_Gyro_Move, |
|
k_EControllerActionOrigin_SteamV2_Gyro_Pitch, |
|
k_EControllerActionOrigin_SteamV2_Gyro_Yaw, |
|
k_EControllerActionOrigin_SteamV2_Gyro_Roll, |
|
|
|
k_EControllerActionOrigin_Count |
|
}; |
|
|
|
enum ESteamControllerLEDFlag |
|
{ |
|
k_ESteamControllerLEDFlag_SetColor, |
|
k_ESteamControllerLEDFlag_RestoreUserDefault |
|
}; |
|
|
|
enum ESteamInputType |
|
{ |
|
k_ESteamInputType_Unknown, |
|
k_ESteamInputType_SteamController, |
|
k_ESteamInputType_XBox360Controller, |
|
k_ESteamInputType_XBoxOneController, |
|
k_ESteamInputType_GenericXInput, |
|
k_ESteamInputType_PS4Controller, |
|
}; |
|
|
|
// ControllerHandle_t is used to refer to a specific controller. |
|
// This handle will consistently identify a controller, even if it is disconnected and re-connected |
|
typedef uint64 ControllerHandle_t; |
|
|
|
|
|
// These handles are used to refer to a specific in-game action or action set |
|
// All action handles should be queried during initialization for performance reasons |
|
typedef uint64 ControllerActionSetHandle_t; |
|
typedef uint64 ControllerDigitalActionHandle_t; |
|
typedef uint64 ControllerAnalogActionHandle_t; |
|
|
|
#pragma pack( push, 1 ) |
|
|
|
struct ControllerAnalogActionData_t |
|
{ |
|
// Type of data coming from this action, this will match what got specified in the action set |
|
EControllerSourceMode eMode; |
|
|
|
// The current state of this action; will be delta updates for mouse actions |
|
float x, y; |
|
|
|
// Whether or not this action is currently available to be bound in the active action set |
|
bool bActive; |
|
}; |
|
|
|
struct ControllerDigitalActionData_t |
|
{ |
|
// The current state of this action; will be true if currently pressed |
|
bool bState; |
|
|
|
// Whether or not this action is currently available to be bound in the active action set |
|
bool bActive; |
|
}; |
|
|
|
struct ControllerMotionData_t |
|
{ |
|
// Sensor-fused absolute rotation; will drift in heading |
|
float rotQuatX; |
|
float rotQuatY; |
|
float rotQuatZ; |
|
float rotQuatW; |
|
|
|
// Positional acceleration |
|
float posAccelX; |
|
float posAccelY; |
|
float posAccelZ; |
|
|
|
// Angular velocity |
|
float rotVelX; |
|
float rotVelY; |
|
float rotVelZ; |
|
}; |
|
|
|
#pragma pack( pop ) |
|
|
|
|
|
//----------------------------------------------------------------------------- |
|
// Purpose: Native Steam controller support API |
|
//----------------------------------------------------------------------------- |
|
class ISteamController |
|
{ |
|
public: |
|
|
|
// Init and Shutdown must be called when starting/ending use of this interface |
|
virtual bool Init() = 0; |
|
virtual bool Shutdown() = 0; |
|
|
|
// Synchronize API state with the latest Steam Controller inputs available. This |
|
// is performed automatically by SteamAPI_RunCallbacks, but for the absolute lowest |
|
// possible latency, you call this directly before reading controller state. |
|
virtual void RunFrame() = 0; |
|
|
|
// Enumerate currently connected controllers |
|
// handlesOut should point to a STEAM_CONTROLLER_MAX_COUNT sized array of ControllerHandle_t handles |
|
// Returns the number of handles written to handlesOut |
|
virtual int GetConnectedControllers( ControllerHandle_t *handlesOut ) = 0; |
|
|
|
// Invokes the Steam overlay and brings up the binding screen |
|
// Returns false is overlay is disabled / unavailable, or the user is not in Big Picture mode |
|
virtual bool ShowBindingPanel( ControllerHandle_t controllerHandle ) = 0; |
|
|
|
// ACTION SETS |
|
// Lookup the handle for an Action Set. Best to do this once on startup, and store the handles for all future API calls. |
|
virtual ControllerActionSetHandle_t GetActionSetHandle( const char *pszActionSetName ) = 0; |
|
|
|
// Reconfigure the controller to use the specified action set (ie 'Menu', 'Walk' or 'Drive') |
|
// This is cheap, and can be safely called repeatedly. It's often easier to repeatedly call it in |
|
// your state loops, instead of trying to place it in all of your state transitions. |
|
virtual void ActivateActionSet( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t actionSetHandle ) = 0; |
|
virtual ControllerActionSetHandle_t GetCurrentActionSet( ControllerHandle_t controllerHandle ) = 0; |
|
|
|
virtual void ActivateActionSetLayer( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t actionSetLayerHandle ) = 0; |
|
virtual void DeactivateActionSetLayer( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t actionSetLayerHandle ) = 0; |
|
virtual void DeactivateAllActionSetLayers( ControllerHandle_t controllerHandle ) = 0; |
|
virtual int GetActiveActionSetLayers( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t *handlesOut ) = 0; |
|
|
|
|
|
// ACTIONS |
|
// Lookup the handle for a digital action. Best to do this once on startup, and store the handles for all future API calls. |
|
virtual ControllerDigitalActionHandle_t GetDigitalActionHandle( const char *pszActionName ) = 0; |
|
|
|
// Returns the current state of the supplied digital game action |
|
virtual ControllerDigitalActionData_t GetDigitalActionData( ControllerHandle_t controllerHandle, ControllerDigitalActionHandle_t digitalActionHandle ) = 0; |
|
|
|
// Get the origin(s) for a digital action within an action set. Returns the number of origins supplied in originsOut. Use this to display the appropriate on-screen prompt for the action. |
|
// originsOut should point to a STEAM_CONTROLLER_MAX_ORIGINS sized array of EControllerActionOrigin handles |
|
virtual int GetDigitalActionOrigins( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t actionSetHandle, ControllerDigitalActionHandle_t digitalActionHandle, EControllerActionOrigin *originsOut ) = 0; |
|
|
|
// Lookup the handle for an analog action. Best to do this once on startup, and store the handles for all future API calls. |
|
virtual ControllerAnalogActionHandle_t GetAnalogActionHandle( const char *pszActionName ) = 0; |
|
|
|
// Returns the current state of these supplied analog game action |
|
virtual ControllerAnalogActionData_t GetAnalogActionData( ControllerHandle_t controllerHandle, ControllerAnalogActionHandle_t analogActionHandle ) = 0; |
|
|
|
// Get the origin(s) for an analog action within an action set. Returns the number of origins supplied in originsOut. Use this to display the appropriate on-screen prompt for the action. |
|
// originsOut should point to a STEAM_CONTROLLER_MAX_ORIGINS sized array of EControllerActionOrigin handles |
|
virtual int GetAnalogActionOrigins( ControllerHandle_t controllerHandle, ControllerActionSetHandle_t actionSetHandle, ControllerAnalogActionHandle_t analogActionHandle, EControllerActionOrigin *originsOut ) = 0; |
|
|
|
virtual void StopAnalogActionMomentum( ControllerHandle_t controllerHandle, ControllerAnalogActionHandle_t eAction ) = 0; |
|
|
|
// Trigger a haptic pulse on a controller |
|
virtual void TriggerHapticPulse( ControllerHandle_t controllerHandle, ESteamControllerPad eTargetPad, unsigned short usDurationMicroSec ) = 0; |
|
|
|
// Trigger a pulse with a duty cycle of usDurationMicroSec / usOffMicroSec, unRepeat times. |
|
// nFlags is currently unused and reserved for future use. |
|
virtual void TriggerRepeatedHapticPulse( ControllerHandle_t controllerHandle, ESteamControllerPad eTargetPad, unsigned short usDurationMicroSec, unsigned short usOffMicroSec, unsigned short unRepeat, unsigned int nFlags ) = 0; |
|
|
|
// Tigger a vibration event on supported controllers. |
|
virtual void TriggerVibration( ControllerHandle_t controllerHandle, unsigned short usLeftSpeed, unsigned short usRightSpeed ) = 0; |
|
|
|
// Set the controller LED color on supported controllers. |
|
virtual void SetLEDColor( ControllerHandle_t controllerHandle, uint8 nColorR, uint8 nColorG, uint8 nColorB, unsigned int nFlags ) = 0; |
|
|
|
// Returns the associated gamepad index for the specified controller, if emulating a gamepad |
|
virtual int GetGamepadIndexForController( ControllerHandle_t ulControllerHandle ) = 0; |
|
|
|
// Returns the associated controller handle for the specified emulated gamepad |
|
virtual ControllerHandle_t GetControllerForGamepadIndex( int nIndex ) = 0; |
|
|
|
// Returns raw motion data from the specified controller |
|
virtual ControllerMotionData_t GetMotionData( ControllerHandle_t controllerHandle ) = 0; |
|
|
|
// Attempt to display origins of given action in the controller HUD, for the currently active action set |
|
// Returns false is overlay is disabled / unavailable, or the user is not in Big Picture mode |
|
virtual bool ShowDigitalActionOrigins( ControllerHandle_t controllerHandle, ControllerDigitalActionHandle_t digitalActionHandle, float flScale, float flXPosition, float flYPosition ) = 0; |
|
virtual bool ShowAnalogActionOrigins( ControllerHandle_t controllerHandle, ControllerAnalogActionHandle_t analogActionHandle, float flScale, float flXPosition, float flYPosition ) = 0; |
|
|
|
// Returns a localized string (from Steam's language setting) for the specified origin |
|
virtual const char *GetStringForActionOrigin( EControllerActionOrigin eOrigin ) = 0; |
|
|
|
// Get a local path to art for on-screen glyph for a particular origin |
|
virtual const char *GetGlyphForActionOrigin( EControllerActionOrigin eOrigin ) = 0; |
|
|
|
// Returns the input type for a particular handle |
|
virtual ESteamInputType GetInputTypeForHandle( ControllerHandle_t controllerHandle ) = 0; |
|
}; |
|
|
|
#define STEAMCONTROLLER_INTERFACE_VERSION "SteamController006" |
|
|
|
#endif // ISTEAMCONTROLLER_H
|
|
|