turtle.get_poly()

2025-06-06

以下に詳しく説明します。

turtle モジュールとは?

turtle モジュールは、グラフィックスを描画するためのPythonの標準ライブラリです。画面上に「タートル」(カメの形をしたカーソル)を動かし、線を引いたり、図形を描いたりすることができます。小学校のプログラミング教育などでもよく使われます。

get_poly() の機能

turtle.get_poly() 関数は、以下の目的で使用されます。

  1. ポリゴンの頂点座標の取得
    begin_poly()end_poly() の間にタートルが移動した経路を、ポリゴン(多角形)の頂点の座標として取得します。

  2. 図形の再利用や保存
    取得した頂点座標のリストは、後で同じ図形を再描画したり、ファイルに保存したり、他の計算に使用したりするために利用できます。

使用方法の例

一般的な使用方法は以下のようになります。

import turtle

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

# ポリゴン記録の開始
t.begin_poly()

# タートルを動かして図形を描く(この経路がポリゴンの頂点として記録される)
t.forward(100)
t.left(90)
t.forward(50)
t.left(90)
t.forward(100)
t.left(90)
t.forward(50)

# ポリゴン記録の終了と頂点座標の取得
poly_coords = t.get_poly()

# 取得した頂点座標を表示
print(poly_coords)

# 画面を閉じる
turtle.done()

出力例

上記のコードを実行すると、poly_coords には以下のようなリストが出力されます(具体的な値はタートルの初期位置や移動量によって異なります)。

((0.00, 0.00), (100.00, 0.00), (100.00, 50.00), (0.00, 50.00), (0.00, 0.00))

このリストは、x 座標と y 座標のペアのタプルが並んだもので、描画された四角形の頂点座標を表しています。

注意点

  • ポリゴン記録中に clear()reset() を呼び出すと、記録中のポリゴンデータはリセットされます。
  • end_poly() を呼び出す前に get_poly() を呼び出した場合、begin_poly() からその時点までの経路がポリゴンとして取得されます。
  • begin_poly() が呼び出されていない状態で get_poly() を呼び出すとエラーになる可能性があります。


turtle.get_poly() に関連する一般的なエラーとトラブルシューティング

begin_poly() の呼び出し忘れ

エラーの原因
get_poly() は、begin_poly() で記録を開始し、end_poly() で記録を終了したポリゴンの頂点を取得します。begin_poly() を呼び出さずに get_poly() を呼び出すと、空のポリゴンが返されるか、予期せぬ結果になります。

エラーメッセージの例
直接的なエラーメッセージは出にくいですが、期待する座標が得られない場合に気づきます。

トラブルシューティング

  • 必ず turtle.begin_poly() を、ポリゴンとして記録したい描画操作の前に呼び出してください。

コード例(悪い例)

import turtle
t = turtle.Turtle()
# t.begin_poly() がない
t.forward(100)
t.left(90)
poly_coords = t.get_poly() # ここで空または不正な座標が返される可能性がある
print(poly_coords)
turtle.done()

コード例(良い例)

import turtle
t = turtle.Turtle()
t.begin_poly() # これが重要
t.forward(100)
t.left(90)
t.end_poly()
poly_coords = t.get_poly()
print(poly_coords)
turtle.done()

end_poly() の呼び出し忘れ

エラーの原因
begin_poly() を呼び出したものの、end_poly() を呼び出さずに get_poly() を呼び出した場合、ポリゴン記録が終了していないため、期待するポリゴンが完全に記録されていない可能性があります。この場合、get_poly() は、begin_poly() が呼び出されてから get_poly() が呼び出されるまでの経路を返します。これはエラーではありませんが、意図した結果と異なる場合があります。

トラブルシューティング

  • ポリゴンの記録を完了したい場合は、必ず turtle.end_poly() を呼び出してください。

コード例(意図と異なる結果の例)

import turtle
t = turtle.Turtle()
t.begin_poly()
t.forward(100)
t.left(90)
t.forward(50)
poly_coords = t.get_poly() # end_poly() がないため、記録が途中で終わる
print(poly_coords)
t.forward(100) # この後の動きは記録されない
turtle.done()

