Class JoystickState
Encapsulates the state of a joystick device.
Inherited Members
Namespace: OpenTK.Windowing.GraphicsLibraryFramework
Assembly: OpenTK.Windowing.GraphicsLibraryFramework.dll
Syntax
public class JoystickState
Properties
AxisCount
Gets the number of axes on the joystick this state describes.
Declaration
public int AxisCount { get; }
Property Value
| Type | Description |
|---|---|
| int |
ButtonCount
Gets the number of buttons on the joystick this state describes.
Declaration
public int ButtonCount { get; }
Property Value
| Type | Description |
|---|---|
| int |
HatCount
Gets the number of hats on the joystick this state describes.
Declaration
public int HatCount { get; }
Property Value
| Type | Description |
|---|---|
| int |
Id
Gets the identity of the joystick this state describes.
Declaration
public int Id { get; }
Property Value
| Type | Description |
|---|---|
| int |
Name
Gets the name of the joystick this state describes.
Declaration
public string Name { get; }
Property Value
| Type | Description |
|---|---|
| string |
Methods
GetAxis(int)
Gets a float between -1 and 1 describing the position of an axis.
Declaration
public float GetAxis(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the Axis to check. |
Returns
| Type | Description |
|---|---|
| float | A float between -1 and 1 describing the position of the axis. |
GetAxisPrevious(int)
Gets a float between -1 and 1 describing the previous position of an axis.
Declaration
public float GetAxisPrevious(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the Axis to check. |
Returns
| Type | Description |
|---|---|
| float | A float between -1 and 1 describing the position of the axis. |
GetHat(int)
Gets a Hat describing the state of a hat.
Declaration
public Hat GetHat(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the hat to check. |
Returns
| Type | Description |
|---|---|
| Hat | A Hat describing the hat state. |
GetHatPrevious(int)
Gets a Hat describing the previous state of a hat.
Declaration
public Hat GetHatPrevious(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the hat to check. |
Returns
| Type | Description |
|---|---|
| Hat | A Hat describing the hat state. |
GetSnapshot()
Gets an immutable snapshot of this JoystickState. This can be used to save the current joystick state for comparison later on.
Declaration
public JoystickState GetSnapshot()
Returns
| Type | Description |
|---|---|
| JoystickState | Returns an immutable snapshot of this JoystickState. |
IsButtonDown(int)
Gets a bool describing the state of a button in the current frame.
Declaration
public bool IsButtonDown(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the button to check. |
Returns
| Type | Description |
|---|---|
| bool |
|
IsButtonPressed(int)
Gets a bool describing whether the specified button is down in the current frame but was up in the previous frame.
Declaration
public bool IsButtonPressed(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the button. |
Returns
| Type | Description |
|---|---|
| bool | True if the button is down in this frame, but not the last frame. |
Remarks
"Frame" refers to invocations of
IsButtonReleased(int)
Gets a bool describing whether the specified button is up in the current frame but was down in the previous frame.
Declaration
public bool IsButtonReleased(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the button. |
Returns
| Type | Description |
|---|---|
| bool | True if the button is up in this frame, but down the last frame. |
Remarks
"Frame" refers to invocations of
ToString()
Declaration
public override string ToString()
Returns
| Type | Description |
|---|---|
| string |
Overrides
WasButtonDown(int)
Gets a bool describing whether the button was down in the previous frame.
Declaration
public bool WasButtonDown(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| int | index | The index of the button. |
Returns
| Type | Description |
|---|---|
| bool | Returns true if the button was down, or false if the button was not down. |