Changes

Jump to navigation Jump to search
51,403 bytes removed ,  10:45, 17 October 2015
m
Line 1: Line 1: −
<noinclude>{{Translations | [[Activities/Turtle Art|english]] &#124; [[Activities/Turtle Art/lang-es|español]] &#124;}}{{TOCright}}
+
<noinclude>{{Translations | [[Activities/Turtle Art|english]] &#124; [[Activities/Turtle Art/lang-es|español]] &#124;}}
 
[[Category:Activities|Turtle Art]]</noinclude>
 
[[Category:Activities|Turtle Art]]</noinclude>
   −
==What is Turtle Art==
+
== What is Turtle Blocks (AKA Turtle Art)==
   −
Turtle Art is an activity with a Logo-inspired graphical "turtle" that draws colorful art based on snap-together visual programming elements.
+
Turtle Blocks is an activity with a [https://logothings.wikispaces.com/ Logo-inspired] graphical "turtle" that draws colorful art based on snap-together visual programming elements. Its "low floor" provides an easy entry point for beginners. It also has "high ceiling" programming features which will challenge the more adventurous student.
   −
'''Note:''' There are two inter-compatible programs: Turtle Art and Turtle Blocks. Turtle Art, which closely parallels the Java version of Turtle Art maintained by Brian Silverman, offers a small subset of the functionality of Turtle Blocks.
+
=== Where to get Turtle Blocks ===
   −
==Where to get Turtle Art==
+
http://activities.sugarlabs.org/en-US/sugar/addon/4027
   −
<span class="linkgroup">[[File:Activity-turtleart.png|link=http://activities.sugarlabs.org/en-US/sugar/addon/4027]]</span>
+
'''Note:''' There are two inter-compatible programs: [http://activities.sugarlabs.org/en-US/sugar/addon/4298 Turtle Art] and [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Blocks]. Turtle Art, which closely parallels the Java version of Turtle Art maintained by Brian Silverman, offers a small subset of the functionality of Turtle Blocks. '''Sugar users probably want to use Turtle Blocks rather than Turtle Art.''' (Also see [[Activities/Turtle Confusion|Turtle Confusion]], a collection of programming challenges designed by Barry Newell; as well as the [[Activities/TurtleFlags]], [[Activities/Tortuga de Mexico]] and [[Activities/Amazonas Tortuga]] variants.)
   −
Turtle Art is a [[Taxonomy#Fructose:_The_set_of_demonstration_activities|Fructose module]], so it is included as part of the standard Sugar (Sucrose = Glucose+Fructose) distribution.
+
Debian (and Ubuntu) users can install Turtle Blocks from a repository maintained by Alan Aguiar (https://launchpad.net/~alanjas/+archive/turtleblocks):
 +
# sudo add-apt-repository ppa:alanjas/turtleblocks
 +
# sudo apt-get update
 +
# sudo apt-get install turtleblocks
   −
'''Sugar Activity Library'''
+
Fedora users can do:
* [http://activities.sugarlabs.org/en-US/sugar/addon/4298 Version 89 of Turtle Art]
+
# <strike>sudo yum install turtleblocks</strike>
* [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Version 99 of Turtle Blocks]
+
# sudo yum install sugar-turtleart
* [http://activities.sugarlabs.org/en-US/sugar/addon/4027 download]
  −
'''Sources'''
  −
* [http://git.sugarlabs.org/projects/turtleart git source]
  −
* [http://download.sugarlabs.org/sources/sucrose/fructose/TurtleArt/?C=M;O=D tarballs]
  −
'''Manuals & Guides'''
  −
<!-- {{Iframe|&nbsp;&nbsp;http://wiki.sugarlabs.org/skins/vector/images/bullet-icon.png &nbsp;[http://en.flossmanuals.net/turtleart Turtle Art FLOSS Manual] |http://en.flossmanuals.net/turtleart|940|600|1}} -->
  −
* [http://en.flossmanuals.net/turtleart FLOSS Turtle Art manual]
  −
* [http://wiki.laptop.org/go/Turtle_Art_student_guide Student Guide]
  −
* [http://www.reducativa.com/wiki/index.php?title=Proyecto_OLPC_-_Plan_Ceibal#Turtle_Art activity guides (es)]
  −
* [http://ceibalpuertosauce.blogspot.com/2009/06/tortugarte.html mas TortugaArte]
  −
* [http://neoparaiso.com/logo/que-es-logo.html ¿Qué es Logo?]
  −
* [http://neoparaiso.com/logo/ejercicios-de-geometria.html 84 Ejercicios de Geometría]
  −
* [http://dspace.mit.edu/bitstream/handle/1721.1/5787/AIM-356.pdf;jsessionid=92BD7E499ECB9BB8F8350EF04B8063B3?sequence=2 Logo Progress Report 1973-1975]
  −
* http://www.mochiladigitaltelmex.com.mx/pdf/xo/TortugArte.pdf
  −
'''Galleries'''
  −
* [http://turtleartsite.appspot.com/ Python Turtle Art Gallery]
  −
* [http://www.turtleart.org/ Java Turtle Art Gallery]
  −
* [http://neoparaiso.com/logo/galeria-graficos-de-tortuga.html Another Turtle Art gallery]
  −
* [http://sites.google.com/site/godiard/TurtleArt.ppt?attredirects=0&d=1 (archivo en PowerPoint)]
  −
'''Blogs'''
  −
* [http://billkerr2.blogspot.com/2009/08/40-maths-shapes-challenges.html 40 shapes challenge]
  −
'''Other wiki pages'''
  −
* [[Activities/TurtleArt/Arduino|Turtle Art Arduino]]
  −
* [http://wiki.laptop.org/go/Category:Aplicaciones_de_Actividad_TortugArte Aplicaciones de Actividad TortugArte]
  −
'''Release notes'''
  −
* [[0.90/TurtleArt|Fructose 0.90 release notes]]
  −
* [[0.88/TurtleArt|Fructose 0.88 release notes]]
  −
* [[0.86/TurtleArt|Fructose 0.86 release notes]]
  −
'''Video'''
  −
* [http://www.dailymotion.com/sugarlabs/video/15708788 Introductory video]
  −
* http://www.mediagala.com/rap/videos/tortugarte/flv/Turtle_Charla_4.html
  −
'''Bugs'''
  −
* [http://bugs.sugarlabs.org/query?component=Turtleart&col=id&col=summary&col=component&col=type&col=status&col=priority&col=milestone&col=time&col=changetime&order=priority Sugar Labs tickets], [http://dev.laptop.org/query?component=turtleart-activity&col=id&col=summary&col=component&col=type&col=status&col=priority&col=milestone&col=time&col=changetime&order=priority OLPC tickets]
      +
For those of you who would like to use Turtle Blocks in a browser, there is a mostly compatible version at [http://turtle.sugarlabs.org Turtle Blocks JS]. See [https://github.com/walterbender/turtleblocksjs/blob/master/guide/README.md the Guide] ([https://github.com/walterbender/turtleblocksjs/blob/master/guide-es/README.md en ES]) for more details.
    +
Finally, there is [http://walterbender.github.io/musicblocks Music Blocks], a musical fork of Turtle Blocks. See [https://github.com/walterbender/musicblocks/blob/master/guide/README.md the Guide] for more details.
   −
=== i18n ===
+
{{:Activities/Turtle Art/Getting_started}}
   −
Turtle Art currently has support for: de, el, en, es, fa_AF, fi, fr, hi, it, mn, nl, ps, pt, ru, sl, sv, ta, tr, vi, and zh_TW
+
{{:Activities/Turtle Art/Turtle_Cards}}
   −
(See [http://translate.sugarlabs.org our Pootle server] for details about how to translate Turtle Art into your language.)
+
{{:Activities/Turtle Art/Challenges}}
   −
=== Reporting bugs ===
+
{{:Activities/Turtle Art/Toolbars}}
   −
Please file bug reports [https://bugs.sugarlabs.org/newticket?component=Turtleart here].
+
{{:Activities/Turtle Art/Extras}}
   −
==Background==
+
{{:Activities/Turtle Art/Tutorials}}
   −
Turtle Art is intended to be a stepping stone to  the Logo programming language, but there are many restrictions compared to Logo. (Only numeric global variables and stack items are available, no lists or other data-structures. The conditionals and some of the functions only take constants or variables, not expressions. Limited screen real-estate makes building large programs unfeasible.) However, you can export your Turtle Art creations to [[#Exporting to Berkeley Logo|Berkeley Logo]].
+
{{:Activities/Turtle Art/Galleries}}
   −
Turtle Art was written by Brian Silverman and is maintained by Walter Bender. Arjun Sarwal added the sensor features. Luis Michelena contributed to the "named" action and box blocks. Tony Forster has been the lead test engineer and has really [[#From_the_field|stretched the boundaries]] of Turtle Art. Raúl Gutiérrez Segalés has been a major contributor to the refactoring of the Turtle Art code base starting with Version 0.83.
+
{{:Activities/Turtle Art/Portfolios}}
   −
=== Branches ===
+
{{:Activities/Turtle Art/Logo}}
A [[Activities/Turtle Art/Templates|portfolio feature]] lets you use Turtle Art to create multimedia slide shows from material retrieved from your Journal. The basic idea is to import images (and eventually movies, audio, and text files) into slide templates, not unlike Powerpoint, and then show a presentation by stepping through them. The portfolio includes the typical major functions of presentation software: an editor that allows text to be inserted and formatted (this is largely incomplete), a method for inserting images (from the Journal), and a slide-show system to display the content. What makes it a bit different than tools such as Powerpoint is that you can program your slides using Turtle Art blocks. Turtle Art also has an export-to-HTML function so that presentations can be viewed outside of the Sugar environment. (These features have been merged into the main branch of Turtle Art.)
     −
==== Turtle Art with Arduino ====
+
{{:Activities/Turtle Art/Programmable_Brick}}
[[Activities/TurtleArt/Arduino|Turtle Art with Arduino]] support is an extension of Turtle Art that supports data capture from the Arduino board. This branch is maintained by Sayamindu Dasgupta and Rafael Ortiz.
     −
==Learning with Turtle Art==
+
{{:Activities/Turtle Art/Plugins}}
   −
Play with Turtle Art to draw colorful art patterns using a turtle that accepts instructions for movement.
+
{{:Activities/Turtle Art/Misc}}
   −
With visual programming blocks, you can snap together programs by compiling (combining) them in ways to create anything you can imagine.
+
{{:Activities/Turtle Art/Under_the_hood}}
   −
<gallery>
+
{{:Activities/Turtle Art/Packaging}}
File:TA-sample1.png
  −
File:TA-sample2.png
  −
File:TA-sample3.png
  −
File:TA-sample4.png
  −
File:TA-sample5.png
  −
File:TA-sample6.png
  −
</gallery>
     −
===maths===
+
== Credits ==
 
+
* Walter Bender and Raúl Gutiérrez Segalés maintain the code (with some occasional help from Simon Schampijer)
<gallery>
+
* Especially helpful feedback from Tony Forster, Guzmán Trinidad, and Bill Kerr
File:TAclock1.png|A clock activity
+
* Matthew Gallagher works on packaging and wrote the project-upload code
File:TAclock2.png
+
* Brian Silverman is the first author of Turtle Art
File:TAclock3.png
  −
File:TAclock4.png
  −
File:TAgeometry.png|Calculating the hypotenuse and approximating the angle of a right triangle
  −
File:TAgeometry1.png|Stepping through the program is a nice way to visualize the process of approximation
  −
File:TAgeometry2.png|The final result of the approximation.
  −
File:Sine.png|And on-the-fly function definitions
  −
</gallery>
  −
 
  −
Tony Forster describes his "adventures" with on-the-fly definitions to create an [http://4.bp.blogspot.com/_fTmGyLerUL4/SY0URR-P7TI/AAAAAAAAAN4/XySQUPHmiME/s1600-h/clockface.jpg analog clock] in [http://tonyforster.blogspot.com/2009/02/using-insert-function-block-in.html his blog.]
  −
 
  −
Try any of the [http://docs.python.org/library/time.html time] or [http://docs.python.org/library/math.html math] library functions, e.g.,
  −
 
  −
localtime().tm_min
  −
 
  −
sin(x) + sin(pi/2)
  −
 
  −
===presentations===
  −
 
  −
<gallery>
  −
File:Portfolio14.png
  −
File:Portfolio13.png
  −
</gallery>
  −
 
  −
===games===
  −
 
  −
Turtle Art can be used to write games, such as a simple falling block game:
  −
<gallery>
  −
File:WeGotGame.png
  −
File:Hot-cold.png
  −
File:Yes-no.png
  −
File:State-game.png
  −
File:Boston-game.png
  −
File:Continent-game.png
  −
File:Gardner-school.png
  −
File:Shapes-game.png
  −
</gallery>
  −
 
  −
==Getting Started==
  −
 
  −
[[Image:TAvertical.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.
  −
 
  −
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) or Turtle (slow) buttons on the Project Toolbar.
  −
 
  −
<gallery>
  −
File:TA-basics.png|basic turtle graphics: 'forward', 'back', 'arc', and 'right' blocks
  −
File:TA-text.png|'show' block used for text
  −
File:TA-image.png|multimedia: 'show' block used for image (movies, audio)
  −
File:TA-pencolor.png|pen attributes: 'set pen color' block
  −
File:TA-pensize.png|'set pen size' block
  −
File:TA-if.png|logical operations: 'if' block
  −
File:TA-box-eample.png|named variables:'store in' block
  −
</gallery>
  −
 
  −
===Video Tutorials===
  −
I know there are a few but they are not categorized on this page... we'll make that happen soon. Help would be appreciated.
  −
 
  −
* [http://www.youtube.com/results?search_query=pleabargain+sugar+turtle+art&search_type=&aq=o introductory videos here on Turtle Art]
  −
* [http://www.dailymotion.com/video/xa71j3_to-square-final-2 To Square—a tutorial by the Summer Spot youths at the Lilla G. Frederick Pilot Middle School]
  −
* [http://www.youtube.com/watch?v=yHd6nEmXT34 A basic tutorial].
  −
* [http://www.dailymotion.com/user/sugarlabs/video/x9cpzd_turtleartportfoliobasics_creation a video of the portfolio basics]
  −
* [http://www.dailymotion.com/user/sugarlabs/video/x9dsjf_hotcold-game_creation Get your hot cold Turtle Art Video here!]
  −
* [http://www.dailymotion.com/user/sugarlabs/video/x9xz9o_stategame_tech Name that State!]
  −
* [http://www.dailymotion.com/video/xa7dle_shapes A Shapes and Colors Game]
  −
 
  −
===Main Toolbar===
  −
 
  −
[[Image:TAmain.png]]
  −
 
  −
From left to right: Activity toolbar; Edit toolbar; View toolbar; show/hide palette;  erase canvas; run project fast; run project slow; stop project; Help toolbar; stop activity
  −
 
  −
Keyboard short cuts for the above: Alt+ '''p'''alette; '''b'''locks; '''r'''un; '''w'''alk; '''s'''top; '''e'''rase; e.g., Alt+e will erase the screen. Esc will return from full-screen mode.
  −
 
  −
Notes: The run buttons are tied to the [[#descriptions (6)|Start Block]]. If no Start Block is used, then all blocks are run when either run button is clicked. The "rabbit" button runs the blocks at maximum speed. The "turtle" button pauses and displays the turtle between each step. The "bug" button pauses between each step and shows status information.
  −
 
  −
===Project Toolbar===
  −
 
  −
[[Image:TAproject.png]]
  −
 
  −
From left to right:
  −
* Project title;
  −
* [[#Sharing|Share]] button;
  −
* Keep button;
  −
* Save copy to Journal button; save to HTML;
  −
* [[#Exporting to Berkeley Logo|Save to Logo]];
  −
* Save as an image;
  −
* Import [[#Programmable Brick|Python code]];
  −
* Import Turtle Art project
  −
 
  −
===Edit Toolbar===
  −
 
  −
[[Image:TAcopy.png]]
  −
 
  −
The Edit toolbar is used to copy stacks of blocks to the clipboard and to paste stacks from the clipboard. To copy a stack, place the cursor on any block in the stack and then type Ctrl-c. To paste a stack from the clipboard, type Ctrl-v.
  −
 
  −
From left to right:
  −
* Copy
  −
* Paste
  −
 
  −
===View Toolbar===
  −
 
  −
[[Image:TAview.png]]
  −
 
  −
From left to right:
  −
* Full-screen button;
  −
* Cartesian-coordinate grid;
  −
* polar-coordinate grid;
  −
* display of x,y coordinates of turtle;
  −
* Rescale-coordinates button;
  −
* Grow block size;
  −
* Shrink block size
  −
 
  −
===Help Toolbar===
  −
 
  −
[[Image:TAhelp.png]]
  −
 
  −
From left to right:
  −
* Import sample project;
  −
* display help strings
  −
 
  −
=== Palettes Toolbar ===
  −
 
  −
There are eight palettes of program elements available for program construction: [[Activities/Turtle_Art/Turtle|Turtle movements]]; [[Activities/Turtle_Art/Pen|Pen attributes]]; Color attributes; [[Activities/Turtle_Art/Numbers|Numeric operators]]; [[Activities/Turtle_Art/Sensors|Misc. functions]]; [[Activities/Turtle_Art/Flow|Logical operators]]; [[Activities/Turtle_Art/Blocks|Logical blocks]]; and [[Activities/Turtle_Art/Templates|Presentation blocks]]
  −
 
  −
Blocks are dragged from the palette onto the canvas surface. To dispose of a block, drag it back onto the palette. (It will be placed onto the trash palette.)
  −
 
  −
The palettes can be displayed horizontally or vertically (See below). Orientation is adjusted by clicking on the [[Image:TAorientation0.svg]] and [[Image:TAorientation1.svg]] buttons on the upper-left corner of the palette. The palette can be hidden by clicking on the [[Image:TAhide.svg]] button on the lower-right corner of the palette. The next palette in the menu can be accessed by clicking on the [[Image:TAnext.svg]] button on the upper-right corner of the palette.
  −
 
  −
The [[Image:Hide-palette.png]] button is used to hide/reveal the palette of blocks. The [[Image:Hide-blocks.png]] button is used to hide/reveal the program blocks.
  −
 
  −
====Turtle Palette====
  −
[[Image:TAturtle.png]]
  −
 
  −
These blocks are used to control the movements of the turtle.
  −
 
  −
* clean: clear the screen and position the turtle in the center of the screen, pen down, color red, heading 0
  −
* forward: move turtle forward
  −
* back: move turtle backward
  −
* show: draw text or display media object from the Journal
  −
* left: rotate turtle counterclockwise
  −
* right: rotate turtle clockwise
  −
* seth: set turtle heading
  −
* set xy: set turtle x,y position (0,0) is the center of the screen
  −
* heading: holds current heading value of the turtle (can be used in place of a number block)
  −
* xcor: holds current x-coordinate value of the turtle (can be used in place of a number block)
  −
* ycor: holds current y-coordinate value of the turtle (can be used in place of a number block)
  −
* set scale: sets the scale of images displayed with show block
  −
* arc: move turtle along an arc
  −
 
  −
Only available in Turtle Blocks:
  −
* left: holds current x-coordinate value of the left edge of the screen (can be used in place of a number block)
  −
* top: holds current y-coordinate value of the top edge of the screen (can be used in place of a number block)
  −
* right: holds current x-coordinate value of the right edge of the screen (can be used in place of a number block)
  −
* bottom: holds current y-coordinate value of the bottom edge of the screen (can be used in place of a number block)
  −
 
  −
====Pen Palette====
  −
[[Image:TApen.png]]
  −
 
  −
These blocks are used to control the attributes of the turtle's pen.
  −
 
  −
* pen up: turtle will not draw when moved
  −
* pen down: turtle will draw when moved
  −
* set pen size: sets the width of the line drawn by the turtle
  −
* fill screen: fill the screen with a color/shade and reposition the turtle in the center of the screen
  −
* pen size: width of the line drawn by the turtle (can be used in place of a number block)
  −
* set text size: scales the text drawn by the show block (found on the Turtle palette)
  −
* set color: sets the pen color
  −
* set shade: sets the pen shade
  −
* text size: current text size (can be used in place of a number block) (Depreciated)
  −
* color: current pen color (can be used in place of a number block)
  −
* share: current pen shade (can be used in place of a number block)
  −
* set gray: sets the gray-level of the pen (Only available in Turtle Blocks)
  −
* gray: current pen gray level (can be used in place of a number block) (Only available in Turtle Blocks)
  −
* start fill: starts a filled polygon (straight sides, not arcs)
  −
* end fill: ends a fill polygon (straight sides, not arcs)
  −
 
  −
====Color Palette====
  −
[[Image:TAcolors.png]]
  −
 
  −
These blocks can be used with the set-pen-color block in place of a number block.
  −
 
  −
====Numbers Palette====
  −
[[Image:TAnumbers.png]]
  −
 
  −
These blocks are arithmetic and boolean operators.
  −
 
  −
* addition: adds two numeric inputs (also can be used to concatenate strings)
  −
* subtraction: subtracts the bottom numeric input from the top input
  −
* multiplication: multiplies two numeric inputs
  −
* division: divided top input (numerator) by bottom input (denominator)
  −
* identity: identity function (used for spacing blocks)
  −
* modulo (remainder): calculates remainder when dividing top input by the bottom input
  −
* square root (Only available with Turtle Blocks)
  −
* random number: generates a random integer between the minimum and maximum values
  −
* number block: a numeric input
  −
* greater than: boolean greater than operator (used with flow blocks)
  −
* less than: boolean less than operator (used with flow blocks)
  −
* equal to: boolean equal to operator (used with flow blocks)
  −
* not: boolean not (Only available with Turtle Blocks)
  −
* and: boolean and (Only available with Turtle Blocks)
  −
* or: boolean or (Only available with Turtle Blocks)
  −
 
  −
====Flow Palette====
  −
[[Image:TAflow.png]]
  −
 
  −
These blocks control program flow.
  −
 
  −
* wait: pause program execution (unit is seconds)
  −
* forever: continuously repeat execute stack under the right flow
  −
* repeat: repeat the execution of stack under the right flow a specified number of times
  −
* if/then: conditional execution of the stack under the right flow (uses boolean operators found on the Number palette)
  −
* if/then/else: conditional execution of the stack under the center and right flows (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
  −
* while: execute stack under right flow ''while'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
  −
* until: execute stack under right flow ''until'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
  −
* horizontal spacer (Only available with Turtle Blocks)
  −
* vertical spacer
  −
* stop stack: interrupt execution
  −
 
  −
====Blocks Palette====
  −
[[Image:TAblocks.png]]
  −
 
  −
These blocks are for defining variables and subroutines.
  −
 
  −
* action 1: top of action 1 stack (Only available with Turtle Blocks)
  −
* action 1: execute action 1 stack (Only available with Turtle Blocks)
  −
* action 2: top of action 2 stack (Only available with Turtle Blocks)
  −
* action 2: execute action 2 stack (Only available with Turtle Blocks)
  −
* action: top of named action stack
  −
* action: execute named action stack
  −
* store in box 1: store a number, string, or media object in box 1 (Only available with Turtle Blocks)
  −
* store in box 2: store a number, string, or media object in box 2 (Only available with Turtle Blocks)
  −
* text: string input
  −
* box 1: current value of box 1 (can be used in place of a number block) (Only available with Turtle Blocks)
  −
* box 2: current value of box 2 (can be used in place of a number block) (Only available with Turtle Blocks)
  −
* box: current value of named box (can be used in place of a number block)
  −
* store in: store a number, string, or media object in a named box
  −
* start: connects action to toolbar 'Run' button
  −
 
  −
====Extras Palette====
  −
[[Image:TAextras.png]]
  −
 
  −
These are a collection of extra blocks for accessing advanced features only available in Turtle Blocks.
  −
 
  −
* query keyboard: check for keyboard input (results are stored in the keyboard block)
  −
* push: push value onto FILO (first-in last-out) heap
  −
* show heap: show FILO in status block
  −
* keyboard: current value of keyboard input (can be used in place of a number block)
  −
* pop: pop value off of the FILO (can be used in place of a number block)
  −
* empty heap: empty the FILO
  −
* Python: a [[Activities/TurtleArt-0.88#Python_function_block|programmable block]] (can be used in place of a number block)
  −
:: add your own math equation in the block, e.g., sin(x); This block is expandable to support up to three variables, e.g. f(x,y,z)
  −
* Import Python: [[Activities/TurtleArt-0.88#Python_code_block|import Python code]] from the Sugar Journal (a more general-purpose programmable block). This block accepts a single variable x, as an input or up to 3 variables as an array x[0], x[1] and x[2]
  −
* turtle: specify which turtle is active
  −
* comment: program comment (displayed in "walk" mode)
  −
* print: print value in status block (also available in Turtle Art)
  −
* Cartesian: display Cartesian coordinate grid overlay
  −
* width: screen width (can be used in place of a number block)
  −
* height: screen height (can be used in place of a number block)
  −
* polar: display polar coordinate grid overlay
  −
* top of stack: block to denote the top of a collapsible stack
  −
* bottom of stack: block to denote the bottom of a collapsible stack
  −
:: To use the collapsible-stack blocks, place them around the blocks you want to hide
  −
* read pixel: push the RGB value of the pixel under the turtle onto the FILO (blue is first, red is last)
  −
* turtle sees: the "palette color" of the pixel under the turtle
  −
* turtle shell: import a image from the Journal to use as the turtle's 'shell', i.e., replace the turtle with a sprite.
  −
 
  −
====Portfolio Palette====
  −
[[Image:TAportfolio.png]]
  −
 
  −
These blocks are used to make multimedia presentations only available in Turtle Blocks.
  −
 
  −
* journal: Sugar Journal media object (used with show block) (also available in Turtle Art)
  −
* audio: Sugar Journal media object (used with show block)
  −
* description: Sugar Journal description field (used with show block)
  −
* hide blocks: hides all blocks and palettes (useful for decluttering the screen during presentations) (also available in Turtle Art)
  −
* show blocks: shows blocks and palettes (useful for resuming programming after a presentation)
  −
* full screen: goes into full-screen mode (hides Sugar toolbars)
  −
* save picture: save the canvas to the Sugar Journal as a .png image (note: saves the canvas as displayed)
  −
* save SVG: save turtle graphics to the Sugar Journal as a .svg image (note: only saves the changes to the canvas in the current execution run)
  −
* list slide: used for bulleted lists; This block is expandable, allowing you to add as many bullets as you need.
  −
* picture slides: used for picture slides (1×1, 2×2, 1×2 and 2×1)
  −
::Note: The slide blocks expand into stacks that can be edited for customized presentations.
  −
 
  −
====Trash Palette====
  −
[[Image:TAtrash.png]]
  −
 
  −
This palette holds any blocks that have been put in the trash. You can drag blocks out of the trash to restore them. The trash palette is emptied when you quit Turtle Art.
  −
 
  −
====Vertical palettes====
  −
[[Image:TAvertical.png|300px]]
  −
 
  −
An example of a vertical palette. Vertical palettes are used by default on the OLPC XO laptops running older versions of Sugar.
  −
 
  −
===Keyboard shortcuts===
  −
* Ctrl+q quit (exit Turtle Art)
  −
* Alt+p show/hide the palettes
  −
* Alt+b show/hide the blocks
  −
* Alt+r run the 'start' stack rapidly
  −
* Alt+w run the 'start' stack slowly (and highlight blocks during execution)
  −
* Alt+s stop execution of the stack
  −
* Alt+e erase the screen
  −
* Esc return from full-screen mode
  −
* Ctrl+c copy a stack of blocks or text from a block
  −
* Ctrl+v paste a stack of blocks or text into a block
  −
* cursor (arrow) keys (or h j k l keys) move selected stack of blocks or turtle or move between toolbar items
  −
* Return (Enter) is used to run a stack of blocks or to select a toolbar item
  −
 
  −
Note for OLPC-XO laptop users: the buttons on the display can also be used.
  −
* The left-hand buttons can be used to move a stack of blocks or turtle
  −
* o button runs the selected stack of blocks or returns the selected turtle to the home position (center of the screen)
  −
* × button deletes the selected stack of blocks
  −
* ✓ button runs the 'start' stack
  −
* ◽ button selects the next block (in the order in which they were added) (only in version 100+)
  −
 
  −
===Helpful hints===
  −
====Copying and Pasting====
  −
Did you know that you can copy/paste stacks to/from the clipboard? You type Ctrl-C to copy whatever stack is under the cursor to the clipboard. Ctrl-V will paste from the clipboard onto whatever TA project you have open. Try pasting this code into your Turtle Art project.
  −
 
  −
:[[0, "clean", 258, 217, [12, 1]], [1, "repeat", 258, 251, [0, 2, 3, null]], [2, ["number", 36], 309, 251, [1, null]], [3, "repeat", 323, 311, [1, 4, 5, 9]], [4,  ["number", 4], 374, 311, [3, null]], [5, "forward", 388, 371, [3, 6, 7]], [6, ["number", 300], 459, 371, [5, null]], [7, "right", 388, 413, [5, 8, null]], [8, ["number", 90], 446, 413, [7, null]], [9, ["vspace", 20], 323, 389, [3, 10]], [10, "right", 323, 463, [9, 11, null]], [11, ["number", 10], 381, 463, [10, null]], [12, "start", 258, 175, [null, 0]], [-1, ["turtle", 1], 0, 0, 0.0, 0, 50, 5]]
  −
 
  −
You can also paste text from the clipboard into text blocks.
  −
 
  −
====Speed====
  −
Your program will run much faster if you hide blocks
  −
 
  −
====Running Turtle Art outsde of Sugar====
  −
[[Image:TAGnome.png|300px]]
  −
 
  −
Turtle Art can be run in the GNOME desktop outside of Sugar.
  −
 
  −
PC HARDWARE:
  −
* Download [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] (as a *.xo archive)
  −
* Extract the TurtleArt.activity directory from the archive, eg drag it to the desktop
  −
* Open directory TurtleArt.activity
  −
* Run turtleart.py (run in terminal is better, you can see error messages there)
  −
 
  −
OLPC XO HARDWARE
  −
* The XO1.5 and later software builds for the XO1.0 allow switching between Gnome and Sugar desktops. The following assumes that Turtle Art is already installed in Sugar.
  −
* Switch to the Gnome desktop
  −
* open olpc's home on the desktop
  −
* open Activities
  −
* open TurtleArt.activity
  −
* run turtleart.py (run in terminal is better, you can see error messages there)
  −
 
  −
== New features V83 and above==
  −
 
  −
<gallery>
  −
File:Coordinates.png|Cartesian and polar coordinate grids
  −
File:Collapsible.png|Collapsible stack
  −
File:Collapsed.png|Collapsed stack
  −
File:Python-expandable.png|Python function with one, two, or three variables
  −
File:Bullets-two.png|Expandable bullet list (two bullets)
  −
File:Bullets-four.png|Expandable bullet list (four bullets)
  −
File:Large-blocks.png|Enlarged blocks
  −
File:Small-blocks.png|Shrunken blocks
  −
File:100Turtles.png|100 Turtles
  −
File:TA-savesvg.svg|SVG output using the save SVG block
  −
File:TA-multivariable.png|Multi-variable Python blocks
  −
File:TAMaze.png|Turtle 'sees'
  −
</gallery>
  −
 
  −
==Portfolios==
  −
 
  −
In the era of high-stakes testing, we have the means to measure “which child knows more”; these data tell us about relative merit of the school in which a child is enrolled. The Turtle Art portfolio feature is an assessment tool that shows “what a child knows”; children become the curators of their own work. They advance their own learning and help their teachers, parents, and school administrators understand better the depth and breadth of what they have learned.
  −
 
  −
A [http://chronicle.com/wiredcampus/article/3668/electronic-portfolios-a-path-to-the-future-of-learning recent article] in the ''Chronicle of Higher Education'' claims:
  −
# ePortfolios can integrate student learning in an expanded range of media, literacies, and viable intellectual work;
  −
# ePortfolios enable students to link together diverse parts of their learning including the formal and informal curriculum;
  −
# ePortfolios engage students with their learning;
  −
# ePortfolios offer ''colleges'' a meaningful mechanism for accessing and organizing the evidence of student learning.
  −
 
  −
Turtle Art portfolios engage children in the process of reflecting on their work—what they have done, how they have done it, and how success these efforts have been—as they create a multimedia narrative to show their teachers, parents and peers what they have learned. Turtle Art Portfolio builds upon the journaling functionality of the Sugar learning platform, where every action or activity a child takes in the classroom is automatically recorded in a folder: (1) by enabling the child to select important learning achievements, be they in reading, writing, arithmetic, arts, music, physical education, history and social science, etc. Children answer questions such as “I chose this piece because...” (2) creating a multimedia narrative presentation from their selections (including audio voice-overs and video), reflective of the multiple ways in which children learn; and (3) sharing their presentation with classmates, both to celebrate what they have learned, but also to engage in a critical dialog about their work.
  −
 
  −
Turtle Art portfolio is innovative in three ways: (1) it builds upon a journal of *all* learning activities that is automatically collected; (2) it has unique programmability, fun and accessible to even the youngest elementary school children, but interesting and engaging to middle-school children as well; and (3) it has unique tools for both collaborating on the construction of the portfolio and its subsequent sharing with others.
  −
 
  −
Portfolios have been shown to be “a powerful means for children to assess their own work, set goals, and take responsibility for their future learning.” But portfolio assessment has seen limited applicability. It is a practical, engaging means to using portfolios. By building upon the automatic accumulation of work in journal (including a “screen capture” of their work) the portfolio process can readily be integrated into the classroom routine. Reflection becomes the norm: children are encouraged write in their journals (young children record audio notes) for a few minutes after *every* class. The numbing question, “what did you do in school today?” need no longer a necessary part of the parent-child dialog. Instead, the parent can talk to the child about actual artifacts.
  −
 
  −
Culling from the journal becomes part of the end-of-term assessment process. The process of telling one's story as a learning requires further reflection. At a “portfolio social”, parents are invited to view presentations and ask children about their learning; the child's voice is heard.
  −
 
  −
The classroom teacher can add addition assessment slides to the portfolio about themes such as work habits and personal growth, as part of an archive that travels with a child across grade levels. Through juxtaposition, the child and teacher can see what has changed over the course of the years, trends, and areas for improvement, Also, a classroom portfolio can be assembled as part of a teacher-assessment process.
  −
 
  −
Some additional background on ePortfolios can be found here:
  −
* [http://ncepr.org/ Inter/National Coalition for ePortfolio Research]
  −
* [http://epac.pbwiki.com/ ePortfolio Action & Communication – ePAC]
  −
* [http://electronicportfolios.org/ Helen Barrett’s ePortfolio site]
  −
* [http://www.igi-pub.com/reference/details.asp?ID=5072&v=preface Handbook of Research on ePortfolios]
  −
* [http://www.epforum.eu/ EuroPortfolio]
  −
* [http://www.eportfolio.lagcc.cuny.edu/conference/connections.html Making Connections National Resource Center]
  −
 
  −
===Quick Tutorial on using the portfolio features===
  −
<gallery>
  −
File:Portfolio1.png|Start by selecting a slide template from the palette. The templates will automatically expand into a stack.
  −
File:Portfolio2.png|Click on the Journal icon to initiate a search for slide content.
  −
File:Portfolio3.png|Select a journal object, such as an image, audio file, movie, or activity. A thumbnail will appear in the template.
  −
File:Portfolio4.png|The description field for the Journal object will automatically be loaded.
  −
File:Portfolio5.png|Once loaded, the slide stack can be labeled and collapsed.
  −
File:Portfolio6.png|Click on the slide template to view the slide. (Click on the Hide Blocks button on the View toolbar to hide any blocks that are covering your slide.)
  −
File:Portfolio8.png|Try using some of the other templates.
  −
File:Portfolio10.png|View them by clicking on them (you may want to use the Eraser button first).
  −
File:Portfolio11.png|You can program a simple slide show by making a stack: fullscreen; hide blocks; clear the screen; show Slide 1; wait; clear the screen; show Slide 2; wait; show blocks.
  −
File:Portfolio12.png|You can also program stacks for your slide decorations and slide transitions.
  −
File:Portfolio13.png|In this example, we draw a rule under the title of each slide.
  −
File:Portfolio14.png|Run your slide show by clicking on the Run Button on the Main toolbar.
  −
File:Portfolio15.png|In this example, we use keyboard input to transition between slides.
  −
</gallery>
  −
 
  −
<div class="visualClear"></div>
  −
 
  −
A video of the portfolio basics is available [http://www.dailymotion.com/user/sugarlabs/video/x9cpzd_turtleartportfoliobasics_creation here].
  −
 
  −
A PDF of a Turtle Art portfolio presentation can be downloaded [[File:Desktop-Summit.pdf|here]].
  −
 
  −
==Sharing==
  −
 
  −
Turtle Art supports a simple sharing model. Whomever joins a shared activity will share turtles with the other participants, e.g., whatever any turtle draws will appear on every screen. (Please note that the "show" block is not shared, so it is not possible to share multimedia objects.) Share can consume a lot of network bandwidth, so it is not recommended to share among more than 2–3 people at a time. Please note that as of Version 83, Turtle Art will not share correctly with older versions. As with all Sugar activities, you can use the Share-with feature of the Journal to share your Turtle Art projects with others.
  −
 
  −
<gallery>
  −
File:TAsharingTurtles1.png|This (yellow) turtle drew a green star.
  −
File:TAsharingTurtles2.png|This (blue) turtle drew a blue square.
  −
File:TAsharingTurtles3.png|This (red) turtle drew a red circle.
  −
</gallery>
  −
 
  −
==Exporting to Berkeley Logo==
  −
Turtle Art can export its projects to [http://www.cs.berkeley.edu/~bh/ Berkeley Logo] (using either View Source or the Save as Logo button on the [[#Project Toolbar|Project Toolbar]])
  −
 
  −
<gallery>
  −
File:Taspin.png|A Turtle Art project
  −
File:UCB-Logo.png|The UCB Logo version (see "Internals" below)
  −
</gallery>
  −
<div class="visualClear"></div>
  −
 
  −
Logo code generated from your project is viewable in the View Source panel.
  −
<gallery>
  −
File:TA-to-square.png|Turtle Art code
  −
File:TA-view-source.png|View Source menu
  −
File:TA-view-logo-code.png|Logo code
  −
</gallery>
  −
 
  −
'''Note:''' The Save-as-Logo button saves to the Journal as "logosession.lg". UCB Logo does not yet access the Journal directly, so it is necessary to copy the project out of the Journal using the "copy-from-journal" command in the Terminal Activity and then accessing the project using the File menu within the UCB Logo Activity.
  −
 
  −
copy-from-journal logosession.lg
  −
 
  −
Alternatively, you can open the logosession in 'Write', copy the Logo code to the clipboard, and then paste it into the UCB Logo Activity.
  −
 
  −
===Internals, how a Turtle Art project is converted to Logo===
  −
Shown here is the Logo code generated from the Turtle Art project shown above.
  −
 
  −
Firstly the Logo code contains procedures for setting up the palette and the shade functionality:
  −
 
  −
to tasetpalette :i :r :g :b :myshade
  −
make "s ((:myshade - 50) / 50)
  −
ifelse lessp :s 0 [
  −
make "s (1 + (:s *0.8))
  −
make "r (:r * :s)
  −
make "g (:g * :s)
  −
make "b (:b * :s)
  −
] [
  −
make "s (:s * 0.9)
  −
make "r (:r + ((100-:r) * :s))
  −
make "g (:g + ((100-:g) * :s))
  −
make "b (:b + ((100-:b) * :s))
  −
]
  −
setpalette :i (list :r :g :b)
  −
end
  −
 
  −
to rgb :myi :mycolors :myshade
  −
make "myr first :mycolors
  −
make "mycolors butfirst :mycolors
  −
make "myg first :mycolors
  −
make "mycolors butfirst :mycolors
  −
make "myb first :mycolors
  −
make "mycolors butfirst :mycolors
  −
tasetpalette :myi :myr :myg :myb :myshade
  −
output :mycolors
  −
end
  −
 
  −
to processcolor :mycolors :myshade
  −
if emptyp :mycolors [stop]
  −
make "i :i + 1
  −
processcolor (rgb :i :mycolors :myshade) :myshade
  −
end
  −
 
  −
to tasetshade :shade
  −
make "myshade modulo :shade 200
  −
if greaterp :myshade 99 [make "myshade (199-:myshade)]
  −
make "i 7
  −
make "mycolors :colors
  −
processcolor :mycolors :myshade
  −
end
  −
 
  −
to tasetpencolor :c
  −
make "color modulo round :c 100
  −
setpencolor :color + 8
  −
end
  −
 
  −
make "colors [
  −
100 0 0 100 5 0 100 10 0 100 15 0 100 20 0 100 25 0 100 30 0 100 35 0 100 40 0 100 45 0
  −
100 50 0 100 55 0 100 60 0 100 65 0 100 70 0 100 75 0 100 80 0 100 85 0 100 90 0 100 95 0
  −
100 100 0 90 100 0 80 100 0 70 100 0 60 100 0 50 100 0 40 100 0 30 100 0 20 100 0 10 100 0
  −
0 100 0 0 100 5 0 100 10 0 100 15 0 100 20 0 100 25 0 100 30 0 100 35 0 100 40 0 100 45
  −
0 100 50 0 100 55 0 100 60 0 100 65 0 100 70 0 100 75 0 100 80 0 100 85 0 100 90 0 100 95
  −
0 100 100 0 95 100 0 90 100 0 85 100 0 80 100 0 75 100 0 70 100 0 65 100 0 60 100 0 55 100
  −
0 50 100 0 45 100 0 40 100 0 35 100 0 30 100 0 25 100 0 20 100 0 15 100 0 10 100 0 5 100
  −
0 0 100 5 0 100 10 0 100 15 0 100 20 0 100 25 0 100 30 0 100 35 0 100 40 0 100 45 0 100
  −
50 0 100 55 0 100 60 0 100 65 0 100 70 0 100 75 0 100 80 0 100 85 0 100 90 0 100 95 0 100
  −
100 0 100 100 0 90 100 0 80 100 0 70 100 0 60 100 0 50 100 0 40 100 0 30 100 0 20 100 0 10]
  −
make "shade 50
  −
tasetshade :shade
  −
 
  −
to tasetbackground :color :shade
  −
tasetshade :shade
  −
setbackground :color + 8
  −
end
  −
 
  −
Then the Logo code contains the project:
  −
 
  −
to ta
  −
clearscreen tasetbackground 21 100 setpensize 25.0 make "box1 0.0
  −
repeat 300.0 [ tasetpencolor xcor / 6.0 tasetshade heading forward :box1 right 91.0 make "box1 :box1 + 1.0 ]
  −
end
  −
 
  −
ta
  −
 
  −
==Looking under the hood==
  −
 
  −
Turtle Art projects are stored as a .ta file contains a [http://docs.python.org/library/json.html json-encoded] serialization of the project.
  −
 
  −
The json encoding of a repeat 4 forward 100 right 90 project:
  −
                                     
  −
[[0,"repeat",331,158,[null,1,2,null]],[1,["number","4"],417,167,[0,null]],[2,"forward",426,207,[0,3,4]],[3,["number","100"],500,216,[2,null]],[4,"right",426,246,[2,5,null]],[5,["number","90"],500,255,[4,null]],[-1,"turtle",0,0,0,0,50,5]]
  −
 
  −
The basic structure of the encoding is a list of lists, where each block has these elements:
  −
# block number
  −
# block name or [block name, block value]
  −
# x position (depreciated)
  −
# y position (depreciated)
  −
# list of connections to other blocks
  −
 
  −
Turtles are encoded at the end of the list:
  −
# -1
  −
# turtle or [turtle, turtle name]
  −
# x position
  −
# y position
  −
# heading
  −
# pen color
  −
# pen shade
  −
# pen width
  −
 
  −
==Programmable Brick==
  −
 
  −
The following feature—a block that can be programmed by the Pippy activity—is available in versions 44+ of Turtle Art.
  −
 
  −
A copy of the tamyblock.py module is stored in the Journal when you first launch Turtle Art. You can edit the module in Pippy and then import your custom code into Turtle Art using the Pippy button on the Project toolbar.
  −
 
  −
[[Image:TAPippyButton.svg]]
  −
 
  −
[[Image:TA-pippy.png|300px]]
  −
 
  −
To use the customized block, select the "Pippy" block found on the the Extras palette.
  −
 
  −
Examples:
  −
 
  −
[[Image:TA-dotted-line.png]]
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Draw a dotted line of length x.
  −
    #
  −
    ###########################################################################
  −
    try:  # make sure x is a number
  −
      x = float(x)
  −
    except ValueError:
  −
        return
  −
    if lc.tw.canvas.pendown:
  −
        dist = 0
  −
        while dist+lc.tw.canvas.pensize < x:  # repeat drawing dots
  −
            lc.tw.canvas.setpen(True)
  −
            lc.tw.canvas.forward(1)
  −
            lc.tw.canvas.setpen(False)
  −
            lc.tw.canvas.forward((lc.tw.canvas.pensize*2)-1)
  −
            dist += (lc.tw.canvas.pensize*2)
  −
        lc.tw.canvas.forward(x-dist)          # make sure we have moved exactly x
  −
        lc.tw.canvas.setpen(True)
  −
    else:
  −
        lc.tw.canvas.forward(x)
  −
    return
  −
 
  −
You can pass a list of up to three arguments to tamyblock.py as in the example below that converts the input to an rgb value.
  −
 
  −
[[Image:TA-rgb.png]]
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Set rgb color
  −
    #
  −
    ###########################################################################
  −
    r = int(x[0])
  −
    while r < 0:
  −
        r += 256
  −
    while r > 255:
  −
        r -= 256
  −
    g = int(x[1])
  −
    while g < 0:
  −
        g += 256
  −
    while g > 255:
  −
        g -= 256
  −
    b = int(x[0])
  −
    while b < 0:
  −
        b += 256
  −
    while b > 255:
  −
        b -= 256
  −
    rgb = "#%02x%02x%02x" % (r,g,b)
  −
    lc.tw.fgcolor = lc.tw.canvas.cm.alloc_color(rgb)
  −
    return
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Push an uppercase version of a string onto the heap.
  −
    # Use a 'pop' block to use the new string.
  −
    #
  −
    ###########################################################################
  −
    if type(x) != str:
  −
        X = str(x).upper()
  −
    else:
  −
        X = x.upper()
  −
    lc.heap.append(X)
  −
    return
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Push hours, minutes, seconds onto the FILO.
  −
    # Use three 'pop' blocks to retrieve these values.
  −
    # Note: because we use a FILO (first in, last out heap),
  −
    # the first value you will pop will be seconds.
  −
    #
  −
    ###########################################################################
  −
    lc.heap.append(localtime().tm_hour)
  −
    lc.heap.append(localtime().tm_min)
  −
    lc.heap.append(localtime().tm_sec)
  −
    return
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Add a third dimension (gray) to the color model.
  −
    #
  −
    ###########################################################################
  −
    val = 0.3 * lc.tw.rgb[0] + 0.6 * lc.tw.rgb[1] + 0.1 * lc.tw.rgb[2]
  −
    if x != 100:
  −
        x = int(x)%100
  −
    r = int((val*(100-x) + lc.tw.rgb[0]*x)/100)
  −
    g = int((val*(100-x) + lc.tw.rgb[1]*x)/100)
  −
    b = int((val*(100-x) + lc.tw.rgb[2]*x)/100)
  −
    # reallocate current color
  −
    rgb = "#%02x%02x%02x" % (r,g,b)
  −
    lc.tw.fgcolor = lc.tw.canvas.cm.alloc_color(rgb)
  −
    return
  −
 
  −
def myblock(lc, x):
  −
    ###########################################################################
  −
    #
  −
    # Save an image named x to the Sugar Journal.
  −
    #
  −
    ###########################################################################
  −
    lc.tw.save_as_image(str(x))
  −
    return
  −
 
  −
===Understanding the Structure of the Turtle Art program===
  −
Turtle Art offers two blocks for adding Python code,
  −
* the Python function block [[image:Pythonfunctionblock.jpg]] adds a single line of code,
  −
* the Python code block [[image:Pythoncodeblock.jpg]] supports multi line code.
  −
 
  −
====Python function block====
  −
The Python function block is processed through tajail.py. For security reasons, it cannot access Turtle Art objects. It can it only access the Python language and the time, math and numpy libraries as the following extract from tajail.py shows.
  −
 
  −
from time import *
  −
from math import *
  −
try:
  −
    from numpy import *
  −
except ImportError:
  −
    _logger.error("could not import numpy")
  −
 
  −
 
  −
For more information on allowable syntax for this block:
  −
* Python language, see http://docs.python.org/tutorial/
  −
* Math library, see http://docs.python.org/library/math.html
  −
* Time library, see http://docs.python.org/library/time.html
  −
* Numpy library, see numpy.scipy.org/
  −
 
  −
====Python code block====
  −
Turtle Art is created in object oriented Python code. This is based around the definition of classes and the creation of object(s) which are instance(s) of that class. These objects then have properties and methods which are defined by their class.
  −
 
  −
See http://docs.python.org/tutorial/classes.html for a description of classes in Python.
  −
 
  −
See the file TurtleArtActivity.py. This is where it starts. When an instance of TurtleArtActivity is created, setup_canvas() creates an instance of TurtleArtWindow: self.tw This instance of TurtleArtWindow creates an instance of  LogoCode: self.tw.lc and an instance of TurtleGraphics: self.tw.canvas
  −
 
  −
tamyblock.py gets passed a LogoCode instance, lc, and everything is relative to that instance.  tw is passed to lc and set as an instance data object at init. This allows referral back to tw when needed. Consequently, Class TurtleArtWindow is accessed through lc.tw. and Class TurtleGraphics is accessed through lc.tw.canvas
  −
 
  −
 
  −
{| border=1 cellpadding=3 cellspacing=3 style="margin: 1em auto 1em auto; border: 1px #666666 solid; border-collapse: collapse; background: #f9f9f9;"
  −
!Class!!Defined in!!Instance!!Created in
  −
|-
  −
|TurtleArtActivity||TurtleArtActivity.py|| ||inherits from sugar.activity
  −
|-
  −
|TurtleArtWindow||tawindow.py||tw||TurtleArtActivity.py
  −
|-
  −
|LogoCode||talogo.py||lc||tawindow.py
  −
|-
  −
|TurtleGraphics||tacanvas.py||canvas||tawindow.py
  −
|-
  −
|Turtles, Turtle||taturtle.py||turtles||tawindow.py, tacanvas.py
  −
|-
  −
|Blocks, Block||tablock.py||block_list||tawindow.py
  −
|}
  −
 
  −
Class TurtleArtWindow – useful properties and methods (from within tamyblock.py, lc.tw is the class instance)
  −
{| border=1 cellpadding=3 cellspacing=3 style="margin: 1em auto 1em auto; border: 1px #666666 solid; border-collapse: collapse; background: #f9f9f9;"
  −
!Methods and data attributes!!Example!!Notes
  −
|-
  −
|set_fullscreen(self)||lc.tw.set_fullscreen()||Hides the Sugar toolbar
  −
|-
  −
|set_cartesian(self, flag)||lc.tw.set_cartesian(True)||True will make the overlay visible; False will make it invisible
  −
|-
  −
|set_polar(self, flag)||lc.tw.set_polar(True)||True will make the overlay visible; False will make it invisible
  −
|-
  −
|hideshow_button(self, flag)||lc.tw.hideshow_button()||Toggles visibility of blocks and palettes
  −
|-
  −
|self.active_turtle||lc.tw.active_turtle||The active turtle instance
  −
|}
  −
 
  −
Class TurtleGraphics – useful properties and methods (from within tamyblock.py, lc.tw.canvas is the class instance)
  −
{| border=1 cellpadding=3 cellspacing=3 style="margin: 1em auto 1em auto; border: 1px #666666 solid; border-collapse: collapse; background: #f9f9f9;"
  −
!Methods and data attributes!!Example!!Notes
  −
|-
  −
|clearscreen(self)||lc.tw.canvas.clearscreen()||Clears the screen and resets all turtle and pen attributes to default values
  −
|-
  −
|setpen(self, flag)||lc.tw.canvas.setpen(True)||True will set the pen "down", enabling drawing; False will set the pen "up"
  −
|-
  −
|forward(self, n)||lc.tw.canvas.forward(100)||Move the turtle forward 100 units
  −
|-
  −
|arc(self, a, r)||lc.tw.canvas.arc(120, 50)||Move the turtle along an arc of 120 degrees (clockwise) and radius of 50 units
  −
|-
  −
|setheading(self, a)||lc.tw.canvas.setheading(180)||Set the turtle heading to 180 (towards the bottom of the screen)
  −
|-
  −
|self.heading||lc.tw.canvas.heading||The current heading
  −
|-
  −
|setpensize(self, n)||lc.tw.canvas.setpensize(25)||Set the turtle pensize to 25 units
  −
|-
  −
|self.pensize||lc.tw.canvas.pensize||The current pensize
  −
|-
  −
|setcolor(self, c)||lc.tw.canvas.color(70)||Set the pen color to 70 (blue)
  −
|-
  −
|self.color||lc.tw.canvas.color||The current pen color
  −
|-
  −
|setshade(self, s)||lc.tw.canvas.shade(50)||Set the pen shade to 50
  −
|-
  −
|self.shade||lc.tw.canvas.shade||The current pen shade
  −
|-
  −
|fillscreen(self, c, s)||lc.tw.canvas.fillscreen(70, 90)||Fill the screen with color 70, shade 90 (light blue)
  −
|-
  −
|setxy(self, x, y)||lc.tw.canvas.setxy(100,100)||Move the turtle to position (100, 100)
  −
|-
  −
|self.xcor||lc.tw.canvas.xcor||The current x coordinate of the turtle (scaled to current units)
  −
|-
  −
|self.ycor||lc.tw.canvas.ycor||The current y coordinate of the turtle (scaled to current units)
  −
|-
  −
|self.set_turtle(name)||lc.tw.canvas.set_turtle(1)||Set the current turtle to turtle '1'
  −
|}
  −
 
  −
Other useful Python functions
  −
{| border=1 cellpadding=3 cellspacing=3 style="margin: 1em auto 1em auto; border: 1px #666666 solid; border-collapse: collapse; background: #f9f9f9;"
  −
!Module!!Methods and data attributes!!Example!!Notes
  −
|-
  −
|from math import pow||pow(2,3)||returns 2 to the 3rd power (8)||See http://docs.python.org/library/math.html
  −
|-
  −
|from math import sin, pi||sin(45*pi/180)||returns sin of 45 (0.707)||See http://docs.python.org/library/math.html
  −
|-
  −
|from time import localtime||localtime().tm_hour||returns the current hour||See http://docs.python.org/library/time.html
  −
|-
  −
| ||lc.heap.append(data)||add data to the FILO||See http://docs.python.org/tutorial/datastructures.html
  −
|-
  −
| ||data = lc.heap.pop(-1)||pop data off of the FILO||See http://docs.python.org/tutorial/datastructures.html
  −
|}
  −
 
  −
==From the field==
  −
 
  −
Tony Forster has written a number of blog posts about his experiments with Turtle Art:
  −
* [http://tonyforster.blogspot.com/2009/02/using-python-blocks-in-turtleart.html Using Python blocks in TurtleArt]
  −
* [http://tonyforster.blogspot.com/2009/02/turtle-lander.html Turtle Lander]
  −
* [http://tonyforster.blogspot.com/2009/01/reprogramming-sugar.html Reprogramming Sugar]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-random.html Turtle random]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-random-v2.html Turtle random V2]    [[File:Turtle Blocks Activity randomv3.ta]]  (English & español)
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-lissajous.html Turtle Lissajous] [[File:Turtle_Art_lisajous.ta‎]]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-spring-damper.html Turtle spring damper] [[File:Turtle_spring_damper.ta‎]]      (English & español)
  −
* [http://tonyforster.blogspot.com/2009/09/turtle-art-color-and-shade.html color and shade]
  −
* [http://tonyforster.blogspot.com/2009/09/turtleart-shapes.html Turtle Art shapes]
  −
* [http://tonyforster.blogspot.com/2009/12/bouncing-turtle.html Bouncing Turtle] [[File:TurtleArt_bounce.ta‎]]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-pythagoras.html Turtle Pythagoras 1], [http://tonyforster.blogspot.com/2010/02/turtle-pythagoras.html 2]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-graph.html Turtle graph] [[File:Turtle_graph.ta‎ ]]
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-pi.html Turtle Pi] [[File:Turtle_pi.ta]]    (English & español)
  −
* [http://tonyforster.blogspot.com/2010/10/turtle-pi-another-one.html Turtle Pi, another one] [[File:Turtle Blocks pi another.ta]] (English & español) 
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-fractions.html Turtle fractions] [[File:TmpBtvKZX.ta‎]]        (English & español)
  −
* [http://tonyforster.blogspot.com/2009/12/turtle-interactive-multimedia.html Turtle interactive multimedia]
  −
* [http://tonyforster.blogspot.com/2010/02/turtle-art-collapsed-stacks-and-numeric.html capture numeric input] [[File:Turtle_Art_getnumber.ta‎ ]]  (English & español)
  −
* [http://tonyforster.blogspot.com/2010/02/turtle-e.html Turtle e][[File:Turtle_e.ta‎]]        (English & español)
  −
* [http://tonyforster.blogspot.com/2010/03/turtle-spirograph.html Turtle spirograph] [[File:Turtle_Art_spirograph.ta‎]]          (English & español)
  −
* [http://tonyforster.blogspot.com/2010/03/mouse-support-in-turtleart.html Mouse support] [[File:Turtle_Art_Activity_mouse.ta‎]]
  −
* [http://tonyforster.blogspot.com/2010/03/turtle-sieve-of-eratosthenes.html Turtle-sieve-of-Eratosthenes] [[File: Turtle_Art_Activity_eratos.ta‎ ]]  (English & español)
  −
* [http://tonyforster.blogspot.com/2010/09/turtle-sliderule.html Turtle sliderule]
  −
* [http://tonyforster.blogspot.com/2010/09/turtle-diophantine.html Turtle Diophantine] [[File:Turtle Blocks Activity Diophantine.ta]], [http://wiki.laptop.org/go/Aplicacion_Problema_de_Pizzas#TortugArte see also]    (English & español)
  −
An bringing it all together, [http://tonyforster.blogspot.com/2009/03/turtle-oscilloscope.html the Turtle Art Oscilloscope].
  −
 
  −
[http://tonyforster.blogspot.com/2009/03/turtle-oscilloscope.html http://3.bp.blogspot.com/_fTmGyLerUL4/Sbyd3ClYTJI/AAAAAAAAARs/21Q1ERocXzE/s400/Untitled.jpg]
  −
 
  −
Tony has also used the programmable block to do [http://tonyforster.blogspot.com/2009/03/turtle-fileview.html file IO].
  −
 
  −
== Modifying Turtle Art ==
  −
 
  −
Turtle Art is under the MIT license. You are free to use it and learn with it. You are also encourage to modify it to suit your needs or just for a further opportunity to learn.
  −
 
  −
Much of the motivation behind the Version 0.83 refactoring of the code was to make it easier for you to make changes. Most changes can be confined to two modules: taconstants.py and talogo.py. The former defines the blocks and palettes; the latter defines what code is executed by a block.
  −
 
  −
taconstants.py contains the constants that by-in-large determine the behavior of Turtle Art. Notably, the block palettes are defined below. If you want to add a new block to Turtle Art, it is generally a matter of modifying some tables below and then adding the primitive to talogo.py. For example, if we want to add a new turtle command, 'uturn', we'd make the following changes:
  −
 
  −
(1) We'd add 'uturn' to the PALETTES list of lists:
  −
 
  −
PALETTES = [['forward', 'back', 'clean', 'left', 'right', 'show',
  −
              'seth', 'setxy', 'heading', 'xcor', 'ycor', 'setscale',
  −
              'arc', 'scale', 'left', 'top', 'right', 'bottom', 'uturn'],
  −
            ['penup','pendown', 'setpensize', 'fillscreen', 'pensize',...
  −
 
  −
(2) Then we'd add it to one of the block-style definitions. Since it takes
  −
no arguments, we'd add it here:
  −
 
  −
BASIC_STYLE = ['clean', 'penup', 'pendown', 'stack1', 'stack2', 'vspace',
  −
    'hideblocks', 'showblocks', 'clearheap', 'printheap', 'kbinput', 'uturn']
  −
 
  −
(3) Then we give it a name (Note the syntax _('string to be
  −
translated') used by the language-internationalization system; also
  −
note that the name is an array, as some blocks contain multiple
  −
strings.):
  −
 
  −
BLOCK_NAMES = {
  −
...
  −
    'uturn':[_('u-turn')],
  −
...
  −
              }
  −
 
  −
(4) and a help-menu entry:
  −
 
  −
HELP_STRINGS = {
  −
...
  −
    'uturn':_('change the heading of the turtle 180 degrees'),
  −
...
  −
              }
  −
 
  −
(5) Next, we need to define it as a primitive for the Logo command
  −
parser (generally just the same name):
  −
 
  −
PRIMITIVES = {
  −
...
  −
    'uturn':'uturn',
  −
...
  −
            }
  −
 
  −
(6) Since there are no default arguments, we don't need to do anything
  −
else here. But we do need to define the actual function in talogo.py
  −
 
  −
DEFPRIM = {
  −
...
  −
    'uturn':[0, lambda self: self.tw.canvas.seth(self.tw.canvas.heading+180)],
  −
...
  −
          }
  −
 
  −
That's it. When you next run Turtle Art, you will have a 'uturn' block
  −
on the Turtle Palette.
  −
 
  −
[[Image:TAuturn.png|300px]]
  −
 
  −
Adding a new palette is simply a matter of: (1) adding an additional entry to PALETTE_NAMES; (2) new list of blocks to PALETTES; and (3) an additional entry in COLORS. However you will have to: (4) create icons for the palette-selector buttons. These are kept in the icons subdirectory. You need two icons: yourpalettenameoff.svg and yourpalettenameon.svg, where yourpalettename is the same string as the entry you added to the PALETTE_NAMES list. Note that the icons should be the same size (55x55) as the others. This is the default icon size for Sugar toolbars.
  −
 
  −
==Just for fun==
  −
<gallery>
  −
File:Galapagos.png|my elder cousin
  −
File:Hot-cold.png|[http://www.dailymotion.com/user/sugarlabs/video/x9dsjf_hotcold-game_creation (video)]
  −
File:State-game.png|[http://www.dailymotion.com/user/sugarlabs/video/x9xz9o_stategame_tech (video)]
  −
File:Pie1.png
  −
File:Pie2.png|[http://5toescuela3.blogspot.com/2009/07/actividades-para-sugar.html Using Turtle Art for pie charts]
  −
File:Keyboard.png|Q: How do I cast keyboard input to a string? Looking at the source your are using ord() to fetch the input... is there a way to convert that back to string before showing it? ANS: Use chr(). See the example in the illustration.
  −
File:Explicit_approach.png
  −
File:Approximation_approach.png
  −
File:100_turtles.png
  −
</gallery>
 

Navigation menu