turtle --- 海龜繪圖?

Turtle 方法?

海龜動(dòng)作

移動(dòng)和繪制

forward() | fd() 前進(jìn)

backward() | bk() | back() 后退

right() | rt() 右轉(zhuǎn)

left() | lt() 左轉(zhuǎn)

goto() | setpos() | setposition() 前往/定位

setx() 設(shè)置x坐標(biāo)

sety() 設(shè)置y坐標(biāo)

setheading() | seth() 設(shè)置朝向

home() 返回原點(diǎn)

circle() 畫(huà)圓

dot() 畫(huà)點(diǎn)

stamp() 印章

clearstamp() 清除印章

clearstamps() 清除多個(gè)印章

undo() 撤消

speed() 速度

獲取海龜?shù)臓顟B(tài)

position() | pos() 位置

towards() 目標(biāo)方向

xcor() x坐標(biāo)

ycor() y坐標(biāo)

heading() 朝向

distance() 距離

設(shè)置與度量單位

degrees() 角度

radians() 弧度

畫(huà)筆控制

繪圖狀態(tài)

pendown() | pd() | down() 畫(huà)筆落下

penup() | pu() | up() 畫(huà)筆抬起

pensize() | width() 畫(huà)筆粗細(xì)

pen() 畫(huà)筆

isdown() 畫(huà)筆是否落下

顏色控制

color() 顏色

pencolor() 畫(huà)筆顏色

fillcolor() 填充顏色

填充

filling() 是否填充

begin_fill() 開(kāi)始填充

end_fill() 結(jié)束填充

更多繪圖控制

reset() 重置

clear() 清空

write() 書(shū)寫(xiě)

海龜狀態(tài)

可見(jiàn)性

showturtle() | st() 顯示海龜

hideturtle() | ht() 隱藏海龜

isvisible() 是否可見(jiàn)

外觀

shape() 形狀

resizemode() 大小調(diào)整模式

shapesize() | turtlesize() 形狀大小

shearfactor() 剪切因子

settiltangle() 設(shè)置傾角

tiltangle() 傾角

tilt() 傾斜

shapetransform() 變形

get_shapepoly() 獲取形狀多邊形

使用事件

onclick() 當(dāng)鼠標(biāo)點(diǎn)擊

onrelease() 當(dāng)鼠標(biāo)釋放

ondrag() 當(dāng)鼠標(biāo)拖動(dòng)

特殊海龜方法

begin_poly() 開(kāi)始記錄多邊形

end_poly() 結(jié)束記錄多邊形

get_poly() 獲取多邊形

clone() 克隆

getturtle() | getpen() 獲取海龜畫(huà)筆

getscreen() 獲取屏幕

setundobuffer() 設(shè)置撤消緩沖區(qū)

undobufferentries() 撤消緩沖區(qū)條目數(shù)

TurtleScreen/Screen 方法?

窗口控制

bgcolor() 背景顏色

bgpic() 背景圖片

clearscreen()

resetscreen()

screensize() 屏幕大小

setworldcoordinates() 設(shè)置世界坐標(biāo)系

動(dòng)畫(huà)控制

delay() 延遲

tracer() 追蹤

update() 更新

使用屏幕事件

listen() 監(jiān)聽(tīng)

onkey() | onkeyrelease() 當(dāng)鍵盤(pán)按下并釋放

onkeypress() 當(dāng)鍵盤(pán)按下

onclick() | onscreenclick() 當(dāng)點(diǎn)擊屏幕

ontimer() 當(dāng)達(dá)到定時(shí)

mainloop() | done() 主循環(huán)

設(shè)置與特殊方法

mode()

colormode() 顏色模式

getcanvas() 獲取畫(huà)布

getshapes() 獲取形狀

register_shape() | addshape() 添加形狀

turtles() 所有海龜

window_height() 窗口高度

window_width() 窗口寬度

輸入方法

textinput() 文本輸入

numinput() 數(shù)字輸入

Screen 專(zhuān)有方法

bye() 退出

exitonclick() 當(dāng)點(diǎn)擊時(shí)退出

setup() 設(shè)置

title() 標(biāo)題

海龜動(dòng)作?

turtle.forward(distance)?

turtle.fd(distance)?

參數(shù)

distance -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

海龜前進(jìn) distance 指定的距離，方向?yàn)楹｝數(shù)某颉?/p>

