Python Turtle の描画を思い通りに!resetscreen() の代替方法と使い分け

2025-06-06

turtle.resetscreen() とは?

turtle.resetscreen() は、Python の turtle グラフィックモジュールで使われる関数です。この関数は、文字通り「スクリーンをリセットする」ために使用されます。

具体的には、以下の3つの主要な処理を実行します。

  1. 全てのタートルを削除する (Delete all turtles)
    スクリーン上に作成された全てのタートル(描画を行う「ペン」のようなオブジェクト)を削除します。これにより、以前の描画が全てクリアされます。

  2. 描画をリセットする (Reset drawing)
    スクリーン上で行われた全ての描画(線、図形など)を消去し、スクリーンを初期状態に戻します。

  3. 入力とイベントバインディングをリセットする (Reset input and event bindings)
    キーボード入力やマウスイベントにバインドされていた(関連付けられていた)全てのイベントハンドラを解除します。これにより、プログラムの実行中に設定されたカスタムのイベント処理が全て無効になります。

どのような時に使うのか?

turtle.resetscreen() は、主に以下のような状況で役立ちます。

  • デバッグ時
    プログラムの特定のセクションを繰り返し実行して、そのたびにスクリーンをクリアしたい場合に、デバッグ作業を効率化できます。
  • 複数の独立した描画シーケンスをテストする時
    異なる描画パターンを連続してテストしたいが、それぞれのテストの前にスクリーンをきれいにしたい場合に使用します。
  • プログラムを最初からやり直したい時
    何らかの理由で、現在の描画やタートルの状態を全てクリアして、プログラムを完全に初期状態から再実行したい場合に便利です。

使用例

以下に簡単な使用例を示します。

import turtle

# タートルを作成
t = turtle.Turtle()

# 四角形を描画
for _ in range(4):
    t.forward(100)
    t.right(90)

# 少し待つ
turtle.delay(1000) # 1秒待つ (ミリ秒単位)

# スクリーンをリセット
turtle.resetscreen()

# 新しい描画を開始
t_new = turtle.Turtle()
t_new.circle(50)

# 終了
turtle.done()

このコードを実行すると、まず四角形が描画されます。1秒待った後、turtle.resetscreen() が呼び出され、四角形が消えてスクリーンが完全にクリアされます。その後、新しいタートルが作成され、円が描画されます。

  • 単に描画だけをクリアしたい場合は、turtle.clear() または各タートルオブジェクトの clear() メソッドを使用することを検討してください。これらのメソッドは、描画は消去しますが、タートルの状態やイベントバインディングは保持します。
  • turtle.resetscreen() は、スクリーン全体をリセットするため、既存のタートルオブジェクトやイベントバインディングを全て失います。もし一部の要素だけを保持したい場合は、この関数は適切ではありません。


turtle.resetscreen() は、画面上の全てのタートル、描画、およびイベントバインディングをリセットするため、特に注意が必要です。

エラーではないが「何も表示されない」「プログラムがすぐに終了する」

これはエラーメッセージが出るわけではありませんが、初心者によくある混乱です。

原因
turtle.resetscreen() を呼び出した後、新しい描画命令がない、または turtle.done()turtle.mainloop() といったイベントループを開始する関数が最後に呼び出されていないため、プログラムがすぐに終了し、描画ウィンドウが表示されないか、すぐに閉じてしまいます。

トラブルシューティング

  • プログラムの最後に turtle.done() または turtle.mainloop() を追加して、描画ウィンドウが開いたままになるようにしてください。これにより、ユーザーがウィンドウを閉じるまでプログラムが待機します。
  • turtle.resetscreen() の後に、新しいタートルを作成し、描画命令を記述しているか確認してください。


import turtle

t = turtle.Turtle()
t.forward(100)

turtle.resetscreen() # ここで全てがリセットされる

