Функции модуля turtle

Описание

`forward(distance) | fd(distance)`¶

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

distance — число (целое или дробное)

import turtle
turtle.position() # (0.00, 0.00)
turtle.forward(100)
turtle.position() # (100.00, 0.00)
turtle.fd(50)
turtle.position() # (150.00, 0.00)
turtle.done()

`back(distance) | bk(distance) | backward(distance)`¶

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

distance — число (целое или дробное)

import turtle
turtle.position() # (0.00, 0.00)
turtle.back(50)
turtle.position() # (-50.00, 0.00)
turtle.bk(100)
turtle.position() # (-150.00, 0.00)
turtle.backward(50)
turtle.position() # (-200.00, 0.00)
turtle.done()

`right(angle) | rt(angle)`¶

Поворачивает черепаху направо на указанный угол angle в градусах.

angle — число (целое или дробное)

import turtle
turtle.heading() # 0.0
turtle.right(90)
turtle.heading() # 90.0
turtle.rt(45)
turtle.heading() # 135.0
turtle.done()

`left(angle) | lt(angle)`¶

Поворачивает черепаху налево на указанный угол angle в градусах.

angle — число (целое или дробное)

import turtle
turtle.heading() # 0.0
turtle.left(90)
turtle.heading() # 90.0
turtle.lt(45)
turtle.heading() # 45.0
turtle.done()

`goto(x, y=None) | setpos(x, y=None) | setposition(x, y=None)`¶

Перемещает черепаху в абсолютные координаты x и y. Если перо опущено, рисует линию. Не меняет ориентацию черепахи. Если y равно None, то x должен быть парой координат или Vec2D.

x — число (целое или дробное) или пара координат
y — число или None

import turtle
turtle.position() # (0.00, 0.00)
turtle.goto(100, 100)
turtle.position() # (100.00, 100.00)
turtle.setpos(0, 0)
turtle.position() # (0.00, 0.00)
turtle.setposition(-100, 0)
turtle.position() # (-100.00, 0.00)
turtle.done()

`setx(x)`¶

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

x — число (целое или дробное)

import turtle
turtle.position() # (0.00, 0.00)
turtle.setx(100)
turtle.position() # (100.00, 0.00)
turtle.done()

`sety(y)`¶

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

y — число (целое или дробное)

import turtle
turtle.position() # (0.00, 0.00)
turtle.sety(100)
turtle.position() # (0.00, 100.00)
turtle.done()

`setheading(to_angle) | seth(to_angle)`¶

Устанавливает ориентацию черепахи на угол to_angle.

to_angle — число (целое или дробное)

Вот некоторые общие направления в градусах:

Стандартный режим	Режим logo
0 — восток	0 — север
90 — север	90 — восток
180 — запад	180 — юг
270 — юг	270 — запад

import turtle
turtle.heading() # 0.0
turtle.seth(90)
turtle.heading() # 90.0
turtle.setheading(180)
turtle.heading() # 180.0
turtle.done()

`home()`¶

Перемещает черепаху в начальную позицию (0, 0) и устанавливает ориентацию на восток.

import turtle
turtle.goto(100, 100)
turtle.position() # (100.00, 100.00)
turtle.setheading(90)
turtle.heading() # 90.0
turtle.home()
turtle.position() # (0.00, 0.00)
turtle.heading() # 0.0
turtle.done()

`circle(radius, extent=None, steps=None)`¶

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

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

radius — число (целое или дробное)
extent — число (целое или дробное)
steps — число (целое)

import turtle
turtle.circle(100)
turtle.circle(50, 180)
turtle.circle(-50, 180, 5)
turtle.done()

`dot(size=None, *color)`¶

Рисует точку с диаметром size, используя цвет color. Если size не задан, используется максимум из pensize+4 и 2*pensize.

size — целое число ≥ 1 (если задано)
color — строка цвета или числовой кортеж цвета

import turtle
turtle.home()
turtle.dot()
turtle.fd(50)
turtle.dot(20, "blue")
turtle.fd(50)
turtle.done()

`stamp()`¶

Штампует копию формы черепахи на холсте в текущей позиции. Возвращает stamp_id для этого штампа, который можно использовать для его удаления с помощью clearstamp(stamp_id).

import turtle
turtle.fd(50)
stamp_id = turtle.stamp()
turtle.fd(50)
turtle.done()

`clearstamp(stamp_id)`¶

Удаляет штамп с идентификатором stamp_id.

