Turtle

Instanz deklarieren

Wenn du einen Turtle-Block zum Arbeitsbereich hinzufügst, wird im Python-Code automatisch die folgende Instanzdeklaration eingefügt:

turtle = Turtle(0)
# wenn es mehrere Instanzen gibt
turtle_1 = Turtle(1)

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
index	Dropdown-Option	Instanznummer (beginnt bei 0)	ganze Zahl ≥ 0	0

Radgeschwindigkeit setzen

Legt die Radgeschwindigkeit fest. Der Bereich der Geschwindigkeit ist -100 ~ 100.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Rads	links(left), rechts(right), beide(both)	-
speed	Eingabe (Block)	Radgeschwindigkeit	ganze Zahl -100 ~ 100, 0: Stopp	-

Python

turtle = Turtle(0)

turtle.set_wheel_speed('both', 50)

Strecke bewegen

Legt die zu fahrende Strecke fest.
Ist keine Radgeschwindigkeit gesetzt, bewegt sich der Roboter nicht.
Ist der Streckenwert 0, bewegt er sich entsprechend der aktuellen Radgeschwindigkeit weiter.
Wenn du warten aktivierst, wird gewartet, bis die Bewegung abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Strecke	reelle Zahl ≥ 0	-
unit	Dropdown-Option	Längeneinheit	cm, mm, Zoll(inch)	cm
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Zeit bewegen

Bewegt sich mit der aktuellen Radgeschwindigkeit für die angegebene Zeit.
Ist keine Radgeschwindigkeit gesetzt, bewegt sich der Roboter mit der Standardgeschwindigkeit vorwärts.
Wenn du warten aktivierst, wird gewartet, bis die Bewegung abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Zeit (Sekunden)	reelle Zahl ≥ 0	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Auf der Stelle drehen

Legt Richtung und Winkel für die Drehung auf der Stelle fest.
Wenn du warten aktivierst, wird gewartet, bis die Drehung abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
direction	Dropdown-Option	Drehrichtung	links(left), rechts(right)	-
data	Eingabe (Block)	Drehwinkel (Grad)	reelle Zahl ≥ 0	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Radgeschwindigkeit ändern

Ändert die Radgeschwindigkeit von Turtle.
Die eingegebene Geschwindigkeit wird zur aktuellen Radgeschwindigkeit addiert und ergibt die neue Radgeschwindigkeit.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Rads	links(left), rechts(right), beide(both)	-
speed	Eingabe (Block)	Geschwindigkeitsdifferenz	ganze Zahl -200 ~ 200	-

Python

turtle = Turtle(0)

turtle.change_wheel_speed('both', 10)

Anhalten

Stoppt die Bewegung von Turtle.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.stop()

Rad bewegt sich?

Gibt true zurück, wenn sich das Rad bewegt, und false, wenn es stillsteht.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.wheel_moving()

Um ein Rad schwenken

Legt den Drehpunkt, die Richtung und den Winkel fest.
Wenn du warten aktivierst, wird gewartet, bis die Drehung abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
base	Dropdown-Option	Rad als Drehpunkt	linkes Rad(left_wheel), rechtes Rad(right_wheel)	-
direction	Dropdown-Option	Drehrichtung	vorwärts(forward), rückwärts(backward)	-
data	Eingabe (Block)	Drehwinkel (Grad)	reelle Zahl ≥ 0	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Kreis zeichnen

Legt beim Zeichnen eines Kreises mit dem Stift die Richtung, den Radius und den Winkel fest.
Wenn du warten aktivierst, wird gewartet, bis die Drehung abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
direction	Dropdown-Option	Drehrichtung	links vorwärts(left_forward), links rückwärts(left_backward), rechts vorwärts(right_forward), rechts rückwärts(right_backward)	-
degree	Eingabe (Block)	Drehwinkel (Grad)	reelle Zahl ≥ 0	-
radius	Eingabe (Block)	Radius	reelle Zahl ≥ 0	-
unit	Dropdown-Option	Einheit des Radius	cm, mm, Zoll(inch)	cm
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Linie folgen

Folgt mit dem Farbsensor am Boden einer Linie in einer bestimmten Farbe.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
line	Dropdown-Option	Farbe der Linie	schwarz(black), rot(red), grün(green), blau(blue), alle Farben(any)	black

Python

turtle = Turtle(0)

turtle.trace_line('black')

Linie bis zu einer Farbe folgen

Folgt mit dem Farbsensor am Boden der Linie in Farbe A, bis die Farbe B erreicht wird.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
line	Dropdown-Option	Farbe der Linie	schwarz(black), rot(red), grün(green), blau(blue), alle Farben(any)	-
color	Dropdown-Option	Farbe zum Anhalten	schwarz(black), rot(red), grün(green), cyan(cyan), blau(blue), magenta(magenta), alle Farben(any)	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

An der Kreuzung fahren

Turtle fährt an der Kreuzung in die angegebene Richtung und folgt dann der Linie, bis er die nächste Kreuzung erreicht.
Wenn du warten aktivierst, wird gewartet, bis die Fahrt abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
direction	Dropdown-Option	Fahrtrichtung an der Kreuzung	geradeaus fahren(forward), links(left), rechts(right), wenden(uturn)	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Linienfolgegeschwindigkeit setzen

Legt die Geschwindigkeit der Linienfolge fest. Der Bereich ist 1 ~ 10.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Geschwindigkeit der Linienfolge	ganze Zahl 1 ~ 10	-

