源代码： :source:`Lib/turtle.py`

海龟图形是向孩子们介绍编程的流行方式。 它是 1966 年由 Wally Feurzig 和 Seymour Papert 开发的原始 Logo 编程语言的一部分。

想象一只机器乌龟从 xy 平面的 (0, 0) 开始。 在 import turtle 之后，给它命令 turtle.forward(15)，它会在它面向的方向上移动（在屏幕上！）15 个像素，并在移动时画一条线。 给它命令 turtle.right(25)，它会原地顺时针旋转 25 度。

龟星

海龟可以使用重复简单动作的程序绘制复杂的形状。

class=align-center|../_images/turtle-star.png

通过将这些和类似的命令组合在一起，可以轻松绘制复杂的形状和图片。

turtle 模块是从 Python 标准发行版到 Python 2.5 版本的同名模块的扩展重新实现。

它试图保持旧乌龟模块的优点，并（几乎）100% c与它兼容。 这首先意味着在使用 -n 开关从 IDLE 运行中使用模块时，让学习程序员能够交互地使用所有命令、类和方法。

海龟模块以面向对象和面向过程的方式提供海龟图形基元。 因为它使用 tkinter 作为底层图形，所以它需要一个安装了 Tk 支持的 Python 版本。

面向对象的接口本质上使用两个+两个类：

TurtleScreen 类将图形窗口定义为绘图海龟的游乐场。 它的构造函数需要一个 tkinter.Canvas 或一个 ScrolledCanvas 作为参数。 当 turtle 用作某些应用程序的一部分时，应该使用它。

函数 Screen() 返回一个 TurtleScreen 子类的单例对象。 当turtle作为独立的图形工具使用时，应使用此功能。 作为单例对象，从其类继承是不可能的。

TurtleScreen/Screen 的所有方法也作为函数存在，即 作为面向过程的接口的一部分。

RawTurtle（别名：RawPen）定义了在 TurtleScreen 上绘制的 Turtle 对象。 它的构造函数需要一个 Canvas、ScrolledCanvas 或 TurtleScreen 作为参数，因此 RawTurtle 对象知道在哪里绘制。

派生自 RawTurtle 的是子类 Turtle（别名：Pen），它利用自动创建的“Screen 实例（如果尚未存在）。

RawTurtle/Turtle 的所有方法也以函数的形式存在，即 面向过程的接口的一部分。

过程接口提供从类 Screen 和 Turtle 的方法派生的函数。 它们与相应的方法具有相同的名称。 只要调用从 Screen 方法派生的函数，就会自动创建一个屏幕对象。 每当调用从 Turtle 方法派生的任何函数时，都会自动创建一个（未命名的）海龟对象。

要在屏幕上使用多个海龟，必须使用面向对象的界面。

笔记

在以下文档中，给出了函数的参数列表。 当然，方法有额外的第一个参数 self，这里省略了。

forward() | fd()

向后() | bk() | 返回()

右() | rt()

left() | lt()

goto() | setpos() | 设置位置()

setx()

sety()

setheading() | seth()

home()

circle()

dot()

stamp()

clearstamp()

clearstamps()

undo()

speed()

位置() | pos()

towards()

xcor()

ycor()

heading()

distance()

degrees()

radians()

pendown() | pd() | 向下()

penup() | pu() | 向上()

pensize() | 宽度()

pen()

isdown()

color()

pencolor()

fillcolor()

filling()

begin_fill()

end_fill()

reset()

clear()

write()

showturtle() | st()

隐藏海龟() | ht()

isvisible()

shape()

resizemode()

shapesize() | 海龟大小()

shearfactor()

settiltangle()

tiltangle()

tilt()

shapetransform()

get_shapepoly()

onclick()

onrelease()

ondrag()

begin_poly()

end_poly()

get_poly()

clone()

getturtle() | getpen()

getscreen()

setundobuffer()

undobufferentries()

bgcolor()

bgpic()

clear() | 清屏()

重置() | 重置屏幕()

screensize()

setworldcoordinates()

delay()

tracer()

update()

listen()

onkey() | onkeyrelease()

onkeypress()

onclick() | onscreenclick()

ontimer()

mainloop() | 完成()

mode()

colormode()

getcanvas()

getshapes()

register_shape() | addshape()

turtles()

window_height()

window_width()

textinput()

numinput()

bye()