コード例(正しい例)

import turtle
t = turtle.Turtle()
t.begin_poly()
t.forward(100)
t.left(90)
t.forward(50)
t.end_poly() # 記録を終了
poly_coords = t.get_poly()
print(poly_coords)
t.forward(100) # この後の動きはポリゴン記録には影響しない
turtle.done()

複数のポリゴンを同時に記録しようとしている

エラーの原因
turtle モジュールは、一度に1つのポリゴンしか記録できません。begin_poly() を連続して呼び出しても、最初の呼び出しで記録が開始され、それ以降の呼び出しは無視されるか、既存の記録を上書きする可能性があります(バージョンによって挙動が異なる可能性あり)。

トラブルシューティング

  • あるいは、複数のタートルオブジェクトを生成し、それぞれで異なるポリゴンを記録する方法も考えられます。
  • 複数のポリゴンが必要な場合は、1つのポリゴンの記録 (begin_poly() -> 描画 -> end_poly() -> get_poly()) を完了してから、次のポリゴンの記録を開始するようにしてください。

turtle.py というファイル名でスクリプトを保存している

エラーの原因
これは turtle.get_poly() に固有のエラーではありませんが、turtle モジュール全般でよくある問題です。自分のPythonスクリプトファイルの名前を turtle.py にしてしまうと、Pythonが標準ライブラリの turtle モジュールではなく、自分のスクリプトファイルをインポートしようとするため、AttributeError などのエラーが発生します。

エラーメッセージの例
AttributeError: module 'turtle' has no attribute 'get_poly' (または他のturtle関数名)

トラブルシューティング

  • 自分のスクリプトファイル名を my_turtle_drawing.pydrawing_shapes.py のように、turtle.py 以外の名前に変更してください。変更後、.pyc ファイルが残っている場合はそれも削除すると良いでしょう。

turtle.Screen() や turtle.done() の不足

エラーの原因
turtle モジュールで描画を行う場合、通常はグラフィックスウィンドウを表示し、ユーザーの操作を待つために turtle.Screen() (または turtle.getscreen())と turtle.done() が必要です。これらが不足していると、プログラムがすぐに終了してしまい、描画結果を確認できなかったり、スクリプトが「フリーズ」したように見えたりすることがあります。

トラブルシューティング

  • スクリプトの最後に turtle.done() (または turtle.exitonclick() など)を追加して、ウィンドウが開いたままになるようにしてください。

複雑な図形や高速な描画による予期せぬ結果

エラーの原因
非常に複雑な図形や、speed(0) などで高速に描画する場合、タートルの位置のサンプリングが追いつかない、またはポリゴンの頂点として記録される座標が期待通りにならないことがあります。特に、曲線を circle()dot() などで描画した場合、get_poly() が返すのはそれらの図形を構成する「点」のリストではなく、タートルが移動したパス上の主要な点のリストになります。

  • 曲線などをポリゴンで近似したい場合は、短い直線セグメントの繰り返しで描画し、それぞれのセグメントの端点をポリゴンの頂点として記録する必要があります。
  • get_poly() で正確な頂点リストが必要な場合は、forward(), left(), right() など、直線的な移動と角度の変更を組み合わせることで、意図した通りの頂点を持つポリゴンを構成するようにしてください。
  • オンラインで検索する
    エラーメッセージや問題の挙動をそのまま検索すると、Stack Overflowなどのコミュニティで同じ問題に遭遇した人の解決策が見つかることが多いです。
  • コードを単純化する
    複雑なコードで問題が発生した場合は、get_poly() の呼び出しと最小限の描画操作だけを残して、問題が再現するかどうかを確認します。これにより、問題の原因となっている箇所を特定しやすくなります。
  • エラーメッセージをよく読む
    Pythonのエラーメッセージは、問題の箇所(ファイル名、行番号)とエラーの種類を示してくれます。これを手掛かりにデバッグを進めましょう。


