turtle --- 海龜繪圖?

Turtle 方法?

海龜動作

移動和繪制

forward() | fd() 前進

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

right() | rt() 右轉

left() | lt() 左轉

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

setx() 設置x坐標

sety() 設置y坐標

setheading() | seth() 設置朝向

home() 返回原點

circle() 畫圓

dot() 畫點

stamp() 印章

clearstamp() 清除印章

clearstamps() 清除多個印章

undo() 撤消

speed() 速度

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

position() | pos() 位置

towards() 目標方向

xcor() x坐標

ycor() y坐標

heading() 朝向

distance() 距離

設置與度量單位

degrees() 角度

radians() 弧度

畫筆控制

繪圖狀態(tài)

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

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

pensize() | width() 畫筆粗細

pen() 畫筆

isdown() 畫筆是否落下

顏色控制

color() 顏色

pencolor() 畫筆顏色

fillcolor() 填充顏色

填充

filling() 是否填充

begin_fill() 開始填充

end_fill() 結束填充

更多繪圖控制

reset() 重置

clear() 清空

write() 書寫

海龜狀態(tài)

可見性

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() 設置撤消緩沖區(qū)

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

TurtleScreen/Screen 方法?

窗口控制

bgcolor() 背景顏色

bgpic() 背景圖片

clearscreen()

resetscreen()

screensize() 屏幕大小

setworldcoordinates() 設置世界坐標系

動畫控制

delay() 延遲

tracer() 追蹤

update() 更新

使用屏幕事件

listen() 監(jiān)聽

onkey() | onkeyrelease() 當鍵盤按下并釋放

onkeypress() 當鍵盤按下

onclick() | onscreenclick() 當點擊屏幕

ontimer() 當達到定時

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

設置與特殊方法

mode()

colormode() 顏色模式

getcanvas() 獲取畫布

getshapes() 獲取形狀

register_shape() | addshape() 添加形狀

turtles() 所有海龜

window_height() 窗口高度

window_width() 窗口寬度

輸入方法

textinput() 文本輸入

numinput() 數(shù)字輸入

Screen 專有方法

bye() 退出

exitonclick() 當點擊時退出

setup() 設置

title() 標題

海龜動作?

turtle.forward(distance)?

turtle.fd(distance)?

參數(shù)

distance -- 一個數(shù)值 (整型或浮點型)

海龜前進 distance 指定的距離，方向為海龜?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 -- 一個數(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 -- 一個數(shù)值 (整型或浮點型)

海龜右轉 angle 個單位。(單位默認為角度，但可通過 degrees() 和 radians() 函數(shù)改變設置。) 角度的正負由海龜模式確定，參見 mode()。

>>>

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

turtle.left(angle)?

turtle.lt(angle)?

參數(shù)

angle -- 一個數(shù)值 (整型或浮點型)

海龜左轉 angle 個單位。(單位默認為角度，但可通過 degrees() 和 radians() 函數(shù)改變設置。) 角度的正負由海龜模式確定，參見 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 -- 一個數(shù)值或數(shù)值對/向量

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

如果 y 為 None，x 應為一個表示坐標的數(shù)值對或 Vec2D 類對象 (例如 pos() 返回的對象).

海龜移動到一個絕對坐標。如果畫筆已落下將會畫線。不改變海龜?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 -- 一個數(shù)值 (整型或浮點型)

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

>>>

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

turtle.sety(y)?

參數(shù)

y -- 一個數(shù)值 (整型或浮點型)

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

>>>

>>> 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 -- 一個數(shù)值 (整型或浮點型)

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

標準模式	logo 模式
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)?

參數(shù)

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

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

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

繪制一個 radius 指定半徑的圓。圓心在海龜左邊 radius 個單位；extent 為一個夾角，用來決定繪制圓的一部分。如未指定 extent*則繪制整個圓。如果 *extent 不是完整圓周，則以當前畫筆位置為一個端點繪制圓弧。如果 radius 為正值則朝逆時針方向繪制圓弧，否則朝順時針方向。最終海龜?shù)某驎罁?jù) extent 的值而改變。

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

>>>

>>> 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 -- 一個整型數(shù) >= 1 (如果指定)

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

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

參數(shù)

stampid -- 一個整型數(shù)，必須是之前 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)?

參數(shù)

