Der CindyScript Editor - Cinderella Dokumentation
Description: The user's guide to the Interactive Geometry Software Cinderella

Zum Inhalt

# Der CindyScript Editor

## CindyScript-Code eingeben

### Der CindyScript Editor

Um CindyScript zu nutzen, kann man den Editor verwenden, der im Menü Scripting/Edit Scripts verfügbar ist. Hier erklären wir kurz, wie man den Editor nutzt.

Der Script Editor

#### Das Eingabefenster

Der Script Editor zeigt eine Ansicht mit drei Bereichen. Auf der linken Seite sehen Sie einen Überblick über alle Occasionen (siehe unten) und die zugehörigen Skripte. Auf der rechten Seite sehen Sie unter einem Bereich mit Start-, Stop- und Hilfe-Schaltflächen sowie einem Feld zum Eingeben von Skriptnamen einen großen Textbereich zum Bearbeiten (d.h. Eingeben) von Skripten und einen kleineren Textbereich, der die Ausgabe der Skripte anzeigt.

#### Occasionen

Cinderella ist hochinteraktiv, und deshalb gibt es viele „Occasionen", die zum Auslösen der Ausführung von CindyScript-Befehlen geeignet sind. Auf der linken Seite des Script Editors sehen Sie die verfügbaren Occasionen.

Normalerweise schreiben Sie Skripte für die Occasion „Draw". Diese werden ausgeführt, wenn die Ansicht gerendert wird. Um ein Skript zu bearbeiten, klicken Sie zunächst auf „Draw".

Skripte für die Draw-Occasion eingeben.

Der Bearbeitungsbereich zeigt die Meldung „Enter your script here" an. Klicken Sie darauf und beginnen Sie, Text einzugeben.

In der Ansicht werden Sie eine Diagonale aus grünen Punkten bemerken, die durch das Skript erstellt wurden.

Sie finden einen Überblick über alle Occasionen in der Einführung in CindyScript.

### Die Shell

Sie können auch CindyScript-Befehle eingeben und sofort ausführen lassen. Wählen Sie einfach das Element „Shell" aus dem linken Bereich und geben Sie die Befehle in den Textbereich auf der rechten Seite ein. Wenn Sie Shift+Enter drücken, wird der eingegebene Befehl ausgeführt und Sie sehen die Ein- und Ausgabe im unteren Textbereich. Sie können Shift+Auf-Pfeiltaste und Shift+Ab-Pfeiltaste verwenden, um durch den Befehlsverlauf zu scrollen.

### Die Befehlszeile

Verwenden der Befehlszeile zum Verschieben eines Punkts

Manchmal ist es sehr praktisch, Konstruktionen mit CindyScript-Befehlen zu manipulieren. Sie können dies entweder mit dem Shell-Fenster wie oben beschrieben tun oder für kurze Befehle die in die Konstruktionsansicht integrierte Befehlszeile verwenden. Um sie zu aktivieren, wählen Sie „Scripting/Command Line" aus dem Menü oder drücken Sie die entsprechende Tastenkombination Ctrl+Enter (Windows und Unix) oder CMD+Enter (Mac OS X).

Die Befehlszeile befindet sich unter der Statusleiste. Sie können beliebige CindyScript-Funktionen eingeben und durch Drücken der Eingabetaste evaluieren. Wenn Sie Shift+Enter drücken, wird der Code auf dieselbe Weise evaluiert, aber das Eingabefeld der Befehlszeile wird nicht gelöscht. Sie können dies verwenden, wenn Sie mehrere ähnliche Befehle erteilen möchten oder wenn Sie die korrekte Syntax durch Ausprobieren suchen.

Wenn Sie das Kontrollkästchen permanent rechts neben der Befehlszeile aktivieren, wird der Code in der Draw-Occasion gespeichert und somit ausgewertet, wenn die Konstruktion neu gezeichnet wird. Sie können auf den Code zugreifen, indem Sie den Script Editor wie oben erläutert öffnen.

Als schnelles Beispiel zeigen wir, wie man einen Punkt C permanent zum Mittelpunkt zweier Punkte A und B verschiebt: Zeichnen Sie die drei Punkte, aktivieren Sie die Befehlszeile, geben Sie `C.xy=(A+B)/2` ein und aktivieren Sie das Kontrollkästchen permanent.

Verwenden der Befehlszeile zum Verschieben eines Punkts

Nach dem Drücken der Eingabetaste bewegt sich C zum Mittelpunkt von A und B und bleibt dort, auch wenn sich A oder B bewegt. Das Überprüfen des Script Editors zeigt das automatisch generierte Draw-Occasion-Skript mit dem Namen CommandLine.

Verwenden des Permanent-Kontrollkästchens

### CindyScript und der Inspector

Viele Texteingabefelder des Inspector-Fensters akzeptieren CindyScript-Code als Eingabe. Das Skript wird nur einmal evaluiert – wenn Sie permanente Änderungen vornehmen möchten, müssen Sie entweder die Befehlszeile oder die Draw-Occasion im Script Editor verwenden. Nach dem Drücken der Eingabetaste können Sie Ihren CindyScript-Code immer noch sehen, aber wenn das Eingabefeld den Fokus verliert, wird sein Wert durch das Evaluationsergebnis ersetzt.

Das automatisch generierte Befehlszeilen-Skript

### Klickbare Schaltflächen

Textobjekte können durch Aktivieren des Feldes Use as button im Inspector in eine klickbare Schaltfläche umgewandelt werden. Sie können CindyScript-Code an die Schaltfläche anhängen, der jedes Mal ausgeführt wird, wenn der Benutzer darauf klickt. Da das Feld für Skript-Code sehr klein ist, empfehlen wir, einfach Funktionen aufzurufen, die im init-Skript der Konstruktion definiert sind.

### Weitere Sprachen

Sie können die Programmiersprache, die zum Interpretieren eines Skripts verwendet wird, über das Auswahlfeld im oberen Bereich auswählen. Verfügbare Sprachen sind CindyScript, Python, JRuby und CDY, die interne Sprache, die zum Speichern von Konstruktionen verwendet wird. Derzeit unterstützen wir jedoch nur CindyScript, und dies ist auch die einzige Sprache, die Sie in Cinderella-Applets verwenden können.

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