Binding of Isaac - Afterbirth+ Lua Reference/Guide
Input Namespace Reference

Functions

boolean IsButtonTriggered (integer button, integer controllerId)
 
boolean IsButtonPressed (integer button, integer controllerId)
 
float GetButtonValue (integer button, integer controllerId)
 
boolean IsActionTriggered (integer action, integer controllerId)
 
boolean IsActionPressed (integer action, integer controllerId)
 
float GetActionValue (integer action, integer controllerId)
 
boolean IsMouseBtnPressed (integer button)
 
Vector GetMousePosition (boolean gameCoords)
 

Function Documentation

◆ GetActionValue()

float Input::GetActionValue ( integer  action,
integer  controllerId 
)

Returns the current strength in which a button was pressed. This is 0 OR 1 with a keyboard. With a controller, this can be used to get the strength in which you have moved the analog stick in a direction.

This code prints the current "strength" in which the analog stick was moved to the left.
print(Input.GetActionValue(ButtonAction.ACTION_LEFT, 1))   

◆ GetButtonValue()

float Input::GetButtonValue ( integer  button,
integer  controllerId 
)

Use "GetActionValue" instead of this function.

◆ GetMousePosition()

Vector Input::GetMousePosition ( boolean  gameCoords)

Returns the current mouse position in game coordinates (true) or render coordinates.

This code renders "Hello World!" at the current mouse position.
local mousePos = Isaac.WorldToScreen(Input.GetMousePosition(true))-- transfer game- in screen coordinates
Isaac.RenderText("Hello World!", mousePos.X, mousePos.Y, 1 ,1 ,1 ,1 )

◆ IsActionPressed()

boolean Input::IsActionPressed ( integer  action,
integer  controllerId 
)

Returns, if an action-button is pressed or not. An Action-button is any button that got a default function assigned to it. This function will return true, as long the button is held down.

List of all Action enums

This code prints "bomb Button pressed", when any button was pressed that is assigned to the "place bomb" function.
if Input.IsActionPressed(ButtonAction.ACTION_BOMB, 0)  then
    print("bomb Button pressed")   
end

◆ IsActionTriggered()

boolean Input::IsActionTriggered ( integer  action,
integer  controllerId 
)

Returns, if an action-button was pressed some time before or not. An Action-button is any button that got a default function assigned to it. This functions will only return true, if the button was pressed down. It will no longer return true, after you called this function and try to call it in the next update cycle (for example in the next render cycle).

List of all Action enums

This code prints "bomb Button pressed", when any button was pressed that is assigned to the "place bomb" function.
if Input.IsActionTriggered(ButtonAction.ACTION_BOMB, 0)  then
    print("bomb Button pressed")   
end

◆ IsButtonPressed()

boolean Input::IsButtonPressed ( integer  button,
integer  controllerId 
)

Returns, if a button is pressed or not. This function will return true, as long the button is held down.

List of all key enums

This code prints "Enter Button pressed", when the "Enter"-Button was pressed.
if Input.IsButtonPressed(Keyboard.KEY_ENTER, 0)  then
    print("Enter Button pressed.")   
end

◆ IsButtonTriggered()

boolean Input::IsButtonTriggered ( integer  button,
integer  controllerId 
)

Returns, if a button was pressed some time before or not. This functions will only return true, if the button was pressed down. It will no longer return true, after you called this function and try to call it in the next update cycle (for example in the next render cycle).

List of all key enums

This code prints "Enter Button was pressed", when the "Enter"-Button was pressed.
if Input.IsButtonTriggered(Keyboard.KEY_ENTER, 0)  then
    print("Enter Button was pressed.")   
end

◆ IsMouseBtnPressed()

boolean Input::IsMouseBtnPressed ( integer  button)

Returns, if a mousebutton is pressed or not.

Left: 0, Right: 1, mousewheel: 2, back button: 3, forward button: 4

This code prints "Right Click", when the "right"-mousebutton was pressed.
if Input.IsMouseBtnPressed(1)  then
    print("Right Click")   
end