stamp_id — целое число

import turtle
stamp_id = turtle.stamp()
turtle.fd(500)
turtle.clearstamp(stamp_id)
turtle.done()

`clearstamps(n=None)`¶

Удаляет n последних штампов. Если n не задано, удаляет все штампы.

n — целое число

import turtle
import time

for i in range(8):
    unused_stamp_id = turtle.stamp()
    turtle.fd(30)
time.sleep(1)
turtle.clearstamps(2)
time.sleep(1)
turtle.clearstamps(-2)
time.sleep(1)
turtle.clearstamps()
turtle.done()

`undo()`¶

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

import turtle

for i in range(4):
    turtle.fd(50)
    turtle.lt(80)

for i in range(8):
    turtle.undo()
turtle.done()

`speed(speed=None)`¶

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

speed — число (целое или дробное) или строка

Строки скорости преобразуются в числовые значения скорости следующим образом:

"fastest" — 0
"fast" — 10
"normal"— 6
"slow"— 3
"slowest"— 1

Скорости от 1 до 10 обеспечивают все более быструю анимацию рисования линий и поворота черепахи. Скорость 0 означает, что анимация не происходит. Перемещение вперед/назад заставляет черепаху прыгать, а поворот влево/вправо заставляет черепаху мгновенно поворачиваться.

import turtle
turtle.speed(1)
turtle.fd(100)
turtle.speed("fastest")
turtle.fd(100)
turtle.done()

Текущее состояние черепахи¶

`position() | pos()`¶

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

import turtle
turtle.position() # (0.00, 0.00)

`towords(x, y=None)`¶

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

x — число или пара/вектор чисел или экземпляр черепахи
y — число, если x число, иначе None

import turtle
turtle.goto(10, 10)
turtle.towards(0, 0) # 225.0

`xcor()`¶

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

import turtle
turtle.left(50)
turtle.forward(100)
turtle.xcor() # 64.28

`ycor()`¶

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

import turtle
turtle.left(50)
turtle.forward(100)
turtle.ycor() # 86.60

`heading()`¶

Возвращает текущее направление черепахи в градусах.

import turtle
turtle.left(67)
turtle.heading() # 67.0

`distance(x, y=None)`¶

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

x — число или пара/вектор чисел или экземпляр черепахи
y — число, если x число, иначе None

import turtle
turtle.goto(10, 10)
turtle.distance(0, 0) # 14.14
joe = turtle.Turtle()
joe.forward(77)
turtle.distance(joe) # 67.74

Настройки черепахи¶

`degrees(fullcircle=360.0)`¶

Устанавливает количество градусов в полном круге. По умолчанию это 360 градусов.

fullcircle — число (целое или дробное)

import turtle
turtle.degrees(400)
turtle.circle(125, 100)
turtle.done()

`radians()`¶

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

import turtle
turtle.left(90)
turtle.heading() # 90.0
turtle.radians()
turtle.heading() # 1.5707963267948966

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

`pendown() | pd() | down()`¶

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

`penup() | pu() | up()`¶

Поднимает перо, чтобы черепаха не оставляла след при движении.

`pensize(width=None) | width(width=None)`¶

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

width — число (целое или дробное)

import turtle
turtle.pensize(5)
for i in range(4):
    turtle.fd(100)
    turtle.rt(90)
turtle.done()

`pen(pen=None, **pendict)`¶

pen — словарь с некоторыми или всеми из ниже перечисленных ключей
pendict — один или несколько ключевых аргументов с ниже перечисленными ключами

Возвращает или устанавливает атрибуты пера в «словаре пера» со следующими парами ключ/значение:

"shown": True/False
"pendown": True/False
"pencolor": строка цвета или кортеж цвета
"fillcolor": строка цвета или кортеж цвета
"pensize": положительное число
"speed": число в диапазоне 0.10
"resizemode": "auto" или "user" или "noresize"
"stretchfactor": (положительное число, положительное число)
"outline": положительное число
"tilt": число

Этот словарь можно использовать в качестве аргумента для последующего вызова pen() для восстановления предыдущего состояния пера. Более того, один или несколько из этих атрибутов могут быть предоставлены в качестве ключевых аргументов. Это можно использовать для установки нескольких атрибутов пера в одном операторе.

import turtle

turtle.pen(fillcolor="black", pencolor="red", pensize=10)

pen = turtle.pen()
print(pen['pencolor'])  # 'red'
turtle.done()

