input
*****

.. autonim:: input

This module allows you to read user input from the GBA's keypad.

**Example:**

.. code-block:: nim

  import natu/[video, irq, bios, input]
  
  dispcnt.init()
  irq.enable(iiVBlank)
  
  while true:
    VBlankIntrWait()
    
    # Update key state (call this once per frame.)
    keyPoll()
    
    # Change backdrop color when the player presses "A".
    if keyIsDown(kiA):
      bgColorMem[0] = rgb5(15, 31, 20)

-------------------------------------------------

Types
=====

.. autonim:: input.KeyIndex
.. autonim:: input.KeyState
.. autonim:: input.KeyInput
.. autonim:: input.KeyIntrOp
.. autonim:: input.KeyCnt

-------------------------------------------------

Globals
=========

.. autonim:: input.allKeys
.. autonim:: input.keyCurrState
.. autonim:: input.keyPrevState

-------------------------------------------------

Basic Procs
===========

.. autonim:: input.keyPoll
.. autonim:: input.keysDown
.. autonim:: input.keysUp
.. autonim:: input.keysHit
.. autonim:: input.keysReleased
.. autonim:: input.keyIsDown
.. autonim:: input.keyIsUp
.. autonim:: input.keyWasDown
.. autonim:: input.keyWasUp
.. autonim:: input.keyHit
.. autonim:: input.keyReleased
.. autonim:: input.anyKeyHit

-------------------------------------------------

Repeated Keys
=============

.. autonim:: input.keysRepeated
.. autonim:: input.keyRepeated
.. autonim:: input.setKeyRepeatMask
.. autonim:: input.setKeyRepeatDelay
.. autonim:: input.setKeyRepeatPeriod


-------------------------------------------------

I/O Registers
=============

.. autonim:: input.keyinput

.. autonim:: input.keycnt

.. autonim:: input.state