はじめてのPyxel|丸を描いて矢印キーで動かそう

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

はじめてのPyxelでは、「丸を描く→色と位置を変える→矢印キーで動かす」の3つを試します。コードの数字が画面の変化につながるところを、自分で確かめましょう。

先にPyxelのインストールを済ませ、pyxel-playgroundをVS Codeで開いてください。この教材はPCで実行します。このサイトのPython基礎のブラウザ実行欄は使いません。

毎回の流れ:変わる結果を予想 → コードを1か所変える → Ctrl + Sで保存 → 前の画面を閉じて再実行 → 違いを言葉にする。

実験1:丸をひとつ描こう

hello_pyxel.pyを開き、次のコードを保存します。導入記事を終えた人は、そのファイルをそのまま使えます。

import pyxel

pyxel.init(160, 120, title="Hello Pyxel")
pyxel.cls(1)
pyxel.circ(80, 60, 12, 10)
pyxel.show()
.\.venv\Scripts\python.exe hello_pyxel.py

青い背景に黄色い丸が出れば成功です。initは画面の準備、clsは背景を塗る、circは丸を描く、showは描いた画面を表示して待つ、という役割です。文字を表示するprintとは違い、別のウィンドウに図形を描いています。

実験2:色・位置・大きさを変えよう

circの4つの数は、中心のx座標・y座標・半径・色番号です。右に進むとx、下に進むとyが増えます。
circの4つの数は、中心のx座標・y座標・半径・色番号です。右に進むとx、下に進むとyが増えます。
変える数 見本 予想すること
色番号 pyxel.circ(80, 60, 12, 8) 黄色から何色になる?
x座標 pyxel.circ(110, 60, 12, 10) 左右のどちらへ移る?
y座標 pyxel.circ(80, 30, 12, 10) 上下のどちらへ移る?
半径 pyxel.circ(80, 60, 20, 10) どのくらい大きくなる?

表の行は、元のcircの1行と入れ替える見本です。全部をまとめて追加せず、ひとつずつ試しましょう。色番号8は、初期パレットでは赤です。色番号はまず0〜15から選べます。

予想してから、ひとつ変えよう

丸の中心を (20, 100) にすると、画面のどのあたりに出るでしょう。予想した場所を指してから試してください。半径を大きくすると、画面からはみ出すことも観察できます。

実験3:矢印キーで丸を動かそう

次はmove_circle.pyという別のファイルを作ります。下のコード全体を貼り付け、保存してください。最初のコードに継ぎ足す形ではありません。

import pyxel

pyxel.init(160, 120, title="Move the circle")
x = 80
y = 60
speed = 2

def update():
    global x, y
    if pyxel.btn(pyxel.KEY_LEFT):
        x -= speed
    if pyxel.btn(pyxel.KEY_RIGHT):
        x += speed
    if pyxel.btn(pyxel.KEY_UP):
        y -= speed
    if pyxel.btn(pyxel.KEY_DOWN):
        y += speed
    x = max(12, min(147, x))
    y = max(12, min(107, y))

def draw():
    pyxel.cls(1)
    pyxel.circ(x, y, 12, 10)

pyxel.run(update, draw)
.\.venv\Scripts\python.exe move_circle.py

Pyxelの画面を一度クリックしてから、矢印キーを押してみましょう。押している間は動き、離すと止まります。上下左右に動かし、画面の端で止まることも確かめてください。

updateは位置などの状態を変え、drawは今の状態を描きます。Pyxelがこの処理を繰り返すと、丸が動いて見えます。
updateは位置などの状態を変え、drawは今の状態を描きます。Pyxelがこの処理を繰り返すと、丸が動いて見えます。

動きを作る、4つのしくみ

  1. 位置を覚える:x = 80とy = 60が丸の中心です。変数の教材で使った「値を覚える」が役立ちます。
  2. キーを調べる:pyxel.btn(pyxel.KEY_RIGHT)は右キーが押されているかを調べます。ifの条件を満たすとx += speedで右へ動かします。
  3. 描き直す:draw()の最初にpyxel.cls(1)で前の画面を塗り、今の位置に丸を描きます。
  4. 繰り返しを任せる:pyxel.run(update, draw)に2つの関数を渡します。ここではupdate()のようにかっこを付けません。

global x, yは、この見本で関数の外にある位置を更新するために使っています。関数のしくみを確かめたいときはdef・引数・returnの教材へ戻れます。大きな作品では状態のまとめ方も工夫しますが、まずはこの短い見本で動きの関係をつかみましょう。

端で止まる2行は、何をしている?

max(12, min(147, x))は、xを12〜147の範囲に収めます。画面のx座標は0〜159で、丸の半径は12なので、端から12だけ内側で止めます。yも同じ考え方で12〜107です。半径を変えた場合は、止まる範囲も見直しましょう。

自分の動きに改造しよう

  1. 速さを変える:speed = 2を1、4に変えます。同じ時間押したとき、動く距離はどうなりますか?
  2. 色を変える:draw()のcircの最後の数を変えます。背景との見やすさも比べます。
  3. 初期位置を変える:最初のx・yを変えます。画面のどこから始まるか予想します。

斜めの2つのキーを同時に押すと、xとyの両方が変わります。この見本では、斜めの移動距離を一定にそろえる補正はしていません。まずは「横だけ」「縦だけ」「両方」の違いを観察してください。

うまく動かないとき

  • キーが効かない:Pyxelのウィンドウをクリックし、入力先を選びます。VS Codeを選んだままだと、そちらにキー入力が届きます。
  • 丸のあとが残る:drawの中でclsがcircより前にあるか確かめます。
  • IndentationError:関数・ifの中の字下げを見本と比べます。半角スペースをそろえましょう。
  • 書き換えても変化しない:保存したファイルと実行するファイルが同じか確認し、前のPyxel画面を閉じて再実行します。
  • No module named ‘pyxel’:インストール先と実行先のPythonを確認します。

できたことを、ひとこと説明しよう

「右キーを押すと、どの変数がどう変わる?」「背景を毎回塗るのはなぜ?」のどちらかを、自分の言葉で説明できたら、次へ進みましょう。

次は、Pyxelエディターで自分のドット絵を描く →。丸の代わりに使いたい形を、紙に描いて考えておくのもおすすめです。

確認した環境と公式資料

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

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


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