`isdown()`¶

Возвращает True, если перо опущено, иначе False.

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

`pencolor(*args)`¶

Устанавливает цвет пера. Если вызывается без аргументов, возвращает текущий цвет пера. Может быть вызван следующими способами:

pencolor(colorstring) — строка цвета (может быть названием цвета или его шестнадцатеричным представлением, например, "red", "#ff0000")
pencolor((r, g, b)) — кортеж цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())
pencolor(r, g, b) — числа цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())

import turtle
turtle.pencolor("red")
turtle.fd(100)
turtle.pencolor((0.5, 0.5, 0.5))
turtle.fd(100)
turtle.pencolor(0, 0, 1)
turtle.fd(100)
turtle.done()

`fillcolor(*args)`¶

Устанавливает цвет заливки. Если вызывается без аргументов, возвращает текущий цвет заливки. Может быть вызван следующими способами:

fillcolor(colorstring) — строка цвета (может быть названием цвета или его шестнадцатеричным представлением, например, "red", "#ff0000")
fillcolor((r, g, b)) — кортеж цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())
fillcolor(r, g, b) — числа цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())

import turtle
turtle.fillcolor("#ff00ff")
turtle.begin_fill()
for i in range(4):
    turtle.fd(100)
    turtle.rt(90)
turtle.end_fill()
turtle.done()

`color(*args)`¶

Устанавливает цвет пера и цвет заливки. Если вызывается без аргументов, возвращает текущий цвет пера и цвет заливки. Может быть вызван следующими способами:

color() — возвращает текущий цвет пера и цвет заливки в виде пары строк или кортежей цветов, как возвращают pencolor() и fillcolor()
color(colorstring), color((r, g, b)), color(r, g, b) — устанавливает и цвет пера, и цвет заливки в одинаковое значение. Аргументы такие же, как и для pencolor() и fillcolor()
color(colorstring1, colorstring2), color((r1, g1, b1), (r2, g2, b2)) — устанавливает цвет пера и цвет заливки. Аргументы такие же, как и для pencolor() и fillcolor()

import turtle
turtle.color("red", "green")
turtle.begin_fill()
for i in range(4):
    turtle.fd(100)
    turtle.rt(90)
turtle.end_fill()
turtle.done()

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

`filling()`¶

Возвращает True, если черепаха находится в режиме заливки, иначе False.

`begin_fill()`¶

Начинает заливку фигуры, которую рисует черепаха.

`end_fill()`¶

Заливает фигуру, нарисованную после последнего вызова begin_fill().

import turtle
turtle.fillcolor("yellow")
turtle.begin_fill()
for i in range(6):
    turtle.fd(100)
    turtle.rt(60)
turtle.end_fill()
turtle.done()

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

`reset()`¶

Сбрасывает черепаху в начальное состояние, удаляя все нарисованные линии и сбрасывая все настройки черепахи.

import turtle
turtle.color("red")
for i in range(8):
    turtle.fd(100)
    turtle.rt(130)
turtle.reset()
turtle.done()

`clear()`¶

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

import turtle
turtle.color("red")
for i in range(8):
    turtle.fd(100)
    turtle.rt(130)
turtle.clear()
turtle.done()

`write(arg, move=False, align='left', font=('Arial', 8, 'normal'))`¶

Выводит текст на экран в текущей позиции черепахи. Если move равно True, то черепаха перемещается курсором вправо после вывода текста.

arg — строка
move — логическое значение
align — строка, одна из: "left", "center", "right"
font — кортеж, содержащий три значения: имя шрифта, размер шрифта и стиль шрифта

import turtle
for i in range(5):
    turtle.fd(i * 20)
    turtle.left(115)
turtle.write("Hello, world!", move=True, align="left", font=("Arial", 16, "normal"))
turtle.done()

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

`hideturtle() | ht()`¶

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

`showturtle() | st()`¶

Показывает черепаху.

`isvisible()`¶

Возвращает True, если черепаха видима, иначе False.

`shape(name=None)`¶

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

name — строка, одна из: "arrow", "turtle", "circle", "square", "triangle", "classic"

import turtle

for shape in ["arrow", "turtle", "circle", "square", "triangle", "classic"]:
    turtle.shape(shape)
    turtle.fd(150)
    turtle.rt(60)
    turtle.stamp()
turtle.done()

`resizemode(rmode=None)`¶

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