例1:シンプルな四角形のポリゴン取得

最も基本的な例です。begin_poly()end_poly() で描画を挟み、その経路の頂点を取得します。

import turtle

# タートルとスクリーンをセットアップ
screen = turtle.Screen()
screen.setup(width=600, height=400)
t = turtle.Turtle()
t.speed(1) # 描画速度を遅くして確認しやすくする

print("ポリゴン記録を開始します...")
t.begin_poly()

# 四角形を描画
t.forward(100)
t.left(90)
t.forward(50)
t.left(90)
t.forward(100)
t.left(90)
t.forward(50) # 始点に戻る

print("ポリゴン記録を終了します...")
t.end_poly()

# 記録されたポリゴンの頂点座標を取得
poly_coords = t.get_poly()

print("取得したポリゴンの頂点座標:")
for coord in poly_coords:
    print(f"  {coord}")

# 描画を続ける場合は、以下のようにタートルを動かせる
# t.penup()
# t.goto(0, -100)
# t.pendown()
# t.circle(50)

# 画面を閉じないようにする
turtle.done()

解説

  1. t.begin_poly() でポリゴン記録を開始します。
  2. タートルを動かして四角形を描画します。この間のタートルの位置が頂点として記録されます。
  3. t.end_poly() でポリゴン記録を終了します。
  4. t.get_poly() で、記録された頂点座標のリスト(タプルのタプル)を取得し、表示します。

例2:取得したポリゴン座標を使って別のタートルで同じ図形を描画

get_poly() の主な用途の一つです。取得した座標データがあれば、同じ図形を何度でも、別のタートルで描画できます。

import turtle

screen = turtle.Screen()
screen.setup(width=700, height=500)

# 最初のタートルで星を描画し、そのポリゴンを取得
t1 = turtle.Turtle()
t1.color("blue")
t1.speed(3)
t1.penup()
t1.goto(-150, 50)
t1.pendown()

t1.begin_poly()
for _ in range(5):
    t1.forward(150)
    t1.right(144)
t1.end_poly()

star_coords = t1.get_poly()
print("星のポリゴン座標を取得しました:", star_coords)

# 最初のタートルを非表示にする
t1.hideturtle()

# 新しいタートルで取得したポリゴンを使って同じ星を描画
t2 = turtle.Turtle()
t2.color("red")
t2.speed(1)
t2.penup() # 描画しない状態で移動
t2.goto(star_coords[0]) # 最初の頂点に移動
t2.pendown() # 描画開始

# 取得した座標をなぞる
for x, y in star_coords:
    t2.goto(x, y)

# 画面を閉じる
turtle.done()

解説

  1. 最初のタートル t1 で星型を描画し、get_poly() でその頂点座標を star_coords に保存します。
  2. t1 を非表示にし、新しいタートル t2 を作成します。
  3. t2star_coords の最初の座標に移動させ、ペンを下ろします。
  4. star_coords 内のすべての座標を順に t2.goto(x, y) でたどることで、t1 が描いた星とまったく同じ星を t2 が描画します。

例3:ポリゴンの頂点数を制限する(カスタムポリゴン)

get_poly() は描画された全ての点を記録します。しかし、場合によっては特定の点だけをポリゴンの頂点としたいことがあります。この例では、ポリゴンとして記録する点を手動で指定します。

import turtle

screen = turtle.Screen()
screen.setup(width=600, height=400)
t = turtle.Turtle()
t.speed(1)
t.penup()
t.goto(-100, 0)
t.pendown()

# カスタムな頂点リストを作成
# get_poly() を使わず、自分で座標を管理する
custom_polygon_points = []

# 複数の点を移動しながら追加していく
t.forward(100)
custom_polygon_points.append(t.pos()) # 現在の位置をリストに追加

t.left(90)
t.forward(50)
custom_polygon_points.append(t.pos())

t.right(135)
t.forward(120)
custom_polygon_points.append(t.pos())

t.right(135)
t.forward(100)
custom_polygon_points.append(t.pos())