# t はもう存在しないか、参照できない状態になっている(タートルオブジェクト自体は存在しうるが、スクリーンから削除されている)
# 新しいタートルを作成する必要がある
new_t = turtle.Turtle()
new_t.circle(50)

turtle.done() # これがないとすぐにウィンドウが閉じる

NameError: name 't' is not defined (または類似の変数名エラー)

原因
turtle.resetscreen() を呼び出すと、スクリーン上の全てのタートルオブジェクトが「削除」されます。これは、以前に作成したタートルオブジェクトへの参照が、もはや有効なタートルを表していないことを意味します。resetscreen() の後に、以前のタートルオブジェクト(例: t)を使おうとすると、このエラーが発生します。

トラブルシューティング
turtle.resetscreen() を呼び出した後は、新たに turtle.Turtle() を呼び出して新しいタートルオブジェクトを作成し、それを使用する必要があります。


import turtle

my_turtle = turtle.Turtle()
my_turtle.forward(50)

turtle.resetscreen()

# ここで my_turtle を使おうとするとエラーになる可能性がある
# my_turtle.right(90) # NameError (または描画されない)

# 正しい方法:新しいタートルを作成する
another_turtle = turtle.Turtle()
another_turtle.circle(30)

turtle.done()

イベントハンドラが機能しない

原因
turtle.resetscreen() は、キーボード入力やマウスクリックなどのイベントにバインドされていた(関連付けられていた)全てのイベントハンドラを解除します。そのため、resetscreen() の前に設定したイベントハンドラが、その後機能しなくなります。

トラブルシューティング
turtle.resetscreen() を呼び出した後、必要に応じてイベントハンドラを再設定する必要があります。


import turtle

def move_forward():
    turtle.forward(10)

screen = turtle.Screen()
screen.onkey(move_forward, "Up") # 上矢印キーで前進

screen.listen() # イベントリスナーを開始

# 何らかの描画...
turtle.circle(20)

# スクリーンをリセット
turtle.resetscreen()

# move_forward 関数はまだ存在するが、onkey のバインディングが解除されているため、
# キーを押しても何も起こらない。
# 再度バインディングする必要がある。

# 新しいスクリーンオブジェクトを取得(resetscreen()で既存のスクリーンオブジェクトがリセットされるため)
new_screen = turtle.Screen() 
new_screen.onkey(move_forward, "Up") # イベントハンドラを再バインド
new_screen.listen()

turtle.done()

turtle.resetscreen() と他のリセット系関数との混同

turtle モジュールには、似たような名前のリセット系関数がいくつかあり、これらを混同することで予期せぬ挙動につながることがあります。

  • turtle.reset(): 特定のタートルオブジェクトの描画を消去し、そのタートルの位置、向き、ペン状態などを初期状態に戻す。他のタートルやスクリーン全体には影響しない。
  • turtle.clear(): 特定のタートルオブジェクトの描画のみを消去する。タートルの位置や向きはそのまま。
  • turtle.clearscreen(): スクリーン上の全ての描画と全てのタートルを削除しますが、スクリーン設定(背景色、サイズなど)やイベントバインディングは保持する場合があります。多くの場合 resetscreen() と似た効果ですが、違いがあることを知っておくと良いでしょう。
  • turtle.resetscreen(): スクリーン上の全てのタートル、描画、イベントバインディングをリセット。最も広範なリセットを行う。

トラブルシューティング
それぞれの関数の役割を理解し、目的に合った関数を使用することが重要です。

  • 特定のタートルだけを初期状態に戻したい場合は turtle.reset()
  • 描画だけをクリアしてタートルや設定は保持したい場合は turtle.clear() (特定のタートル用) や turtle.clearscreen() (スクリーン全体用)。
  • 全てをまっさらにして最初からやり直したい場合は turtle.resetscreen()
  • turtle.done() または turtle.mainloop() を忘れない
    これらは、プログラムが終了せずに描画ウィンドウを表示し続けるために非常に重要です。
  • 公式ドキュメントを参照する
    turtle モジュールの公式ドキュメントは、各関数の詳細な動作や引数について正確な情報を提供しています。
  • 最小限の再現コードを作成する
    問題が発生したときに、コード全体を提示するのではなく、問題が再現する最小限のコード片を作成してみましょう。これにより、問題の切り分けが容易になります。
  • エラーメッセージをよく読む
    Pythonのエラーメッセージは、問題の特定に役立つ多くの情報を含んでいます。特に NameErrorAttributeError などは、どこで何が問題になっているのかを示唆してくれます。


