Suggestion:

• Ignore the issues brought up by the animation requirement until after you have successfully implemented and tested the system for graphical presentation without animation
• Then revisit the animation issue by following the hints given later

This section suggests the way to do this.

• Should extend JComponent
• Should be declared to be abstract
  • No abstract methods, but
  • Must be subclassed to override the paintComponent method
• Constructor should take the first State object displayed by the canvas and store it
• Should provide accessor and mutator for the state being displayed
• It may help to also provide an accessor and mutator for the previous state to carry out animation
• This class can also have any methods that might be generally useful to subclasses

• Constructor should take a Canvas object as its second argument and store it (along with the Problem argument from before)
• The canvas, being a JComponent, should be added to the GUI layout instead of the JTextArea from before
• In the move button listeners, if doMove is successful:
  • The canvas must be told about the new state
  • The canvas must be repainted
• Similar actions must be taken upon problem reset

Suppose they are BridgeCanvas and WaterJugCanvas, respectively.

• Constructor should accept the appropriate initial state and pass if off to the Canvas constructor using super
• Constructor should create and store any drawing objects that are needed by paintComponent
• paintComponent should draw the objects required to depict the problem's current state

• When using the setColor method (from java.awt.Graphics), you can create arbitrary colors using the Color constructor (from java.awt) taking three integers representing red, green, and blue values
• Here is a useful resource for finding suitable red, green, and blue values: RGB Color Chart
• To accurately position text on your canvas, see the special topic on page 163 of the text
• Use the GeneralPath class (from java.awt.geom) to draw arbitrary shapes:
  • Create a path using new GeneralPath()
  • Determine a point (x₀,y₀) that is the start of the drawing
  • Move to the start using path.moveTo(x₀,y₀)
  • Determine the remaining points on your drawing (x₁,y₁), . . . (x_n,y_n).
  • Draw a line to (x₁,y₁) using path.lineTo(x₁,y₁)
  • . . .
  • Draw a line to (x_n,y_n) using path.lineTo(x_n,y_n)
  • Complete the drawing back to (x₀,y₀) using path.closePath()
• The above procedure draws a closed figure with straight edges. To incorporate curves, replace calls to lineTo with calls to quadTo
• A useful tutorial: Working With Java 2D Graphics

Or, you can test your GUI with graphics included.

    public static void main(String[] args) {
        JFrame frame = new JFrame("BridgeCanvas Test");
        frame.add(new BridgeCanvas(new BridgeState(Position.WEST,
                                                   Position.WEST,
                                                   Position.WEST,
                                                   Position.WEST,
                                                   Position.WEST,
                                                   0)));
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.pack();
        frame.setVisible(true);
    }

Now run the BridgeCanvas.java file to observe the rendering of the state.

Change the states given to the BridgeCanvas constructor to observe different states.

Follow the same procedure with your WaterJugCanvas class.

• BridgeGui (in the bridge package)
• WaterJugGui (in the waterjug package)
• TestFrame (in the framework.test package)

Once that's done, you can run these files and they should behave as before but with the graphical rendering of states.

See the animation example on pp. 164—169 of the text for details on how a timer is used to produce animation.

The rest of this section treats issues specific to this assignment.

• The successive redrawing of the shape(s) cannot be done from within the Canvas object's paintComponent method itself
• So management of the timer must be done by some other method, call it for example render, that will have to be added to the abstract Canvas class, and which will have to be overridden by any class that wants to do animation
• The GUI's move button listeners will have to call render rather than repaint
• Classes that don't perform animation can simply have their render methods call repaint

Suppose you are animating the filling of a water jug.

• By initDrawCriteria is meant the initializing of the height of the rectangle representing a water jug.
• By updateDrawCriteria is meant the incremental change needed to the height of the rectangle in order to carry out the animation.
• Due to the way a timer works, the firing of the actionPerformed method and updateDrawCriteria actions are executed in a loop.
• It is up to the timer listener to determine if the animation is finished and to either stop the timer or repaint the canvas accordingly.

• To double-check that everything is in order, click Build on the menu bar and select Clean and Build Main Project.
• Run the bridge.BridgeGUI and waterjug.WaterJugGUI classes to make sure everything works.
• Run the framework.test.TestFrame class to be doubly sure.

Email the zip file to your TA.

• Correctness, appearance and creativity of static graphical renderings: 20 points
• Successful incorporation of animation: 10 points