turtle
— Gráficos con Turtle¶
Código fuente: Lib/turtle.py
Introducción¶
Gráficas Turtle es una forma muy habitual de introducción a la programación para niñas y niños. Era parte original del lenguaje de programación Logo, desarrollado por Wally Feurzeig, Seymour Papert y Cynthia Solomon en 1967.
Imagina una tortuga robot que empieza en las coordenadas (0, 0) en un plano x-y. Después de un import turtle
, dele el comando turtle.forward(15)
, y se mueve (¡en la pantalla!) 15 pixeles en la dirección en la que se encuentra, dibujando una línea mientras se mueve. Dele el comando turtle.right(25)
, y rotará en el lugar, 25 grados, en sentido horario.
Al combinar estos comandos y otros similares, se pueden dibujar figuras intrincadas y formas.
El módulo turtle
es una reimplementación extendida del mismo módulo de la distribución estándar Python hasta la versión 2.5.
Trata de mantener los méritos del viejo módulo y ser (casi) 100% compatible con él. Esto implica en primer lugar, habilitar al programador que está aprendiendo, el uso de todos los comandos, clases y métodos de forma interactiva cuando usa el módulo desde el IDLE ejecutado con la opción -n
.
El módulo turtle provee las primitivas gráficas, tanto en orientación procedimental como orientada a objetos. Como usa el módulo tkinter
para las gráficas subyacentes, necesita tener instalada una versión de Python con soporte TK.
La interface orientada a objetos usa esencialmente clases dos+dos:
La clase
TurtleScreen
define una ventana gráfica como base para las tortugas dibujantes. Su constructor necesita una clasetkinter.Canvas
o una aScrolledCanvas
como argumento. Se debe usar cuandoturtle
es usado como parte de una aplicación.La función
Screen()
devuelve un objeto singleton de la subclaseTurtleScreen
. Esta función debe utilizarse cuandoturtle
se usa como una herramienta independiente para hacer gráficos. Siendo un objeto singleton, no es posible que tenga herencias de su clase.Todos los métodos de TurtleScreen/Screen también existen como funciones. Por ejemplo. como parte de la interface orientada a procedimientos.
RawTurtle
(alias:RawPen
) Define los objetos Turtle con los cuales dibujar con la claseTurtleScreen
. Su constructor necesita como argumento un Canvas, ScrolledCanvas o TurtleScreen, así el objeto RawTurtle sabe donde dibujar.Derivada de RawTurtle está la subclase
Turtle
(alias:Pen
), que dibuja en «la» instanciaScreen
que se crea automáticamente, si no está presente.Todos los métodos de RawTurtle/Turtle también existen como funciones. Por ejemplo, como parte de la interface orientada a procedimientos.
La interface procedimental provee funciones que son derivadas de los métodos de las clases Screen
y Turtle
. Tienen los mismos nombres que los métodos correspondientes. Un objeto Screen es creado automáticamente cada vez que una función derivada de un método Screen es llamado. Un objeto Turtle (innombrado) se crea automáticamente cada vez que se llama a una función derivada de un método Turtle.
Para usar varias tortugas en una pantalla se tiene que usar la interface orientada a objetos.
Nota
En la siguiente documentación se proporciona la listas de argumentos para las funciones. Los métodos, por su puesto, tienen el argumento principal adicional self que se omite aquí.
Reseña de los métodos disponibles para Turtle y Screen¶
Métodos Turtle¶
- Movimiento de Turtle
- Mover y dibujar
- Mostrar el estado de la tortuga
- Ajuste y unidades de medida
- Control del lápiz
- Estado de dibujo
- Control del color
- Relleno
- Más controles de dibujo
- Estado de la Tortuga
- Visibilidad
- Apariencia
- Usando eventos
- Métodos especiales de Turtle
Métodos de TurtleScreen/Screen¶
- Control de ventana
- Control de animación
- Usando eventos de pantalla
- Configuración y métodos especiales
- Métodos de entrada
- Métodos específicos para Screen
Métodos de RawTurtle/Turtle Y sus correspondientes funciones¶
Casi todos los ejemplos de esta sección se refieren a una instancia Turtle llamada turtle
.
Movimiento de Turtle¶
-
turtle.
forward
(distance)¶ -
turtle.
fd
(distance)¶ - Parámetros
distance – un número (entero o flotante)
Mover hacia adelante la tortuga la ditance especificada, en la dirección en la que la tortuga apunta.
>>> 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)¶ - Parámetros
distance – un número
Mover hacia atrás la tortuga la distance especificada, opuesta a la dirección en que la tortuga apunta. No cambia la dirección de la tortuga.
>>> turtle.position() (0.00,0.00) >>> turtle.backward(30) >>> turtle.position() (-30.00,0.00)
-
turtle.
right
(angle)¶ -
turtle.
rt
(angle)¶ - Parámetros
angle – un número (entero o flotante)
Gira la tortuga a la derecha tomando los angle como unidad de medida. (La unidad de medida por defecto son los grado, pero se puede configurar a través de las funciones
degrees()
yradians()
.) La orientación de los ángulos depende del modo en que está la tortuga, vermode()
.>>> turtle.heading() 22.0 >>> turtle.right(45) >>> turtle.heading() 337.0
-
turtle.
left
(angle)¶ -
turtle.
lt
(angle)¶ - Parámetros
angle – un número (entero o flotante)
Gira la tortuga a la izquierda tomando los ángulos como unidad de medida. (La unidad de medida por defecto son los grado, pero se puede configurar a través de las funciones
degrees()
yradians()
.) La orientación de los ángulos depende del modo en que está la tortuga, vermode()
.>>> 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)¶ - Parámetros
x – un número o un par/vector de números
y – un número o
None
Si y es
None
, x debe ser un par de coordenadas o unVec2D
(ejemplo: según lo devuelto porpos()
).Mueve la tortuga a una posición absoluta. Si el lápiz está bajo, traza una linea. No cambia la orientación de la tortuga.
>>> 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)¶ - Parámetros
x – un número (entero o flotante)
Establece la primera coordenada de la tortuga a x, deja la segunda coordenada sin cambios.
>>> turtle.position() (0.00,240.00) >>> turtle.setx(10) >>> turtle.position() (10.00,240.00)
-
turtle.
sety
(y)¶ - Parámetros
y – un número (entero o flotante)
Establece la segunda coordenada de la tortuga a y, deja la primera coordenada sin cambios.
>>> turtle.position() (0.00,40.00) >>> turtle.sety(-10) >>> turtle.position() (0.00,-10.00)
-
turtle.
setheading
(to_angle)¶ -
turtle.
seth
(to_angle)¶ - Parámetros
to_angle – un número (entero o flotante)
Establece la orientación de la tortuga a to_angle. Aquí hay algunas direcciones comunes en grados:
modo estándar
modo logo
0 - este
0 - norte
90 - norte
90 - este
180 - oeste
180 - sur
270 - sur
270 - oeste
>>> turtle.setheading(90) >>> turtle.heading() 90.0
-
turtle.
home
()¶ Mueve la tortuga al origen – coordenadas (0,0) – y establece la orientación a la orientación original (que depende del modo, ver
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)¶ - Parámetros
radius – un número
extent – un número (o
None
)steps – un entero (o
None
)
Dibuja un círculo con el radius (radio) dado. El centro es radius unidades a la izquierda de la tortuga; extent – un ángulo – determina que parte del círculo se dibuja. Si no se pasa extent, dibuja el círculo entero. Si extent no es un círculo completo, un punto final del arco es la posición actual de lápiz. Dibuja el arco en dirección antihorario si radius es positivo, si no en dirección horaria. Finalmente la dirección de la tortuga es modificada por el aumento de extent.
Como el círculo se aproxima a un polígono regular inscripto, steps determina el número de pasos a usar. Si no se da, será calculado automáticamente. Puede ser usado para dibujar polígonos regulares.
>>> 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)¶ - Parámetros
size – un entero >= 1 (si se da)
color – un colorstring o una tupla numérica de color
Dibuja un punto circular con diámetro size, usando color. Si size no se da, el máximo de pensize+4 y 2*pensize es usado.
>>> 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
()¶ Estampa una copia de la forma de la tortuga en el lienzo en la posición actual. Devuelve un stamp_id por cada estampa, que puede ser usado para borrarlo al llamar
clearstamp(stamp_id)
.>>> turtle.color("blue") >>> turtle.stamp() 11 >>> turtle.fd(50)
-
turtle.
clearstamp
(stampid)¶ - Parámetros
stampid – un entero, debe devolver el valor de la llamada previa de la función
stamp()
call
Borra la estampa con el stampid dado.
>>> 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)¶ - Parámetros
n – un entero (o
None
)
Borra todas o las primeros/últimos n estampas de la tortuga. Si n es
None
, borra todas las estampas, Si n > 0 borra la primera estampa n, sino y n < 0 borra la última estampa 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
()¶ Deshace (repetidamente) la(s) última(s) acción(es) de la tortuga. El número de acciones a deshacer es determinado por el tamaño del undobuffer.
>>> for i in range(4): ... turtle.fd(50); turtle.lt(80) ... >>> for i in range(8): ... turtle.undo()
-
turtle.
speed
(speed=None)¶ - Parámetros
speed – un entero en el rango 0..10 o un speedstring (ver abajo)
Establecer la velocidad de la tortuga a un valor entero en el rango 0..10. Si no se pasa ningún argumento, vuelve a la velocidad actual.
Si el parámetro de entrada es un número mayor que 10 o menor que 0.5, la velocidad se establece a 0. La frase acerca de la velocidad es mapeada a valores de velocidad de la siguiente manera:
«fastest»: 0
«fast»: 10
«normal»: 6
«slow»: 3
«slowest»: 1
Velocidades de 1 a 10 generan una animación cada vez más rápida al dibujar las líneas y en el giro de la tortuga.
Atención: speed = 0 implica que no habrá ninguna animación. Los métodos fordward/back harán que la tortuga salte, de la misma manera que left/right hará que la tortuga gire instantáneamente.
>>> turtle.speed() 3 >>> turtle.speed('normal') >>> turtle.speed() 6 >>> turtle.speed(9) >>> turtle.speed() 9
Mostrar el estado de la tortuga¶
-
turtle.
position
()¶ -
turtle.
pos
()¶ Devuelve la posición actual de la tortuga (x,y) (como un vector
Vec2D
)>>> turtle.pos() (440.00,-0.00)
-
turtle.
towards
(x, y=None)¶ - Parámetros
x – un número o par de vectores numéricos o una instancia de la tortuga
y – un número si x es un número, si no
None
Return the angle between the line from turtle position to position specified by (x,y), the vector or the other turtle. This depends on the turtle’s start orientation which depends on the mode - «standard»/»world» or «logo».
>>> turtle.goto(10, 10) >>> turtle.towards(0,0) 225.0
-
turtle.
xcor
()¶ Devuelve la coordinada x de la tortuga.
>>> turtle.home() >>> turtle.left(50) >>> turtle.forward(100) >>> turtle.pos() (64.28,76.60) >>> print(round(turtle.xcor(), 5)) 64.27876
-
turtle.
ycor
()¶ Devuelve la coordenada y de la tortuga.
>>> turtle.home() >>> turtle.left(60) >>> turtle.forward(100) >>> print(turtle.pos()) (50.00,86.60) >>> print(round(turtle.ycor(), 5)) 86.60254
-
turtle.
heading
()¶ Devuelve la orientación actual de la tortuga (el valor depende del modo de la tortuga, ver
mode()
).>>> turtle.home() >>> turtle.left(67) >>> turtle.heading() 67.0
-
turtle.
distance
(x, y=None)¶ - Parámetros
x – un número o par de vectores numéricos o una instancia de la tortuga
y – un número si x es un número, si no
None
Devuelve la distancia desde la tortuga al vector (x,y) dado, otra instancia de la tortuga, el valor es unidad pasos de tortuga.
>>> turtle.home() >>> turtle.distance(30,40) 50.0 >>> turtle.distance((30,40)) 50.0 >>> joe = Turtle() >>> joe.forward(77) >>> turtle.distance(joe) 77.0
Configuración de las medidas¶
-
turtle.
degrees
(fullcircle=360.0)¶ - Parámetros
fullcircle – un número
Establece la unidad de medida del ángulo, por ejemplo establece el número de «grados» para un círculo completo. El valor por defecto es 36 grados.
>>> 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
()¶ Establece la unidad de medida del ángulo a radianes. Equivalente a
degrees(2*math.pi)
.>>> turtle.home() >>> turtle.left(90) >>> turtle.heading() 90.0 >>> turtle.radians() >>> turtle.heading() 1.5707963267948966
Control del lápiz¶
Estado de dibujo¶
-
turtle.
pensize
(width=None)¶ -
turtle.
width
(width=None)¶ - Parámetros
width – un número positivo
Establece el grosos de la línea a width o lo devuelve. Si resizemode se establece a «auto» y turtleshape es un polígono, ese polígono es dibujado con el mismo grosor de línea. Si no se dan argumentos, devuelve el grosor del lápiz actual.
>>> turtle.pensize() 1 >>> turtle.pensize(10) # from here on lines of width 10 are drawn
-
turtle.
pen
(pen=None, **pendict)¶ - Parámetros
pen – un diccionario con algunos o todos las claves listadas debajo
pendict – uno o más argumentos-palabras claves con las claves listadas debajo como palabras claves
Devuelve o establece los atributos del lápiz en un «diccionario-lápiz» con el siguiente para de valores/claves:
«shown»: True/False
«pendown»: True/False
«pencolor»: color-string or color-tuple
«fillcolor»: color-string or color-tuple
«pensize»: número positivo
«speed»: número en el rango 0..10
«resizemode»: «auto» or «user» or «noresize»
«stretchfactor»: (número positivo, número positivo)
«outline»: número positivo
«tilt»: número
Este diccionario puede usarse como argumento de una llamada subsecuente a la función
pen()
para restaurar el estado anterior del lápiz. Más aún, uno o más de estos atributos pueden darse como argumentos claves. Esto puede usarse para establecer diferentes atributos del lápiz en una sola definición.>>> turtle.pen(fillcolor="black", pencolor="red", pensize=10) >>> sorted(turtle.pen().items()) [('fillcolor', 'black'), ('outline', 1), ('pencolor', 'red'), ('pendown', True), ('pensize', 10), ('resizemode', 'noresize'), ('shearfactor', 0.0), ('shown', True), ('speed', 9), ('stretchfactor', (1.0, 1.0)), ('tilt', 0.0)] >>> penstate=turtle.pen() >>> turtle.color("yellow", "") >>> turtle.penup() >>> sorted(turtle.pen().items())[:3] [('fillcolor', ''), ('outline', 1), ('pencolor', 'yellow')] >>> turtle.pen(penstate, fillcolor="green") >>> sorted(turtle.pen().items())[:3] [('fillcolor', 'green'), ('outline', 1), ('pencolor', 'red')]
-
turtle.
isdown
()¶ Devuelve
True``si el lápiz está abajo, si está arriba ``False
.>>> turtle.penup() >>> turtle.isdown() False >>> turtle.pendown() >>> turtle.isdown() True
Control del color¶
-
turtle.
pencolor
(*args)¶ Devuelve o establece el color del lápiz.
Se permiten cuatro formatos de entrada:
pencolor()
Devuelve el color del lápiz actual como una palabra específica de algún color o como una tupla (ver ejemplo). Puede ser usado como una entrada para otra llamada de color/pencolor/fillcolor.
pencolor(colorstring)
Establece el color del lápiz a colorstring, que es una palabra que especifica un color Tk, tales como
"red"
,"yellow"
, o"#33cc8c"
.pencolor((r, g, b))
Establece el color del lápiz representado como una tupla de r, g, y b. Cada valor r, g, y b debe ser un valor entero en el rango 0..colormode, donde colormode es 1.0 o 255 (ver
colormode()
).pencolor(r, g, b)
Establece el color del lápiz al color RGB representado por r, g, y b. Cada valor r, g, y b debe estar en el rango 0..colormode.
Si turtleshape es un polígono, la línea del polígono es dibujado con el muevo color de lápiz elegido.
>>> colormode() 1.0 >>> turtle.pencolor() 'red' >>> turtle.pencolor("brown") >>> turtle.pencolor() 'brown' >>> tup = (0.2, 0.8, 0.55) >>> turtle.pencolor(tup) >>> turtle.pencolor() (0.2, 0.8, 0.5490196078431373) >>> colormode(255) >>> turtle.pencolor() (51.0, 204.0, 140.0) >>> turtle.pencolor('#32c18f') >>> turtle.pencolor() (50.0, 193.0, 143.0)
-
turtle.
fillcolor
(*args)¶ Return or set the fillcolor.
Se permiten cuatro formatos de entrada:
fillcolor()
Devuelve el valor actual de fillcolor como una palabra, posiblemente en formato de tupla (ver ejemplo). Puede ser usado como entrada de otra llamada color/pencolor/fillcolor.
fillcolor(colorstring)
Establece fillcolor a colorstring, que es un color TK especificado como una palabra (en inglés), tales como «red», «yellow», o «#33cc8c»`.
fillcolor((r, g, b))
Establece fillcolor al color RGB representado por la tupla r, g, y b. Cada uno de los valores r, g, y b debe estar en el rango 0..colormode, donde colormode es 1.0 o 255 (ver
colormode()
).fillcolor(r, g, b)
Establece fillcolor al color RGB representado por r, g, y b. Cada uno de los valores r, g y b debe ser un valor en el rango 0..colormode.
Si turtleshape es un polígono, el interior de ese polígono es dibujado con el color establecido en fillcolor.
>>> turtle.fillcolor("violet") >>> turtle.fillcolor() 'violet' >>> turtle.pencolor() (50.0, 193.0, 143.0) >>> turtle.fillcolor((50, 193, 143)) # Integers, not floats >>> turtle.fillcolor() (50.0, 193.0, 143.0) >>> turtle.fillcolor('#ffffff') >>> turtle.fillcolor() (255.0, 255.0, 255.0)
-
turtle.
color
(*args)¶ Retorna o establece pencolor (el color del lápiz) y fillcolor (el color de relleno).
Se permiten varios formatos de entrada. Usan de 0 a 3 argumentos como se muestra a continuación:
color()
Devuelve el valor actual de pencolor y el valor actual de fillcolor como un par de colores especificados como palabras o tuplas, como devuelven las funciones
pencolor()
yfillcolor()
.color(colorstring)
,color((r,g,b))
,color(r,g,b)
Entradas como en
pencolor()
, establece al valor dado tanto, fillcolor como pencolor.color(colorstring1, colorstring2)
,color((r1,g1,b1), (r2,g2,b2))
Equivalente a
pencolor(colorstring1)
yfillcolor(colorstring2)
y análogamente si se usa el otro formato de entrada.
Si turtleshape es un polígono, la línea y el interior de ese polígono e dibujado con los nuevos colores que se establecieron.
>>> turtle.color("red", "green") >>> turtle.color() ('red', 'green') >>> color("#285078", "#a0c8f0") >>> color() ((40.0, 80.0, 120.0), (160.0, 200.0, 240.0))
Ver también: Método Screeen colormode()
.
Relleno¶
-
turtle.
filling
()¶ Devuelve fillstate (
True
si está lleno, sinoFalse
).>>> turtle.begin_fill() >>> if turtle.filling(): ... turtle.pensize(5) ... else: ... turtle.pensize(3)
-
turtle.
begin_fill
()¶ Para ser llamada justo antes de dibujar una forma a rellenar.
-
turtle.
end_fill
()¶ Rellena la forma dibujada después de última llamada a la función
begin_fill()
.Superponer o no, regiones de polígonos auto-intersectados o múltiples formas, estas son rellenadas dependiendo de los gráficos del sistema operativo, tipo de superposición y número de superposiciones. Por ejemplo, la flecha de la tortuga de arriba, puede ser toda amarilla o tener algunas regiones blancas.
>>> turtle.color("black", "red") >>> turtle.begin_fill() >>> turtle.circle(80) >>> turtle.end_fill()
Más controles de dibujo¶
-
turtle.
reset
() Borra el dibujo de la tortuga de la pantalla, centra la tortuga y establece las variables a los valores por defecto.
>>> turtle.goto(0,-22) >>> turtle.left(100) >>> turtle.position() (0.00,-22.00) >>> turtle.heading() 100.0 >>> turtle.reset() >>> turtle.position() (0.00,0.00) >>> turtle.heading() 0.0
-
turtle.
clear
() Borra el dibujo de la tortuga de la pantalla. No mueve la tortuga. El estado y posición de la tortuga así como los todos los dibujos de las otras tortugas no son afectados.
-
turtle.
write
(arg, move=False, align="left", font=("Arial", 8, "normal"))¶ - Parámetros
arg – objeto que se escribirá en TurtleScreen
move – True/False
align – una de las frases «left», «center» o «right»
font – un trio (nombre de fuente, tamaño de fuente, tipo de fuente)
Write text - the string representation of arg - at the current turtle position according to align («left», «center» or «right») and with the given font. If move is true, the pen is moved to the bottom-right corner of the text. By default, move is
False
.>>> turtle.write("Home = ", True, align="center") >>> turtle.write((0,0), True)
Estado de la Tortuga¶
Visibilidad¶
-
turtle.
hideturtle
()¶ -
turtle.
ht
()¶ Hace invisible a la tortuga, Es una buena idea hacer eso mientras está haciendo dibujos complejos, ya que esconder a la tortuga acelera dibujo de manera observable.
>>> turtle.hideturtle()
-
turtle.
isvisible
()¶ Devuelve
True
si la tortuga se muestra,False
si está oculta.>>> turtle.hideturtle() >>> turtle.isvisible() False >>> turtle.showturtle() >>> turtle.isvisible() True
Apariencia¶
-
turtle.
shape
(name=None)¶ - Parámetros
name – una cadena de caracteres que es un nombre de forma válido
Establece la forma de la tortuga al name que se establece o, si no se establece un nmbre, devuelve el nombre actual de su forma. La forma name debe existir en el diccionario de formas de TurtleScreen. Inicialmente están las siguientes formas poligonales: «arrow», «turtle», «circle», «square», «triangle», «classic». Para aprender como trabajar con estas formas ver los métodos de Screen
register_shape()
.>>> turtle.shape() 'classic' >>> turtle.shape("turtle") >>> turtle.shape() 'turtle'
-
turtle.
resizemode
(rmode=None)¶ - Parámetros
rmode – una de las cadenas «auto», «user», «noresize»
Establece resizemode a alguno de los valores: «auto», «user», «noresize». Si mode no se aporta, devuelve el actual resizemode. Distintos resizemode tienen los siguientes efectos:
«auto»: adapta la apariencia de la tortuga al correspondiente valor del lápiz.
«user»: adapta la apariencia de la tortuga de acuerdo a los valores de sretchfactor y outlinewidth (contorno), que se establece con la función
shapesize()
.«noresize»: no se adapta la apariencia de la tortuga.
resizemode("user")
is called byshapesize()
when used with arguments.>>> turtle.resizemode() 'noresize' >>> turtle.resizemode("auto") >>> turtle.resizemode() 'auto'
-
turtle.
shapesize
(stretch_wid=None, stretch_len=None, outline=None)¶ -
turtle.
turtlesize
(stretch_wid=None, stretch_len=None, outline=None)¶ - Parámetros
stretch_wid – número positivo
stretch_len – número positivo
outline – número positivo
Devuelve o establece los atributos del lápiz los factores x/y de estiramiento y contorno. Establece resizemode a «user» si y solo si resizemode está definido como «user», la tortuga será verá estirada acorde a sus factores de estiramiento: stretch_wid es el factor de estiramiento perpendicular a su orientación, stretch_len es su factor de estiramiento en dirección a su orientación, outline determina el grosor de contorno de la forma.
>>> turtle.shapesize() (1.0, 1.0, 1) >>> turtle.resizemode("user") >>> turtle.shapesize(5, 5, 12) >>> turtle.shapesize() (5, 5, 12) >>> turtle.shapesize(outline=8) >>> turtle.shapesize() (5, 5, 8)
-
turtle.
shearfactor
(shear=None)¶ - Parámetros
shear – número (opcional)
Establece o devuelve el valor actual del estiramiento. Estira la forma de la tortuga de acuerdo a la inclinación del factor de corte, que es la tangente del ángulo de corte. No cambia el rumbo de la tortuga (dirección del movimiento). Si no de da un valor de inclinación: devuelve el factor actual, por ejemplo la tangente del ángulo de inclinación, por el cual se cortan la líneas paralelas al rumbo de la tortuga.
>>> turtle.shape("circle") >>> turtle.shapesize(5,2) >>> turtle.shearfactor(0.5) >>> turtle.shearfactor() 0.5
-
turtle.
tilt
(angle)¶ - Parámetros
angle – un número
Rota la forma de la tortuga en ángulo desde su ángulo de inclinación actual, pero no cambia el rumbo de la tortuga (dirección del movimiento).
>>> turtle.reset() >>> turtle.shape("circle") >>> turtle.shapesize(5,2) >>> turtle.tilt(30) >>> turtle.fd(50) >>> turtle.tilt(30) >>> turtle.fd(50)
-
turtle.
settiltangle
(angle)¶ - Parámetros
angle – un número
Rota la forma de la tortuga apuntando en la dirección especificada por el ángulo, independientemente de su ángulo de dirección actual. No cambia el rumbo de la tortuga (dirección de movimiento).
>>> turtle.reset() >>> turtle.shape("circle") >>> turtle.shapesize(5,2) >>> turtle.settiltangle(45) >>> turtle.fd(50) >>> turtle.settiltangle(-45) >>> turtle.fd(50)
Obsoleto desde la versión 3.1.
-
turtle.
tiltangle
(angle=None)¶ - Parámetros
angle – un número (opcional)
Establece o devuelve el ángulo de inclinación actual. Si se otorga un ángulo, rota la forma de la tortuga para apuntar en la dirección del ángulo especificado, independientemente de su actual ángulo de inclinación. No cambia el rumbo de la tortuga (dirección del movimiento). Si no se da el ángulo: devuelve el ángulo de inclinación actual, por ejemplo: el ángulo entre la orientación de la forma de la tortuga y el rumbo de la tortuga (su dirección de movimiento).
>>> turtle.reset() >>> turtle.shape("circle") >>> turtle.shapesize(5,2) >>> turtle.tilt(45) >>> turtle.tiltangle() 45.0
-
turtle.
shapetransform
(t11=None, t12=None, t21=None, t22=None)¶ - Parámetros
t11 – un número (opcional)
t12 – un número (opcional)
t21 – un número (opcional)
t12 – un número (opcional)
Establece o devuelve la matriz de transformación actual de la forma de la tortuga.
If none of the matrix elements are given, return the transformation matrix as a tuple of 4 elements. Otherwise set the given elements and transform the turtleshape according to the matrix consisting of first row t11, t12 and second row t21, t22. The determinant t11 * t22 - t12 * t21 must not be zero, otherwise an error is raised. Modify stretchfactor, shearfactor and tiltangle according to the given matrix.
>>> turtle = Turtle() >>> turtle.shape("square") >>> turtle.shapesize(4,2) >>> turtle.shearfactor(-0.5) >>> turtle.shapetransform() (4.0, -1.0, -0.0, 2.0)
-
turtle.
get_shapepoly
()¶ Devuelve el polígono de la forma actual como tupla de pares de coordenadas. Esto puede ser usado para definir una nueva forma o componentes de una forma compuesta.
>>> turtle.shape("square") >>> turtle.shapetransform(4, -1, 0, 2) >>> turtle.get_shapepoly() ((50, -20), (30, 20), (-50, 20), (-30, -20))
Usando eventos¶
-
turtle.
onclick
(fun, btn=1, add=None) - Parámetros
fun – una función con dos argumentos que se invocará con las coordenadas del punto en el que se hizo clic en el lienzo
btn – número del botón del mouse, el valor predeterminado es 1 (botón izquierdo del mouse)
add –
True
oFalse
– si esTrue
, se agrega un nuevo enlace, de lo contrario reemplazará el enlace anterior
Enlaza acciones divertidas a eventos de click en la tortuga. Si la accion es
None
, las acciones asociadas son borradas. Ejemplo para la tortuga anónima, en la forma procedimental:>>> 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)¶ - Parámetros
fun – una función con dos argumentos que se invocará con las coordenadas del punto en el que se hizo clic en el lienzo
btn – número del botón del mouse, el valor predeterminado es 1 (botón izquierdo del mouse)
add –
True
oFalse
– si esTrue
, se agrega un nuevo enlace, de lo contrario reemplazará el enlace anterior
Enlaza acciones divertidas a eventos del tipo soltar botón del mouse en la tortuga. SI la acción es
None
, las acciones asociadas son borradas.>>> 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)¶ - Parámetros
fun – una función con dos argumentos que se invocará con las coordenadas del punto en el que se hizo clic en el lienzo
btn – número del botón del mouse, el valor predeterminado es 1 (botón izquierdo del mouse)
add –
True
oFalse
– si esTrue
, se agrega un nuevo enlace, de lo contrario reemplazará el enlace anterior
Enlaza acciones divertidas a eventos en los movimientos del mouse. Si la acción es
None
, las acciones asociadas son borradas.Observación: cada secuencia de los eventos de movimiento del mouse en una tortuga es precedida por un evento de click del mouse en esa tortuga.
>>> turtle.ondrag(turtle.goto)
Subsecuentemente, clickear y arrastrar la Tortuga la moverá a través de la pantalla produciendo dibujos a mano alzada (si el lápiz está abajo).
Métodos especiales de Turtle¶
-
turtle.
begin_poly
()¶ Comienza a grabar los vértices de un polígono. La posición actual de la tortuga es el primer vértice del polígono.
-
turtle.
end_poly
()¶ Deja de grabar los vértices de un polígono. La posición actual de la tortuga es el último vértice del polígono. Esto se conectará con el primer vértice.
-
turtle.
get_poly
()¶ Devuelve el último polígono grabado.
>>> 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
()¶ Crea y devuelve un clon de la tortuga con la misma posición, dirección y propiedades de la tortuga.
>>> mick = Turtle() >>> joe = mick.clone()
-
turtle.
getturtle
()¶ -
turtle.
getpen
()¶ Devuelve el objeto Tortuga en si. El único uso razonable: es como una función para devolver la «tortuga anónima»:
>>> pet = getturtle() >>> pet.fd(50) >>> pet <turtle.Turtle object at 0x...>
-
turtle.
getscreen
()¶ Devuelve el objeto
TurtleScreen
sobre el cual la tortuga está dibujando. Los métodos TurtleScreen luego pueden ser llamados para ese objeto.>>> ts = turtle.getscreen() >>> ts <turtle._Screen object at 0x...> >>> ts.bgcolor("pink")
-
turtle.
setundobuffer
(size)¶ - Parámetros
size – un entero o
None
Set or disable undobuffer. If size is an integer, an empty undobuffer of given size is installed. size gives the maximum number of turtle actions that can be undone by the
undo()
method/function. If size isNone
, the undobuffer is disabled.>>> turtle.setundobuffer(42)
-
turtle.
undobufferentries
()¶ Devuelve el número de entradas en el buffer para deshacer acciones.
>>> while undobufferentries(): ... undo()
Formas compuestas¶
Para usar formas complejas con la tortuga, que consiste en varios polígonos de diferentes colores, deberá usar la clase de ayuda Shape
explícitamente como se describe debajo:
Crear una objeto de forma vacía del tipo compound.
Agregar todos los componentes deseados a este objeto, usando el método
addcomponent()
.Por ejemplo:
>>> 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")
Ahora agregar la forma a la lista de formas de la pantalla y úsela:
>>> register_shape("myshape", s) >>> shape("myshape")
Nota
La clase Shape
es usada internamente por el método register_shape()
en maneras diferentes. El programador deberá lidiar con la clase Shape ¡solo cuando use formas compuestas como las que se mostraron arriba!
Métodos de TurtleScreen/Screen y sus correspondientes funciones¶
La mayoría de los ejemplos en esta sección se refieren a la instancia de TurtleScreen llamada screen
.
Control de ventana¶
-
turtle.
bgcolor
(*args)¶ - Parámetros
args – una cadena de color o tres números en el rango 0..*colormode* o una tupla de 3 de esos números
Establece o devuelve el color de fondo de TurtleScreen.
>>> screen.bgcolor("orange") >>> screen.bgcolor() 'orange' >>> screen.bgcolor("#800080") >>> screen.bgcolor() (128.0, 0.0, 128.0)
-
turtle.
bgpic
(picname=None)¶ - Parámetros
picname – una cadena, nombre o archivo gif o
"nopic"
, oNone
Establece la imagen de fondo o devuelve el nombre de la imagen de fondo actual. Si picname es un nombre de archivo, establece la imagen correspondiente como fondo. Si picname es
"nopic"
, borra la imagen de fondo, si hay alguna presente. Si picname esNone
, devuelve el nombre de archivo de la imagen de fondo actual.>>> screen.bgpic() 'nopic' >>> screen.bgpic("landscape.gif") >>> screen.bgpic() "landscape.gif"
-
turtle.
clear
()¶ -
turtle.
clearscreen
()¶ Borra todos los dibujos y todas las tortugas del la pantalla de la tortuga. Reinicia la ahora vacía pantalla de la tortuga a su estado inicial: fondo blanco, sin imagen de fondo, sin enlaces a eventos o seguimientos.
Nota
Este método de TurtleScreen está disponible como una función global solo bajo el nombre clearscreen`. La función global
clear
es otra, derivada del método de Turtleclear
.
-
turtle.
reset
()¶ -
turtle.
resetscreen
()¶ Reinicia todas las tortugas de la pantalla a su estado inicial.
Nota
Este método TurtleScreen esta disponible como una función global solo bajo el nombre
resetscreen
. La función globalreset
es otra, derivada del método Turtlereset
.
-
turtle.
screensize
(canvwidth=None, canvheight=None, bg=None)¶ - Parámetros
canvwidth – entero positivo, nueva anchura del lienzo en pixeles
canvheight – entero positivo, nueva altura del lienzo en pixeles
bg – colorstrng o tupla de color, muevo color de fondo
Si no se dan argumentos, devuelve el actual (ancho y alto del lienzo). Sino redimensiona el lienzo en el que la tortuga está dibujando. No altera la ventana de dibujo. Para ver las partes ocultas del lienzo, use la barra de desplazamiento. Con este método, se pueden hacer visibles aquellas partes de un dibujo que antes estaban fuera del lienzo.
>>> screen.screensize() (400, 300) >>> screen.screensize(2000,1500) >>> screen.screensize() (2000, 1500)
ej. buscar una tortuga que se escapó por error ;-)
-
turtle.
setworldcoordinates
(llx, lly, urx, ury)¶ - Parámetros
llx – un número, coordenada x de la esquina inferior izquierda del lienzo
lly – un número, coordenada y de la esquina inferior izquierda del lienzo
urx – un número, coordenada x de la esquina superior derecha del lienzo
ury – un número, coordenada z de la esquina superior derecha del lienzo
Configura coordenadas definidas por el usuario y cambia al modo world si es necesario. Esto realiza un
screen.reset()
. Si el modo world ya está activo, todos los dibujos se re dibujan de acuerdo a las nuevas coordenadas.ATENCIÓN: en los sistemas de coordenadas definidos por el usuario, los ángulos pueden aparecer distorsionados.
>>> 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
Control de animación¶
-
turtle.
delay
(delay=None)¶ - Parámetros
delay – entero positivo
Establece o retorna el retraso del dibujo en mili segundos. ( Este es aproximadamente, el tiempo de intervalo entre dos actualizaciones consecutivas del lienzo). Mientras más largo sea el retraso, más lenta la animación.
Argumento opcional:
>>> screen.delay() 10 >>> screen.delay(5) >>> screen.delay() 5
-
turtle.
tracer
(n=None, delay=None)¶ - Parámetros
n – entero no negativo
delay – entero no negativo
Activa o desactiva la animación de la tortuga y establece el retraso para la actualización de los dibujos. Si se da n, solo cada enésima actualización regular de pantalla se realiza realmente. (Puede usarse para acelerar los dibujos de gráficos complejos). Cuando es llamada sin argumentos, devuelve el valor de n guardado actualmente. El segundo argumento establece el valor de retraso (ver
delay()
).>>> screen.tracer(8, 25) >>> dist = 2 >>> for i in range(200): ... fd(dist) ... rt(90) ... dist += 2
-
turtle.
update
()¶ Realiza una actualización de la pantalla de la tortuga. Para ser usada cuando tracer está deshabilitada.
Ver también el método RawTurtle/Turtle speed()
.
Usando eventos de pantalla¶
-
turtle.
listen
(xdummy=None, ydummy=None)¶ Establece el foco en la pantalla de la tortuga (para recoger eventos de teclado). Los argumentos dummy se proveen en orden de ser capaces de pasar
listen()
a los métodos onclick.
-
turtle.
onkey
(fun, key)¶ -
turtle.
onkeyrelease
(fun, key)¶ - Parámetros
fun – una función sin argumentos o
None
key – una cadena de caracteres: tecla (por ejemplo, «a») o una acción del teclado (por ejemplo, «space»)
Vincula fun a un evento de liberación de una tecla. Si fun es
None
, los eventos vinculados son removidos. Aclaración: para poder registrar eventos de teclado, TurtleScreen tiene que tener el foco. (ver el métodolisten()
.)>>> def f(): ... fd(50) ... lt(60) ... >>> screen.onkey(f, "Up") >>> screen.listen()
-
turtle.
onkeypress
(fun, key=None)¶ - Parámetros
fun – una función sin argumentos o
None
key – una cadena de caracteres: tecla (por ejemplo, «a») o una acción del teclado (por ejemplo, «space»)
Vincula fun a un evento de pulsado de una tecla, o a cualquier evento de pulsado de tecla si no se da una. Aclaración: para poder registrar eventos de teclado, TurtleScreen tiene que tener el foco. (ver el método
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)¶ - Parámetros
fun – una función con dos argumentos que se invocará con las coordenadas del punto en el que se hizo clic en el lienzo
btn – número del botón del mouse, el valor predeterminado es 1 (botón izquierdo del mouse)
add –
True
oFalse
– si esTrue
, se agrega un nuevo enlace, de lo contrario reemplazará el enlace anterior
Vincula fun a eventos de click del mouse en esta pantalla. Si fun es
None
, los vínculos existentes son removidos.Example for a TurtleScreen instance named
screen
and a Turtle instance namedturtle
:>>> 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
Nota
Este método TurtleScreen está disponible como una función global solo bajo el nombre onscreenclick`. La función global
onclick
es otra derivada del método Turtleonclick
.
-
turtle.
ontimer
(fun, t=0)¶ - Parámetros
fun – una función sin argumentos
t – un número >= 0
Instala un temporizador que llama a fun cada t milisegundos.
>>> 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
()¶ Comienza un bucle de evento - llamando a la función mainloop del Tkinter. Debe ser la última declaración en un programa gráfico de turtle. No debe ser usado si algún script es corrido dentro del IDLE en modo -n (Sin subproceso) - para uso interactivo de gráficos turtle.:
>>> screen.mainloop()
Métodos de entrada¶
-
turtle.
textinput
(title, prompt)¶ - Parámetros
title – cadena de caracteres
prompt – cadena de caracteres
Abre una ventana de diálogo para ingresar una cadena de caracteres. El parámetro title es el título de la ventana de diálogo, prompt es un texto que usualmente describe que información se debe ingresar. Devuelve la cadena ingresada. Si el diálogo es cancelado, devuelve None`.
>>> screen.textinput("NIM", "Name of first player:")
-
turtle.
numinput
(title, prompt, default=None, minval=None, maxval=None)¶ - Parámetros
title – cadena de caracteres
prompt – cadena de caracteres
default – número (opcional)
minval – número (opcional)
maxval – número (opcional)
Abre una ventana de diálogo para el ingreso de un número. title es el título de la ventana de diálogo, prompt es un texto que usualmente describe qué información numérica ingresar. default: valor por defecto, minval: mínimo valor aceptado, maxval: máximo valor aceptado. Si se aportan estos parámetros, el número a ingresar debe estar en el rango minval..*maxval*. Si no, se da una pista y el diálogo permanece abierto para su corrección. Devuelve el número ingresado. Si el diálogo es cancelado, devuelve
None
.:>>> screen.numinput("Poker", "Your stakes:", 1000, minval=10, maxval=10000)
Configuración y métodos especiales¶
-
turtle.
mode
(mode=None)¶ - Parámetros
mode – una de las cadenas «standard», «logo» o «world»
Establece el mode de la tortuga («standard», «logo» o «world») y realiza un reinicio. Si no se da «mode», retorna el modo actual.
El modo «standard» es compatible con el antiguo
turtle
. El modo «logo» es compatible con la mayoría de los gráficos de tortuga Logo. El modo «world» usa coordenadas de mundo definidas por el usuario. Atención: en este modo los ángulos aparecen distorsionados si la relación de unidadx/y
no es igual a 1.Modo
Rumbo inicial de la tortuga
ángulos positivos
«standard»
hacia la derecha (este)
sentido antihorario
«logo»
hacia arriba (norte)
sentido horario
>>> mode("logo") # resets turtle heading to north >>> mode() 'logo'
-
turtle.
colormode
(cmode=None)¶ - Parámetros
cmode – uno de los valores 1.0 o 255
Devuelve el colormode o lo establece a 1.0 o 255. Subsecuentemente, los valores triples de color r, g, b tienen que estar en el rango 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
()¶ Devuelve el lienzo de este TurtleScreen. Útil para conocedores que saben que hace con un TKinter Canvas.
>>> cv = screen.getcanvas() >>> cv <turtle.ScrolledCanvas object ...>
-
turtle.
getshapes
()¶ Devuelve la lista de nombres de todas las formas de la tortuga actualmente disponibles.
>>> screen.getshapes() ['arrow', 'blank', 'circle', ..., 'turtle']
-
turtle.
register_shape
(name, shape=None)¶ -
turtle.
addshape
(name, shape=None)¶ Hay tres formas distintas de llamar a esta función:
name es el nombre de un archivo gif y shape es
None
: instala la imagen correspondiente.>>> screen.register_shape("turtle.gif")
Nota
Las imágenes de tipo shapes no rotan cuando la tortuga gira, así que ellas ¡no muestran el rumbo de la tortuga!
name es una cadena de caracteres arbitraria y shape es una tupla de pares de coordenadas: Instala la forma poligonal correspondiente.
>>> screen.register_shape("triangle", ((5,-3), (0,5), (-5,-3)))
name es una cadena de caracteres arbitraria y shape es un objeto
Shape
(compuesto): Instala la correspondiente forma compuesta.
Agregar una forma de tortuga a la lista de formas de TurtleScreen. Solo las formas registradas de esta manera pueden ser usadas invocando el comando
shape(shapename)
.
-
turtle.
turtles
()¶ Devuelve la lista de tortugas en la pantalla.
>>> for turtle in screen.turtles(): ... turtle.color("red")
-
turtle.
window_height
()¶ Devuelve la altura de la ventana de la tortuga.
>>> screen.window_height() 480
-
turtle.
window_width
()¶ Devuelve el ancho de la ventana de la tortuga.
>>> screen.window_width() 640
Métodos específicos de Screen, no heredados de TurtleScreen¶
-
turtle.
bye
()¶ Apaga la ventana gráfica de la tortuga.
-
turtle.
exitonclick
()¶ Bind
bye()
method to mouse clicks on the Screen.Si el valor «using_IDLE» en la configuración del diccionario es
False
(valor por defecto), también ingresa mainloop. Observaciones: si se usa la IDLE con el modificador (no subproceso)-n
, este valor debe establecerse aTrue
enturtle.cfg
. En este caso el propio mainloop de la IDLE está activa también para script cliente.
-
turtle.
setup
(width=_CFG["width"], height=_CFG["height"], startx=_CFG["leftright"], starty=_CFG["topbottom"])¶ Establece el tamaño y la posición de la ventana principal. Los valores por defecto de los argumentos son guardados en el diccionario de configuración y puede ser cambiado a través del archivo
turtle.cfg
.- Parámetros
width – si es un entero, el tamaño en pixeles, si es un número flotante, una fracción de la pantalla; el valor por defecto es 50% de la pantalla
height – si es un entero, la altura en pixeles, si es un número flotante, una fracción de la pantalla; el valor por defecto es 75% de la pantalla
startx – si es positivo, punto de inicio en pixeles desde la esquina izquierda de la pantalla, si es negativo desde la esquina derecha de la pantalla, si es
None
, centra la ventana horizontalmentestarty – si es positivo, punto de inicio en pixeles desde la parte superior de la pantalla, si es negativo desde la parte inferior de la pantalla, si es
None
, centra la ventana verticalmente
>>> 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)¶ - Parámetros
titlestring – una cadena de caracteres que se muestra en la barra de título de la ventana gráfica de la tortuga
Establece el título de la ventana de la tortuga a titlestring.
>>> screen.title("Welcome to the turtle zoo!")
Clases públicas¶
-
class
turtle.
RawTurtle
(canvas)¶ -
class
turtle.
RawPen
(canvas)¶ - Parámetros
canvas – una clase
tkinter.Canvas
, unaScrolledCanvas
o una claseTurtleScreen
Crea una tortuga. La tortuga tiene todos los métodos descriptos anteriormente como «métodos de «Turtle/RawTurtle».
-
class
turtle.
Turtle
¶ Subclase de RawTurtle, tiene la misma interface pero dibuja sobre una objeto por defecto
Screen
creado automáticamente cuando es necesario por primera vez.
-
class
turtle.
TurtleScreen
(cv)¶ - Parámetros
cv – un
tkinter.Canvas
Provee métodos orientados a la pantalla como
setbg()
etc. descriptos anteriormente.
-
class
turtle.
Screen
¶ Subclase de TurtleScreen, con cuatro métodos agregados.
-
class
turtle.
ScrolledCanvas
(master)¶ - Parámetros
master – algunos widgets TKinter para contener el ScrollCanvas, por ejemplo un lienzo Tkinter con barras de desplazamiento agregadas
Usado por la clase Screen, que proporciona automáticamente un ScrolledCanvas como espacio de trabajo para las tortugas.
-
class
turtle.
Shape
(type_, data)¶ - Parámetros
type_ – una de las cadenas de caracteres «polygon», «image», «compound»
Estructura de datos que modela las formas. El par (type_, data)` debe seguir estas especificaciones:
type_
data
«polygon»
una tupla para el polígono, por ejemplo: una tupla de par de coordenadas
«image»
una imagen (en esta forma solo se usa ¡internamente!)
«compound»
None
(una forma compuesta tiene que ser construida usando el métodoaddcomponent()
)-
addcomponent
(poly, fill, outline=None)¶ - Parámetros
poly – un polígono, por ejemplo una tupla de pares de números
fill – un color con el que el polígono será llenado
outline – un color con el que se delineará el polígono (se de ingresa)
Ejemplo:
>>> poly = ((0,0),(10,-5),(0,10),(-10,-5)) >>> s = Shape("compound") >>> s.addcomponent(poly, "red", "blue") >>> # ... add more components and then use register_shape()
Ver Formas compuestas.
-
class
turtle.
Vec2D
(x, y)¶ Una clase de vectores bidimensionales, usado como clase de ayuda para implementar gráficos de tortuga. Puede ser útil para los programas de gráficos de tortugas también. Derivado de la tupla, ¡por lo que un vector es una tupla!
Proporciona (para a, b vectores, k números)
a + b
suma de vectoresa - b
resta de vectoresa * b
producto internok * a
ya * k
multiplicación con escalarabs(a)
valor absoluto de aa.rotate(angle)
rotación
Ayuda y configuración¶
Cómo usar la ayuda¶
Los métodos públicos de las clases Screen y Turtle están ampliamente documentados a través de cadenas de documentación. Por lo tanto, estos se pueden usar como ayuda en línea a través de las instalaciones de ayuda de Python:
Cuando se usa IDLE, la información sobre herramientas muestra las firmas y las primeras líneas de las cadenas de documentos de las llamadas de función/método escritas.
Llamar a
help()
en métodos o funciones muestra los 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()
Los docstrings de las funciones que se derivan de los métodos tienen una forma modificada:
>>> 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()
Estos docstrings modificados se crean automáticamente junto con las definiciones de función que se derivan de los métodos en el momento de la importación.
Traducción de cadenas de documentos a diferentes idiomas¶
Existe una utilidad para crear un diccionario cuyas claves son los nombres de los métodos y cuyos valores son los docstrings de los métodos públicos de las clases Screen y Turtle.
-
turtle.
write_docstringdict
(filename="turtle_docstringdict")¶ - Parámetros
filename – una cadena de caracteres, utilizada como nombre de archivo
Crea y escribe un diccionario-docstring en un script de Python con el nombre de archivo dado. Esta función tiene que ser llamada explícitamente (no es utilizada por las clases de gráficos de tortugas). El diccionario de docstrings se escribirá en el script de Python
filename.py
. Está destinado a servir como plantilla para la traducción de las cadenas de documentos a diferentes idiomas.
Si usted (o sus estudiantes) desea utilizar turtle
con ayuda en línea en su idioma nativo, debe traducir los docstrings y guardar el archivo resultante como, por ejemplo, turtle_docstringdict_german.py
.
Si tiene una entrada adecuada en su archivo turtle.cfg
, este diccionario se leerá en el momento de la importación y reemplazará los docstrings originales en inglés.
En el momento de escribir este artículo, existen diccionarios de docstrings en alemán e italiano. (Solicitudes por favor a glingl@aon.at.)
Cómo configurar Screen and Turtles¶
La configuración predeterminada incorporada imita la apariencia y el comportamiento del antiguo módulo de tortuga para mantener la mejor compatibilidad posible con él.
Si desea utilizar una configuración diferente que refleje mejor las características de este módulo o que se adapte mejor a sus necesidades, por ejemplo, para su uso en un aula, puede preparar un archivo de configuración turtle.cfg
que se leerá en el momento de la importación y modificará la configuración de acuerdo con su configuración.
La configuración incorporada correspondería al siguiente 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
Breve explicación de las entradas seleccionadas:
Las primeras cuatro líneas corresponden a los argumentos del método
Screen.setup()
.Las líneas 5 y 6 corresponden a los argumentos del método
Screen.screensize()
.shape puede ser cualquiera de las formas integradas, por ejemplo: arrow, turtle, etc. Para obtener más información, pruebe con
help(shape)
.Si no desea usar color de relleno (es decir, hacer que la tortuga sea transparente), debe escribir
fillcolor = ""
(pero todas las cadenas no vacías no deben tener comillas en el archivo cfg).Si desea reflejar el estado de la tortuga, debe usar
resizemode = auto
.Si establece, por ejemplo,
language = italian
el docstringdictturtle_docstringdict_italian.py
se cargará en el momento de la importación (si está presente en la ruta de importación, por ejemplo, en el mismo directorio queturtle
.Las entradas exampleturtle y examplescreen definen los nombres de estos objetos a medida que aparecen en las cadenas de documentos. La transformación de método-docstrings en función-docstrings eliminará estos nombres de las docstrings.
using_IDLE: establezca esto en
True
si trabaja regularmente con IDLE y su interruptor -n («sin subproceso»). Esto evitará queexitonclick()
ingrese al bucle principal.
Puede haber un archivo turtle.cfg
en el directorio donde se almacena turtle
y uno adicional en el directorio de trabajo actual. Este último anulará la configuración del primero.
El directorio Lib/turtledemo
contiene un archivo turtle.cfg
. Puede estudiarlo como un ejemplo y ver sus efectos al ejecutar las demostraciones (preferiblemente no desde el visor de demostraciones).
turtledemo
— Scripts de demostración¶
El paquete turtledemo
incluye un conjunto de scripts de demostración. Estos scripts se pueden ejecutar y visualizar utilizando el visor de demostración suministrado de la siguiente manera:
python -m turtledemo
Alternativamente, puede ejecutar los scripts de demostración individualmente. Por ejemplo,
python -m turtledemo.bytedesign
El directorio del paquete turtledemo
contiene:
Un visor de demostración
__main__.py
que se puede utilizar para ver el código fuente de los scripts y ejecutarlos al mismo tiempo.Múltiples scripts que demuestran diferentes características del módulo
turtle
. Se puede acceder a los ejemplos a través del menú de ejemplos. También se pueden ejecutar de forma independiente.Un archivo
turtle.cfg
que sirve como ejemplo de cómo escribir y usar dichos archivos.
Los scripts de demostración son:
Nombre |
Descripción |
Características |
---|---|---|
bytedesign |
patrón de gráficos de tortuga clásica compleja |
|
caos |
gráficos dinámicos de Verhulst, muestra que los cálculos de la computadora pueden generar resultados a veces contra las expectativas del sentido común |
coordenadas mundiales |
reloj |
reloj analógico que muestra la hora de su computadora |
tortugas como manecillas de reloj, temporizador |
colormixer |
experimento con r, g, b |
|
bosque |
3 árboles de ancho primero |
aleatorización |
fractalcurves |
Curvas Hilbert & Koch |
recursión |
lindenmayer |
etnomatemáticas (kolams indios) |
Sistema-L |
minimal_hanoi |
Torres de Hanoi |
Tortugas rectangulares como discos de Hanoi (shape, tamaño de forma) |
nim |
juega el clásico juego de nim con tres montones de palos contra la computadora. |
tortugas como nimsticks, impulsado por eventos (mouse, teclado) |
pintar |
programa de dibujo super minimalista |
|
paz |
elemental |
turtle: apariencia y animación |
penrose |
embaldosado aperiódico con cometas y dardos |
|
planet_and_moon |
simulación de sistema gravitacional |
formas compuestas, |
round_dance |
tortugas bailarinas que giran por parejas en dirección opuesta |
formas compuestas, clonar tamaño de forma, tilt, get_shapepoly, update |
sorting_animate |
demostración visual de diferentes métodos de ordenamiento |
alineación simple, aleatorización |
árbol |
un primer árbol de amplitud (gráfico, usando generadores) |
|
two_canvases |
diseño simple |
tortugas en dos lienzos (two_canvases) |
wikipedia |
un patrón del artículo de wikipedia sobre gráficos de tortuga (turtle) |
|
yinyang |
otro ejemplo elemental |
|
¡Diviértete!
Cambios desde Python 2.6¶
Los métodos
Turtle.tracer()
,Turtle.window_width()
yTurtle.window_height()
han sido eliminados. Los métodos con estos nombres y funciones ahora están disponibles solo como métodos deScreen
. Las funciones derivadas de estos permanecen disponibles. (De hecho, ya en Python 2.6 estos métodos eran simplemente duplicaciones de los métodos correspondientesTurtleScreen
/Screen
).El método
Turtle.fill()
ha sido eliminado. El comportamiento debegin_fill()
yend_fill()
ha cambiado ligeramente: ahora cada proceso de llenado debe completarse con una llamadaend_fill()
.Se ha añadido un método
Turtle.filling()
. Retorna un valor booleano:True
si hay un proceso de llenado en curso,False
en caso contrario. Este comportamiento corresponde a una llamadafill()
sin argumentos en Python 2.6.
Cambios desde Python 3.0¶
Se han añadido los métodos
Turtle.shearfactor()
,Turtle.shapetransform()
yTurtle.get_shapepoly()
. Por lo tanto, ahora está disponible la gama completa de transformaciones lineales regulares para transformar formas de tortugas.Turtle.tiltangle()
se ha mejorado en funcionalidad: ahora se puede usar para obtener o establecer el tiltangle.Turtle.settiltangle()
ha quedado obsoleto.El método
Screen.onkeypress()
se ha agregado como complemento aScreen.onkey()
que, de hecho, une las acciones al evento keyrelease. En consecuencia, este último tiene un alias:Screen.onkeyrelease()
.Se ha añadido el método
Screen.mainloop()
. Entonces, cuando se trabaja solo con objetos Screen y Turtle, ya no se debe importar adicionalmentemainloop()
.Se han añadido dos métodos de entrada
Screen.textinput()
yScreen.numinput()
. Estos cuadros de diálogo de entrada emergentes y retornan cadenas y números respectivamente.Se han agregado dos scripts de ejemplo
tdemo_nim.py
ytdemo_round_dance.py
al directorioLib/turtledemo
.