24.1. turtle – Черепашья графика¶turtle – Turtle graphics

24.1.2.1. Методы Turtle¶Turtle methods

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

Перемещение и рисование

forward() | fd()

backward() | bk() | back()

right() | rt()

left() | lt()

goto() | setpos() | setposition()

setx()

sety()

setheading() | seth()

home()

circle()

dot()

stamp()

clearstamp()

clearstamps()

undo()

speed()

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

position() | pos()

towards()

xcor()

ycor()

heading()

distance()

Настройка и измерение

degrees()

radians()

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

Состояние рисования

pendown() | pd() | down()

penup() | pu() | up()

pensize() | width()

pen()

isdown()

Управление цветом

color()

pencolor()

fillcolor()

Заливка

filling()

begin_fill()

end_fill()

Дополнительное управление рисованием

reset()

clear()

write()

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

Видимость

showturtle() | st()

hideturtle() | ht()

isvisible()

Внешний вид

shape()

resizemode()

shapesize() | turtlesize()

shearfactor()

settiltangle()

tiltangle()

tilt()

shapetransform()

get_shapepoly()

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

onclick()

onrelease()

ondrag()

Специальные методы черепахи

begin_poly()

end_poly()

get_poly()

clone()

getturtle() | getpen()

getscreen()

setundobuffer()

undobufferentries()

24.1.2.2. Методы TurtleScreen/Screen¶Methods of TurtleScreen/Screen

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

bgcolor()

bgpic()

clear() | clearscreen()

reset() | resetscreen()

screensize()

setworldcoordinates()

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

delay()

tracer()

update()

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

listen()

onkey() | onkeyrelease()

onkeypress()

onclick() | onscreenclick()

ontimer()

mainloop() | done()

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

mode()

colormode()

getcanvas()

getshapes()

register_shape() | addshape()

turtles()

window_height()

window_width()

Методы ввода

textinput()

numinput()

Методы, специфичные для Screen

bye()

exitonclick()

setup()

title()

24.1.3.1. Движение черепашки¶Turtle motion

turtle.forward(distance)¶

turtle.fd(distance)¶

Параметры:	distance – число (целое или с плавающей запятой)

Перемещает черепаху вперед на указанное distance, в направлении, в котором черепаха смотрит.

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

turtle.back(distance)¶

turtle.bk(distance)¶

turtle.backward(distance)¶

Параметры:	distance – число

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

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

turtle.right(angle)¶

turtle.rt(angle)¶

Параметры:	angle – число (целое или с плавающей запятой)

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

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

turtle.left(angle)¶

turtle.lt(angle)¶

Параметры:	angle – число (целое или с плавающей запятой)

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

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

turtle.goto(x, y=None)¶

turtle.setpos(x, y=None)¶

turtle.setposition(x, y=None)¶

Параметры:	x – число или пара/вектор чисел y – число или None

Если y равен None, то x должен быть парой координат или Vec2D (например, возвращаемым функцией pos()).

Перемещает черепаху в абсолютную позицию. Если перо опущено, рисует линию. Направление черепахи не меняется.

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

turtle.setx(x)¶

Параметры:	x – число (целое или с плавающей запятой)

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

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

turtle.sety(y)¶

Параметры:	y – число (целое или с плавающей запятой)

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

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

turtle.setheading(to_angle)¶

turtle.seth(to_angle)¶

Параметры:	to_angle – число (целое или с плавающей запятой)

Устанавливает направление черепахи в to_angle. Вот некоторые распространенные направления в градусах:

стандартный режим	режим 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)¶

Параметры:	radius – число extent – число (или None) steps – целое число (или None)

Рисует окружность с заданным radius. Центр находится на radius единиц левее черепахи; extent – угол – определяет, какая часть окружности рисуется. Если extent не указан, рисуется вся окружность. Если extent не является полной окружностью, одна из конечных точек дуги – это текущее положение пера. Дуга рисуется против часовой стрелки, если radius положительный, и по часовой стрелке в противном случае. В конце направление черепахи изменяется на величину extent.

Поскольку окружность аппроксимируется вписанным правильным многоугольником, steps определяет количество используемых шагов. Если не указано, вычисляется автоматически. Может использоваться для рисования правильных многоугольников.

>>> turtle.home()
>>> turtle.position()
(0.00,0.00)
>>> turtle.heading()
0.0
>>> turtle.circle(50)
>>> turtle.position()
(-0.00,0.00)
>>> turtle.heading()
0.0
>>> turtle.circle(120, 180)  # нарисовать полуокружность
>>> turtle.position()
(0.00,240.00)
>>> turtle.heading()
180.0

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