n -- 一個整型數(shù) (或 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()?

撤消 (或連續(xù)撤消) 最近的一個 (或多個) 海龜動作。可撤消的次數(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 -- 一個 0..10 范圍內的整型數(shù)或速度字符串 (見下)

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

如果輸入數(shù)值大于 10 或小于 0.5 則速度設為 0。速度字符串與速度值的對應關系如下:

• "fastest": 0 最快

• "fast": 10 快

• "normal": 6 正常

• "slow": 3 慢

• "slowest": 1 最慢

速度值從 1 到 10，畫線和海龜轉向的動畫效果逐級加快。

注意: speed = 0 表示 沒有 動畫效果。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()?

返回海龜當前的坐標 (x,y) (為 Vec2D 矢量類對象)。

>>>

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

turtle.towards(x, y=None)?

參數(shù)

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

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

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

>>>

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

turtle.xcor()?

返回海龜?shù)?x 坐標。

>>>

>>> 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 坐標。

>>>

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

turtle.heading()?

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

>>>

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

turtle.distance(x, y=None)?

參數(shù)

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

• y -- 一個數(shù)值——如果 x 是一個數(shù)值，否則為 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

度量單位設置?

turtle.degrees(fullcircle=360.0)?

參數(shù)

fullcircle -- 一個數(shù)值

設置角度的度量單位，即設置一個圓周為多少 "度"。默認值為 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

畫筆控制?

海龜狀態(tài)?

使用事件?

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

參數(shù)

• fun -- 一個函數(shù)，調用時將傳入兩個參數(shù)表示在畫布上點擊的坐標。

• btn -- 鼠標按鈕編號，默認值為 1 (鼠標左鍵)

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

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

>>>

>>> 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 -- 一個函數(shù)，調用時將傳入兩個參數(shù)表示在畫布上點擊的坐標。

• btn -- 鼠標按鈕編號，默認值為 1 (鼠標左鍵)

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

將 fun 指定的函數(shù)綁定到在此海龜上釋放鼠標按鍵事件。如果 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 -- 一個函數(shù)，調用時將傳入兩個參數(shù)表示在畫布上點擊的坐標。

• btn -- 鼠標按鈕編號，默認值為 1 (鼠標左鍵)

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

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

注: 在海龜上移動鼠標事件之前應先發(fā)生在此海龜上點擊鼠標事件。

>>>

>>> turtle.ondrag(turtle.goto)

在此之后點擊并拖動海龜可在屏幕上手繪線條 (如果畫筆為落下)。

特殊海龜方法?

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

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

>>>

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

turtle.getturtle()?

turtle.getpen()?

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

>>>

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

參數(shù)

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

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

>>>

>>> turtle.setundobuffer(42)

turtle.undobufferentries()?

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

>>>

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

復合形狀?

要使用由多個不同顏色多邊形構成的復合海龜形狀，你必須明確地使用輔助類 Shape，具體步驟如下:

1. 創(chuàng)建一個空 Shape 對象，類型為 "compound"。

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

   >>>

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

窗口控制?

turtle.bgcolor(*args)?

參數(shù)

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

設置或返回 TurtleScreen 的背景顏色。

>>>

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

turtle.bgpic(picname=None)?

參數(shù)

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

設置背景圖片或返回當前背景圖片名稱。如果 picname 為一個文件名，則將相應圖片設為背景。如果 picname 為 "nopic"，則刪除當前背景圖片。如果 picname 為 None，則返回當前背景圖片文件名。:

>>>

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

turtle.clear()

備注

此 TurtleScreen 方法作為全局函數(shù)時只有一個名字 clearscreen。全局函數(shù) clear 所對應的是 Turtle 方法 clear。

turtle.clearscreen()?

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

turtle.reset()

備注

此 TurtleScreen 方法作為全局函數(shù)時只有一個名字 resetscreen。全局函數(shù) reset 所對應的是 Turtle 方法 reset。

turtle.resetscreen()?

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

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

參數(shù)

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

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

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

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

>>>

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

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

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

參數(shù)

• llx -- 一個數(shù)值, 畫布左下角的 x-坐標

• lly -- 一個數(shù)值, 畫布左下角的 y-坐標

• urx -- 一個數(shù)值, 畫面右上角的 x-坐標

• ury -- 一個數(shù)值, 畫布右上角的 y-坐標

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

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

>>>

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

動畫控制?

turtle.delay(delay=None)?

參數(shù)

delay -- 正整型數(shù)

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

可選參數(shù):

>>>

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

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

參數(shù)

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

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

啟用/禁用海龜動畫并設置刷新圖形的延遲時間。如果指定 n 值，則只有每第 n 次屏幕刷新會實際執(zhí)行。(可被用來加速復雜圖形的繪制。) 如果調用時不帶參數(shù)，則返回當前保存的 n 值。第二個參數(shù)設置延遲值 (參見 delay())。

>>>

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

turtle.update()?

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

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

使用屏幕事件?

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

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

turtle.onkey(fun, key)?

turtle.onkeyrelease(fun, key)?

參數(shù)

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

• key -- 一個字符串: 鍵 (例如 "a") 或鍵標 (例如 "space")

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

>>>

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

turtle.onkeypress(fun, key=None)?

參數(shù)

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

• key -- 一個字符串: 鍵 (例如 "a") 或鍵標 (例如 "space")

綁定 fun 指定的函數(shù)到指定鍵的按下事件。如未指定鍵則綁定到任意鍵的按下事件。注: 為了能夠注冊按鍵事件，必須得到焦點。(參見 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 -- 一個函數(shù)，調用時將傳入兩個參數(shù)表示在畫布上點擊的坐標。

• btn -- 鼠標按鈕編號，默認值為 1 (鼠標左鍵)

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

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

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

turtle.ontimer(fun, t=0)?

參數(shù)

• fun -- 一個無參數(shù)的函數(shù)

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

安裝一個計時器，在 t 毫秒后調用 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()?

開始事件循環(huán) - 調用 Tkinter 的 mainloop 函數(shù)。必須作為一個海龜繪圖程序的結束語句。如果一個腳本是在以 -n 模式 (無子進程) 啟動的 IDLE 中運行時 不可 使用 - 用于實現(xiàn)海龜繪圖的交互功能。:

>>>

>>> screen.mainloop()

輸入方法?

turtle.textinput(title, prompt)?

參數(shù)

• title -- string

• prompt -- string

彈出一個對話框窗口用來輸入一個字符串。形參 title 為對話框窗口的標題，prompt 為一條文本，通常用來提示要輸入什么信息。返回輸入的字符串。如果對話框被取消則返回 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)

設置與特殊方法?

turtle.mode(mode=None)?

參數(shù)

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

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

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

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

>>>

>>> 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 對象。供了解 Tkinter 的 Canvas 對象內部機理的人士使用。

>>>

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

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

1. name 為一個 gif 文件的文件名， shape 為 None: 安裝相應的圖像形狀。:

   >>>

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

   備注

   當海龜轉向時圖像形狀 不會 轉動，因此無法顯示海龜?shù)某?

