Pyxelエディターの使い方|pyxel editで描いて保存

学習ガイド / ゲーム・作品づくり

Pyxelエディターは、Python用Pyxelに付属する、ドット絵・音・音楽などを作る道具です。pyxel editという命令で開き、作った素材を.pyxresファイルに保存します。

この記事では起動→8×8の絵を描く→保存→Pythonから表示までを進めます。「pixel edit」「Pyxel Edit」で探している方へ:ここで扱うのはPython用Pyxelの内蔵エディターです。別製品の「Pyxel Edit」の操作説明ではありません。

準備:Pyxelのインストール記事を終え、VS Codeでpyxel-playgroundフォルダーを開きます。描く道具の起動はターミナル、絵の保存はエディターの中で行います。

1. pyxel editでエディターを起動する

VS Codeの「ターミナル」→「新しいターミナル」を開きます。場所がpyxel-playgroundであることを確かめ、WindowsのPowerShellで次の1行を実行します。

.\.venv\Scripts\python.exe -m pyxel edit my_assets.pyxres

Pyxel Editorというウィンドウが開けば成功です。まだ絵がない、黒い編集画面が表示されます。命令の最後は、これから保存するファイル名です。新規ファイルは、エディターで保存するまで作成されません。

公式ガイドにある短い形はpyxel edit my_assets.pyxresです。このコースでは、インストールした環境を確実に使うため、.venvのPythonから-m pyxelで起動します。エディターを開いたターミナルは、その間エディターを動かしています。

2. Imageモードで、小さなドット絵を描く

PyxelエディターのImageモードでは、左の大きな編集領域で描き、下のパレットで色を選びます。IMAGE 0の左上8×8を使います。
PyxelエディターのImageモードでは、左の大きな編集領域で描き、下のパレットで色を選びます。IMAGE 0の左上8×8を使います。
  1. 左上のモード切替で、Image(絵)のアイコンを選びます。起動直後は通常このモードです。
  2. 右下付近のIMAGEの番号を0にします。これが、絵を入れる「イメージバンク」の番号です。
  3. 右の絵の全体表示で、編集範囲の白い枠が左上にあることを確認します。違う場所なら左上をクリックして戻します。
  4. 左下のパレットから色を選びます。見本は色番号10の黄色。まず黒以外を選びましょう。
  5. 鉛筆の形のツールを選び、左の拡大表示に1マスずつ描きます。左上から横8マス・縦8マス以内に収めます。

最初は、中央に小さなひし形やコインを描いてみましょう。左上の座標は(0, 0)、8×8の範囲はxもyも0〜7です。マウスを置いた場所の座標表示も手がかりになります。絵を大きく描きすぎると、後の見本コードでは一部しか表示されません。

描き間違えたらCtrl+Zで戻せます。背景の黒(色番号0)で塗り直す方法もあります。使う色を2〜3色に絞ると、小さく表示しても形が伝わるか考えやすくなります。

イメージバンクは「絵を置いておく場所」

イメージバンクは0・1・2の3つで、それぞれ256×256の領域があります。ゲームの画面そのものではありません。そこから必要な範囲を取り出して、ゲーム画面に表示します。この教材ではバンク0の左上8×8だけを使います。

3. .pyxresファイルに保存しよう

  1. エディターのウィンドウを選んだ状態で、Ctrl+Sを押します。上部の保存アイコンからも保存できます。
  2. VS Codeの左のファイル一覧で、my_assets.pyxresができたことを確認します。
  3. 保存後、エディターのウィンドウを閉じます。閉じる操作が難しい場合は、起動したターミナルを選んでCtrl+Cを押します。
  4. 同じ起動命令をもう一度実行します。描いた絵が残っていたら、保存できています。

Escはエディターを終了するキーではありません。表示用の見本プログラムとは操作が異なります。終了する前に必ず保存しましょう。

my_assets.pyxresは絵や音の素材、.pyはプログラムです。どちらも作品フォルダーに保存し、それぞれの画面でCtrl+Sを押します。
my_assets.pyxresは絵や音の素材、.pyはプログラムです。どちらも作品フォルダーに保存し、それぞれの画面でCtrl+Sを押します。