例1:シンプルなリセットと再描画

この例では、まず簡単な図形(四角形)を描画し、その後 resetscreen() を呼び出して画面をクリアし、別の図形(円)を新しく描画します。

import turtle
import time # 一時停止のために使用

print("四角形を描画します...")

# 最初のタートルを作成し、四角形を描画
t = turtle.Turtle()
t.pensize(3)
t.color("blue")
for _ in range(4):
    t.forward(100)
    t.right(90)

time.sleep(2) # 2秒間待機して、四角形が表示されるのを確認

print("スクリーンをリセットします...")
turtle.resetscreen() # 全てのタートルと描画、イベントバインディングをリセット

print("円を描画します...")
# resetscreen()の後、古いタートル(t)はもはやスクリーン上に存在しないため、
# 新しいタートルを作成する必要がある
new_t = turtle.Turtle()
new_t.pensize(5)
new_t.color("red")
new_t.circle(70)

turtle.done() # ウィンドウが開いたままになるようにする
print("プログラム終了。")

実行結果の解説

  1. 青い線で四角形が描画されます。
  2. 2秒間停止します。
  3. turtle.resetscreen() が実行されると、ウィンドウが一度真っ白になり、四角形が消えます。古いタートル t は事実上使用できなくなります。
  4. 新しいタートル new_t が作成され、赤い線で円が描画されます。
  5. ウィンドウは turtle.done() によって開いたままになります。

例2:繰り返し描画で resetscreen() を使う

この例では、ループ内で異なる図形を連続して描画するために resetscreen() を使用します。

import turtle
import time

def draw_square(size, color):
    t = turtle.Turtle()
    t.pensize(2)
    t.color(color)
    for _ in range(4):
        t.forward(size)
        t.right(90)
    time.sleep(1) # 各描画の後に1秒待つ

def draw_circle(radius, color):
    t = turtle.Turtle()
    t.pensize(2)
    t.color(color)
    t.circle(radius)
    time.sleep(1) # 各描画の後に1秒待つ

shapes_to_draw = [
    ("square", 80, "green"),
    ("circle", 60, "purple"),
    ("square", 120, "orange"),
    ("circle", 40, "brown")
]

for shape_type, size_or_radius, color in shapes_to_draw:
    print(f"{color}{shape_type} を描画します...")
    if shape_type == "square":
        draw_square(size_or_radius, color)
    elif shape_type == "circle":
        draw_circle(size_or_radius, color)

    if shape_type != shapes_to_draw[-1][0]: # 最後の描画以外はリセット
        turtle.resetscreen()
    else:
        # 最後の描画の後もウィンドウを保持したい場合は、ここでもう一度タートルを作成するか、
        # あるいは単に turtle.done() を呼び出す準備をする
        pass

turtle.done()
print("全ての描画が完了しました。")

実行結果の解説

  1. まず緑の四角形が描画され、1秒停止します。
  2. resetscreen() で画面がクリアされ、紫の円が描画され、1秒停止します。
  3. 再び resetscreen() で画面がクリアされ、オレンジの四角形が描画され、1秒停止します。
  4. 再び resetscreen() で画面がクリアされ、茶色の円が描画されます。
  5. 最後の描画の後もウィンドウが開いたままになります。

例3:イベントハンドラと resetscreen()

resetscreen() はイベントバインディングも解除することを示す例です。リセット後にイベントを再設定する必要があります。

import turtle