>>>

>>> 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)?

參數(shù)

distance -- 一個(gè)數(shù)值

海龜后退 distance 指定的距離，方向與海龜?shù)某蛳喾?。不改變海龜?shù)某颉?/p>

>>>

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

turtle.right(angle)?

turtle.rt(angle)?

參數(shù)

angle -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

海龜右轉(zhuǎn) angle 個(gè)單位。(單位默認(rèn)為角度，但可通過(guò) degrees() 和 radians() 函數(shù)改變?cè)O(shè)置。) 角度的正負(fù)由海龜模式確定，參見(jiàn) mode()。

>>>

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

turtle.left(angle)?

turtle.lt(angle)?

參數(shù)

angle -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

海龜左轉(zhuǎn) angle 個(gè)單位。(單位默認(rèn)為角度，但可通過(guò) degrees() 和 radians() 函數(shù)改變?cè)O(shè)置。) 角度的正負(fù)由海龜模式確定，參見(jiàn) 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)?

參數(shù)

• x -- 一個(gè)數(shù)值或數(shù)值對(duì)/向量

• y -- 一個(gè)數(shù)值或 None

如果 y 為 None，x 應(yīng)為一個(gè)表示坐標(biāo)的數(shù)值對(duì)或 Vec2D 類(lèi)對(duì)象 (例如 pos() 返回的對(duì)象).

海龜移動(dòng)到一個(gè)絕對(duì)坐標(biāo)。如果畫(huà)筆已落下將會(huì)畫(huà)線。不改變海龜?shù)某颉?/p>

 >>> 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)?

參數(shù)

x -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

設(shè)置海龜?shù)臋M坐標(biāo)為 x，縱坐標(biāo)保持不變。

>>>

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

turtle.sety(y)?

參數(shù)

y -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

設(shè)置海龜?shù)目v坐標(biāo)為 y，橫坐標(biāo)保持不變。

>>>

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

turtle.setheading(to_angle)?

turtle.seth(to_angle)?

參數(shù)

to_angle -- 一個(gè)數(shù)值 (整型或浮點(diǎn)型)

設(shè)置海龜?shù)某驗(yàn)?to_angle。以下是以角度表示的幾個(gè)常用方向：

標(biāo)準(zhǔn)模式	logo 模式
0 - 東	0 - 北
90 - 北	90 - 東
180 - 西	180 - 南
270 - 南	270 - 西

>>>

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

turtle.home()?

海龜移至初始坐標(biāo) (0,0)，并設(shè)置朝向?yàn)槌跏挤较?(由海龜模式確定，參見(jiàn) 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)?

參數(shù)

• radius -- 一個(gè)數(shù)值

• extent -- 一個(gè)數(shù)值 (或 None)

• steps -- 一個(gè)整型數(shù) (或 None)

繪制一個(gè) radius 指定半徑的圓。圓心在海龜左邊 radius 個(gè)單位；extent 為一個(gè)夾角，用來(lái)決定繪制圓的一部分。如未指定 extent*則繪制整個(gè)圓。如果 *extent 不是完整圓周，則以當(dāng)前畫(huà)筆位置為一個(gè)端點(diǎn)繪制圓弧。如果 radius 為正值則朝逆時(shí)針?lè)较蚶L制圓弧，否則朝順時(shí)針?lè)较?。最終海龜?shù)某驎?huì)依據(jù) extent 的值而改變。

圓實(shí)際是以其內(nèi)切正多邊形來(lái)近似表示的，其邊的數(shù)量由 steps 指定。如果未指定邊數(shù)則會(huì)自動(dòng)確定。此方法也可用來(lái)繪制正多邊形。

>>>

>>> 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)?

參數(shù)

• size -- 一個(gè)整型數(shù) >= 1 (如果指定)

• color -- 一個(gè)顏色字符串或顏色數(shù)值元組

繪制一個(gè)直徑為 size，顏色為 color 的圓點(diǎn)。如果 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()?

在海龜當(dāng)前位置印制一個(gè)海龜形狀。返回該印章的 stamp_id，印章可以通過(guò)調(diào)用 clearstamp(stamp_id) 來(lái)刪除。

>>>

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

turtle.clearstamp(stampid)?

參數(shù)

stampid -- 一個(gè)整型數(shù)，必須是之前 stamp() 調(diào)用的返回值