.pyxresは、コードを書くテキストファイルではありません。VS Codeで中身を書き換えるのではなく、エディターで開いて編集します。ファイル名を.pngや.pyに変更しても、画像やプログラムに変換されるわけではありません。

4. 描いた絵をPythonから表示する

エディターを閉じ、my_assets.pyxresと同じフォルダーにshow_sprite.pyを作ります。次を貼り付け、保存してください。

from pathlib import Path
import pyxel

pyxel.init(160, 120, title="My first sprite")
resource = Path(__file__).with_name("my_assets.pyxres")
pyxel.load(str(resource))
pyxel.cls(1)
pyxel.blt(76, 56, 0, 0, 0, 8, 8, 0)
pyxel.show()
.\.venv\Scripts\python.exe show_sprite.py

青い背景の中央付近に、自分の小さな絵が表示されたら成功です。8×8は小さいので、最初は小さなマークに見えます。画面全体を占める大きな絵ではありません。

Path(__file__).with_name(...)は、実行中の.pyと同じ場所にある素材ファイルを探す指定です。pyxel.load(...)で素材を読み込み、pyxel.blt(...)で必要な範囲を画面へ描きます。

bltでは、画面に出す位置と、素材から取り出す位置を別々に指定します。見本はバンク0の左上8×8を、画面の76・56に描きます。
bltでは、画面に出す位置と、素材から取り出す位置を別々に指定します。見本はバンク0の左上8×8を、画面の76・56に描きます。
見本の値 意味
76, 56 ゲーム画面に描く位置。絵の左上の座標です。
0 素材のイメージバンク番号。
0, 0 素材から取り出す範囲の左上の座標。
8, 8 取り出す幅と高さ。
最後の0 透明にする色番号。黒を描かず、背景が見えるようにします。
予想してから、ひとつ変えよう

エディターで絵の色を1か所変えて保存し、show_sprite.pyをもう一度実行しましょう。コードを変えずに絵が変わるのは、どのファイルを読み直しているからでしょう?

Pyxelエディターで困ったとき

pyxel editが起動しない

pyxelが見つからない場合は、この記事の.venvから始まる命令を使います。No module named pyxelなら、同じ仮想環境へのインストールを確認します。

保存したファイルが見つからない

保存前なら、まずエディターでCtrl+Sを押します。保存後なら、エディターを起動したターミナルのフォルダーを確認します。同じ名前のファイルが別の場所にできていないかを調べましょう。

ファイルを読み込めない/Failed to open file

show_sprite.pyとmy_assets.pyxresが同じフォルダーにあるか、拡張子を含めた名前が一致するかを確認します。見本のコードは、この2つを同じ場所に置く前提です。

画面は開くのに、絵が見えない

IMAGEが0か、絵が左上0〜7の範囲にあるか、保存したかを確かめます。色番号0は透明指定なので、黒だけの絵は表示されません。黄色などの色を1マス描いて保存し、再実行すると切り分けられます。

絵の一部しか出ない

見本が取り出す範囲は8×8です。その外側に描いた部分は表示されません。初めは絵を範囲内に収めます。大きくしたいときは、取り出す幅と高さも合わせて変更します。

音やマップも作れますか?

Tilemap・Sound・Musicの編集モードもあります。この教材ではImageを扱います。絵を表示できてから、必要な機能を順に足していきましょう。

次は、自分の絵を動かしてみよう

まずは、矢印キーで丸を動かす教材のx・yが、どこで変わるか思い出しましょう。絵を動かすときも「位置を変える→描き直す」は同じです。丸の中心と、ドット絵の左上では座標の意味が違うため、置き換えるときには端で止める範囲も見直します。

今日は「自分で描いた素材を、保存して、Pythonから表示できた」までできればひと区切りです。

確認した環境と公式資料

この記事のコードはPyxel 3.0.1・Python 3.12のLinux環境で動作を確認しています。Windows 11向けの操作・コマンドを案内していますが、Windows実機での一連の操作確認は未実施です。画面や対応バージョンは更新で変わるため、導入できないときは公式資料も確認してください。

パイソンチャレンジャーズによる独自教材です。Pyxelの公式サイトではありません。


Pyxelの学び方へ / Pythonの教材一覧へ