turtle — Графика черепахи¶

Запуск среды для черепах¶

В оболочке Python импортируйте все объекты модуля turtle:

from turtle import *

Если вы столкнетесь с ошибкой No module named '_tkinter', вам придется установить Tk interface package в свою систему.

Базовый чертеж¶

Отправьте черепаху вперед на 100 шагов:

forward(100)

Вы должны увидеть (скорее всего, в новом окне на вашем дисплее) линию, проведенную черепахой на восток. Измените направление движения черепахи, чтобы она повернулась на 120 градусов влево (против часовой стрелки).:

left(120)

Давайте продолжим, нарисуя треугольник:

forward(100)
left(120)
forward(100)

Обратите внимание, как черепаха, изображенная стрелкой, указывает в разные стороны, когда вы управляете ею.

Поэкспериментируйте с этими командами, а также с backward() и right().

home()

pos()

clearscreen()

Создание алгоритмических шаблонов¶

Используя петли, можно создавать геометрические узоры:

for steps in range(100):
    for c in ('blue', 'red', 'green'):
        color(c)
        forward(steps)
        right(30)

- which of course, are limited only by the imagination!

Давайте нарисуем звезду в верхней части этой страницы. Нам нужны красные линии, заполненные желтым:

color('red')
fillcolor('yellow')

Точно так же, как up() и down() определяют, будут ли отображаться линии, заливку можно включать и выключать:

begin_fill()

Далее мы создадим цикл:

while True:
    forward(200)
    left(170)
    if abs(pos()) < 1:
        break

abs(pos()) < 1 - это хороший способ узнать, когда черепаха вернется на свое место.

Наконец, завершите начинку:

end_fill()

(Обратите внимание, что заполнение фактически происходит только тогда, когда вы даете команду end_fill().)

Приступайте к работе как можно быстрее¶

Одной из прелестей turtle graphics является мгновенная визуальная обратная связь, которую можно получить с помощью простых команд - это отличный способ познакомить детей с идеями программирования с минимальными затратами (не только детей, конечно).

Модуль turtle делает это возможным, предоставляя все свои базовые функциональные возможности в виде функций, доступных с помощью from turtle import *. В turtle graphics tutorial описан этот подход.

Стоит отметить, что многие команды turtle также имеют еще более лаконичные эквиваленты, такие как fd() для forward(). Они особенно полезны при работе с учащимися, для которых набор текста не является навыком.

Для работы turtle graphics в вашей системе должен быть установлен Tk interface package. Имейте в виду, что это не всегда просто, поэтому проверьте это заранее, если вы планируете использовать turtle graphics с учеником.

Используйте пространство имен модуля turtle¶

Использование from turtle import * удобно, но имейте в виду, что при этом импортируется довольно большая коллекция объектов, и если вы делаете что-либо, кроме turtle graphics, вы рискуете столкнуться с конфликтом имен (это становится еще большей проблемой, если вы используете turtle graphics в скрипте, где другие модули может быть импортирован).

Решение состоит в том, чтобы использовать import turtle - fd() становится turtle.fd(), width() становится turtle.width() и так далее. (Если набирать «turtle» снова и снова становится утомительно, используйте вместо этого, например, import turtle as t.)

Используйте графику черепахи в скрипте¶

Рекомендуется использовать пространство имен модуля turtle, как описано непосредственно выше, например:

import turtle as t
from random import random

for i in range(100):
    steps = int(random() * 100)
    angle = int(random() * 360)
    t.right(angle)
    t.fd(steps)

Однако требуется еще один шаг - как только скрипт завершится, Python также закроет окно turtle. Добавь:

t.mainloop()

до конца выполнения скрипта. Теперь скрипт будет ожидать завершения и не завершит работу до тех пор, пока он не будет завершен, например, путем закрытия графического окна turtle.

Используйте объектно-ориентированную графику turtle¶

Объектно-ориентированный подход к графике черепашек используется не только для ознакомительных целей или для того, чтобы как можно быстрее освоиться, но и как более привычный и эффективный. Например, это позволяет отображать на экране сразу несколько черепашек.

При таком подходе различные команды turtle являются методами объектов (в основном объектов Turtle). Вы можете использовать объектно-ориентированный подход в командной оболочке, но это было бы более типично для скрипта на Python.

