pyxen.input.keyboard
키보드 상태와 텍스트 입력에 접근합니다.
kbd = pyxen.input.keyboard
버튼 모델
모든 키는 다음 속성을 가진 Button 객체를 반환합니다:
| 속성 | 타입 | 설명 |
|---|---|---|
down | bool | 누르고 있는 동안 True |
pressed | bool | 키가 눌린 프레임에서 True |
released | bool | 키가 놓인 프레임에서 True |
value | float | 아날로그 값 (보통 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
참고
- 읽기 전용
- 프레임 기반 상태
- 매 업데이트마다 안전하게 쿼리 가능