Duong Pham's CS390 Project Page

"High level design of the module."

The Hole Objects

• HoleID and ScreenCoordinate: The Hole object will know its ID number and its on screen location. The ID number will be one of the number in the pyramid below (ie. 00 or 21). 15 hole objects are stored in a array in the module. The on screen location is the xyz coordinate of the world window where the hole and the board are drawn. This world window then is mapped to the screen to create the viewable portion on the screen.
  

              00
           10    11
        20    21    22
     30    31    32    33
  40    41    42    43    44
  

• HasPeg: This boolean variable tells the module whether there is a peg in the whole. If HasPeg is true, there is a peg in the specified hole. If HasPeg is false, there is an empty hole on the board.
• The shape of the peg and the board are created graphically using pre-defined shapes in openGL libraries.

The Board Objects

• The board contains a array of 15 holes objects.

  void drawBoard()

  • The board is drawn first. Next it uses a loop to iterator through all the pegs and draw each peg if the "hasPeg" attribute is true.
  • The function is called after each move to display changes made to the board.

  void reset()

  • Once this function is called, attribute "hasPeg" of all the holes will be set to "true". The program is set to capture user's mouse click.

void readFirstMove(string move)

• The function captures the coordinates of the screen upon the user's click. The coordinates will be checked if it matches any peg. If it does, the peg's ID will be pass back as the string. The solver will process this string to produce the solutions.

void readMove(string peg, string hole)

• This function has 2 arguments, 2 pegIDs, which indicates the next move of the puzzle. The first string is the peg which wil be moved. The second argument will be the empty whole the peg will be moved to.
• The board will be changed according to these 2 pegIDs. The "hasPeg" attribute of the first peg will be set to false. The "hasPeg" attribute of the second peg will be set to be true.
• The drawBoard function will then be called to display the change in the board configuration.

void animation(string removedPeg, string peg, string hole)

• This function takes 3 arguments, the removedPeg is to be removed from the board, the peg and the hole are to be swapped. The complete animation process has two step. First, the middle peg will get smaller and gratually disappear. Second, the moving peg will slide to the empty hole. The animation cannot be interupted. After each animation the program will execute any event generated during the time the animation is going.

Handlers

Mouse handler

• The mouse handler will capture user's click and check if any peg is selected. If no peg is selected, nothing will happen. If the peg is selected, the solving process begins. Once the solving process begin, user's click is discarded. Once the puzzle is restarted, the user then can click again.

Keyboard handler

• The matrix of the camera will be recalculated each time one of the navigation buttons is pressed. After applying changes to the camera, the screen will be redrawn with the new camera configuration.
• When the key "p" is pressed, the process is paused until the key "p" is again pressed. During the pause, user can fly to the predesignated spots by pressing keys from 1 to 4 or pressing arrow keys with "f" and "b" keys.
• Pressing the key "r" when the puzzle is solved will reset the value "hasPeg" of all the holes to "true". A new board will be generated and the user can click on the peg to start the solving process again.