Тогда приведенный выше пример становится:

from turtle import Turtle
from random import random

t = Turtle()
for i in range(100):
    steps = int(random() * 100)
    angle = int(random() * 360)
    t.right(angle)
    t.fd(steps)

t.screen.mainloop()

Обратите внимание на последнюю строку. t.screen является экземпляром Screen, на котором существует экземпляр Turtle; он создается автоматически вместе с turtle.

Экран черепахи может быть настроен по индивидуальному заказу, например:

t.screen.title('Object-oriented turtle demo')
t.screen.bgcolor("orange")

Черепашьи методы¶

Движение черепахи

Двигайтесь и рисуйте

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

Способы создания водолазного экрана/ширмы¶

Управление окном

bgcolor()

bgpic()

clearscreen()

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

Движение черепахи¶

turtle.forward(distance)¶

turtle.fd(distance)¶

Parameters:

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

Parameters:

distance – число

Переместите черепашку назад на расстояние, противоположное направлению движения черепашки. Не меняйте направление движения черепашки.

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

turtle.right(angle)¶

turtle.rt(angle)¶

Parameters:

angle – число (целое или с плавающей точкой)

Поверните черепашку вправо на угол в единицах измерения. (По умолчанию единицами измерения являются градусы, но их можно задать с помощью функций degrees() и radians().) Ориентация угла зависит от режима черепашки, см. mode().

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

turtle.left(angle)¶

turtle.lt(angle)¶

Parameters:

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

Parameters:

• 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)¶

Parameters:

x – число (целое или с плавающей точкой)

Установите первую координату черепахи равной x, вторую координату оставьте без изменений.

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

turtle.sety(y)¶

Parameters:

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

Parameters:

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

Parameters:

• radius – число

• extent – число (или None)

• steps – целое число (или None)

Нарисуйте окружность с заданным радиусом. Центр находится в единицах радиуса слева от черепашки; протяженность - угол - определяет, какая часть окружности будет нарисована. Если протяженность не задана, нарисуйте всю окружность целиком. Если радиус не является полной окружностью, одна из конечных точек дуги является текущим положением пера. Если радиус положительный, нарисуйте дугу против часовой стрелки, в противном случае - по часовой стрелке. Наконец, направление движения черепашки изменяется на величину радиуса.

Поскольку окружность аппроксимируется вписанным правильным многоугольником, 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)¶

Parameters:

• size – целое число >= 1 (если задано)

• color – цветовая строка или числовой цветовой кортеж

Нарисуйте круглую точку диаметром размер, используя цвет. Если размер не указан, используется максимальное значение размера пера+4 и 2*размер пера.

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

Parameters:

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

Parameters:

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

Отмените (повторно) последнее действие черепашки. Количество доступных действий отмены определяется размером буфера отмены.

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

turtle.speed(speed=None)¶

Parameters:

speed – целое число в диапазоне 0..10 или строка скорости (см. ниже)

Установите для скорости черепахи целочисленное значение в диапазоне 0..10. Если аргумент не указан, верните текущую скорость.

Если введенное значение больше 10 или меньше 0,5, скорость устанавливается равной 0. Строки скорости преобразуются в значения скорости следующим образом:

• «самый быстрый»: 0

• «быстрый»: 10

• «нормальный»: 6

• «медленно»: 3

• «самый медленный»: 1

Скорости от 1 до 10 обеспечивают все более быструю анимацию рисования линий и поворота черепахи.

Внимание: скорость = 0 означает, что анимация не выполняется. движение черепахи вперед / назад приводит к прыжку, а движение влево/вправо - к мгновенному повороту.

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

Расскажите о состоянии черепахи¶

turtle.position()¶

turtle.pos()¶

Возвращает текущее местоположение черепахи (x,y) (в виде вектора Vec2D).

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

turtle.towards(x, y=None)¶

Parameters:

• x – число или пара/вектор чисел или экземпляр turtle

• 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)¶

Parameters:

• x – число или пара/вектор чисел или экземпляр turtle

• 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

Настройки для измерения¶

turtle.degrees(fullcircle=360.0)¶

Parameters:

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

