Turtle
Déclarer l'instance
Si tu ajoutes un bloc de Turtle à la zone de travail, la déclaration d'instance suivante est insérée automatiquement dans le code Python :
turtle = Turtle(0)
# s'il y a plusieurs instances
turtle_1 = Turtle(1)Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| index | Option de liste | Numéro de l'instance (commence à 0) | entier supérieur ou égal à 0 | 0 |
Régler la vitesse de la roue
Détermine la vitesse des roues. La plage de la vitesse est -100 ~ 100.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue | gauche(left), droite(right), les deux(both) | - |
| speed | Entrée (bloc) | Vitesse de la roue | entier -100 ~ 100, 0 : arrêt | - |
Python
turtle = Turtle(0)
turtle.set_wheel_speed('both', 50)Avancer d'une distance
Règle la distance à parcourir.
Si tu n'as pas réglé la vitesse des roues, il ne se déplace pas.
Si la valeur de la distance est 0, il continue à se déplacer selon la vitesse actuelle des roues.
Si tu coches la case attendre, il attend que le déplacement soit terminé.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Distance du déplacement | décimal supérieur ou égal à 0 | - |
| unit | Option de liste | Unité de la distance | cm, mm, pouces(inch) | cm |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.move_distance(50, 'cm', wait=True)Avancer un temps
Se déplace pendant le temps indiqué à la vitesse actuelle des roues.
Si tu n'as pas réglé la vitesse des roues, il avance à la vitesse par défaut.
Si tu coches la case attendre, il attend que le déplacement soit terminé.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Temps du déplacement (secondes) | décimal supérieur ou égal à 0 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
# wait = TRUE
turtle.move_time(5, wait=True)
# wait = FALSE
turtle.move_time(0.5, wait=False)Tourner sur place
Règle la direction et l'angle de la rotation sur place.
Si tu coches la case attendre, il attend que la rotation soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| direction | Option de liste | Direction de la rotation | gauche(left), droite(right) | - |
| data | Entrée (bloc) | Angle de la rotation (degrés) | décimal supérieur ou égal à 0 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.turn_degree('left', 90, wait=True)Modifier la vitesse de la roue
Modifie la vitesse des roues de Turtle.
La nouvelle vitesse est la vitesse actuelle plus la vitesse que tu as saisie.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue | gauche(left), droite(right), les deux(both) | - |
| speed | Entrée (bloc) | Écart de vitesse à appliquer | entier -200 ~ 200 | - |
Python
turtle = Turtle(0)
turtle.change_wheel_speed('both', 10)Arrêter
Arrête le déplacement de Turtle.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.stop()La roue est-elle en mouvement ?
Renvoie true si les roues sont en mouvement et false si elles sont arrêtées.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.wheel_moving()Pivoter autour de la roue
Règle le point de référence, la direction et l'angle de la rotation.
Si tu coches la case attendre, il attend que la rotation soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| base | Option de liste | Roue de référence de la rotation | roue gauche(left_wheel), roue droite(right_wheel) | - |
| direction | Option de liste | Direction de la rotation | avant(forward), arrière(backward) | - |
| data | Entrée (bloc) | Angle de la rotation (degrés) | décimal supérieur ou égal à 0 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.pivot('left_wheel', 'forward', 90, wait=True)Dessiner un cercle
Quand tu dessines un cercle avec le stylo, règle la direction, le rayon et l'angle de la rotation.
Si tu coches la case attendre, il attend que la rotation soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| direction | Option de liste | Direction de la rotation | avant gauche(left_forward), arrière gauche(left_backward), avant droite(right_forward), arrière droite(right_backward) | - |
| degree | Entrée (bloc) | Angle de la rotation (degrés) | décimal supérieur ou égal à 0 | - |
| radius | Entrée (bloc) | Rayon de la rotation | décimal supérieur ou égal à 0 | - |
| unit | Option de liste | Unité du rayon | cm, mm, pouces(inch) | cm |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.pivot_circle('left_forward', 90, 1, 'cm', wait=True)Suivre la ligne avec le capteur
Avec le capteur de couleur du sol il suit une ligne d'une couleur donnée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| line | Option de liste | Couleur de la ligne à suivre | noir(black), rouge(red), vert(green), bleu(blue), toutes les couleurs(any) | black |
Python
turtle = Turtle(0)
turtle.trace_line('black')Suivre la ligne jusqu'à une couleur donnée
Avec le capteur de couleur du sol il suit une ligne de la couleur A jusqu'à rencontrer la couleur B.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| line | Option de liste | Couleur de la ligne à suivre | noir(black), rouge(red), vert(green), bleu(blue), toutes les couleurs(any) | - |
| color | Option de liste | Couleur où s'arrêter | noir(black), rouge(red), vert(green), cyan(cyan), bleu(blue), magenta(magenta), toutes les couleurs(any) | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.trace_line_until_color('black', 'red', wait=True)Passer l'intersection et s'arrêter à la suivante
Turtle se déplace à l'intersection dans la direction indiquée puis continue jusqu'à rencontrer l'intersection suivante.
Si tu coches la case attendre, il attend que le déplacement soit terminé.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| direction | Option de liste | Direction à l'intersection | avancer(forward), à gauche(left), à droite(right), demi-tour(uturn) | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.trace_intersection('left', wait=True)Régler la vitesse de suivi de ligne
Règle la vitesse de suivi de ligne. La plage de la vitesse est 1 ~ 10.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Vitesse de suivi de ligne | entier 1 ~ 10 | - |
Python
turtle = Turtle(0)
turtle.set_trace_speed(5)Régler le gain de suivi de ligne
Règle de combien la direction change pendant le suivi de ligne. La plage du gain est 1 ~ 10.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Variation de la direction | entier 1 ~ 10 | - |
Python
turtle = Turtle(0)
turtle.set_trace_gain(5)Arrêter le suivi de ligne
Termine la fonction de suivi de ligne de Turtle.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.stop_trace()Régler la couleur de la LED
Règle la couleur de la LED de la tête de Turtle.
Si tu choisis une couleur dans la palette de couleurs, elle est convertie en nom de couleur (texte en anglais) et appelée ainsi. (le code est généré avec le nom de la couleur, pas avec les valeurs numériques R, G, B.)
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| color | Couleur | Choix dans la palette de couleurs → converti en nom de couleur (en anglais) | noms de couleurs : 'black', 'red', 'yellow', 'green', 'cyan', 'blue', 'magenta', 'white' | - |
Python
turtle = Turtle(0)
turtle.set_led_color('red')Régler la couleur de la LED avec un bloc de la catégorie Couleur
Reçoit en entrée la sortie d'un bloc de la catégorie Couleur ([R, G, B]) et règle la couleur de la LED de la tête.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (couleur) | Bloc de la catégorie Couleur ou tableau [R, G, B] | [0~255, 0~255, 0~255] | - |
Python
turtle = Turtle(0)
turtle.set_led_color(*Utils.color('red'))Changer la couleur de la LED d'une valeur RGB
Ajoute à la couleur actuelle de la LED de la tête les variations R, G, B saisies et règle la nouvelle couleur.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| r | Entrée (champ) | Variation du rouge | entier -255 ~ 255 | 0 |
| g | Entrée (champ) | Variation du vert | entier -255 ~ 255 | 0 |
| b | Entrée (champ) | Variation du bleu | entier -255 ~ 255 | 0 |
Python
turtle = Turtle(0)
turtle.change_led_color(10, 0, 0)Éteindre la LED de la tête
Enlève la couleur de la LED de la tête.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.turn_off()Régler le bourdonnement
Règle le bourdonnement de Turtle à la fréquence indiquée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| hz | Entrée (bloc) | Fréquence (Hz) | décimal 0 ~ 6553,5 | - |
Python
turtle = Turtle(0)
turtle.sound_buzz(440)Jouer une note
Turtle joue la note indiquée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| note | Option de liste | Note | Do(C), Do#(C#), Ré(D), Ré#(D#), Mi(E), Fa(F), Fa#(F#), Sol(G), Sol#(G#), La(A), La#(A#), Si(B) | - |
| octave | Option de liste | Octave | 1, 2, 3, 4, 5, 6, 7 | 4 |
Python
turtle = Turtle(0)
turtle.sound_note('D', 5)Jouer un extrait sonore
Turtle joue un extrait sonore donné.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| clip | Option de liste | Nom de l'extrait sonore | 'mute', 'beep', 'siren', 'engine', 'robot', 'march', 'birthday', 'dibidibidip', 'good_job' et d'autres | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
turtle = Turtle(0)
turtle.sound_clip('siren', wait=True)Désactiver le son
Éteint le son de Turtle.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.sound_off()Le son est-il en cours de lecture ?
Renvoie true si le son est en cours de lecture et false sinon.
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.sound_playing()Valeur de la vitesse de la roue
La vitesse d'une roue donnée
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue à lire | gauche(left), droite(right) | - |
Python
turtle = Turtle(0)
turtle.wheel_speed('left')Valeur du capteur de couleur du sol
La valeur du capteur de couleur du sol
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.floor()Valeur du nom de la couleur de la carte
Le nom de la couleur de la carte lue avec le capteur de couleur du sol
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.card_color()Valeur du motif de couleur de la carte
Le motif de couleur de la carte lu avec le capteur de couleur du sol
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.card_pattern()Valeur de l'accélération de la pesanteur
La valeur de l'accélération de la pesanteur sur un axe donné
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Axe à lire | x, y, z | - |
Python
turtle = Turtle(0)
turtle.acceleration('x')Valeur du capteur de température
La valeur du capteur de température
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.temperature()Valeur de la force du signal
La force du signal
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.signal_strength()Tension de la batterie
La tension de la batterie
Paramètres
(aucun)
Python
turtle = Turtle(0)
turtle.battery()Touche-t-il une couleur donnée ?
Mesure avec le capteur de couleur de Turtle s'il touche la couleur indiquée et renvoie vrai (True) / faux (False).
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| color | Option de liste | Nom de la couleur | unknown, red, yellow, green, cyan, blue, magenta, white | - |
Python
turtle = Turtle(0)
turtle.is_card_color('red')Le motif de couleur de la carte est-il ~ ?
Renvoie vrai (True) / faux (False) selon que le motif de couleur de la carte détecté par le capteur de couleur correspond ou non.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| pattern | Option de liste | Nom du motif de la carte | 'red_yellow', 'red_green', 'blue_red' | - |
Python
turtle = Turtle(0)
turtle.is_card_pattern('red_yellow')État du bouton du dos
Si le bouton qui se trouve sur le dos est pressé ou s'il a été cliqué
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| event | Option de liste | Type d'état du bouton | pressé(pressed), cliqué(click), cliqué longuement(long_click) | - |
Python
turtle = Turtle(0)
turtle.button('pressed')Si l'état a changé
Si l'état du robot a changé
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Type d'état | 0 ~ 5 (voir le tableau ci-dessous) | - |
| unit | Condition |
|---|---|
| 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