tsdlgamecontroller.md 5.0 KB
id: tsdlgamecontroller title: TSDLGameController
sidebar_label: TSDLGameController
A game controller or mapped joystick.
Methods
Method Close()
Closes the game controller.
Method GetAttached:Int()
Checks if a controller has been opened and is currently connected.
Returns
True if the controller has been opened and currently connected, or False if it has not.
Method GetAxis:Int(axis:ESDLGameControllerAxis)
Gets the current state of an axis control on a game controller.
The axis indices start at index 0. The state is a value ranging from -32768 to 32767. Triggers, however, range from 0 to 32767 (they never return a negative value).
Returns
Axis state (including 0) on success or 0 (also) on failure; call SDLGetError for more information.
Method GetButton:Int(button:ESDLGameControllerButton)
Gets the current state of a button on a game controller.
The button indices start at index 0.
Returns
1 for pressed state or 0 for not pressed state or error; call SDLGetError for more information.
Method GetName:String()
Gets the implementation dependent name for the game controller.
Returns
The implementation dependent name for the game controller, or Null if there is no name or the controller is invalid.
Method GetMapping:String()
Gets the current mapping of the Game Controller.
More information about the mapping can be found at AddMapping.
Returns
A String that has the controller's mapping or Null if no mapping is available; call SDLGetError for more information.
Functions
Function Open:TSDLGameController(port:Int)
Opens a game controller to use.
The port passed as an argument refers to the N'th game controller on the system. A call to Close should be made when you have finished with this game controller.
Returns
A TSDLGameController instance or Null if an error occurred; call SDLGetError() for more information.
Function AddMapping:Int(mapping:String)
Adds support for controllers that SDL is unaware of or to cause an existing controller to have a different binding.
The mapping string has the format "GUID,name,mapping", where GUID is the string value from GetGUIDString, name is the human readable string for the device and mappings are controller mappings to joystick ones. Under Windows there is a reserved GUID of "xinput" that covers all XInput devices. The mapping format for joystick is:
| Mapping | Description |
|---|---|
| bX | a joystick button, index X |
| hX.Y | hat X with value Y |
| aX | axis X of the joystick |
Buttons can be used as a controller axes and vice versa.
This string shows an example of a valid mapping for a controller: "341a3608000000000000504944564944,Afterglow PS3 Controller,a:b1,b:b2,y:b3,x:b0,start:b9,guide:b12,back:b8,dpup:h0.1,dpleft:h0.8,dpdown:h0.4,dpright:h0.2,leftshoulder:b4,rightshoulder:b5,leftstick:b10,rightstick:b11,leftx:a0,lefty:a1,rightx:a2,righty:a3,lefttrigger:b6,righttrigger:b7"
Returns
1 if a new mapping is added, 0 if an existing mapping is updated, -1 on error; call SDLGetError for more information.
Function GetAxisFromString:ESDLGameControllerAxis(txt:String)
Converts a string into an enum representation for an ESDLGameControllerAxis.
Returns
The ESDLGameControllerAxis enum corresponding to the input string, or ESDLGameControllerAxis.INVALID if no match was found.
Function GetButtonFromString:ESDLGameControllerButton(txt:String)
Turns a string into a button mapping.
Returns
A button mapping (#ESDLGameControllerButton) on success or ESDLGameControllerButton.INVALID on failure.
Function GetStringForAxis:String(axis:ESDLGameControllerAxis)
Turns an axis enum into a string mapping.
Function GetStringForButton:String(button:ESDLGameControllerButton)
Turns a button enum into a string mapping.
Function NameForIndex:String(port:Int)
Gets the implementation dependent name for the game controller.
Returns
The implementation dependent name for the game controller, or Null if there is no name or the index is invalid.
Example
SuperStrict
Framework SDL.SDLGameController
Import brl.standardio
For Local i:Int = 0 Until JoyCount()
Print TSDLGameController.NameForIndex(i)
Next