Math4Team/RIT/Projects/Fun Towers: Difference between revisions

(11 intermediate revisions by 3 users not shown)

Line 1:

[[Image:~~FTscreenshot~~.~~jpg~~|250px|thumb|right|~~The initial~~ version of fun towers]]

[[Image:FunTowers.JPG|250px|thumb|right|Our modified version of fun towers]]

==Group Members==

*[[User:EricMallon|Eric Mallon]]

Line 14:

We have completed the initial proposed modifications to the game to make it applicable to 4th grade math education. At this point we consider the game 'done' for all practical purposes, and it is now a viable option to help teach 4th grade math on the XO laptop.

While the code and cards are complete, we cannot get the resources of the cards to correctly load at this time, so it does not load correctly on the XO. The pr file containing the code to run the game on the XO uses a different mechanism to load image resources. At this time, we are unable to load these resources. Using the modifications below the game will run in Squeak though.

==~~Proposed~~ Domains==

==Implemented Domains==

*4.N.4: Select, use, and explain models to relate common fractions and mixed numbers (1/2, 1/3, 1/4, 1/5, 1/6, 1/8, 1/10, 1/12, and 11/2), find equivalent fractions, mixed numbers, and decimals, and order fractions.

Line 35:

Line 36:

*Implement level select: The player can use a simple level selector to switch between all the levels.

'''[[Fun Tower Level Select | Fun Tower Level Select Code Description]]'''

==Future Plans==

Line 43:

Line 45:

*Integrate teacher reporting API (potentially using [http://map.squeak.org/package/dab9b621-00d2-41c3-966c-458bf62b8008 SoapCore]) to output time it takes for student to finish level

*Addressing more standards, or standards of a different education system (Current standards are all Massachusetts based)

If you have any questions about the project, email Tyler Bragdon at eldrac@gmail.com

==How To Play==

* You have one card of your own; your goal is to remove all the cards from the towers

* You can remove a face-up card from the towers if it is one unit up or down from the card you have. 8 Units of change vary between levels, each level corresponds to a math4 standard. The standard unit is 1, so a card displaying the number 6 allows you to remove a card with a 5 or a 7 from the towers. Another example of a unit is 1/4, so if you have 2 1/2, you can remove 2 1/4 or 2 3/4's.

* You have one card of your own; your goal is to remove all the cards from the towers

* If you click on a card in the tower to remove it, and it is a valid removal (one unit up/down) then that card becomes your new card, displayed to the right of the deck.

* You can remove a face-up card from the towers if it is one unit up or down from the card you have.

* At any time, the student can click on the deck to receive a new card.

8 Units of change vary between levels, each level corresponds to a math4 standard. The standard unit is 1, so a card displaying the number 6 allows you to remove a card with a 5 or a 7 from the towers. Another example of a unit is 1/4, so if you have 2 1/2, you can remove 2 1/4 or 2 3/4's.

* The game is won when all cards from all 3 of the towers have been removed

* If you click on a card in the tower to remove it, and it is a valid removal (one unit up/down) then that card becomes your new card, displayed to the right of the deck.

* To switch levels, click the scroll buttons in the bottom left of the screen until the desired level is displayed. Hit the start button to switch to the new level.

* At any time, the student can click on the deck to receive a new card.

* The game is won when all cards from all 3 of the towers have been removed.

* To switch levels, click the scroll buttons in the bottom left of the screen until the desired level is displayed. Hit the start button to switch to the new level.

==Project Files==

* Game Image File (http://www.cs.rit.edu/~gtb2909/FunTowers/FunTowersImage.zip)

* Teacher Documentation (http://www.cs.rit.edu/~gtb2909/FunTowers/FunTowersTeacher.doc)

* Modified Game Card files (http://www.cs.rit.edu/~gtb2909/FunTowers/Cards.zip)

==Project Resources==

* Fun Towers XO Game Download (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_080601.xo)

* Fun Towers Original XO Game Download (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_080601.xo)

* Fun Towers Game Source (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_OLPC_080121.sar)

* Fun Towers Original Game Source (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_OLPC_080121.sar)

* Squeak by Example (http://www.iam.unibe.ch/~scg/SBE/SBE.pdf)

* An Introduction to Morphic: The Squeak User Interface Framework (http://stephane.ducasse.free.fr/FreeBooks/CollectiveNBlueBook/morphic.final.pdf)

Line 63:

Line 70:

* EToys image download (http://etoys.laptop.org/src/etoys-image-and-pr.zip)

* SoapCore Squeak SOAP client (http://map.squeak.org/package/dab9b621-00d2-41c3-966c-458bf62b8008)

* Modified Game Card files (http://www.cs.rit.edu/~gtb2909/FunTowers/Cards.zip)

==Project Setup==

~~PC:~~

First go to the squeak download page linked above, and download the version of squeak appropriate for your operating system. Also download Fun Tower's image file linked in the project files section, and extract both files into the same folder. Run squeak.exe, and it will ask you to select an image file - chose the one with funtowers in its name. The game should now be running on your computer.

First ~~download and extract the Etoys image zip file, next download the squeak executable from~~ the squeak download page and ~~place~~ squeak.~~exe~~ in the folder ~~with the Etoys image file~~. ~~Next download the game source file (.sar) - run~~ squeak.exe, and ~~drag and drop the .sar~~ file ~~into~~ the ~~Etoys window, selecting the "Install SAR" option~~. ~~Click the "Make a Project" button to get to a blank screen, then press Alt+, to bring up the main menu and click 'new morph', go to from alphabetical list, D-F, and click on FtGame.~~ The game is now ~~loaded in the Etoys environment.~~

~~XO:~~

~~Using the browse program~~ on ~~the XO, simply download the XO game download from the link above and it automatically installs~~.

==Accessing Game Code==

~~With~~ the game ~~loaded into the etoys environment~~ on ~~either the XO or PC~~, ~~again hit~~ Alt + , ~~to bring up~~ the ~~main menu. Select~~ the ~~last option to "edit this~~ menu~~". In the window that pops up, press the small browse~~ button in the ~~middle~~ left ~~to bring up the system browser~~. ~~In the left column of the system browser~~, ~~scroll down~~ and select ~~Funtowers-Game, in~~ the ~~other columns you can now select and browse all~~ the ~~game~~ code.

Follow the steps above to get the game running on your computer, then hold down Alt and click on the game in the screen, options buttons should appear surrounding the game - select the red menu button in the top mid-left. From that menu go down to debug, and select browse morph class. The window containing the browser for the games code should now appear.

==Contacts==

@@ Line 1: / Line 1: @@
-[[Image:FTscreenshot.jpg|250px|thumb|right|The initial version of fun towers]]
+[[Image:FunTowers.JPG|250px|thumb|right|Our modified version of fun towers]]
 ==Group Members==
 *[[User:EricMallon|Eric Mallon]]
@@ Line 14: / Line 14: @@
 We have completed the initial proposed modifications to the game to make it applicable to 4th grade math education. At this point we consider the game 'done' for all practical purposes, and it is now a viable option to help teach 4th grade math on the XO laptop.
+While the code and cards are complete, we cannot get the resources of the cards to correctly load at this time, so it does not load correctly on the XO.  The pr file containing the code to run the game on the XO uses a different mechanism to load image resources.  At this time, we are unable to load these resources. Using the modifications below the game will run in Squeak though.
-==Proposed Domains==
+==Implemented Domains==
 *4.N.4: Select, use, and explain models to relate common fractions and mixed numbers (1/2, 1/3, 1/4, 1/5, 1/6, 1/8, 1/10, 1/12, and 11/2), find equivalent fractions, mixed numbers, and decimals, and order fractions.
@@ Line 35: / Line 36: @@
 *Implement level select: The player can use a simple level selector to switch between all the levels.
+'''[[Fun Tower Level Select | Fun Tower Level Select Code Description]]'''
 ==Future Plans==
@@ Line 43: / Line 45: @@
 *Integrate teacher reporting API (potentially using [http://map.squeak.org/package/dab9b621-00d2-41c3-966c-458bf62b8008 SoapCore]) to output time it takes for student to finish level
 *Addressing more standards, or standards of a different education system (Current standards are all Massachusetts based)
+If you have any questions about the project, email Tyler Bragdon at eldrac@gmail.com
 ==How To Play==
+* You have one card of your own; your goal is to remove all the cards from the towers
+* You can remove a face-up card from the towers if it is one unit up or down from the card you have. 8 Units of change vary between levels, each level corresponds to a math4 standard. The standard unit is 1, so a card displaying the number 6 allows you to remove a card with a 5 or a 7 from the towers. Another example of a unit is 1/4, so if you have 2 1/2, you can remove 2 1/4 or 2 3/4's.
-   * You have one card of your own; your goal is to remove all the cards from the towers
+* If you click on a card in the tower to remove it, and it is a valid removal (one unit up/down) then that card becomes your new card, displayed to the right of the deck.
-   * You can remove a face-up card from the towers if it is one unit up or down from the card you have.
+* At any time, the student can click on the deck to receive a new card.
-Units of change vary between levels, each level corresponds to a math4 standard. The standard unit is 1, so a card displaying the number 6 allows you to remove a card with a 5 or a 7 from the towers. Another example of a unit is 1/4, so if you have 2 1/2, you can remove 2 1/4 or 2 3/4's.
+* The game is won when all cards from all 3 of the towers have been removed
-   * If you click on a card in the tower to remove it, and it is a valid removal (one unit up/down) then that card becomes your new card, displayed to the right of the deck.
+* To switch levels, click the scroll buttons in the bottom left of the screen until the desired level is displayed. Hit the start button to switch to the new level.
-   * At any time, the student can click on the deck to receive a new card.
-   * The game is won when all cards from all 3 of the towers have been removed.
-   * To switch levels, click the scroll buttons in the bottom left of the screen until the desired level is displayed. Hit the start button to switch to the new level.
+==Project Files==
+* Game Image File (http://www.cs.rit.edu/~gtb2909/FunTowers/FunTowersImage.zip)
+* Teacher Documentation (http://www.cs.rit.edu/~gtb2909/FunTowers/FunTowersTeacher.doc)
+* Modified Game Card files (http://www.cs.rit.edu/~gtb2909/FunTowers/Cards.zip)
 ==Project Resources==
-* Fun Towers XO Game Download (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_080601.xo)
+* Fun Towers Original XO Game Download (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_080601.xo)
-* Fun Towers Game Source (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_OLPC_080121.sar)
+* Fun Towers Original Game Source (http://www.hpi.uni-potsdam.de/hirschfeld/projects/olpc/media/Funtowers_OLPC_080121.sar)
 * Squeak by Example (http://www.iam.unibe.ch/~scg/SBE/SBE.pdf)
 * An Introduction to Morphic: The Squeak User Interface Framework (http://stephane.ducasse.free.fr/FreeBooks/CollectiveNBlueBook/morphic.final.pdf)
@@ Line 63: / Line 70: @@
 * EToys image download (http://etoys.laptop.org/src/etoys-image-and-pr.zip)
 * SoapCore Squeak SOAP client (http://map.squeak.org/package/dab9b621-00d2-41c3-966c-458bf62b8008)
-* Modified Game Card files (http://www.cs.rit.edu/~gtb2909/FunTowers/Cards.zip)
 ==Project Setup==
-PC:
+First go to the squeak download page linked above, and download the version of squeak appropriate for your operating system.  Also download Fun Tower's image file linked in the project files section, and extract both files into the same folder.  Run squeak.exe, and it will ask you to select an image file - chose the one with funtowers in its name.  The game should now be running on your computer.
-First download and extract the Etoys image zip file, next download the squeak executable from the squeak download page and place squeak.exe in the folder with the Etoys image file.  Next download the game source file (.sar) - run squeak.exe, and drag and drop the .sar file into the Etoys window, selecting the "Install SAR" option.  Click the "Make a Project" button to get to a blank screen, then press Alt+, to bring up the main menu and click 'new morph', go to from alphabetical list, D-F, and click on FtGame. The game is now loaded in the Etoys environment.
-XO:
-Using the browse program on the XO, simply download the XO game download from the link above and it automatically installs.
 ==Accessing Game Code==
-With the game loaded into the etoys environment on either the XO or PC, again hit Alt + , to bring up the main menu.  Select the last option to "edit this menu".  In the window that pops up, press the small browse button in the middle left to bring up the system browser.  In the left column of the system browser, scroll down and select Funtowers-Game, in the other columns you can now select and browse all the game code.
+Follow the steps above to get the game running on your computer, then hold down Alt and click on the game in the screen, options buttons should appear surrounding the game - select the red menu button in the top mid-left.  From that menu go down to debug, and select browse morph class.  The window containing the browser for the games code should now appear.
 ==Contacts==