"auto" — размер изменяется автоматически при изменении формы черепахи
"user" — размер изменяется только при вызове turtlesize()
"noresize" — размер не изменяется

`shapesize(stretch_wid=None, stretch_len=None, outline=None)`
`turtlesize(stretch_wid=None, stretch_len=None, outline=None)`¶

Возвращает или устанавливает коэффициенты растяжения черепахи по x/y и/или контур. Устанавливает resizemode в "user". Только если режим изменения размера установлен в "user", черепаха будет отображаться растянутой в соответствии с ее коэффициентами растяжения: stretch_wid — коэффициент растяжения перпендикулярно ее ориентации, stretch_len — коэффициент растяжения в направлении ее ориентации, outline — определяет ширину контура фигуры.

stretch_wid — положительное число
stretch_len — положительное число
outline — положительное число

import turtle
turtle.shapesize() # (1.0, 1.0, 1)
turtle.shapesize(2, 5, 1)

turtle.done()

`shearfactor(shear=None)`¶

Устанавливает или возвращает коэффициент сдвига черепахи. Сдвигает форму черепахи в соответствии с заданным коэффициентом сдвига shear, который является тангенсом угла сдвига. Не изменяет направление движения черепахи. Если shear не задан: возвращает текущий коэффициент сдвига, т. е. тангенс угла сдвига, на который сдвигаются линии, параллельные направлению движения черепахи.

shear — число

import turtle
turtle.speed("slowest")
turtle.shearfactor(0.8)

for i in range(5):
    turtle.fd(100)
    turtle.rt(72)
turtle.done()

`tilt(tilt=None)`¶

Поворачивает форму черепахи на угол tilt в градусах относительно текущего угла наклона. Не изменяет направление движения черепахи. Если tilt не задан, возвращает текущий угол наклона.

tilt — число

import turtle
turtle.speed("slowest")
turtle.tilt(45)
turtle.fd(100)
turtle.tilt(45)
turtle.fd(100)
turtle.done()

`tiltangle(angle=None)`¶

Устанавливает или возвращает текущий угол наклона черепахи. Если angle задан, поворачивает форму черепахи на угол angle в градусах безотносительно текущего угла наклона. Не изменяет направление движения черепахи. Если angle не задан, возвращает текущий угол наклона, т. е. угол между ориентацией формы черепахи и направлением движения черепахи.

angle — число

import turtle
turtle.speed("slowest")
turtle.tiltangle(45)
turtle.fd(100)
turtle.tiltangle(45)
turtle.fd(100)
turtle.done()

`shapetransform(t11=None, t12=None, t21=None, t22=None)`¶

Возвращает или устанавливает матрицу трансформации черепахи.

t11, t12, t21, t22 — числа

Если не передано ни одного элемента матрицы, возвращает матрицу трансформации в виде кортежа из 4 элементов. В противном случае устанавливает переданные элементы и трансформирует форму черепахи в соответствии с матрицей, состоящей из первой строки t11, t12 и второй строки t21, t22. Определитель t11 * t22 - t12 * t21 не должен быть равен нулю, иначе возникает ошибка. Изменяет коэффициенты растяжения, коэффициенты сдвига и угол наклона в соответствии с заданной матрицей.

import turtle

turtle.shapesize(2, 2, 2)
turtle.shapetransform(1, 0.5, 0, 1)
turtle.done()

`get_shapepoly()`¶

Возвращает текущий многоугольник формы черепахи в виде кортежа координатных пар. Это можно использовать для определения новой формы или компонентов составной формы.

import turtle

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

События¶

`onclick(fun, btn=1, add=None)`¶

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

fun — функция, с двумя аргументами: координаты x и y курсора, которая будет вызвана при клике на черепаху
btn — номер кнопки мыши, которая вызывает функцию, по умолчанию 1 (левая кнопка)
add — логическое значение, определяющее, добавлять ли новую функцию к уже существующим функциям-обработчикам или заменять их

import turtle

def handler(x, y):
    print(f"Clicked at {x}, {y}")

turtle.onclick(handler)
turtle.done()

`onrelease(fun, btn=1, add=None)`¶

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

fun — функция, с двумя аргументами: координаты x и y курсора, которая будет вызвана при отпускании кнопки мыши на черепахе
btn — номер кнопки мыши, которая вызывает функцию, по умолчанию 1 (левая кнопка)
add — логическое значение, определяющее, добавлять ли новую функцию к уже существующим функциям-обработчикам или заменять их

