deejoe / sugarizer-lite

A lightweight, shallow-clone fork of Sugarizer stripped of the two largest activities
Apache License 2.0
3 stars 5 forks source link

Describe FractionBounce #13

Open cja1093 opened 4 years ago

cja1093 commented 4 years ago

This issue will be used to describe the FractionBounce project. I'll incorporate a game description as well as steps to install the activity.

GitHub: https://github.com/sugarlabs/fractionbounce

README.md covers a lot of the essentially content for getting started

cja1093 commented 4 years ago

Gameplay

Players must nudge a bouncing ball to land on the an area of the ground representing a particular percentage or fraction equivalent to the fraction displayed on screen. Correct answers add a check to the background image

Screenshot

DennisSSDev commented 4 years ago

@cja1093 I have a few questions regarding the game and it would be great if you could point me at direct code examples:

cja1093 commented 4 years ago

Installation

It is not a part of Sugar desktop, but can be added via the browse method on an instance of Sugar. (Look for it on the sugarlabs activity list)

Note: I haven't been able to get a working install of the activity on my sugarlive build

Architecture

image

DennisSSDev commented 4 years ago

woops I mentioned @ymoullec in the previous issue, I meant @cja1093 :P

cja1093 commented 4 years ago

@cja1093 I have a few questions regarding the game and it would be great if you could point me at direct code examples:

  • Is the number of fractions set in stone, or are they generate at random during the runtime of the game?
  • are the fractions going to be smaller than one? On the screenshots, it seems that it's always in the range of 0 to 1
  • Is the ball falling based on physics? Or is it just a linear translation till it hits the bottom?
  • What happens when the player drops the ball in the wrong section?

image

cja1093 commented 4 years ago

Educational Value

This activity will be fairly useful for 4th graders in the way it helps create a visual understanding of basic fraction (or percentage) values. It sets a good foundation for continued work with fractions regarding equivalence and general comparisons (such as comparing denominators, adding/subtracting fractions, and multiplying fractions).

BlueJay89 commented 4 years ago
  • Is the ball falling based on physics? Or is it just a linear translation till it hits the bottom?
* Based on the [ball.py](https://github.com/sugarlabs/fractionbounce/blob/master/ball.py) file it seems there are stored transform values that are applied to the ball's position and rotation (not entirely sure on this one)

To piggyback on cja1093 I've delved into the ball.py and bounce.py and while the instance of the ball in the game has no properties that would utilize physics to move it, it uses simple transformations. However, bounce.py uses information from an accelerometer (if the device it is playing on has one) to dictate transformation data to the instance of the ball. This could give a more natural feel to the movement of the ball as if it were acting under the laws of physics.

ghost commented 4 years ago

My mention of this issue has already been noted in the Github web interface, but I wanted to mention it explicitly also in a comment for benefit of the notifications system (and for my email inbox):

Specifically, I want to note the corresponding Sugarizer development issue for this activity:

18

as participants in each issue can earn credit working across the lines with their counterparts in the other, corresponding issue (developers seeking or offering feedback from/to describers and vice versa).

BlueJay89 commented 4 years ago

Fraction Bounce is an activity designed to teach and reinforce the concepts of basic fractions.

The overview of the user experience this game is well described in the sugar labs wiki: https://wiki.sugarlabs.org/go/Activities/Fraction_Bounce

The game involves moving a bouncing ball across the screen based on a given fraction, score is kept based on the successes of the players ability to match the movement of the ball to the given fraction in the form of smiley faces.

ghost commented 4 years ago

@BlueJay89 Since @cja1093 got out ahead on this issue pretty well, your best opportunity to get a little more done on this issue could be synthesizing the discussion so far into something to place in:

https://github.com/ritjoe/sugarizer-lite/tree/master/hfoss-2195

BlueJay89 commented 4 years ago

@ritjoe you're suggesting an organized summary of the actions taken, discussion, and results of this issue in a document to be added to that location? I can certainly begin working on that.

deejoe commented 4 years ago

On Wed, Apr 29, 2020 at 07:51:04AM -0700, BlueJay89 wrote:

@ritjoe you're suggesting an organized summary of the actions taken, discussion, and results of this issue in a document to be added to that location? I can certainly begin working on that.

Yes. Mostly with a focus on the descriptions themselves. Some mention of the Chrome debugging efforts would be ok to put in, too, but the idea is that this would serve as a reference to someone who wanted to continue working on the Javascript implementation of the activity.