# 始点に戻る
t.goto(custom_polygon_points[0])
custom_polygon_points.append(t.pos())

print("カスタムポリゴンの頂点座標:")
for coord in custom_polygon_points:
    print(f"  {coord}")

# 必要であれば、これらの点を使って塗りつぶしなどを行うことも可能
# t.begin_fill()
# for x, y in custom_polygon_points:
#     t.goto(x, y)
# t.end_fill()

turtle.done()

解説

  • これにより、get_poly() が記録する「タートルの移動経路全体」ではなく、「指定したタイミングでのタートルの位置」を頂点とするポリゴンデータを自分で構築できます。これは、複雑なパスの一部だけをポリゴンとして扱いたい場合に有用です。
  • この例では get_poly() を直接使用していません。代わりに、t.pos() (タートルの現在位置を取得する関数) を使って、タートルが特定の地点に到達するたびにその座標をリスト custom_polygon_points に手動で追加しています。

ユーザーがクリックした点をポリゴンの頂点として記録し、最終的にそのポリゴンを取得して描画する例です。

import turtle

screen = turtle.Screen()
screen.setup(width=600, height=600)
screen.title("Click to define a polygon (Right-click to finish)")
t = turtle.Turtle()
t.speed(0) # 最速
t.penup() # 描画しない状態で移動
t.goto(0, 0)
t.pendown()
t.hideturtle() # タートルカーソルを非表示にする

polygon_points = []
drawing_active = False

def start_drawing(x, y):
    global drawing_active
    if not drawing_active:
        print("描画を開始します。クリックで点を追加してください。")
        t.clear() # 前の描画をクリア
        t.penup()
        t.goto(x, y)
        t.pendown()
        polygon_points.clear()
        polygon_points.append((x, y))
        t.dot(5, "blue")
        drawing_active = True
        # begin_poly() はここでは使わない (点の記録を手動で行うため)
        # 厳密なポリゴン記録が必要なら begin_poly() をここに置き、end_poly() を finish_drawing() に置く

def add_point(x, y):
    if drawing_active:
        t.goto(x, y)
        polygon_points.append((x, y))
        t.dot(5, "blue")
        print(f"点 ({x}, {y}) を追加しました。")

def finish_drawing(x, y): # 右クリックで終了
    global drawing_active
    if drawing_active:
        print("描画を終了します。")
        drawing_active = False
        if len(polygon_points) > 2: # 3点以上でポリゴンが成立
            # 最後の点から最初の点へ線を引いて閉じる
            t.goto(polygon_points[0])
            polygon_points.append(polygon_points[0]) # 閉じるために最初の点を最後にも追加

            print("\n完成したポリゴンの頂点座標:")
            for coord in polygon_points:
                print(f"  {coord}")

            # 取得したポリゴンデータを使って塗りつぶし
            fill_turtle = turtle.Turtle()
            fill_turtle.hideturtle()
            fill_turtle.penup()
            fill_turtle.goto(polygon_points[0])
            fill_turtle.pendown()
            fill_turtle.fillcolor("lightgreen")
            fill_turtle.begin_fill()
            for px, py in polygon_points:
                fill_turtle.goto(px, py)
            fill_turtle.end_fill()
        else:
            print("ポリゴンを形成するには3点以上必要です。")
        polygon_points.clear() # 次の描画のためにクリア

# イベントリスナーを設定
screen.onclick(add_point, btn=1) # 左クリックで点を追加
screen.onclick(finish_drawing, btn=3) # 右クリックで描画終了

# 指示を表示
t.penup()
t.goto(0, 180)
t.write("左クリックで点を打ち、右クリックで終了", align="center", font=("Arial", 16, "normal"))
t.goto(0, 0)
t.pendown()

turtle.done()
  • 右クリックすると描画が終了し、記録された点を使ってポリゴンを閉じ、塗りつぶします。
  • 左クリックするたびに、タートルの現在位置がクリックされた点に移動し、その座標が polygon_points リストに追加されます。
  • screen.onclick() を使って、マウスの左クリックと右クリックにそれぞれ関数を割り当てています。
  • この例では、turtle.get_poly() を直接使っていません。これは、ユーザーがクリックした座標を直接取得し、それをポリゴンの頂点として管理しているためです。get_poly() はタートルの「経路」を記録するのに対し、この例では「クリックされた特定の点」を記録しています。