exitonclick()

setup()

title()

本节中的大多数示例都引用了名为 turtle 的 Turtle 实例。

distance – 一个数字（整数或浮点数）

将海龟向前移动指定的 distance，沿海龟前进的方向。

distance – 一个数字

将海龟向后移动 distance，与海龟前进的方向相反。 不要改变乌龟的航向。

angle – 一个数字（整数或浮点数）

将海龟向右旋转 angle 个单位。 （单位默认为度，但可以通过 degrees() 和 radians() 函数设置。）角度方向取决于海龟模式，参见 mode() 。

angle – 一个数字（整数或浮点数）

将海龟向左转 angle 个单位。 （单位默认为度，但可以通过 degrees() 和 radians() 函数设置。）角度方向取决于海龟模式，参见 mode() 。

x – 一个数字或一对/数字向量

y – 一个数字或 None

如果 y 是 None，则 x 必须是一对坐标或一个 Vec2D（例如 由 pos() 返回）。

将海龟移动到绝对位置。 如果钢笔在下，画线。 不要改变乌龟的方向。

x – 一个数字（整数或浮点数）

将海龟的第一个坐标设置为 x，第二个坐标保持不变。

y – 一个数字（整数或浮点数）

将海龟的第二个坐标设置为 y，保持第一个坐标不变。

to_angle – 一个数字（整数或浮点数）

将海龟的方向设置为 to_angle。 以下是一些常见的度数方向：

标准模式

标志模式

0 - 东

0 - 北

90 - 北

90 - 东

180 - 西

180 - 南

270 - 南

270 - 西

将海龟移动到原点 - 坐标 (0,0) - 并将其航向设置为其开始方向（这取决于模式，请参阅 mode()）。

radius – 一个数字

extent – 一个数字（或 None）

steps – 一个整数（或 None）

用给定的 半径 画一个圆。 中心是乌龟左边的半径个单位； extent – 一个角度 – 决定绘制圆的哪一部分。 如果未给出 extent，则绘制整个圆。 如果 extent 不是一个完整的圆，则圆弧的一个端点是当前笔的位置。 如果 radius 为正，则以逆时针方向绘制圆弧，否则以顺时针方向绘制。 最后，海龟的方向改变了 extent 的数量。

由于圆由内接正多边形近似，因此 steps 确定要使用的步数。 如果没有给出，它将自动计算。 可用于绘制规则多边形。

size – 一个整数 >= 1（如果给定）

color – 颜色字符串或数字颜色元组

使用 color 绘制直径为 size 的圆点。 如果未给出 size，则使用 pensize+4 和 2*pensize 的最大值。

在当前海龟位置的画布上标记海龟形状的副本。 返回该图章的stamp_id，可用于通过调用clearstamp(stamp_id) 删除它。

stampid – 一个整数，必须是前一个 stamp() 调用的返回值

删除给定 stampid 的图章。

n – 一个整数（或 None）

删除所有或第一个/最后一个 n 的海龟图章。 如果 n 是None , 删除所有图章，如果 n > 0 先删除 n 邮票，否则如果 n < 0 最后删除 n 邮票。

撤消（重复）最后一个海龟动作。 可用撤消操作的数量由撤消缓冲区的大小决定。

speed – 0..10 范围内的整数或速度字符串（见下文）

将海龟的速度设置为 0..10 范围内的整数值。 如果没有给出参数，则返回当前速度。

如果输入的数字大于 10 或小于 0.5，则速度设置为 0。 Speedstrings 映射到 speedvalues 如下：

“最快”：0

“快”：10

“正常”：6

“慢”：3

“最慢”：1

从 1 到 10 的速度强制执行越来越快的线条绘制和海龟转动动画。

注意：speed = 0 表示 no 动画发生。 向前/向后使海龟跳跃，同样向左/向右使海龟立即转动。

返回海龟的当前位置 (x,y)（作为 Vec2D 向量）。

x – 一个数字或一对/数字向量或海龟实例

y – 如果 x 是数字，则为数字，否则为 None

返回从海龟位置到由 (x,y)、向量或其他海龟指定的位置之间的角度。 这取决于海龟的开始方向，这取决于模式 - “标准”/“世界”或“标志”）。

返回海龟的 x 坐标。

返回海龟的 y 坐标。

返回海龟的当前方向（值取决于海龟模式，参见 mode()）。

