LuaDocs/UInputManager

From Data Realms Wiki

Contents 1 Has no parent class 2 Enumerations 2.1 Players 2.2 InputDevice 2.3 InputElements 2.4 MouseButtons 2.5 JoyButtons 2.6 JoyDirections 3 Functions 3.1 ElementPressed 3.2 ElementReleased 3.3 ElementHeld 3.4 KeyPressed 3.5 KeyReleased 3.6 KeyHeld 3.7 WhichKeyHeld 3.8 MouseButtonPressed 3.9 MouseButtonReleased 3.10 MouseButtonHeld 3.11 MouseWheelMoved 3.12 JoyButtonPressed 3.13 JoyButtonReleased 3.14 JoyButtonHeld 3.15 WhichJoyButtonPressed 3.16 JoyDirectionPressed 3.17 JoyDirectionReleased 3.18 JoyDirectionHeld 3.19 AnalogMoveValues 3.20 AnalogAimValues 3.21 SetMouseValueMagnitude 3.22 AnalogAxisValue 3.23 AnalogStickValues 3.24 MouseUsedByPlayer 3.25 AnyMouseButtonPress 3.26 TrapMousePos 3.27 GetMouseMovement 3.28 DisableMouseMoving 3.29 SetMousePos 3.30 ForceMouseWithinBox 3.31 ForceMouseWithinPlayerScreen 3.32 AnyJoyInput 3.33 AnyJoyPress 3.34 AnyJoyButtonPress 3.35 AnyInput 3.36 AnyPress 3.37 AnyStartPress

Has no parent class

Generic Class. The singleton manager over the user input.

Go back to Class Index

Enumerations

Players

• 0 = PLAYER_ONE
• 1 = PLAYER_TWO
• 2 = PLAYER_THREE
• 3 = PLAYER_FOUR
• 4 = MAX_PLAYERS

InputDevice

• 0 = DEVICE_KEYB_ONLY
• 1 = DEVICE_MOUSE_KEYB
• 2 = DEVICE_GAMEPAD_1
• 3 = DEVICE_GAMEPAD_2
• 4 = DEVICE_GAMEPAD_3
• 5 = DEVICE_GAMEPAD_4
• 6 = DEVICE_COUNT

InputElements

• 0 = INPUT_L_UP
• 1 = INPUT_L_DOWN
• 2 = INPUT_L_LEFT
• 3 = INPUT_L_RIGHT
• 4 = INPUT_R_UP
• 5 = INPUT_R_DOWN
• 6 = INPUT_R_LEFT
• 7 = INPUT_R_RIGHT
• 8 = INPUT_FIRE
• 9 = INPUT_AIM
• 10 = INPUT_AIM_UP
• 11 = INPUT_AIM_DOWN
• 12 = INPUT_AIM_LEFT
• 13 = INPUT_AIM_RIGHT
• 14 = INPUT_PIEMENU
• 15 = INPUT_JUMP
• 16 = INPUT_CROUCH
• 17 = INPUT_NEXT
• 18 = INPUT_PREV
• 19 = INPUT_START
• 20 = INPUT_BACK
• 21 = INPUT_COUNT

MouseButtons

• 0 = MOUSE_LEFT
• 1 = MOUSE_RIGHT
• 2 = MOUSE_MIDDLE
• 3 = MAX_MOUSE_BUTTONS

JoyButtons

• 0 = JOY_1
• 1 = JOY_2
• 2 = JOY_3
• 3 = JOY_4
• 4 = JOY_5
• 5 = JOY_6
• 6 = JOY_7
• 7 = JOY_8
• 8 = JOY_9
• 9 = JOY_10
• 10 = JOY_11
• 11 = JOY_12
• 12 = MAX_JOY_BUTTONS

JoyDirections

• 0 = JOYDIR_ONE
• 1 = JOYDIR_TWO

Functions

ElementPressed

Shows whether a specific input element was depressed between the last update and the one previous to it.

Arguments:

• Which player to check, and which element of that player.

Return value:

Pressed or not.

ElementReleased

Shows whether a specific input element was released between the last update and the one previous to it.

Arguments:

• Which player to check, and which element of that player.

Return value:

Pressed or not.

ElementHeld

Shows whether a specific input element was held during the last update.

Arguments:

• Which player to check, and which element of that player.

Return value:

Pressed or not.

KeyPressed

Shows whether a key was depressed between the last update and the one previous to it.

Arguments:

• A const char with the Allegro-defined key enumeration to test.

Return value:

Pressed or not.

KeyReleased

Shows whether a key was released between the last update and the one previous to it.

Arguments:

• A const char with the Allegro-defined key enumeration to test.

Return value:

Released or not.

KeyHeld

Shows whether a key is being held right now.

Arguments:

• A const char with the Allegro-defined key enumeration to test.

Return value:

Held or not.

WhichKeyHeld

Shows the scancode of the keyboard key which is currently down.

Arguments:

• None.

Return value:

The scancode (KEY_SPACE, etc) of the first keyboard key in the keyboard buffer. 0 means none.

MouseButtonPressed

Shows whether a mosue button was depressed between the last update and the one previous to it.

Arguments:

• Which button.

Return value:

Pressed or not.

MouseButtonReleased

Shows whether a mosue button was released between the last update and the one previous to it.

Arguments:

• Which button.

Return value:

Released or not.

MouseButtonHeld

Shows whether a mouse button is being held down right now.

Arguments:

• Which button.

Return value:

Held or not.

MouseWheelMoved

Shows whether a the mouse wheel has been moved past the threshold limit in either direction this frame.

Arguments:

• None.

Return value:

The direction the mouse wheel has been moved which is past tht threshold 0 means not past, negative means moved down, positive means moved up.

