Entering Program Code
Entering Program Code
The editor for CindyScript code can be opened by selecting the menu item Scripting/Edit Scripts. When this item is selected, a window for the program code editor is opened. Each construction has an individual program editor window. When first opened, the editor window looks as follows:
This window contains several components that require explanation. The main part of the window is occupied by a large white space (the middle part of the right side). This is the text field in which you will enter your script later on. The left side of the window is occupied by a "tree view," in which you can select an occasion upon which a script should be executed. The first step in entering a script consists in choosing a suitable occasion.
The lower part of the right side is reserved for console output, while the top part of the window contains some controls and a field in which you can enter a name for your script.
Entering a Small Script
The first step in entering a script consists in choosing the occasion on which the script is to be executed. For this, one has to click on one of the "Events" shown on the left. Let us choose the "Draw" event. A script entered in the Draw event will always be executed when drawing is performed on the screen. After this entry has been selected, the main part of the window is ready for input. Clicking in the main window allows one to enter script code. In the example shown below a small script was entered and given the title "My first script"
Pressing the button with the two gears executes the script. In the above example a green dotted line will be drawn consisting of ten simple dots. Alternatively the execution can be started by pressing <shift>+<enter>.
Every script in Cinderella is associated with an occasion on which it will be executed. Since scripts in Cinderella are assumed to run during the runtime of the program, it may well happen that the same script is executed many times during a move. The precise interpretation of the different occasions is described below:
In the upper part of the script editor window are two buttons to start and stop the program, as well as a text field to provide names to parts of the program and a language chooser for switching between different languages (at present, only CindyScript is documented).
Perhaps the most important part of these controls is the "Play" button (the one with the two gears). Whenever this button is pressed all scripts are parsed and the execution of the program is started. Every change in a program requires the play button to be pressed to become active. Alternatively, the key combination <shift>+<enter> can be used as an equivalent for pressing the play button.
It may happen that a script gets stuck in an infinite loop or performs a calculation that simply takes too long. As a kind of emergency exit, the "Stop" button can be pressed.
The little text field on the left can be used to give a script an individual name. Scripts with different names can be accessed and edited separately.
Finally, there is a drop-down menu for choosing the language for the script. In this documentation you will find all necessary information for programming in CindyScript. However, it is also possible to program in "Python", "JRuby" or in the core Cinderella geometry language. These options will be documented later and elsewhere.
You find more information about the ways to enter code in the corresponding section of the reference manual.
Contributors to this page: Kortenkamp
The content on this page is licensed under the terms of the License.