x – 一个数字或一对/数字向量或海龟实例

y – 如果 x 是数字，则为数字，否则为 None

以海龟步长为单位返回海龟到 (x,y)、给定向量或给定其他海龟的距离。

fullcircle – 一个数字

设置角度测量单位，即 为一个完整的圆设置“度数”。 默认值为 360 度。

将角度测量单位设置为弧度。 相当于 degrees(2*math.pi)。

turtle.pd() turtle.down()

turtle.pu() turtle.up()

width – 一个正数

将线宽设置为 width 或返回。 如果resizemode 设置为“auto”并且turtleshape 是一个多边形，则该多边形以相同的线条粗细绘制。 如果没有给出参数，则返回当前的画笔大小。

pen – 包含以下列出的部分或全部键的字典

pendict – 一个或多个关键字参数，下面列出的键作为关键字

使用以下键/值对在“笔字典”中返回或设置笔的属性：

“显示”：真/假

“pendown”：真/假

“pencolor”：颜色字符串或颜色元组

“fillcolor”：颜色字符串或颜色元组

“pensize”：正数

“速度”：0..10 范围内的数字

“resizemode”：“auto”或“user”或“noresize”

“stretchfactor”：（正数，正数）

“大纲”：正数

“倾斜”：数字

此字典可用作后续调用 pen() 以恢复以前的笔状态的参数。 此外，这些属性中的一个或多个可以作为关键字参数提供。 这可用于在一个语句中设置多个笔属性。

如果笔已按下，则返回 True，如果笔已抬起，则返回 False。

返回或设置 pencolor。

允许四种输入格式：

将当前画笔颜色作为颜色规范字符串或元组返回（参见示例）。 可用作另一个 color/pencolor/fillcolor 调用的输入。

设置pencolor为colorstring，为Tk颜色规范字符串，如"red"、"yellow"或"#33cc8c"。

将 pencolor 设置为由 r、g 和 b 的元组表示的 RGB 颜色。 r、g 和 b 中的每一个都必须在 0..colormode 范围内，其中 colormode 为 1.0 或 255（请参阅 colormode( ))。

将 pencolor 设置为由 r、g 和 b 表示的 RGB 颜色。 r、g 和 b 中的每一个都必须在 0..colormode 范围内。

如果turtleshape 是多边形，则使用新设置的pencolor 绘制该多边形的轮廓。

返回或设置填充颜色。

允许四种输入格式：

将当前填充颜色作为颜色规范字符串返回，可能采用元组格式（参见示例）。 可用作另一个 color/pencolor/fillcolor 调用的输入。

设置fillcolor为colorstring，为Tk颜色规范字符串，如"red"、"yellow"或"#33cc8c"。

将 fillcolor 设置为由 r、g 和 b 的元组表示的 RGB 颜色。 r、g 和 b 中的每一个都必须在 0..colormode 范围内，其中 colormode 为 1.0 或 255（请参阅 colormode( ))。

将 fillcolor 设置为由 r、g 和 b 表示的 RGB 颜色。 r、g 和 b 中的每一个都必须在 0..colormode 范围内。

如果turtleshape 是多边形，则使用新设置的fillcolor 绘制该多边形的内部。

返回或设置 pencolor 和 fillcolor。

允许使用多种输入格式。 它们使用 0 到 3 个参数，如下所示：

将当前画笔颜色和当前填充颜色作为一对颜色规范字符串或元组返回，如 pencolor() 和 fillcolor() 返回。

pencolor() 中的输入，将 fillcolor 和 pencolor 都设置为给定值。

等效于 pencolor(colorstring1) 和 fillcolor(colorstring2)，如果使用其他输入格式，则类似。

如果turtleshape 是多边形，则使用新设置的颜色绘制该多边形的轮廓和内部。

另请参阅：屏幕方法 colormode()。

返回填充状态（True 如果填充，False 否则）。

填充最后一次调用 begin_fill() 后绘制的形状。

从屏幕上删除海龟的绘图，重新居中海龟并将变量设置为默认值。

arg – 要写入 TurtleScreen 的对象

move – 真/假

align – “左”、“中”或“右”字符串之一

font – 三元组（字体名称、字体大小、字体类型）

写入文本 - arg 的字符串表示 - 根据 align（“左”，“中”或“右”）和给定的字体在当前海龟位置。 如果 move 为真，笔将移动到文本的右下角。 默认情况下，move 是 False。

