Input API

Check keyboard and mouse input state.

Functions

is_key_down()

Check if a key is currently pressed.

local pressed = kinetic.input.is_key_down(vk_code)

Parameters:

• vk_code (number) - Virtual key code

Common Key Codes:

0x45  -- E key
0x51  -- Q key
0x52  -- R key
0x46  -- F key
0x20  -- Space
0x10  -- Shift
0x11  -- Ctrl
0x12  -- Alt

Example:

if kinetic.input.is_key_down(0x45) then
    print("E key is pressed")
end

is_mouse_down()

Check if a mouse button is pressed.

local pressed = kinetic.input.is_mouse_down(button)

Parameters:

• button (number) - 1 = left, 2 = right, 3 = middle

Example:

if kinetic.input.is_mouse_down(1) then
    print("Left mouse button pressed")
end

if kinetic.input.is_mouse_down(2) then
    print("Right mouse button pressed")
end

get_mouse_pos()

Get current mouse position.

local pos = kinetic.input.get_mouse_pos()

Returns: Table with x and y coordinates

Example:

local mouse = kinetic.input.get_mouse_pos()
print("Mouse at: " .. mouse.x .. ", " .. mouse.y)

Complete Examples

Key Toggle

local toggle_key = 0x45  -- E key
local was_pressed = false
local feature_enabled = false

kinetic.on_frame = function(delta_time)
    local is_pressed = kinetic.input.is_key_down(toggle_key)
    
    -- Detect key press (not hold)
    if is_pressed and not was_pressed then
        feature_enabled = not feature_enabled
        kinetic.notify("Feature", feature_enabled and "Enabled" or "Disabled", 1.0)
    end
    
    was_pressed = is_pressed
end

Mouse Tracker

kinetic.on_frame = function(delta_time)
    local mouse = kinetic.input.get_mouse_pos()
    
    -- Draw crosshair at mouse
    kinetic.draw.circle({mouse.x, mouse.y}, {255, 0, 0}, 5)
    
    -- Show coordinates
    kinetic.draw.text({mouse.x + 10, mouse.y}, {255, 255, 255}, 
        string.format("(%d, %d)", mouse.x, mouse.y))
end

Virtual Key Codes Reference

Key	Code	Key	Code
A-Z	0x41-0x5A	0-9	0x30-0x39
F1-F12	0x70-0x7B	Space	0x20
Shift	0x10	Ctrl	0x11
Alt	0x12	Tab	0x09
Enter	0x0D	Esc	0x1B

Full list

Next Steps

• System API - Core functions

• Drawing API - Draw based on input