Changes

26,215 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;}}{{GoogleTrans-en}}{{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 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.
   −
==Where to get Turtle Art==
+
=== Where to get Turtle Blocks ===
   −
[[Image:Activity-turtleart.png]]
+
http://activities.sugarlabs.org/en-US/sugar/addon/4027
   −
'''There is a new experimental version of Turtle Art available: [[File:TurtleArt-83.xo]].'''
+
'''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) 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
   −
[http://activities.sugarlabs.org/en-US/sugar/addon/4027 Version 82] | [http://activities.sugarlabs.org/en-US/sugar/addon/4027 addons] | [http://git.sugarlabs.org/projects/turtleart Source] | [http://en.flossmanuals.net/turtleart FLOSS Manual] | [http://wiki.laptop.org/go/TurtleArt laptop.org Turtle Art page] | [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] | [[Activities/TAExperimental|Experimental fork]] | [http://www.turtleart.org/ Turtle Art Gallery] | [[0.86/TurtleArt|0.86 release notes]] | [http://www.dailymotion.com/sugarlabs/video/15708788 Introductory video] | [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://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 OLPC tickets] | [http://neoparaiso.com/logo/galeria-graficos-de-tortuga.html Another Turtle Art gallery]
+
Fedora users can do:
 +
# <strike>sudo yum install turtleblocks</strike>
 +
# sudo yum install sugar-turtleart
   −
'''Note:''' The first time you run Turtle Art, it takes about 60 seconds to load. You'll see a mostly blank screen after the initial flashing of the icon. Subsequently, the loading time is ~5 seconds (on an OLPC-XO-1 laptop).
+
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.
   −
=== i18n ===
+
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.
   −
Turtle Art currently has support for: de, el, en, es, fi, fr, it, mn, nl, pt, ru, sl, sv, ta, tr, vi, and zh_TW
+
{{:Activities/Turtle Art/Getting_started}}
   −
(See [https://dev.laptop.org/translate/ our Pootle server] for details about how to translate Turtle Art into your language.)
+
{{:Activities/Turtle Art/Turtle_Cards}}
   −
==Background==
+
{{:Activities/Turtle Art/Challenges}}
   −
Turtle Art is an activity with a Logo-inspired graphical "turtle" that draws colorful art based on [http://wiki.laptop.org/go/Scratch Scratch]-like snap-together visual programming elements.
+
{{:Activities/Turtle Art/Toolbars}}
   −
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]]. The [[Activities/TAExperimental|experimental version of Turtle Art]] also has a (limited) facility for sensor input, so, for example, you can move the Turtle based upon sound volume or pitch.
+
{{:Activities/Turtle Art/Extras}}
   −
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.
+
{{:Activities/Turtle Art/Tutorials}}
   −
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.
+
{{:Activities/Turtle Art/Galleries}}
   −
===Learning with Turtle Art===
+
{{:Activities/Turtle Art/Portfolios}}
   −
Play with Turtle Art to draw colorful art patterns using a turtle that accepts instructions for movement.
+
{{:Activities/Turtle Art/Logo}}
   −
With visual programming blocks, you can snap together programs by compiling (combining) them in ways to create anything you can imagine.
+
{{:Activities/Turtle Art/Programmable_Brick}}
   −
[[Image:TA-sample1.png|400px]] [[Image:TA-sample2.png|400px]] [[Image:TA-sample3.png|400px]] [[Image:TA-sample4.png|400px]] [[Image:TA-sample5.png|400px]] [[Image:TA-sample6.png|400px]]
+
{{:Activities/Turtle Art/Plugins}}
   −
====maths====
+
{{:Activities/Turtle Art/Misc}}
   −
A clock activity
+
{{:Activities/Turtle Art/Under_the_hood}}
   −
[[Image:TAclock1.png|400px]] [[Image:TAclock2.png|400px]] [[Image:TAclock3.png|400px]] [[Image:TAclock4.png|400px]]
+
{{:Activities/Turtle Art/Packaging}}
   −
Calculating the hypotenuse and approximating the angle of a right triangle; Stepping through the program is a nice way to visualize the process of approximation; The final result of the approximation.
+
== Credits ==
 
+
* Walter Bender and Raúl Gutiérrez Segalés maintain the code (with some occasional help from Simon Schampijer)
[[Image:TAgeometry.png|400px]] [[Image:TAgeometry1.png|400px]] [[Image:TAgeometry2.png|400px]]
+
* Especially helpful feedback from Tony Forster, Guzmán Trinidad, and Bill Kerr
 
+
* Matthew Gallagher works on packaging and wrote the project-upload code
And on-the-fly function definitions:
+
* Brian Silverman is the first author of Turtle Art
 
  −
[[Image:Ta-sin.png]] [[Image:Sine.png|300px]]
  −
 
  −
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====
  −
 
  −
[[Image:Portfolio14.png|400px]] [[Image:Portfolio10.png|400px]]
  −
 
  −
====games====
  −
 
  −
Turtle Art can be used to write games, such as a simple falling block game:
  −
 
  −
[[Image:WeGotGame.png|400px]] [[Image:WeGotGame2.png|400px]]
  −
 
  −
===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]
  −
 
  −
==Getting Started==
  −
 
  −
[[Image:TA-1.png|400px]]
  −
 
  −
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.
  −
===tips===
  −
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, "hat2", 880, 80, [null, 1]], [1, "forever", 892, 130, [0, 2, null]], [2, "kbinput", 973, 144, [1, 3]], [3, "if", 973, 198, [2, 4, 7, 8]], [4, "greater", 1053, 208, [3, 5, 6, null]], [5, "keyboard", 1085, 217, [4, null]], [6, ["number", "0"], 1234, 217, [4, null]], [7, "stopstack", 1068, 272, [3, null]], [8, "wait", 973, 313, [3, 9, null]], [9, ["number", "0.5"], 1047, 322, [8, null]]]
  −
 
  −
You can also paste text from the clipboard into text blocks.
  −
 
  −
[[Image:TAGnome.png|600px]]
  −
 
  −
Turtle Art runs in Sugar and in the GNOME desktop.
  −
 
  −
===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]]
  −
 
  −
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.
  −
 
  −
===View Toolbar===
  −
 
  −
[[Image:TAview.png]]
  −
 
  −
Hide/show blocks; 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]]
  −
 
  −
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]]
  −
 
  −
On the far-right end of the toolbar is the hide/show palette button.
  −
 
  −
Blocks are dragged from the palette onto the canvas surface. To dispose of a block, drag it back onto the 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.
  −
 
  −
[[Image:TAturtle.png]]
  −
 
  −
These blocks are used to control the movements of the turtle.
  −
 
  −
[[Image:TApen.png]]
  −
 
  −
These blocks are used to control the attributes of the turtle's pen.
  −
 
  −
[[Image:TAcolors.png]]
  −
 
  −
These blocks can be used with the set-pen-color block.
  −
 
  −
[[Image:TAnumbers.png]]
  −
 
  −
These blocks are arithmetic and boolean operators.
  −
 
  −
[[Image:TAflow.png]]
  −
 
  −
These blocks control program flow.
  −
 
  −
[[Image:TAblocks.png]]
  −
 
  −
These blocks are for defining variables and subroutines.
  −
 
  −
[[Image:TAextras.png]]
  −
 
  −
These are a collection of extra blocks for accessing advanced features.
  −
 
  −
[[Image:TAportfolio.png]]
  −
 
  −
These blocks are used to make multimedia presentations.
  −
 
  −
[[Image:TAvertical.png]]
  −
 
  −
An example of a vertical palette.
  −
 
  −
<!--
  −
<span class="plainlinks">
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Turtle http://wiki.sugarlabs.org/images/6/6d/TA-turtle-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Pen http://wiki.sugarlabs.org/images/8/81/TA-pen-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Numbers http://wiki.sugarlabs.org/images/4/46/TA-numbers-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Sensors http://wiki.sugarlabs.org/images/6/6c/TA-sensors-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Flow http://wiki.sugarlabs.org/images/a/ac/TA-flow-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Blocks http://wiki.sugarlabs.org/images/4/45/TA-myblocks-palette.png]
  −
[http://wiki.sugarlabs.org/go/Activities/Turtle_Art/Templates http://wiki.sugarlabs.org/images/5/51/TA-templates.png]
  −
</span>
  −
-->
  −
 
  −
<!--
  −
{{:Activities/Turtle_Art/Turtle}}
  −
 
  −
{{:Activities/Turtle_Art/Pen}}
  −
 
  −
{{:Activities/Turtle_Art/Numbers}}
  −
 
  −
{{:Activities/Turtle_Art/Sensors}}
  −
 
  −
{{:Activities/Turtle_Art/Flow}}
  −
 
  −
{{:Activities/Turtle_Art/Blocks}}
  −
 
  −
{{:Activities/Turtle_Art/Templates}}
  −
-->
  −
 
  −
== New features ==
  −
 
  −
[[Image:Coordinates.png|300px|Cartesian and polar coordinate grids]]
  −
[[Image:Collapsible.png|300px|Collapsible stack]]
  −
[[Image:Collapsed.png|300px|Collapsed stack]]
  −
[[Image:Python-expandable.png|300px|Python function with one, two, or three variables]]
  −
[[Image:Bullets-two.png|300px|Expandable bullet list (two bullets)|]]
  −
[[Image:Bullets-four.png|300px|Expandable bullet list (four bullets)]]
  −
[[Image:Large-blocks.png|300px|Enlarged blocks]]
  −
[[Image:Small-blocks.png|300px|Shrunken blocks]]
  −
[[Image:100Turtles.png|300px|100 Turtles]]
  −
 
  −
==Quick Tutorial on using the portfolio features==
  −
[[Image:Portfolio1.png|thumb|left|200px|Start by selecting a slide template from the palette.]]
  −
[[Image:Portfolio2a.png|thumb|left|200px|Click on the Journal icon to initiate a search for slide content.]]
  −
[[Image:Portfolio3.png|thumb|left|200px|Select a journal object.]]
  −
[[Image:Journal1.png|thumb|left|200px|The Journal preview and description will be used.]]
  −
[[Image:Portfolio4.png|thumb|left|200px|A thumbnail will appear in the template.]]
  −
[[Image:Portfolio5.png|thumb|left|200px|Click on the slide template to view the slide.]]
  −
[[Image:Portfolio6.png|thumb|left|200px|Click on the Hide Blocks button on the toolbar to hide any blocks that are covering your slide.]]
  −
[[Image:Portfolio7.png|thumb|left|200px|Congratulations. You've made a slide.]]
  −
[[Image:Portfolio8.png|thumb|left|200px|Try using some of the other templates.]]
  −
[[Image:Portfolio10.png|thumb|left|200px|View them by clicking on them (you may want to use the Eraser button first).]]
  −
[[Image:Portfolio11.png|thumb|left|200px|You can program a simple slide show by making a stack: clear the screen; show Slide 1; wait; clear the screen; show Slide 2.]]
  −
[[Image:Portfolio12.png|thumb|left|200px|You can also program stacks for your slide decorations and slide transitions.]]
  −
[[Image:Portfolio13.png|thumb|left|200px|In this example, we draw a rule under the title of each slide and poll for keyboard input to transition between slides.]]
  −
[[Image:Portfolio14.png|thumb|left|200px|Run your slide show by clicking on the Run Button (rabbit) on the toolbar.]]
  −
[[Image:Portfolio15.png|thumb|left|200px|In this example, we use microphone input to transition between slides.]]
  −
 
  −
 
  −
<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 get a copy of the current state of the project from the initiator of the share. Subsequent changes to the project are shared between all participants. It is not recommended to share among more than 2–3 people at a time. Please note that if different versions of Turtle Art are used in the same share instance, there may be problems, as old versions won't know how to handle new bricks introduced in later versions.
  −
 
  −
[[Image:TAsharing.png|400px]]
  −
 
  −
==Exporting to Berkeley Logo==
  −
Turtle Art can export its projects to [http://www.cs.berkeley.edu/~bh/ Berkeley Logo] (using the Save as Logo button on the [[#Project Toolbar|Project Toolbar]])
  −
 
  −
[[Image:Taspin.png|thumb|left|a Turtle Art project]]
  −
[[Image:UCB-Logo.png|thumb|left|the UCB Logo version]]
  −
<div class="visualClear"></div>
  −
 
  −
'''Note:''' The project is saved 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
  −
 
  −
===Internals===
  −
Some 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
  −
 
  −
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 two files: (1) a .ta file contains a [http://docs.python.org/library/json.html json-encoded] serialization of the project; and (2) a .png file of the canvas.
  −
 
  −
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]]
  −
 
  −
==Programmable Brick==
  −
 
  −
The following feature is only available in versions 44+ of Turtle Art.
  −
 
  −
=== myblock.py ===
  −
 
  −
And a block that can be programmed by the Pippy interface:
  −
 
  −
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.
  −
 
  −
[[Image:TAPippyButton.svg]]
  −
 
  −
[[Image:TA-pippy.png|300px]]
  −
 
  −
To use the customized block, select the "view source" block from the Sensors palette.
  −
 
  −
[[Image:TAMyblock.svg]]
  −
 
  −
Examples:
  −
 
  −
def myblock(lc,x):
  −
    # draw a dotted line of length x
  −
    # make sure x is a number
  −
    if type(x) != int and type(x) != float:
  −
        return
  −
    dist = 0
  −
    # save current turtle pen state
  −
    pen = lc.tw.turtle.pendown
  −
    # repeat drawing dots
  −
    while dist+lc.tw.turtle.pensize < x:
  −
        setpen(lc.tw.turtle, True)
  −
        forward(lc.tw.turtle, 1)
  −
        setpen(lc.tw.turtle, False)
  −
        forward(lc.tw.turtle, (lc.tw.turtle.pensize*2)-1)
  −
        dist += (lc.tw.turtle.pensize*2)
  −
    # make sure we have moved exactly x
  −
    forward(lc.tw.turtle, x-dist)
  −
    # restore pen state
  −
    setpen(lc.tw.turtle, pen)
  −
return
  −
 
  −
[[Image:TA-dotted-line.png]]
  −
 
  −
def myblock(lc,x):
  −
    # push an uppercase version of a string onto the heap
  −
    if type(x) != str:
  −
        X = str(x).upper()
  −
    else:
  −
        X = x.upper()
  −
    # push result onto heap (use the pop block to use the new string)
  −
    lc.heap.append(X)
  −
return
  −
 
  −
def myblock(lc,x):
  −
    # push hours, minutes, seconds onto the heap
  −
    # use three pop blocks to retrieve the values
  −
    # remember: the heap is a FILO (first in, last out)
  −
    # 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
  −
    # calculate the value (brightness) of the current color
  −
    val = 0.3 * lc.tw.rgb[0] + 0.6 * lc.tw.rgb[1] + 0.1 * lc.tw.rgb[2]
  −
    # make sure gray is in range from 0 to 100
  −
    if x != 100:
  −
        x = int(x)%100
  −
    # mix in gray
  −
    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
  −
    lc.tw.fgcolor = lc.tw.cm.alloc_color(r<<8,g<<8,b<<8)
  −
return
  −
 
  −
def myblock(lc,x)
  −
    # save a screenshot in the journal
  −
    lc.tw.activity._do_saveimage_cb(lc.tw.activity)
  −
return
  −
 
  −
===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]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-lissajous.html Turtle Lissajous]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-spring-damper.html Turtle spring damper]
  −
[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]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-pythagoras.html Turtle Pythagoras]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-graph.html Turtle graph]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-pi.html Turtle Pi]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-fractions.html Turtle fractions]
  −
[http://tonyforster.blogspot.com/2009/12/turtle-interactive-multimedia.html Turtle interactive multimedia]
  −
 
  −
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].
  −
 
  −
==Just for fun==
  −
 
  −
[[Image:Galapagos.png|400px]]
  −
 
  −
[[Image:Hot-cold.png|400px]]
  −
[http://www.dailymotion.com/user/sugarlabs/video/x9dsjf_hotcold-game_creation (video)]
  −
 
  −
[[Image:Yes-no.png|400px]]
  −
 
  −
[[File:State-game.png|400px]]
  −
[http://www.dailymotion.com/user/sugarlabs/video/x9xz9o_stategame_tech (video)]
  −
 
  −
[[File:Pie1.png|200px]][[File:Pie2.png|200px]]
  −
[http://5toescuela3.blogspot.com/2009/07/actividades-para-sugar.html Using Turtle Art for pie charts]
  −
 
  −
[[File:Keyboard.png|400px]] 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|400px]]
  −
 
  −
[[File:Approximation_approach.png|400px]]
  −
 
  −
[[File:100_turtles.png|400px]]