Pygameハローワールドチュートリアル

Pygameのプールに飛び込む前に、Python自体がインストールされていることを確認しましょう。できればバージョン3.7以降が推奨です。また、Pythonの標準パッケージマネージャーであるpipも必要です。これは最近のPythonには通常バンドルされており、非常に便利な仲間です。

ターミナルまたはコマンドプロンプトを開き、次のように入力すると、いつでもPythonのバージョンを確認できます。

python --version

Python 3.x.xのような応答があれば、問題ありません。そうでない場合は、python.orgにアクセスしてインストールしてください。手間いらずです。

これは、さまざまなアートプロジェクトを別々のフォルダに保管するようなものです。仮想環境はプロジェクトの依存関係を分離します。これにより、Pygameが、例えばWeb開発などの他のライブラリと衝突するのを防ぎます。すべてをきれいに整理し、依存関係のスパゲッティモンスターを防ぎます。

まず、ターミナルを開き、ゲームプロジェクトを配置したい場所に移動し、新しい環境を作成します。

python -m venv .venv

次に、その新しい環境に実際に入る必要があります。これは、専用のワークスペースのドアを開けるようなものです。

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

# Windowsの場合（この特定の構文ではPowerShellではなくコマンドプロンプトを使用してください）
.venv\Scripts\activate

正常に環境に入ると、ターミナルプロンプトの先頭に(.venv)が表示されます。これは「Pygameゾーンへようこそ」のサインと考えてください。

仮想環境が正常に動作したら、Pygameを導入するのは非常に簡単です。短いコマンドを実行するだけで、pipがあとはすべて処理し、必要なものをすべてダウンロードしてセットアップします。幸い、複雑な儀式や複雑な呪文は必要ありません。

アクティブなターミナルでこのコマンドを実行してください。

pip install pygame

Pygameと依存関係を取得する際に、多くのテキストが表示されます。完了したら、ゲームの構築を開始する準備が整います。新しいピカピカのツールキットを開封するようなものです。

最もシンプルなPongクローンから最も複雑なオープンワールドのエピックまで、あらゆるインタラクティブなゲームは「ゲームループ」に依存しています。これは単なる専門用語ではなく、ゲームの心臓部であり、いくつかの重要なステップを絶えず繰り返しています。これは、観客の反応を常にチェックし、俳優を動かし、セットを再描画する、熱心な劇場の舞台監督のようなものです。

基本的なリズムは次のとおりです。

• 入力の処理: プレイヤーがキーを押しましたか？ マウスをクリックしましたか？
• ゲーム状態の更新: 入力とゲームロジックに基づいて、何が変更されますか？（例：キャラクターが移動する、スコアが更新される）。
• すべてを描画: 前のフレームを消去し、すべてのゲームオブジェクトを新しい位置に再描画します。

どのPygameプログラムも、同様の儀式で始まります。モジュールの初期化、表示ウィンドウの作成、そして適切なタイトルの設定です。これは、イーゼルをセットアップし、キャンバスを張り、絵の具を少しでもつける前に、傑作のタイトルを書くようなものです。

hello_pygame.pyという新しいファイルを作成し、これらの行を追加してください。

import pygame

# 1. Pygameの初期化
pygame.init()

# 2. 画面の次元を定義
screen_width = 800
screen_height = 600
screen = pygame.display.set_mode((screen_width, screen_height))

# 3. ウィンドウのタイトルを設定
pygame.display.set_caption("My First Pygame Window")

# ゲームループ（次のステップで埋めます）
running = True
while running:
    # イベント処理、更新、描画はここに入ります
    pass

# Pygameを終了
pygame.quit()

pygame.init()はPygameのすべてのモジュールを起動し、pygame.display.set_mode()は表示されるゲームウィンドウを作成します。最後に、pygame.display.set_caption()はウィンドウに名前を付けます。これは、新しいフォルダにラベルを付けるようなものです。

次に、色を少し加えて、そのむき出しのウィンドウをゲームループで生き生きとさせましょう。Pygameの色は、赤、緑、青の値のタプルであり、0から255までの範囲です。デジタルパレットで絵の具を混ぜるようなものです。次に、screen.fill()メソッドを使用して、各フレームでその色をキャンバス全体に塗りつぶし、pygame.display.flip()を使用して更新された画像を画面に表示します。

hello_pygame.pyにこれらの行を追加し、while running:ループ内のpassを置き換えてください。

# いくつかの色を定義（RGB値）
WHITE = (255, 255, 255)
BLACK = (0, 0, 0)
BLUE = (0, 0, 255)
GREEN = (0, 255, 0)
RED = (255, 0, 0)
LIGHT_GREY = (200, 200, 200) # 背景色

# ... (ループ前の既存のコードの残りの部分) ...

# ゲームループ
running = True
while running:
    # 画面を色で塗りつぶす（これにより、各フレームの画面がクリアされます）
    screen.fill(LIGHT_GREY)

    # すべての描画コマンドはここに入ります

    # ディスプレイを更新
    pygame.display.flip()

# ... (最後に pygame.quit() ) ...

screen.fill()行は、新しいフレームを描画する前にすべてを消去するようなもので、pygame.display.flip()は、作品を観客に披露する瞬間です。このセットアップにより、画面は常に更新され、あらゆるアニメーションの基本的なトリックとなります。

