python之繪製圖形庫turtle

關於繪製圖形庫turtle
# 畫布上，默認有一個座標原點爲畫布中心的座標軸(0,0)，默認"standard"模式座標原點上有一隻面朝x軸正方向小烏龜

一：海龜箭頭Turtle相關方法
#############################
#       1.繪製的運動        #
#############################
a).移動和繪製
# turtle.forward(distance) | turtle.fd(distance)
# 畫筆向繪製方向的當前方向移動distance(integer or float)的pixels距離，
# 例如：

　turtle.fd(150)

# turtle.backward(distance) | turtle.back(distance) | turtle.bk(distance)
# 畫筆向繪製方向的相反方向移動distance(integer or float)的pixels距離
# 例如：

 turtle.backward(200)

# turtle.right(angle) | turtle.rt(angle)
# 繪製方向向右旋轉angle度
# 例如：

turtle.rt(45)

# turtle.left(angle) | turtle.lt(angle)
# 繪製方向向左旋轉angle度
# 例如：

turtle.lt(45)

# turtle.setpos(x, y=None) | turtle.setposition(x, y=None) | turtle.goto(x, y=None)
# 移動到絕對位置,若是畫筆按下,就畫線
# 參數x(a number or a pair/vector of numbers)
# 參數y(a number or None)
# 若是y爲None,x必須是a pair of coordinates or a Vec2D
# 例如：

turtle.setpos((20,80)) 
turtle.setposition(120,20) 
turtle.goto(60,30)

# turtle.setx(x)
# y縱向座標不變，更改x橫向座標,x(integer or float)
# 例如：

turtle.setx(15)

# turtle.sety(y)
# x橫向座標不變，更改y縱向座標,y(integer or float)
# 例如：

turtle.sety(15)

# turtle.seth(to_angle) | turtle.setheading(to_angle)
# 將方向設置成to_angle.to_angle(integer or float)to_angle的值在不一樣模式下含義以下
"standard"模式逆時針       "logo"模式順時針
    0 - east                0 - north
    90 - north              90 - east
    180 - west              180 - south
    270 - south             270 - west
以下圖「standard」模式時(默認0時表示x方向向右即向東);「logo」模式時(默認0時表示y方向向上即向北)
                    y「logo」時
　　　　　　　　　　　　^
                    |
                    |
                    |
                (0,0)——————> x「standard」時
# 例如：

# 「standard」模式時角度爲逆時針,因此90度表示向北;logo」模式時角度爲順時針,因此90度表示向東
turtle.setheading(90)

# turtle.home()
# 將位置和方向恢復到初始狀態,位置初始座標爲（0,0）,方向初始爲("standard"模式爲right向右即東,"logo"模式是up向上即北)
# 例如：

turtle.home()

# turtle.circle(radius, extent=None, steps=None)
# 按給定的半徑畫圓，當前位置爲圓的初始端點
    Parameters:
        radius(a number,圓半徑,爲正數則逆時針畫,爲負數則順時針畫,方向隨着軌跡的變化而變化)
        extent(a number or None,一個角度,決定哪部分圓圈被繪製,不提供extent表示畫完整的圓)
        steps(an integer or None,指定半徑radius前提下,完成extent的角度時,分了幾步,如畫正5邊形時turtle.circle(40, None, 5))
# 例如：

        turtle.home()
        # 當前位置(0,0)開始逆時針畫半徑爲30的圓
        turtle.circle(30)
        # 逆時針畫半徑爲50的半圓
        turtle.circle(50, 180)
        # 方向值爲180,「standard」模式時方向向左,「logo」模式方向向下
        print(turtle.heading())
        turtle.circle(-50, 180)
        print(turtle.heading())
        # 逆時針方向半徑爲40畫五邊形(5步畫接近整圓的圖形)
        turtle.circle(40, None, 5)    

# turtle.dot(size=None, *color)
# 按給定直徑size畫圓點(None[未提供時取pensize+4 和 2*pensize中的最大值] 或 >= 1的整數),color圓點顏色
# 例如：

        turtle.home()
        # 當前畫筆大小爲1
        print(turtle.pensize())
        # 未提供取最大直徑值爲pensize+4 = 5
        turtle.dot()
        turtle.fd(50)
        # 以直徑爲5畫藍色圓點
        turtle.dot(5, "blue")
        turtle.fd(50)
        # 以直徑爲20畫紅色圓點
        turtle.dot(20, "red")
        turtle.fd(50)
        print(turtle.position())
        print(turtle.heading())

# turtle.stamp()和turtle.clearstamp(stamp_id)和turtle.clearstamps(n=None)
# turtle.stamp()是在當前位置拷貝一份此時箭頭的形狀,返回一個stamp_id(int型),
# turtle.clearstamp(stamp_id)用來刪除指定stamp_id的箭頭形狀
# turtle.clearstamps(n=None),n爲None時表示刪除全部拷貝的箭頭形狀;爲0不刪除;n > 0 表示刪除前n個,n < 0 表示刪除後n個
# 例如：

        # 畫筆顏色設成紅色
        turtle.color("red")
        num = 0
        while num < 5:
            # 當前位置拷貝一份箭頭形狀
            stamp_id = turtle.stamp()
            turtle.fd(50)
            num += 1
        # 改變畫筆顏色爲黑
        turtle.color("black")
        # 刪除拷貝的箭頭形狀(此處id最後一次複製的stamp_id)
        turtle.clearstamp(stamp_id)
        # 刪除前1個
        turtle.clearstamps(1)
        # 刪除後1個
        turtle.clearstamps(-1)
        # 所有刪除
        turtle.clearstamps()
        # 不刪除
        # turtle.clearstamps(0)

