
Pygameで使える便利な小技集
pythonでのゲーム制作に便利なPygame。起動方法や基本の使い方などは他の方が(noteに限らず)もう記事にされていると思うのでここでは裏技・小技を紹介します。
※Windowsで解説しています。
1. インストールができないときの対処
まずはPygameがそもそもインストールできない、コマンドがうまくいかないときの対処です(万能とは言い切れませんが)。これはpygameに限らず、numpyなどの他の外部モジュールのインストールでも同様です。
普通は以下のようにコマンドプロンプトに入力してインストールすると思います。
pip install pygameしかし、これをやると以下の文言が出てきてしまう場合があります。
'pip' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。
「"pip"なんていう名前のコマンドはこの端末に登録されてないから使えない」です。
これは以下のようにするとインストールできます。
py -m pip install pygameここで、最初の"py"は"python"や”python3”にする必要があることもたまにありますがだいたいは"py"で動作します。これでやると多くの場合はインストールが成功しますが、インストール途中に赤文字などでエラーっぽい文言が出てくる場合があります。その場合は以下のコマンドを打ちます。
py -m install --upgrade pipこれはコマンドをアップデートするコマンドです。これをしてから先ほどの をやるとうまくいくはずです。
2. Pygameに最初から入っているプログラム
実はPygameにはサンプルプログラムが最初からたくさん入っています。
しかもコードはパブリックドメインが適用されているので自由にプログラムに利用することができますし、丁寧に書かれているので読みやすいです。
(1) 実行方法
実行方法は簡単です。IDLEシェルでも普通に動きますし新規作成から新しくファイルを作ってRunから実行してもよいです。ここでは試しにを実行します。
import pygame.examples.aliens as game
game.main()後述するほかのプログラムを実行する場合はのところを実行したいプログラム名からを除いたものを入力してください。
(2) コードの開き方
サンプルプログラムのコードを開いたり一覧を見たい場合はエクスプローラーなどから開く必要があります。ファイルパスは以下のものになります。
Pythonファイル\Lib\site-packages\pygame\examples"pythonファイル"のところはインストール時にどこに置いたかで変わってしまうのでご自身のエクスプローラーなどで探してみてください。
見つからない場合は、スタートメニューやデスクトップにピン止めしているなら右クリック→「ファイルの場所を開く」から開き、遡ることでpythonファイルを突き止められます(スタートメニューの場合はショートカットが出てくるのでさらに同様の操作が必要)。
ちなみに、ファイルパスを指定せずにpythonを普通にインストールした場合は以下のファイルパスにある可能性があります。
C:\Users\ユーザー名\AppData\Local\Programs\Python「ユーザー名」のところはご自身のユーザー名に変換してください。
開くとこんな感じに出てくると思います。

ここで、はこれをモジュール用のフォルダとして認識させるためのファイルなので実行しても何もありません。また、フォルダにはプログラム実行に必要な画像や音声などが入っているので、うかつに削除しようものならエラーを吐きます(追加する分には多分問題なし)。
ここからはpygameで実際にゲームを作るときに使える技です。
3. インポート時のメッセージを消す方法
pygameを実行すると下のようなメッセージが出てきます。

これの問題点は新規作成から本格的に作った場合でもお構いなしに表示されることで、ゲームを起動するたびにこれが出てくるのは鬱陶しいですよね。
実はこの表示、消すことができます。消すには以下のコードをpygameのインポートの前に書きます。
import os
os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = '1'これをしてからimportすると下のようになります。

もちろん新規作成から本格的に作って実行してもメッセージは表示されません。
4. ウィンドウを閉じる際の確認メッセージ
pygameではウィンドウを閉じるボタンを押すときにでいちいち判定をする必要があって面倒ですが、それを逆手に取ったプログラムです。これを使うとウィンドウを閉じるときに「本当に閉じますか?」的な確認メッセージを出すことができます。これにはpythonの組み込みモジュールであるのを使います。
### 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("タイトル","メッセージ")変数に格納される返り値は、「はい」なら、「いいえ」ならです。
これを実行してウィンドウを閉じようとすると下のようになるはずです。

ちなみにこれを応用するとなどでエラーメッセージを出したりできて便利なので気になる方は調べてみてください。
5. Pygameでの色を名前で指定する方法
Pygameで色を指定するとき、手っ取り早いのはのタプルで指定する方法です。しかし、欲しい色の値を調べるのはちょっと大変ですよね。実はPygameではとすれば色の指定が簡単にできます(例えばなど)。
これで使える色はとても多いので、色一覧を表示するプログラムを作ってみました。が色とカラーコードを結びつける辞書なのでこれを利用しています。で出すだけだと面白くない(???)のでしっかりウィンドウに一覧表示しています。
### 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
実行すると以下のようなウィンドウが出てくると思います。

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

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