Pygletハローワールド：Pythonで最初のゲームウィンドウを作成する

Pygletのマジックを散りばめる前に、基盤をしっかりさせましょう。Python 3.7以上が必要です。ほとんどのシステムにはありますが、念のため確認しておくと良いでしょう。ターミナルまたはコマンドプロンプトを開き、Pythonに何ができるか尋ねてみてください。

python --version

Python 3.x.xと表示されない場合は、python.orgにアクセスすれば解決できます。Pythonが確認できたら、仮想環境でクリーンなワークスペースを確保しましょう。

# プロジェクトフォルダに移動し、作成します：
python -m venv .venv

そして、魔法の杖を振るように、アクティベートします。ターミナルのプロンプトに(.venv)という小さなプレフィックスが表示され、隔離されたワンダーランドにいることを subtly 示します。

# macOS/Linuxの場合
source .venv/bin/activate

# Windowsの場合 (コマンドプロンプトを使用)
.venv\Scripts\activate

仮想環境が稼働したら、Pygletをプロジェクトに導入するのは、パッケージをインストールするのと同じくらい簡単です。コマンドを1つ実行するだけで、pipがPython Package Indexから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!」と表示された、かなりシンプルで空のウィンドウが表示されるはずです。謙虚な始まりかもしれませんが、かなりの成果です！

前のステップのあの小さなコード片は、実はたくさんのことをやっていました。ウィンドウを起動させたあの2行のカーテンをめくってみましょう。

• 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!」ラベルのメッセージを変更しましょう。

以下のon_mouse_press関数をmain.pyに追加してください。

# ... (前のコード) ...

# クリック回数を追跡
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など）に関する情報をどのように取得するかを注意してください。それはあなたのマウスのためのミニチュア監視システムであり、常に報告する準備ができています。

さて、基本をカバーしました：ウィンドウ、いくつかのテキスト、そしてユーザー入力に応答するいくつかの方法。それらをすべて1つのまとまった「Hello World」スクリプトにまとめて、Pygletのエレガンスを真に実証しましょう。この統合されたバージョンは、新しいインタラクティブな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のクロックを使用して、タイミングイベントを実行し、スムーズなアニメーションを作成します。
• オーディオとビデオ： 効果音、BGMを追加したり、アプリケーションに直接ビデオを埋め込んだりします。
• ゲームループとバッチ処理： より複雑なプロジェクトでは、効率的なレンダリング技術と多数のオブジェクトの管理を掘り下げます。
• 入力デバイス： マウスとキーボードを超えて、ジョイスティックとゲームパッドのサポートを探求します。

この「Hello World」を、ブランコを穏やかに押す最初のものと考えてください。今、勢いがつきました。次のステップはすべて、どれだけ高く行きたいかです。いじり続け、探求し続け、Pythonの創造物をPygletで生き生きとさせることを楽しんでください！