turtle — Черепашья графика¶

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

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

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

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

Методы TurtleScreen/Экран¶

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

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

Нарисовать круг с заданным радиусом. Центр находится на радиус единиц левее черепахи; extent – угол – определяет, какая часть окружности будет нарисована. Если extent не задан, рисуется вся окружность. Если extent не является полной окружностью, то одной из конечных точек дуги будет текущая позиция пера. Если радиус положителен, дуга рисуется против часовой стрелки, в противном случае - по часовой стрелке. Наконец, направление черепашки изменяется на величину 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)  # draw a semicircle
>>> turtle.position()
(0.00,240.00)
>>> turtle.heading()
180.0

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

Parameters

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

Штампует копию фигуры черепахи на холсте в текущей позиции черепахи. Возвращает 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 – число или пара/вектор чисел или экземпляр черепахи

• 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 – число или пара/вектор чисел или экземпляр черепахи

• 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 - целое число, то устанавливается пустой undobuffer заданного размера. size задает максимальное количество действий черепашки, которые могут быть отменены методом/функцией undo(). Если size равен None, undobuffer отключается.

>>> turtle.setundobuffer(42)

turtle.undobufferentries()¶

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

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

Составные фигуры¶

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

1. Создайте пустой объект Shape типа «составной».

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 кортежа таких чисел

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

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

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

turtle.reset()

Примечание

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

turtle.resetscreen()¶

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

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

Parameters

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

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

• bg – colorstring или color-tuple, новый цвет фона

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

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

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

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

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

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

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

turtle.onkey(fun, key)¶

turtle.onkeyrelease(fun, key)¶

Parameters

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

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

Привязка fun к событию key-release клавиши. Если fun равно None, привязка к событию снимается. Замечание: чтобы иметь возможность регистрировать события нажатия клавиш, TurtleScreen должен иметь фокус. (См. метод 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

Установите таймер, который вызывает fun через 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. Должен быть последним утверждением в программе черепашьей графики. Не должно не использоваться, если скрипт запускается из IDLE в режиме -n (No subprocess) - для интерактивного использования черепашьей графики.

>>> screen.mainloop()

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

turtle.textinput(title, prompt)¶

Parameters

• title – строка

• prompt – строка

Вызывает диалоговое окно для ввода строки. Параметр 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 – число (необязательно)

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

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

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

turtle.mode(mode=None)¶

Parameters

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

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

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

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

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

turtle.colormode(cmode=None)¶

Parameters

cmode – одно из значений 1.0 или 255

Возвращает colormode или устанавливает его в 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. Полезно для инсайдеров, которые знают, что делать с Tkinter Canvas.

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

turtle.getshapes()¶

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

>>> screen.getshapes()
['arrow', 'blank', 'circle', ..., 'turtle']

turtle.register_shape(name, shape=None)¶

turtle.addshape(name, shape=None)¶

Существует три различных способа вызова этой функции:

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 – строка, которая отображается в строке заголовка графического окна черепахи

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

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

Как пользоваться помощью¶

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

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

• Вызов 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()
  

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

  >>> 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 с заданным именем файла. Эта функция должна быть вызвана явно (она не используется графическими классами черепахи). Словарь docstring будет записан в Python-скрипт filename.py. Он предназначен для использования в качестве шаблона для перевода doc-строк на различные языки.

Если вы (или ваши студенты) хотите использовать 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().

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

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

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

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

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

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

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

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