Changes

Line 1: Line 1:  
==Getting Started==
 
==Getting Started==
   −
[[Image:TAvertical.png|300px]]
+
There are several Turtle Art manuals:
 +
* [http://ht.ly/gqueN]
 +
 
 +
[[Image:New-TA-Repeat-block.png|300px]]
    
Start by clicking on (or dragging) blocks from the Turtle palette. Use multiple blocks to create drawings; as the turtle moves under your control, colorful lines are drawn.
 
Start by clicking on (or dragging) blocks from the Turtle palette. Use multiple blocks to create drawings; as the turtle moves under your control, colorful lines are drawn.
   −
You add blocks to your program by clicking on or dragging them from the palette to the main area. You can delete a block by dragging it back onto the palette. Click anywhere on a "stack" of blocks to start executing that stack or by clicking in the Rabbit (fast) , Turtle (slow) or Bug (debug) buttons [[File:Rabbitturtle.jpg |100px]] on the Project Toolbar.
+
You add blocks to your program by clicking on or dragging them from the palette to the main area. You can delete a block by dragging it back onto the palette. Click anywhere on a "stack" of blocks to start executing that stack or by clicking in the Rabbit (fast) , Turtle (slow) or Bug (debug) buttons [[File:Rabbitturtle.jpg |80px]] on the Project Toolbar.
    
===The basics===
 
===The basics===
 
<gallery>
 
<gallery>
 
File:TA-basics.png|Basic turtle graphics: 'forward', 'back', 'arc', and 'right' blocks
 
File:TA-basics.png|Basic turtle graphics: 'forward', 'back', 'arc', and 'right' blocks
File:TA-pencolor.png|Pen attributes: 'set pen color' block
+
File:TA-pencolor.png|The 'set color' block affects pen trails, fill and text
 +
</gallery>
 +
<gallery>
 
File:TA-pensize.png|'set pen size' block
 
File:TA-pensize.png|'set pen size' block
File:Penupdown.jpg|Pen up and pen down
+
File:Penupdown.jpg|'pen up' and 'pen down'
 
</gallery>
 
</gallery>
      
===Drawing shapes===
 
===Drawing shapes===
 
<gallery>
 
<gallery>
File:turtlesquare.jpg|Use the repeat block to draw shapes
+
File:turtlesquare.jpg|Use the 'repeat' block to draw shapes
File:Turtlepolygon.jpg|This can be generalised to n sided polygons, store n in Box1
+
File:Turtlepolygon.jpg|This can be generalised to n sided polygons, n is stored in 'box 1'
 +
</gallery>
 +
<gallery>
 
File:Turtlefilledtriangle.jpg|Use 'start fill' and 'end fill' to draw filled shapes
 
File:Turtlefilledtriangle.jpg|Use 'start fill' and 'end fill' to draw filled shapes
 +
File:TA-sample4.png|There's no limit
 +
</gallery>
 +
 +
===Displaying things===
 +
<gallery>
 +
File:Hello world.jpg|Use 'print' to display in the print window
 +
File:TA-text.png|'show' block used to display at the turtle
 +
File:TA-image.png|'show' an image or video
 +
File:Showcamera.jpg|'show' the camera output
 +
File:Showsound.jpg|'show' plays sounds as well
 +
File:Printnumber.jpg|'print' and 'show' can display text or numbers including results of calculations
 +
File:Stringsandnumbers.jpg|'print' or 'show' mixed text and numbers, using '+'
 +
File:Speech.jpg|Text to speech. Load the Python block with the inbuilt sample code <i>speak.py</i>
 
</gallery>
 
</gallery>
   Line 27: Line 46:     
<gallery>
 
<gallery>
File:TA-box-eample.png|named variables:'store in' block
+
File:TA-box-eample.png|Named variables: store a variable in 'box'
 
File:Namedstacks.jpg|Named 'stacks' of blocks can be reused
 
File:Namedstacks.jpg|Named 'stacks' of blocks can be reused
 +
File:ActionBlocks.png|When a new named stack is created, a new action block is added to the palette.
 
File:Collapsestack.jpg|Collapse a 'stack' of blocks to save space
 
File:Collapsestack.jpg|Collapse a 'stack' of blocks to save space
 
File:Pushpop.jpg|Store data in the first in last out heap using 'push' and 'pop'
 
File:Pushpop.jpg|Store data in the first in last out heap using 'push' and 'pop'
 +
File:Turtlearray.jpg|Box names (and stack names) can be boxes, in this case (taken from the math-dice project), a one-dimensional array of 11 variables has been created.
 
</gallery>
 
</gallery>
   −
===Displaying things===
+
===Mathematics===
 
<gallery>
 
<gallery>
File:Hello world.jpg|Using 'print'
+
File:Mathoperators.jpg |Math operators including + - * / mod sqrt
File:Printnumber.jpg|'print' and 'show' can display numbers including results of calculations
+
File:TA-if.png|Logical operations: flow control blocks accept >, <, =, and, not, or as input
File:Stringsandnumbers.jpg|'print' with text and numbers
+
File:Pie2.png|Make pie charts [http://wiki.sugarlabs.org/go/File:Turtle_Art_Activity_pie_chart.ta]
File:TA-text.png|'show' block used for text
+
File:Functionblock.jpg|Use Python functions, (accepts any of the [http://docs.python.org/library/time.html time] or [http://docs.python.org/library/math.html math] library functions)
File:TA-image.png|'show' an image, (movies, audio)
+
File:Coordinates.png|Cartesian and polar coordinate grids
File:Showcamera.jpg|'show' the camera output
+
File:CM-coordinate-grid.svg|Centimeter coordinate grid (XO only)
File:Showsound.jpg|'show' plays sounds as well
   
</gallery>
 
</gallery>
   −
===Keyboard and mouse input===
+
===Keyboard, mouse and sensor input===
 
<gallery>
 
<gallery>
 
File:Keyboardinput.jpg|Reading the keyboard
 
File:Keyboardinput.jpg|Reading the keyboard
 
File:Keyboard.png|Converting the keyboard output to a string
 
File:Keyboard.png|Converting the keyboard output to a string
File:Entertermnumber.jpg|Getting a multi digit number [[http://wiki.sugarlabs.org/go/File:Turtle_Art_getnumber.ta]]
+
File:Entertermnumber.jpg|Entering a multi digit number, exits with the number in 'box 1', [[http://wiki.sugarlabs.org/go/File:Turtle_Art_getnumber.ta]]
File:Turtlemouse.jpg|Load the Python block with the sample code push_mouse_event.py to read mouse events
+
File:Turtlemouse.jpg|Load the Python block with the sample code <i>push_mouse_event.py</i> to read mouse events
</gallery>
+
File:Printloudness.jpg|Read the microphone
 
+
File:Resistance.jpg|Read sensors plugged into the microphone socket [http://wiki.sugarlabs.org/go/Activities/TurtleArt/Using_Turtle_Art_Sensors]
===Mathematics===
  −
<gallery>
  −
File:TA-if.png|logical operations: 'if' block
  −
File:Pie2.png|Make pie charts
  −
File:Functionblock.jpg|Use Python functions
   
</gallery>
 
</gallery>