Skip to content

Turtle ​

Dichiarare l'istanza ​

Se aggiungi un blocco di Turtle all'area di lavoro, nel codice Python viene inserita automaticamente la dichiarazione di istanza seguente:

python
turtle = Turtle(0)
# se ci sono più istanze
turtle_1 = Turtle(1)

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
indexOpzione di elencoNumero dell'istanza (parte da 0)intero maggiore o uguale a 00

Impostare la velocità della ruota ​

Determina la velocità delle ruote. L'intervallo della velocità è -100 ~ 100.

set_wheel_speed

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoRuotasinistra(left), destra(right), entrambe(both)-
speedIngresso (blocco)Velocità della ruotaintero -100 ~ 100, 0: fermo-

Python ​

python
turtle = Turtle(0)

turtle.set_wheel_speed('both', 50)

Avanzare di una distanza ​

Imposta la distanza da percorrere.
Se non hai impostato la velocità delle ruote, non si muove.
Se il valore della distanza è 0, continua a muoversi secondo la velocità attuale delle ruote.
Se attivi la casella attendi, aspetta che il movimento sia finito.

move_distance

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
dataIngresso (blocco)Distanza del movimentodecimale maggiore o uguale a 0-
unitOpzione di elencoUnità della distanzacm, mm, pollici(inch)cm
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.move_distance(50, 'cm', wait=True)

Muoversi per un tempo ​

Si muove per il tempo indicato alla velocità attuale delle ruote.
Se non hai impostato la velocità delle ruote, avanza alla velocità predefinita.
Se attivi la casella attendi, aspetta che il movimento sia finito.

move_time

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
dataIngresso (blocco)Tempo del movimento (secondi)decimale maggiore o uguale a 0-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

# wait = TRUE
turtle.move_time(5, wait=True)
# wait = FALSE
turtle.move_time(0.5, wait=False)

Girare sul posto ​

Imposta la direzione e l'angolo della rotazione sul posto.
Se attivi la casella attendi, aspetta che la rotazione sia finita.

turn_degree

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
directionOpzione di elencoDirezione della rotazionesinistra(left), destra(right)-
dataIngresso (blocco)Angolo della rotazione (gradi)decimale maggiore o uguale a 0-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.turn_degree('left', 90, wait=True)

Cambiare la velocità della ruota ​

Cambia la velocità delle ruote di Turtle.
La nuova velocità è la velocità attuale più la velocità che hai inserito.

change_speed

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoRuotasinistra(left), destra(right), entrambe(both)-
speedIngresso (blocco)Differenza di velocità da applicareintero -200 ~ 200-

Python ​

python
turtle = Turtle(0)

turtle.change_wheel_speed('both', 10)

Fermarsi ​

Ferma il movimento di Turtle.

stop

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.stop()

La ruota è in movimento? ​

Restituisce true se le ruote sono in movimento e false se sono ferme.

wheel_moving

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.wheel_moving()

Ruotare attorno alla ruota ​

Imposta il punto di riferimento, la direzione e l'angolo della rotazione.
Se attivi la casella attendi, aspetta che la rotazione sia finita.

pivot

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
baseOpzione di elencoRuota di riferimento della rotazioneruota sinistra(left_wheel), ruota destra(right_wheel)-
directionOpzione di elencoDirezione della rotazioneavanti(forward), indietro(backward)-
dataIngresso (blocco)Angolo della rotazione (gradi)decimale maggiore o uguale a 0-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.pivot('left_wheel', 'forward', 90, wait=True)

Disegnare un cerchio ​

Quando disegni un cerchio con la penna, imposta la direzione, il raggio e l'angolo della rotazione.
Se attivi la casella attendi, aspetta che la rotazione sia finita.

pivot_circle

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
directionOpzione di elencoDirezione della rotazioneavanti a sinistra(left_forward), indietro a sinistra(left_backward), avanti a destra(right_forward), indietro a destra(right_backward)-
degreeIngresso (blocco)Angolo della rotazione (gradi)decimale maggiore o uguale a 0-
radiusIngresso (blocco)Raggio della rotazionedecimale maggiore o uguale a 0-
unitOpzione di elencoUnità del raggiocm, mm, pollici(inch)cm
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.pivot_circle('left_forward', 90, 1, 'cm', wait=True)