screen = turtle.Screen()
t = turtle.Turtle()
t.pensize(3)

def move_forward():
    t.forward(50)

def move_backward():
    t.backward(50)

def reset_and_rebind():
    print("スクリーンをリセットし、イベントを再バインドします...")
    turtle.resetscreen() # イベントバインディングも解除される!
    
    # 新しいタートルを作成
    global t # グローバル変数tを更新
    t = turtle.Turtle()
    t.pensize(3)

    # イベントハンドラを再バインド
    screen_after_reset = turtle.Screen() # 新しいScreenオブジェクトを取得
    screen_after_reset.onkey(move_forward, "Up")
    screen_after_reset.onkey(move_backward, "Down")
    screen_after_reset.onkey(reset_and_rebind, "r") # rキーのリセットイベントも再バインド
    screen_after_reset.listen()
    print("再バインド完了。")


# 初期イベントバインディング
screen.onkey(move_forward, "Up") # 上矢印キーで前進
screen.onkey(move_backward, "Down") # 下矢印キーで後退
screen.onkey(reset_and_rebind, "r") # 'r'キーでリセットと再バインド

screen.listen() # イベントリスナーを開始
print("上矢印、下矢印キーでタートルを動かせます。'r'キーでリセットします。")
turtle.done()
  1. プログラムを開始すると、上矢印キーと下矢印キーでタートルを動かせます。
  2. 'r' キーを押すと、reset_and_rebind() 関数が実行されます。
  3. turtle.resetscreen() が呼び出され、画面がクリアされます。この時点で、元の screen オブジェクトにバインドされていたイベントは解除されます。
  4. その後、reset_and_rebind() 関数内で新しいタートルが作成され、イベントハンドラが新しい Screen オブジェクトに対して再バインドされます。
  5. 再度、上矢印キーや下矢印キーでタートルを動かすことができるようになります。


turtle モジュールには、描画のクリアやタートルの状態管理に関する複数の関数があります。目的に応じて使い分けることが重要です。

turtle.clear() または turtle.Turtle().clear() (描画のみをクリア)

これは、特定のタートルが描画した内容のみをクリアしたい場合に最もよく使われる代替方法です。タートルの位置、向き、ペン色などの状態はそのまま維持されます。

  • my_turtle_object.clear() (タートルオブジェクトのメソッド): 特定の my_turtle_object が描画した内容をクリアします。
  • turtle.clear() (モジュールレベル): アクティブな(最後に使われた)タートルの描画をクリアします。

使用例

import turtle
import time

# タートルを作成
t = turtle.Turtle()
t.pensize(3)
t.color("blue")

# 四角形を描画
print("四角形を描画します...")
for _ in range(4):
    t.forward(100)
    t.right(90)

time.sleep(2) # 2秒間待機

print("描画をクリアします (タートルの状態は維持されます)...")
t.clear() # ここで描画のみが消える

time.sleep(1) # 1秒間待機

# タートルの位置はそのままで、新しい描画を開始
print("同じタートルで円を描画します...")
t.color("green") # 色だけ変える
t.circle(70)

turtle.done()
print("プログラム終了。")

resetscreen() との違い

  • イベントバインディングも維持される。
  • タートルの位置、向き、ペン状態などの属性が維持される。
  • タートルオブジェクト (t)が削除されない。

turtle.reset() または turtle.Turtle().reset() (タートルの状態もリセット)

これは、特定のタートルの描画をクリアし、さらにそのタートル自身の位置、向き、ペン状態などを初期状態に戻したい場合に使用します。他のタートルやスクリーン全体には影響しません。

  • my_turtle_object.reset() (タートルオブジェクトのメソッド): 特定の my_turtle_object の描画をクリアし、初期状態に戻します。
  • turtle.reset() (モジュールレベル): アクティブなタートルの描画をクリアし、初期状態に戻します。

使用例

import turtle
import time

