Python Turtle.setpos()のよくあるエラーと解決策

2025-06-06

主な機能

描画の制御: タートルのペンがダウン（下ろされている）状態であれば、移動中に線が描画されます。ペンがアップ（上げられている）状態であれば、線は描画されずにタートルのみが移動します。
絶対座標への移動: タートルを現在の位置に関わらず、指定されたx座標とy座標の絶対位置へ移動させます。

使い方

基本的な構文は以下の通りです。

turtle.setpos(x, y)

または

turtle.setpos(vec)

y: 移動したい目的地のy座標です。
x: 移動したい目的地のx座標です。

具体例

import turtle

# 画面とタートルをセットアップ
screen = turtle.Screen()
t = turtle.Turtle()

# ペンを下ろして線を引く準備
t.pendown()

# (100, 50)へ移動しながら線を引く
t.setpos(100, 50)

# ペンを上げてから(-50, -80)へ移動（線は引かれない）
t.penup()
t.setpos(-50, -80)

# ペンを下ろして再び線を引く準備
t.pendown()

# (0, 0)へ移動しながら線を引く
t.setpos(0, 0)

# 画面をクリックで閉じる
screen.exitonclick()

機能的にはturtle.setpos()とturtle.goto()に違いはありません。どちらを使っても同じ結果が得られます。コードの可読性や個人の好みで使い分けられます。

NameError: name 'turtle' is not defined または NameError: name 't' is not defined

これは最も基本的なエラーで、turtleモジュールが正しくインポートされていないか、タートルのオブジェクトが作成されていない場合に発生します。

原因

タートルのオブジェクト（例: t = turtle.Turtle()）を作成する前にt.setpos()を呼び出している。
import turtleを忘れている。

解決策
コードの冒頭でturtleモジュールをインポートし、Turtleオブジェクトをインスタンス化していることを確認してください。

import turtle # これを忘れない

# t = turtle.Turtle() のようにタートルのオブジェクトを作成する
t = turtle.Turtle()
t.setpos(100, 100)

TypeError: setpos() missing 1 required positional argument: 'y' または TypeError: setpos() takes 2 positional arguments but 3 were given

setpos()に渡す引数の数が間違っている場合に発生します。

原因

3つ以上の引数を渡している（例: t.setpos(10, 20, 30)）。
1つの引数しか渡していない（例: t.setpos(100)）。
setpos()には通常、x座標とy座標の2つの引数が必要です。

解決策
xとyの2つの数値引数を正確に渡してください。

# OK: xとyの2つの引数
t.setpos(100, 50)

# NG: t.setpos(100) はエラー
# NG: t.setpos(10, 20, 30) もエラー

xとyをturtle.Vec2Dオブジェクトとして渡す場合は、1つの引数となりますが、その場合もVec2Dオブジェクトが正しく構成されている必要があります。

# Vec2D オブジェクトとして渡す場合
vec = turtle.Vec2D(50, -50)
t.setpos(vec) # これはOK

タートルが動かない、または予期せぬ位置に移動する

コードにエラーはないものの、タートルが思った通りに動かない場合に考えられる問題です。

原因

画面が更新されていない
- screen.tracer(0)などを使って自動更新をオフにしている場合、screen.update()を呼び出さないと描画が反映されません。
非常に速い描画速度
- t.speed(0)（最速）に設定している場合、タートルの動きが速すぎて、移動しているように見えないことがあります。
座標系の理解不足
- turtleのデフォルトの座標系では、画面の中央が(0,0)です。
- 右が正のx軸、上が正のy軸です。
- window.setworldcoordinates()などを使って座標系を変更している場合、それが原因で混乱している可能性もあります。
penup() / pendown() の状態の誤解
- penup()（ペン上げ）の状態では、setpos()で移動しても線は描画されません。タートルは「飛んで」移動します。
- pendown()（ペン下げ）の状態では、線が描画されます。

解決策

画面の更新を確認
screen.tracer(0)を使用している場合は、描画コマンドの後にscreen.update()を呼び出す必要があります。

screen = turtle.Screen()
t = turtle.Turtle()
screen.tracer(0) # 自動更新をオフ

t.setpos(100, 100)
# ... 他の描画コマンド ...

screen.update() # 変更を画面に反映

