Pythonの勉強を始めて、print()で文字を出すところまではできた。でも、黒い画面に文字が流れるだけでは、なかなか楽しさを感じにくいものですよね。
自分の書いたコードで、目に見える何かが動いてくれたら。そう思ったことがある方に試してほしいのが、今回のテーマであるturtleです。
turtleを使うと、画面の上にいる亀に命令を出して、線で図形を描けます。インストールは不要で、Pythonに最初から入っている標準ライブラリだけで動きます。
この記事では、基本の命令から、forを使った図形の描き方、色や塗りつぶし、よくあるつまずきの直し方までを順番に解説します。
turtleはどんなモジュールなのか¶
まずは、turtleがどんな道具なのかを押さえておきましょう。turtleは、ペンを持った亀に命令を出して線を描くためのモジュールです。
画面の真ん中に亀がいて、前に進めと言えば進んだぶんだけ線が引かれます。右に曲がれと言えば、その場で向きを変えます。
この考え方は、Pythonが考えたものではありません。公式ドキュメントによると、1967年に生まれたLogoという教育用の言語の描画の仕組みを、Pythonで再現したものです。
公式ドキュメントでは、すぐに目に見える反応が返ってくるので学習者がプログラミングの考え方に触れやすい、と紹介されています。外部のライブラリを入れずに、ちょっとした絵を出せる手軽さも魅力です。
最初の一歩、亀を動かしてみる¶
では、さっそく亀を動かしてみましょう。次のコードをturtle_test.pyのような名前で保存し、実行してみてください。
ファイル名をturtle.pyにするのは避けてください。理由はあとで説明します。
import turtle
t = turtle.Turtle()
t.forward(100) # 100ピクセル前に進む
t.left(90) # 左に90度回る
t.forward(100)
turtle.done() # ウィンドウを開いたままにする
実行すると新しいウィンドウが開き、亀が右へ進んでから上に曲がって、L字の線を描きます。亀は最初、画面の中心で右を向いた状態から始まります。
最後のturtle.done()は、ウィンドウを開いたままにするための命令です。公式ドキュメントでも、turtleのプログラムの最後の文にするよう書かれています。
よく使う命令の一覧¶
ここで、よく使う命令を表にまとめておきます。最初はこの表の命令だけで、かなりいろいろな絵が描けます。
| 命令 | 短い別名 | 意味 |
|---|---|---|
| forward(距離) | fd | 向いている方向に進む |
| backward(距離) | bk / back | 後ろに下がる |
| left(角度) | lt | 左に回る |
| right(角度) | rt | 右に回る |
| penup() | up / pu | ペンを上げる(線を引かずに移動) |
| pendown() | down / pd | ペンを下ろす(線を引く) |
| goto(x, y) | setpos | 指定した座標へ移動する |
| home() | なし | 中心の(0, 0)に戻る |
| circle(半径) | なし | 円を描く |
| color(色) | なし | ペンや塗りの色を変える |
角度は度で指定し、leftは反時計回り、rightは時計回りです。座標は画面の中心が(0, 0)で、右がxのプラス、上がyのプラスになります。
forを使って正多角形と星を描く¶
ここからが、turtleの本当に楽しいところです。同じ命令をくり返すと、きれいな図形があっという間に描けます。
たとえば正方形は、100進んで90度回るという動きを4回くり返すだけです。forとrange()を使えば、たった3行で書けます。
import turtle
t = turtle.Turtle()
for _ in range(4):
t.forward(100)
t.left(90)
turtle.done()
range(4)は0から3までの4つの数を作るので、中の2行が4回実行されます。使わない変数には、慣習として_という名前を付けます。
range()の動きに自信がない方は、先に次の記事を読んでおくと理解しやすくなります。
【関連記事】Pythonのrange関数を使いこなそう
回る角度は360を辺の数で割る¶
では、正三角形や正六角形はどう描けばいいのでしょうか。ポイントは、亀が1周すると合計で360度回るということです。
正n角形なら、1つの角で回る角度は360をnで割った値になります。これを関数にまとめると、どんな正多角形でも描けるようになります。
import turtle
def polygon(t, sides, length):
"""正多角形を描く"""
angle = 360 / sides
for _ in range(sides):
t.forward(length)
t.left(angle)
t = turtle.Turtle()
t.speed(0) # アニメーションをなくして一瞬で描く
for sides in range(3, 9): # 三角形から八角形まで
polygon(t, sides, 80)
turtle.done()
三角形から八角形までが、同じ場所から重なるように描かれます。辺の数を増やしていくと、だんだん円に近づいていく様子もわかるはずです。
ここでやっていることは、くり返しを関数に切り出すという、プログラミングでとても大事な考え方そのものです。文字だけで説明されるより、絵で見たほうがずっと腑に落ちるのではないでしょうか。
星は回る角度を変えるだけ¶
次は、星を描いてみましょう。五芒星は、144度ずつ回りながら5回進むと描けます。
import turtle
t = turtle.Turtle()
t.color("red", "yellow") # 線の色, 塗りの色
t.begin_fill()
for _ in range(5):
t.forward(200)
t.right(144)
t.end_fill()
turtle.done()
begin_fill()とend_fill()で囲んだ部分で描いた形が、塗りの色で塗られます。公式ドキュメントにある通り、実際に塗られるのはend_fill()を呼んだときです。
color()に色を2つ渡すと、1つ目が線の色、2つ目が塗りの色になります。色は"red"のような英語の名前のほか、"#ff8800"のような16進数の書き方でも指定できます。
描く速さと見た目を調整する¶
図形が複雑になってくると、亀の動きが遅く感じるはずです。そんなときはspeed()で速さを変えます。
速さは0から10までの数か、名前で指定します。公式ドキュメントに載っている対応は次のとおりです。
| 名前 | 数 | 動き |
|---|---|---|
| "slowest" | 1 | いちばん遅い |
| "slow" | 3 | 遅い |
| "normal" | 6 | ふつう |
| "fast" | 10 | 速い |
| "fastest" | 0 | アニメーションなしで一瞬 |
0がいちばん速いという点は、直感と逆なので注意してください。1から10は数が大きいほど速くなり、0だけはアニメーションそのものをしない特別な値です。
亀の形もshape()で変えられます。t.shape("turtle")とすると、矢印ではなく本物の亀の形になり、ぐっと雰囲気が出ます。
ペンの太さはwidth()で変えられ、t.hideturtle()を使えば描き終わったあとに亀を隠せます。完成した絵だけを見せたいときに便利です。
複数の亀を動かす書き方¶
turtleには、関数だけで描く書き方と、Turtleオブジェクトを作って描く書き方の2つがあります。この記事でt = turtle.Turtle()と書いてきたのは、後者の書き方です。
オブジェクトを使う書き方の良いところは、亀を何匹でも作れることです。それぞれに別の色や動きを与えられます。
import turtle
screen = turtle.Screen()
screen.bgcolor("black")
colors = ["red", "orange", "yellow", "green", "cyan", "violet"]
turtles = []
for i, c in enumerate(colors):
t = turtle.Turtle()
t.color(c)
t.speed(0)
t.left(i * 60) # 60度ずつ違う方向を向かせる
turtles.append(t)
for _ in range(36):
for t in turtles:
t.forward(5)
t.left(10)
screen.exitonclick() # クリックするとウィンドウを閉じる
6匹の亀がそれぞれ違う方向へ動き出し、花びらのような模様を描きます。最後のexitonclick()は、画面をクリックしたらウィンドウを閉じる命令です。
クラスとインスタンスの関係が、亀という目に見える形で体験できるのもturtleの良さです。1つのクラスから作った亀でも、それぞれが自分の位置や色を覚えています。
オブジェクト指向の考え方をもう少しくわしく知りたい方は、次の記事もどうぞ。
【関連記事】Pythonのオブジェクト指向とは?
よくあるつまずきと直し方¶
turtleはシンプルですが、初めて使うときにつまずきやすいポイントがいくつかあります。ここでは、よく見かける3つを取り上げます。
ウィンドウがすぐに閉じてしまう¶
コードを実行すると一瞬だけウィンドウが出て、すぐに消えてしまうことがあります。これは、最後の行まで実行し終えたプログラムがそのまま終了しているためです。
対処法は、最後にturtle.done()かscreen.exitonclick()を書くことです。どちらも、ウィンドウを開いたまま待ち続ける状態に入ります。
ファイル名をturtle.pyにしてしまう¶
いちばん多い失敗が、練習用のファイルをturtle.pyという名前で保存してしまうことです。こうすると、import turtleで読み込まれるのが標準ライブラリではなく、自分のファイルになってしまいます。
その結果、AttributeErrorが出て、turtleにTurtleが無いといった不思議なエラーになります。ファイル名をturtle_test.pyなどに変え、同じフォルダにできた__pycache__も消してから実行し直してください。
私はエンジニアとして10年ほど開発に関わってきましたが、標準ライブラリと同じ名前のファイルを作ってしまう失敗は、現場でも何度も見てきました。エラーの文面からは原因が想像しにくいので、気づくまでに意外と時間がかかるのです。
標準ライブラリと同じ名前は避ける。この習慣は、turtleに限らずずっと役に立ちます。
tkinterが無いと言われる¶
turtleは内部でtkinterという画面表示の仕組みを使っています。そのため、tkinterが入っていない環境ではimport turtleの時点でエラーになります。
公式ドキュメントによると、python.orgから入れたWindowsやmacOSのPythonには最初から含まれています。一方で、Linuxの一部のディストリビューションでは別のパッケージとして配られています。
_tkinterという言葉を含むエラーが出たら、Pythonを入手した配布元の案内に従ってTkのパッケージを追加してください。たとえばUbuntuなら、python3-tkというパッケージが用意されています。
また、Google Colabのようにブラウザの中で動く環境では、デスクトップのウィンドウを開けないのでturtleはそのままでは使えません。手元のパソコンにPythonを入れて試すのがいちばん確実です。
新しいバージョンで便利になったこと¶
turtleは古くからあるモジュールですが、最近のバージョンでも少しずつ機能が増えています。公式ドキュメントで確認できる主な追加を表にまとめました。
| 追加された機能 | バージョン | できること |
|---|---|---|
| teleport() | 3.12 | 線を引かずに指定した位置へ瞬間移動する |
| fill() | 3.14 | with文で塗りつぶしの範囲を書ける |
| no_animation() | 3.14 | with文の中だけアニメーションを止める |
| save() | 3.14 | 描いた絵をPostScriptファイルに保存する |
なかでも便利なのが、Python 3.14で入ったfill()です。begin_fill()とend_fill()の組み合わせを、with文で書けるようになりました。
import turtle
t = turtle.Turtle()
t.color("black", "red")
with t.fill(): # Python 3.14以降
t.circle(80)
turtle.done()
withのブロックを抜けると、自動でend_fill()が呼ばれたのと同じ状態になります。end_fill()の書き忘れを防げるのがうれしいところです。
ただし、3.13以前のPythonでは使えないので、手元のバージョンを確認してから試してください。with文の仕組みが気になる方は、次の記事でくわしく解説しています。
【関連記事】Pythonのコンテキストマネージャーとは?
turtleで練習すると身につくこと¶
turtleは子ども向けのおもちゃだと思われがちです。でも実際には、プログラミングの基本をまとめて練習できる、とてもよくできた教材です。
turtleで描く絵と、身につく考え方の対応を整理すると次のようになります。
| 描くもの | 身につくこと |
|---|---|
| 正方形や正多角形 | forによるくり返し |
| 好きな大きさの多角形 | 関数と引数 |
| 条件で色が変わる模様 | ifによる分岐 |
| 複数の亀の動き | クラスとインスタンス |
| 木の枝やうずまき | 再帰 |
とくに再帰は、文字で説明されるとつまずきやすい単元です。枝が2つに分かれ、その先でまた2つに分かれる木の絵を描いてみると、関数が自分自身を呼ぶ動きが目で追えます。
再帰そのものの考え方は、次の記事で解説しています。turtleと合わせて読むと、理解がぐっと深まるはずです。
【関連記事】Pythonの再帰関数とは?
ほかにもどんな絵が描けるのか知りたいときは、ターミナルでpython -m turtledemoと実行してみてください。Pythonに付属しているデモのビューアーが開き、いろいろな作例とそのコードを見られます。
まとめ¶
turtleは、画面の上の亀に命令を出して線を描く、Python標準のモジュールです。インストール不要で、書いたコードの結果がすぐ目に見えるのが最大の特長です。
forward()やleft()といった基本の命令に、forや関数を組み合わせるだけで、多角形や星をかんたんに描けます。速さはspeed()で調整でき、0がいちばん速いという点だけ覚えておきましょう。
ウィンドウがすぐ閉じるならturtle.done()を最後に書き、AttributeErrorが出たらファイル名がturtle.pyになっていないか確かめてください。tkinterが無いと言われたら、配布元の案内に沿ってTkを追加します。
文字だけの練習に少し飽きてきたら、ぜひturtleで1枚の絵を描いてみてください。動くものを作る楽しさは、学習を続けるいちばんの原動力になります。
ここまでお読みいただきありがとうございました。