刪除 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)?

參數(shù)

n -- 一個(gè)整型數(shù) (或 None)

刪除全部或前/后 n 個(gè)海龜印章。如果 n 為 None 則刪除全部印章，如果 n > 0 則刪除前 n 個(gè)印章，否則如果 n < 0 則刪除后 n 個(gè)印章。

>>>

>>> 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()?

撤消 (或連續(xù)撤消) 最近的一個(gè) (或多個(gè)) 海龜動(dòng)作。可撤消的次數(shù)由撤消緩沖區(qū)的大小決定。

>>>

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

turtle.speed(speed=None)?

參數(shù)

speed -- 一個(gè) 0..10 范圍內(nèi)的整型數(shù)或速度字符串 (見(jiàn)下)

設(shè)置海龜移動(dòng)的速度為 0..10 表示的整型數(shù)值。如未指定參數(shù)則返回當(dāng)前速度。

如果輸入數(shù)值大于 10 或小于 0.5 則速度設(shè)為 0。速度字符串與速度值的對(duì)應(yīng)關(guān)系如下:

• "fastest": 0 最快

• "fast": 10 快

• "normal": 6 正常

• "slow": 3 慢

• "slowest": 1 最慢

速度值從 1 到 10，畫(huà)線和海龜轉(zhuǎn)向的動(dòng)畫(huà)效果逐級(jí)加快。

注意: speed = 0 表示 沒(méi)有 動(dòng)畫(huà)效果。forward/back 將使海龜向前/向后跳躍，同樣的 left/right 將使海龜立即改變朝向。

>>>

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

獲取海龜?shù)臓顟B(tài)?

turtle.position()?

turtle.pos()?

返回海龜當(dāng)前的坐標(biāo) (x,y) (為 Vec2D 矢量類(lèi)對(duì)象)。

>>>

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

turtle.towards(x, y=None)?

參數(shù)

• x -- 一個(gè)數(shù)值或數(shù)值對(duì)/矢量，或一個(gè)海龜實(shí)例

• y -- 一個(gè)數(shù)值——如果 x 是一個(gè)數(shù)值，否則為 None

返回從海龜位置到由 (x,y)、矢量或另一海龜所確定位置的連線的夾角。 此數(shù)值依賴于海龜?shù)某跏汲?，這又取決于 "standard"/"world" 或 "logo" 模式設(shè)置。

>>>

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

turtle.xcor()?

返回海龜?shù)?x 坐標(biāo)。

>>>

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

turtle.ycor()?

返回海龜?shù)?y 坐標(biāo)。

>>>

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

turtle.heading()?

返回海龜當(dāng)前的朝向 (數(shù)值依賴于海龜模式參見(jiàn) mode())。

>>>

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

turtle.distance(x, y=None)?

參數(shù)

• x -- 一個(gè)數(shù)值或數(shù)值對(duì)/矢量，或一個(gè)海龜實(shí)例

• y -- 一個(gè)數(shù)值——如果 x 是一個(gè)數(shù)值，否則為 None

返回從海龜位置到由 (x,y)，適量或另一海龜對(duì)應(yīng)位置的單位距離。

>>>

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

度量單位設(shè)置?

turtle.degrees(fullcircle=360.0)?

參數(shù)

fullcircle -- 一個(gè)數(shù)值

設(shè)置角度的度量單位，即設(shè)置一個(gè)圓周為多少 "度"。默認(rèn)值為 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()?

設(shè)置角度的度量單位為弧度。其值等于 degrees(2*math.pi)。

>>>

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

畫(huà)筆控制?

海龜狀態(tài)?

使用事件?

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

參數(shù)

• fun -- 一個(gè)函數(shù)，調(diào)用時(shí)將傳入兩個(gè)參數(shù)表示在畫(huà)布上點(diǎn)擊的坐標(biāo)。

• btn -- 鼠標(biāo)按鈕編號(hào)，默認(rèn)值為 1 (鼠標(biāo)左鍵)

• add -- True 或 False -- 如為 True 則將添加一個(gè)新綁定，否則將取代先前的綁定

將 fun 指定的函數(shù)綁定到鼠標(biāo)點(diǎn)擊此海龜事件。如果 fun 值為 None，則移除現(xiàn)有的綁定。以下為使用匿名海龜即過(guò)程式的示例:

>>>

>>> 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)?

參數(shù)

• fun -- 一個(gè)函數(shù)，調(diào)用時(shí)將傳入兩個(gè)參數(shù)表示在畫(huà)布上點(diǎn)擊的坐標(biāo)。

• btn -- 鼠標(biāo)按鈕編號(hào)，默認(rèn)值為 1 (鼠標(biāo)左鍵)

• add -- True 或 False -- 如為 True 則將添加一個(gè)新綁定，否則將取代先前的綁定

將 fun 指定的函數(shù)綁定到在此海龜上釋放鼠標(biāo)按鍵事件。如果 fun 值為 None，則移除現(xiàn)有的綁定。

>>>

>>> 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)?

參數(shù)

• fun -- 一個(gè)函數(shù)，調(diào)用時(shí)將傳入兩個(gè)參數(shù)表示在畫(huà)布上點(diǎn)擊的坐標(biāo)。

• btn -- 鼠標(biāo)按鈕編號(hào)，默認(rèn)值為 1 (鼠標(biāo)左鍵)

• add -- True 或 False -- 如為 True 則將添加一個(gè)新綁定，否則將取代先前的綁定

將 fun 指定的函數(shù)綁定到在此海龜上移動(dòng)鼠標(biāo)事件。如果 fun 值為 None，則移除現(xiàn)有的綁定。

注: 在海龜上移動(dòng)鼠標(biāo)事件之前應(yīng)先發(fā)生在此海龜上點(diǎn)擊鼠標(biāo)事件。

>>>

>>> turtle.ondrag(turtle.goto)

在此之后點(diǎn)擊并拖動(dòng)海龜可在屏幕上手繪線條 (如果畫(huà)筆為落下)。

特殊海龜方法?

turtle.begin_poly()?

開(kāi)始記錄多邊形的頂點(diǎn)。當(dāng)前海龜位置為多邊形的第一個(gè)頂點(diǎn)。

turtle.end_poly()?

停止記錄多邊形的頂點(diǎn)。當(dāng)前海龜位置為多邊形的最后一個(gè)頂點(diǎn)。它將連線到第一個(gè)頂點(diǎn)。

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()?

創(chuàng)建并返回海龜?shù)目寺◇w，具有相同的位置、朝向和海龜屬性。

>>>

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

turtle.getturtle()?

turtle.getpen()?

返回海龜對(duì)象自身。唯一合理的用法: 作為一個(gè)函數(shù)來(lái)返回 "匿名海龜":

>>>

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

turtle.getscreen()?

返回作為海龜繪圖場(chǎng)所的 TurtleScreen 類(lèi)對(duì)象。該對(duì)象將可調(diào)用 TurtleScreen 方法。

>>>

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

turtle.setundobuffer(size)?

參數(shù)

size -- 一個(gè)整型數(shù)值或 None

設(shè)置或禁用撤銷(xiāo)緩沖區(qū)。 如果 size 為整數(shù)，則開(kāi)辟一個(gè)給定大小的空撤銷(xiāo)緩沖區(qū)。 size 給出了可以通過(guò) undo() 方法/函數(shù)撤銷(xiāo)海龜動(dòng)作的最大次數(shù)。 如果 size 為 None，則禁用撤銷(xiāo)緩沖區(qū)。

>>>

>>> turtle.setundobuffer(42)

turtle.undobufferentries()?

返回撤銷(xiāo)緩沖區(qū)里的條目數(shù)。

>>>

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

復(fù)合形狀?

要使用由多個(gè)不同顏色多邊形構(gòu)成的復(fù)合海龜形狀，你必須明確地使用輔助類(lèi) Shape，具體步驟如下:

1. 創(chuàng)建一個(gè)空 Shape 對(duì)象，類(lèi)型為 "compound"。

2. 按照需要使用 addcomponent() 方法向此對(duì)象添加多個(gè)部件。

   例如:

   >>>

   >>> 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. 接下來(lái)將 Shape 對(duì)象添加到 Screen 對(duì)象的形狀列表并使用它:

   >>>

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

窗口控制?

turtle.bgcolor(*args)?

參數(shù)

args -- 一個(gè)顏色字符串或三個(gè)取值范圍 0..colormode 內(nèi)的數(shù)值或一個(gè)取值范圍相同的數(shù)值3元組