描画速度を調整
タートルの動きを確認したい場合は、t.speed(1)（最も遅い）からt.speed(6)程度の速度で試してみてください。
```
t.speed(1) # 遅い速度で動きを確認
t.setpos(100, 100)
```
座標を再確認
目的の座標が画面の範囲内にあるか、正しく計算されているかを確認してください。小さな値を試して、タートルが動くことを確認するのも良い方法です。
penup() / pendown() を確認
描画したい場合は、t.pendown()を呼び出していることを確認してください。線を引きたくない場合は、t.penup()を呼び出してください。
```
t.penup() # 線を引かずに移動
t.setpos(100, 100)
t.pendown() # ここから線を引く
t.setpos(200, 100)
```

turtle.done() や screen.exitonclick() を忘れている

これはsetpos()自体のエラーではありませんが、プログラム実行後に画面がすぐに閉じてしまい、結果を確認できないという一般的な問題です。

解決策
スクリプトの最後にturtle.done()またはscreen.exitonclick()（またはturtle.mainloop()）を追加してください。これにより、ユーザーが画面をクリックするか、手動で閉じない限り、描画ウィンドウが開いたままになります。

import turtle

t = turtle.Turtle()
t.setpos(50, 50)

screen = turtle.Screen() # Screenオブジェクトが必要
screen.exitonclick() # 画面をクリックで閉じる
# または turtle.done()

非常に稀ですが、Pythonのインストールが破損しているか、turtleモジュールが利用できない環境で実行している場合に発生します。

解決策

インストールを修復するか、再インストールすることを検討してください。
仮想環境を使用している場合は、その環境にturtleモジュールが含まれているか確認してください（通常は標準ライブラリなので含まれています）。
Pythonのインストールが正しいか確認してください。

例1: 基本的な移動と線の描画

最も基本的な使い方です。タートルを異なる座標に移動させ、その軌跡を線として描画します。

import turtle

# 1. 画面とタートルをセットアップ
screen = turtle.Screen()
t = turtle.Turtle()
t.shape("turtle") # タートルの形状を「タートル」にする
t.speed(1)        # 描画速度を遅くして動きがわかるようにする

# 2. 初期位置から線を引く
# デフォルトではタートルは画面中央 (0,0) にいます。
# ペンはデフォルトでダウンしています（線を描く状態）。
t.setpos(100, 50) # (100, 50) へ移動しながら線を引く

# 3. 一度ペンを上げてから移動（線は引かれない）
t.penup()         # ペンを上げる（移動しても線を描かない）
t.setpos(-150, -80) # (-150, -80) へ移動（線は引かれない）

# 4. 再びペンを下ろして線を描く
t.pendown()       # ペンを下ろす（移動すると線を描く）
t.setpos(0, 0)    # 原点 (0,0) へ移動しながら線を引く

# 5. プログラム終了まで画面を開いたままにする
screen.exitonclick() # 画面をクリックすると終了

解説

screen.exitonclick(): 描画結果を確認できるように、画面をクリックするまでウィンドウを開いたままにします。
t.pendown(): タートルのペンを下げます。この後のsetpos()では、再び線が描画されます。
t.penup(): タートルのペンを上げます。この後のsetpos()では、タートルは移動しますが線は描かれません。
t.setpos(100, 50): タートルを現在の位置から座標 (100,50) へ移動させます。ペンが下がっている（pendown()）ので、線が描画されます。

例2: 四角形を描く

setpos()を使って、各頂点の座標を指定して四角形を描画します。

import turtle

screen = turtle.Screen()
t = turtle.Turtle()
t.speed(3) # 描画速度を少し速く

# 四角形の頂点座標を定義
# 左下から時計回りに描く
point1 = (-100, -100)
point2 = (100, -100)
point3 = (100, 100)
point4 = (-100, 100)

# 描画を開始するために最初の点へ移動 (線は引かない)
t.penup()
t.setpos(point1)
t.pendown()

# 各頂点へ移動して線を引く
t.setpos(point2)
t.setpos(point3)
t.setpos(point4)
t.setpos(point1) # 最初の点に戻って四角形を閉じる

screen.exitonclick()

解説

最後にpoint1に戻ることで、四角形が閉じられます。
t.pendown()でペンを下げてから、定義した各pointに順にsetpos()で移動することで、四角形の辺が描画されます。
まずt.penup()でペンを上げ、最初の頂点point1へ移動します。これにより、最初の位置までの不要な線が描画されません。

例3: 星を描く（複雑なパターン）

