Key codes

Every key and mouse button the engine knows has a #define in natiny.h, so nothing has to be written as a bare number:

if (natiny_input_get_key_down(NATINY_INPUT_KEY_W)) {
    y -= speed * dt;
}

if (natiny_input_get_mouse_button_pressed(NATINY_INPUT_MOUSE_BUTTON_LEFT)) {
    fire();
}

The constants are what natiny_input_get_key_down, natiny_input_get_key_pressed, natiny_input_get_key_released and the mouse button functions take. Values run to 348, well inside the 512 keys the engine tracks; a code outside that range reads as not pressed rather than an error. The Lua binding exposes the same numbers under the shorter natiny.input.KEY_W.

Printable keys - the value is the character's ASCII code

Editing and navigation

Locks and system keys

Function keys

Keypad

Modifiers

Mouse buttons

Notes

• The printable keys carry their own ASCII code, which is why NATINY_INPUT_KEY_A is 65 and not 0. That is a physical key on a US layout, not the character it types - for text, read natiny_input_get_char_at instead, which gives what the keyboard's own layout produced.
• The values follow GLFW, which is what the desktop backends report. On the web the browser's keyCode is translated to the same numbers, so a constant means the same key everywhere.
• Four constants never arrive from a browser, which has no keyCode of its own for them: NATINY_INPUT_KEY_KP_EQUAL, NATINY_INPUT_KEY_F25, NATINY_INPUT_KEY_WORLD_1 and NATINY_INPUT_KEY_WORLD_2.
• A browser also reports one code for each modifier pair, so on the web the left-hand constant stands for both: NATINY_INPUT_KEY_LEFT_SHIFT is true for either Shift, and NATINY_INPUT_KEY_RIGHT_SHIFT never fires. NATINY_INPUT_KEY_KP_ENTER arrives as NATINY_INPUT_KEY_ENTER for the same reason.
• NATINY_INPUT_KEY_PRINT_SCREEN reaches a desktop window on release only, which is what the operating system passes on.

See also

• natiny_input_get_key_down - is the key held this frame
• natiny_input_get_key_pressed - was it pressed this frame
• natiny_input_get_key_released - was it released this frame
• natiny_input_get_char_at - the characters typed this frame