docs.kde.org
The Menubar
Prev
Next

The Menubar

In 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

File->New (Ctrl-N)

Creates a new, empty TurtleScript file.

File->Open... (Ctrl-O)

Opens a TurtleScript file.

File->Open Recent

Opens a TurtleScript file that has been opened recently.

File->Examples

Open example TurtleScript programs. The examples are in your favorite language that you can choose in Settings->Script Language.

File->Save (Ctrl-S)

Saves the currently opened TurtleScript file.

File->Save As...

Saves the currently opened TurtleScript file on a specified location.

File->Export to HTML...

Exports the current content of the Editor as an HTML file that includes highlighting colors.

File->Print... (Ctrl-P)

Prints the current code in the editor.

File->Quit (Ctrl-Q)

Quits KTurtle.

The Edit Menu

Edit->Undo (Ctrl-Z)

Undoes the last change to code. KTurtle has unlimited undos.

Edit->Redo (Ctrl-Shift-Z)

Redoes an undone change to the code.

Edit->Cut (Ctrl-X)

Cuts the selected text from the editor to the clipboard.

Edit->Copy (Ctrl-C)

Copies the selected text from the editor to the clipboard.

Edit->Paste (Ctrl-V)

Pastes the text from the clipboard to the editor.

Edit->Select All (Ctrl-A)

Selects all the text from the editor.

Edit->Find... (Ctrl-F)

With this action you can find phrases in the code.

Edit->Find Next (F3)

Use this to find the next occurrence of the phrase you searched for.

Edit->Find Previous (Shift-F3)

Use this to find the previous occurrence of the phrase you searched for.

Edit->Overwrite Mode (Ins)

Toggle between the 'insert' and 'overwrite' mode.

The Canvas Menu

Canvas->Export to Image (PNG)...

Exports the current content of the Canvas as a raster image of the PNG (Portable Network Graphics) type.

Canvas->Export to Drawing (SVG)...

Exports the current content of the Canvas as a vector drawing of the SVG (Scalable Vector Graphics) type.

Canvas->Print Canvas...

Prints the current content of the Canvas.

The Run Menu

Run->Run (F5)

Starts the execution of the commands in the editor.

Run->Pause (F6)

Pauses the execution. This action is only enabled when the commands are actually executing.

Run->Abort (F7)

Stops the execution. This action is only enabled when the commands are actually executing.

Run->Run Speed

Present 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 Menu

Tools->Direction Chooser...

This action opens the direction chooser dialog.

Tools->Color Picker...

This action opens the color picker dialog.

The Settings Menu

Settings->Script Language

Choose the language for the code.

Settings->Show Editor (Ctrl-E)

Show or hide the Editor.

Settings->Show Inspector (Ctrl-I)

Show or hide the inspector.

Settings->Show Errors

Show 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.

View->Show Line Numbers (F11)

With this action you can show the line numbers in the editor. This can be handy for finding errors.

Settings->Show Toolbar

Toggle the Main Toolbar

Settings->Show Statusbar

Toggle the Statusbar

Settings->Configure Shortcuts...

Standard KDE dialog to configure the shortcuts.

Settings->Configure Toolbars...

The standard KDE dialog for configuring the toolbars.

The Help Menu

Help->KTurtle Handbook (F1)

Invokes the KDE Help system starting at the KTurtle help pages. (this document).

Help->What's This? (Shift+F1)

Changes the mouse cursor to a combination arrow and question mark. Clicking on items within KTurtle will open a help window (if one exists for the particular item) explaining the item's function.

Help->Report Bug...

Opens the Bug report dialog where you can report a bug or request a “wishlist” feature.

Help->Switch Application Language...

Opens a dialog where you can edit the Primary language and Fallback language for this application.

Help->About KTurtle

This will display version and author information.

Help->About KDE

This displays the KDE version and other basic information.

Help->Help on: ... (F2)

This is a very useful function: it provides help on the code where the cursor in the editor is at. So, e.g., 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.

Prev
Next
Contents


docs.kde.org