pyxen.input.keyboard

키보드 상태와 텍스트 입력에 접근합니다.

kbd = pyxen.input.keyboard

버튼 모델

모든 키는 다음 속성을 가진 Button 객체를 반환합니다:

속성타입설명
downbool누르고 있는 동안 True
pressedbool키가 눌린 프레임에서 True
releasedbool키가 놓인 프레임에서 True
valuefloat아날로그 값 (보통 1.0 또는 0.0)

키보드 속성은 읽기 전용입니다.


키 접근

직접 속성

if kbd.a.pressed:
    print("A pressed")

문자열 인덱싱

if kbd["space"].down:
    print("Jump!")

키 이름이 유효하지 않으면:

kbd["unknown"]  # → None

텍스트 입력

text = kbd.text

이 프레임에 입력된 텍스트를 반환합니다 (UI 입력에 유용).


지원되는 키

  • 문자: "a" ~ "z" (대소문자 구분 없음)
  • 숫자: "0" ~ "9" 또는 "num_0" ~ "num_9"
  • 방향키: "left", "right", "up", "down"
  • 수정자: "left_shift", "right_ctrl"
  • 펑션 키: "f1" ~ "f12"
  • 기호: "minus", "equals", "comma"
  • 키패드: "keypad_0" ~ "keypad_9"

예시: 이동

if kbd.left.down:
    player.x -= 1

if kbd.right.down:
    player.x += 1

참고

  • 읽기 전용
  • 프레임 기반 상태
  • 매 업데이트마다 안전하게 쿼리 가능