This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Animations-Related Classes
Containers
Common Functionality
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

Unigine::InputJoystick Class

Header: #include <UnigineInput.h>

This class handles joystick input. Generic joysticks can be hot-plugged. So, you can connect your joystick before or after create an instance of this class.

The InputJoystick class provides access to the following controller input:

  • Axes detect movement along X and Y axes (if a joystick is two-axis, which is the most typical case) and along Z axis (if it is three-axis one). Two-axis joysticks are configured in such a way that left-to-right movement of the stick is mapped to the movement along the X axis, while movement from backward to forward (down-up) indicates movement along the Y axis. In case of 3D joystick, twisting the stick to the left (counter-clockwise) or to the right (clockwise) corresponds to movement along the Z axis.
    Axes are quired for their states via getAxis(). To provide smooth interpolation between frames and avoid jerks, axis values can be filtered via setFilter().
  • Buttons correspond to the controller's buttons and can be either pressed or released in the current frame, or continuously pressed for multiple frames in a row including the current one.
  • POV (Point-Of-View) hat switches indicate the direction of view and support a number of positions such as left, right, up and down (similar to a D-pad).

InputJoystick Class

Members


int getPlayerIndex ( ) const#

Returns the index of player for the joystick. Some devices support connection of multiple players (e.g., XBox 360 supports up to four players connected through XBox 360 gamepads). This method enables you to get this index.

Return value

Player index for the joystick.

bool isAvailable ( ) const#

Returns a value indicating if the joystick is available.

Return value

true if the joystick is available; otherwise, false.

const char * getName ( ) const#

Returns the name of the joystick.

Return value

Joystick name.

int getNumber ( ) const#

Returns the joystick number.

Return value

Joystick number.

Input::DEVICE getDeviceType ( ) const#

Returns a value indicating the type of the device (wheel, throttle, etc.).

Return value

Device type. One of the DEVICE_* values of the Input class.

void setFilter ( float filter ) #

Sets a filter value used to correct the current state of the joystick axis relative to the previous one.

Arguments

  • float filter - Filter value for interpolation between axis states. The provided value is clamped to a range [0;1].
    • Filter value of 0 means there is no interpolation and the current value is not corrected.
    • Filter value of 1 means the previous state is used instead of the current one.

float getFilter ( ) const#

Returns a filter value used to correct the current state of the joystick axis relative to the previous one:
  • Filter value of 0 means there is no interpolation and the current value is not corrected.
  • Filter value of 1 means the previous state is used instead of the current one.

Return value

Filter value for interpolation between axis states.

int getNumAxes ( ) const#

Returns the number of axes supported by the joystick.

Return value

Number of axes for the joystick.

float getAxis ( unsigned int axis ) const#

Returns a state value for the axis win the specified number. It includes position of the joystick along the following axes: X, Y (two-axis joystick) and Z (three-axis joystick). When a joystick 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

  • unsigned int axis - Axis number.

Return value

Value in range [-1; 1].

float getAxisDelta ( unsigned int axis ) const#

Arguments

  • unsigned int axis - Axis number.

const char * getAxisName ( unsigned int axis ) const#

Returns the name of a given axis by its number.

Arguments

  • unsigned int axis - Axis number.

Return value

Axis name.

int getNumPovs ( ) const#

Returns the number of POV hat switches supported by the joystick.

Return value

Number of POV hats.

Input::JOYSTICK_POV getPov ( unsigned int pov ) const#

Returns a POV hat switch state. POV hats support the following positions: left, right, up and down.

Arguments

  • unsigned int pov - POV hat number.

Return value

POV hat state. One of the JOYSTICK_POV values of the Input class.

const char * getPovName ( unsigned int pov ) const#

Returns the name of a given POV hat switch.

Arguments

  • unsigned int pov - POV hat number.

Return value

POV hat name.

int getNumButtons ( ) const#

Returns the number of buttons supported by the joystick.

Return value

Number of buttons.

bool isButtonPressed ( unsigned int key ) const#

Returns a value indicating if the button with the specified number is pressed. Check this value to perform continuous actions.

Arguments

  • unsigned int key - Button number.

Return value

true if the button with the specified number is pressed; otherwise - false (pressed).

bool isButtonDown ( unsigned int key ) const#

Returns a value indicating if the button with the specified number was pressed during the current frame.

Arguments

  • unsigned int key - Button number.

Return value

true if the button with the specified number was pressed during the current frame; otherwise - false (pressed).

bool isButtonUp ( unsigned int key ) const#

Returns a value indicating if the button with the specified number was released during the current frame.

Arguments

  • unsigned int key - Button number.

Return value

true if the button with the specified number was released during the current frame; otherwise - false.

const char * getButtonName ( unsigned int button ) const#

Returns the name of the button with the specified number.

Arguments

  • unsigned int button - Button number.

Return value

Button name.

Ptr<InputEventJoyButton> getButtonEvent ( int button ) const#

Returns the currently processed joystick button input event.

Arguments

  • int button - Button number.

Return value

Joystick button input event, or nullptr if there are no events for the specified joystick button in the current frame.

int getButtonEvents ( int button, Vector<Ptr<InputEventJoyButton>> & OUT_events ) const#

Returns the number of input events for the specified joystick button and puts the events to the specified output buffer.

Arguments

  • int button - Button number.
  • Vector<Ptr<InputEventJoyButton>> & OUT_events - Buffer with button input events.
    Notice
    This 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 joystick button.

Ptr<InputEventJoyPovMotion> getPovEvent ( int pov ) const#

Returns the currently processed joystick POV hat input event.

Arguments

  • int pov - POV hat number.

Return value

Joystick POV hat input event, or nullptr if there are no events for the specified joystick POV hat in the current frame.

int getPovEvents ( int pov, Vector<Ptr<InputEventJoyPovMotion>> & OUT_events ) const#

Returns the number of input events for the specified joystick POV hat and puts the events to the specified output buffer.

Arguments

  • int pov - POV hat number.
  • Vector<Ptr<InputEventJoyPovMotion>> & OUT_events - Buffer with POV input events.
    Notice
    This 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 joystick POV hat.

const char * getGuid ( ) const#

Returns the GUID created on the basis of vendor and product identifiers and product version number. It enables you to identify device model (Controller XBox One, etc.), however, it will be the same for two identical models.

Return value

Device model GUID.

int getVendor ( ) const#

Returns a unique identifier of the device manufacturer (vendor). This can be very useful in case your application uses non-standard custom input devices to ensure proper configuration (dead zones, inverse flags, correction curves, etc.).

Return value

Unique identifier of the device manufacturer (vendor).

int getProduct ( ) const#

Returns a unique identifier for the product (GUID). This identifier is established by the manufacturer of the device. This can be very useful in case your application uses non-standard custom input devices to ensure proper configuration (dead zones, inverse flags, correction curves, etc.).

Return value

Unique identifier for the product (GUID).

int getProductVersion ( ) const#

Returns the version of the product established by the manufacturer of the device. This can be very useful in case your application uses non-standard custom input devices to ensure proper configuration (dead zones, inverse flags, correction curves, etc.).

Return value

Version of the product established by the manufacturer of the device.
Last update: 2023-04-13
Build: ()