設(shè)置或返回 TurtleScreen 的背景顏色。

>>>

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

turtle.bgpic(picname=None)?

參數(shù)

picname -- 一個(gè)字符串, gif-文件名, "nopic", 或 None

設(shè)置背景圖片或返回當(dāng)前背景圖片名稱。如果 picname 為一個(gè)文件名，則將相應(yīng)圖片設(shè)為背景。如果 picname 為 "nopic"，則刪除當(dāng)前背景圖片。如果 picname 為 None，則返回當(dāng)前背景圖片文件名。:

>>>

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

turtle.clear()

備注

此 TurtleScreen 方法作為全局函數(shù)時(shí)只有一個(gè)名字 clearscreen。全局函數(shù) clear 所對(duì)應(yīng)的是 Turtle 方法 clear。

turtle.clearscreen()?

從中刪除所有海龜?shù)娜坷L圖。將已清空的 TurtleScreen 重置為初始狀態(tài): 白色背景，無(wú)背景片，無(wú)事件綁定并啟用追蹤。

turtle.reset()

備注

此 TurtleScreen 方法作為全局函數(shù)時(shí)只有一個(gè)名字 resetscreen。全局函數(shù) reset 所對(duì)應(yīng)的是 Turtle 方法 reset。

turtle.resetscreen()?

重置屏幕上的所有海龜為其初始狀態(tài)。

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

參數(shù)

• canvwidth -- 正整型數(shù)，以像素表示畫(huà)布的新寬度值

• canvheight -- 正整型數(shù)，以像素表示畫(huà)面的新高度值

• bg -- 顏色字符串或顏色元組，新的背景顏色

如未指定任何參數(shù)，則返回當(dāng)前的 (canvaswidth, canvasheight)。否則改變作為海龜繪圖場(chǎng)所的畫(huà)布大小。不改變繪圖窗口。要觀察畫(huà)布的隱藏區(qū)域，可以使用滾動(dòng)條。通過(guò)此方法可以令之前繪制于畫(huà)布之外的圖形變?yōu)榭梢?jiàn)。

>>>

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

也可以用來(lái)尋找意外逃走的海龜 ;-)

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

參數(shù)

• llx -- 一個(gè)數(shù)值, 畫(huà)布左下角的 x-坐標(biāo)

• lly -- 一個(gè)數(shù)值, 畫(huà)布左下角的 y-坐標(biāo)

• urx -- 一個(gè)數(shù)值, 畫(huà)面右上角的 x-坐標(biāo)

• ury -- 一個(gè)數(shù)值, 畫(huà)布右上角的 y-坐標(biāo)

設(shè)置用戶自定義坐標(biāo)系并在必要時(shí)切換模式為 "world"。這會(huì)執(zhí)行一次 screen.reset()。如果 "world" 模式已激活，則所有圖形將根據(jù)新的坐標(biāo)系重繪。

注意: 在用戶自定義坐標(biāo)系中，角度可能顯得扭曲。

>>>

>>> 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

動(dòng)畫(huà)控制?

turtle.delay(delay=None)?

參數(shù)

delay -- 正整型數(shù)

設(shè)置或返回以毫秒數(shù)表示的延遲值 delay。(這約等于連續(xù)兩次畫(huà)布刷新的間隔時(shí)間。) 繪圖延遲越長(zhǎng)，動(dòng)畫(huà)速度越慢。

可選參數(shù):

>>>

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

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

參數(shù)

• n -- 非負(fù)整型數(shù)

• delay -- 非負(fù)整型數(shù)

啟用/禁用海龜動(dòng)畫(huà)并設(shè)置刷新圖形的延遲時(shí)間。如果指定 n 值，則只有每第 n 次屏幕刷新會(huì)實(shí)際執(zhí)行。(可被用來(lái)加速?gòu)?fù)雜圖形的繪制。) 如果調(diào)用時(shí)不帶參數(shù)，則返回當(dāng)前保存的 n 值。第二個(gè)參數(shù)設(shè)置延遲值 (參見(jiàn) delay())。

>>>

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

turtle.update()?

執(zhí)行一次 TurtleScreen 刷新。在禁用追蹤時(shí)使用。

另參見(jiàn) RawTurtle/Turtle 方法 speed()。

使用屏幕事件?

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

