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

Запуск среды черепашки¶Starting a turtle environment

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

from turtle import *

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

Основы рисования¶Basic drawing

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

forward(100)

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

left(120)

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

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

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

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

home()

pos()

clearscreen()

Создание алгоритмических узоров¶Making algorithmic patterns

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

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

– которые, конечно, ограничены только воображением!

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

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

Начать как можно быстрее¶Get started as quickly as possible

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

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

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

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

Использовать пространство имён модуля turtle¶Use the turtle module namespace

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

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

Использовать черепашью графику в скрипте¶Use turtle graphics in a script

Рекомендуется использовать пространство имён модуля 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 закроет окно черепашки. Добавьте:

t.mainloop()

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

Использовать объектно-ориентированную черепашью графику¶Use object-oriented turtle graphics

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

В этом подходе различные команды черепашки являются методами объектов (в основном объектов 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; он создаётся автоматически вместе с черепашкой.

Экран черепашки можно настроить, например:

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

Методы черепахи¶Turtle methods

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

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

forward() | fd()

backward() | bk() | back()

right() | rt()

left() | lt()

goto() | setpos() | setposition()

teleport()

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

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

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

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

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

bye()

exitonclick()

setup()

title()

Движение черепахи¶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.teleport(x, y=None, *, fill_gap=False)¶

Параметры:

• x – число или None

• y – число или None

• fill_gap – логическое значение

Перемещает черепаху в абсолютную позицию. В отличие от goto(x, y), линия не рисуется. Направление черепахи не меняется. Если в данный момент выполняется заливка, многоугольник(и), из которого телепортировали, будут залиты после выхода, и заливка начнется снова после телепортации. Это можно отключить с помощью fill_gap=True, что делает воображаемую линию, пройденную во время телепортации, барьером заливки, как в goto(x, y).

>>> tp = turtle.pos()
>>> tp
(0.00,0.00)
>>> turtle.teleport(60)
>>> turtle.pos()
(60.00,0.00)
>>> turtle.teleport(y=10)
>>> turtle.pos()
(60.00,10.00)
>>> turtle.teleport(20, 30)
>>> turtle.pos()
(20.00,30.00)

Добавлено в версии 3.12.

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")
>>> stamp_id = turtle.stamp()
>>> 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):
...     unused_stamp_id = turtle.stamp()
...     turtle.fd(30)
>>> 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

Состояние черепашки¶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

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

turtle.degrees(fullcircle=360.0)¶

Параметры:

fullcircle – число

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

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

>>> # Изменить единицу измерения угла на град (также известный как гон,
>>> # град, или градиан, и равная 1/100 прямого угла.)
>>> 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

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

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

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

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

Параметры:

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

• btn – номер кнопки мыши, по умолчанию 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 – функция с двумя аргументами, которая будет вызвана с координатами точки щелчка на холсте

• 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)     # нажатие на черепашку меняет цвет заливки на красный,
>>> turtle.onrelease(turtle.unglow) # отпускание делает его прозрачным.

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

Параметры:

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

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

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

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

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

>>> turtle.ondrag(turtle.goto)

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

Специальные методы черепашки¶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()

Составные фигуры¶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")
   

Управление окном¶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()

Примечание

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

turtle.clearscreen()¶

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

turtle.reset()

Примечание

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

turtle.resetscreen()¶

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

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)   # правильный восьмиугольник

Управление анимацией¶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 выключен.

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

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

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

Методы ввода¶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 – число (необязательно)

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

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

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

turtle.mode(mode=None)¶

Параметры:

mode – одна из строк “standard”, “logo” или “world”

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

Режим “standard” совместим со старой turtle. Режим “logo” совместим с большинством черепашьих графических средств Logo. Режим “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 ...>

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¶Methods specific to Screen, not inherited from TurtleScreen

turtle.bye()¶

Закрывает окно графики черепашки.

turtle.exitonclick()¶

Привязывает метод bye() к щелчкам мыши на экране.

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

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

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

Параметры:

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

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

• startx – если положительное, начальная позиция в пикселях от левого края экрана; если отрицательное – от правого края; если None, окно центрируется по горизонтали

• starty – если положительное, начальная позиция в пикселях от верхнего края экрана; если отрицательное – от нижнего края; если 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!")

Как пользоваться справкой¶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 создаются автоматически вместе с определениями функций, которые производятся от методов во время импорта.

Перевод docstrings на разные языки¶Translation of docstrings into different languages

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

turtle.write_docstringdict(filename='turtle_docstringdict')¶

Параметры:

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

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

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

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

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

Как настроить 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, то словарь строк документации turtle_docstringdict_italian.py будет загружен во время импорта (если он присутствует в пути импорта, например, в той же директории, что и turtle).

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

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

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

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