InputManager is responsible for converting input events
- * received from the Key, Mouse and Joy Input implementations into an
- * abstract, input device independent representation that user code can use.
- *
- * By default an InputManager is included with every Application instance for use
- * in user code to query input, unless the Application is created as headless
- * or with input explicitly disabled.
- *
- * The input manager has two concepts, a {@link Trigger} and a mapping. - * A trigger represents a specific input trigger, such as a key button, - * or a mouse axis. A mapping represents a link onto one or several triggers, - * when the appropriate trigger is activated (e.g. a key is pressed), the - * mapping will be invoked. Any listeners registered to receive an event - * from the mapping will have an event raised. - *
- * There are two types of events that {@link InputListener input listeners} - * can receive, one is {@link ActionListener#onAction(java.lang.String, boolean, float) action} - * events and another is {@link AnalogListener#onAnalog(java.lang.String, float, float) analog} - * events. - *
- * onAction events are raised when the specific input
- * activates or deactivates. For a digital input such as key press, the onAction()
- * event will be raised with the isPressed argument equal to true,
- * when the key is released, onAction is called again but this time
- * with the isPressed argument set to false.
- * For analog inputs, the onAction method will be called any time
- * the input is non-zero, however an exception to this is for joystick axis inputs,
- * which are only called when the input is above the {@link InputManager#setAxisDeadZone(float) dead zone}.
- *
- * This should only be called internally in {@link Application}.
- *
- * @param mouse
- * @param keys
- * @param joystick
- * @param touch
- * @throws IllegalArgumentException If either mouseInput or keyInput are null.
- */
- public InputManager(MouseInput mouse, KeyInput keys, JoyInput joystick, TouchInput touch) {
- if (keys == null || mouse == null) {
- throw new IllegalArgumentException("Mouse or keyboard cannot be null");
- }
-
- this.keys = keys;
- this.mouse = mouse;
- this.joystick = joystick;
- this.touch = touch;
-
- keys.setInputListener(this);
- mouse.setInputListener(this);
- if (joystick != null) {
- joystick.setInputListener(this);
- joysticks = joystick.loadJoysticks(this);
- }
- if (touch != null) {
- touch.setInputListener(this);
- }
-
- firstTime = keys.getInputTimeNanos();
- }
-
- private void invokeActions(int hash, boolean pressed) {
- ArrayList {@link ActionListener#onAction(java.lang.String, boolean, float) }
- * events will only be raised if the joystick axis value is greater than
- * the The given InputListener will be registered to receive events
- * on the specified mapping names. When a mapping raises an event, the
- * listener will have its appropriate method invoked, either
- * {@link ActionListener#onAction(java.lang.String, boolean, float) }
- * or {@link AnalogListener#onAnalog(java.lang.String, float, float) }
- * depending on which interface the This will unregister the listener from any mappings that it
- * was previously registered with via
- * {@link InputManager#addListener(com.jme3.input.controls.InputListener, java.lang.String[]) }.
- *
- * @param listener The listener to unregister.
- *
- * @see InputManager#addListener(com.jme3.input.controls.InputListener, java.lang.String[])
- */
- public void removeListener(InputListener listener) {
- for (Mapping mapping : mappings.values()) {
- mapping.listeners.remove(listener);
- }
- }
-
- /**
- * Create a new mapping to the given triggers.
- *
- *
- * The given mapping will be assigned to the given triggers, when
- * any of the triggers given raise an event, the listeners
- * registered to the mappings will receive appropriate events.
- *
- * @param mappingName The mapping name to assign.
- * @param triggers The triggers to which the mapping is to be registered.
- *
- * @see InputManager#deleteMapping(java.lang.String)
- */
- public void addMapping(String mappingName, Trigger... triggers) {
- Mapping mapping = mappings.get(mappingName);
- if (mapping == null) {
- mapping = new Mapping(mappingName);
- mappings.put(mappingName, mapping);
- }
-
- for (Trigger trigger : triggers) {
- int hash = trigger.triggerHashCode();
- ArrayList
- * The given mapping will no longer be assigned to receive trigger
- * events.
- *
- * @param mappingName The mapping name to unregister.
- *
- * @see InputManager#addMapping(java.lang.String, com.jme3.input.controls.Trigger[])
- */
- public void deleteMapping(String mappingName) {
- Mapping mapping = mappings.remove(mappingName);
- if (mapping == null) {
- //throw new IllegalArgumentException("Cannot find mapping: " + mappingName);
- logger.log(Level.WARNING, "Cannot find mapping to be removed, skipping: {0}", mappingName);
- return;
- }
-
- ArrayList
- * The given mapping will no longer receive events raised by the
- * trigger.
- *
- * @param mappingName The mapping name to cease receiving events from the
- * trigger.
- * @param trigger The trigger to no longer invoke events on the mapping.
- */
- public void deleteTrigger(String mappingName, Trigger trigger) {
- Mapping mapping = mappings.get(mappingName);
- if (mapping == null) {
- throw new IllegalArgumentException("Cannot find mapping: " + mappingName);
- }
-
- ArrayList By default the cursor is visible.
- *
- * @return whether the mouse cursor is visible or not.
- *
- * @see InputManager#setCursorVisible(boolean)
- */
- public boolean isCursorVisible() {
- return mouseVisible;
- }
-
- /**
- * Set whether the mouse cursor should be visible or not.
- *
- * @param visible whether the mouse cursor should be visible or not.
- */
- public void setCursorVisible(boolean visible) {
- if (mouseVisible != visible) {
- mouseVisible = visible;
- mouse.setCursorVisible(mouseVisible);
- }
- }
-
- /**
- * Returns the current cursor position. The position is relative to the
- * bottom-left of the screen and is in pixels.
- *
- * @return the current cursor position
- */
- public Vector2f getCursorPosition() {
- return cursorPos;
- }
-
- /**
- * Returns an array of all joysticks installed on the system.
- *
- * @return an array of all joysticks installed on the system.
- */
- public Joystick[] getJoysticks() {
- return joysticks;
- }
-
- /**
- * Adds a {@link RawInputListener} to receive raw input events.
- *
- *
- * Any raw input listeners registered to this
- * If a raw input listener has handled the event and does not wish
- * other listeners down the list to process the event, it may set the
- * {@link InputEvent#setConsumed() consumed flag} to indicate the
- * event was consumed and shouldn't be processed any further.
- * The listener may do this either at each of the event callbacks
- * or at the {@link RawInputListener#endInput() } method.
- *
- * @param listener A listener to receive raw input events.
- *
- * @see RawInputListener
- */
- public void addRawInputListener(RawInputListener listener) {
- rawListeners.add(listener);
- }
-
- /**
- * Removes a {@link RawInputListener} so that it no longer
- * receives raw input events.
- *
- * @param listener The listener to cease receiving raw input events.
- *
- * @see InputManager#addRawInputListener(com.jme3.input.RawInputListener)
- */
- public void removeRawInputListener(RawInputListener listener) {
- rawListeners.remove(listener);
- }
-
- /**
- * Clears all {@link RawInputListener}s.
- *
- * @see InputManager#addRawInputListener(com.jme3.input.RawInputListener)
- */
- public void clearRawInputListeners() {
- rawListeners.clear();
- }
-
- /**
- * Enable simulation of mouse events. Used for touchscreen input only.
- *
- * @param value True to enable simulation of mouse events
- */
- public void setSimulateMouse(boolean value) {
- if (touch != null) {
- touch.setSimulateMouse(value);
- }
- }
- /**
- * @deprecated Use isSimulateMouse
- * Returns state of simulation of mouse events. Used for touchscreen input only.
- *
- */
- public boolean getSimulateMouse() {
- if (touch != null) {
- return touch.isSimulateMouse();
- } else {
- return false;
- }
- }
-
- /**
- * Returns state of simulation of mouse events. Used for touchscreen input only.
- *
- */
- public boolean isSimulateMouse() {
- if (touch != null) {
- return touch.isSimulateMouse();
- } else {
- return false;
- }
- }
-
- /**
- * Enable simulation of keyboard events. Used for touchscreen input only.
- *
- * @param value True to enable simulation of keyboard events
- */
- public void setSimulateKeyboard(boolean value) {
- if (touch != null) {
- touch.setSimulateKeyboard(value);
- }
- }
-
- /**
- * Returns state of simulation of key events. Used for touchscreen input only.
- *
- */
- public boolean isSimulateKeyboard() {
- if (touch != null) {
- return touch.isSimulateKeyboard();
- } else {
- return false;
- }
- }
-
- private void processQueue() {
- int queueSize = inputQueue.size();
- RawInputListener[] array = rawListeners.getArray();
-
- for (RawInputListener listener : array) {
- listener.beginInput();
-
- for (int j = 0; j < queueSize; j++) {
- InputEvent event = inputQueue.get(j);
- if (event.isConsumed()) {
- continue;
- }
-
- if (event instanceof MouseMotionEvent) {
- listener.onMouseMotionEvent((MouseMotionEvent) event);
- } else if (event instanceof KeyInputEvent) {
- listener.onKeyEvent((KeyInputEvent) event);
- } else if (event instanceof MouseButtonEvent) {
- listener.onMouseButtonEvent((MouseButtonEvent) event);
- } else if (event instanceof JoyAxisEvent) {
- listener.onJoyAxisEvent((JoyAxisEvent) event);
- } else if (event instanceof JoyButtonEvent) {
- listener.onJoyButtonEvent((JoyButtonEvent) event);
- } else if (event instanceof TouchEvent) {
- listener.onTouchEvent((TouchEvent) event);
- } else {
- assert false;
- }
- }
-
- listener.endInput();
- }
-
- for (int i = 0; i < queueSize; i++) {
- InputEvent event = inputQueue.get(i);
- if (event.isConsumed()) {
- continue;
- }
-
- if (event instanceof MouseMotionEvent) {
- onMouseMotionEventQueued((MouseMotionEvent) event);
- } else if (event instanceof KeyInputEvent) {
- onKeyEventQueued((KeyInputEvent) event);
- } else if (event instanceof MouseButtonEvent) {
- onMouseButtonEventQueued((MouseButtonEvent) event);
- } else if (event instanceof JoyAxisEvent) {
- onJoyAxisEventQueued((JoyAxisEvent) event);
- } else if (event instanceof JoyButtonEvent) {
- onJoyButtonEventQueued((JoyButtonEvent) event);
- } else if (event instanceof TouchEvent) {
- onTouchEventQueued((TouchEvent) event);
- } else {
- assert false;
- }
- // larynx, 2011.06.10 - flag event as reusable because
- // the android input uses a non-allocating ringbuffer which
- // needs to know when the event is not anymore in inputQueue
- // and therefore can be reused.
- event.setConsumed();
- }
-
- inputQueue.clear();
- }
-
- /**
- * Updates the
+ * By default an
+ * The input manager has two concepts, a {@link Trigger} and a mapping.
+ * A trigger represents a specific input trigger, such as a key button,
+ * or a mouse axis. A mapping represents a link onto one or several triggers,
+ * when the appropriate trigger is activated (e.g. a key is pressed), the
+ * mapping will be invoked. Any listeners registered to receive an event
+ * from the mapping will have an event raised.
+ *
+ * There are two types of events that {@link InputListener input listeners}
+ * can receive, one is {@link ActionListener#onAction(java.lang.String, boolean, float) action}
+ * events and another is {@link AnalogListener#onAnalog(java.lang.String, float, float) analog}
+ * events.
+ *
+ *
+ * This should only be called internally in {@link Application}.
+ *
+ * @param mouse
+ * @param keys
+ * @param joystick
+ * @param touch
+ * @throws IllegalArgumentException If either mouseInput or keyInput are null.
+ */
+ public InputManager(MouseInput mouse, KeyInput keys, JoyInput joystick, TouchInput touch) {
+ if (keys == null || mouse == null) {
+ throw new IllegalArgumentException("Mouse or keyboard cannot be null");
+ }
+
+ this.keys = keys;
+ this.mouse = mouse;
+ this.joystick = joystick;
+ this.touch = touch;
+
+ keys.setInputListener(this);
+ mouse.setInputListener(this);
+ if (joystick != null) {
+ joystick.setInputListener(this);
+ joysticks = joystick.loadJoysticks(this);
+ }
+ if (touch != null) {
+ touch.setInputListener(this);
+ }
+
+ firstTime = keys.getInputTimeNanos();
+ }
+
+ private void invokeActions(int hash, boolean pressed) {
+ ArrayList {@link ActionListener#onAction(java.lang.String, boolean, float) }
+ * events will only be raised if the joystick axis value is greater than
+ * the The given InputListener will be registered to receive events
+ * on the specified mapping names. When a mapping raises an event, the
+ * listener will have its appropriate method invoked, either
+ * {@link ActionListener#onAction(java.lang.String, boolean, float) }
+ * or {@link AnalogListener#onAnalog(java.lang.String, float, float) }
+ * depending on which interface the This will unregister the listener from any mappings that it
+ * was previously registered with via
+ * {@link InputManager#addListener(com.jme3.input.controls.InputListener, java.lang.String[]) }.
+ *
+ * @param listener The listener to unregister.
+ *
+ * @see InputManager#addListener(com.jme3.input.controls.InputListener, java.lang.String[])
+ */
+ public void removeListener(InputListener listener) {
+ for (Mapping mapping : mappings.values()) {
+ mapping.listeners.remove(listener);
+ }
+ }
+
+ /**
+ * Create a new mapping to the given triggers.
+ *
+ *
+ * The given mapping will be assigned to the given triggers, when
+ * any of the triggers given raise an event, the listeners
+ * registered to the mappings will receive appropriate events.
+ *
+ * @param mappingName The mapping name to assign.
+ * @param triggers The triggers to which the mapping is to be registered.
+ *
+ * @see InputManager#deleteMapping(java.lang.String)
+ */
+ public void addMapping(String mappingName, Trigger... triggers) {
+ Mapping mapping = mappings.get(mappingName);
+ if (mapping == null) {
+ mapping = new Mapping(mappingName);
+ mappings.put(mappingName, mapping);
+ }
+
+ for (Trigger trigger : triggers) {
+ int hash = trigger.triggerHashCode();
+ ArrayList
+ * The given mapping will no longer be assigned to receive trigger
+ * events.
+ *
+ * @param mappingName The mapping name to unregister.
+ *
+ * @see InputManager#addMapping(java.lang.String, com.jme3.input.controls.Trigger[])
+ */
+ public void deleteMapping(String mappingName) {
+ Mapping mapping = mappings.remove(mappingName);
+ if (mapping == null) {
+ //throw new IllegalArgumentException("Cannot find mapping: " + mappingName);
+ logger.log(Level.WARNING, "Cannot find mapping to be removed, skipping: {0}", mappingName);
+ return;
+ }
+
+ ArrayList
+ * The given mapping will no longer receive events raised by the
+ * trigger.
+ *
+ * @param mappingName The mapping name to cease receiving events from the
+ * trigger.
+ * @param trigger The trigger to no longer invoke events on the mapping.
+ */
+ public void deleteTrigger(String mappingName, Trigger trigger) {
+ Mapping mapping = mappings.get(mappingName);
+ if (mapping == null) {
+ throw new IllegalArgumentException("Cannot find mapping: " + mappingName);
+ }
+
+ ArrayList By default the cursor is visible.
+ *
+ * @return whether the mouse cursor is visible or not.
+ *
+ * @see InputManager#setCursorVisible(boolean)
+ */
+ public boolean isCursorVisible() {
+ return mouseVisible;
+ }
+
+ /**
+ * Set whether the mouse cursor should be visible or not.
+ *
+ * @param visible whether the mouse cursor should be visible or not.
+ */
+ public void setCursorVisible(boolean visible) {
+ if (mouseVisible != visible) {
+ mouseVisible = visible;
+ mouse.setCursorVisible(mouseVisible);
+ }
+ }
+
+ /**
+ * Returns the current cursor position. The position is relative to the
+ * bottom-left of the screen and is in pixels.
+ *
+ * @return the current cursor position
+ */
+ public Vector2f getCursorPosition() {
+ return cursorPos;
+ }
+
+ /**
+ * Returns an array of all joysticks installed on the system.
+ *
+ * @return an array of all joysticks installed on the system.
+ */
+ public Joystick[] getJoysticks() {
+ return joysticks;
+ }
+
+ /**
+ * Adds a {@link RawInputListener} to receive raw input events.
+ *
+ *
+ * Any raw input listeners registered to this
+ * If a raw input listener has handled the event and does not wish
+ * other listeners down the list to process the event, it may set the
+ * {@link InputEvent#setConsumed() consumed flag} to indicate the
+ * event was consumed and shouldn't be processed any further.
+ * The listener may do this either at each of the event callbacks
+ * or at the {@link RawInputListener#endInput() } method.
+ *
+ * @param listener A listener to receive raw input events.
+ *
+ * @see RawInputListener
+ */
+ public void addRawInputListener(RawInputListener listener) {
+ rawListeners.add(listener);
+ }
+
+ /**
+ * Removes a {@link RawInputListener} so that it no longer
+ * receives raw input events.
+ *
+ * @param listener The listener to cease receiving raw input events.
+ *
+ * @see InputManager#addRawInputListener(com.jme3.input.RawInputListener)
+ */
+ public void removeRawInputListener(RawInputListener listener) {
+ rawListeners.remove(listener);
+ }
+
+ /**
+ * Clears all {@link RawInputListener}s.
+ *
+ * @see InputManager#addRawInputListener(com.jme3.input.RawInputListener)
+ */
+ public void clearRawInputListeners() {
+ rawListeners.clear();
+ }
+
+ /**
+ * Enable simulation of mouse events. Used for touchscreen input only.
+ *
+ * @param value True to enable simulation of mouse events
+ */
+ public void setSimulateMouse(boolean value) {
+ if (touch != null) {
+ touch.setSimulateMouse(value);
+ }
+ }
+ /**
+ * @deprecated Use isSimulateMouse
+ * Returns state of simulation of mouse events. Used for touchscreen input only.
+ *
+ */
+ public boolean getSimulateMouse() {
+ if (touch != null) {
+ return touch.isSimulateMouse();
+ } else {
+ return false;
+ }
+ }
+
+ /**
+ * Returns state of simulation of mouse events. Used for touchscreen input only.
+ *
+ */
+ public boolean isSimulateMouse() {
+ if (touch != null) {
+ return touch.isSimulateMouse();
+ } else {
+ return false;
+ }
+ }
+
+ /**
+ * Enable simulation of keyboard events. Used for touchscreen input only.
+ *
+ * @param value True to enable simulation of keyboard events
+ */
+ public void setSimulateKeyboard(boolean value) {
+ if (touch != null) {
+ touch.setSimulateKeyboard(value);
+ }
+ }
+
+ /**
+ * Returns state of simulation of key events. Used for touchscreen input only.
+ *
+ */
+ public boolean isSimulateKeyboard() {
+ if (touch != null) {
+ return touch.isSimulateKeyboard();
+ } else {
+ return false;
+ }
+ }
+
+ private void processQueue() {
+ int queueSize = inputQueue.size();
+ RawInputListener[] array = rawListeners.getArray();
+
+ for (RawInputListener listener : array) {
+ listener.beginInput();
+
+ for (int j = 0; j < queueSize; j++) {
+ InputEvent event = inputQueue.get(j);
+ if (event.isConsumed()) {
+ continue;
+ }
+
+ if (event instanceof MouseMotionEvent) {
+ listener.onMouseMotionEvent((MouseMotionEvent) event);
+ } else if (event instanceof KeyInputEvent) {
+ listener.onKeyEvent((KeyInputEvent) event);
+ } else if (event instanceof MouseButtonEvent) {
+ listener.onMouseButtonEvent((MouseButtonEvent) event);
+ } else if (event instanceof JoyAxisEvent) {
+ listener.onJoyAxisEvent((JoyAxisEvent) event);
+ } else if (event instanceof JoyButtonEvent) {
+ listener.onJoyButtonEvent((JoyButtonEvent) event);
+ } else if (event instanceof TouchEvent) {
+ listener.onTouchEvent((TouchEvent) event);
+ } else {
+ assert false;
+ }
+ }
+
+ listener.endInput();
+ }
+
+ for (int i = 0; i < queueSize; i++) {
+ InputEvent event = inputQueue.get(i);
+ if (event.isConsumed()) {
+ continue;
+ }
+
+ if (event instanceof MouseMotionEvent) {
+ onMouseMotionEventQueued((MouseMotionEvent) event);
+ } else if (event instanceof KeyInputEvent) {
+ onKeyEventQueued((KeyInputEvent) event);
+ } else if (event instanceof MouseButtonEvent) {
+ onMouseButtonEventQueued((MouseButtonEvent) event);
+ } else if (event instanceof JoyAxisEvent) {
+ onJoyAxisEventQueued((JoyAxisEvent) event);
+ } else if (event instanceof JoyButtonEvent) {
+ onJoyButtonEventQueued((JoyButtonEvent) event);
+ } else if (event instanceof TouchEvent) {
+ onTouchEventQueued((TouchEvent) event);
+ } else {
+ assert false;
+ }
+ // larynx, 2011.06.10 - flag event as reusable because
+ // the android input uses a non-allocating ringbuffer which
+ // needs to know when the event is not anymore in inputQueue
+ // and therefore can be reused.
+ event.setConsumed();
+ }
+
+ inputQueue.clear();
+ }
+
+ /**
+ * Updates the onAnalog events are raised every frame while the input is activated.
- * For digital inputs, every frame that the input is active will cause the
- * onAnalog method to be called, the argument value
- * argument will equal to the frame's time per frame (TPF) value but only
- * for digital inputs. For analog inputs however, the value argument
- * will equal the actual analog value.
- */
-public class InputManager implements RawInputListener {
-
- private static final Logger logger = Logger.getLogger(InputManager.class.getName());
- private final KeyInput keys;
- private final MouseInput mouse;
- private final JoyInput joystick;
- private final TouchInput touch;
- private float frameTPF;
- private long lastLastUpdateTime = 0;
- private long lastUpdateTime = 0;
- private long frameDelta = 0;
- private long firstTime = 0;
- private boolean eventsPermitted = false;
- private boolean mouseVisible = true;
- private boolean safeMode = false;
- private float globalAxisDeadZone = 0.05f;
- private final Vector2f cursorPos = new Vector2f();
- private Joystick[] joysticks;
- private final IntMapdeadZone.
- *
- * @param deadZone the deadzone for joystick axes.
- */
- public void setAxisDeadZone(float deadZone) {
- this.globalAxisDeadZone = deadZone;
- }
-
- /**
- * Returns the deadzone for joystick axes.
- *
- * @return the deadzone for joystick axes.
- */
- public float getAxisDeadZone() {
- return globalAxisDeadZone;
- }
-
- /**
- * Adds a new listener to receive events on the given mappings.
- *
- * listener implements.
- * If the listener implements both interfaces, then it will receive the
- * appropriate event for each method.
- *
- * @param listener The listener to register to receive input events.
- * @param mappingNames The mapping names which the listener will receive
- * events from.
- *
- * @see InputManager#removeListener(com.jme3.input.controls.InputListener)
- */
- public void addListener(InputListener listener, String... mappingNames) {
- for (String mappingName : mappingNames) {
- Mapping mapping = mappings.get(mappingName);
- if (mapping == null) {
- mapping = new Mapping(mappingName);
- mappings.put(mappingName, mapping);
- }
- if (!mapping.listeners.contains(listener)) {
- mapping.listeners.add(listener);
- }
- }
- }
-
- /**
- * Removes a listener from receiving events.
- *
- * InputManager
- * will receive raw input events first, before they get handled
- * by the InputManager itself. The listeners are
- * each processed in the order they were added, e.g. FIFO.
- * InputManager.
- * This will query current input devices and send
- * appropriate events to registered listeners.
- *
- * @param tpf Time per frame value.
- */
- public void update(float tpf) {
- frameTPF = tpf;
-
- // Activate safemode if the TPF value is so small
- // that rounding errors are inevitable
- safeMode = tpf < 0.015f;
-
- long currentTime = keys.getInputTimeNanos();
- frameDelta = currentTime - lastUpdateTime;
-
- eventsPermitted = true;
-
- keys.update();
- mouse.update();
- if (joystick != null) {
- joystick.update();
- }
- if (touch != null) {
- touch.update();
- }
-
- eventsPermitted = false;
-
- processQueue();
- invokeUpdateActions();
-
- lastLastUpdateTime = lastUpdateTime;
- lastUpdateTime = currentTime;
- }
-
- /**
- * Dispatches touch events to touch listeners
- * @param evt The touch event to be dispatched to all onTouch listeners
- */
- public void onTouchEventQueued(TouchEvent evt) {
- ArrayListInputManager is responsible for converting input events
+ * received from the Key, Mouse and Joy Input implementations into an
+ * abstract, input device independent representation that user code can use.
+ * InputManager is included with every Application instance for use
+ * in user code to query input, unless the Application is created as headless
+ * or with input explicitly disabled.
+ * onAction events are raised when the specific input
+ * activates or deactivates. For a digital input such as key press, the onAction()
+ * event will be raised with the isPressed argument equal to true,
+ * when the key is released, onAction is called again but this time
+ * with the isPressed argument set to false.
+ * For analog inputs, the onAction method will be called any time
+ * the input is non-zero, however an exception to this is for joystick axis inputs,
+ * which are only called when the input is above the {@link InputManager#setAxisDeadZone(float) dead zone}.
+ * onAnalog events are raised every frame while the input is activated.
+ * For digital inputs, every frame that the input is active will cause the
+ * onAnalog method to be called, the argument value
+ * argument will equal to the frame's time per frame (TPF) value but only
+ * for digital inputs. For analog inputs however, the value argument
+ * will equal the actual analog value.
+ */
+public class InputManager implements RawInputListener {
+
+ private static final Logger logger = Logger.getLogger(InputManager.class.getName());
+ private final KeyInput keys;
+ private final MouseInput mouse;
+ private final JoyInput joystick;
+ private final TouchInput touch;
+ private float frameTPF;
+ private long lastLastUpdateTime = 0;
+ private long lastUpdateTime = 0;
+ private long frameDelta = 0;
+ private long firstTime = 0;
+ private boolean eventsPermitted = false;
+ private boolean mouseVisible = true;
+ private boolean safeMode = false;
+ private float globalAxisDeadZone = 0.05f;
+ private final Vector2f cursorPos = new Vector2f();
+ private Joystick[] joysticks;
+ private final IntMapdeadZone.
+ *
+ * @param deadZone the deadzone for joystick axes.
+ */
+ public void setAxisDeadZone(float deadZone) {
+ this.globalAxisDeadZone = deadZone;
+ }
+
+ /**
+ * Returns the deadzone for joystick axes.
+ *
+ * @return the deadzone for joystick axes.
+ */
+ public float getAxisDeadZone() {
+ return globalAxisDeadZone;
+ }
+
+ /**
+ * Adds a new listener to receive events on the given mappings.
+ *
+ * listener implements.
+ * If the listener implements both interfaces, then it will receive the
+ * appropriate event for each method.
+ *
+ * @param listener The listener to register to receive input events.
+ * @param mappingNames The mapping names which the listener will receive
+ * events from.
+ *
+ * @see InputManager#removeListener(com.jme3.input.controls.InputListener)
+ */
+ public void addListener(InputListener listener, String... mappingNames) {
+ for (String mappingName : mappingNames) {
+ Mapping mapping = mappings.get(mappingName);
+ if (mapping == null) {
+ mapping = new Mapping(mappingName);
+ mappings.put(mappingName, mapping);
+ }
+ if (!mapping.listeners.contains(listener)) {
+ mapping.listeners.add(listener);
+ }
+ }
+ }
+
+ /**
+ * Removes a listener from receiving events.
+ *
+ * InputManager
+ * will receive raw input events first, before they get handled
+ * by the InputManager itself. The listeners are
+ * each processed in the order they were added, e.g. FIFO.
+ * InputManager.
+ * This will query current input devices and send
+ * appropriate events to registered listeners.
+ *
+ * @param tpf Time per frame value.
+ */
+ public void update(float tpf) {
+ frameTPF = tpf;
+
+ // Activate safemode if the TPF value is so small
+ // that rounding errors are inevitable
+ safeMode = tpf < 0.015f;
+
+ long currentTime = keys.getInputTimeNanos();
+ frameDelta = currentTime - lastUpdateTime;
+
+ eventsPermitted = true;
+
+ keys.update();
+ mouse.update();
+ if (joystick != null) {
+ joystick.update();
+ }
+ if (touch != null) {
+ touch.update();
+ }
+
+ eventsPermitted = false;
+
+ processQueue();
+ invokeUpdateActions();
+
+ lastLastUpdateTime = lastUpdateTime;
+ lastUpdateTime = currentTime;
+ }
+
+ /**
+ * Dispatches touch events to touch listeners
+ * @param evt The touch event to be dispatched to all onTouch listeners
+ */
+ public void onTouchEventQueued(TouchEvent evt) {
+ ArrayList