使乌龟隐形。 在您正在进行一些复杂的绘图时这样做是个好主意，因为隐藏海龟可以明显加快绘图速度。

使乌龟可见。

如果显示海龟，则返回 True，如果隐藏则返回 False。

name – 一个字符串，它是一个有效的 shapename

将海龟形状设置为具有给定 name 的形状，或者，如果未给出名称，则返回当前形状的名称。 带有 name 的形状必须存在于 TurtleScreen 的形状字典中。 最初有以下多边形形状：“箭头”、“乌龟”、“圆形”、“正方形”、“三角形”、“经典”。 要了解如何处理形状，请参阅 Screen 方法 register_shape()。

rmode – 字符串“auto”、“user”、“noresize”之一

将 resizemode 设置为以下值之一：“auto”、“user”、“noresize”。 如果未给出 rmode，则返回当前调整大小模式。 不同的resizemode有以下效果：

“auto”：根据 pensize 的值调整海龟的外观。

“user”：根据由shapesize()设置的stretchfactor和outlinewidth（outline）的值来适配海龟的外观。

“noresize”：不适应海龟的外观。

当与参数一起使用时，resizemode(“user”) 由 shapesize() 调用。

stretch_wid – 正数

stretch_len – 正数

outline – 正数

返回或设置笔的属性 x/y-stretchfactors 和/或轮廓。 将调整大小模式设置为“用户”。 当且仅当 resizemode 设置为“user”时，海龟将根据其拉伸因子显示拉伸：stretch_wid 是垂直于其方向的拉伸因子，stretch_len 是其方向的拉伸因子方向，outline 确定形状轮廓的宽度。

shear – 数字（可选）

设置或返回当前的剪切因子。 根据给定的剪切因子剪切剪切海龟形状，剪切角的切线。 做 不 改变海龟的航向（移动方向）。 如果没有给出剪切：返回当前的剪切因子，i。 e. 剪切角的切线，平行于海龟航向的线被剪切。

angle – 一个数字

将海龟从当前倾斜角度旋转 angle，但不要 不 改变海龟的航向（移动方向）。

angle – 一个数字

旋转海龟形状以指向 angle 指定的方向，而不管其当前的倾斜角度。 不要改变海龟的航向（移动方向）。

自 3.1 版起已弃用。

angle – 一个数字（可选）

设置或返回当前的倾斜角度。 如果给出角度，则旋转海龟形状以指向角度指定的方向，而不管其当前的倾斜角度。 做 不 改变海龟的航向（移动方向）。 如果没有给出角度：返回当前的倾斜角度，i。 e. 海龟形状的方向和海龟的方向（它的运动方向）之间的角度。

t11 – 一个数字（可选）

t12 – 一个数字（可选）

t21 – 一个数字（可选）

t12 – 一个数字（可选）

设置或返回海龟形状的当前变换矩阵。

如果没有给出任何矩阵元素，则以 4 个元素的元组形式返回变换矩阵。 否则，设置给定的元素并根据由第一行 t11, t12 和第二行 t21, 22 组成的矩阵转换海龟形状。 行列式 t11 * t22 - t12 * t21 不能为零，否则会引发错误。 根据给定的矩阵修改拉伸因子、剪切因子和倾斜角。

将当前形状多边形作为坐标对的元组返回。 这可用于定义新形状或复合形状的组件。

fun – 一个带有两个参数的函数，将使用画布上点击点的坐标调用

btn – 鼠标按钮编号，默认为 1（鼠标左键）

add – True 或 False – 如果是 True，将添加新绑定，否则将替换之前的绑定

将 fun 绑定到此海龟的鼠标点击事件。 如果 fun 是 None，则删除现有绑定。 匿名海龟的例子，即 程序方式：

fun – 一个带有两个参数的函数，将使用画布上点击点的坐标调用

btn – 鼠标按钮编号，默认为 1（鼠标左键）

add – True 或 False – 如果是 True，将添加新绑定，否则将替换之前的绑定

将 fun 绑定到此海龟上的鼠标按钮释放事件。 如果 fun 是 None，则删除现有绑定。

fun – 一个带有两个参数的函数，将使用画布上点击点的坐标调用

btn – 鼠标按钮编号，默认为 1（鼠标左键）

add – True 或 False – 如果是 True，将添加新绑定，否则将替换之前的绑定

将 fun 绑定到此海龟上的鼠标移动事件。 如果 fun 是 None，则删除现有绑定。

备注：海龟上的每个鼠标移动事件序列都在该海龟上发生鼠标点击事件之前。

随后，单击并拖动 Turtle 将在屏幕上移动它，从而产生手绘（如果笔已放下）。

返回最后记录的多边形。

创建并返回具有相同位置、方向和海龟属性的海龟的克隆。

返回 Turtle 对象本身。 仅合理使用：作为返回“匿名海龟”的函数：

返回海龟正在绘制的 TurtleScreen 对象。 然后可以为该对象调用 TurtleScreen 方法。

size – 一个整数或 None

设置或禁用撤销缓冲区。 如果 size 是一个整数，则安装给定大小的空撤销缓冲区。 size 给出了 undo() 方法/函数可以撤消的海龟动作的最大数量。 如果 size 为 None，则禁用 undobuffer。

返回撤消缓冲区中的条目数。

要使用由多个不同颜色的多边形组成的复合海龟形状，您必须明确使用辅助类 Shape，如下所述：

创建一个“复合”类型的空 Shape 对象。

使用 addcomponent() 方法根据需要向该对象添加任意数量的组件。

例如：

现在将 Shape 添加到 Screen 的 shapelist 并使用它：

笔记

Shape 类由 register_shape() 方法以不同方式在内部使用。 当使用如上所示的复合形状时，应用程序员必须处理 Shape 类 only！

本节中的大多数示例都引用了一个名为 screen 的 TurtleScreen 实例。

args – 一个颜色字符串或三个 0..colormode 范围内的数字或此类数字的 3 元组

设置或返回 TurtleScreen 的背景颜色。

picname – 一个字符串、gif 文件的名称或 "nopic" 或 None

设置背景图片或返回当前背景图片的名称。 如果 picname 是文件名，则将相应的图像设置为背景。 如果 picname 是 "nopic"，请删除背景图像（如果存在）。 如果 picname 是 None，则返回当前背景图片的文件名。

从 TurtleScreen 中删除所有绘图和所有海龟。 将现在为空的 TurtleScreen 重置为其初始状态：白色背景、无背景图像、无事件绑定和跟踪。

笔记

此 TurtleScreen 方法仅在名称 clearscreen 下可用作全局函数。 全局函数 clear 是从 Turtle 方法 clear 派生的一个不同的函数。

将屏幕上的所有海龟重置为其初始状态。

笔记

此 TurtleScreen 方法仅在名称 resetscreen 下可用作全局函数。 全局函数 reset 是另一个衍生自 Turtle 方法 reset 的函数。

canvwidth – 正整数，画布的新宽度（以像素为单位）

canvheight – 正整数，画布的新高度（以像素为单位）

bg – 颜色字符串或颜色元组，新的背景颜色

如果没有给出参数，则返回当前（画布宽度，画布高度）。 否则调整海龟正在绘制的画布的大小。 不要改变绘图窗口。 要观察画布的隐藏部分，请使用滚动条。 使用这种方法，可以使之前画布之外的绘图部分可见。

例如 寻找一只错误逃脱的乌龟 ;-)

llx – 一个数字，画布左下角的 x 坐标

lly – 一个数字，画布左下角的 y 坐标

urx – 一个数字，画布右上角的 x 坐标

ury – 数字，画布右上角的 y 坐标

设置用户定义的坐标系，必要时切换到“世界”模式。 这将执行 screen.reset()。 如果“世界”模式已激活，则所有图形都将根据新坐标重新绘制。

注意：在用户定义的坐标系中，角度可能会出现扭曲。

delay – 正整数

以毫秒为单位设置或返回绘图 delay。 （这大约是两次连续画布更新之间的时间间隔。）绘制延迟越长，动画越慢。

可选参数：

n – 非负整数

delay – 非负整数

打开/关闭海龟动画并设置更新图纸的延迟。 如果给出 n，则仅真正执行第 n 次常规屏幕更新。 （可用于加速复杂图形的绘制。）不带参数调用时，返回当前存储的 n 值。 第二个参数设置延迟值（参见 delay()）。

另请参阅 RawTurtle/Turtle 方法 speed()。

fun – 没有参数的函数或 None

key – 一个字符串：key（例如 “a”）或键符号（例如 “空间”）

将 fun 绑定到按键的按键释放事件。 如果 fun 是 None，则删除事件绑定。 备注：为了能够注册按键事件，TurtleScreen 必须有焦点。 （参见方法 listen()。）

fun – 没有参数的函数或 None

key – 一个字符串：key（例如 “a”）或键符号（例如 “空间”）

如果给定了键，则将 fun 绑定到键的按键事件，如果没有给定键，则绑定到任何按键事件。 备注：为了能够注册按键事件，TurtleScreen 必须有焦点。 （参见方法 listen()。）

fun – 一个带有两个参数的函数，将使用画布上点击点的坐标调用

btn – 鼠标按钮编号，默认为 1（鼠标左键）

add – True 或 False – 如果是 True，将添加新绑定，否则将替换之前的绑定

将 fun 绑定到此屏幕上的鼠标单击事件。 如果 fun 是 None，则删除现有绑定。

名为 screen 的 TurtleScreen 实例和名为 turtle 的 Turtle 实例的示例：

笔记

此 TurtleScreen 方法仅在名称 onscreenclick 下可用作全局函数。 全局函数 onclick 是另一个衍生自 Turtle 方法 onclick 的函数。

fun – 一个没有参数的函数

t – 一个数字 >= 0

安装一个计时器，在 t 毫秒后调用 fun。

启动事件循环 - 调用 Tkinter 的 mainloop 函数。 必须是海龟图形程序中的最后一条语句。 如果脚本在 IDLE 中以 -n 模式（无子进程）运行，则必须使用 not - 用于海龟图形的交互使用。

title – 字符串

prompt – 字符串

弹出一个用于输入字符串的对话窗口。 参数title是对话窗口的标题，prompt是主要描述输入什么信息的文字。 返回字符串输入。 如果对话框被取消，返回None。

title – 字符串

prompt – 字符串

default – 数字（可选）

minval – 数字（可选）

maxval – 数量（可选）

弹出一个输入数字的对话窗口。 title 是对话窗口的标题，prompt 是一段文字，主要描述输入什么数字信息。 默认值：默认值，minval：输入的最小值，maxval：输入的最大值输入的数字必须在 minval .. 如果给出这些，则为 maxval。 如果不是，则会发出提示并且对话框保持打开状态以进行更正。 返回数字输入。 如果对话框被取消，返回None。

mode – 字符串“standard”、“logo”或“world”之一

设置海龟模式（“标准”、“标志”或“世界”）并执行重置。 如果没有给出模式，则返回当前模式。

模式“标准”与旧的 turtle 兼容。 模式“logo”与大多数 Logo 海龟图形兼容。 “世界”模式使用用户定义的“世界坐标”。 注意：在此模式下，如果x/y单位比不等于1，角度会出现扭曲。

模式

初始海龟航向

正角

“标准”

向右（东）

逆时针

“标识”

向上（北）

顺时针

cmode – 值 1.0 或 255 之一

返回颜色模式或将其设置为 1.0 或 255。 随后颜色三元组的 r、g、b 值必须在 0..cmode 范围内。

返回此 TurtleScreen 的 Canvas。 对于知道如何使用 Tkinter Canvas 的内部人员很有用。

返回所有当前可用海龟形状的名称列表。

可以通过三种不同的方式调用此函数：

name为gif文件名，shape为None：安装对应的图片形状。

笔记

转动海龟时图像形状不旋转，因此它们不显示海龟的航向！

name 是任意字符串，shape 是坐标对的元组：安装相应的多边形形状。

name 是任意字符串，shape 是（复合） Shape 对象：安装对应的复合形状。

将海龟形状添加到 TurtleScreen 的形状列表。 通过发出命令shape(shapename)，只能使用这样注册的形状。

返回屏幕上的海龟列表。

返回海龟窗口的高度。

返回海龟窗口的宽度。

将 bye() 方法绑定到屏幕上的鼠标点击。

如果配置字典中“using_IDLE”的值为False（默认值），同样进入mainloop。 备注：如果使用带有-n开关（无子进程）的IDLE，则该值应设置为turtle.cfg中的True。 在这种情况下，IDLE 自己的主循环对于客户端脚本也处于活动状态。

设置主窗口的大小和位置。 参数的默认值存储在配置字典中，可以通过 turtle.cfg 文件进行更改。

width - 如果是整数，则以像素为单位的大小，如果是浮点数，则为屏幕的一部分； 默认为 50% of 屏幕

height - 如果是整数，则以像素为单位的高度，如果是浮点数，则为屏幕的一小部分； 默认为 75% of 屏幕

startx - 如果为正，从屏幕左边缘开始的像素位置，如果从右边缘为负，如果 None，水平居中窗口

starty - 如果为正，从屏幕顶部边缘开始的像素位置，如果从底部边缘为负，如果 None，垂直居中窗口

titlestring – 显示在海龟图形窗口标题栏中的字符串

将海龟窗口的标题设置为 titlestring。

canvas – tkinter.Canvas、ScrolledCanvas 或 TurtleScreen

创建一只乌龟。 海龟具有上述所有方法，称为“海龟/RawTurtle 的方法”。

cv – tkinter.Canvas

提供面向屏幕的方法，如 setbg() 等。 上面描述的。

master – 一些包含 ScrolledCanvas 的 Tkinter 小部件，即 添加了滚动条的 Tkinter-canvas

由类 Screen 使用，因此它会自动提供一个 ScrolledCanvas 作为海龟的游乐场。

type_ – 字符串“polygon”、“image”、“compound”之一

数据结构建模形状。 对 (type_, data) 必须遵循以下规范：

类型_

数据

“多边形”

一个多边形元组，即 一组坐标对

“图片”

一张图片（这种形式只在内部使用！）

“化合物”

None（必须使用 addcomponent() 方法构建复合形状）

poly – 一个多边形，即 一对数字的元组

fill – poly 将填充的颜色

outline – 多边形轮廓的颜色（如果给定）

例子：

请参阅 复合形状 。

一个二维向量类，用作实现海龟图形的辅助类。 也可能对海龟图形程序有用。 派生自元组，所以向量是元组！

提供（对于 a、b 向量、k 编号）：

a + b 矢量加法

a - b 矢量减法

a * b 内积

k * a 和 a * k 与标量的乘法

abs(a) a 的绝对值

a.rotate(angle) 旋转

Screen 和 Turtle 类的公共方法通过文档字符串进行了大量记录。 所以这些可以通过 Python 帮助工具用作在线帮助：

使用 IDLE 时，工具提示会显示函数/方法调用中键入的文档字符串的签名和第一行。

在方法或函数上调用 help() 会显示文档字符串：

从方法派生的函数的文档字符串具有修改后的形式：

这些修改后的文档字符串与导入时从方法派生的函数定义一起自动创建。

有一个实用程序可以创建一个字典，其键是方法名称，其值是 Screen 和 Turtle 类的公共方法的文档字符串。

filename – 一个字符串，用作文件名

使用给定的文件名创建 docstring-dictionary 并将其写入 Python 脚本。 必须显式调用此函数（海龟图形类不使用它）。 文档字符串字典将写入 Python 脚本 filename.py。 它旨在用作将文档字符串翻译成不同语言的模板。

如果您（或您的学生）想在您的母语中使用 turtle 在线帮助，您必须翻译文档字符串并将生成的文件保存为例如 turtle_docstringdict_german.py。

如果您的 turtle.cfg 文件中有适当的条目，该词典将在导入时被读入并替换原始英文文档字符串。

在撰写本文时，有德语和意大利语的文档字符串词典。 （请求请发送至 [email protected]。）

内置的默认配置模仿旧海龟模块的外观和行为，以保持与它的最佳兼容性。

如果您想使用不同的配置来更好地反映此模块的功能或更适合您的需求，例如 在教室中使用时，您可以准备一个配置文件turtle.cfg，导入时会读取该配置文件，并根据其设置修改配置。

内置配置将对应于以下turtle.cfg：

所选条目的简短说明：

在turtle所在的目录下可以有一个turtle.cfg文件，在当前工作目录下还有一个。 后者将覆盖第一个的设置。

Lib/turtledemo 目录包含一个 turtle.cfg 文件。 您可以将其作为示例进行研究，并在运行演示时查看其效果（最好不在演示查看器中）。

turtledemo 包包含一组演示脚本。 可以使用提供的演示查看器运行和查看这些脚本，如下所示：

或者，您可以单独运行演示脚本。 例如，

turtledemo 包目录包含：

演示脚本是：

玩得开心！