key

Este modulo contiene funciones para gestionar el dispositivo de teclado.

La cola de eventos obtiene eventos como pygame.KEYDOWN y pygame.KEYUP cuando se pulsan o sueltan las teclas del teclado respectivamente. Cada evento tiene una atributo llamado key que es un identificador en entero que representa cada tecla del teclado.

El evento pygame.KEYDOWN tiene un atributo adicional llamado unicode, y otro scancode. unicode representa un único caracter que es la traducción completa del caracter ingresado por teclado. Teniendo en cuenta las teclas de composición y mayúsculas. scancode representa el código de tecla específico de la plataforma. Este código podría ser diferente de un teclado a otro, aunque es útil para la selección de teclas raras como las teclas multimedia.

Existen muchas constantes de teclado que se utilizadan para representar teclas. La siguiente es una lista con todas esas constantes:

El telcado tambien tiene una lista de estados de combinaciones que pueden ser montados a través de una lógica binaria.

• KMOD_NONE
• KMOD_LSHIFT
• KMOD_RSHIFT
• KMOD_SHIFT
• KMOD_CAPS
• KMOD_LCTRL
• KMOD_RCTRL
• KMOD_CTRL
• KMOD_LALT
• KMOD_RALT
• KMOD_ALT
• KMOD_LMETA
• KMOD_RMETA
• KMOD_META
• KMOD_NUM
• KMOD_MODE

pygame.key.get_focused() -> return bool

Esta función devuelve verdadero cuando la ventana de visualización contiene el foco del teclado. Si se necesita que la ventana no pierda el foco del teclado, se puede utilizar pygame.event.set_grab para capturar todas las entradas de teclado.

• buscar código donde se use esta función.

pygame.key.get_pressed() -> return bools

Devuelve una secuencia de valores lógicos (booleans) representando el estado de cada tecla en el teclado. Utilice los valores de constante de tecla como índice de la secuencia. Un valor verdadero significa que el botón esta presionado.

Tenga en cuenta que obtener la lista de las teclas pulsadas con esta función no es la forma apropiada de gestionar la entrada de texto por parte del usuario. No hay forma de conocer el orden de las teclas pulsadas, y las pulsaciones muy rápidas de teclas pueden pasar desapercibidas entre dos llamadas a get_pressed. Tampoco hay forma de trasladar las teclas pulsadas a un valor de caracter completamente imprimible.

Vea el evento pygame.KEYDOWN de la cola de eventos para desarrollar esta funcionalidad.

• buscar código donde se use esta función.

pygame.key.get_mods() -> return int

Devuelve un entero representando una mascara con todos las teclas que estan siendo presionadas. Utilizando lógica binaria puedes verificar si una tecla como shift está pulsada, el estado de capslock y más.

• buscar código donde se use esta función.

 pygame.key.set_mods(int) -> return None 

Crea una mascara binaria con las constantes de las teclas que deseas imponer sobre tu programa.

• buscar código donde se use esta función.

pygame.key.set_repeat() -> return None
pygame.key.set_repeat(delay, interval) -> return None

Cuando la funcionalidad de repetición de teclas está habilitada en el teclado, las teclas que quedan presionadas generan múltiples eventos de tipo pygame.KEYDOWN. El parrámetro delay (tiempo de retraso) es el número de milisegundos transcurridos antes de enviar el primer evento. Luego el resto de los eventos se enviarán en ese intervalo de milisegundos.

Si no especifica argumentos la repetición de teclas quedará deshabilitada.

Cuando se inicializa pygame la repetición de teclas está deshabilitada.

• buscar código donde se use esta función.

 pygame.key.get_repeat() -> return (delay, interval) 

Esta función cumple una tarea similar a set_repeat, solo que nos muestra el intervalo de milisegundos en lugar de definirlo.

• buscar código donde se use esta función.

 pygame.key.name(key) -> return string 

Devuelve el nombre descriptivo de la constante del telclado.

• buscar código donde se use esta función.