Управление пером¶

Состояние черепахи¶

Использование событий¶

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

Parameters:

• fun – функция с двумя аргументами, которая будет вызвана с координатами выбранной точки на холсте

• btn – номер кнопки мыши, по умолчанию равен 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)¶

Parameters:

• fun – функция с двумя аргументами, которая будет вызвана с координатами выбранной точки на холсте

• btn – номер кнопки мыши, по умолчанию равен 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)¶

Parameters:

• fun – функция с двумя аргументами, которая будет вызвана с координатами выбранной точки на холсте

• btn – номер кнопки мыши, по умолчанию равен 1 (левая кнопка мыши)

• add – True или False - если True, то будет добавлена новая привязка, в противном случае она заменит прежнюю привязку

Привязать fun к событиям перемещения мыши на этой черепахе. Если значение fun равно None, существующие привязки удаляются.

Примечание: Каждой последовательности событий перемещения мыши на черепахе предшествует событие щелчка мыши на этой черепахе.

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

Создайте и верните клон черепашки с той же позицией, заголовком и свойствами черепашки.

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

Parameters:

size – целое число или None

Установите или отключите буфер отмены. Если size является целым числом, то устанавливается пустой буфер отмены заданного размера. size задает максимальное количество действий turtle, которые могут быть отменены с помощью undo() метода/функции. Если размер равен None, то необуфер отключен.

>>> turtle.setundobuffer(42)

turtle.undobufferentries()¶

Возвращает количество записей в буфере отмены.

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

Сложные формы¶

Чтобы использовать сложные формы черепах, которые состоят из нескольких полигонов разного цвета, вы должны явно использовать вспомогательный класс Shape, как описано ниже:

1. Создайте пустой объект формы типа «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. Теперь добавьте фигуру в список фигур на экране и используйте ее:

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

Управление окном¶

turtle.bgcolor(*args)¶

Parameters:

args – цветовая строка или три числа в диапазоне 0..colormode или набор из 3 таких чисел

Установите или верните цвет фона экрана с черепашками.

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

turtle.bgpic(picname=None)¶

Parameters:

picname – строка, название gif-файла или "nopic", или None

Установите фоновое изображение или верните название текущего фонового изображения. Если picname - это имя файла, установите соответствующее изображение в качестве фона. Если picname равно "nopic", удалите фоновое изображение, если оно присутствует. Если picname равно None, верните имя файла текущего фонового изображения.

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

turtle.clear()

Примечание

Этот метод TurtleScreen доступен как глобальная функция только под именем clearscreen. Глобальная функция clear отличается от метода Turtle clear.

turtle.clearscreen()¶

Удалите все рисунки и всех черепашек с экрана черепашек. Верните пустой экран черепашек в исходное состояние: белый фон, без фонового изображения, без привязок к событиям и трассировки.

turtle.reset()

Примечание

Этот метод TurtleScreen доступен как глобальная функция только под именем resetscreen. Глобальная функция reset является еще одним производным от метода Turtle reset.

turtle.resetscreen()¶

Верните всех черепах на экране в исходное состояние.

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

Parameters:

• canvwidth – положительное целое число, новая ширина холста в пикселях

• canvheight – положительное целое число, новая высота холста в пикселях

• bg – цветовая строка или цветовой кортеж, новый цвет фона

Если аргументы не указаны, верните значение current (ширина холста, высота холста). В противном случае измените размер холста, на котором рисуют черепашки. Не изменяйте окно рисования. Чтобы увидеть скрытые части холста, используйте полосы прокрутки. С помощью этого метода можно сделать видимыми те части рисунка, которые раньше находились за пределами холста.

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

например, для поиска ошибочно сбежавшей черепахи ;-)

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

Parameters:

• 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

Управление анимацией¶

turtle.delay(delay=None)¶

Parameters:

delay – положительное целое число

Установите или верните значение задержки рисования в миллисекундах. (Это приблизительно интервал времени между двумя последовательными обновлениями холста.) Чем больше задержка рисования, тем медленнее анимация.

Необязательный аргумент:

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

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

Parameters:

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

Выполните обновление экрана с водолазкой. Будет использоваться, когда функция трассировки выключена.

