Using &kturtle;Here is a screenshot of &kturtle; in action&kturtle; Main WindowThe main window of &kturtle; has three main parts: the editor (1) on the left where you type the &turtlescript; commands, the the canvas (2) on the right where the turtle make your drawing, and the inspector (3) which gives you information when your program executes. Besides these you find the menu bar (5) from where all the actions can be reached, the toolbar (4) that allows you to quickly select the most used actions, the Console, that you can use to enter a one line command to test it, and the statusbar (along the bottom of the window) where you will find feedback on the state of &kturtle;.The EditorIn the editor you type the &turtlescript; commands. Most of functions of the editor can be found in the File and Edit menus. The editor can be docked on each border of the main window or it can be detached and placed anywhere on your desktop.You have several ways to get some code in the editor. The easiest way is to use an example: choose FileExamples in the File menu and select an example. The file example you choose will be opened in the the editor, you can then use RunRun from the menubar or the Run from the toolbar to run the code if you like.You can open &turtlescript; files by choosing FileOpen....The third way is to directly type your own code in the editor or to copy/paste some code.The CanvasThe canvas is the domain of the turtle, here the turtle draws according to the commands it gets. After getting some code in the Editor and executing it, two things can happen: either the code executes fine, and will you most likely see something change on the canvas; or you have made an error in your code in that case the error tab will appear explaining you what mistake you made.You can zoom in and out the canvas with your mouse wheel.The InspectorThe inspector informs you about the variables, the learned functions and show the code tree while the program is running.The inspector can be docked on each border of the main window or it can be detached and placed anywhere on your desktop.The ToolbarHere you can quickly reach the most used actions. The Toolbar also contains the Console where you can quickly invoke commands, this might be useful in case you want to test a command without modifying the content of the Editor.You can configure the toolbar using SettingsConfigure Toolbars... to better fit your preferences.The MenubarIn the menubar you find all the actions of &kturtle;. They are in the following groups: File, Edit, Canvas, Run, Tools, Settings, and Help. This section describes them all.The File Menu&Ctrl;NFileNewCreates a new, empty &turtlescript; file.&Ctrl;OFileOpen...Opens a &turtlescript; file.FileOpen RecentOpens a &turtlescript; file that has been opened recently.FileExamplesOpen example &turtlescript; programs. The examples are in your favorite language that you can choose in SettingsScript Language.&Ctrl;SFileSaveSaves the currently opened &turtlescript; file.FileSave As...Saves the currently opened &turtlescript; file on a specified location.FileExport to HTML...Exports the current content of the Editor as an HTML file that includes highlighting colors.&Ctrl;PFilePrint...Prints the current code in the editor.&Ctrl;QFileQuitQuits &kturtle;.The Edit Menu&Ctrl;ZEditUndoUndoes the last change to code. &kturtle; has unlimited undos.&Ctrl;&Shift;ZEditRedoRedoes an undone change to the code.&Ctrl;XEditCutCuts the selected text from the editor to the clipboard.&Ctrl;CEditCopyCopies the selected text from the editor to the clipboard.&Ctrl;VEditPastePastes the text from the clipboard to the editor.&Ctrl;AEditSelect AllSelects all the text from the editor.&Ctrl;FEditFind...With this action you can find phrases in the code.F3EditFind NextUse this to find the next occurrence of the phrase you searched for.&Shift;F3EditFind PreviousUse this to find the previous occurrence of the phrase you searched for.InsEditOverwrite ModeToggle between the 'insert' and 'overwrite' mode.The Canvas MenuCanvasExport to Image (PNG)...Exports the current content of the Canvas as a raster image of the PNG (Portable Network Graphics) type.CanvasExport to Drawing (SVG)...Exports the current content of the Canvas as a vector drawing of the SVG (Scalable Vector Graphics) type.CanvasPrint Canvas...Prints the current content of the Canvas.The Run MenuF5RunRunStarts the execution of the commands in the editor.F6RunPausePauses the execution. This action is only enabled when the commands are actually executing.F7RunAbortStops the execution. This action is only enabled when the commands are actually executing.RunRun SpeedPresent a list of possible execution speeds, consisting of: Full Speed, Slow, Slower, Slowest and Step-by-Step. When the execution speed is set to Full Speed (default) we can barely keep up with what is happening. Sometimes this behavior is wanted, but sometimes we want to keep track of the execution. In the latter case you want to set the execution speed to Slow, Slower or Slowest. When one of the slow modes is selected the current position of the executor will be shown in the editor. Step-by-Step will execute one command at a time.The Tools MenuToolsDirection Chooser...This action opens the direction chooser dialog.ToolsColor Picker...This action opens the color picker dialog.The Settings MenuSettingsScript LanguageChoose the language for the code.&Ctrl;ESettingsShow EditorShow or hide the Editor.&Ctrl;ISettingsShow InspectorShow or hide the inspector.SettingsShow ErrorsShow or hide the Error tab with a list of errors resulting from running the code. If this option is enabled, click on Canvas to see the turtle again.F11ViewShow Line NumbersWith this action you can show the line numbers in the editor. This can be handy for finding errors.SettingsShow ToolbarToggle the Main ToolbarSettingsShow StatusbarToggle the StatusbarSettingsConfigure Shortcuts...Standard &kde; dialog to configure the shortcuts.SettingsConfigure Toolbars...The standard &kde; dialog for configuring the toolbars.The Help Menu
&help.menu.documentation;
F2HelpHelp on: ...This is a very useful function: it provides help on the code where the cursor in the editor is at. So, ⪚, you have used the print command in your code, and you want to read and to know what the handbook says on this command. You just move your cursor so it is in the print command and you press F2. The handbook will then show all info on the print command.This function can prove to be useful while learning &turtlescript;.The StatusbarOn the status bar you get feedback of the state of &kturtle;. On the left side it shows the feedback on the last action. On the right side you find the current location of the cursor (line and column numbers). In the middle of the status bar is indicated the current language used for the commands.