Параметры:	size – целое число >= 1 (если указано) color – строка цвета или кортеж числовых цветов

Рисует круглую точку диаметром 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)¶

Параметры:	stampid – целое число, должно быть возвращаемым значением предыдущего вызова stamp()

Удаляет печать с заданным stampid.

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

turtle.clearstamps(n=None)¶

Параметры:	n – целое число (или None)

Удаляет все или первые/последние n отпечатков черепашки. Если n равно None, удаляет все отпечатки, если n > 0, удаляет первые n отпечатков, если n < 0, удаляет последние n отпечатков.

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

turtle.undo()¶

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

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

turtle.speed(speed=None)¶

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

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

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

• «самый быстрый»: 0
• «быстрый»: 10
• “обычная”: 6
• “медленная”: 3
• “самая медленная”: 1

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

Внимание: speed = 0 означает, что никакой анимации не происходит. forward/back заставляют черепашку прыгать, а left/right заставляют черепашку мгновенно поворачиваться.

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

24.1.3.2. Состояние черепашки¶Tell Turtle’s state

turtle.position()¶

turtle.pos()¶

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

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

turtle.towards(x, y=None)¶

Параметры:	x – число или пара/вектор чисел, или экземпляр черепашки y – число, если x – число, иначе None

Возвращает угол между линией от позиции черепахи до позиции, заданной с помощью (x, y), вектора или другой черепахи. Это зависит от начальной ориентации черепахи, которая зависит от режима – «standard»/«world» или «logo»).

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

turtle.xcor()¶

Возвращает x-координату черепашки.

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

turtle.ycor()¶

Возвращает y-координату черепашки.

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

turtle.heading()¶

Возвращает текущий курс черепашки (значение зависит от режима черепашки, см. mode()).

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

turtle.distance(x, y=None)¶

Параметры:	x – число или пара/вектор чисел, или экземпляр черепашки y – число, если x – число, иначе None

Возвращает расстояние от черепашки до точки (x,y), указанного вектора или указанной другой черепашки в единицах шага черепашки.

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

24.1.3.3. Настройки измерения¶Settings for measurement

turtle.degrees(fullcircle=360.0)¶

Параметры:	fullcircle – число

Устанавливает единицы измерения углов, то есть задаёт количество «градусов» в полном обороте. Значение по умолчанию – 360 градусов.

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

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

turtle.radians()¶

Устанавливает единицы измерения углов в радианы. Эквивалентно degrees(2*math.pi).

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

24.1.3.4. Управление пером¶Pen control

24.1.3.5. Состояние черепахи¶Turtle state

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

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

Параметры:	fun – функция с двумя аргументами, которая будет вызвана с координатами точки щелчка на холсте num – номер кнопки мыши, по умолчанию 1 (левая кнопка мыши) add – True или False – если True, будет добавлена новая привязка, в противном случае она заменит предыдущую привязку

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

>>> def turn(x, y):
...     left(180)
...
>>> onclick(turn)  # Теперь щелчок по черепашке повернёт её.
>>> onclick(None)  # привязка события будет удалена

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

Параметры:	fun – функция с двумя аргументами, которая будет вызвана с координатами точки щелчка на холсте num – номер кнопки мыши, по умолчанию 1 (левая кнопка мыши) add – True или False – если True, будет добавлена новая привязка, в противном случае она заменит предыдущую привязку

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

>>> class MyTurtle(Turtle):
...     def glow(self,x,y):
...         self.fillcolor("red")
...     def unglow(self,x,y):
...         self.fillcolor("")
...
>>> turtle = MyTurtle()
>>> turtle.onclick(turtle.glow)     # нажатие на черепашку меняет цвет заливки на красный,
>>> turtle.onrelease(turtle.unglow) # отпускание делает его прозрачным.

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

Параметры:	fun – функция с двумя аргументами, которая будет вызвана с координатами точки щелчка на холсте num – номер кнопки мыши, по умолчанию 1 (левая кнопка мыши) add – True или False – если True, будет добавлена новая привязка, в противном случае она заменит предыдущую привязку

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

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

>>> turtle.ondrag(turtle.goto)

После этого щелчок и перетаскивание черепашки будет перемещать её по экрану, создавая рисунки от руки (если перо опущено).

24.1.3.7. Специальные методы Turtle¶Special Turtle methods

turtle.begin_poly()¶

Начинает запись вершин многоугольника. Текущая позиция черепашки является первой вершиной многоугольника.

turtle.end_poly()¶