Python

turtle = Turtle(0)

turtle.set_trace_speed(5)

Linienfolge-Verstärkung setzen

Legt die Richtungsänderung bei der Linienfolge fest. Der Bereich ist 1 ~ 10.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Richtungsänderung	ganze Zahl 1 ~ 10	-

Python

turtle = Turtle(0)

turtle.set_trace_gain(5)

Linienfolge beenden

Beendet die Linienfolge von Turtle.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.stop_trace()

Kopf-LED-Farbe setzen

Legt die Farbe der Kopf-LED von Turtle fest.
Wenn du in der Farbpalette eine Farbe wählst, wird sie in den Farbnamen (englische Zeichenkette) umgewandelt und so aufgerufen. (Der Code verwendet den Farbnamen und nicht die R-, G-, B-Zahlenwerte.)

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
color	Farbe	Auswahl in der Farbpalette → Umwandlung in den Farbnamen (englisch)	Farbnamen: 'black', 'red', 'yellow', 'green', 'cyan', 'blue', 'magenta', 'white'	-

Python

turtle = Turtle(0)

turtle.set_led_color('red')

Kopf-LED-Farbe mit einem Block der Kategorie Farbe setzen

Nimmt die Ausgabe eines Blocks der Kategorie Farbe ([R, G, B]) als Eingabe und setzt damit die Farbe der Kopf-LED.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Farbe)	Block der Kategorie Farbe oder Array [R, G, B]	[0~255, 0~255, 0~255]	-

Python

turtle = Turtle(0)

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

LED-Farbe um RGB ändern

Addiert die eingegebenen R-, G-, B-Änderungen zur aktuellen Farbe der Kopf-LED und setzt so eine neue Farbe.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
r	Eingabe (Feld)	Änderung von Rot	ganze Zahl -255 ~ 255	0
g	Eingabe (Feld)	Änderung von Grün	ganze Zahl -255 ~ 255	0
b	Eingabe (Feld)	Änderung von Blau	ganze Zahl -255 ~ 255	0

Python

turtle = Turtle(0)

turtle.change_led_color(10, 0, 0)

Kopf-LED ausschalten

Löscht die Farbe der Kopf-LED.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.turn_off()

Summton einstellen

Legt den Summton von Turtle mit der angegebenen Frequenz fest.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
hz	Eingabe (Block)	Frequenz (Hz)	reelle Zahl 0 ~ 6553,5	-

Python

turtle = Turtle(0)

turtle.sound_buzz(440)

Note spielen

Turtle spielt die angegebene Note.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
note	Dropdown-Option	Note	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	Dropdown-Option	Oktave	1, 2, 3, 4, 5, 6, 7	4

Python

turtle = Turtle(0)

turtle.sound_note('D', 5)

Soundclip abspielen

Turtle spielt einen bestimmten Soundclip ab.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
clip	Dropdown-Option	Name des Soundclips	'mute', 'beep', 'siren', 'engine', 'robot', 'march', 'birthday', 'dibidibidip', 'good_job' usw.	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

turtle = Turtle(0)

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

Ton ausschalten

Schaltet den Ton von Turtle aus.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.sound_off()

Ton wird abgespielt?

Gibt true zurück, wenn ein Ton abgespielt wird, und false, wenn nicht.

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.sound_playing()

Radgeschwindigkeit

Die Geschwindigkeit eines bestimmten Rads

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ziel-Rad	links(left), rechts(right)	-

Python

turtle = Turtle(0)

turtle.wheel_speed('left')

Bodenfarbsensor

Wert des Farbsensors am Boden

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.floor()

Kartenfarbe

Der Name der Kartenfarbe, die über den Farbsensor am Boden gelesen wurde

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.card_color()

Kartenfarbmuster

Das Muster der Kartenfarbe, das über den Farbsensor am Boden gelesen wurde

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.card_pattern()

Beschleunigung

Der Wert der Erdbeschleunigung auf einer bestimmten Achse

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Gemessene Achse	x, y, z	-

Python

turtle = Turtle(0)

turtle.acceleration('x')

Temperatur

Wert des Temperatursensors

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.temperature()

Signalstärke

Signalstärke

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.signal_strength()

Batterie

Batteriespannung

Parameter

(keine)

Python

turtle = Turtle(0)

turtle.battery()

Berührt eine Farbe?

Misst mit dem Farbsensor von Turtle, ob eine bestimmte Farbe berührt wird, und gibt true(True) / false(False) zurück.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
color	Dropdown-Option	Farbname	unknown, red, yellow, green, cyan, blue, magenta, white	-

Python

turtle = Turtle(0)

turtle.is_card_color('red')

Kartenmuster ist ~ ?

Gibt zurück, ob das vom Farbsensor erkannte Kartenfarbmuster übereinstimmt, als true(True) / false(False).

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
pattern	Dropdown-Option	Name des Kartenmusters	'red_yellow', 'red_green', 'blue_red'	-

Python

turtle = Turtle(0)

turtle.is_card_pattern('red_yellow')

Rückseitentaste

Ob die Taste auf der Rückseite gedrückt oder geklickt wurde

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
event	Dropdown-Option	Art des Tastenzustands	gedrückt(pressed), geklickt(click), lange geklickt(long_click)	-

Python

turtle = Turtle(0)

turtle.button('pressed')

Zustandsänderung

Ob sich der Zustand des Roboters geändert hat

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Zustands	0 ~ 5 (siehe Tabelle unten)	-

unit	Bedingung
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