Turtle
Declarar la instancia
Si añades un bloque de Turtle al área de trabajo, en el código Python se inserta automáticamente la declaración de instancia siguiente:
turtle = Turtle(0)
# si hay varias instancias
turtle_1 = Turtle(1)Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| index | Opción de desplegable | Número de instancia (empieza en 0) | entero ≥ 0 | 0 |
Fijar la velocidad de la rueda
Determina la velocidad de la rueda. El rango de la velocidad es -100 ~ 100.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| unit | Opción de desplegable | Tipo de rueda | izquierda(left), derecha(right), ambas(both) | - |
| speed | Entrada (bloque) | Velocidad de la rueda | entero -100 ~ 100, 0: parada | - |
Python
turtle = Turtle(0)
turtle.set_wheel_speed('both', 50)Mover una distancia
Establece la distancia que se recorre.
Si no hay ninguna velocidad de rueda fijada, el robot no se mueve.
Si la distancia es 0, el robot sigue avanzando a la velocidad de rueda actual.
Si marcas esperar, se espera hasta que el movimiento termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| data | Entrada (bloque) | Distancia que se recorre | decimal ≥ 0 | - |
| unit | Opción de desplegable | Unidad de distancia | cm, mm, pulgada(inch) | cm |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.move_distance(50, 'cm', wait=True)Mover durante un tiempo
Avanza durante el tiempo indicado a la velocidad de rueda actual.
Si no hay ninguna velocidad de rueda fijada, el robot avanza a la velocidad predeterminada.
Si marcas esperar, se espera hasta que el movimiento termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| data | Entrada (bloque) | Tiempo de movimiento (segundos) | decimal ≥ 0 | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
# wait = TRUE
turtle.move_time(5, wait=True)
# wait = FALSE
turtle.move_time(0.5, wait=False)Girar sobre el sitio
Establece la dirección y el ángulo con los que el robot gira sobre el sitio.
Si marcas esperar, se espera hasta que el giro termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| direction | Opción de desplegable | Dirección de giro | izquierda(left), derecha(right) | - |
| data | Entrada (bloque) | Ángulo de giro (grados) | decimal ≥ 0 | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.turn_degree('left', 90, wait=True)Cambiar la velocidad de la rueda
Cambia la velocidad de rueda de Turtle.
La nueva velocidad de rueda es la velocidad actual más la velocidad introducida.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| unit | Opción de desplegable | Tipo de rueda | izquierda(left), derecha(right), ambas(both) | - |
| speed | Entrada (bloque) | Diferencia de velocidad del cambio | entero -200 ~ 200 | - |
Python
turtle = Turtle(0)
turtle.change_wheel_speed('both', 10)Detener
Detiene el movimiento de Turtle.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.stop()¿Rueda en movimiento?
Devuelve true si la rueda está en movimiento y false si está parada.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.wheel_moving()Pivotar alrededor de una rueda
Establece el punto de giro, la dirección y el ángulo.
Si marcas esperar, se espera hasta que el giro termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| base | Opción de desplegable | Rueda como punto de giro | rueda izquierda(left_wheel), rueda derecha(right_wheel) | - |
| direction | Opción de desplegable | Dirección de giro | adelante(forward), atrás(backward) | - |
| data | Entrada (bloque) | Ángulo de giro (grados) | decimal ≥ 0 | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.pivot('left_wheel', 'forward', 90, wait=True)Dibujar un círculo
Al dibujar un círculo con el lápiz, establece la dirección, el radio y el ángulo.
Si marcas esperar, se espera hasta que el giro termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| direction | Opción de desplegable | Dirección de giro | adelante izq.(left_forward), atrás izq.(left_backward), adelante der.(right_forward), atrás der.(right_backward) | - |
| degree | Entrada (bloque) | Ángulo de giro (grados) | decimal ≥ 0 | - |
| radius | Entrada (bloque) | Radio del giro | decimal ≥ 0 | - |
| unit | Opción de desplegable | Unidad del radio | cm, mm, pulgada(inch) | cm |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.pivot_circle('left_forward', 90, 1, 'cm', wait=True)Seguir la línea con el sensor
Sigue con el sensor de color de la parte inferior una línea de un color concreto.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| line | Opción de desplegable | Color de la línea que se sigue | negro(black), rojo(red), verde(green), azul(blue), cualquier color(any) | black |
Python
turtle = Turtle(0)
turtle.trace_line('black')Seguir la línea hasta un color concreto
Sigue con el sensor de color de la parte inferior la línea del color A hasta que el robot encuentra el color B.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| line | Opción de desplegable | Color de la línea que se sigue | negro(black), rojo(red), verde(green), azul(blue), cualquier color(any) | - |
| color | Opción de desplegable | Color en el que se para | negro(black), rojo(red), verde(green), cian(cyan), azul(blue), magenta(magenta), cualquier color(any) | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.trace_line_until_color('black', 'red', wait=True)Girar en una intersección y parar en la siguiente
Turtle gira en la intersección en la dirección indicada y después sigue hasta encontrar la intersección siguiente.
Si marcas esperar, se espera hasta que el movimiento termine.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| direction | Opción de desplegable | Dirección en la intersección | avanzar(forward), izquierda(left), derecha(right), dar la vuelta(uturn) | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.trace_intersection('left', wait=True)Fijar la velocidad de seguimiento de línea
Fija la velocidad de seguimiento de línea. El rango de la velocidad es 1 ~ 10.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| data | Entrada (bloque) | Velocidad de seguimiento de línea | entero 1 ~ 10 | - |
Python
turtle = Turtle(0)
turtle.set_trace_speed(5)Fijar la ganancia de seguimiento de línea
Fija la corrección de dirección en el seguimiento de línea. El rango de la corrección es 1 ~ 10.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| data | Entrada (bloque) | Corrección de dirección | entero 1 ~ 10 | - |
Python
turtle = Turtle(0)
turtle.set_trace_gain(5)Detener el seguimiento de línea
Termina la función de seguimiento de línea de Turtle.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.stop_trace()Fijar el color del LED
Fija el color del LED de la cabeza de Turtle.
Si eliges un color en la paleta de colores, se pasa como nombre de color (texto en inglés). (El código no se genera con valores numéricos R, G, B, sino con el nombre del color.)
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| color | Color | Selección en la paleta de colores → nombre de color (inglés) | Nombre de color: 'black', 'red', 'yellow', 'green', 'cyan', 'blue', 'magenta', 'white' | - |
Python
turtle = Turtle(0)
turtle.set_led_color('red')Fijar el color del LED con un bloque de la categoría Color
Toma como entrada la salida de un bloque de la categoría Color ([R, G, B]) y fija con ella el color del LED de la cabeza.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| data | Entrada (color) | Bloque de la categoría Color o una matriz [R, G, B] | [0~255, 0~255, 0~255] | - |
Python
turtle = Turtle(0)
turtle.set_led_color(*Utils.color('red'))Cambiar el color del LED con valores RGB
Suma los cambios de R, G y B introducidos al color actual del LED de la cabeza y fija así un color nuevo.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| r | Entrada (campo) | Cambio de rojo | entero -255 ~ 255 | 0 |
| g | Entrada (campo) | Cambio de verde | entero -255 ~ 255 | 0 |
| b | Entrada (campo) | Cambio de azul | entero -255 ~ 255 | 0 |
Python
turtle = Turtle(0)
turtle.change_led_color(10, 0, 0)Apagar el LED
Borra el color del LED de la cabeza.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.turn_off()Fijar el zumbido
Fija el zumbido de Turtle en la frecuencia indicada.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| hz | Entrada (bloque) | Frecuencia (Hz) | decimal 0 ~ 6553,5 | - |
Python
turtle = Turtle(0)
turtle.sound_buzz(440)Tocar una nota
Turtle toca la nota indicada.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| note | Opción de desplegable | Nota | Do(C), Do#(C#), Re(D), Re#(D#), Mi(E), Fa(F), Fa#(F#), Sol(G), Sol#(G#), La(A), La#(A#), Si(B) | - |
| octave | Opción de desplegable | Octava | 1, 2, 3, 4, 5, 6, 7 | 4 |
Python
turtle = Turtle(0)
turtle.sound_note('D', 5)Reproducir un sonido
Turtle reproduce un clip de sonido concreto.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| clip | Opción de desplegable | Nombre del clip de sonido | 'mute', 'beep', 'siren', 'engine', 'robot', 'march', 'birthday', 'dibidibidip', 'good_job' y más | - |
| wait | Casilla | Esperar a que termine | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.sound_clip('siren', wait=True)Apagar el sonido
Apaga el sonido de Turtle.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.sound_off()¿Reproduciendo sonido?
Devuelve true si se está reproduciendo sonido y false si no.
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.sound_playing()Velocidad de la rueda
La velocidad de una rueda concreta
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| unit | Opción de desplegable | Rueda afectada | izquierda(left), derecha(right) | - |
Python
turtle = Turtle(0)
turtle.wheel_speed('left')Valor del sensor de color del suelo
El valor del sensor de color de la parte inferior
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.floor()Nombre del color de la tarjeta
El nombre del color de la tarjeta leído con el sensor de color de la parte inferior
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.card_color()Patrón de colores de la tarjeta
El patrón de los colores de la tarjeta leído con el sensor de color de la parte inferior
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.card_pattern()Valor de la aceleración
El valor de la aceleración de la gravedad en un eje concreto
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| unit | Opción de desplegable | Eje medido | x, y, z | - |
Python
turtle = Turtle(0)
turtle.acceleration('x')Valor del sensor de temperatura
El valor del sensor de temperatura
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.temperature()Valor de la intensidad de la señal
La intensidad de la señal
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.signal_strength()Voltaje de la batería
El voltaje de la batería
Parámetros
(ninguno)
Python
turtle = Turtle(0)
turtle.battery()¿Toca un color concreto?
Mide con el sensor de color de Turtle si el robot toca el color indicado y devuelve el resultado como verdadero(True) / falso(False).
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| color | Opción de desplegable | Nombre del color | unknown, red, yellow, green, cyan, blue, magenta, white | - |
Python
turtle = Turtle(0)
turtle.is_card_color('red')¿El patrón de colores de la tarjeta es ~ ?
Devuelve como verdadero(True) / falso(False) si el patrón de colores de la tarjeta reconocido por el sensor de color coincide.
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| pattern | Opción de desplegable | Nombre del patrón de tarjeta | 'red_yellow', 'red_green', 'blue_red' | - |
Python
turtle = Turtle(0)
turtle.is_card_pattern('red_yellow')Estado del botón trasero
Si el botón de la espalda está pulsado o se ha hecho clic en él
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| event | Opción de desplegable | Tipo de estado del botón | pulsado(pressed), clic(click), clic largo(long_click) | - |
Python
turtle = Turtle(0)
turtle.button('pressed')¿Ha cambiado el estado?
Si el estado del robot ha cambiado
Parámetros
| Nombre | Tipo | Descripción | Rango / Tipo | Valor predeterminado |
|---|---|---|---|---|
| unit | Opción de desplegable | Tipo de estado | 0 ~ 5 (ver la tabla siguiente) | - |
| unit | Condición |
|---|---|
| 0 | acceleration('x') > 50 |
| 1 | acceleration('x') < -50 |
| 2 | acceleration('y') > 50 |
| 3 | acceleration('y') < -50 |
| 4 | acceleration('z') > 0 |
| 5 | acceleration('z') < -30 |
Python
turtle = Turtle(0)
# unit = 0
turtle.acceleration('x') > 50