Seguire la linea con il sensore ​

Con il sensore di colore del pavimento segue una linea di un colore determinato.

trace_line

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
lineOpzione di elencoColore della linea da seguirenero(black), rosso(red), verde(green), blu(blue), qualunque colore(any)black

Python ​

python
turtle = Turtle(0)

turtle.trace_line('black')

Seguire la linea fino a un colore determinato ​

Con il sensore di colore del pavimento segue una linea del colore A fino a incontrare il colore B.

trace_line_until_color

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
lineOpzione di elencoColore della linea da seguirenero(black), rosso(red), verde(green), blu(blue), qualunque colore(any)-
colorOpzione di elencoColore in cui fermarsinero(black), rosso(red), verde(green), ciano(cyan), blu(blue), magenta(magenta), qualunque colore(any)-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.trace_line_until_color('black', 'red', wait=True)

Passare l'intersezione e fermarsi a quella successiva ​

Turtle si muove all'intersezione nella direzione indicata e poi continua fino a incontrare l'intersezione successiva.
Se attivi la casella attendi, aspetta che il movimento sia finito.

intersection

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
directionOpzione di elencoDirezione all'intersezionevai avanti(forward), a sinistra(left), a destra(right), inversione a U(uturn)-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.trace_intersection('left', wait=True)

Impostare la velocità di inseguimento della linea ​

Imposta la velocità di inseguimento della linea. L'intervallo della velocità è 1 ~ 10.

set_trace_speed

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
dataIngresso (blocco)Velocità di inseguimento della lineaintero 1 ~ 10-

Python ​

python
turtle = Turtle(0)

turtle.set_trace_speed(5)

Impostare il guadagno di inseguimento della linea ​

Imposta di quanto cambia la direzione durante l'inseguimento della linea. L'intervallo del guadagno è 1 ~ 10.

set_trace_gain

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
dataIngresso (blocco)Variazione della direzioneintero 1 ~ 10-

Python ​

python
turtle = Turtle(0)

turtle.set_trace_gain(5)

Interrompere l'inseguimento della linea ​

Termina la funzione di inseguimento della linea di Turtle.

stop_trace

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.stop_trace()

Impostare il colore del LED ​

Imposta il colore del LED della testa di Turtle.
Se scegli un colore nella tavolozza dei colori, viene convertito nel nome del colore (testo in inglese) e chiamato così. (il codice viene generato con il nome del colore, non con i valori numerici R, G, B.)

set_led_color

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
colorColoreScelta nella tavolozza dei colori → convertita nel nome del colore (in inglese)nomi dei colori: 'black', 'red', 'yellow', 'green', 'cyan', 'blue', 'magenta', 'white'-

Python ​

python
turtle = Turtle(0)

turtle.set_led_color('red')

Impostare il colore del LED con un blocco della categoria Colore ​

Riceve in ingresso l'uscita di un blocco della categoria Colore ([R, G, B]) e imposta il colore del LED della testa.

set_led_color_with_block

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
dataIngresso (colore)Blocco della categoria Colore o array [R, G, B][0~255, 0~255, 0~255]-

Python ​

python
turtle = Turtle(0)

turtle.set_led_color(*Utils.color('red'))

Cambiare il colore del LED di un valore RGB ​

Somma al colore attuale del LED della testa le variazioni R, G, B inserite e imposta il nuovo colore.

change_by_rgb

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
rIngresso (campo)Variazione del rossointero -255 ~ 2550
gIngresso (campo)Variazione del verdeintero -255 ~ 2550
bIngresso (campo)Variazione del bluintero -255 ~ 2550

Python ​

python
turtle = Turtle(0)

turtle.change_led_color(10, 0, 0)

Spegnere il LED della testa ​

Toglie il colore del LED della testa.

turn_off

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.turn_off()

Impostare la frequenza del cicalino ​

Imposta il cicalino di Turtle alla frequenza indicata.