設(shè)置焦點(diǎn)到 TurtleScreen (以便接收按鍵事件)。使用兩個(gè) Dummy 參數(shù)以便能夠傳遞 listen() 給 onclick 方法。

turtle.onkey(fun, key)?

turtle.onkeyrelease(fun, key)?

參數(shù)

• fun -- 一個(gè)無(wú)參數(shù)的函數(shù)或 None

• key -- 一個(gè)字符串: 鍵 (例如 "a") 或鍵標(biāo) (例如 "space")

綁定 fun 指定的函數(shù)到按鍵釋放事件。如果 fun 值為 None，則移除事件綁定。注: 為了能夠注冊(cè)按鍵事件，TurtleScreen 必須得到焦點(diǎn)。(參見(jiàn) method listen() 方法。)

>>>

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

turtle.onkeypress(fun, key=None)?

參數(shù)

• fun -- 一個(gè)無(wú)參數(shù)的函數(shù)或 None

• key -- 一個(gè)字符串: 鍵 (例如 "a") 或鍵標(biāo) (例如 "space")

綁定 fun 指定的函數(shù)到指定鍵的按下事件。如未指定鍵則綁定到任意鍵的按下事件。注: 為了能夠注冊(cè)按鍵事件，必須得到焦點(diǎn)。(參見(jiàn) 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)?

參數(shù)

• fun -- 一個(gè)函數(shù)，調(diào)用時(shí)將傳入兩個(gè)參數(shù)表示在畫(huà)布上點(diǎn)擊的坐標(biāo)。

• btn -- 鼠標(biāo)按鈕編號(hào)，默認(rèn)值為 1 (鼠標(biāo)左鍵)

• add -- True 或 False -- 如為 True 則將添加一個(gè)新綁定，否則將取代先前的綁定

綁定 fun 指定的函數(shù)到鼠標(biāo)點(diǎn)擊屏幕事件。如果 fun 值為 None，則移除現(xiàn)有的綁定。

以下示例使用一個(gè) TurtleScreen 實(shí)例 screen 和一個(gè) Turtle 實(shí)例 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 方法作為全局函數(shù)時(shí)只有一個(gè)名字 onscreenclick。全局函數(shù) onclick 所對(duì)應(yīng)的是 Turtle 方法 onclick。

turtle.ontimer(fun, t=0)?

參數(shù)

• fun -- 一個(gè)無(wú)參數(shù)的函數(shù)

• t -- 一個(gè)數(shù)值 >= 0

安裝一個(gè)計(jì)時(shí)器，在 t 毫秒后調(diào)用 fun 函數(shù)。

>>>

>>> 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()?

開(kāi)始事件循環(huán) - 調(diào)用 Tkinter 的 mainloop 函數(shù)。必須作為一個(gè)海龜繪圖程序的結(jié)束語(yǔ)句。如果一個(gè)腳本是在以 -n 模式 (無(wú)子進(jìn)程) 啟動(dòng)的 IDLE 中運(yùn)行時(shí) 不可 使用 - 用于實(shí)現(xiàn)海龜繪圖的交互功能。:

>>>

>>> screen.mainloop()

輸入方法?

turtle.textinput(title, prompt)?

參數(shù)

• title -- string

• prompt -- string

彈出一個(gè)對(duì)話框窗口用來(lái)輸入一個(gè)字符串。形參 title 為對(duì)話框窗口的標(biāo)題，prompt 為一條文本，通常用來(lái)提示要輸入什么信息。返回輸入的字符串。如果對(duì)話框被取消則返回 None。:

>>>

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

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

參數(shù)

• title -- string

• prompt -- string

• default -- 數(shù)值 (可選)

• minval -- 數(shù)值 (可選)

• maxval -- 數(shù)值 (可選)

Pop up a dialog window for input of a number. title is the title of the dialog window, prompt is a text mostly describing what numerical information to input. default: default value, minval: minimum value for input, maxval: maximum value for input. The number input must be in the range minval .. maxval if these are given. If not, a hint is issued and the dialog remains open for correction. Return the number input. If the dialog is canceled, return None.

>>>

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

設(shè)置與特殊方法?

turtle.mode(mode=None)?

參數(shù)

mode -- 字符串 "standard", "logo" 或 "world" 其中之一

設(shè)置海龜模式 ("standard", "logo" 或 "world") 并執(zhí)行重置。如未指定模式則返回當(dāng)前的模式。

