
【フリー配布】pygameで使える便利な自作関数集 | Python | 20261018追記
pythonのpygameでのゲーム・アプリ開発は、そのままでももちろん分かりやすく開発できるものの、テキストの描画などはフォント指定など少し面倒です。今回は実際に私が開発でよく使っている関数をまとめてモジュールにしたので、せっかく作ったならフリー配布しようと思います。
1. 利用について
一応利用規約的なものをここに書いておきます。
このモジュールは以上と、、が正常にインストールされている場合のみ動作します。
利用したものをexe化する場合、を使うことを推奨します。pyinstaller以外での動作は確認していません。
このモジュールの利用において発生した問題については、私は一切の責任を負いかねます。ただ、モジュールの不具合などありましたら、お手数ですがコメントまでお願いします。
利用はフリー(再配布可)で、特に連絡なども不要です。モジュールとしてそのまま利用でも、中身の関数だけコピペ利用でもOKです。
中身の関数だけコピペする場合、関数が他の関数を利用している場合があるので、利用先も含めセットでコピペしてください(そうしないとエラーを吐きます)。
中身の関数はご自身の環境に合わせ自由に改造して構いません。(配布状態はあくまで私が使いやすくしただけなので)
開発環境は、、です。
その他、何かご質問等あればこの記事にコメントをお願いします(できるだけ早く対応します)。なお、ダウンロード、利用方法、機能説明はこの後書いています。
2. ダウンロード・利用方法
(1) ダウンロード
以下からダウンロードしてください。
特に解凍などは必要ありません(ただのファイルです)。
※ 【重要】20261018追記
上のものは内部にtkinterを使用しており、メイン側でtkinterを使っている場合正常に動作しなくなることがあります。これを避けたい(モジュール内でtkinterを使用しない)場合は、以下のものを使ってください。
(2) 利用方法
ダウンロード後は、制作されているメインプログラムと同ディレクトリに置いてするか、もしくは自作モジュールの利用と同様にとすればOKです。
なお、注意として、メインプログラム内のこのモジュールのimport記述は、必ずpygameのimportより前に書いてください。(以下のような感じです)
import pygame_patch
import pygame as pg
pg.init()
……3. 機能・関数
これについてはプログラムでもある程度コメントを入れていますが、分かりづらいと思うのでここで解説します。
(1) import時の初期機能
モジュールがimportされたとき、以下のことを行います。
のウェルカムメッセージの非表示
警告の無視(※)
※ のアップデートに伴う利用の警告で、側の問題、つまりこちらでは基本的にどうしようもありません。いちいち出るのが鬱陶しいので切っています。
(2) path関数
path関数は、exe化したときのファイルパスの修正を行う関数です。普段のファイルパス指定にこれを通すことで、exe化してもエラーを吐かず安全に実行できます。
以下のような構文で指定します。
pygame_patch.path("ファイルパス",is_save)第1引数はそのままファイルパスでOKですが、必ず相対パス指定にしてください。
第2引数は、exe化したときに同ディレクトリを参照するか?という引数で、で指定します。簡単にまとめると、でのexe化の際にでexeファイルに含めたものを参照している場合は、exeファイルでも変わらず同じ場所を参照して読み込む場合はを指定してください。なお、初期値はです。
なお、この第2引数の指定は今後の関数でたびたび出てくるので、ぜひ頭に入れておいてください。
(3) drawtext関数
drawtext関数は、pygameのSurfaceへのテキスト描画を、フォント・サイズ・位置指定含め一括でできる関数です。また、描画したテキストのRectデータを返すので、を利用したマウス判定や当たり判定などにも利用可能です。
構文は以下のようになります。
pygame_patch.drawtext(描画Surface,x,y,"テキスト",font,サイズ,文字色,文字背景色,anchor,透明度)第4引数までは説明不要だと思うので、第5引数fontから説明します。
引数fontは、指定するフォントのタイプで指定方法が変わります。
(a) システムフォントの場合
Consolasなど、PCのシステムにもともと入っているフォントの場合は、そのフォント名を文字列で指定してください。
(b) .ttfファイルを読み込む場合
外部からのttfファイルを読み込む場合は、タプルでを指定してください。exe化同ディレクトリ参照は、先ほどのpath関数での解説の第2引数と同じです。(ファイルパスも同様に相対指定にしてください)
サイズ、文字色、文字背景色については説明不要だと思うので省略します。
(色に関してはタプル形式かで入れてください。背景色がない場合はを指定するか、もしくは書かなくても良いです)
anchorについては、での指定と全く同じように指定できます。初期値はで、などのような8方位指定です。
透明度は、pygameの仕様上、最初のSurfaceを作る段階でを指定している場合のみ有効になります。透明度を0~255の整数で指定してください。(0が最小で透明、255が最大で通常表示です)
(4) blit関数
blit関数は、本来のscreen.blitの機能にanchor指定を追加したものです。また、drawtext関数同様Rectデータを返します。
pygame_patch.blit(描画されるSurface,描画するSurface,x,y,anchor)つまり、第2引数のSurfaceを第1引数のSurfaceに描画します。
anchor指定に関しては先ほどのdrawtext関数同様です。
(5) file_open関数
file_open関数は、組み込みのpickleモジュールを利用したファイルの読み込み・書き込みを行います。
構文は以下のものになります。
pygame_patch.file_open("ファイルパス",is_save,mode,データ,エラーメッセージタイトル,エラーメッセージ本文)ファイルパスはpath関数同様に相対指定、is_saveもexe化時のディレクトリ参照の話なのでpath関数と同じです。
modeは、読み書きのモードを指定します。1を指定で書き込み()、2なら上書き保存()、3なら新規作成+書き込み()です。
データは保存時のみ、保存したいデータを指定してください。
エラーメッセージは、ファイルを開けなかった場合のエラーメッセージの出力内容を指定してください(これは任意です)。
4. アップデートについて
今のところアップデートは考えていませんが、もしかしたら追加をするかもしれません(2025/11/17現在)。追加の場合はこの記事の内容とファイルを更新しますが、既存の関数名は変えるつもりはありませんので、もし追加などあった場合は新しくダウンロードしていただき、古いものを置き換えていただければ正常に動作すると思います。
【アップデート履歴】
2025/11/17:初公開
2026/10/18:tkinterを内部に含まないバージョンも公開
>>>全記事ポータルページはこちら