The KTurtle Handbook

Creates a new, empty TurtleScript file.

Opens a TurtleScript file.

Opens a TurtleScript file that has been opened recently.

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

Saves the currently opened TurtleScript file.

Saves the currently opened TurtleScript file on a specified location.

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

Prints the current code in the editor.

Quits KTurtle.

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

Redoes an undone change to the code.

Cuts the selected text from the editor to the clipboard.

Copies the selected text from the editor to the clipboard.

Pastes the text from the clipboard to the editor.

Selects all the text from the editor.

With this action you can find phrases in the code.

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

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

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

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

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

Prints the current content of the Canvas.

Starts the execution of the commands in the editor.

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

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

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.

This action opens the direction chooser dialog.

This action opens the color picker dialog.

Choose the language for the code.

Show or hide the Editor.

Show or hide the inspector.

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.

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

Toggle the Main Toolbar

Toggle the Statusbar

Standard KDE dialog to configure the shortcuts.

The standard KDE dialog for configuring the toolbars.

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

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.

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

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

This will display version and author information.

This displays the KDE version and other basic information.

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.

forward X

backward X

turnleft X

turnright X

direction X

center

go X,Y

gox X

goy Y

getx returns the number of pixels from the left of the canvas to the current position of the turtle.

gety returns the number of pixels from the top of the canvas to the current position of the turtle.

penup

pendown

penwidth X

pencolor R,G,B

canvassize X,Y

canvascolor R,G,B

clear

reset

spriteshow

spritehide

print X

$year = 2003
$author = "Cies"
print $author + " started the KTurtle project in " + $year + " and still enjoys working on it!"

fontsize X

round(x)

print round(10.8)
forward 20
print round(10.3)

random X,Y

repeat 500 {
  $x = random 1,20
  forward $x
  turnleft 10 - $x
}

sqrt X

pi

sin X
cos X
tan X

arcsin X
arccos X
arctan X

message X

message "Cies started KTurtle in 2003 and still enjoys working on it!"

ask X

$in = ask "What is your year of birth?"
$out = 2003 - $in
print "In 2003 you were " + $out + " years old at some point."

wait X

repeat 36 {
  forward 5
  turnright 10
  wait 0.5
}

if boolean { ... }

$x = 6
if $x > 5 {
  print "$x is greater than five!"
}

if boolean { ... } else { ... }

reset
$x = 4
if $x > 5 {
  print "$x is greater than five!"
} else {
  print "$x is smaller than six!"
}

while boolean { ... }

$x = 1
while $x < 5 {
  forward 10
  wait 1
  $x = $x + 1
}

repeat number { ... }

for variable = number to number { ... }

for $x = 1 to 10 {
  print $x * 7
  forward 15
}

The default step size of a loop is 1, you can use an other value with

for variable = number to number step number { ... }

break

exit