Programmcode eingeben - Cinderella Dokumentation
Description: The user's guide to the Interactive Geometry Software Cinderella

Zum Inhalt

# Programmcode eingeben

Der Editor für CindyScript-Code kann durch Auswahl des Menüpunkts Scripting/Edit Scripts geöffnet werden. Wenn dieser Punkt ausgewählt wird, öffnet sich ein Fenster für den Programm-Code-Editor. Jede Konstruktion hat ein individuelles Programm-Editor-Fenster. Wenn es zum ersten Mal geöffnet wird, sieht das Editor-Fenster wie folgt aus:

Der Script-Editor

Dieses Fenster enthält mehrere Komponenten, die einer Erklärung bedürfen. Der Hauptteil des Fensters wird von einem großen weißen Bereich (der mittlere Teil der rechten Seite) eingenommen. Dies ist das Textfeld, in dem Sie später Ihr Skript eingeben. Die linke Seite des Fensters wird von einer „Baumansicht" eingenommen, in der Sie einen Zeitpunkt auswählen können, zu dem ein Skript ausgeführt werden soll. Der erste Schritt beim Eingeben eines Skripts besteht darin, einen geeigneten Zeitpunkt zu wählen.

Der untere Teil der rechten Seite ist für die Konsolenausgabe reserviert, während der obere Teil des Fensters einige Steuerelemente und ein Feld enthält, in dem Sie einen Namen für Ihr Skript eingeben können.

### Ein kleines Skript eingeben

Der erste Schritt beim Eingeben eines Skripts besteht darin, den Zeitpunkt zu wählen, zu dem das Skript ausgeführt werden soll. Dafür muss man auf eines der auf der linken Seite angezeigten „Ereignisse" klicken. Wählen wir das Ereignis „Draw". Ein Skript, das im Draw-Ereignis eingegeben wird, wird immer ausgeführt, wenn auf dem Bildschirm gezeichnet wird. Nachdem dieser Eintrag ausgewählt wurde, ist der Hauptteil des Fensters eingabebereit. Durch Klicken im Hauptfenster können Sie Skriptcode eingeben. Im Beispiel unten wurde ein kleines Skript eingegeben und erhielt den Titel „My first script".

Text eingeben

Durch Drücken der Schaltfläche mit den zwei Zahnrädern wird das Skript ausgeführt. Im obigen Beispiel wird eine grüne gepunktete Linie mit zehn einfachen Punkten gezeichnet. Alternativ kann die Ausführung durch Drücken von + gestartet werden.

### Ausführungs-Slots

Jedes Skript in Cinderella ist mit einem Zeitpunkt verbunden, zu dem es ausgeführt wird. Da Skripte in Cinderella während der Laufzeit des Programms ausgeführt werden sollen, kann es vorkommen, dass dasselbe Skript während einer Bewegung mehrmals ausgeführt wird. Die genaue Interpretation der verschiedenen Gelegenheiten wird unten beschrieben:

- Draw: Ein Skript in diesem Slot wird direkt vor der Generierung eines neuen Bildschirmbildes ausgeführt. Hier eingegebene Skripte werden sehr häufig ausgeführt. Dies ist der typische Ort, um ein Skript einzugeben, das automatisch aktualisiert werden soll, wenn der Benutzer geometrische Elemente zieht.

- Move: Skripte in diesem Slot werden noch häufiger ausgeführt als solche im Slot „Draw". Sie werden immer aufgerufen, wenn sich die Position freier Elemente geändert hat. Im Allgemeinen geschieht dies häufiger als nur bei der Bildschirmaktualisierung. Manchmal führt das Platzieren eines Skripts im Slot „Draw" zu seltsamen und unerwarteten Ergebnissen. Es könnte dann eine gute Idee sein, es im Slot „Move" zu platzieren.

- Initialization: Ein Skript in diesem Slot wird ausgeführt, wenn die Parse-Schaltfläche des Script-Editors gedrückt wird. Dieser Slot ist sehr nützlich, um Variablen oder Punkte in einen Anfangszustand oder eine Anfangsposition zurückzusetzen.

- Timer Tick: Ein Skript in diesem Slot führt dazu, dass ein Animation-Controller in der geometrischen Ansicht angezeigt wird (falls noch nicht vorhanden). Wenn die Play-Schaltfläche des Animation-Controllers gedrückt wird, wird ein Skript in diesem Slot regelmäßig alle paar Millisekunden ausgeführt.

