Pyglet 헬로 월드: Python으로 첫 게임 창 만들기

Pyglet 마법을 뿌리기 전에 기초를 단단히 다져봅시다. Python 3.7 이상이 필요합니다. 대부분의 시스템에는 이미 설치되어 있을 것이지만, 항상 확인하는 것이 좋습니다. 터미널 또는 명령 프롬프트를 열고 Python에 무엇을 하고 있었는지 물어보세요:

python --version

Python 3.x.x가 표시되지 않으면 python.org를 방문하여 설치하세요. Python이 확인되면, 가상 환경으로 깔끔하고 깨끗한 작업 공간을 만들어 봅시다:

# 프로젝트 폴더로 이동한 후 생성하세요:
python -m venv .venv

그리고 마법을 부리듯 활성화하세요. 터미널 프롬프트에 (.venv) 접두사가 붙어 격리된 원더랜드에 있다는 것을 미묘하게 알려줍니다:

# macOS/Linux에서
source .venv/bin/activate

# Windows에서 (명령 프롬프트 사용)
.venv\Scripts\activate

가상 환경이 원활하게 작동하면 Pyglet을 프로젝트에 통합하는 것은 간단합니다. 단 하나의 명령어로 pip가 나머지를 처리하여 Python 패키지 인덱스에서 Pyglet을 가져와 격리된 프로젝트 공간에 깔끔하게 넣어줍니다.

활성화된 터미널에 이 명령을 입력하세요:

pip install pyglet

Pyglet 및 필요한 하위 종속성이 다운로드 및 설치될 때 텍스트가 빠르게 표시되는 것을 볼 수 있습니다. 완료되면 공식적으로 창을 표시하기 시작할 준비가 된 것입니다! 이는 첫 번째 붓질을 위해 이젤을 설치하고 물감을 준비하는 것과 같습니다.

모든 훌륭한 시각적 애플리케이션은 캔버스에서 시작되며, Pyglet에서는 창이 바로 그것입니다. 가장 기본적인 요소이지만 가능성의 세계를 열어줍니다. main.py와 같은 새 파일을 만들고 가장 간단한 창 만들기 주문을 넣어 봅시다.

이 스니펫을 main.py 파일에 복사하여 붙여넣으세요:

import pyglet

# 창 생성
window = pyglet.window.Window(width=800, height=600, caption='Hello Pyglet!')

# 애플리케이션 실행
pyglet.app.run()

이제 파일을 저장하고 *활성화된* 터미널에서 실행하세요:

python main.py

제목 표시줄에 "Hello Pyglet!"이라고 표시된 꽤 평범하고 빈 창이 나타날 것입니다. 겸손한 시작일 수 있지만, 상당한 성과입니다!

마지막 단계의 코드 조각은 실제로 많은 것을 했습니다. 창을 생명으로 만든 두 줄을 살펴보겠습니다.

• import pyglet: 이 줄은 진입점이며, Python에게 Pyglet 라이브러리를 사용하겠다는 것을 알립니다. 도구 상자를 여는 것으로 생각하세요.
• window = pyglet.window.Window(...): 여기서는 Pyglet의 Window 클래스의 인스턴스를 생성하고 있습니다. 몇 가지 인수를 전달했습니다:
  • width 및 height: 창의 크기를 픽셀 단위로 설정합니다.
  • caption: 창의 제목 표시줄에 나타나는 텍스트로, 이름표 역할을 합니다.
  `resizable=True` 또는 `fullscreen=True`와 같은 다른 옵션으로 더 멋지게 만들 수 있지만, "Hello World"에는 이 정도면 충분합니다.
• pyglet.app.run(): 이것이 대지휘자입니다. Pyglet의 메인 이벤트 루프를 시작합니다. 본질적으로 애플리케이션을 대기 상태로 만들어 마우스 클릭, 키 입력 또는 운영 체제가 "이 창을 다시 그려야 합니다!"라고 말하는 것과 같은 이벤트에 귀를 기울이게 합니다. 이 줄이 없으면 창이 "Pyglet!"이라고 말할 수 없을 정도로 빠르게 깜박였다가 사라질 것입니다.

거의 모든 Pyglet 애플리케이션에 대한 기본 패턴입니다. 무대를 설정하고 쇼를 시작하도록 지시합니다.

빈 창은 빈 무대와 같습니다. 기능적이지만 개성이 부족합니다. 존재감을 제대로 알리기 위해 텍스트를 넣어봅시다. Pyglet은 이를 위해 편리한 Label 클래스를 제공하여 텍스트 표시를 놀랍도록 쉽게 만듭니다.

