com.badlogic.gdx.controllers

Class Controllers

java.lang.Object

com.badlogic.gdx.controllers.Controllers

public class Controllers
extends java.lang.Object

Provides access to connected Controller instances. Query the available controllers via getControllers(), add and remove global ControllerListener instances via addListener(ControllerListener) and removeListener(ControllerListener). The listeners will be invoked on the rendering thread. The global listeners will be invoked for all events generated by all controllers. Polling a Controller can be done by invoking one of its getter methods.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	preferredManager The class name of a preferred ControllerManager.

Constructor Summary

Constructors

Constructor and Description
Controllers()

Method Summary

Modifier and Type	Method and Description
static void	addListener(ControllerListener listener) Add a global ControllerListener that can react to events from all Controller instances.
static void	clearListeners() Removes every global ControllerListener previously added.
static com.badlogic.gdx.utils.Array<Controller>	getControllers() Returns an array of connected Controller instances.
static Controller	getCurrent()
static com.badlogic.gdx.utils.Array<ControllerListener>	getListeners() Returns all listeners currently registered.
static void	removeListener(ControllerListener listener) Removes a global ControllerListener.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

preferredManager

public static java.lang.String preferredManager

The class name of a preferred ControllerManager. If this is null then an appropriate ControllerManager will automatically be selected. This must be set before any controllers or managers are found.

Constructor Detail

Controllers

public Controllers()

Method Detail

getControllers

public static com.badlogic.gdx.utils.Array<Controller> getControllers()

Returns an array of connected Controller instances. This method should only be called on the rendering thread.

Returns:

the connected controllers

getCurrent

public static Controller getCurrent()

Returns:

the controller the player used most recently. This might return null if there is no controller connected or the last used connector disconnected

addListener

public static void addListener(ControllerListener listener)

Add a global ControllerListener that can react to events from all Controller instances. The listener will be invoked on the rendering thread.

Parameters:

listener -

removeListener

public static void removeListener(ControllerListener listener)

Removes a global ControllerListener. The method must be called on the rendering thread.

Parameters:

listener -

clearListeners

public static void clearListeners()

Removes every global ControllerListener previously added.

getListeners

public static com.badlogic.gdx.utils.Array<ControllerListener> getListeners()

Returns all listeners currently registered. Modifying this array will result in undefined behaviour.