2. name 為指定的字符串，shape 為由坐標值對構成的元組: 安裝相應的多邊形形狀。

   >>>

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

將一個海龜形狀加入 TurtleScreen 的形狀列表。只有這樣注冊過的形狀才能通過執(zhí)行 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

Screen 專有方法, 而非繼承自 TurtleScreen?

turtle.bye()?

關閉海龜繪圖窗口。

turtle.exitonclick()?

將 bye() 方法綁定到 Screen 上的鼠標點擊事件。

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

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

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

參數(shù)

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

• height -- 如為一個整型數(shù)值，表示高度為多少像素，如為一個浮點數(shù)值，則表示屏幕的占比；默認為屏幕的 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)?

參數(shù)

titlestring -- 一個字符串，顯示為海龜繪圖窗口的標題欄文本

設置海龜窗口標題為 titlestring 指定的文本。

>>>

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

如何使用幫助?

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

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

• 對文法或函數(shù)調用 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()
  

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

  >>>

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

這些修改版文檔字符串是在導入時與方法對應函數(shù)的定義一起自動生成的。

文檔字符串翻譯為不同的語言?

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

turtle.write_docstringdict(filename='turtle_docstringdict')?

參數(shù)

filename -- 一個字符串，表示文件名

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

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

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

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

如何配置 Screen 和 Turtle?

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

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

內置的配置對應以下的 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() 方法的參數(shù)。

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

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

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

• 如果你想令海龜反映其狀態(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 條目定義了相應對象在文檔字符串中顯示的名稱。方法文檔字符串轉換為函數(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 所在目錄，當前工作目錄也可以有一個同名文件。后者會重載覆蓋前者的設置。

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