# turtle.undo()
# (每調用一次就)撤銷最後的一次動做,須要撤銷全部可經過while turtle.undobufferentries(),turtle.undobufferentries()返回當前可撤銷次數
# 例如：

        # 一直撤銷最後一個動做直到不可撤銷
        while turtle.undobufferentries():
            # 撤銷最後的一次動做
            turtle.undo()

# turtle.speed(speed=None)
    Parameters:
        peed爲0-10的整數(1-10愈來愈快,0表示最快,參數爲小數會被自動置爲整數)或以下內置的速度字符串,若是>10或小於0.5則被置爲0;爲>=0.5的小數時被置爲四捨五入的值。speed未設置則返回當前速度
# 內置的速度字符串：
    「fastest」: 0
    「fast」: 10
    「normal」: 6
    「slow」: 3
    「slowest」: 1
# 例如：

        # 速度爲0,表示速度最快
        turtle.speed(0)
        # <0.5速度會被置爲0,表示速度最快
        turtle.speed(0.4)
        # >10速度會被置爲0,表示速度最快
        turtle.speed(20)
        # 速度字符串fastest,表示速度最快
        turtle.speed("fastest")
        # 速度最慢
        turtle.speed("slowest")
        # 速度爲9
        turtle.speed(9)

b).獲取(海龜)箭頭的狀態
# position() | pos()
# 返回(海龜)箭頭當前位置座標
# 例如：

        turtle.pos()

# turtle.towards(x, y=None)
# 返回(海龜)箭頭當前位置指向(x,y)位置連線的向量的角度(取決於當前模式,「standard」/」world」默認方向向右(即東)逆時針開始;「logo」模式默認方向向上(即北)順時針開始)
    Parameters:
        x：x能夠是一個number或一個pair/vector of numbers或一個turtle instance
        y：x是一個number,y就是一個number;不然y爲None
# 例如：

        turtle.goto(20, 20)
        # 移動後,位置爲(20,20),兩個向量分別是(20,20)點到(0, 0)點的向量和(20, 20)點到箭頭當前方向的向量("standard"模式默認向右,逆時針算角度,"logo"模式默認向上,順時針算角度)
        angle = turtle.towards(0, 0)
        print("兩向量角度：", angle)
        # turtle.towards((0, 0), None)
        angle = turtle.towards((0, 0))
        print("兩向量角度：", angle)
        # turtle箭頭當前位置與turtle1箭頭當前位置連線的向量到turtle箭頭當前位置與turtle當前方向連線的向量角度
        turtle1 = turtle.Turtle()
        turtle1.setpos(0, 0)
        angle = turtle.towards(turtle1)
        # "standard"模式逆時針算角度,因此towards()後的角度angle是225,不是135
        print("兩向量角度：", angle)

# turtle.xcor() 和 turtle.ycor()
# turtle.xcor()是返回(海龜)箭頭的x座標,turtle.ycor()是返回(海龜)箭頭的y座標
# 例如：

        turtle.lt(50)
        turtle.fd(100)
        # 打印箭頭當前座標(64.28,76.60)
        print(turtle.pos())
        # 原數據64.27876096865394,保留5位後打印64.27876
        print(round(turtle.xcor(), 5))
        # 原數據76.60444431189781,保留5位後打印76.60444
        print(round(turtle.ycor(), 5))

# turtle.heading()
# 返回當前箭頭方向角度,取決於當前模式mode,「standard」模式時默認方向向右逆時針計算角度;「logo」模式默認方向向上,順時針計算角度
# 例如：

見turtle.circle中的例子

# turtle.distance(x, y=None)
# 返回當前(海龜)箭頭座標與座標(x,y)間距離或當前(海龜)箭頭座標與另外一個(海龜)箭頭座標間距離
    Parameters:
        x：x能夠是一個number或一個pair/vector of numbers或一個turtle instance
        y：x是一個number,y就是一個number;不然y爲None
# 例如：

        turtle.home()
        # 距離爲50
        print(turtle.distance(30,40))
        # 距離爲50
        print(turtle.distance((30,40)))
        joe = turtle.Turtle()
        joe.setpos(30, 40)
        # 距離爲50
        print(turtle.distance(joe))

# c).設置與測量
# turtle.degrees(fullcircle=360.0) 和 turtle.radians()
# turtle.degrees表示設置一個完整圓的「度數」。默認值爲360度,參數fullcircle(number類型),若是是360度時的90度,假如改爲整圓爲400度則此時角度應該是90/360*400
# turtle.radians()表示將一個完整圓的「度數」設置成2π,若是是360度時的90度則此時角度應該是90/360*(2π)
# 例如：

        turtle.home()
        turtle.left(90)
        # 輸出(360份裏的90份)90.0
        print(turtle.heading())
        # 將一個完整圓的「度數」從360度改爲400度
        turtle.degrees(400.0)
        # 輸出(400份裏的100份)100.0
        print(turtle.heading())
        # 將一個完整圓的「度數」設置成360度
        turtle.degrees(360)
        # 輸出(360份裏的90份)90.0
        print(turtle.heading())
        turtle.radians()
        # 輸出(2π份裏的1.5707963267948966份)1.5707963267948966
        print(turtle.heading())

#############################
#       2.畫筆控制           #
#############################
# a).畫筆繪製狀態
# 舊方法 turtle.penup() | turtle.up() | turtle.pu()
# 畫筆擡起,此時移動不會進行繪製操做
# 例如：

        turtle.pu()

# 舊方法 turtle.pendown() | turtle.down() | turtle.pd()
# 畫筆按下,此時移動會進行繪製操做
# 例如：

        turtle.pd()

# turtle.width(width=None) | turtle.pensize(width=None)
# 設置或返回線的粗細(width=None時表示返回,不爲None表示設置)，注意若是resizemode設置成"auto"而且繪製的是多邊形，則多邊形繪製時使用相同的線條粗細
# 例如：

        # 設置線條粗細爲5
        turtle.pensize(5)
        # 返回線條粗細爲5
        turtle.pensize()

