Week 2: June 8-12

Git commits: 5bf03bf - 8b2680e

Goals and Milestones

Goals

• Perform a thorough refactor of the preview tool so that it supports the same elements and functionality it did a year ago
• Take our improved organization of the preview tool and set it up so that it loads information from the schema
  • This would first include the Act, Scene, Screen structure
  • ...and then we would move on to loading game elements.

Milestones

• Read through relevant background material
• Examined the code
• Took ownership of the GitHub account
• Exchanged communication information necessary with all members of the team

Weekly Log

We brought the June 2014 preview tool into the new repository and began creating new packages and classes to keep the code organized. We chose the Naked Objects model as our design pattern, the reasoning as follows: The business logic contained within the object itself, along with the generation of the UI representation. This means that the UI is a direct representation of the object itself. This means edits in the Preview tool are actually edits to the underlying data structures Adding new elements to the preview tool, without damaging the ways other classes function (a big problem in the original code base), is extremely simple.

Weekly Progress Report

Tasks Completed

• Implemented:
  • Element resizing (on all edges)
  • Image elements
  • Text elements
  • Backdrops
  • Music proof of concept

Tasks for Next Week

• Attempt to load the sandbox challenge in the schema
• Examine how the characters were previously loaded from the schema
• Begin background research for the usability ("user experience") study
• Update the mentors on our progress

Possible Limitations Observed

• The naked objects structure means that “right clicking” an object and selecting delete will be difficult as the object itself will try and delete itself.
  • Possible fix: Publisher/Subscriber system
• We also hoped to be able to generate polygons from the XML to support challenges like the right angle puzzle in the original sandbox. We encountered problems trying to use the Java Polygon libraries and considered other mathematical ways that the XML could generate shapes (e.g. generating triangles given angles and length measurements). The team that created the original sandbox hardcoded their triangles, with no means of generating shapes. Our determination was that, if we keep shapes as a priority, it would be best to have a customizable triangle function where the XML sets the angles and sides and a generic polygon generator that created equilateral shapes of five or more sides.
• Schema issues
• We only load what information we need, JAXB will only serialize what data we do load.
  • Possible fix: Create skeleton classes to hold the extra data
• Crossbred JDOM and JAXB
• Characters are not given a location in the current schema, they are hard coded in the game engine
• Props do not exist in the schema
• Characters do not include positions in the schema

Bugs Observed

• Button elements will ignore element rendering order, jumping in front of other elements at times.
• The “Rounded Text Box” border leaves a trail when being moved, and the edges of the corners are grey instead of transparent

Week 3: June 15-19

Git commits: e328473 - e37059f

Goals and Milestones

Goals

• Attempt to load the sandbox challenge in the schema
• Examine how the characters were previously loaded from the schema
• Begin background research for the usability ("user experience") study
• Work on deleting when we go from the preview tool to the main code
• Add sound effects to the buttons
• Implement hints
• Implement saving
• Implement "our" idea of what a Prop is
• Be able to add elements
• Be able to change the background
• Be able to change the music
• Be able to see learning objectives
• Update the mentors on our progress
• ===> Figure out how to let the user revise the content

Milestones

• Examined how the characters were previously loaded from the schema
• Began background research for the usability ("user experience") study
• Implemented hints
• Implemented saving
• Worked on a database for the repository

Weekly Log

Joe S. implemented hints. The team brainstormed to consider the program's overall design and how best saving might be implemented. William pulled research articles as background for the usability study and got familiar with RefWorks. Joe S. built the game manager to oversee saving within the preview tool. This will use a change log to record when the user performs certain actions (for example, when the user resizes a button). He programmed the overall structure so that the saving and "undo" functions can be added, tested, and debugged at a later time. The team members updated their mentors on their progress. Finally, Joe S. and William welcomed a new member to the SimSYS family, Joe A.

Joe S. and Joe A. got to work fixing up the preview tool and implemented undo and redo functions as well as saving. This was followed by some debugging (since too many undos would make an object disappear) and modifications to the change log so that if a user performed an undo and then did an undo again, the second undo did not mess up the first undo. William pulled more articles related to the research study through Marquette's databases and through inter-library loan.

Joe S. and Joe. A made considerable progress on the preview tool, and the team decided that a good next step would be to look at structuring the repository so that it can be used for generating and previewing games. The projects's mentors disagreed, and asked us to pursue a file structure. William got the go-ahead to start planning out scenarios for the user study and looking in to how that could be implemented. At our weekly meeting Joe A. and Lakis Wu introduced themselves to the whole team.

Weekly Progress Report

Tasks for Next Week

• Start on file structure for XMLs and learning objectives.
• Continue imporving the preview tool so that is is where we want it to be for the study
• Continue on the design for the usability study

Possible Limitations Observed

• Character positions are still a schema issue, and so displaying them in the preview tool will require more work

Week 4: June 22-26

Git commits: a65e7a6 - []

Goals and Milestones

Goals

• Continue to update the preview tool to get it ready for the study
• Implement the ability to swap out questions
• Come up with a design for the usability study
• Plan the content of the XML we will have to make for the study (4th grade math is our content)

Milestones

• Background and props fully implemented

Weekly Log

• Monday
  • Joe S. implemented the ability to place props from the selection window
  • Joe S. and Joe A. implemented the ability to switch out backgrounds and play music and sound.
  • William reviewed VLC materials to make sure the user study closely aligns with the claims of the paper.
  • Joe A. did more work refining the undo/redo function
  • William started a sketch for the user study
  • The trio talked with Dr. Brylow over Google+ and discussed moving forward.
  • Joe S. edited the code that handles the change log
  • Joe S. and Joe A. chased down a bug in the undo/redo function that had been plaguing them
  • The trio sent an email to their mentors updating them on their progress

• Tuesday

• Wednesday

• Thursday

• Friday

Weekly Progress Report

Tasks Completed

Tasks for Next Week

Possible Limitations Observed

Bugs Observed

Week 5: June 29 - July 3

Git commits: [] - []

Goals and Milestones

Goals

Milestones

Weekly Log

• Monday

• Tuesday

• Wednesday

• Thursday

• Friday

Weekly Progress Report

Tasks Completed

Tasks for Next Week

Possible Limitations Observed

Bugs Observed

</font>