BP Blockly User Guide - Revision history

Assaf at 08:30, 12 May 2014

2014-05-12T08:30:14Z

2014-04-29T09:43:39Z

‎Example: Alternating Taps

2014-04-29T09:43:17Z

‎Example: Alternating Taps

2014-04-28T19:12:57Z

‎Example: The Rocket Landing Game Example

2014-04-28T19:12:40Z

‎Example: Alternating Taps

2014-04-28T19:11:46Z

‎Example: Alternating Taps

2014-04-28T18:41:43Z

‎Additional Examples

2014-04-28T18:36:23Z

‎Additional Examples

2014-04-28T18:34:14Z

‎Example: Alternating Taps

2014-04-28T18:33:24Z

‎Example: Alternating Taps

@@ Line 126: / Line 126: @@
 * BtnEast: User clicked East
 * BtnWest: User clicked West
-* . . .
+* BtnNorth: User clicked North
-* TimeTick: A unit of time passed (s
+* BtnSouth: User clicked South
 * RocketTouchedEastWall: Rocket arrived at east wall
 * RocketAwayFromEastWall: Rocket departed from east wall
-* . . .
+* (Same for west, north and south) . . .
 * TouchDown: Rocket touched launch pad and is aligned with it
 * Missed: Rocket reached or passed launch pad without being aligned with it
@@ Line 137: / Line 138: @@
 * RocketWest: Request to redraw rocket 10 pixels further to the west
 * RocketEast: Request to redraw rocket 10 pixels further to the east
 * RocketDown: Request to redraw rocket 10 pixels down
 * PadWest: The application wishes the pad to move 10 pixels further to the west
-* . . .
+* PadEast: The application wishes the pad to move 10 pixels further to the east
 * DisplayWin: The application determined that the player won
 * DisplayLose: The application determined that the player lost

@@ Line 98: / Line 98: @@
 = Example: Alternating Taps =
-* When in BP for Blockly (under FireFox), click the drop-down meny and select Hot and Cold.
+* When in BP for Blockly (under FireFox), click the drop-down menu and select "Hot and Cold".
 This example contains three enabled b-threads and one disabled b-thread.
 * 1. Requesting the event addHot 10 times.

@@ Line 98: / Line 98: @@
 = Example: Alternating Taps =
-* Download the zipped version of BP Blockly.
+* When in BP for Blockly (under FireFox), click the drop-down meny and select Hot and Cold.
-* When in BP for Blockly (under FireFox), click Load Project,  browse and select bp_code/apps/bp/examples/addHotCold.xml.
-This example contains three b-threads:
+This example contains three enabled b-threads and one disabled b-thread.
 * 1. Requesting the event addHot 10 times.
@@ Line 112: / Line 111: @@
 * Then enable the third b-thread, and run the program again. No events will be triggered due the blocking of addCold.
 * Click on the HTML tab and examine the HTML actuator code that displays the event text upon triggering of the events.  In another implementation this code could call a JavaScript method that actually opens a water tap for a few seconds.
-* A 4th b-thread was loaded disabled. This is an "actuator" b-thread that reacts to the addHot and addCold events. In this case, by displaying a window with the event text. Again, this b-thread could call a JavaScript method that performs a desired action.
+* The 4th b-thread was loaded disabled. This is an "actuator" b-thread that reacts to the addHot and addCold events. In this case, by displaying a window with the event text. Again, this b-thread could call a JavaScript method that performs a desired action.
 = Example: The Rocket Landing Game Example =

@@ Line 116: / Line 116: @@
 = Example: The Rocket Landing Game Example =
-To load this example click "Load Project" and browse and select bp_code/apps/bp/examples/RocketLanding.xml.
+* Download the zipped version of BP Blockly.
 In this game the player attempts to land a rocket on a landing pad on the surface of a planet. The rocket moves downward at a fixed speed in the vertical direction. Using GUI buttons, the player can move the rocket north, south, east and west, with the goal of positioning it directly above the landing pad. The player can also press an Up button to create an exhaust burst that
@@ Line 158: / Line 159: @@
 A key point to observe is that the behavior when rocket reaches the walls is independent and is by blocking of a move past the wall.
 = Additional Examples =

@@ Line 98: / Line 98: @@
 = Example: Alternating Taps =
 * Download the zipped version of BP Blockly.
-* When in BP for Blockly (under FireFox), click Load Project,  load the Hot and Cold example from the drop-down menu.
+* When in BP for Blockly (under FireFox), click Load Project,  browse and select bp_code/apps/bp/examples/addHotCold.xml.
 This example contains three b-threads:

@@ Line 163: / Line 163: @@
 The dropdown menu provides two additional examples
 * A nullification game: See explanation in [http://www.wisdom.weizmann.ac.il/~bprogram/pres/agere2012AuthorVersion.pdf AGERE 2012 paper]
-* A basic game of Tic-Tac-Toe
+* A basic game of Tic-Tac-Toe: This example, with very basic strategies, demonstrates the instantiation of a b-thread according to a parameter list. For example, the application block "all Squares" represents a list of all possible squares, and a b-thread is instantiated for each one of these, waiting for a user click in this square, and requesting an X event in the same square.

@@ Line 97: / Line 97: @@
 = Example: Alternating Taps =
-When in BP for blockly, load the Hot and Cold example from the drop-down menu.
+When in BP for Blockly, load the Hot and Cold example from the drop-down menu.
 This example contains three b-threads:
-* 1. Requesting the event addHot 10 times
+* 1. Requesting the event addHot 10 times.
-* 2. Requesting the event addCold 10 times
+* 2. Requesting the event addCold 10 times.
 * 3. Forcing the alternation of the two events by waiting for two occurrences of addHot event and blocking the addCold, and vice versa, in a loop.
 Experimenting:
 * Try disabling the third b-thread. Both remaining b-threads will run and events will alternate, per the round robin scheduling in this version of BP for Blockly.
 * Then try disabling the first b-thread. Only addCold events will be triggered.
 * Then enable the third b-thread, and run the program again. No events will be triggered due the blocking of addCold.
 Click on the HTML tab and examine the HTML actuator code that displays the event text upon triggering of the events.  In another implementation this code could call a JavaScript method that actually opens a water tap for a few seconds.
 A 4th b-thread was loaded disabled. This is an "actuator" b-thread that reacts to the addHot and addCold events. In this case, by displaying a window with the event text. Again, this b-thread could call a JavaScript method that performs a desired action.