main.py를 다음과 같이 업데이트하세요:

import pyglet

window = pyglet.window.Window(800, 600, caption='Hello Pyglet!')

# Label 객체 생성
hello_label = pyglet.text.Label(
    'Hello World!',
    font_name='Times New Roman',
    font_size=36,
    x=window.width//2, y=window.height//2,
    anchor_x='center', anchor_y='center',
    color=(255, 255, 255, 255) # RGBA: 흰색, 불투명
)

# 함수를 이벤트 핸들러로 등록하는 데코레이터
@window.event
def on_draw():
    window.clear() # 먼저 창을 지우세요
    hello_label.draw() # 그런 다음 라벨을 그리세요

pyglet.app.run()

main.py의 새 버전을 실행하세요. 이제 창 중앙에 "Hello World!"가 멋지게 표시될 것입니다. 마치 걸작에 헤드라인을 추가하는 것과 같습니다.

@window.event와 on_draw()를 보셨을 겁니다. 이들은 Pyglet에서 시각적인 모든 것에 매우 중요합니다. 앞에서 언급한 이벤트 루프는 사용자 입력뿐만 아니라 창이 자체를 다시 그려야 할 때를 결정하기도 합니다. on_draw가 나오는 곳입니다.

• @window.event: 이 Python 데코레이터는 Pyglet이 "window 객체가 on_draw라는 '이벤트'를 처리해야 할 때마다 이 함수를 호출합니다."라고 말하는 방법입니다. 마치 스테이지 매니저에게 '커튼 콜' 이벤트를 누가 처리하는지 정확히 알려주는 것과 같습니다.
• def on_draw():: 이 함수는 *그 순간* 창에 무엇이 보일지에 대한 모든 지침을 포함합니다. 창이 최소화되거나 크기가 조정된 후, 또는 단순히 애니메이션의 다음 프레임을 표시할 때가 되었기 때문에 디스플레이를 새로 고쳐야 할 때마다 자동으로 호출됩니다.
• window.clear(): 새로운 것을 그리기 전에, 판을 깨끗이 지우는 것이 좋습니다. 이렇게 하면 창 전체가 지워져 유령처럼 남은 이전 그림이 남지 않습니다.
• hello_label.draw(): 마지막으로 hello_label 객체에게 지워진 창에 자신을 그리도록 지시합니다. 그리기 순서가 중요하므로 마지막에 그리는 것이 맨 위에 나타납니다.

on_draw를 이해하는 것이 핵심입니다. 모든 렌더링의 중앙 허브입니다. 텍스트, 이미지, 복잡한 3D 모델에 이르기까지 모든 그래픽 요소는 결국 이 함수를 통해 표시됩니다. 애플리케이션의 시각적 출력을 위한 심장 박동으로 간주하세요.

정적인 이미지는 좋지만, 재미는 인터랙티브한 경험에서 시작됩니다. 이벤트 기반 프레임워크인 Pyglet은 사용자 입력을 쉽게 처리할 수 있도록 합니다. 키 입력에 응답하도록 간단한 키보드 핸들러를 추가하여 창이 응답하도록 해봅시다. 예를 들어 Escape 키를 눌러 창을 닫아봅시다.

on_draw 함수 바로 아래에 이 새 이벤트 핸들러를 main.py에 추가하세요:

# ... (창 및 라벨에 대한 이전 코드) ...

@window.event
def on_draw():
    window.clear()
    hello_label.draw()

# 키 입력 확인을 위해 keys 모듈 가져오기
import pyglet.window.key as key

@window.event
def on_key_press(symbol, modifiers):
    if symbol == key.ESCAPE:
        pyglet.app.exit() # 애플리케이션 종료

pyglet.app.run()

스크립트를 다시 실행하고 `Escape` 키를 눌러보세요. 뿅! 창이 사라질 것입니다. on_key_press 함수는 또 다른 특별한 이벤트 핸들러로, 사용자의 손가락이 키보드를 누르는 순간을 감지합니다. 특정 신호가 주어졌을 때 행동을 수행할 준비가 된 백스테이지의 작은 진행 요원과 같습니다.

키보드는 훌륭하지만, 때로는 좋은 클릭이 필요할 때도 있습니다. Pyglet은 마우스 입력에 대해 유사한 이벤트 핸들러를 제공합니다. 마우스 버튼을 클릭할 때마다 "Hello World!" 라벨의 메시지를 변경해 봅시다.

main.py에 다음 on_mouse_press 함수를 추가하세요:

# ... (이전 코드) ...

# 클릭 횟수 추적
click_count = 0