import turtle

def handler(x, y):
    print(f"Released at {x}, {y}")

turtle.onrelease(handler)
turtle.done()

`ondrag(fun, btn=1, add=None)`¶

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

fun — функция, с двумя аргументами: координаты x и y курсора, которая будет вызвана при перетаскивании черепахи мышью
btn — номер кнопки мыши, которая вызывает функцию, по умолчанию 1 (левая кнопка)
add — логическое значение, определяющее, добавлять ли новую функцию к уже существующим функциям-обработчикам или заменять их

import turtle

def handler(x, y):
    turtle.goto(x, y)

turtle.ondrag(handler)
turtle.done()

Специальные методы¶

`begin_poly()`¶

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

`end_poly()`¶

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

`get_poly()`¶

Возвращает текущий многоугольник, записанный с помощью begin_poly() и end_poly().

import turtle

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

`clone()`¶

Создает и возвращает копию черепахи.

import turtle

nick = turtle.Turtle()
nick.color("red")

joe = nick.clone()

nick.fd(100)
joe.rt(90)
turtle.done()

`getturtle() | getpen()`¶

Возвращает объект черепахи. Используется для получения ссылки на черепаху, если она была создана без присвоения переменной (анонимная черепаха).

import turtle

t = turtle.getturtle()
t.color("red")
turtle.done()

`getscreen()`¶

Возвращает объект экрана черепахи TurtleScreen на котором она находится.

import turtle
screen = turtle.getscreen()
screen.bgcolor("lightblue")
turtle.done()

`setundobuffer(size)`¶

Устанавливает размер буфера отмены. По умолчанию размер равен 1000.

size — целое число

`undobufferentries()`¶

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

import turtle

for i in range(8):
    turtle.fd(50)
    turtle.lt(80)


while turtle.undobufferentries():
    print(turtle.undobufferentries())
    turtle.undo()
turtle.done()

Составные формы¶

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

Создайте пустой объект Shape типа compound.
Добавьте столько компонентов, сколько нужно, используя метод addcomponent().
Зарегистрируйте форму с помощью метода register_shape() и используйте ее.

import turtle
 
s = turtle.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")
turtle.register_shape("myshape", s)
turtle.shape("myshape")
turtle.done()

Методы TurtleScreen/Screen и соответствующие функции¶

Большинство примеров в этом разделе относятся к экземпляру TurtleScreen с именем screen. При использовании функций вместо методов, экземпляр TurtleScreen не указывается явно. Также можно использовать экземпляр TurtleScreen, полученный с помощью turtle.getscreen().

`bgcolor(*args)`¶

Устанавливает цвет фона экрана. Если вызывается без аргументов, возвращает текущий цвет фона. Может быть вызван следующими способами:

bgcolor(colorstring) — строка цвета (может быть названием цвета или его шестнадцатеричным представлением, например, "red", "#ff0000")
bgcolor((r, g, b)) — кортеж цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())
bgcolor(r, g, b) — числа цвета. Каждый из r, g и b должен быть в диапазоне 0.1 или 0.255, в зависимости от режима цвета (см. colormode())

import turtle
screen = turtle.getscreen()
screen.bgcolor("lightblue")
turtle.done()

`bgpic(picname=None)`¶

Устанавливает или возвращает фоновое изображение экрана. Если picname не задано, возвращает текущее фоновое изображение.

picname — строка, путь к файлу изображения

import turtle
turtle.bgpic("landscape.gif")
turtle.done()

`clear()`¶

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

import turtle
turtle.clearscreen() # эквивалентно turtle.getscreen().clear()

`clearscreen()`¶

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

`reset()`¶

Это метод доступен только как глобальная функция под именем resetscreen. Глобальная функция reset — это функция черепахи reset.

`resetscreen()`¶

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

import turtle
turtle.resetscreen() # эквивалентно turtle.getscreen().reset()

`screensize(canvwidth=None, canvheight=None, bg=None)`¶

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

canvwidth — положительное число
canvheight — положительное число
bg — строка, цвет фона холста

Функции модуля turtle

forward(distance) | fd(distance)¶

back(distance) | bk(distance) | backward(distance)¶

right(angle) | rt(angle)¶

left(angle) | lt(angle)¶

goto(x, y=None) | setpos(x, y=None) | setposition(x, y=None)¶

setx(x)¶

sety(y)¶

setheading(to_angle) | seth(to_angle)¶

home()¶