sound_buzz

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
hzIngresso (blocco)Frequenza (Hz)decimale 0 ~ 6553,5-

Python ​

python
turtle = Turtle(0)

turtle.sound_buzz(440)

Suonare una nota ​

Turtle riproduce la nota indicata.

sound_note

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
noteOpzione di elencoNotaDo(C), Do#(C#), Re(D), Re#(D#), Mi(E), Fa(F), Fa#(F#), Sol(G), Sol#(G#), La(A), La#(A#), Si(B)-
octaveOpzione di elencoOttava1, 2, 3, 4, 5, 6, 74

Python ​

python
turtle = Turtle(0)

turtle.sound_note('D', 5)

Riprodurre un clip audio ​

Turtle riproduce un clip audio determinato.

sound_clip

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
clipOpzione di elencoNome del clip audio'mute', 'beep', 'siren', 'engine', 'robot', 'march', 'birthday', 'dibidibidip', 'good_job' e altri-
waitCasella di controlloSe aspettare la fineTRUE / FALSETRUE

Python ​

python
turtle = Turtle(0)

turtle.sound_clip('siren', wait=True)

Disattivare il suono ​

Spegne il suono di Turtle.

sound_off

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.sound_off()

Il suono è in riproduzione? ​

Restituisce true se il suono è in riproduzione e false se non lo è.

sound_playing

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.sound_playing()

Valore della velocità della ruota ​

La velocità di una ruota determinata

wheel_speed

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoRuota da leggeresinistra(left), destra(right)-

Python ​

python
turtle = Turtle(0)

turtle.wheel_speed('left')

Valore del sensore di colore del pavimento ​

Il valore del sensore di colore del pavimento

floor

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.floor()

Valore del nome del colore della scheda ​

Il nome del colore della scheda letto con il sensore di colore del pavimento

card_color

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.card_color()

Valore della sequenza di colori della scheda ​

La sequenza dei colori della scheda letta con il sensore di colore del pavimento

card_pattern

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.card_pattern()

Valore dell'accelerazione di gravità ​

Il valore dell'accelerazione di gravità su un asse determinato

acceleration

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoAsse da leggerex, y, z-

Python ​

python
turtle = Turtle(0)

turtle.acceleration('x')

Valore del sensore di temperatura ​

Il valore del sensore di temperatura

temperature

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.temperature()

Valore della potenza del segnale ​

La potenza del segnale

signal_strength

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.signal_strength()

Tensione della batteria ​

La tensione della batteria

battery

Parametri ​

(nessuno)

Python ​

python
turtle = Turtle(0)

turtle.battery()

Tocca un colore determinato? ​

Misura con il sensore di colore di Turtle se tocca il colore indicato e restituisce vero (True) / falso (False).

color_read

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
colorOpzione di elencoNome del coloreunknown, red, yellow, green, cyan, blue, magenta, white-

Python ​

python
turtle = Turtle(0)

turtle.is_card_color('red')

La sequenza di colori della scheda è ~ ? ​

Restituisce vero (True) / falso (False) a seconda che la sequenza dei colori della scheda rilevata dal sensore di colore corrisponda o no.

pattern_read

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
patternOpzione di elencoNome della sequenza della scheda'red_yellow', 'red_green', 'blue_red'-

Python ​

python
turtle = Turtle(0)

turtle.is_card_pattern('red_yellow')

Stato del pulsante posteriore ​

Se il pulsante che sta sul dorso è premuto oppure se è stato cliccato

button

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
eventOpzione di elencoTipo di stato del pulsantepremuto(pressed), cliccato(click), cliccato a lungo(long_click)-

Python ​

python
turtle = Turtle(0)

turtle.button('pressed')

Se lo stato è cambiato ​

Se lo stato del robot è cambiato

state_change

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoTipo di stato0 ~ 5 (vedi la tabella qui sotto)-
unitCondizione
0acceleration('x') > 50
1acceleration('x') < -50
2acceleration('y') > 50
3acceleration('y') < -50
4acceleration('z') > 0
5acceleration('z') < -30

Python ​

python
turtle = Turtle(0)

# unit = 0
turtle.acceleration('x') > 50