JoyButtonPressed

Shows whether a joy button was depressed between the last update and the one previous to it.

Arguments:

• Which joystick to check, and which button on that joystick.

Return value:

Pressed or not.

JoyButtonReleased

Shows whether a joy button was released between the last update and the one previous to it.

Arguments:

• Which joystick to check, and which button on that joystick.

Return value:

Released or not.

JoyButtonHeld

Shows whether a joystick button is being held down right now.

Arguments:

• Which joystick to check, and which button on that joystick.

Return value:

Held or not.

WhichJoyButtonPressed

Shows the first joystick button which was pressed down since last frame.

Arguments:

• Which joystick to check.

Return value:

The first button in the sequence of button enumerations (JOY_1, JOY_2, JOY_3) that is pressed since the previous frame. JOY_NONE means none.

JoyDirectionPressed

Shows whether a joystick axis direction was depressed between the last update and the one previous to it.

Arguments:

• Which joystick, stick, axis and direction to check.

Return value:

Pressed or not.

JoyDirectionReleased

Shows whether a joystick d-pad direction was released between the last update and the one previous to it.

Arguments:

• Which joystick, stick, axis and direction to check.

Return value:

Released or not.

JoyDirectionHeld

Shows whether a joystick axis is being held down in a specific direction right now. Two adjacent directions can be held down to produce diagonals.

Arguments:

• Which joystick, stick, axis and direction to check.

Return value:

Held or not.

AnalogMoveValues

Gets the analog moving values of a specific player's control scheme.

Arguments:

• Which player to get em for.

Return value:

The analog axis values ranging between -1.0 to 1.0, in both axes.

AnalogAimValues

Gets the analog aiming values of a specific player's control scheme.

Arguments:

• Which player to get em for.

Return value:

The analog axis values ranging between -1.0 to 1.0, in both axes.

SetMouseValueMagnitude

Set the mouse's analog emualtion output to be of a specific normalized magnitude.

Arguments:

• The normalized magnitude, between 0 and 1.0.

Return value:

None.

AnalogAxisValue

Gets the normalized value of a certain joystick's stick's axis.

Arguments:

• Which joystick, stick and axis to check.

Return value:

The analog axis value ranging between -1.0 to 1.0, or 0.0 to 1.0 if it's a throttle type control.

AnalogStickValues

Gets the analog values of a certain joystick device stick.

Arguments:

• Which joystick to check, and which stick on that joystick device.

Return value:

The analog axis values ranging between -1.0 to 1.0.

MouseUsedByPlayer

Reports if any, and which player is using the mouse for control at this time.

Arguments:

• None.

Return value:

Which player is using the mouse. If noone is, then -1 is returned;

AnyMouseButtonPress

Return true if there is any mouse button presses at all

Arguments:

• None.

Return value:

Whether any mouse buttons have been pressed at all since last frame

TrapMousePos

Sets the mouse to be trapped in the middle of the screen, so it doesn't go out and click on other windows etc. This is usually used when the cursor is invisible and only relative mouse movements are used.

Arguments:

• Whether to trap the mouse or not.
• Which player is trying ot control the mouse. Only the player with actual control over the mouse will affect its trapping here. -1 means change mouse trapping regardless of player.

Return value:

None.

GetMouseMovement

Gets the relative movement of the mouse since last update. Only returns true if the selected player actuall is using the mouse.

Arguments:

• Which player to get em for. If the player doesn't use the mouse, then this always returns a zero vector.

Return value:

The relative mouse movements, in both axes.

DisableMouseMoving

Will temporarily disable positioniong of the mouse. This is so that when focus is swtiched back to the game window, it avoids having the window fly away because the user clicked the title bar of the window.

Arguments:

• Whether to disable or not.

Return value:

None.

SetMousePos

Sets the absolute screen position of the mouse cursor.

Arguments:

• Where to place the mouse.
• Which player is trying ot control the mouse. Only the player with actual control over the mouse will affect its trapping here. -1 means do it regardless of player.

Return value:

None.

ForceMouseWithinBox

Forces the mouse within a box on the screen.

Arguments:

• The top left corner of the screen box to keep the mouse within, in screen coodinates.
• The dimensions of the box, width/height.
• Which player is trying ot control the mouse. Only the player with actual control over the mouse will affect its trapping here. -1 means do it regardless of player.

Return value:

None.

ForceMouseWithinPlayerScreen

Forces the mouse within a specific player's screen area.

Arguments:

• Which player's screen's are to constrain the mouse to. Only the player with actual control over the mouse will affect its trapping here.

Return value:

None.

AnyJoyInput

Return true if there is any joystick input at all, buttons or d-pad.

Arguments:

• None.

Return value:

Whether any buttons of pads are pressed at all.

AnyJoyPress

Return true if there is any joystick presses at all, buttons or d-pad.

Arguments:

• None.

Return value:

Whether any buttons or pads have been pressed at all since last frame.

AnyJoyButtonPress

Return true if there is any joystick button presses at all, but not d-pad input, for a specific joystick.

Arguments:

• None.

Return value:

Whether any joy buttons have been pressed at all since last frame, of a specific joystick.

AnyInput

Return true if there is any input at all, keyboard or buttons or d-pad.

Arguments:

• None.

Return value:

Whether any buttons of pads are pressed at all.

AnyPress

Return true if there is any key, button, or d-pad presses at all. MUST call Update before calling this for it to work properly!

Arguments:

• None.

Return value:

Whether any buttons of pads have been pressed at all since last frame.

AnyStartPress

Return true if there is any start key/button presses at all. MUST call Update before calling this for it to work properly!

Arguments:

• None.

Return value:

Whether any start buttons or keys have been pressed at all since last frame.

Go back to Class Index