Остановить запись вершин многоугольника. Текущая позиция черепашки – последняя вершина многоугольника. Она будет соединена с первой вершиной.

turtle.get_poly()¶

Возвращает последний записанный многоугольник.

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

turtle.clone()¶

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

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

turtle.getturtle()¶

turtle.getpen()¶

Возвращает сам объект Turtle. Единственное разумное применение – как функция для возврата «анонимной черепашки»:

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

turtle.getscreen()¶

Возвращает объект TurtleScreen, на котором черепаха рисует. Методы TurtleScreen затем можно вызывать для этого объекта.

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

turtle.setundobuffer(size)¶

Параметры:	size – целое число или None

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

>>> turtle.setundobuffer(42)

turtle.undobufferentries()¶

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

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

24.1.3.8. Составные фигуры¶Compound shapes

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

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

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

24.1.4.1. Управление окном¶Window control

turtle.bgcolor(*args)¶

Параметры:	args – строка цвета, три числа в диапазоне от 0 до colormode или кортеж из трёх таких чисел.

Устанавливает или возвращает цвет фона экрана TurtleScreen.

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

turtle.bgpic(picname=None)¶

Параметры:	picname – строка, имя gif-файла, "nopic" или None

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

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

turtle.clear()

turtle.clearscreen()¶

Удаляет все рисунки и всех черепах с TurtleScreen. Сбрасывает теперь пустой TurtleScreen в исходное состояние: белый фон, без фонового изображения, без привязок событий и с включённой трассировкой.

Примечание

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

turtle.reset()

turtle.resetscreen()¶

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

Примечание

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

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

Параметры:	canvwidth – положительное целое, новая ширина холста в пикселях canvheight – положительное целое, новая высота холста в пикселях bg – строка цвета или кортеж цвета, новый цвет фона

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

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

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

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

Параметры:	llx – число, x-координата левого нижнего угла холста lly – число, y-координата левого нижнего угла холста urx – число, x-координата правого верхнего угла холста ury – число, y-координата правого верхнего угла холста

Настраивает пользовательскую систему координат и переключается в режим «world» при необходимости. Это выполняет screen.reset(). Если режим «world» уже активен, все рисунки перерисовываются в соответствии с новыми координатами.

ВНИМАНИЕ: в пользовательских системах координат углы могут отображаться искажёнными.

>>> screen.reset()
>>> screen.setworldcoordinates(-50,-7.5,50,7.5)
>>> for _ in range(72):
...     left(10)
...
>>> for _ in range(8):
...     left(45); fd(2)   # правильный восьмиугольник

24.1.4.2. Управление анимацией¶Animation control

turtle.delay(delay=None)¶

Параметры:	delay – положительное целое

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

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

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

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

Параметры:	n – неотрицательное целое число delay – неотрицательное целое число

Включает/выключает анимацию черепахи и устанавливает задержку для обновления рисунков. Если задан n, реально выполняется только каждое n-е обычное обновление экрана. (Можно использовать для ускорения рисования сложной графики.) При вызове без аргументов возвращает текущее сохранённое значение n. Второй аргумент устанавливает значение задержки (см. delay()).

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

turtle.update()¶

Выполняет обновление TurtleScreen. Используется, когда tracer выключен.

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

24.1.4.3. Использование событий экрана¶Using screen events

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

Устанавливает фокус на TurtleScreen (для сбора событий клавиш). Фиктивные аргументы предусмотрены, чтобы можно было передавать listen() методу onclick.

turtle.onkey(fun, key)¶

turtle.onkeyrelease(fun, key)¶

Параметры:	fun – функция без аргументов или None key – строка: клавиша (например, “a”) или символ клавиши (например, “space”)

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

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

turtle.onkeypress(fun, key=None)¶

Параметры:	fun – функция без аргументов или None key – строка: клавиша (например, “a”) или символ клавиши (например, “space”)

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

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

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

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

Параметры:	fun – функция с двумя аргументами, которая будет вызвана с координатами точки щелчка на холсте num – номер кнопки мыши, по умолчанию 1 (левая кнопка мыши) add – True или False – если True, будет добавлена новая привязка, в противном случае она заменит предыдущую привязку

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

Пример для экземпляра TurtleScreen с именем screen и экземпляра Turtle с именем turtle:

>>> screen.onclick(turtle.goto) # Последующий щелчок по TurtleScreen заставит
>>>                             # черепашку переместиться в точку щелчка.
>>> screen.onclick(None)        # снова удалить привязку события

Примечание

Этот метод TurtleScreen доступен как глобальная функция только под именем onscreenclick. Глобальная функция onclick – это другая функция, производная от метода Turtle onclick.

