メインコンテンツへスキップ
見出し画像

Pygameで使える便利な小技集

    pythonでのゲーム制作に便利なPygame。起動方法や基本の使い方などは他の方が(noteに限らず)もう記事にされていると思うのでここでは裏技・小技を紹介します。

    ※Windowsで解説しています。

    1. インストールができないときの対処

    まずはPygameがそもそもインストールできない、pip\verb|pip|コマンドがうまくいかないときの対処です(万能とは言い切れませんが)。これはpygameに限らず、numpyなどの他の外部モジュールのインストールでも同様です。

    普通は以下のようにコマンドプロンプトに入力してインストールすると思います。

    pip install pygame

    しかし、これをやると以下の文言が出てきてしまう場合があります。

    'pip' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。

    これが何を言っているかを簡単にまとめると、
    「"pip"なんていう名前のコマンドはこの端末に登録されてないから使えない」です。

    これは以下のようにするとインストールできます。

    py -m pip install pygame

    ここで、最初の"py"は"python"や”python3”にする必要があることもたまにありますがだいたいは"py"で動作します。これでやると多くの場合はインストールが成功しますが、インストール途中に赤文字などでエラーっぽい文言が出てくる場合があります。その場合は以下のコマンドを打ちます。

    py -m install --upgrade pip

    これはpip\verb|pip|コマンドをアップデートするコマンドです。これをしてから先ほどの py -m pip install pygame\verb|py -m pip install pygame| をやるとうまくいくはずです。

    2. Pygameに最初から入っているプログラム

    実はPygameにはサンプルプログラムが最初からたくさん入っています。
    しかもコードはパブリックドメインが適用されているので自由にプログラムに利用することができますし、丁寧に書かれているので読みやすいです。

    (1) 実行方法

    実行方法は簡単です。IDLEシェルでも普通に動きますし新規作成から新しくファイルを作ってRunから実行してもよいです。ここでは試しにaliens.py\verb|aliens.py|を実行します。

    import pygame.examples.aliens as game
    game.main()

    後述するほかのプログラムを実行する場合はaliens\verb|aliens|のところを実行したいプログラム名から.py\verb|.py|を除いたものを入力してください。

    (2) コードの開き方

    サンプルプログラムのコードを開いたり一覧を見たい場合はエクスプローラーなどから開く必要があります。ファイルパスは以下のものになります。

    Pythonファイル\Lib\site-packages\pygame\examples

    "pythonファイル"のところはインストール時にどこに置いたかで変わってしまうのでご自身のエクスプローラーなどで探してみてください。
    見つからない場合は、スタートメニューやデスクトップにピン止めしているなら右クリック→「ファイルの場所を開く」から開き、遡ることでpythonファイルを突き止められます(スタートメニューの場合はショートカットが出てくるのでさらに同様の操作が必要)。

    ちなみに、ファイルパスを指定せずにpythonを普通にインストールした場合は以下のファイルパスにある可能性があります。

    C:\Users\ユーザー名\AppData\Local\Programs\Python

    「ユーザー名」のところはご自身のユーザー名に変換してください。

    開くとこんな感じに出てくると思います。

    画像

    ここで、__init__.py\verb|__init__.py|はこれをモジュール用のフォルダとして認識させるためのファイルなので実行しても何もありません。また、data\verb|data|フォルダにはプログラム実行に必要な画像や音声などが入っているので、うかつに削除しようものならエラーを吐きます(追加する分には多分問題なし)。


     

    ここからはpygameで実際にゲームを作るときに使える技です。

    3. インポート時のメッセージを消す方法

    pygameを実行すると下のようなメッセージが出てきます。

    画像
    バージョン情報とpygameへようこそ的なメッセージ。別になくても良い。

    これの問題点は新規作成から本格的に作った場合でもお構いなしに表示されることで、ゲームを起動するたびにこれが出てくるのは鬱陶しいですよね。

    実はこの表示、消すことができます。消すには以下のコードをpygameのインポートの前に書きます。

    import os
    os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = '1'

    これをしてからimportすると下のようになります。

    画像
    やはりこちらのほうが見栄えは良い

    もちろん新規作成から本格的に作って実行してもメッセージは表示されません。

    4. ウィンドウを閉じる際の確認メッセージ

    pygameではウィンドウを閉じるボタンを押すときにevent.get\verb|event.get|でいちいち判定をする必要があって面倒ですが、それを逆手に取ったプログラムです。これを使うとウィンドウを閉じるときに「本当に閉じますか?」的な確認メッセージを出すことができます。これにはpythonの組み込みモジュールであるtkinter\verb|tkinter|のmessagebox\verb|messagebox|を使います。

    ### pygameとtkinterのimport
    import pygame as pg
    import tkinter as tk
    import tkinter.messagebox as messagebox
    
    pg.init()  # pygameの初期化
    screen = pg.display.set_mode((800,600)) # pygameウィンドウを表示
    
    root = tk.Tk() # tkを起動
    root.attributes("-topmost",True) # ウィンドウを最前面表示にする
    root.withdraw() # tkのウィンドウを非表示にする
    
    ### メインループ
    running = True
    while running:
        screen.fill((255,255,255)) # screenを白で塗る
        pg.display.update() # screenを更新
        ### イベント判定
        for event in pg.event.get():
            if event.type == pg.QUIT:
                # 確認メッセージの表示
                ask = messagebox.askyesno("確認","ウィンドウを閉じてもよろしいですか?")
                if ask == True:
                    pg.quit() # pygameを閉じる
                    running = False
    
    

    これをゲームなどに応用することで確認メッセージを表示させられます。
    messagebox.askyesno\verb|messagebox.askyesno|の構文は以下のようになります。

    変数 = messagebox.askyesno("タイトル","メッセージ")

    変数に格納される返り値は、「はい」ならTrue\verb|True|、「いいえ」ならFalse\verb|False|です。

    これを実行してウィンドウを閉じようとすると下のようになるはずです。

    画像
    「はい」を押せば閉じます

    ちなみにこれを応用するとmessagebox.showwarning\verb|messagebox.showwarning|などでエラーメッセージを出したりできて便利なので気になる方は調べてみてください。

    5. Pygameでの色を名前で指定する方法

    Pygameで色を指定するとき、手っ取り早いのは(R,G,B)\verb|(R,G,B)|のタプルで指定する方法です。しかし、欲しい色の値を調べるのはちょっと大変ですよね。実はPygameではpygame.Color("色の名前")\verb|pygame.Color("色の名前")|とすれば色の指定が簡単にできます(例えばscreen.fill(pygame.Color("WHITE"))\verb|screen.fill(pygame.Color("WHITE"))|など)。

    これで使える色はとても多いので、色一覧を表示するプログラムを作ってみました。pygame.color.THECOLORS\verb|pygame.color.THECOLORS|が色とカラーコードを結びつける辞書なのでこれを利用しています。print\verb|print|で出すだけだと面白くない(???)のでしっかりウィンドウに一覧表示しています。

    ### importのメッセージを非表示にする処理
    import os
    os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = '1'
    
    ### pygameのインポートとウィンドウなどの設定
    import pygame as pg
    pg.init()
    pg.display.set_caption("COLORS")
    wid = 800
    hei = 600
    screen = pg.display.set_mode((wid,hei))
    font1 = pg.font.Font(None,20)
    font2 = pg.font.Font(None,100)
    font3 = pg.font.Font(None,32)
    
    ### tkinter.messageboxの準備
    import tkinter as tk
    import tkinter.messagebox as messagebox
    root = tk.Tk()
    root.attributes("-topmost",True)
    root.withdraw()
    
    ### 色名一覧のリストを作成
    colornames = []
    for c in pg.color.THECOLORS:
        colornames.append(c)
    
    ### 設置場所にRectを作っておく(クリックの判定用)
    rects = []
    rects_copy = []
    x = 30
    y = 50
    for r in range(len(colornames)):
        rects.append(pg.Rect(x,y,140,40))
        rects_copy.append(pg.Rect(x,y,140,40))
        x += 150
        if x > 700:
            x = 30
            y += 50
    
    ### 変数の初期値設定
    running = True
    change_y = 0
    clickedcolorname = None
    page = 1
    pushflag = False
    
    
    ### 一覧の描画
    def draw1():
        global change_y,rects_copy,clickedcolorname,page,pushflag
        screen.fill(pg.Color("WHITE"))
        # 操作方法の文字の描画
        text = font3.render("Up/Down key to move. Click on the colored area to enlarge.",
                             True,pg.Color("BLACK"))
        screen.blit(text,text.get_rect(center=(wid / 2,change_y + 25)))
        screen.blit(text,text.get_rect(center=(wid / 2,
                                               change_y + (len(colornames)//5 + 1) * 50 + 25)))
        # 色の四角,文字の描画
        for n in range(len(rects)):
            pg.draw.rect(screen,colornames[n],rects_copy[n])
            colortext1 = font1.render(colornames[n],True,pg.Color("BLACK"))
            colortext2 = font1.render(colornames[n],True,pg.Color("WHITE"))
            screen.blit(colortext1,(rects[n].x + 5,rects_copy[n].y + 4))
            screen.blit(colortext2,(rects[n].x + 5,rects_copy[n].y + 20))
        # キーボード判定
        key = pg.key.get_pressed()
        if key[pg.K_UP]:
            change_y += 20
        if key[pg.K_DOWN]:
            change_y -= 20
        # 調整値の上限、下限を設定
        if change_y > 0:
            change_y = 0
        elif change_y < -(len(colornames) // 5 - 10) * 50:
            change_y = -(len(colornames) // 5 - 10) * 50
        # 表示位置の変更(Rectをまるごと調整する)
        for r in range(len(rects)):
            rects_copy[r].y = rects[r].y + change_y
        # クリックの判定
        pos = pg.mouse.get_pos()
        mdown = pg.mouse.get_pressed()
        if mdown[0]:
            if pushflag == False:
                for n in range(len(rects_copy)):
                    if rects_copy[n].collidepoint(pos):
                        break
                clickedcolorname = colornames[n]
                page = 2
                pushflag = True
        else:
            # 離すまで次の押した判定をしない処理
            pushflag = False
            
    
    ### 拡大表示の描画
    def draw2():
        global page,pushflag
        # 描画
        screen.fill(pg.Color(clickedcolorname))
        text1 = font2.render(clickedcolorname,True,pg.Color("BLACK"))
        text2 = font2.render(clickedcolorname,True,pg.Color("WHITE"))
        text3 = font2.render(clickedcolorname,True,pg.Color(clickedcolorname))
        text4 = font3.render("(Click anywhere to go back.)",True,pg.Color("BLACK"))
        text5 = font3.render("(Click anywhere to go back.)",True,pg.Color("WHITE"))
        textrect1 = text3.get_rect(center=(wid/2,300))
        textrect2 = text3.get_rect(center=(wid/2,400))
        pg.draw.rect(screen,pg.Color("BLACK"),textrect1)
        pg.draw.rect(screen,pg.Color("WHITE"),textrect2)
        screen.blit(text1,text1.get_rect(center=(wid/2,100)))
        screen.blit(text2,text2.get_rect(center=(wid/2,200)))
        screen.blit(text3,textrect1)
        screen.blit(text3,textrect2)
        screen.blit(text4,text4.get_rect(center=(wid/2,525)))
        screen.blit(text5,text5.get_rect(center=(wid/2,560)))
        # クリックの判定
        mdown = pg.mouse.get_pressed()
        if mdown[0]:
            if pushflag == False:
                page = 1
                pushflag = True
        else:
            # 離すまで次の押した判定をしない処理
            pushflag = False
    
    
    ### メインループ
    while running:
        if page == 1:
            draw1()
        elif page == 2:
            draw2()
        pg.display.update()
        pg.time.Clock().tick(30)
        for event in pg.event.get():
            if event.type == pg.QUIT:
                # 確認メッセージの表示
                ask = messagebox.askyesno("確認","ウィンドウを閉じてもよろしいですか?")
                if ask == True:
                    pg.quit()
                    running = False
    

    実行すると以下のようなウィンドウが出てくると思います。

    画像
    書いてある通り上下矢印キーで移動します。

    色をクリックすると下のようにその色を拡大表示します。

    画像
    書いてある通りどこでも良いのでウィンドウ内をクリックすれば閉じます

    これを使うと色の印象や見やすさなどが一発でわかります。



     
     
    数学とPythonが好きな人です。 主に数学と自作のPythonプログラムの解説記事を書いています。 最近はBVE関連にハマってます… X垢(主にBVE):https://x.com/__init__92435

    あなたへのおすすめ