@window.event
def on_mouse_press(x, y, button, modifiers):
    global click_count # 전역 변수를 수정해야 합니다.
    click_count += 1
    hello_label.text = f'You clicked {click_count} times!'

# ... (on_key_press 및 pyglet.app.run()은 동일하게 유지) ...

실행하면 창 안 어디든 클릭하면 텍스트가 업데이트됩니다. on_mouse_press가 클릭이 발생한 위치(x, y 좌표), 눌린 버튼, 수정자 키(Shift 또는 Ctrl 등)에 대한 정보를 어떻게 얻는지 주목하세요. 마우스를 위한 소형 감시 시스템과 같으며 항상 보고할 준비가 되어 있습니다.

창, 텍스트, 사용자 입력에 응답하는 몇 가지 방법을 다뤘습니다. Pyglet의 우아함을 진정으로 보여주는 하나의 일관된 "Hello World" 스크립트로 모든 것을 종합해 봅시다. 이 통합 버전은 Pyglet 프로젝트를 시작할 때 일반적으로 사용하게 될 것입니다.

main.py의 완전하고 세련된 버전입니다:

import pyglet
import pyglet.window.key as key # 키보드 이벤트용

# 1. 창 설정
window = pyglet.window.Window(width=800, height=600, caption='Pyglet Interactive Hello World', resizable=True)

# 2. 시각적 요소 준비
click_count = 0
hello_label = pyglet.text.Label(
    'Hello World!',
    font_name='Arial',
    font_size=28,
    x=window.width//2, y=window.height//2,
    anchor_x='center', anchor_y='center',
    color=(255, 255, 255, 255) # 흰색 텍스트
)

# 3. 이벤트 핸들러 정의

@window.event
def on_draw():
    window.clear()
    hello_label.draw()

@window.event
def on_key_press(symbol, modifiers):
    if symbol == key.ESCAPE:
        pyglet.app.exit()
    elif symbol == key.SPACE:
        hello_label.text = "Spacebar pressed! Hello again!"
    elif symbol == key.BACKSPACE:
        hello_label.text = "Back to basics: Hello World!"


@window.event
def on_mouse_press(x, y, button, modifiers):
    global click_count
    click_count += 1
    hello_label.text = f'Mouse clicked {click_count} times!'

# 창 크기가 조정되면 라벨 위치 업데이트
@window.event
def on_resize(width, height):
    hello_label.x = width // 2
    hello_label.y = height // 2
    print(f"Window resized to {width}x{height}") # 디버깅용

# 4. 애플리케이션 실행
pyglet.app.run()

이제 이 버전을 저장하고 실행하세요. 마우스를 클릭하고, `Space`, `Backspace`, `Escape` 키를 눌러보세요. 본질적으로 Pyglet을 사용하여 화면의 동작과 반응을 안무하는 방법을 보여주는 작지만 강력한 인터랙티브 데모를 구축했습니다. 모든 이벤트를 음표로, 코드를 악보로 삼아 미니 오케스트라를 지휘하는 것과 같습니다.

공식적으로 첫 Pyglet "Hello World" 애플리케이션을 만들었습니다! 빈 캔버스에서 인터랙티브 디스플레이까지, 창 생성, 텍스트 표시, 사용자 입력 응답 등 핵심 구성 요소를 실제로 보았습니다. 이 기초는 훨씬 더 복잡한 것을 구축하기에 놀랍도록 강력합니다.

이제 어디로 가야 할까요? 세상, 적어도 Pyglet 세상은 여러분의 것입니다:

• 이미지 및 스프라이트: 이미지를 로드하고 그려 게임에 생명을 불어넣으세요. Pyglet은 다양한 형식을 쉽게 처리합니다.
• 애니메이션: 움직이세요! Pyglet의 시계를 사용하여 시간 이벤트와 부드러운 애니메이션을 만드세요.
• 오디오 및 비디오: 사운드 효과, 배경 음악을 추가하거나 애플리케이션에 비디오를 직접 포함할 수도 있습니다.
• 게임 루프 및 배치: 더 복잡한 프로젝트를 위해서는 효율적인 렌더링 기술과 많은 개체 관리에 대해 더 깊이 파고들게 될 것입니다.
• 입력 장치: 마우스와 키보드 외에도 조이스틱 및 게임패드 지원을 탐색하세요.

이 "Hello World"를 그네를 부드럽게 밀기 시작하는 것으로 생각하세요. 이제 추진력을 얻었습니다. 다음 단계는 얼마나 높이 올라가고 싶은지에 달려 있습니다. 계속해서 실험하고, 계속해서 탐색하고, Pyglet으로 Python 창작물에 생명을 불어넣는 것을 즐기세요!