turtle.ontimer(fun, t=0)¶

Параметры:	fun – функция без аргументов t – число >= 0

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

>>> running = True
>>> def f():
...     if running:
...         fd(50)
...         lt(60)
...         screen.ontimer(f, 250)
>>> f()   ### заставляет черепашку обходить вокруг
>>> running = False

turtle.mainloop()¶

turtle.done()¶

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

>>> screen.mainloop()

24.1.4.4. Методы ввода¶Input methods

turtle.textinput(title, prompt)¶

Параметры:	title – строка prompt – строка

Отображает диалоговое окно для ввода строки. Параметр title (заголовок) задаёт заголовок диалогового окна, параметр prompt (подсказка) – текст, в основном описывающий, какую информацию следует ввести. Возвращает введённую строку. Если диалог отменён, возвращает None.

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

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

Параметры:	title – строка prompt – строка default – число (необязательно) minval – число (необязательно) maxval – число (необязательно)

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 imput, 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)

24.1.4.5. Настройки и специальные методы¶Settings and special methods

turtle.mode(mode=None)¶

Параметры:	mode – одна из строк “standard”, “logo” или “world”

Устанавливает режим черепахи (“standard”, “logo” или “world”) и выполняет сброс. Если режим не задан, возвращается текущий режим.

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

Режим	Начальное направление черепахи	положительные углы
“standard”	вправо (восток)	против часовой стрелки
“logo”	вверх (север)	по часовой стрелке

>>> mode("logo")   # сбрасывает направление черепашки на север
>>> mode()
'logo'

turtle.colormode(cmode=None)¶

Параметры:	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()¶

Возвращает Canvas данного TurtleScreen. Полезно для тех, кто знает, что делать с Canvas из Tkinter.

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

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

24.1.4.6. Методы, специфичные для Screen, не унаследованные от TurtleScreen¶Methods specific to Screen, not inherited from 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.

Параметры:

width – если целое число, размер в пикселях; если число с плавающей запятой, доля экрана; по умолчанию – 50% экрана. height – если целое число, высота в пикселях; если число с плавающей запятой, доля от экрана; по умолчанию 75% экрана startx – если положительное, начальная позиция в пикселях от левого края экрана; если отрицательное – от правого края; если None – центрировать окно по горизонтали. startx – если положительное, начальная позиция в пикселях от верхнего края экрана, если отрицательное – от нижнего края, если None – расположить окно по центру по вертикали.

>>> screen.setup (width=200, height=200, startx=0, starty=0)
>>>              # устанавливает окно размером 200x200 пикселей в верхнем левом углу экрана
>>> screen.setup(width=.75, height=0.5, startx=None, starty=None)
>>>              # устанавливает окно 75% на 50% экрана и центрирует его

turtle.title(titlestring)¶

Параметры:	titlestring – строка, отображаемая в заголовке окна черепашьей графики

Устанавливает заголовок окна черепашки равным titlestring.

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

24.1.6.1. Как пользоваться справкой¶How to use help

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

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

• Вызов help() у методов или функций показывает docstrings:

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

• Docstrings функций, производных от методов, имеют изменённую форму:

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

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

24.1.6.2. Перевод строк документации на разные языки¶Translation of docstrings into different languages

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

turtle.write_docstringdict(filename="turtle_docstringdict")¶

Параметры:	filename – строка, используемая как имя файла

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

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

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

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

24.1.6.3. Как настроить Screen и Turtles¶How to configure Screen and Turtles

Встроенная конфигурация по умолчанию имитирует внешний вид и поведение старого модуля 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().
• shape может быть любой из встроенных форм, например: arrow, turtle и т.д. Для получения дополнительной информации попробуйте help(shape).
• Если вы хотите не использовать цвет заливки (т.е. сделать черепаху прозрачной), нужно написать fillcolor = "" (но все непустые строки не должны содержать кавычек в cfg-файле).
• Если вы хотите отражать состояние черепахи, нужно использовать resizemode = auto.
• Если установить, например, language = italian, то словарь docstringdict turtle_docstringdict_italian.py будет загружен при импорте (если присутствует в пути импорта, например, в той же директории, что и turtle).
• Записи exampleturtle и examplescreen задают имена этих объектов, как они встречаются в строках документации. Преобразование строк документации методов в строки документации функций удалит эти имена из строк документации.
• using_IDLE: установите это в True, если вы регулярно работаете с IDLE и его ключом -n (“без подпроцесса”). Это предотвратит вход exitonclick() в главный цикл.

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

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