# turtle.pen(pen=None, **pendict)
# 設置或返回畫筆字典中對應的畫筆屬性(一個鍵值對)
    Parameters:
        (pendict)畫筆字典鍵值對以下
            「fillcolor」: color-string or color-tuple
            「outline」: positive number
            「pencolor」: color-string or color-tuple
            「pendown」: True/False
            「pensize」: positive number
            「resizemode」: 「auto」 or 「user」 or 「noresize」
            「shearfactor」: number
            「shown」: True/False
            「speed」: number in range 0..10
            「stretchfactor」: (positive number, positive number)
            「tilt」: number
# 例如：

        # 打印{'shown': True, 'pendown': True, 'pencolor': 'black', 'fillcolor': 'black', 'pensize': 1, 'speed': 3, 'resizemode': 'noresize', 'stretchfactor': (1.0, 1.0), 'shearfactor': 0.0, 'outline': 1, 'tilt': 0.0}
        print(turtle.pen())
        turtle.pen(fillcolor="black", pencolor="red", pensize=10)
        # 打印排序後的爲 [('fillcolor', 'black'), ('outline', 1), ('pencolor', 'red'), ('pendown', True), ('pensize', 10), ('resizemode', 'noresize'), ('shearfactor', 0.0), ('shown', True), ('speed', 3), ('stretchfactor', (1.0, 1.0)), ('tilt', 0.0)]
        print(sorted(turtle.pen().items()))
        turtle.fd(100)
        penstate=turtle.pen()
        turtle.pen(penstate, fillcolor="green")

# turtle.isdown()
# 獲取畫筆是否按下,按下返回True,不然返回False
# 例如：

        turtle.pu()
        # 打印False
        print(turtle.isdown())
        turtle.pd()
        # 打印True
        print(turtle.isdown())

# b).畫筆顏色控制
# turtle.pencolor(*args)
# 設置或返回畫筆顏色(設置後海龜箭頭的外輪廓也是這個顏色)
# 例如：

        # 返回畫筆顏色
        turtle.pencolor()
        # pencolor(colorstring)語法設置畫筆顏色
        turtle.pencolor("red")
        turtle.fd(50)
        # pencolor(colorstring)語法設置畫筆顏色
        turtle.pencolor("#33cc8c")
        turtle.fd(50)
        # pencolor(r, g, b)或pencolor((r, g, b))語法設置畫筆顏色,取決於顏色模式,colormode顏色模式取值1.0或255,colormode爲1.0時r,g,b取值範圍0-1.0小數;colormode爲255時r,g,b取值範圍0-255的整數
        turtle.getscreen().colormode(1.0)
        # 打印顏色模式爲1.0
        print(turtle.getscreen().colormode())
        turtle.pencolor(0.1, 0.2, 0)
        turtle.fd(50)
        turtle.getscreen().colormode(255)
        # 打印顏色模式爲255
        print(turtle.getscreen().colormode())
        turtle.pencolor(30, 210, 180)
        turtle.fd(50)

# turtle.fillcolor(*args)
# 返回或設置畫筆填充顏色(設置後海龜箭頭內部填充也是這個顏色)
# 用法同turtle.pencolor(*args)方法
# 例如：

        print(turtle.fillcolor())
        screen = turtle.getscreen()
        # pencolor(colorstring)語法設置畫筆顏色
        turtle.fillcolor("red")
        turtle.fd(50)
        # fillcolor(colorstring)語法設置畫筆顏色
        turtle.fillcolor("#33cc8c")
        turtle.fd(50)
        # fillcolor(r, g, b)fillcolor((r, g, b))語法設置畫筆顏色,取決於顏色模式,colormode顏色模式取值1.0或255,colormode爲1.0時r,g,b取值範圍0-1.0小數;colormode爲255時r,g,b取值範圍0-255的整數
        screen.colormode(1.0)
        # 打印顏色模式爲1.0
        print(screen.colormode())
        turtle.fillcolor(0.1, 0.2, 0)
        turtle.fd(50)
        screen.colormode(255)
        # 打印顏色模式爲255
        print(screen.colormode())
        turtle.fillcolor(30, 210, 180)
        turtle.fd(50)

# turtle.color(*args)
# 設置或返回pencolor和fillcolor
# 例如：

        # 返回pencolor和fillcolor  ('black','black')
        print(turtle.color())
        # color(colorstring)或color((r,g,b))或color(r,g,b)將pencolor和fillcolor都設置成紅色
        turtle.color("red")
        # 返回pencolor和fillcolor  ('red','red')
        print(turtle.color())
        # color(colorstring1, colorstring2)或color((r1,g1,b1), (r2,g2,b2))分別設置pencolor和fillcolor
        turtle.color("red", "yellow")
        # 返回pencolor和fillcolor  ('red','yellow')
        print(turtle.color())
        turtle.color("#285078", "#a0c8f0")
        # 返回pencolor和fillcolor ((0.1568627450980392, 0.3137254901960784, 0.47058823529411764), (0.6274509803921569, 0.7843137254901961, 0.9411764705882353))
        print(turtle.color())

# c).填充
# turtle.filling()返回填充狀態(填充狀態則返回True,不然返回False)、開始填充圖形以前先調用turtle.begin_fill()、填充完圖形後調用turtle.end_fill()
# 例如：

        # 返回False
        print(turtle.filling())
        # 繪製shape以前先準備開始fill
        turtle.begin_fill()
        # 返回True
        print(turtle.filling())
        turtle.circle(20, None, 6)
        # 繪製完shape以後結束fill
        turtle.end_fill()
        # 返回False
        print(turtle.filling())