setpos()を複数回使用して、星形のような複雑なパターンを描画します。ここでは、5点星を描いてみます。

import turtle
import math

screen = turtle.Screen()
t = turtle.Turtle()
t.speed(0) # 最速で描画
t.penup() # 線なしで初期位置へ

# 星のサイズと中心座標
star_size = 150
center_x, center_y = 0, 0

# 5点星の各頂点の計算
# 星の頂点は円周上に等間隔に配置される
# 最初の頂点は上向きにするため、角度は90度から始める
points = []
for i in range(5):
    angle_degrees = 90 + i * (360 / 5) # 5つの頂点を等間隔に配置
    angle_radians = math.radians(angle_degrees)
    x = center_x + star_size * math.cos(angle_radians)
    y = center_y + star_size * math.sin(angle_radians)
    points.append((x, y))

# 星の描画順序 (例: 0 -> 2 -> 4 -> 1 -> 3 -> 0)
# これは一般的な5点星の描画順序です
draw_order = [0, 2, 4, 1, 3, 0]

# 描画開始
t.setpos(points[draw_order[0]]) # 最初の点へ移動
t.pendown()

for i in range(1, len(draw_order)):
    t.setpos(points[draw_order[i]]) # 順に点を結んでいく

t.hideturtle() # 描画後にタートルを隠す
screen.exitonclick()

解説

t.hideturtle(): 描画が完了した後、タートルアイコンを隠して、描かれた図形がはっきり見えるようにします。
t.speed(0): 最速で描画します。
draw_orderリストは、星の辺を正しく描画するための頂点の順番を定義しています。setpos()は常に直線で2点間を結ぶため、星形を正確に描くには頂点を正しい順序で結ぶ必要があります。
mathモジュールを使用して、三角関数で星の各頂点の座標を計算しています。

turtle.Vec2Dオブジェクトを使ってsetpos()に座標を渡す例です。

import turtle

screen = turtle.Screen()
t = turtle.Turtle()
t.speed(2)

# Vec2D オブジェクトで座標を定義
position1 = turtle.Vec2D(100, 100)
position2 = turtle.Vec2D(-50, 150)
position3 = turtle.Vec2D(0, -100)

t.penup()
t.setpos(position1) # Vec2D オブジェクトで移動
t.pendown()
t.dot(5, "blue") # 点を描く

t.setpos(position2)
t.dot(5, "red")

t.setpos(position3)
t.dot(5, "green")

screen.exitonclick()

t.setpos(position1): Vec2Dオブジェクトを直接setpos()に渡すことができます。これはt.setpos(position1.x, position1.y)と同じ意味になります。
turtle.Vec2D(x, y): xとy座標を持つ2Dベクトルオブジェクトを作成します。

turtle.forward(distance) / turtle.fd(distance)

これは最も基本的な移動メソッドの一つで、タートルが現在向いている方向に指定された距離だけ前進します。

特徴

線の描画: デフォルトで線を描画します（ペンがダウンしていれば）。
相対移動: タートルの現在の向きに依存します。

使用例

import turtle

t = turtle.Turtle()
t.shape("turtle")
t.speed(1)

t.forward(100) # 現在の向きに100ピクセル前進 (デフォルトは右向き)
t.left(90)     # 左に90度回転
t.fd(50)       # 新しい向きに50ピクセル前進

turtle.done()

turtle.backward(distance) / turtle.bk(distance) / turtle.back(distance)

forward()の逆で、タートルの現在向いている方向とは反対の方向に指定された距離だけ後退します。

特徴

線の描画: デフォルトで線を描画します。
相対移動: タートルの現在の向きに依存します。

使用例

import turtle

t = turtle.Turtle()
t.speed(1)

t.forward(100)
t.backward(50) # 50ピクセル後退
t.bk(30)       # さらに30ピクセル後退

turtle.done()

turtle.setx(x) / turtle.sety(y)

これらのメソッドは、タートルのx座標またはy座標のみを変更し、もう一方の座標は現在の値を保持します。

特徴

線の描画: 線を描画します。
半絶対移動: 一方の軸のみ絶対座標で指定します。

使用例

import turtle

t = turtle.Turtle()
t.speed(1)

t.penup() # 初期位置の線を描かない
t.setpos(50, 50) # (50, 50) に移動
t.pendown()

