Unigine.InputVRController Class
| Inherits from: | InputVRDevice |
The class manages VR controller input, serving as the primary interface for VR input.
Notice
Each instance of the InputVRController class will contain its own set of values sampled from the controller.
There are three types of VR controllers: left-hand, right-hand controllers, and a treadmill. To get the type of the VR controller, you can use the getControllerType() function.
The class provides access to the following input:
- Buttons of the VR controller, including the touch buttons. They can be either pressed or released in the current frame or continuously pressed or touched for multiple frames in a row, including the current one.
- Axes of the VR controller that detect 1-dimensional movement of the control. Depending on the type of the VR controller, there can be a different number of axes. Usually, there are 3 axes, however, UNIGINE supports up to 4.
An axis can be mapped to a control of one of the following types (also referred to as an axis type): trackpad, joystick, or trigger. Each axis type has a different number of reserved axes.
To identify the supported axes, call getNumAxes(). Additionally, you can get the axis type using getAxisType().
Notice
The article on VR Input System provides several examples of inputs on different types of OpenVR-supported controllers and information on buttons and axes mapping in UNIGINE.
InputVRController Class
Enums
MODEL_TYPE#
| Name | Description |
|---|---|
| UNKNOWN = 0 | Unknown controller. |
| HTC_VIVE = 1 | HTC Vive |
| OCULUS_RIFT = 2 | Oculus Rift |
| VALVE_KNUCKLES = 3 | Valve Index Knuckles |
| NUM_MODEL_TYPES = 4 | Total number of VR controller models. |
CONTROLLER_TYPE#
| Name | Description |
|---|---|
| UNKNOWN = 0 | Unknown controller type |
| HAND_LEFT = 1 | Left hand controller |
| HAND_RIGHT = 2 | Right hand controller |
| TREADMILL = 3 | Treadmill |
| NUM_CONTROLLER_TYPES = 4 | Total number of controller types |
AXIS_TYPE#
| Name | Description |
|---|---|
| NONE = 0 | Not specified |
| TRACK_PAD = 1 | Trackpad |
| JOYSTICK = 2 | Joystick |
| TRIGGER = 3 | Trigger |
| NUM_AXIS_TYPES = 4 | Total number of axis types. |
Properties
InputVRController.MODEL_TYPE ModelType#
The Controller model type.
float Filter#
The Filter value.
InputVRController.CONTROLLER_TYPE ControllerType#
The Controller type.
int NumAxes#
The Number of axes.
Members
InputVRController.AXIS_TYPE GetAxisType ( int axis ) #
Returns the type of the specified axis.Arguments
- int axis - Axis number.
Return value
Axis type.float GetAxis ( int axis ) #
Returns a state value for the specified axis. It includes position of the VR controller along the following axes: X, Y (two-axis controller) and Z (three-axis controller). When the VR controller is in the center position, X and Y axes values are zero. Negative values indicate left or down; positive values indicate right or up.Arguments
- int axis - Axis number.
Return value
Value in range [-1.0f; 1.0f].float GetAxisDelta ( int axis ) #
Returns the axis delta — the difference between a new and the current state of the specified axis.Arguments
- int axis - Axis number.
Return value
Value in range [-1.0f; 1.0f].bool IsButtonPressed ( Input.VR_BUTTON button ) #
Returns a value indicating if the specified button is pressed. Check this value to perform continuous actions.Arguments
- Input.VR_BUTTON button - Button.
Return value
true if the button is pressed; otherwise, false.bool IsButtonDown ( Input.VR_BUTTON button ) #
Returns a value indicating if the specified button was pressed during the current frame.Arguments
- Input.VR_BUTTON button - Button.
Return value
true if the button was pressed; otherwise, false.bool IsButtonUp ( Input.VR_BUTTON button ) #
Returns a value indicating if the specified button was released during the current frame.Arguments
- Input.VR_BUTTON button - Button.
Return value
true if the button was released; otherwise, false.bool IsButtonTouchPressed ( Input.VR_BUTTON touch ) #
Returns a value indicating if the specified button is touched.Arguments
- Input.VR_BUTTON touch - Button.
Return value
true if the button is touched; otherwise, false.bool IsButtonTouchDown ( Input.VR_BUTTON touch ) #
Returns a value indicating if the specified touch button was "pressed" in the currect frame.Arguments
- Input.VR_BUTTON touch -
Return value
true if the touch button was "pressed"; otherwise, false.bool IsButtonTouchUp ( Input.VR_BUTTON touch ) #
Returns a value indicating if the specified touch button was "released" in the currect frame.Arguments
- Input.VR_BUTTON touch -
Return value
true if the touch button was "released"; otherwise, false.InputEventVRButton GetButtonEvent ( Input.VR_BUTTON button ) #
Returns the currently processed VR controller button input event.Arguments
- Input.VR_BUTTON button - Button.
Return value
VR controller button input event, or null if there are no events for the specified button in the current frame.int GetButtonEvents ( Input.VR_BUTTON button, InputEventVRButton[] OUT_events ) #
Returns the number of input events for the specified VR controller button and puts the events to the specified output buffer.Arguments
- Input.VR_BUTTON button - Button.
- InputEventVRButton[]
OUT_events - Buffer with button input events.NoticeThis output buffer is to be filled by the Engine as a result of executing the method.
Return value
Number of input events for the specified VR controller button.InputEventVRButtonTouch GetButtonTouchEvent ( Input.VR_BUTTON button ) #
Returns the currently processed VR controller button touch event.Arguments
- Input.VR_BUTTON button - Button.
Return value
VR controller button touch event, or null if there are no events for the specified touch button in the current frame.int GetButtonTouchEvents ( Input.VR_BUTTON button, InputEventVRButtonTouch[] OUT_events ) #
Returns the number of touch events for the specified VR controller touch button and puts the events to the specified output buffer.Arguments
- Input.VR_BUTTON button - Button.
- InputEventVRButtonTouch[]
OUT_events - Buffer with button touch events.NoticeThis output buffer is to be filled by the Engine as a result of executing the method.
Return value
Number of input events for the specified VR controller touch button.void SetVibration ( ushort duration_ms = 100 ) #
Sets the vibration of the given duration for the VR controller.Arguments
- ushort duration_ms - Duration of the vibration.
Last update:
2023-12-15
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)