circle(radius, extent=None, steps=None)¶

dot(size=None, *color)¶

stamp()¶

clearstamp(stamp_id)¶

clearstamps(n=None)¶

undo()¶

speed(speed=None)¶

Текущее состояние черепахи¶

position() | pos()¶

towords(x, y=None)¶

xcor()¶

ycor()¶

heading()¶

distance(x, y=None)¶

Настройки черепахи¶

degrees(fullcircle=360.0)¶

radians()¶

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

pendown() | pd() | down()¶

penup() | pu() | up()¶

pensize(width=None) | width(width=None)¶

pen(pen=None, **pendict)¶

isdown()¶

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

pencolor(*args)¶

fillcolor(*args)¶

color(*args)¶

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

filling()¶

begin_fill()¶

end_fill()¶

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

reset()¶

clear()¶

write(arg, move=False, align='left', font=('Arial', 8, 'normal'))¶

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

hideturtle() | ht()¶

showturtle() | st()¶

isvisible()¶

shape(name=None)¶

resizemode(rmode=None)¶

shapesize(stretch_wid=None, stretch_len=None, outline=None)turtlesize(stretch_wid=None, stretch_len=None, outline=None)¶

shearfactor(shear=None)¶

tilt(tilt=None)¶

tiltangle(angle=None)¶

shapetransform(t11=None, t12=None, t21=None, t22=None)¶

get_shapepoly()¶

События¶

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

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

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

Специальные методы¶

begin_poly()¶

end_poly()¶

get_poly()¶

clone()¶

getturtle() | getpen()¶

getscreen()¶

setundobuffer(size)¶

undobufferentries()¶

Составные формы¶

Методы TurtleScreen/Screen и соответствующие функции¶

bgcolor(*args)¶

bgpic(picname=None)¶

clear()¶

clearscreen()¶

reset()¶

resetscreen()¶

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

`forward(distance) | fd(distance)`¶

`back(distance) | bk(distance) | backward(distance)`¶

`right(angle) | rt(angle)`¶

`left(angle) | lt(angle)`¶

`goto(x, y=None) | setpos(x, y=None) | setposition(x, y=None)`¶

`setx(x)`¶

`sety(y)`¶

`setheading(to_angle) | seth(to_angle)`¶

`home()`¶

`circle(radius, extent=None, steps=None)`¶

`dot(size=None, *color)`¶

`stamp()`¶

`clearstamp(stamp_id)`¶

`clearstamps(n=None)`¶

`undo()`¶

`speed(speed=None)`¶

`position() | pos()`¶

`towords(x, y=None)`¶

`xcor()`¶

`ycor()`¶

`heading()`¶

`distance(x, y=None)`¶

`degrees(fullcircle=360.0)`¶

`radians()`¶

`pendown() | pd() | down()`¶

`penup() | pu() | up()`¶

`pensize(width=None) | width(width=None)`¶

`pen(pen=None, **pendict)`¶

`isdown()`¶

`pencolor(*args)`¶

`fillcolor(*args)`¶

`color(*args)`¶

`filling()`¶

`begin_fill()`¶

`end_fill()`¶

`reset()`¶

`clear()`¶

`write(arg, move=False, align='left', font=('Arial', 8, 'normal'))`¶

`hideturtle() | ht()`¶

`showturtle() | st()`¶

`isvisible()`¶

`shape(name=None)`¶

`resizemode(rmode=None)`¶

`shapesize(stretch_wid=None, stretch_len=None, outline=None)`
`turtlesize(stretch_wid=None, stretch_len=None, outline=None)`¶

`shearfactor(shear=None)`¶

`tilt(tilt=None)`¶

`tiltangle(angle=None)`¶

`shapetransform(t11=None, t12=None, t21=None, t22=None)`¶

`get_shapepoly()`¶

`onclick(fun, btn=1, add=None)`¶

`onrelease(fun, btn=1, add=None)`¶

`ondrag(fun, btn=1, add=None)`¶

`begin_poly()`¶

`end_poly()`¶

`get_poly()`¶

`clone()`¶

`getturtle() | getpen()`¶

`getscreen()`¶

`setundobuffer(size)`¶

`undobufferentries()`¶

`bgcolor(*args)`¶

`bgpic(picname=None)`¶

`clear()`¶

`clearscreen()`¶

`reset()`¶

`resetscreen()`¶

`screensize(canvwidth=None, canvheight=None, bg=None)`¶