t.setx(150) # y座標は50のまま、x座標を150にする -> (150, 50) へ移動
t.sety(100) # x座標は150のまま、y座標を100にする -> (150, 100) へ移動
t.setx(-100) # (150, 100) から (-100, 100) へ移動

turtle.done()

turtle.setheading(angle) / turtle.seth(angle)

このメソッドはタートルの向き（ヘディング）を絶対角度で設定します。タートル自体は移動しませんが、その後のforward()などの相対移動の方向が変わります。

特徴

角度の単位: デフォルトは度数法（degrees）。
向きの変更: 位置は変更せず、向きだけを変更します。

使用例

import turtle

t = turtle.Turtle()
t.speed(1)

t.forward(50)       # 右に50進む
t.setheading(90)    # 真上を向く (0度が右、90度が上)
t.forward(50)       # 真上に50進む
t.seth(180)         # 真左を向く
t.forward(50)       # 真左に50進む

turtle.done()

turtle.circle(radius, extent=None, steps=None)

円や円弧を描画するメソッドですが、タートルの位置も移動します。円周に沿って移動するような効果が得られます。

特徴

線の描画: 線を描画します。
円弧状の移動: 指定された半径と角度で円弧を描きながら移動します。

使用例

import turtle

t = turtle.Turtle()
t.speed(1)

t.circle(100)        # 半径100の円を描く
t.penup()
t.goto(-100, 0)      # 新しい開始位置へ移動 (setposでも可)
t.pendown()
t.circle(50, 180)    # 半径50の半円を描く (180度)

turtle.done()

これは主に点（ドット）を描くためのメソッドですが、タートルはその場に留まります。位置をマークする際にsetpos()と組み合わせて使われることがあります。

特徴

位置は変わらない: ドットを描くだけでタートルの位置は移動しません。
点の描画: タートルの現在の位置に点を描画します。

使用例

import turtle

t = turtle.Turtle()
t.speed(0)

# 複数の位置に点を描く
t.penup() # 線を描かない
t.setpos(50, 50)
t.dot(10, "red") # 赤い点を描く

t.setpos(-80, 20)
t.dot(15, "blue") # 青い点を描く

t.setpos(0, -100)
t.dot(20, "green") # 緑の点を描く

turtle.done()

turtle.setpos()は絶対座標への移動に最適ですが、上記のような代替メソッドは、タートルの動作をより細かく、または相対的に制御したい場合に非常に役立ちます。

円弧状の移動: circle()
向きの変更のみ: setheading()
特定の軸のみの絶対移動: setx() / sety()
現在の向きへの前進/後退: forward() / backward()
絶対位置への瞬間移動: setpos() / goto()

Pythonグラフィックプログラミング：Turtle以外の選択肢（Tkinter, Pygame他）

「タートル」（亀）と呼ばれる小さなロボットが画面上を動き回り、その軌跡に沿って線を描いていく様子を想像してください。このタートルに命令を与えることで、様々な図形や模様を描くことができます。視覚的にプログラミングの結果がすぐに確認できるため、特に子供やプログラミングの基本概念を学ぶのに適しています。

Python Turtleグラフィック完全ガイド：メソッドと関数の使い方

Pythonのturtleモジュールは、グラフィック描画を簡単に行うための機能を提供します。このモジュールには、基本的な描画オブジェクトである「タートル」を制御するための様々なメソッドや関数が用意されています。大きく分けて、タートルを制御する方法には以下の2種類があります。

Methods of TurtleScreen/Screen and corresponding functions (turtle)

turtleモジュールは、グラフィカルな描画を簡単に行うためのPythonの標準ライブラリです。カメ（タートル）が画面上を移動しながら線を描く様子をシミュレートします。このモジュールには、描画を行う「カメ」と、そのカメが活動する「画面」という2つの主要な要素があります。

Python Turtleとは？初心者向けグラフィックプログラミング入門

Pythonのturtleモジュールは、グラフィック描画を簡単に行うためのモジュールです。Logoプログラミング言語にインスパイアされており、"タートル"と呼ばれる小さなカーソルを動かすことで線や図形を描くことができます。そして、turtledemoは、このturtleモジュールの使い方を示すデモスクリプト集です。これはPythonの標準ライブラリの一部として含まれており、turtleモジュールの様々な機能や、それを使ってどのような面白いグラフィックが描けるかを示すためのたくさんのサンプルプログラムが用意されています。