# d).更多的繪製控制,注意screen實際上是TurtleScreen對象的實例,使用screen時要先經過screen = turtle.getscreen()獲得
# turtle.reset() | turtle.resetscreen() | screen.reset() | screen.resetscreen()
# 清屏並將畫筆位置和方向恢復到初始狀態，保持畫筆形狀不變，即位置恢復到原點(0, 0)位置，"standard"/"world"模式方向也恢復到默認的向右,"logo"模式方向恢復到默認的向上
# 例如：

        turtle.reset()

# turtle.clear() | turtle.clearscreen() | screen.clear() | screen.clearscreen()
# 清屏而且畫筆形狀也恢復默認,保持畫筆位置和方向不變
# 例如：

        turtle.clear()

# turtle.write(arg, move=False, align="left", font=("Arial", 8, "normal"))
    Parameters:
        arg – object to be written to the TurtleScreen  待繪製的文本
        move – True/False   設置是否繪製
        align – one of the strings 「left」, 「center」 or right」設置文本下方初始位置
        font – a triple (fontname, fontsize, fonttype) 設置字體
# 繪製文本
# 例如：

        # 繪製文本「Home = 」，move爲True表示畫筆從文本下邊align所在位置一直繪製到文本右下方,默認False不繪製
        turtle.write("Home = ", True, align="center")
        turtle.write((0,0), True)

#############################
#       3.繪製狀態           #
#############################
# a).顯示/隱藏
# turtle.hideturtle() | turtle.ht()
# 隱藏畫筆(即海龜箭頭),此時只要畫筆是按下狀態，雖然隱藏了可是仍是能繪製圖形的,複雜的快速繪圖時效果顯著
# 例如：

        turtle.hideturtle()

# turtle.showturtle() | turtle.st()
# 顯示畫筆(即海龜箭頭)
# 例如：

        turtle.showturtle()

# turtle.isvisible()
# 返回(海龜)畫筆當前是不是可見狀態,可見返回True,不然返回False
# 例如：

        turtle.hideturtle()
        # 返回False
        print(turtle.isvisible())
        turtle.showturtle()
        # 返回True
        print(turtle.isvisible())

# b).外觀
# turtle.shape(name=None)
    Parameters:
        name – 形狀名，必須在TurtleScreen的形狀字典中，如(粗大箭頭1)「arrow」,(海龜箭頭) 「turtle」, (實心圓箭頭)「circle」, (實心方形箭頭)「square」, (粗大箭頭2)「triangle」, 默認的箭頭「classic」
# 設置或返回(海龜)畫筆箭頭形狀名
# 例如：

        # 打印 'classic'
        print(turtle.shape())
        turtle.shape("turtle")
        # 打印 'turtle'
        print(turtle.shape())

# turtle.resizemode(rmode=None)
    Parameters:
        rmode – 「auto」, 「user」, 「noresize」，3選1，具體說明以下
            「auto」: 此模式下(海龜)畫筆箭頭隨 pensize變化而變化.
            「user」: 此模式下(海龜)畫筆箭頭大小取決於【經過shapesize()進行設置的】.stretchfactor和outlinewidth (outline)的值
            「noresize」:此模式下(海龜)畫筆箭頭大小不變
# 設置或返回(海龜)畫筆箭頭大小的縮放模式

# turtle.shapesize(stretch_wid=None, stretch_len=None, outline=None) | turtle.turtlesize(stretch_wid=None, stretch_len=None, outline=None)
    Parameters:
        stretch_wid – positive number 與當前箭頭方向的垂直方向上的拉伸值
        stretch_len – positive number 與當前箭頭方向上的拉伸值
        outline – positive number shape輪廓寬度值
# 返回或設置畫筆x/y方向拉伸值和(或)shape輪廓寬度，僅當resizemode爲「user」模式時有效
# 例如：

        # 設置外輪廓顏色爲red,填充色爲black
        turtle.pen(pencolor="red", fillcolor="black")
        # 返回, (1.0, 1.0, 1)表示垂直方向縮放到原來爲1倍,水平方向縮放到原來1倍,外輪廓寬度1
        print(turtle.shapesize())
        # 設置resizemode爲"user"模式
        turtle.resizemode("user")
        # 表示垂直方向縮放到原來爲5倍,水平方向縮放到原來5倍,外輪廓寬度12
        turtle.shapesize(5, 5, 12)
        # 返回, (5, 5, 12)
        print(turtle.shapesize())
        # 設置輪廓寬度爲8
        turtle.shapesize(outline=8)
        # 返回，(5, 5, 8)
        print(turtle.shapesize())

# turtle.shearfactor(shear=None)
    Parameters:
        shear – number (optional)
# 設置或返回剪切因子，
# 例如：

        # 箭頭改爲圓形
        turtle.shape("circle")
        # 垂直縮放到5倍,水平縮放到2倍
        turtle.shapesize(5, 2)
        print(turtle.shearfactor())
        # 建立另外一個(海龜)箭頭，和原來的拉開距離
        tl = turtle.Turtle()
        tl.pu()
        tl.fd(100)
        tl.pd()
        tl.shape("circle")
        # 垂直縮放到5倍,水平縮放到2倍
        tl.shapesize(5, 2)
        # 設置shearfactor爲0.5
        tl.shearfactor(0.5)
        print(tl.shearfactor())

# turtle.tilt(angle)
    Parameters:
        angle – a number  箭頭圖標在現有角度基礎上再旋轉的角度，好比當前爲45度,此基礎45度變成90度
# 保持箭頭方向不變的前提下，旋轉箭頭形狀
# 例如：

        # 清屏並恢復原始座標位置(0,0)恢復默認方向向右
        turtle.reset()
        # 改變箭頭形狀爲圓形
        turtle.shape("circle")
        # 垂直縮放到5倍，水平縮放到2倍
        turtle.shapesize(5, 2)
        # 保持方向向右,圓形箭頭圖標旋轉45度
        turtle.tilt(45)
        # 畫線
        turtle.fd(100)
        # 拷貝一份箭頭形狀
        turtle.stamp()
        # 保持方向向右,圓形箭頭圖標旋轉45度
        turtle.tilt(45)
        # 畫線
        turtle.fd(100)