- Integration Tick: Dieses Ereignis ist nur im Kontext von Physik-Simulationen relevant. Wenn ein Skript in diesem Slot enthalten ist, wird es ausgeführt, wenn die interne Physik-Simulations-Engine Informationen über die Position und Kräfte von Massen erfordert. Dieser Slot wird benötigt, wenn man benutzerdefinierte Kraft-Potenziale implementieren möchte.

- Simulation Start: Dieses Skript wird ausgeführt, wenn der Animation-Controller von „Stop" zu „Play" wechselt. Es ist ein sehr guter Ort, um anfängliche Setups für Animationen einzugeben.

- Simulation Stop: Dieses Skript wird ausgeführt, wenn der Animation-Controller von „Play" zu „Stop" wechselt. Es ist ein sehr guter Ort, um das Ergebnis einer Animation zu bewerten.

- Mouse Down: Dieser Slot und die folgenden drei Slots sind sehr nützlich für die Programmierung von Benutzeroberflächen in CindyScript. Ein Skript in diesem Slot wird ausgeführt, wenn die Maustaste gedrückt wird. Mit der Funktion `mouse()` können die aktuellen Mauskoordinaten innerhalb eines Skripts gelesen werden.

- Mouse Up: Skripte in diesem Slot werden ausgeführt, wenn die Maus freigegeben wird.

- Mouse Click: Skripte in diesem Slot werden ausgeführt, wenn die Maus bewegt wird.

- Mouse Drag: Skripte in diesem Slot werden ausgeführt, wenn die Maus gezogen wird.

- Key Typed: Skripte in diesem Slot werden ausgeführt, wenn eine Taste auf der Tastatur eingegeben wird. Dieser Slot ist sehr nützlich für die Bearbeitung von Benutzereingaben über die Tastatur. Eine Zeichenkette, die der aktuell gedrückten Taste entspricht, kann über die Funktionen `key()` und `keydownlist()` aufgerufen werden.

- Key Down: Skripte in diesem Slot werden ausgeführt, wenn eine Taste auf der Tastatur gedrückt wird, genau in dem Moment, wenn die Taste nach unten geht.

- Key Up: Skripte in diesem Slot werden ausgeführt, wenn eine Taste auf der Tastatur freigegeben wird, genau in dem Moment, wenn die Taste nach oben geht.

### Steuerelemente

Im oberen Teil des Script-Editor-Fensters befinden sich zwei Schaltflächen zum Starten und Stoppen des Programms, ein Textfeld zum Bereitstellen von Namen für Teile des Programms und eine Sprachauswahl zum Wechsel zwischen verschiedenen Sprachen (derzeit ist nur CindyScript dokumentiert).

Die Script-Steuerelemente

Der vielleicht wichtigste Teil dieser Steuerelemente ist die Schaltfläche „Play" (die mit den zwei Zahnrädern). Wenn diese Schaltfläche gedrückt wird, werden alle Skripte analysiert und die Ausführung des Programms wird gestartet. Jede Änderung in einem Programm erfordert, dass die Play-Schaltfläche gedrückt wird, um aktiv zu werden. Alternativ kann die Tastenkombination + als Äquivalent zum Drücken der Play-Schaltfläche verwendet werden.

Es kann vorkommen, dass ein Skript in einer Endlosschleife stecken bleibt oder eine Berechnung durchführt, die einfach zu lange dauert. Als eine Art Notausgang kann die Schaltfläche „Stop" gedrückt werden.

Das kleine Textfeld auf der linken Seite kann verwendet werden, um einem Skript einen individuellen Namen zu geben. Skripte mit unterschiedlichen Namen können separat aufgerufen und bearbeitet werden.

Schließlich gibt es ein Dropdown-Menü zur Auswahl der Sprache für das Skript. In dieser Dokumentation finden Sie alle notwendigen Informationen zur Programmierung in CindyScript. Es ist jedoch auch möglich, in „Python", „JRuby" oder in der Core-Cinderella-Geometrie-Sprache zu programmieren. Diese Optionen werden später und an anderer Stelle dokumentiert.

Weitere Informationen zu den Möglichkeiten, Code einzugeben, finden Sie in dem entsprechenden Abschnitt des Referenzhandbuchs.

Diese Seite wurde automatisch mit KI (Claude) übersetzt und wartet noch auf Überprüfung. → Alle KI-übersetzten Seiten