Смотрите также метод RawTurtle/Turtle Turtle speed().

Использование экранных событий¶

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

Установите фокус на Turtle Creek (чтобы собирать ключевые события). Вводятся фиктивные аргументы, чтобы иметь возможность передавать listen() методу onclick.

turtle.onkey(fun, key)¶

turtle.onkeyrelease(fun, key)¶

Parameters:

• fun – функция без аргументов или None

• key – строка: ключ (например, «a») или символ ключа (например, «пробел»)

Привязать fun к событию нажатия клавиши. Если значение fun равно None, привязки к событию удаляются. Примечание: чтобы иметь возможность регистрировать события нажатия клавиши, экран Turtle должен быть сфокусирован. (Смотрите метод listen().)

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

turtle.onkeypress(fun, key=None)¶

Parameters:

• 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)¶

Parameters:

• fun – функция с двумя аргументами, которая будет вызвана с координатами выбранной точки на холсте

• btn – номер кнопки мыши, по умолчанию равен 1 (левая кнопка мыши)

• add – True или False - если True, то будет добавлена новая привязка, в противном случае она заменит прежнюю привязку

Привязать fun к событиям, вызываемым щелчком мыши на этом экране. Если значение fun равно None, существующие привязки будут удалены.

Пример для экземпляра 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 доступен как глобальная функция только под именем onscreenclick. Глобальная функция onclick является еще одним производным от метода Turtle onclick.

turtle.ontimer(fun, t=0)¶

Parameters:

• fun – функция без аргументов

• t – число >= 0

Установите таймер, который вызывает «веселье» через t миллисекунд.

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

Запускает цикл обработки событий, вызывая функцию mainloop Tkinter. Должен быть последним оператором в графической программе turtle. Не должен использоваться, если скрипт запускается из IDLE в режиме -n (без подпроцесса) - для интерактивного использования графики turtle.

>>> screen.mainloop()

Методы ввода¶

turtle.textinput(title, prompt)¶

Parameters:

• title – строка

• prompt – строка

Откроется диалоговое окно для ввода строки. Заголовок параметра - это заголовок диалогового окна, подсказка - это текст, в основном описывающий, какую информацию вводить. Верните введенную строку. Если диалоговое окно отменено, верните None.

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

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

Parameters:

• title – строка

• prompt – строка

• default – номер (необязательно)

• minval – номер (необязательно)

• maxval – номер (необязательно)

Откроется диалоговое окно для ввода числа. заголовок - это заголовок диалогового окна, подсказка - это текст, в основном описывающий, какую числовую информацию вводить. default: значение по умолчанию, minval: минимальное значение для ввода, maxval: максимальное значение для ввода. Введенное число должно быть в диапазоне minval .. maxval, если они указаны. Если нет, выдается подсказка, и диалоговое окно остается открытым для исправления. Верните введенное число. Если диалоговое окно отменено, верните None.

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

Настройки и специальные методы¶

turtle.mode(mode=None)¶

Parameters:

mode – одна из строк «стандарт», «логотип» или «мир»

Установите режим черепашки («стандартный», «логотип» или «мир») и выполните сброс. Если режим не указан, возвращается текущий режим.

Режим «стандартный» совместим со старым turtle. Режим «логотип» совместим с большинством графических изображений черепашек с логотипами. Режим «мир» использует заданные пользователем «мировые координаты». Внимание: в этом режиме углы отображаются искаженными, если x/y отношение единиц измерения не равно 1.

Режим	Начальный курс черепахи	положительные углы
«стандартный»	справа (на восток)	против часовой стрелки
«логотип»	вверх (север)	по часовой стрелке

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

turtle.colormode(cmode=None)¶

Parameters:

cmode – одно из значений 1,0 или 255

Верните цветовой режим или установите для него значение 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()¶

Верните холст этого экрана-черепашки. Полезно для тех, кто знает, что делать с холстом 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 - это (составной) объект Shape: установите соответствующую составную фигуру.

Добавьте фигуру черепахи в список форм на TurtleScreen. Только зарегистрированные таким образом фигуры можно использовать, выполнив команду 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() к щелчкам мыши по экрану.