"standard" 模式與舊的 turtle 兼容。"logo" 模式與大部分 Logo 海龜繪圖兼容。"world" 模式使用用戶自定義的 "世界坐標(biāo)系"。注意: 在此模式下，如果 x/y 單位比率不等于 1 則角度會(huì)顯得扭曲。

模式	初始海龜朝向	正數(shù)角度
"standard"	朝右 (東)	逆時(shí)針
"logo"	朝上 (北)	順時(shí)針

>>>

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

turtle.colormode(cmode=None)?

參數(shù)

cmode -- 數(shù)值 1.0 或 255 其中之一

Return the colormode or set it to 1.0 or 255. Subsequently r, g, b values of color triples have to be in the range 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 的 Canvas 對(duì)象。供了解 Tkinter 的 Canvas 對(duì)象內(nèi)部機(jī)理的人士使用。

>>>

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

turtle.getshapes()?

返回所有當(dāng)前可用海龜形狀的列表。

>>>

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

turtle.register_shape(name, shape=None)?

turtle.addshape(name, shape=None)?

調(diào)用此函數(shù)有三種不同方式:

1. name 為一個(gè) gif 文件的文件名， shape 為 None: 安裝相應(yīng)的圖像形狀。:

   >>>

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

   備注

   當(dāng)海龜轉(zhuǎn)向時(shí)圖像形狀 不會(huì) 轉(zhuǎn)動(dòng)，因此無(wú)法顯示海龜?shù)某?

2. name 為指定的字符串，shape 為由坐標(biāo)值對(duì)構(gòu)成的元組: 安裝相應(yīng)的多邊形形狀。

   >>>

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

3. name is an arbitrary string and shape is a (compound) Shape object: Install the corresponding compound shape.

將一個(gè)海龜形狀加入 TurtleScreen 的形狀列表。只有這樣注冊(cè)過(guò)的形狀才能通過(guò)執(zhí)行 shape(shapename) 命令來(lái)使用。

turtle.turtles()?

返回屏幕上的海龜列表。

>>>

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

turtle.window_height()?

返回海龜窗口的高度。:

>>>

>>> screen.window_height()
480

turtle.window_width()?

返回海龜窗口的寬度。:

>>>

>>> screen.window_width()
640

Screen 專(zhuān)有方法, 而非繼承自 TurtleScreen?

turtle.bye()?

關(guān)閉海龜繪圖窗口。

turtle.exitonclick()?

將 bye() 方法綁定到 Screen 上的鼠標(biāo)點(diǎn)擊事件。

如果配置字典中 "using_IDLE" 的值為 False (默認(rèn)值) 則同時(shí)進(jìn)入主事件循環(huán)。注: 如果啟動(dòng) IDLE 時(shí)使用了 -n 開(kāi)關(guān) (無(wú)子進(jìn)程)，turtle.cfg 中此數(shù)值應(yīng)設(shè)為 True。在此情況下 IDLE 本身的主事件循環(huán)同樣會(huì)作用于客戶腳本。

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

設(shè)置主窗口的大小和位置。默認(rèn)參數(shù)值保存在配置字典中，可通過(guò) turtle.cfg 文件進(jìn)行修改。

參數(shù)

• width -- 如為一個(gè)整型數(shù)值，表示大小為多少像素，如為一個(gè)浮點(diǎn)數(shù)值，則表示屏幕的占比；默認(rèn)為屏幕的 50%

• height -- 如為一個(gè)整型數(shù)值，表示高度為多少像素，如為一個(gè)浮點(diǎn)數(shù)值，則表示屏幕的占比；默認(rèn)為屏幕的 75%

• startx -- 如為正值，表示初始位置距離屏幕左邊緣多少像素，負(fù)值表示距離右邊緣，None 表示窗口水平居中

• starty -- 如為正值，表示初始位置距離屏幕上邊緣多少像素，負(fù)值表示距離下邊緣，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)?

參數(shù)

titlestring -- 一個(gè)字符串，顯示為海龜繪圖窗口的標(biāo)題欄文本

設(shè)置海龜窗口標(biāo)題為 titlestring 指定的文本。

>>>

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

如何使用幫助?

Screen 和 Turtle 類(lèi)的公用方法以文檔字符串提供了詳細(xì)的文檔。因此可以利用 Python 幫助工具獲取這些在線幫助信息:

• 當(dāng)使用 IDLE 時(shí)，輸入函數(shù)/方法調(diào)用將彈出工具提示顯示其簽名和文檔字符串的頭幾行。

• 對(duì)文法或函數(shù)調(diào)用 help() 將顯示其文檔字符串:

  >>>

  >>> 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()
  

• 方法對(duì)應(yīng)函數(shù)的文檔字符串的形式會(huì)有一些修改:

  >>>

  >>> 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()
  

這些修改版文檔字符串是在導(dǎo)入時(shí)與方法對(duì)應(yīng)函數(shù)的定義一起自動(dòng)生成的。

文檔字符串翻譯為不同的語(yǔ)言?

可使用工具創(chuàng)建一個(gè)字典，鍵為方法名，值為 Screen 和 Turtle 類(lèi)公共方法的文檔字符串。

turtle.write_docstringdict(filename='turtle_docstringdict')?

參數(shù)

filename -- 一個(gè)字符串，表示文件名

創(chuàng)建文檔字符串字典并將其寫(xiě)入 filename 指定的 Python 腳本文件。此函數(shù)必須顯示地調(diào)用 (海龜繪圖類(lèi)并不使用此函數(shù))。文檔字符串字典將被寫(xiě)入到 Python 腳本文件 filename.py。該文件可作為模板用來(lái)將文檔字符串翻譯為不同語(yǔ)言。

如果你 (或你的學(xué)生) 想使用本國(guó)語(yǔ)言版本的 turtle 在線幫助，你必須翻譯文檔字符串并保存結(jié)果文件，例如 turtle_docstringdict_german.py.

如果你在 turtle.cfg 文件中加入了相應(yīng)的條目，此字典將在導(dǎo)入模塊時(shí)被讀取并替代原有的英文版文檔字符串。

在撰寫(xiě)本文檔時(shí)已經(jīng)有了德語(yǔ)和意大利語(yǔ)版的文檔字符串字典。(更多需求請(qǐng)聯(lián)系 glingl@aon.at)

如何配置 Screen 和 Turtle?

內(nèi)置的默認(rèn)配置是模仿舊 turtle 模塊的外觀和行為，以便盡可能地與其保持兼容。

如果你想使用不同的配置，以便更好地反映此模塊的特性或是更適合你的需求，例如在課堂中使用，你可以準(zhǔn)備一個(gè)配置文件 turtle.cfg，該文件將在導(dǎo)入模塊時(shí)被讀取并根據(jù)其中的設(shè)定修改模塊配置。

內(nèi)置的配置對(duì)應(yīng)以下的 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

選定條目的簡(jiǎn)短說(shuō)明:

• 開(kāi)頭的四行對(duì)應(yīng) Screen.setup() 方法的參數(shù)。

• 第 5 和 6 行對(duì)應(yīng) Screen.screensize() 方法的參數(shù)。

• shape 可以是任何內(nèi)置形狀，即: arrow, turtle 等。更多信息可用 help(shape) 查看。

• 如果你想使用無(wú)填充色 (即令海龜變透明)，你必須寫(xiě) fillcolor = "" (但 cfg 文件中所有非空字符串都不可加引號(hào))。

• 如果你想令海龜反映其狀態(tài)，你必須使用 resizemode = auto。

• If you set e.g. language = italian the docstringdict turtle_docstringdict_italian.py will be loaded at import time (if present on the import path, e.g. in the same directory as turtle).

• exampleturtle 和 examplescreen 條目定義了相應(yīng)對(duì)象在文檔字符串中顯示的名稱。方法文檔字符串轉(zhuǎn)換為函數(shù)文檔字符串時(shí)將從文檔字符串中刪去這些名稱。

• using_IDLE: Set this to True if you regularly work with IDLE and its -n switch ("no subprocess"). This will prevent exitonclick() to enter the mainloop.

turtle.cfg 文件可以保存于 turtle 所在目錄，當(dāng)前工作目錄也可以有一個(gè)同名文件。后者會(huì)重載覆蓋前者的設(shè)置。

Lib/turtledemo 目錄中也有一個(gè) turtle.cfg 文件。你可以將其作為示例進(jìn)行研究，并在運(yùn)行演示時(shí)查看其作用效果 (但最好不要在演示查看器中運(yùn)行)。