bindKey

Faz uma função rodar sempre que uma tecla é pressionada ou solta.

Sintaxe

bool bindKey ( string tecla, string estado, function callback [, ... ] )
bool bindKey ( string tecla, string estado, string nomeDoComando [, string argumentos ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
tecla	string	—	Nome da tecla. Veja a tabela acima.
estado	string	—	"down" para o momento de pressionar, "up" para o de soltar, "both" para os dois.
callback	function	—	Função a executar.
...	any	—	Argumentos extras repassados à função a cada disparo.
nomeDoComando	string	—	Comando a executar no lugar de uma função.
argumentos	string	""	String única de argumento entregue a esse comando.

A função é chamada como callback(tecla, estado, ...): o primeiro argumento é o nome da tecla e o segundo é "down" ou "up". Só depois vêm os argumentos extras que você passou.

Retorno

true se o vínculo foi criado — num vínculo de comando, também quando um vínculo idêntico já existe. false, em silêncio, se o nome da tecla não for reconhecido ou o nome do comando for vazio. Um primeiro ou segundo argumento que não seja texto, ou um terceiro argumento que não seja nem função nem string, registra um aviso no console de debug e devolve false.

Um vínculo de função também aceita o nome de um controle do jogo ("fire", "jump", …) no lugar da tecla: a função passa a disparar nas teclas que o jogador mapeou para aquele controle.

Você pode vincular várias funções à mesma tecla; todas rodam.