2,486
edits
Changes
Jump to navigation
Jump to search
Line 4:
Line 4: − + − + + + + + + + + + + + + + + + + − 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.+ − + − + − + + + − + + + + + + + + + + − + − + − + − + − + − ===Import/Export Toolbar===+ − + − [[Image:TAimport.png]] − * Save copy to Journal button;+ − * save to HTML; − * [[#Exporting to Berkeley Logo|Save to Logo]]; − * Save as an image; − * Import Turtle Art project; − * Import [[#Programmable Brick|Python code]]; − * Import sample project − + Line 55:
Line 74: − + − * display of x,y coordinates of turtle;+ − + + + + − ===Help Toolbar===+ − + − * display help strings+ − === Palettes Toolbar ===+ − The palette menus are revealed by clicking on the Block icon on the main toolbar. (On older Sugar systems, select the Projects toolbar. When running Turtle Art from GNOME, the palettes are visible by default.)+ − [[File:TApalette-toolbar.png]]+ − As of Version 106 of Turtle Art, there are ten 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/Flow|Logical operators]]; [[Activities/Turtle_Art/Blocks|Logical blocks]]; Media blocks, [[Activities/Turtle_Art/Sensors|Sensor blocks]]; Customization functions; and [[Activities/Turtle_Art/Templates|Presentation blocks]]. An eleventh palette is used for restoring blocks from the trash.+ − 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-blocks.png]] button is used to hide/reveal the program blocks. Individual palettes can be hidden by clicking on their highlighted tab.+ − + Line 99:
Line 121: − + Line 108:
Line 130: + + + + + + − + − * set color: sets the pen color − * set shade: sets the pen shade − * set gray: sets the gray-level of the pen (Only available in Turtle Blocks) − * color: current pen color (can be used in place of a number block) − * shade: current pen shade (can be used in place of a number block) − * gray: current pen gray level (can be used in place of a number block) (Only available in Turtle Blocks) − + Line 144:
Line 166: − + Line 152:
Line 174: − + + + − * horizontal spacer (Only available with Turtle Blocks)+ − * vertical spacer+ − * stop stack: interrupt execution − + − + − * 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) − * action 1: top of 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 1: execute action 1 stack (Only available with Turtle Blocks) − ====Media Palette====+ − [[Image:TAmedia.png]] − These are a collection of blocks used for displaying media objects, such as images from the Journal.+ − * journal: Sugar Journal media object (used with show block) (also available in Turtle Art)+ − * audio: Sugar Journal media object (used with show block) − * video: Sugar Journal media object (used with show block) − * description: Sugar Journal description field (used with show block) − * text: text string (used with show block; also used with box and action blocks) − * show: draw text or display media object from the Journal − * set scale: sets the scale of images displayed with show block − * 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) − * scale: sets scale for show block (100% is full-screen) − * wait for media: used to pause program while audio or video file plays − + Line 208:
Line 210: − + + + Line 214:
Line 218: − + + + + + + + + + + + − + + + + + + + + + + + + + + + + − + Line 229:
Line 258: − + + + − + − + − + − + + + − + Line 258:
Line 291: + + + + + + + + − + Line 281:
Line 322: + +
Activities/Turtle Art/Toolbars (view source)
Revision as of 04:50, 14 April 2014
, 04:50, 14 April 2014→Edit Toolbar
===Main Toolbar===
===Main Toolbar===
[[Image:TAmain.png]]
[[Image:TAmain.png|800px]]
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
From left to right:
* Activity toolbar (includes sharing; saving/loading options);
* Edit toolbar (including copy and paste);
* View toolbar (including full-screen, coordinate overlays; turtle status, etc.);
* Palette toolbar (including all programming blocks);
* erase canvas;
* run project fast (rabbit);
* run project slow (snail);
* hide blocks (This button is replaced by the stop button when the project is running);
* help;
* load examples;
* stop activity
;Note: 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.
;Note: 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.
;Note: The "rabbit" button runs the blocks at maximum speed. The "snail" button pauses and displays the turtle and block values between each step.
;Note: The [[Image:Show-blocks.svg]] button, which is replaced by the Stop button on the main toolbar while the program is executing, is used to reveal the program blocks. Individual palettes can be hidden by clicking on their highlighted tab.
On older versions of Sugar (e.g., 0.84), the main toolbar will look like this:
;Note: On older versions of Sugar (e.g., 0.84), the main toolbar will look like this:
[[File:TA0.84.png]]
[[File:TA0.84.png|800px]]
===Project Toolbar===
===Project Toolbar===
[[Image:TAproject.png]]
[[File:TurtleBlocks_Toolbar_1.png|800px]]
From left to right:
From left to right:
* Project title;
* Project title;
* Write to Journal (on newer versions of Sugar)
* Keep button (not shown; only appears on older Sugar systems)
* [[#Sharing|Share]] button;
* [[#Sharing|Share]] button;
* Keep button;
* Share blocks button used to share stacks of blocks between collaborators (shown in inactive state);
* Save palette button (shows save options; see below);
* Load palette button (shows load options; see below)
;Note: On older Sugar systems, these controls appear on the Import/Export toolbar.
;Note: To share a stack, click on the share button. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be shared and the cursor will change back to the arrow shape.
[[File:TurtleBlocks_Toolbar_1a.png|800px]]
[[File:TurtleBlocks_Toolbar_1b.png|800px]]
===Edit Toolbar===
===Edit Toolbar===
[[Image:TAcopy.png]]
[[File:TurtleBlocks_Toolbar_2.png|800px]]
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.
The Edit toolbar is used to copy stacks of blocks to the clipboard and to paste stacks from the clipboard. To copy a stack, click on the copy button or type Ctrl-c. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be copied to the Sugar clipboard and the cursor will change back to the arrow shape. To paste from the clipboard, type Ctrl-v or click the paste button.
From left to right:
From left to right:
* Copy
* Copy;
* Paste
* Paste;
* Undo (Restore blocks from trash);
* Save stack to custom palette (use the hand cursor to select a stack to save, the stack of blocks must start with an "action" block);
* Remove stack from custom palette (use the hand cursor to select a stack on the custom palette to delete)
;Note:After save stack: To show the custom palette or see new stacks it is necessary to restart TurtleBlocks
===View Toolbar===
===View Toolbar===
[[Image:TAview.png]]
[[File:TurtleBlocks_Toolbar_4.png|800px]]
From left to right:
From left to right:
* Cartesian-coordinate grid;
* Cartesian-coordinate grid;
* polar-coordinate grid;
* polar-coordinate grid;
* not shown: centimeter-coordinate grid (XO-only);
* ''not shown'': centimeter-coordinate grid (XO-only);
* Rescale-coordinates button (There are two modes: one pixel-based and one scaled from -20 to 20);
* Rescale-coordinates button;
* Grow block size;
* Grow block size;
* Shrink block size
* Shrink block size
* Disable/enable hover help
* display of x,y coordinates, heading of turtle;
=== Palettes Toolbar ===
The palette menus are revealed by clicking on the Block icon on the main toolbar. (On older Sugar systems, select the Projects toolbar. When running Turtle Art from GNOME, the palettes are visible by default.)
[[Image:TAhelp.png]]
[[File:TurtleBlocks_Toolbar_5.png|800px]]
There are ten 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/Flow|Logical operators]]; [[Activities/Turtle_Art/Blocks|Logical blocks]]; [[Activities/Turtle_Art/Sensors|Sensor blocks]]; Media blocks; Customization functions; and [[Activities/Turtle_Art/Templates|Presentation blocks]]. An eleventh palette is used for restoring blocks from the trash.
;Note: Additional palettes may be loaded by [[Activities/Turtle_Art#plugins|plugin]] extensions to Turtle Blocks.
;Note: A custom palette is created if you use the 'save stack' button on the Edit toolbar.
;Note: 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.)
;Note: 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.
;Note: The palette can be hidden by clicking on the [[Image:TAhide.svg]] button on the lower-right corner of the palette.
;Note: 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.
;Note: On smaller screens, a palette may not fit. It can be scrolled by clicking on the [[Image:TAscroll.svg]] button.
====Turtle Palette====
====Turtle Palette====
[[Image:TAturtle.png]]
[[Image:TAturtle.png|800px]]
These blocks are used to control the movements of the turtle.
These blocks are used to control the movements of the turtle.
====Pen Palette====
====Pen Palette====
[[Image:TApen.png]]
[[Image:TApen.png|800px]]
These blocks are used to control the attributes of the turtle's pen.
These blocks are used to control the attributes of the turtle's pen.
* fill screen: fill the screen with a color/shade and reposition the turtle in the center of the screen
* 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)
* pen size: width of the line drawn by the turtle (can be used in place of a number block)
* set color: sets the pen color
* set shade: sets the pen shade
* set gray: sets the gray-level of the pen (Only available in Turtle Blocks)
* color: current pen color (can be used in place of a number block)
* shade: current pen shade (can be used in place of a number block)
* 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)
* start fill: starts a filled polygon (straight sides, not arcs)
* end fill: ends a fill polygon (straight sides, not arcs)
* end fill: ends a fill polygon (straight sides, not arcs)
====Color Palette====
====Color Palette====
[[Image:TAcolors.png]]
[[Image:TAcolors.png|800px]]
These blocks can be used with the set-pen-color block in place of a number block.
These blocks can be used with the set-pen-color block in place of a number block.
====Numbers Palette====
====Numbers Palette====
[[Image:TAnumbers.png]]
[[Image:TAnumbers.png|800px]]
These blocks are arithmetic and boolean operators.
These blocks are arithmetic and boolean operators.
====Flow Palette====
====Flow Palette====
[[Image:TAflow.png]]
[[Image:TAflow.png|800px]]
These blocks control program flow.
These blocks control program flow.
* repeat: repeat the execution of stack under the right flow a specified number of times
* 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: 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)
* if/then/else: conditional execution of the stack under the center and right flows (uses boolean operators found on the Number palette)
* vertical spacer
* stop stack: interrupt execution
* while: execute stack under right flow ''while'' the condition is true (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)
* until: execute stack under right flow ''until'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
'''Note:''' Nesting ''while'' and/or ''until'' blocks is not always reliable. If you encounter an error, try putting the nested block in a separate stack, accessed with an action block.
====Blocks Palette====
====Blocks Palette====
[[Image:TAblocks.png]]
[[Image:TAblocks.png|800px]]
These blocks are for defining variables and subroutines.
These blocks are for defining variables and subroutines. Without actions
* start: connects action to toolbar 'Run' button
* start: connects action to toolbar 'Run' button
* store in: store a number, string, or media object in a named box
* store in: store a number, string, or media object in a named box
* action: top of named action stack
* action: top of named action stack
* action: execute named action stack
* action: execute named action stack
'''Note:''' When a named action or named box block are used, new blocks appear on the palette that correspond to these names; e.g., if a top of action stack is rename, "to square", an action block, "to square" is added to the palette.
[[Image:TAblocks_yes.png|800px]]
Palette with additional actions and boxes created by the user.
====Sensors Palette====
====Sensors Palette====
[[Image:TAsensors.png]]
[[Image:TAsensors.png|800px]]
* query keyboard: check for keyboard input (results are stored in the keyboard block)
* query keyboard: check for keyboard input (results are stored in the keyboard block)
* pitch: the resolution is +-8Hz
* pitch: the resolution is +-8Hz
* brightness: average luminance seen through camera
* brightness: average luminance seen through camera
* camera: grab image from camera
* button down: current state of the mouse button (1 == down; 0 == ip)
* mouse x: x position of mouse
* mouse y: y position of mouse
The OLPC XO can measure external inputs with its microphone jack:
The OLPC XO can measure external inputs with its microphone jack:
* voltage: measurement range is DC 0.4V to 1.85V. (OLPC XO1) and 0.17V to 3.0V (OLPC XO1.5)
* voltage: measurement range is DC 0.4V to 1.85V. (OLPC XO1) and 0.17V to 3.0V (OLPC XO1.5)
See [[Activities/TurtleArt/Using Turtle Art Sensors]] for more details about the sensor blocks.
The OLPC XO 1.75 also includes an accelerometer.
* accelerate (not shown): measure the acceleration of the computer. Results are pushed to the stack and can be retrieved by using 3 'pop' blocks (one for X (horizontal), one for Y (vertical), and one for Z (forward/backward))
See [[Activities/Turtle Art/Using Turtle Art Sensors]] for more details about the sensor blocks.
([[Activities/Turtle Art/Uso de Tortuga Arte Sensores]] español)
====Media Palette====
[[Image:TAmedia.png|800px]]
These are a collection of blocks used for displaying media objects, such as images from the Journal.
([[Activities/TurtleArt/Uso_de_TortugaArte_Sensores]] español)
* journal: Sugar Journal media object (used with show block) (also available in Turtle Art)
* audio: Sugar Journal media object (used with show block)
* video: Sugar Journal media object (used with show block)
* description: Sugar Journal description field (used with show block)
* text: text string (used with show block; also used with box and action blocks)
* show: draw text or display media object from the Journal
* set scale: sets the scale of images displayed with show block
* 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)
* scale: sets scale for show block (100% is full-screen)
* media wait: used to pause program while audio or video file plays
* media stop: stop current sound or video
* media pause: pause current sound or video
* media resume: resume playing paused media
* speak: sends text to the voice synthesizer
* sine wave: plays a sine wave of a given frequency, amplitude, and duration
====Extras Palette====
====Extras Palette====
[[Image:TAextras.png]]
[[Image:TAextras.png|800px]]
These are a collection of extra blocks for accessing advanced features only available in Turtle Blocks.
These are a collection of extra blocks for accessing advanced features only available in Turtle Blocks.
* print: print value in status block (also available in Turtle Art)
* print: print value in status block (also available in Turtle Art)
* comment: program comment (displayed in "walk" mode)
* comment: program comment (displayed in "walk" mode)
* Python: a [[Activities/TurtleArt-0.88#Python_function_block|programmable block]] (can be used in place of a number block)
* chr: Python chr primitive: converts ASCII to character (useful for converting keyboard input to text)
* int: Python int primitive: converts input to integers
* Python: a [[Activities/Turtle Art-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)
:: 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]
* Import Python: [[Activities/Turtle Art-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]
* Cartesian: display Cartesian coordinate grid overlay
* Cartesian: display Cartesian coordinate grid overlay
* polar: display polar coordinate grid overlay
* polar: display polar coordinate grid overlay
* turtle: specify which turtle is active
* turtle: specify which turtle is active
* turtle shell: import a image from the Journal to use as the turtle's 'shell', i.e., replace the turtle with a sprite.
* turtle shell: import a image from the Journal to use as the turtle's 'shell', i.e., replace the turtle with a sprite.
* top of stack: block to denote the top of a collapsible stack
* turtle x: Return x coordinates of turtle
* bottom of stack: block to denote the bottom of a collapsible stack
* turtle y: Return y coordinates of turtle
:: To use the collapsible-stack blocks, place them around the blocks you want to hide
* active turtle: the name of active turtle
* turtle heading: Return heading of turtle
* URL: gets a text string or image from a URL
====Portfolio Palette====
====Portfolio Palette====
[[Image:TAportfolio.png]]
[[Image:TAportfolio.png|800px]]
These blocks are used to make multimedia presentations only available in Turtle Blocks.
These blocks are used to make multimedia presentations only available in Turtle Blocks.
* height: screen height (can be used in place of a number block)
* height: screen height (can be used in place of a number block)
::Note: The slide blocks expand into stacks that can be edited for customized presentations.
::Note: The slide blocks expand into stacks that can be edited for customized presentations.
====User custom-stack palette====
[[Image:TAStack.png|800px]]
The custom palette holds any blocks that have been saved with "Save Stack" option in Edit Toolbar. It lets you reuse stacks between projects.
Blocks on this palette will expand into action stacks.
;Note: This palette first appears after using the "Save stack" option on the Edit Toolbar.
====Trash Palette====
====Trash Palette====
[[Image:TAtrash.png]]
[[Image:TAtrash.png|800px]]
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.
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.
File:TAsensors-es.png
File:TAsensors-es.png
File:TAextras-es.png
File:TAextras-es.png
File:TAstack-es.png
File:TAportfolio-es.png
File:TAportfolio-es.png
File:TAtrash-es.png
</gallery>
</gallery>