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

【フリー配布】pygameで使える便利な自作関数集 | Python | 20261018追記

    pythonのpygameでのゲーム・アプリ開発は、そのままでももちろん分かりやすく開発できるものの、テキストの描画などはフォント指定など少し面倒です。今回は実際に私が開発でよく使っている関数をまとめてモジュールにしたので、せっかく作ったならフリー配布しようと思います。

    1. 利用について

    一応利用規約的なものをここに書いておきます。

    • このモジュールはPython 3.7\verb|Python 3.7|以上と、tkinter\verb|tkinter|、pygame\verb|pygame|が正常にインストールされている場合のみ動作します。

    • 利用したものをexe化する場合、pyinstaller\verb|pyinstaller|を使うことを推奨します。pyinstaller以外での動作は確認していません。

    • このモジュールの利用において発生した問題については、私は一切の責任を負いかねます。ただ、モジュールの不具合などありましたら、お手数ですがコメントまでお願いします。

    • 利用はフリー(再配布可)で、特に連絡なども不要です。モジュールとしてそのまま利用でも、中身の関数だけコピペ利用でもOKです。

    • 中身の関数だけコピペする場合、関数が他の関数を利用している場合があるので、利用先も含めセットでコピペしてください(そうしないとエラーを吐きます)。

    • 中身の関数はご自身の環境に合わせ自由に改造して構いません。(配布状態はあくまで私が使いやすくしただけなので)

    • 開発環境はWindows11(64bit)\verb|Windows11(64bit)|、Python 3.13.7\verb|Python 3.13.7|、pygame 2.6.1\verb|pygame 2.6.1|です。

    • その他、何かご質問等あればこの記事にコメントをお願いします(できるだけ早く対応します)。なお、ダウンロード、利用方法、機能説明はこの後書いています。

    2. ダウンロード・利用方法

    (1) ダウンロード

    以下からダウンロードしてください。

    特に解凍などは必要ありません(ただの.py\verb|.py|ファイルです)。

    ※ 【重要】20261018追記
    上のものは内部にtkinterを使用しており、メイン側でtkinterを使っている場合正常に動作しなくなることがあります。これを避けたい(モジュール内でtkinterを使用しない)場合は、以下のものを使ってください。

    (2) 利用方法

    ダウンロード後は、制作されているメインプログラムと同ディレクトリに置いてimport pygame_patch\verb|import pygame_patch|するか、もしくは自作モジュールの利用と同様にfrom (ディレクトリ名) import pygame_patch\verb|from (ディレクトリ名) import pygame_patch|とすればOKです。
    なお、注意として、メインプログラム内のこのモジュールのimport記述は、必ずpygameのimportより前に書いてください。(以下のような感じです)

    import pygame_patch
    import pygame as pg
    pg.init()
    ……

    3. 機能・関数

    これについてはプログラムでもある程度コメントを入れていますが、分かりづらいと思うのでここで解説します。

    (1) import時の初期機能

    モジュールがimportされたとき、以下のことを行います。

    • pygame\verb|pygame|のウェルカムメッセージの非表示

    • pkg_resources\verb|pkg_resources|警告の無視(※)

    ※ setuptools\verb|setuptools|のアップデートに伴う利用の警告で、pygame\verb|pygame|側の問題、つまりこちらでは基本的にどうしようもありません。いちいち出るのが鬱陶しいので切っています。

    (2) path関数

    path関数は、exe化したときのファイルパスの修正を行う関数です。普段のファイルパス指定にこれを通すことで、exe化してもエラーを吐かず安全に実行できます。
    以下のような構文で指定します。

    pygame_patch.path("ファイルパス",is_save)

    第1引数はそのままファイルパスでOKですが、必ず相対パス指定にしてください。

    第2引数is_save\verb|is_save|は、exe化したときに同ディレクトリを参照するか?という引数で、True/False\verb|True/False|で指定します。簡単にまとめると、pyinstaller\verb|pyinstaller|でのexe化の際に--add-data\verb|--add-data|でexeファイルに含めたものを参照している場合はFalse\verb|False|、exeファイルでも変わらず同じ場所を参照して読み込む場合はTrue\verb|True|を指定してください。なお、初期値はFalse\verb|False|です。

    なお、この第2引数の指定は今後の関数でたびたび出てくるので、ぜひ頭に入れておいてください。

    (3) drawtext関数

    drawtext関数は、pygameのSurfaceへのテキスト描画を、フォント・サイズ・位置指定含め一括でできる関数です。また、描画したテキストのRectデータを返すので、collidepoint\verb|collidepoint|を利用したマウス判定や当たり判定などにも利用可能です。
    構文は以下のようになります。

    pygame_patch.drawtext(描画Surface,x,y,"テキスト",font,サイズ,文字色,文字背景色,anchor,透明度)

    第4引数までは説明不要だと思うので、第5引数fontから説明します。

    引数fontは、指定するフォントのタイプで指定方法が変わります。

    (a) システムフォントの場合
    Consolasなど、PCのシステムにもともと入っているフォントの場合は、そのフォント名を文字列で指定してください。
    (b) .ttfファイルを読み込む場合
    外部からのttfファイルを読み込む場合は、タプルで(ファイルパス,exe化同ディレクトリ参照TF)\verb|(ファイルパス,exe化同ディレクトリ参照TF)|を指定してください。exe化同ディレクトリ参照は、先ほどのpath関数での解説の第2引数と同じです。(ファイルパスも同様に相対指定にしてください)

    サイズ、文字色、文字背景色については説明不要だと思うので省略します。
    (色に関してはタプル形式かpg.Color\verb|pg.Color|で入れてください。背景色がない場合はNone\verb|None|を指定するか、もしくは書かなくても良いです)

    anchorについては、tkinter\verb|tkinter|での指定と全く同じように指定できます。初期値は"center"\verb|"center"|で、"nw","w","e","sw"\verb|"nw","w","e","sw"|などのような8方位指定です。

    透明度は、pygameの仕様上、最初のSurfaceを作る段階でpg.SRCALPHA\verb|pg.SRCALPHA|を指定している場合のみ有効になります。透明度を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を指定で書き込み("r"\verb|"r"|)、2なら上書き保存("w"\verb|"w"|)、3なら新規作成+書き込み("x"\verb|"x"|)です。

    データは保存時のみ、保存したいデータを指定してください。

    エラーメッセージは、ファイルを開けなかった場合のエラーメッセージの出力内容を指定してください(これは任意です)。


    4. アップデートについて

    今のところアップデートは考えていませんが、もしかしたら追加をするかもしれません(2025/11/17現在)。追加の場合はこの記事の内容とファイルを更新しますが、既存の関数名は変えるつもりはありませんので、もし追加などあった場合は新しくダウンロードしていただき、古いものを置き換えていただければ正常に動作すると思います。

    【アップデート履歴】
    2025/11/17:初公開
    2026/10/18:tkinterを内部に含まないバージョンも公開



    >>>全記事ポータルページはこちら


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

    あなたへのおすすめ