# turtle.tiltangle(angle=None)
    Parameters:
        angle – a number 忽略箭頭如今的旋轉角度,旋轉到指定的角度數,好比當前爲45度,忽略此時角度45,直接旋轉到45度
# 獲取或設置(保持箭頭方向不變的前提下，)旋轉箭頭形狀的角度
# 例如：

        # 清屏並恢復原始座標位置(0,0)恢復默認方向向右
        turtle.reset()
        # 改變箭頭形狀爲圓形
        turtle.shape("circle")
        # 垂直縮放到5倍，水平縮放到2倍
        turtle.shapesize(5, 2)
        # 保持方向向右,圓形箭頭圖標旋轉45度
        turtle.tilt(45)
        # 畫線
        turtle.fd(100)
        # 拷貝一份箭頭形狀
        turtle.stamp()
        # 保持方向向右,忽略當前箭頭旋轉的角度,圓形箭頭圖標旋轉到45度
        turtle.tiltangle(45)
        # 返回角度45度
        print(turtle.tiltangle())
        # 畫線
        turtle.fd(100)

# turtle.shapetransform(t11=None, t12=None, t21=None, t22=None)
    Parameters:
        t11 – a number (optional)
        t12 – a number (optional)
        t21 – a number (optional)
        t12 – a number (optional)
# 返回或設置箭頭形狀的當前變換矩陣
# 例如：

        # 返回 (1.0, 0.0, 0.0, 1.0)
        print(turtle.shapetransform())
        turtle.shape("square")
        # 垂直方向縮放到4倍,水平縮放到2倍，正方形變長方形
        turtle.shapesize(4, 2)
        turtle.shearfactor(-0.5)
        print(turtle.shapetransform())

# turtle.get_shapepoly()
# 返回當前多邊形的座標對,通常用來定義一個新形狀或做爲一個複合形狀的一部分
# 例如：

        turtle.shape("square")
        turtle.shapetransform(4, -1, 0, 2)
        # 輸出 ((50, -20), (30, 20), (-50, 20), (-30, -20))
        print(turtle.get_shapepoly())

#############################
#       4.繪製使用的事件      #
#############################
# turtle.onclick(fun, btn=1, add=None)
    Parameters:
        fun – 一個有兩個參數x,y的函數,畫布上鼠標左鍵在當前海龜箭頭位置按下時將點擊的座標做爲參數,調用該方法
        num – 鼠標按鈕的數目，默認爲1（鼠標左鍵）
        add – True或False.若是是True,將添加一個新的綁定;不然將替換前綁定
# 畫布上鼠標左鍵在當前海龜箭頭位置按下時綁定一個函數;若是函數爲None,則移除存在的綁定
# 例如：

        def turn(x, y):
            turtle.lt(90)
            # 打印當前座標
            print('x=', x, 'y=', y)
            # 打印當前方向
            print(turtle.heading())
            # 清除綁定關係
            turtle.onclick(None)
            # 再次綁定
            turtle.onclick(turn)
        # 綁定turn方法
        turtle.onclick(turn)

# turtle.onrelease(fun, btn=1, add=None)
    Parameters:
        fun – 一個有兩個參數x,y的函數,畫布上鼠標左鍵在當前海龜箭頭位置彈起時將點擊的座標做爲參數,調用該方法
        num – 鼠標按鈕的數目，默認爲1（鼠標左鍵）
        add – True或False.若是是True,將添加一個新的綁定;不然將替換前綁定
# 畫布上鼠標左鍵在當前海龜箭頭位置彈起時綁定一個函數;若是函數爲None,則移除存在的綁定
# 例如：

        def turn(x, y):
            turtle.lt(90)
            # 打印當前座標
            print('x=', x, 'y=', y)
            print(turtle.heading())
            # 清除綁定關係
            turtle.onrelease(None)
            # 再次綁定
            turtle.onrelease(turn)
        # 綁定turn方法
        turtle.onrelease(turn)

# turtle.ondrag(fun, btn=1, add=None)
    Parameters:
            fun – 一個有兩個參數x,y的函數,畫布上鼠標左鍵在當前海龜箭頭位置按下並拖動時將點擊的座標做爲參數,調用該方法
            num – 鼠標按鈕的數目，默認爲1（鼠標左鍵）
            add – True或False.若是是True,將添加一個新的綁定;不然將替換前綁定
# 畫布上鼠標左鍵在當前海龜箭頭位置按下並拖動時綁定一個函數;若是函數爲None,則移除存在的綁定
# 例如：

        def move(x, y):
            # 海龜箭頭移動到當前拖動位置
            turtle.goto(x, y)
            # 清除綁定關係
            turtle.ondrag(None)
            # 再次綁定
            turtle.ondrag(move)
        # 綁定turn方法
        turtle.ondrag(move)

#############################
#       5.特殊的繪製方法      #
#############################
# turtle.begin_poly()、turtle.end_poly()和turtle.get_poly()配合使用
# turtle.begin_poly()表示開始記錄多邊形第一個頂點
# turtle.end_poly()表示結束記錄多邊形頂點
# turtle.get_poly()表示獲取最後記錄的多邊形
# 例如：

        turtle.home()
        # 開始記錄
        turtle.begin_poly()
        turtle.fd(100)
        turtle.lt(20)
        turtle.fd(30)
        turtle.lt(60)
        turtle.fd(50)
        # 結束記錄
        turtle.end_poly()
        # 返回記錄的多邊形
        p = turtle.get_poly()
        # ((0.00,0.00), (100.00,0.00), (128.19,10.26), (136.87,59.50))
        print(p)
        #  將「myFavouriteShape」Shape添加到TurtleScreen對象的shapelist中
        turtle.register_shape("myFavouriteShape", p)
        # 使用新添加的shape
        turtle.shape("myFavouriteShape")