ここで、実際に「Hello World」メッセージを画面に表示します。これは3段階のダンスです。フォントを選択し、テキストをサーフェスにレンダリングし、そのサーフェスをメインディスプレイに「blit」します。`blit`は、Pygameが1つの画像を別の画像にスタンプする方法であり、テキストやスプライトに非常に便利です。

このコードをwhile running:ループ内、screen.fill(LIGHT_GREY)の直後に配置してください。

# ... (while running: ループ内) ...
    screen.fill(LIGHT_GREY)

    # "Hello World!" テキストのレンダリング
    font = pygame.font.Font(None, 74) # None はデフォルトフォント、74 はフォントサイズ
    text_surface = font.render("Hello World!", True, BLUE) # テキスト、アンチエイリアス、色
    text_rect = text_surface.get_rect() # テキストサーフェスの矩形を取得
    text_rect.center = (screen_width // 2, screen_height // 2) # テキストを中央揃え
    screen.blit(text_surface, text_rect) # テキストサーフェスを画面に描画

    # ディスプレイを更新
    pygame.display.flip()
# ... (コードの残りの部分) ...

フォントオブジェクトを作成し、メッセージを一時的な `text_surface` に描画します。その `hitbox`（`text_rect`）を取得して中央揃えを簡単にし、最後にメインの `screen` に `blit` します。カスタムスタンプをデザインしてページに押すようなものです。

きれいに終了できないゲームは、ドアが閉まらないようなものです。イライラします！ Pygameは、マウスのクリックやキーの押下など、すべてのユーザーインタラクションを「イベント」として管理します。これらのイベント、特にウィンドウを閉じたいというユーザーの意思を示すイベントを常にチェックする必要があります。それ以外の場合、アプリケーションを強制終了することになり、それはあまり親切ではありません。

while running:ループの先頭に、このイベント処理コードを追加してください。

# ... (while running: ループ内、screen.fill の前) ...
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False # ループを終了するために running を False に設定

    screen.fill(LIGHT_GREY)
    # ... (描画コードの残りの部分) ...

pygame.event.get()行は、前回チェックしてから発生したすべてのものを取得します。次に、ウィンドウの「X」ボタンをクリックするとトリガーされるpygame.QUITを特に探します。running = Falseを設定するとループが中断され、pygame.quit()はすべてが正常にクリーンアップされることを保証します。整然とした終了が常に好まれます。

断片を見てきましたが、今度はすべてをまとめましょう。この完全な `hello_pygame.py` ファイルには、初期化からイベント処理とテキスト描画を含むゲームループまで、説明したすべての要素が含まれています。これはコードの小さな交響曲であり、1つのシンプルなメロディーを奏でています。

最終的な `hello_pygame.py` ファイルは次のようになります。

import pygame

# 1. Pygameの初期化
pygame.init()

# 2. 画面の次元を定義
screen_width = 800
screen_height = 600
screen = pygame.display.set_mode((screen_width, screen_height))

# 3. ウィンドウのタイトルを設定
pygame.display.set_caption("Hello Pygame World")

# 4. いくつかの色を定義（RGB値）
WHITE = (255, 255, 255)
BLACK = (0, 0, 0)
BLUE = (0, 0, 255)
GREEN = (0, 255, 0)
RED = (255, 0, 0)
LIGHT_GREY = (200, 200, 200) # 背景色

# 5. ゲームループ
running = True
while running:
    # イベント処理
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # 描画コマンド
    screen.fill(LIGHT_GREY) # 前のフレームをクリアするために画面を塗りつぶす

    # "Hello World!" テキストのレンダリング
    font = pygame.font.Font(None, 74) # None はデフォルトフォント、74 はフォントサイズ
    text_surface = font.render("Hello World!", True, BLUE) # テキスト、アンチエイリアス、色
    text_rect = text_surface.get_rect() # テキストサーフェスの矩形を取得
    text_rect.center = (screen_width // 2, screen_height // 2) # テキストを中央揃え
    screen.blit(text_surface, text_rect) # テキストサーフェスを画面に描画

    # ディスプレイを更新
    pygame.display.flip()

# 6. Pygameを終了
pygame.quit()

各部分がその役割を果たし、機能的ではありますがシンプルなPygameアプリケーションを作成します。それは、時計のすべての歯車が突然協力して時間を刻むようなものです。

真実の瞬間です！ `hello_pygame.py` ファイルをプロジェクトディレクトリに保存したら（もちろん、仮想環境はアクティブにしたまま）、ついに創造物を解放できます。これはグランドフィナーレ、あなたの最初のPygameショーの幕開けです。

ターミナルに戻り、Pythonスクリプトを実行してください。

python hello_pygame.py

「Hello Pygame World」というタイトルで、「Hello World！」が中央に薄い灰色の背景で表示される新しいウィンドウが表示されるはずです。ウィンドウの「X」ボタンをクリックすると、きれいに閉じます。あなたは今、最初のインタラクティブディスプレイを作成しました。それは、あなたのコマンドのデジタルエコーです。次に、色やフォントをいじったり、移動する図形を追加したりして、キャンバスを真に生き生きとさせることができます。