Если значение «using_IDLE» в словаре конфигурации равно False (значение по умолчанию), также введите mainloop. Примечание: Если используется параметр IDLE с параметром -n (без подпроцесса), это значение должно быть установлено на True в turtle.cfg. В этом случае собственный mainloop IDLE активен также и для клиентского скрипта.

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

Установите размер и положение главного окна. Значения аргументов по умолчанию хранятся в словаре конфигурации и могут быть изменены с помощью файла turtle.cfg.

Parameters:

• width – если целое число, то размер в пикселях, если число с плавающей точкой, то часть экрана; по умолчанию используется значение 50% экрана

• height – если целое число, то высота в пикселях, если число с плавающей точкой, то часть экрана; по умолчанию - 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)¶

Parameters:

titlestring – строка, отображаемая в строке заголовка графического окна turtle

Установите для заголовка окна turtle значение titlestring.

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

Как пользоваться справкой¶

Общедоступные методы классов Screen и Turtle подробно описаны в docstrings. Таким образом, их можно использовать в качестве онлайн-справки с помощью средств справки Python:

• При использовании IDLE всплывающие подсказки отображают подписи и первые строки строк документации для введенных вызовов функций/методов.

• При вызове 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()
  

• Строки документации функций, которые являются производными от методов, имеют измененный вид:

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

Эти измененные строки документации создаются автоматически вместе с определениями функций, которые являются производными от методов во время импорта.

Перевод строк документации на разные языки¶

Существует утилита для создания словаря, ключами которого являются имена методов, а значениями - строки документации открытых методов классов Screen и Turtle.

turtle.write_docstringdict(filename='turtle_docstringdict')¶

Parameters:

filename – строка, используемая в качестве имени файла

Создайте и запишите docstring-словарь в скрипт Python с заданным именем файла. Эта функция должна вызываться явно (она не используется графическими классами turtle). Словарь docstring будет записан в скрипт Python filename.py. Он предназначен для того, чтобы служить шаблоном для перевода строк документации на разные языки.

Если вы (или ваши ученики) хотите использовать turtle с онлайн-справкой на вашем родном языке, вам необходимо перевести строки документации и сохранить полученный файл, например, как turtle_docstringdict_german.py.

Если в вашем файле turtle.cfg есть соответствующая запись, этот словарь будет прочитан во время импорта и заменит исходные английские строки документации.

На момент написания этой статьи были доступны словари docstring на немецком и итальянском языках. (Запросы, пожалуйста, направляйте по адресу glingl@aon.at.)

Как настроить экран и черепашек¶

Встроенная конфигурация по умолчанию имитирует внешний вид и поведение старого модуля turtle, чтобы сохранить наилучшую возможную совместимость с ним.

Если вы хотите использовать другую конфигурацию, которая лучше отражает возможности этого модуля или которая лучше соответствует вашим потребностям, например, для использования в классе, вы можете подготовить файл конфигурации 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.

• форма может быть любой из встроенных форм, например: стрелка, черепаха и т.д. Для получения дополнительной информации попробуйте help(shape).

• Если вы хотите не использовать цвет заливки (т.е. сделать черепашку прозрачной), вам нужно написать fillcolor = "" (но все непустые строки в файле cfg не должны содержать кавычек).

• Если вы хотите отразить состояние черепахи, вы должны использовать resizemode = auto.

• Если вы зададите, например, language = italian, строка документа dict turtle_docstringdict_italian.py будет загружена во время импорта (если она присутствует в пути импорта, например, в том же каталоге, что и turtle).

• Записи exampleturtle и examplescreen определяют имена этих объектов в том виде, в каком они встречаются в строках документации. Преобразование method-docstrings в function-docstrings приведет к удалению этих имен из строк документации.

• using_IDLE: Установите значение True, если вы регулярно работаете с IDLE и его переключателем -n («нет подпроцесса»). Это предотвратит попадание exitonclick() в основной цикл.

В каталоге, где хранится файл turtle.cfg, может быть файл turtle, а в текущем рабочем каталоге может быть дополнительный файл. Последний будет переопределять настройки первого.

Каталог Lib/turtledemo содержит файл turtle.cfg. Вы можете изучить его в качестве примера и увидеть его эффекты при запуске демонстраций (желательно не из программы просмотра демонстраций).