# turtle.clone()
# 建立和返回具備相同位置、方向和海龜箭頭屬性的海龜的克隆
# 例如：

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

# turtle.getturtle() | turtle.getpen()
# 返回當前海龜屏幕上第一個海龜對象自己
# 例如：

        pet = turtle.getturtle()
        pet.fd(50)
        print(pet)

# turtle.getscreen()
# 返回繪製着海龜的海龜屏幕對象,獲取該對象後就能夠調用海龜屏幕對象的一些方法了
# 例如：

        # 獲取海龜屏幕TurtleScreen對象
        ts = turtle.getscreen()
        print(ts)
        # 調用海龜屏幕對象的bgcolor方法,設置背景顏色爲粉紅色
        ts.bgcolor("pink")

# turtle.setundobuffer(size)
    Parameters:
        size – an integer【設置undo()可撤銷的最大次數】或None【禁用undo()撤銷功能】
# 設置或禁用撤銷功能, size爲None表示禁用撤銷功能;不然設置多大,就能夠經過調用undo()方法撤銷多少次
# 例如：

        turtle.setundobuffer(42)

# turtle.undobufferentries()
# 獲取當前剩餘可撤銷次數
# 例如：

        while turtle.undobufferentries():   # 判斷是否可撤銷
            turtle.undo()                   # 執行撤銷操做

二：海龜屏幕(TurtleScreen/Screen)的相關方法
首先須要經過screen = turtle.getscreen()獲取到海龜屏幕TurtleScreen的對象並賦值給變量screen,下文中screen均表示該海龜屏幕TurtleScreen的對象
a)Window Control窗口控制
# screen.bgcolor(*args)
    Parameters:
        args – 一個顏色字符串或3個範圍是0-colormode的數字或三個元祖
# 設置或返回海龜屏幕TurtleScreen的背景色
# 例如：

           screen = turtle.getscreen()
           screen.bgcolor("orange")
           # 打印 'orange'
           print(screen.bgcolor())
           screen.bgcolor("#800080")
           # 打印(128.0, 0.0, 128.0)
           print(screen.bgcolor())

# screen.bgpic(picname=None)
    Parameters:
        picname – 一個gif的字符串名字或"nopic"字符串或None
            git圖片名：表示設置海龜屏幕TurtleScreen的背景圖像
            "nopic"：表示刪除海龜屏幕TurtleScreen的背景圖像
            None:表示返回海龜屏幕TurtleScreen的背景圖像的名稱
# 設置/刪除背景圖片或返回當前的背景圖片名
# 例如：

        screen = turtle.getscreen()
        # 打印當前背景圖像名,打印結果爲'nopic'
        print(screen.bgpic())
        # 設置背景圖像,landscape.gif須要提早放到該文件同級目錄
        screen.bgpic("landscape.gif")
        # 打印當前背景圖像名,打印結果爲"landscape.gif"
        print(screen.bgpic())
        screen.bgpic('nopic')
        # 打印當前背景圖像名,打印結果爲'nopic'
        print(screen.bgpic())

# screen.clear() | screen.clearscreen() 和 screen.reset() | screen.resetscreen()
# 例如：見【2.畫筆控制中->d).更多的繪製控制】中例子

# screen.screensize(canvwidth=None, canvheight=None, bg=None)
    Parameters:
        canvwidth – 畫布寬度(正整數,單位爲像素)
        canvheight – 畫布高度(正整數,單位爲像素)
        bg – 新的背景顏色(colorstring或顏色組)
# 若是沒給出參數,則返回當前的畫布大小(canvaswidth, canvasheight);不然表示調整畫布大小
# 例如：

        screen = turtle.getscreen()
        # 打印當前畫布大小,結果爲(400, 300)
        print(screen.screensize())
        # 調整畫布大小,變大後出現了滾動條,可經過滑動滑塊查看畫布隱藏部分
        screen.screensize(2000, 1500)
        # 打印當前畫布大小,結果爲(2000, 1500)
        print(screen.screensize())

# screen.setworldcoordinates(llx, lly, urx, ury)
    Parameters:
        llx – 畫布左下角x座標(number型)
        lly – 畫布左下角y座標(number型)
        urx – 畫布右上角x座標(number型)
        ury – 畫布右上角y座標(number型)
# 設置用戶自定義的座標系統，若是必要的話須要切換到「world」模式，若是「world」模式已是活動的，則會根據新的座標重繪圖紙。
# 注意：在用戶自定義的座標系統中，角度可能會出現扭曲
# 例如：

        screen = turtle.getscreen()
        # 獲取當前海龜模式,打印結果爲 logo
        print(screen.mode())
        turtle.shape("turtle")
        # 清屏,位置方向恢復初始狀態,保持海龜箭頭形狀不變
        screen.reset()
        # 設置海龜模式爲"world"模式,感受設不設置"world"模式展示效果沒啥區別
        screen.mode("world")
        screen.setworldcoordinates(-50, -7.5, 50, 7.5)
        for _ in range(72):
            turtle.lt(10)
        for _ in range(8):
            turtle.lt(45);turtle.fd(2)

b)Animation Control動畫控制
# screen.delay(delay=None)
    Parameters:
        delay – 正整數
# 設置或返回繪圖延遲(單位:毫秒),繪圖延遲越長,動畫的速度越慢
# 例如：

        screen = turtle.getscreen()
        # 獲取繪圖延遲毫秒數,打印結果爲10
        print(screen.delay())
        # 設置繪圖延遲
        screen.delay(5)
        # 獲取繪圖延遲毫秒數,打印結果爲5
        print(screen.delay())

