|
libgdx API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Input
Interface to the input facilities. This allows to poll the state of the keyboard, touch screen and accelerometer. On the desktop the touch screen is replaced by mouse input, the accelerometer is of course not available.
Additionally one can process events with an InputProcessor
with this module. You can set the InputProcessor via the
setInputProcessor(InputProcessor)
method. It will be called before the ApplicationListener.render()
method in
each frame.
Keyboard keys are translated to the constants in Input.Keys
transparantely on all systems. Do not use system specific key
constants.
The class also offers methods to let the phone vibrate as well as getting compass readings.
Nested Class Summary | |
---|---|
static class |
Input.Buttons
Mouse buttons. |
static class |
Input.Keys
Keys. |
static class |
Input.Orientation
|
static class |
Input.Peripheral
Enumeration of potentially available peripherals. |
static interface |
Input.TextInputListener
Callback interface for getTextInput(TextInputListener, String, String) |
Method Summary | |
---|---|
void |
cancelVibrate()
Stops the vibrator |
float |
getAccelerometerX()
|
float |
getAccelerometerY()
|
float |
getAccelerometerZ()
|
float |
getAzimuth()
The azimuth is the angle of the device's orientation around the z-axis. |
long |
getCurrentEventTime()
|
int |
getDeltaX()
|
int |
getDeltaX(int pointer)
|
int |
getDeltaY()
|
int |
getDeltaY(int pointer)
|
InputProcessor |
getInputProcessor()
|
Input.Orientation |
getNativeOrientation()
|
float |
getPitch()
The pitch is the angle of the device's orientation around the x-axis. |
void |
getPlaceholderTextInput(Input.TextInputListener listener,
java.lang.String title,
java.lang.String placeholder)
System dependent method to input a string of text. |
float |
getRoll()
The roll is the angle of the device's orientation around the y-axis. |
int |
getRotation()
|
void |
getRotationMatrix(float[] matrix)
Returns the rotation matrix describing the devices rotation as per SensorManager#getRotationMatrix(float[], float[], float[], float[]). |
void |
getTextInput(Input.TextInputListener listener,
java.lang.String title,
java.lang.String text)
System dependent method to input a string of text. |
int |
getX()
|
int |
getX(int pointer)
Returns the x coordinate in screen coordinates of the given pointer. |
int |
getY()
|
int |
getY(int pointer)
Returns the y coordinate in screen coordinates of the given pointer. |
boolean |
isButtonPressed(int button)
Whether a given button is pressed or not. |
boolean |
isCursorCatched()
|
boolean |
isKeyPressed(int key)
Returns whether the key is pressed. |
boolean |
isPeripheralAvailable(Input.Peripheral peripheral)
Queries whether a Input.Peripheral is currently available. |
boolean |
isTouched()
|
boolean |
isTouched(int pointer)
Whether the screen is currently touched by the pointer with the given index. |
boolean |
justTouched()
|
void |
setCatchBackKey(boolean catchBack)
Sets whether the BACK button on Android should be caught. |
void |
setCatchMenuKey(boolean catchMenu)
Sets whether the MENU button on Android should be caught. |
void |
setCursorCatched(boolean catched)
Only viable on the desktop. |
void |
setCursorPosition(int x,
int y)
Only viable on the desktop. |
void |
setInputProcessor(InputProcessor processor)
Sets the InputProcessor that will receive all touch and key input events. |
void |
setOnscreenKeyboardVisible(boolean visible)
Sets the on-screen keyboard visible if available. |
void |
vibrate(int milliseconds)
Vibrates for the given amount of time. |
void |
vibrate(long[] pattern,
int repeat)
Vibrate with a given pattern. |
Method Detail |
---|
float getAccelerometerX()
float getAccelerometerY()
float getAccelerometerZ()
int getX()
int getX(int pointer)
pointer
- the pointer id.
int getDeltaX()
int getDeltaX(int pointer)
int getY()
int getY(int pointer)
pointer
- the pointer id.
int getDeltaY()
int getDeltaY(int pointer)
boolean isTouched()
boolean justTouched()
boolean isTouched(int pointer)
pointer
- the pointer
boolean isButtonPressed(int button)
Input.Buttons
. On Android only the Button#LEFT
constant is meaningful.
button
- the button to check.
boolean isKeyPressed(int key)
key
- The key code as found in Input.Keys
.
void getTextInput(Input.TextInputListener listener, java.lang.String title, java.lang.String text)
Input.TextInputListener
will be called on the rendering
thread.
listener
- The TextInputListener.title
- The title of the text input dialog.text
- The message presented to the user.void getPlaceholderTextInput(Input.TextInputListener listener, java.lang.String title, java.lang.String placeholder)
Input.TextInputListener
will be called on the
rendering thread.
listener
- The TextInputListener.title
- The title of the text input dialog.placeholder
- The placeholder text presented to the user.void setOnscreenKeyboardVisible(boolean visible)
visible
- visible or notvoid vibrate(int milliseconds)
in your manifest file in order for this to work.
milliseconds
- the number of milliseconds to vibrate.void vibrate(long[] pattern, int repeat)
pattern
- an array of longs of times to turn the vibrator on or off.repeat
- the index into pattern at which to repeat, or -1 if you don't want to repeat.void cancelVibrate()
float getAzimuth()
float getPitch()
float getRoll()
void getRotationMatrix(float[] matrix)
matrix
- long getCurrentEventTime()
InputProcessor
.void setCatchBackKey(boolean catchBack)
catchBack
- whether to catch the back buttonvoid setCatchMenuKey(boolean catchMenu)
catchMenu
- whether to catch the back buttonvoid setInputProcessor(InputProcessor processor)
InputProcessor
that will receive all touch and key input events. It will be called before the
ApplicationListener.render()
method each frame.
processor
- the InputProcessorInputProcessor getInputProcessor()
InputProcessor
or null.boolean isPeripheralAvailable(Input.Peripheral peripheral)
Input.Peripheral
is currently available. In case of Android and the Input.Peripheral.HardwareKeyboard
this returns the whether the keyboard is currently slid out or not.
peripheral
- the Input.Peripheral
int getRotation()
Input.Orientation getNativeOrientation()
void setCursorCatched(boolean catched)
catched
- whether to catch or not to catch the mouse cursorboolean isCursorCatched()
void setCursorPosition(int x, int y)
x
- the x-positiony
- the y-position
|
libgdx API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |