24.1. turtle —龟图形¶

24.1.2.1. 龟方法¶

乌龟运动

移动和绘制

forward() | fd()

backward() | bk() | back()

right() | rt()

left() | lt()

goto() | setpos() | setposition()

setx()

sety()

setheading() | seth()

home()

circle()

dot()

stamp()

clearstamp()

clearstamps()

undo()

speed()

告诉乌龟的状态

position() | pos()

towards()

xcor()

ycor()

heading()

distance()

设置和测量

degrees()

radians()

笔控制

绘图状态

pendown() | pd() | down()

penup() | pu() | up()

pensize() | width()

pen()

isdown()

颜色控制

color()

pencolor()

fillcolor()

填充

filling()

begin_fill()

end_fill()

更多绘图控制

reset()

clear()

write()

乌龟状态

能见度

showturtle() | st()

hideturtle() | ht()

isvisible()

出现

shape()

resizemode()

shapesize() | turtlesize()

shearfactor()

settiltangle()

tiltangle()

tilt()

shapetransform()

get_shapepoly()

使用事件

onclick()

onrelease()

ondrag()

特殊龟方法

begin_poly()

end_poly()

get_poly()

clone()

getturtle() | getpen()

getscreen()

setundobuffer()

undobufferentries()

24.1.2.2. TurtleScreen/Screen的方法¶

窗口控制

bgcolor()

bgpic()

clear() | clearscreen()

reset() | resetscreen()

screensize()

setworldcoordinates()

动画控制

delay()

tracer()

update()

使用屏幕事件

listen()

onkey() | onkeyrelease()

onkeypress()

onclick() | onscreenclick()

ontimer()

mainloop() | done()

设置和特殊方法

mode()

colormode()

getcanvas()

getshapes()

register_shape() | addshape()

turtles()

window_height()

window_width()

输入法

textinput()

numinput()

筛选特异性方法

bye()

exitonclick()

setup()

title()

24.1.3.1. 乌龟运动¶

turtle.forward(distance)¶

turtle.fd(distance)¶

参数:	distance – 数字（整数或浮点）

通过指定的 distance 向乌龟朝向的方向向前移动乌龟。

>>> turtle.position()
(0.00,0.00)
>>> turtle.forward(25)
>>> turtle.position()
(25.00,0.00)
>>> turtle.forward(-75)
>>> turtle.position()
(-50.00,0.00)

turtle.back(distance)¶

turtle.bk(distance)¶

turtle.backward(distance)¶

参数:	distance – 一个号码

通过 distance 向后移动乌龟，与乌龟朝向的方向相反。不要改变乌龟的标题。

>>> turtle.position()
(0.00,0.00)
>>> turtle.backward(30)
>>> turtle.position()
(-30.00,0.00)

turtle.right(angle)¶

turtle.rt(angle)¶

参数:	angle – 数字（整数或浮点）

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

>>> turtle.heading()
22.0
>>> turtle.right(45)
>>> turtle.heading()
337.0

turtle.left(angle)¶

turtle.lt(angle)¶

参数:	angle – 数字（整数或浮点）

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

>>> turtle.heading()
22.0
>>> turtle.left(45)
>>> turtle.heading()
67.0

turtle.goto(x, y=None)¶

turtle.setpos(x, y=None)¶

turtle.setposition(x, y=None)¶

参数:	x – 数字或数字对/向量 y – 数字或 None

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

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

>>> tp = turtle.pos()
>>> tp
(0.00,0.00)
>>> turtle.setpos(60,30)
>>> turtle.pos()
(60.00,30.00)
>>> turtle.setpos((20,80))
>>> turtle.pos()
(20.00,80.00)
>>> turtle.setpos(tp)
>>> turtle.pos()
(0.00,0.00)

turtle.setx(x)¶

参数:	x – 数字（整数或浮点）

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

>>> turtle.position()
(0.00,240.00)
>>> turtle.setx(10)
>>> turtle.position()
(10.00,240.00)

turtle.sety(y)¶

参数:	y – 数字（整数或浮点）

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

>>> turtle.position()
(0.00,40.00)
>>> turtle.sety(-10)
>>> turtle.position()
(0.00,-10.00)

turtle.setheading(to_angle)¶

turtle.seth(to_angle)¶

参数:	to_angle – 数字（整数或浮点）

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

标准模式	标志模式
0 - 东	0 - 北
90 - 北	90 - 东
180 - 西	180 - 南
270 - 南	270 - 西

>>> turtle.setheading(90)
>>> turtle.heading()
90.0

turtle.home()¶

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

>>> turtle.heading()
90.0
>>> turtle.position()
(0.00,-10.00)
>>> turtle.home()
>>> turtle.position()
(0.00,0.00)
>>> turtle.heading()
0.0

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

参数:	radius – 一个号码 extent – 数字（或 None） steps – 整数（或 None）

用给定的 radius 绘制一个圆。中心是乌龟左侧的 radius 单位； extent - 一个角度 - 确定绘制圆的哪一部分。如果没有给出 extent，则绘制整个圆。如果 extent 不是一个完整的圆，圆弧的一个端点是当前笔位置。如果 radius 为正，则沿逆时针方向绘制圆弧，否则为顺时针方向。最后，龟的方向改变 extent 的量。

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

>>> turtle.home()
>>> turtle.position()
(0.00,0.00)
>>> turtle.heading()
0.0
>>> turtle.circle(50)
>>> turtle.position()
(-0.00,0.00)
>>> turtle.heading()
0.0
>>> turtle.circle(120, 180)  # draw a semicircle
>>> turtle.position()
(0.00,240.00)
>>> turtle.heading()
180.0

turtle.dot(size=None, *color)¶

参数:	size – 整数> = 1（如果给定） color – 一个颜色串或一个数字颜色元组

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

>>> turtle.home()
>>> turtle.dot()
>>> turtle.fd(50); turtle.dot(20, "blue"); turtle.fd(50)
>>> turtle.position()
(100.00,-0.00)
>>> turtle.heading()
0.0

turtle.stamp()¶

在当前的乌龟位置上将乌龟形状的副本印在画布上。返回该戳的stamp_id，可以通过调用 clearstamp(stamp_id) 来删除它。

>>> turtle.color("blue")
>>> turtle.stamp()
11
>>> turtle.fd(50)

turtle.clearstamp(stampid)¶

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

使用给定的 stampid 删除戳记。

>>> turtle.position()
(150.00,-0.00)
>>> turtle.color("blue")
>>> astamp = turtle.stamp()
>>> turtle.fd(50)
>>> turtle.position()
(200.00,-0.00)
>>> turtle.clearstamp(astamp)
>>> turtle.position()
(200.00,-0.00)

turtle.clearstamps(n=None)¶

参数:	n – 整数（或 None）

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

>>> for i in range(8):
...     turtle.stamp(); turtle.fd(30)
13
14
15
16
17
18
19
20
>>> turtle.clearstamps(2)
>>> turtle.clearstamps(-2)
>>> turtle.clearstamps()

turtle.undo()¶

撤消（重复）最后一次乌龟动作。可用撤销操作的数量由undobuffer的大小决定。

>>> for i in range(4):
...     turtle.fd(50); turtle.lt(80)
...
>>> for i in range(8):
...     turtle.undo()

turtle.speed(speed=None)¶

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

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

如果输入是大于10或小于0.5的数字，则速度设置为0.速度字符串映射到速度值如下：

• “fastest”：0

• “fast”：10

• “正常”：6

• “slow”：3

• “最慢”：1

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

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

>>> turtle.speed()
3
>>> turtle.speed('normal')
>>> turtle.speed()
6
>>> turtle.speed(9)
>>> turtle.speed()
9

24.1.3.2. 告诉乌龟的状态¶

turtle.position()¶

turtle.pos()¶

返回乌龟的当前位置（x，y）（作为 Vec2D 向量）。

>>> turtle.pos()
(440.00,-0.00)

turtle.towards(x, y=None)¶

参数:	x – 数字或数字/数字向量或龟实例 y – 如果 x 是数字，则为数字，否则为 None

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

>>> turtle.goto(10, 10)
>>> turtle.towards(0,0)
225.0

turtle.xcor()¶

返回乌龟的x坐标。

>>> turtle.home()
>>> turtle.left(50)
>>> turtle.forward(100)
>>> turtle.pos()
(64.28,76.60)
>>> print(round(turtle.xcor(), 5))
64.27876

turtle.ycor()¶

返回乌龟的y坐标。

>>> turtle.home()
>>> turtle.left(60)
>>> turtle.forward(100)
>>> print(turtle.pos())
(50.00,86.60)
>>> print(round(turtle.ycor(), 5))
86.60254

turtle.heading()¶

返回乌龟的当前航向（值取决于乌龟模式，请参阅 mode()）。

>>> turtle.home()
>>> turtle.left(67)
>>> turtle.heading()
67.0

turtle.distance(x, y=None)¶

参数:	x – 数字或数字/数字向量或龟实例 y – 如果 x 是数字，则为数字，否则为 None

返回到乌龟到（x，y），给定的向量或给定的其他乌龟的距离，以乌龟步为单位。

>>> turtle.home()
>>> turtle.distance(30,40)
50.0
>>> turtle.distance((30,40))
50.0
>>> joe = Turtle()
>>> joe.forward(77)
>>> turtle.distance(joe)
77.0

24.1.3.3. 测量设置¶

turtle.degrees(fullcircle=360.0)¶

参数:	fullcircle – 一个号码

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

>>> turtle.home()
>>> turtle.left(90)
>>> turtle.heading()
90.0

Change angle measurement unit to grad (also known as gon,
grade, or gradian and equals 1/100-th of the right angle.)
>>> turtle.degrees(400.0)
>>> turtle.heading()
100.0
>>> turtle.degrees(360)
>>> turtle.heading()
90.0

turtle.radians()¶

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

>>> turtle.home()
>>> turtle.left(90)
>>> turtle.heading()
90.0
>>> turtle.radians()
>>> turtle.heading()
1.5707963267948966

24.1.3.4. 笔控制¶

24.1.3.5. 乌龟状态¶

24.1.3.6. 使用事件¶

turtle.onclick(fun, btn=1, add=None)¶

参数:	fun – 一个带有两个参数的函数，它们将使用画布上点击的点的坐标进行调用 num – 鼠标按钮的编号，默认为1（鼠标左键） add – True 或 False - 如果 True，将添加新的绑定，否则将替换前一个绑定

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

>>> def turn(x, y):
...     left(180)
...
>>> onclick(turn)  # Now clicking into the turtle will turn it.
>>> onclick(None)  # event-binding will be removed

turtle.onrelease(fun, btn=1, add=None)¶

参数:	fun – 一个带有两个参数的函数，它们将使用画布上点击的点的坐标进行调用 num – 鼠标按钮的编号，默认为1（鼠标左键） add – True 或 False - 如果 True，将添加新的绑定，否则将替换前一个绑定

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

>>> class MyTurtle(Turtle):
...     def glow(self,x,y):
...         self.fillcolor("red")
...     def unglow(self,x,y):
...         self.fillcolor("")
...
>>> turtle = MyTurtle()
>>> turtle.onclick(turtle.glow)     # clicking on turtle turns fillcolor red,
>>> turtle.onrelease(turtle.unglow) # releasing turns it to transparent.

turtle.ondrag(fun, btn=1, add=None)¶

参数:	fun – 一个带有两个参数的函数，它们将使用画布上点击的点的坐标进行调用 num – 鼠标按钮的编号，默认为1（鼠标左键） add – True 或 False - 如果 True，将添加新的绑定，否则将替换前一个绑定

绑定 fun 到鼠标移动事件在这只乌龟。如果 fun 是 None，则删除现有绑定。

注释：在乌龟上的每个鼠标移动事件序列之前都有一个鼠标点击事件。

>>> turtle.ondrag(turtle.goto)

随后，单击并拖动乌龟会将其移动到屏幕上，从而产生手写（如果笔下降）。

24.1.3.7. 特殊龟方法¶

turtle.begin_poly()¶

开始记录多边形的顶点。当前乌龟位置是多边形的第一个顶点。

turtle.end_poly()¶

停止记录多边形的顶点。当前龟形位置是多边形的最后一个顶点。这将与第一个顶点连接。

turtle.get_poly()¶

返回最后记录的多边形。

>>> turtle.home()
>>> turtle.begin_poly()
>>> turtle.fd(100)
>>> turtle.left(20)
>>> turtle.fd(30)
>>> turtle.left(60)
>>> turtle.fd(50)
>>> turtle.end_poly()
>>> p = turtle.get_poly()
>>> register_shape("myFavouriteShape", p)

turtle.clone()¶

创建并返回具有相同位置，标题和龟属性的乌龟的克隆。

>>> mick = Turtle()
>>> joe = mick.clone()

turtle.getturtle()¶

turtle.getpen()¶

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

>>> pet = getturtle()
>>> pet.fd(50)
>>> pet
<turtle.Turtle object at 0x...>

turtle.getscreen()¶

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

>>> ts = turtle.getscreen()
>>> ts
<turtle._Screen object at 0x...>
>>> ts.bgcolor("pink")

turtle.setundobuffer(size)¶

参数:	size – 整数或 None

设置或禁用undobuffer。如果 size 是整数，则安装给定大小的空undobuffer。 size 给出了可以通过 undo() 方法/功能撤销的龟甲动作的最大数量。如果 size 是 None，则禁用undobuffer。

>>> turtle.setundobuffer(42)

turtle.undobufferentries()¶

返回undobuffer中的条目数。

>>> while undobufferentries():
...     undo()

24.1.3.8. 复合形状¶

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

1. 创建一个类型为“compound”的空Shape对象。

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

   例如：

   >>> s = Shape("compound")
   >>> poly1 = ((0,0),(10,-5),(0,10),(-10,-5))
   >>> s.addcomponent(poly1, "red", "blue")
   >>> poly2 = ((0,0),(10,-5),(-10,-5))
   >>> s.addcomponent(poly2, "blue", "red")
   

3. 现在添加形状到屏幕的shapelist并使用它：

   >>> register_shape("myshape", s)
   >>> shape("myshape")
   

24.1.4.1. 窗口控制¶

turtle.bgcolor(*args)¶

参数:	args – 颜色字符串或者在范围0..colormode中的三个数字或这样数字的3元组

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

>>> screen.bgcolor("orange")
>>> screen.bgcolor()
'orange'
>>> screen.bgcolor("#800080")
>>> screen.bgcolor()
(128.0, 0.0, 128.0)

turtle.bgpic(picname=None)¶

参数:	picname – 字符串，gif文件或 "nopic" 的名称，或 None

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

>>> screen.bgpic()
'nopic'
>>> screen.bgpic("landscape.gif")
>>> screen.bgpic()
"landscape.gif"

turtle.clear()

turtle.clearscreen()¶

从海龟屏幕中删除所有图纸和所有海龟。重置现在空乌龟屏幕到其初始状态：白色背景，没有背景图像，没有事件绑定和跟踪。

注解

此TurtleScreen方法仅作为全局函数在名称 clearscreen 下可用。全局函数 clear 是从乌龟方法 clear 导出的不同的。

turtle.reset()

turtle.resetscreen()¶

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

注解

此TurtleScreen方法仅作为全局函数在名称 resetscreen 下可用。全局函数 reset 是从乌龟方法 reset 导出的另一个。

turtle.screensize(canvwidth=None, canvheight=None, bg=None)¶

参数:	canvwidth – 正整数，画布的新宽度（以像素为单位） canvheight – 正整数，画布的新高度（以像素为单位） bg – colorstring或color-tuple，新的背景颜色

如果没有给出参数，返回current（canvaswidth，canvasheight）。 Else调整乌龟正在画的画布。不要更改绘图窗口。要观察画布的隐藏部分，请使用滚动条。使用这种方法，人们可以看到画布之前的那些部分。

>>> screen.screensize()
(400, 300)
>>> screen.screensize(2000,1500)
>>> screen.screensize()
(2000, 1500)

例如搜索一个错误逃跑的乌龟；-)

turtle.setworldcoordinates(llx, lly, urx, ury)¶

参数:	llx – 一个数字，画布左下角的x坐标 lly – 画布左下角的数字，y坐标 urx – 一个数字，画布右上角的x坐标 ury – 画布右上角的数字，y坐标

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

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

>>> screen.reset()
>>> screen.setworldcoordinates(-50,-7.5,50,7.5)
>>> for _ in range(72):
...     left(10)
...
>>> for _ in range(8):
...     left(45); fd(2)   # a regular octagon

24.1.4.2. 动画控制¶

turtle.delay(delay=None)¶

参数:	delay – 正整数

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

可选参数：

>>> screen.delay()
10
>>> screen.delay(5)
>>> screen.delay()
5

turtle.tracer(n=None, delay=None)¶

参数:	n – 非负整数 delay – 非负整数

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

>>> screen.tracer(8, 25)
>>> dist = 2
>>> for i in range(200):
...     fd(dist)
...     rt(90)
...     dist += 2

turtle.update()¶

执行TurtleScreen更新。在跟踪器关闭时使用。

参见RawTurtle/Turtle方法 speed()。

24.1.4.3. 使用屏幕事件¶

turtle.listen(xdummy=None, ydummy=None)¶

在TurtleScreen上设置焦点（以便收集关键事件）。提供了虚拟参数，以便能够将 listen() 传递给onclick方法。

turtle.onkey(fun, key)¶

turtle.onkeyrelease(fun, key)¶

参数:	fun – 一个没有参数或 None 的函数 key – 字符串：键（例如“a”）或键符号（例如“空格”）

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

>>> def f():
...     fd(50)
...     lt(60)
...
>>> screen.onkey(f, "Up")
>>> screen.listen()

turtle.onkeypress(fun, key=None)¶

参数:	fun – 一个没有参数或 None 的函数 key – 字符串：键（例如“a”）或键符号（例如“空格”）

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

>>> def f():
...     fd(50)
...
>>> screen.onkey(f, "Up")
>>> screen.listen()

turtle.onclick(fun, btn=1, add=None)

turtle.onscreenclick(fun, btn=1, add=None)¶

参数:	fun – 一个带有两个参数的函数，它们将使用画布上点击的点的坐标进行调用 num – 鼠标按钮的编号，默认为1（鼠标左键） add – True 或 False - 如果 True，将添加新的绑定，否则将替换前一个绑定

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

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

>>> screen.onclick(turtle.goto) # Subsequently clicking into the TurtleScreen will
>>>                             # make the turtle move to the clicked point.
>>> screen.onclick(None)        # remove event binding again

注解

此TurtleScreen方法仅作为全局函数在名称 onscreenclick 下可用。全局函数 onclick 是从乌龟方法 onclick 导出的另一个。

turtle.ontimer(fun, t=0)¶

参数:	fun – 一个没有参数的函数 t – 数字> = 0

安装一个在 t 毫秒后调用 fun 的定时器。

>>> running = True
>>> def f():
...     if running:
...         fd(50)
...         lt(60)
...         screen.ontimer(f, 250)
>>> f()   ### makes the turtle march around
>>> running = False

turtle.mainloop()¶

turtle.done()¶

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

>>> screen.mainloop()

24.1.4.4. 输入法¶

turtle.textinput(title, prompt)¶

参数:	title – string prompt – string

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

>>> screen.textinput("NIM", "Name of first player:")

turtle.numinput(title, prompt, default=None, minval=None, maxval=None)¶

参数:	title – string prompt – string default – number（可选） minval – number（可选） maxval – number（可选）

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

>>> screen.numinput("Poker", "Your stakes:", 1000, minval=10, maxval=10000)

24.1.4.5. 设置和特殊方法¶

turtle.mode(mode=None)¶

参数:	mode – 其中一个字符串“标准”，“标志”或“世界”

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

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

模式	初始乌龟标题	正角度
“标准”	向右（东）	逆时针
“商标”	向上（北）	顺时针

>>> mode("logo")   # resets turtle heading to north
>>> mode()
'logo'

turtle.colormode(cmode=None)¶

参数:	cmode – 值为1.0或255之一

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

>>> screen.colormode(1)
>>> turtle.pencolor(240, 160, 80)
Traceback (most recent call last):
     ...
TurtleGraphicsError: bad color sequence: (240, 160, 80)
>>> screen.colormode()
1.0
>>> screen.colormode(255)
>>> screen.colormode()
255
>>> turtle.pencolor(240,160,80)

turtle.getcanvas()¶

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

>>> cv = screen.getcanvas()
>>> cv
<turtle.ScrolledCanvas object ...>

turtle.getshapes()¶

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

>>> screen.getshapes()
['arrow', 'blank', 'circle', ..., 'turtle']

turtle.register_shape(name, shape=None)¶

turtle.addshape(name, shape=None)¶

有三种不同的方法来调用此函数：

1. name 是gif文件的名称，shape 是 None：安装相应的图像形状。

   >>> screen.register_shape("turtle.gif")
   

   注解

   图像形状 不要 在转动乌龟时旋转，因此它们不显示乌龟的标题！

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

   >>> screen.register_shape("triangle", ((5,-3), (0,5), (-5,-3)))
   

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

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

turtle.turtles()¶

返回海龟在屏幕上的列表。

>>> for turtle in screen.turtles():
...     turtle.color("red")

turtle.window_height()¶

返回乌龟窗口的高度。

>>> screen.window_height()
480

turtle.window_width()¶

返回乌龟窗口的宽度。

>>> screen.window_width()
640

24.1.4.6. 特定于Screen的方法，不是从TurtleScreen继承的¶

turtle.bye()¶

关闭turtlegraphics窗口。

turtle.exitonclick()¶

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

如果配置字典中的值“using_IDLE”是 False （默认值），也要输入mainloop。备注：如果使用带 -n 开关的IDLE（无子过程），则该值应在 turtle.cfg 中设置为 True。在这种情况下，IDLE自己的mainloop也为客户端脚本活动。

turtle.setup(width=_CFG["width"], height=_CFG["height"], startx=_CFG["leftright"], starty=_CFG["topbottom"])¶

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

参数:	width – 如果是整数，大小以像素为单位，如果是float，则为屏幕的一部分；默认为屏幕的50% height – 如果是整数，高度以像素为单位，如果为float，则为屏幕的一部分；默认为屏幕的75% startx – 如果为正，则从屏幕左边缘开始以像素为单位，如果从右边缘为负，如果 None，中心窗口水平 starty – 如果为正，则从屏幕的顶边缘开始以像素为单位的开始位置，如果从底部边缘为负，如果 None，垂直的中心窗口

>>> screen.setup (width=200, height=200, startx=0, starty=0)
>>>              # sets window to 200x200 pixels, in upper left of screen
>>> screen.setup(width=.75, height=0.5, startx=None, starty=None)
>>>              # sets window to 75% of screen by 50% of screen and centers

turtle.title(titlestring)¶

参数:	titlestring – 一个在乌龟图形窗口的标题栏中显示的字符串

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

>>> screen.title("Welcome to the turtle zoo!")

24.1.6.1. 如何使用帮助¶

Screen和Turtle类的公共方法通过docstrings广泛记录。所以这些可以作为在线帮助通过Python帮助设施：

• 当使用IDLE时，工具提示显示输入的函数/方法调用的docstrings的签名和第一行。

• 在方法或函数上调用 help() 显示docstrings:

  >>> help(Screen.bgcolor)
  Help on method bgcolor in module turtle:
  
  bgcolor(self, *args) unbound turtle.Screen method
      Set or return backgroundcolor of the TurtleScreen.
  
      Arguments (if given): a color string or three numbers
      in the range 0..colormode or a 3-tuple of such numbers.
  
  
        >>> screen.bgcolor("orange")
        >>> screen.bgcolor()
        "orange"
        >>> screen.bgcolor(0.5,0,0.5)
        >>> screen.bgcolor()
        "#800080"
  
  >>> help(Turtle.penup)
  Help on method penup in module turtle:
  
  penup(self) unbound turtle.Turtle method
      Pull the pen up -- no drawing when moving.
  
      Aliases: penup | pu | up
  
      No argument
  
      >>> turtle.penup()
  

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

  >>> help(bgcolor)
  Help on function bgcolor in module turtle:
  
  bgcolor(*args)
      Set or return backgroundcolor of the TurtleScreen.
  
      Arguments (if given): a color string or three numbers
      in the range 0..colormode or a 3-tuple of such numbers.
  
      Example::
  
        >>> bgcolor("orange")
        >>> bgcolor()
        "orange"
        >>> bgcolor(0.5,0,0.5)
        >>> bgcolor()
        "#800080"
  
  >>> help(penup)
  Help on function penup in module turtle:
  
  penup()
      Pull the pen up -- no drawing when moving.
  
      Aliases: penup | pu | up
  
      No argument
  
      Example:
      >>> penup()
  

这些修改的docstrings与在导入时从方法派生的函数定义一起自动创建。

24.1.6.2. docstrings翻译成不同的语言¶

有一个实用程序来创建一个字典，其中的键是方法名称，其值是类和屏幕和海龟的公共方法的文档字符串。

turtle.write_docstringdict(filename="turtle_docstringdict")¶

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

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

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

如果您在您的 turtle.cfg 文件中有适当的条目，此字典将在导入时读入，并将替换原始的英语docstrings。

在写这篇文章的时候，有德语和意大利语的docstring词典。 （请请 glingl@aon.at。）

24.1.6.3. 如何配置屏幕和海龟¶

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

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

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

width = 0.5
height = 0.75
leftright = None
topbottom = None
canvwidth = 400
canvheight = 300
mode = standard
colormode = 1.0
delay = 10
undobuffersize = 1000
shape = classic
pencolor = black
fillcolor = black
resizemode = noresize
visible = True
language = english
exampleturtle = turtle
examplescreen = screen
title = Python Turtle Graphics
using_IDLE = False

所选条目的简短说明：

• 前四行对应于 Screen.setup() 方法的参数。

• 第5行和第6行对应于方法 Screen.screensize() 的参数。

• shape 可以是任何内置的形状，例如：箭头，乌龟等。有关更多信息，请尝试 help(shape)。

• 如果你想使用没有fillcolor（即使龟透明），你必须编写 fillcolor = "" （但所有非空字符串不能在cfg文件中有引号）。

• 如果你想反映它的状态，你必须使用 resizemode = auto。

• 如果您设置了 language = italian 将在导入时加载docstringdict turtle_docstringdict_italian.py （如果存在于导入路径上，例如在与 turtle 相同的目录中）。

• 条目 exampleturtle 和 examplescreen 定义这些对象的名称，因为它们出现在docstrings中。方法docstrings到函数docstrings的转换将从docstrings中删除这些名称。

• using_IDLE：如果您经常使用IDLE及其-n开关（“无子过程”），请将其设置为 True。这将防止 exitonclick() 进入主环路。

在存储 turtle 的目录中可以有一个 turtle.cfg 文件，在当前工作目录中有一个附加的 turtle.cfg 文件。后者将覆盖第一个的设置。

Lib/turtledemo 目录包含 turtle.cfg 文件。你可以研究它作为一个例子，并看到它的效果，当运行演示（最好不是从演示观众）。