t = turtle.Turtle()
t.pensize(5)
t.color("purple")
t.penup() # ペンを上げて移動
t.goto(50, 50)
t.pendown() # ペンを下ろす
t.forward(100)
t.right(90)
t.forward(50)

time.sleep(2) # 2秒間待機

print("タートルをリセットします (描画と状態を初期化)...")
t.reset() # 描画が消え、タートルが中央(0,0)に戻り、向きも初期化される

time.sleep(1) # 1秒間待機

print("リセットされたタートルで新しい描画を開始します...")
t.color("orange")
t.circle(40)

turtle.done()
print("プログラム終了。")

resetscreen() との違い

  • 他のタートルやイベントバインディングには影響しない。
  • 影響範囲が特定のタートルオブジェクトに限定される。

turtle.clearscreen() (ほぼ resetscreen() と同じだが一部違いがある)

これは turtle.resetscreen() に非常に似ていますが、細かい違いがあります。通常、スクリーンの背景色などの設定は保持される傾向があるという点が挙げられます。ただし、Pythonのバージョンや環境によっては resetscreen() と全く同じ挙動をする場合もあります。

基本的には、resetscreen() が「全ての要素をゼロから再構築する」イメージであるのに対し、clearscreen() は「全ての描画とタートルを削除するが、スクリーンの初期設定やイベントリスナーの構造は保持しようとする」というニュアンスの違いがあります。

使用例

import turtle
import time

screen = turtle.Screen()
screen.bgcolor("lightblue") # 背景色を設定

t = turtle.Turtle()
t.circle(80)

time.sleep(2)

print("clearscreen() を呼び出します...")
turtle.clearscreen() # 背景色は維持される可能性がある

# 新しいタートルを作成する必要がある (clearscreen()もタートルを削除する)
new_t = turtle.Turtle()
new_t.color("darkgreen")
new_t.dot(100) # 大きな点を描画

turtle.done()
print("プログラム終了。")

resetscreen() との違い

  • イベントバインディングの扱いにも微妙な違いが生じることがありますが、多くの場合、どちらもイベントを解除します。
  • resetscreen() は通常、背景色などもデフォルトに戻しますが、clearscreen() は背景色などのスクリーン設定を保持する傾向があります。

複数のタートルを個別に管理する

複数のタートルを使用し、それぞれを独立して管理したい場合、resetscreen() を使わずに、各タートルオブジェクトの clear()reset() メソッドを個別に呼び出すことができます。

使用例

import turtle
import time

t1 = turtle.Turtle()
t1.color("red")
t1.penup()
t1.goto(-100, 0)
t1.pendown()
t1.circle(50)

t2 = turtle.Turtle()
t2.color("blue")
t2.penup()
t2.goto(100, 0)
t2.pendown()
for _ in range(3): # 三角形
    t2.forward(100)
    t2.left(120)

time.sleep(2)

print("赤いタートルの描画だけをクリアします...")
t1.clear() # t1の描画のみ消える

time.sleep(2)

print("青いタートルをリセットします (描画と状態を初期化)...")
t2.reset() # t2の描画が消え、t2が中央に戻る

time.sleep(1)

print("リセットされた青いタートルで新しい描画を開始します...")
t2.color("green")
t2.dot(20) # 小さな点を描画

turtle.done()
print("プログラム終了。")
  • 必要なタートルだけを操作でき、他のタートルやスクリーンの状態には影響しない。
  • turtle.clearscreen(): resetscreen() と似ているが、スクリーンの背景色など一部の設定が保持される可能性がある。
  • my_turtle.reset(): 特定のタートルが描いた線や図形を消し、さらにそのタートルを初期状態(中央、右向き)に戻したい場合。
  • my_turtle.clear(): 特定のタートルが描いた線や図形だけを消したいが、そのタートルの位置や向きは変えたくない場合。
  • turtle.resetscreen(): 画面全体を完全にまっさらな状態にしたい(タートル、描画、イベントバインディングを全て破棄)場合に使う。