# screen.tracer(n=None, delay=None)
    Parameters:
        n – 非負整數
        delay – 非負整數,見screen.delay(delay=None)
# 打開或關閉海龜動畫，並設置繪製延遲
# 例如：

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

# screen.update()
# 更新海龜屏幕TurtleScreen對象,tracer關閉時使用

c)Using screen events - 海龜屏幕TurtleScreen的相關事件
# screen.listen(xdummy=None, ydummy=None)
# 爲了收集關鍵事件,讓海龜屏幕TurtleScreen的對象獲取焦點

# screen.onkey(fun, key) | screen.onkeyrelease(fun, key)
    Parameters:
        fun – 一個無參函數或None
        key – 一個字符串鍵值: 普通按鍵 (例如：「a」) 或功能鍵 (例如：「space」)
# 鍵盤上key鍵key-release事件觸發時(即按下並擡起)綁定一個無參函數;若是第一個參數fun爲None,則移除綁定的函數
# 注意：前提是海龜屏幕TurtleScreen對象須要經過screen.listen()方法獲取焦點了
# 例如：

        def f():
            turtle.fd(50)
            turtle.lt(60)
        screen = turtle.getscreen()
        # 點擊up鍵綁定f函數
        screen.onkey(f, "Up")
        # 屏幕獲取焦點
        screen.listen()

# screen.onkeypress(fun, key=None)
    Parameters:
        fun – 一個無參函數或None
        key – 一個字符串鍵值: 普通按鍵 (例如：「a」) 或功能鍵 (例如：「space」),key爲None表示任何按鍵按下都會觸發
# 鍵盤上key鍵(若是key爲None時表示任意按鍵)按下時即key-press事件觸發時綁定一個無參函數;若是第一個參數fun爲None,則移除綁定的函數。
# 例如：

        def f():
                turtle.fd(50)
                turtle.lt(60)
            screen = turtle.getscreen()
            # 按下"Up"鍵時綁定f函數
            #screen.onkeypress(f, "Up")
            # 按下任意鍵時綁定f函數
            screen.onkeypress(f, None)
            screen.listen()

# screen.onclick(fun, btn=1, add=None) | screen.onscreenclick(fun, btn=1, add=None)
    Parameters:
        fun – 一個有兩個參數x,y的函數,畫布上鼠標左鍵按下時將點擊的座標做爲參數,調用該方法
        num – 鼠標按鈕的數目，默認爲1（鼠標左鍵）
        add – True或False.若是是True,將添加一個新的綁定;不然將替換前綁定
# 畫布上鼠標左鍵在按下時綁定一個函數;若是函數爲None,則移除存在的綁定
# 例如：

        screen = turtle.getscreen()
        def turn(x, y):
            turtle.lt(90)
            # 打印當前座標
            print('x=', x, 'y=', y)
            print(turtle.heading())
            # 清除綁定關係
            screen.onclick(None)
            # 再次綁定
            screen.onclick(turn)
        # 綁定turn方法
        screen.onclick(turn)

# screen.ontimer(fun, t=0)
    Parameters:
        fun – 一個無參的函數
        t – 一個>=0的number
# 開啓一個計時器,t毫秒後調用函數fun
# 例如：點擊屏幕畫多邊形,再次點擊中止繪製

        # 定義全局變量
        running = False
        def demo1():
            screen = turtle.getscreen()
            def f():
                # 內部函數想修改或使用全局變量須要加global,不然認爲是局部變量
                global running
                if running:
                    turtle.fd(100)
                    turtle.lt(45)
                # 開啓計時器,250毫秒後執行f函數
                screen.ontimer(f, 250)
            def change_status(x, y):
                # 內部函數想修改或使用全局變量須要加global,不然認爲是局部變量
                global running
                # bool取反操做
                running = not running
            f()
            screen.onclick(change_status)
        def my_main():
            demo1()
            turtle.mainloop()
        if __name__ == '__main__':
            my_main()

# d)Input methods輸入相關方法
# screen.textinput(title, prompt)
    Parameters:
        title – 彈框標題(一個string字符串)
        prompt – 彈框提示(一個string字符串)
# 彈出一個輸入文本的彈出框,點擊Cancel取消按鈕則返回None,點擊Ok按鈕返回輸入的字符串
# 例如：

        screen = turtle.getscreen()
        # 彈出輸入文本的彈出框
        name = screen.textinput("歡迎框", "你的姓名是")
        if (name != None and name != ""):
            print(name, ",您好")

# screen.numinput(title, prompt, default=None, minval=None, maxval=None)
    Parameters:
        title – 彈框標題(一個string字符串)
        prompt – 彈框提示(一個string字符串)
        default – 默認值number類型 (可選)
        minval – 最小值number類型 (可選)
        maxval – 最大值number類型 (可選)
# 彈出一個輸入數字的彈出框,點擊Cancel取消按鈕則返回None,點擊Ok按鈕返回輸入的number
# 例如：

        screen = turtle.getscreen()
        # 彈出輸入數字的彈出框
        age = screen.numinput("身高", "請輸入您的身高(單位:米)", 0, 0, 2.5)
        # 判空容錯處理
        if age != None and age > 0:
            print("身高", age, "米")

# e)Settings and special methods設置和特殊方法
# screen.mode(mode=None) | turtle.mode(mode=None)
    Parameters:
        mode – "standard"或 "logo"或"world" 3選1,各海龜模式含義以下
                Mode            初始方向          角度方向
            "standard"          向右 (東)         逆時針方向
            "world"             向右 (東)         逆時針方向
            "logo"              向上(北)          順時針方向
# 設置或返回海龜模式,默認是"standard"標準模式."standard"模式是兼容舊版本;"logo"模式兼容大部分海龜圖形標誌;"world"模式使用用戶自定義的「世界座標」該模式下x/y的單位比不爲1會出現扭曲
# 例如：見screen.setworldcoordinates(llx, lly, urx, ury)中例子