手動で座標を記録する

これが最も一般的で柔軟性の高い代替手段です。turtle.get_poly() がタートルの全ての移動経路を記録するのに対し、この方法では必要な特定の時点の座標のみを記録します。

方法

  • ポリゴンの頂点としたい時点でこれらの関数を呼び出し、返される座標(タプル (x, y))をリストに格納していきます。
  • タートルの現在位置を取得する turtle.pos() または turtle.position() 関数を使用します。

利点

  • イベント駆動型プログラミングとの相性
    マウスクリックイベントなど、ユーザーの操作に基づいて点を追加するような場合に非常に役立ちます。
  • 効率性
    無関係な中間点を記録しないため、生成される座標リストがよりコンパクトになります。
  • 制御の柔軟性
    ポリゴンの頂点として含めたい点だけを正確に指定できます。例えば、曲線を構成する多数の点ではなく、多角形の角となる点だけを記録したい場合に適しています。

欠点

  • begin_poly() / end_poly() のような自動記録機能がないため、コード内で明示的に list.append(t.pos()) を呼び出す必要があります。

コード例

import turtle

screen = turtle.Screen()
t = turtle.Turtle()
t.speed(1)
t.penup()
t.goto(-100, 50)
t.pendown()

# ポリゴンの頂点リストを初期化
my_polygon_vertices = []

# 各頂点に移動し、座標を記録
my_polygon_vertices.append(t.pos()) # 最初の点

t.forward(150)
my_polygon_vertices.append(t.pos())

t.right(90)
t.forward(100)
my_polygon_vertices.append(t.pos())

t.right(90)
t.forward(75)
my_polygon_vertices.append(t.pos())

# 始点に戻る(ポリゴンを閉じる)
t.goto(my_polygon_vertices[0])
my_polygon_vertices.append(t.pos())

print("手動で記録されたポリゴンの頂点:")
for vertex in my_polygon_vertices:
    print(vertex)

# 取得した座標を使って塗りつぶしなどを行うことも可能
fill_turtle = turtle.Turtle()
fill_turtle.hideturtle()
fill_turtle.penup()
fill_turtle.goto(my_polygon_vertices[0])
fill_turtle.pendown()
fill_turtle.fillcolor("lightblue")
fill_turtle.begin_fill()
for x, y in my_polygon_vertices:
    fill_turtle.goto(x, y)
fill_turtle.end_fill()


turtle.done()

図形を構成する数学的な計算

もし描画する図形が正多角形や特定の幾何学的形状である場合、turtle モジュールに頼らず、直接数学的な計算によって頂点座標を求めることができます。

方法

  • math モジュール(特に math.cos(), math.sin(), math.radians() など)が役立ちます。
  • 円周上の点(正多角形の頂点)、線分の方程式など、幾何学の知識を使って座標を計算します。

利点

  • 非描画計算
    画面に描画することなく、ポリゴンデータを生成したい場合に最適です。
  • 独立性
    turtle の描画とは独立して座標を生成できるため、描画速度やタートルの動きに影響されません。
  • 正確性
    浮動小数点誤差が最小限に抑えられ、非常に正確な頂点座標が得られます。

欠点

  • タートルで描画する前に、その描画の数学的特性を理解している必要があります。
  • 複雑な図形の場合、座標計算が複雑になる可能性があります。

コード例(正五角形の頂点を計算)

import turtle
import math

screen = turtle.Screen()
screen.setup(width=600, height=600)
t = turtle.Turtle()
t.hideturtle()
t.speed(0)

# 正五角形の中心と半径
center_x, center_y = 0, 0
radius = 100
num_sides = 5

calculated_vertices = []

# 頂点を計算
# 最初の頂点の角度(上向きから開始)
start_angle = math.radians(90) # 真上が0度なら90度

