Changes

Jump to navigation Jump to search

User:Ignacio Rodríguez/TurtleArt (view source)

Revision as of 20:06, 4 December 2013

214 bytes added ,  20:06, 4 December 2013
→‎Blocks Palette
Line 5: Line 5:     
[[Image:TAmain.png|800px]]
 
[[Image:TAmain.png|800px]]
−
      
From left to right:
 
From left to right:
Line 15: Line 14:  
* run project fast (rabbit);
 
* run project fast (rabbit);
 
* run project slow (snail);
 
* run project slow (snail);
−
* stop project;
+
* hide blocks (This button is replaced by the stop button when the project is running);
−
* save a snapshot (save a copy of the current state of the project);
+
* help;
 
* load examples;
 
* load examples;
−
* display help palette;
   
* stop activity
 
* 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.
+
;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.
   −
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 "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|800px]]
 
[[File:TA0.84.png|800px]]
Line 38: Line 40:  
* Keep button (not shown; only appears on older Sugar systems)
 
* Keep button (not shown; only appears on older Sugar systems)
 
* [[#Sharing|Share]] button;
 
* [[#Sharing|Share]] button;
−
* Share blocks; shown in disable state. Used to share stacks of blocks between collaborators.
+
* Share blocks button used to share stacks of blocks between collaborators (shown in inactive state);
−
* Save as image;
+
* Save palette button (shows save options; see below);
−
* [[#Exporting to Berkeley Logo|Save as Logo]];
+
* Load palette button (shows load options; see below)
−
* Load a previously saved project from the Sugar Journal;
  −
* Load [[#Programmable Brick|Python code into a programmable block]]
      
;Note: On older Sugar systems, these controls appear on the Import/Export toolbar.
 
;Note: On older Sugar systems, these controls appear on the Import/Export toolbar.
−
;Note: On smaller screens, the load/save buttons are shown on a palette.
   
;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.
 
;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_1a.png|800px]]
 +
 
[[File:TurtleBlocks_Toolbar_1b.png|800px]]
 
[[File:TurtleBlocks_Toolbar_1b.png|800px]]
   Line 58: Line 58:     
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);
 +
* Remove stack from custom palette (use the hand cursor to select a stack on the custom palette to delete)
 +
 
 +
;Note:After save stack: For show custom palette is needed restart of TurtleBlocks
    
===View Toolbar===
 
===View Toolbar===
Line 70: Line 75:  
* polar-coordinate grid;
 
* polar-coordinate grid;
 
* ''not shown'': centimeter-coordinate grid (XO-only);
 
* ''not shown'': centimeter-coordinate grid (XO-only);
−
* display of x,y coordinates, heading of turtle;
+
* 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
 
* Disable/enable hover help
 +
* display of x,y coordinates, heading of turtle;
    
=== Palettes Toolbar ===
 
=== Palettes Toolbar ===
Line 84: Line 89:  
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.
 
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: Additional palettes may be loaded by [[Activities/Turtle_Art#plugins|plugin]] extensions to Turtle 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.)
+
;Note: A custom palette is created if you use the 'save stack' button on the Edit toolbar.
   −
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. On smaller screens, a palette may not fit. It can be scrolled by clicking on the [[Image:TAscroll.svg]] button.
+
;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.)
   −
The [[Image:Show-blocks.svg]] button, which replaces 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.
+
;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====
Line 174: Line 185:  
[[Image:TAblocks.png|800px]]
 
[[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 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
 
* 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 1: top of action 1 stack (Only available with Turtle Blocks)
  −
* action 2: top of action 2 stack (Only available with Turtle Blocks)
   
* action: execute named action stack
 
* action: execute named action stack
−
* action 2: execute action 2 stack (Only available with Turtle Blocks)
  −
* action 1: execute action 1 stack (Only available with Turtle Blocks)
      
'''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.
 
'''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====
Line 205: Line 210:  
* 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)
 
* button down: current state of the mouse button (1 == down; 0 == ip)
 
* mouse x: x position of mouse
 
* mouse x: x position of mouse
Line 236: Line 240:  
* 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)
 
* 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)
 
* scale: sets scale for show block (100% is full-screen)
−
* wait for media: used to pause program while audio or video file plays
+
* media wait: used to pause program while audio or video file plays
 
* media stop: stop current sound or video
 
* media stop: stop current sound or video
 
* media pause: pause current sound or video
 
* media pause: pause current sound or video
Line 263: Line 267:  
* 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.
−
* sandwich clamp: "clamp" a stack of blocks to hide
+
* turtle x: Return x coordinates of turtle
 +
* turtle y: Return y coordinates of turtle
 +
* 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====
Line 283: Line 291:  
* 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====
Line 306: Line 322:  
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>
Retrieved from "https://wiki.sugarlabs.org/go/Special:MobileDiff/90688...90749"

Navigation menu