# screen.colormode(cmode=None) | turtle.colormode(cmode=None)
    Parameters:
        cmode – 1.0或255,二選一
# 返回或設置colormode的值爲1.0或255,隨後調用turtle.fillcolor(*args)、turtle.pencolor(*args)、turtle.color(*args)等方法設置畫筆顏色時R,G,B三組顏色值範圍必須是0-colormode值之間的數,不然會報異常
# 例如：見turtle.fillcolor(*args)、turtle.pencolor(*args)、turtle.color(*args)中例子

# screen.getcanvas() | turtle.getcanvas()
# 返回海龜屏幕TurtleScreen的畫布對象實例
# 例如：

        screen = turtle.getscreen()
        screen.getcanvas()

# screen.getshapes() | turtle.getshapes()
# 獲取當前可用海龜形狀的名稱列表
# 例如：

        # 獲取當前可用海龜形狀的名稱列表,打印結果 ['arrow', 'blank', 'circle', 'classic', 'square', 'triangle', 'turtle']
        print(turtle.getscreen().getshapes())

# screen.register_shape(name, shape=None) | screen.addshape(name, shape=None) | turtle.register_shape(name, shape=None) | turtle.addshape(name, shape=None)
# 內存中添加註冊海龜圖形
# 例如：

        screen = turtle.getscreen()
        方法1：
        screen.register_shape("turtle.gif")
        方法2：
        screen.register_shape("triangle", ((5,-3), (0,5), (-5,-3)))
        方法3：shape_obj是一個shape對象見 【turtle.begin_poly()、turtle.end_poly()和turtle.get_poly()配合使用】中例子
        screen.register_shape("myFavouriteShape", shape_obj)

# screen.turtles() | turtle.turtles()
# 返回海龜屏幕TurtleScreen中全部的海龜箭頭對象列表
# 例如：

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

# screen.window_height() | turtle.window_height() 和 screen.window_width() | turtle.window_width()
# 返回海龜繪圖窗口的高/寬(單位:像素)
# 例如：

        # 獲取海龜繪圖窗口高度(單位:像素), 打印 576
        print(turtle.window_height())
        # 獲取海龜繪圖窗口寬度(單位:像素), 打印 683
        print(turtle.window_width())

# screen.bye() | turtle.bye()
# 關閉海龜圖形窗口
# 例如：

        turtle.bye()

# screen.exitonclick() | turtle.exitonclick()
# 運行後屏幕自動消失,調用這句後屏幕會保持,直到點擊屏幕纔會關閉海龜圖形窗口
# 例如：

        turtle.exitonclick()

# screen.mainloop() | screen.done() | turtle.mainloop() | turtle.done()
# 運行後屏幕自動消失,調用這句後屏幕會保持,直到主動關閉當前窗口(點擊繪圖窗口右上角的關閉按鈕或程序調用screen.bye()或turtle.bye()函數),想使用的話必須做爲圖形繪製程序的最後一條語句
# 例如：

        turtle.mainloop()

# screen.setup(width=_CFG["width"], height=_CFG["height"], startx=_CFG["leftright"], starty=_CFG["topbottom"])
# turtle.setup(width=_CFG["width"], height=_CFG["height"], startx=_CFG["leftright"], starty=_CFG["topbottom"])
    Parameters:
        width – 一個整數(單位:像素)或一個小數(表示百分比),默認是屏幕寬的50%
        height – 一個整數(單位:像素)或一個小數(表示百分比),默認是屏幕高的75%
        startx – 若是是正數,則從屏幕左邊緣開始向右(單位：像素) ;若是爲負數則從屏幕右邊緣開始向左;若是爲None則窗口水平居中
        starty – 若是是正數,則從屏幕頂部邊緣開始向下(單位：像素) ;若是爲負數則從屏幕底部邊緣開始向上;若是爲None則窗口垂直居中
# 設置默認展示的主窗口的大小和位置(寬或高比海龜繪圖窗口小時對應方向上會出現滾動條)。參數的默認值存儲在turtle.cfg配置文件中,若是須要可進行修改
# 例如：

        screen = turtle.getscreen()
        # 海龜繪圖窗口寬高分別爲576和683,此時將默認展示的主窗口的大小設置成了576和100,垂直方向由於佔不全會出現滾動條
        screen.setup(width=576, height=100, startx=0, starty=0)
        # screen.setup(width=0.75, height=0.5, startx=None, starty=None)

# screen.title(titlestring) | turtle.title(titlestring)
# 設置海龜窗口標題
# 例如：

        screen = turtle.getscreen()
        # 設置窗口標題
        screen.title("hello turtle")

# 補充
# 關於turtle、turtle.getturtle()、和turtle.Turtle()的理解
# 例如：

        # turtle含義: <module 'turtle' from 'C:\\python_soft\\Anaconda3\\lib\\turtle.py'>
        print("turtle含義:", turtle)
        turtle0 = turtle.getturtle()
        # turtle0含義: <turtle.Turtle object at 0x000001CCCAC75978>   認爲turtle.getturtle()是獲取默認的第一個Turtle對象實例
        print("turtle0含義:", turtle0)
        turtle1 = turtle.Turtle()
        # turtle1含義: <turtle.Turtle object at 0x000001CCCAF97A20>  認爲turtle.Turtle()是建立一個新的Turtle實例對象並返回該實例對象
        print("turtle1含義:", turtle1)
        turtle2 = turtle.getturtle()
        # turtle2含義: <turtle.Turtle object at 0x000001CCCAC75978>
        print("turtle2含義:", turtle2)
        turtle3 = turtle.Turtle()
        # turtle3含義: <turtle.Turtle object at 0x000001CCCAF97B00>
        print("turtle3含義:", turtle3)