for i in range(num_sides):
    angle = start_angle + i * (2 * math.pi / num_sides)
    x = center_x + radius * math.cos(angle)
    y = center_y + radius * math.sin(angle)
    calculated_vertices.append((x, y))

# ポリゴンを閉じるために最初の点を最後にも追加
calculated_vertices.append(calculated_vertices[0])

print("計算された正五角形の頂点:")
for vertex in calculated_vertices:
    print(vertex)

# 計算された頂点を使って描画
t.penup()
t.goto(calculated_vertices[0])
t.pendown()
t.fillcolor("yellow")
t.begin_fill()
for x, y in calculated_vertices:
    t.goto(x, y)
t.end_fill()

turtle.done()

CSVやJSONなどのファイルから座標を読み込む

もしポリゴンのデータが事前に決まっている(例えば、地図の境界線データなど)場合、外部ファイルに保存された座標を読み込むのが効率的です。

方法

  • Pythonの csv モジュールや json モジュールを使ってファイルを読み込み、リストとして座標データを取得します。
  • CSV(カンマ区切り値)ファイルやJSON(JavaScript Object Notation)ファイルなど、構造化された形式で座標を保存します。

利点

  • データ管理のしやすさ
    複雑なポリゴンでも、外部ツールで簡単に編集・管理できます。
  • 再利用性
    同じポリゴンデータを複数のプログラムで利用できます。
  • データの永続性
    プログラムを実行するたびにポリゴンを再定義する必要がありません。

欠点

  • 外部ファイルを用意する必要があります。
  • ファイルの読み書きのコードが必要になります。

コード例(CSVファイルから読み込み)
polygon_data.csv の内容:

x,y
-50,50
50,50
50,-50
-50,-50
-50,50

Pythonコード

import turtle
import csv

screen = turtle.Screen()
t = turtle.Turtle()
t.speed(1)
t.hideturtle()

# CSVファイルから座標を読み込む
loaded_polygon_vertices = []
try:
    with open('polygon_data.csv', 'r') as csvfile:
        reader = csv.DictReader(csvfile) # ヘッダーがあればDictReaderが便利
        for row in reader:
            x = float(row['x'])
            y = float(row['y'])
            loaded_polygon_vertices.append((x, y))
except FileNotFoundError:
    print("Error: 'polygon_data.csv' not found. Please create the file.")
    turtle.bye() # エラーで終了
    exit()

if loaded_polygon_vertices:
    print("CSVから読み込まれたポリゴンの頂点:")
    for vertex in loaded_polygon_vertices:
        print(vertex)

    # 読み込んだ頂点を使って描画
    t.penup()
    t.goto(loaded_polygon_vertices[0])
    t.pendown()
    t.fillcolor("orange")
    t.begin_fill()
    for x, y in loaded_polygon_vertices:
        t.goto(x, y)
    t.end_fill()

turtle.done()

これは turtle モジュールに直接関係するわけではありませんが、Pythonでグラフィックスを扱う他のライブラリ(例: Pillow (PIL) や matplotlib)を使用している場合、それらのライブラリが提供するAPIを通じて、描画された図形オブジェクトから頂点やパス情報を直接抽出できることがあります。

利点

  • より複雑なグラフィックス操作に対応できる。
  • ライブラリが提供する高レベルな機能を利用できる。

欠点

  • turtle のシンプルさからは離れる。
  • turtle モジュールとは異なるライブラリの学習が必要。

turtle.get_poly() はタートルの描画経路を簡単にポリゴンデータとして取得できる便利な関数ですが、その挙動が期待と異なる場合や、より柔軟な制御が必要な場合は、上記のような代替方法を検討すると良いでしょう。

  • ファイルからの読み込み
    複雑なポリゴンデータを永続化・再利用したい場合に最適。
  • 数学的な計算
    正確な幾何学的形状のポリゴンデータを描画前に生成したい場合に最適。
  • 手動で座標を記録
    最も汎用性が高く、特定の点のみをポリゴンとして扱いたい場合に最適。