/* ControlPanel class */
package ciips.animation;
import java.awt.*;
import java.applet.*;
import java.io.*;
import java.net.*;
import java.util.*;
/**
* This class extends the java.awt.Panel
class to form
* a panel which holds the buttons that control
* the animation of the algorithm.
*
* In this particular application, it only consists of four image buttons,
* namely, run, stop, step,
and skip
.
*
* @see Panel
*/
public class ControlPanel extends Panel {
private AlgAnimFrame frame;
private Button runButton;
private Button stopButton;
private Button stepButton, skipButton;
private Font font;
/**
* Creates a panel to hold the control buttons of the animation
* tool.
* @param frame The parent window frame that contains this panel
* @param algname The algorithm name parsed from the applet parameter
*/
public ControlPanel(AlgAnimFrame frame, String algname) {
setLayout( new FlowLayout(FlowLayout.LEFT) );
this.frame = frame;
final Font helv10 = frame.helv10;
setBackground(Color.white);
stopButton = new ImageButton("stop", frame.getApplet(), this);
((ImageButton)stopButton).setDisable();
this.add(stopButton);
runButton = new ImageButton("run", frame.getApplet(), this);
this.add(runButton);
stepButton = new ImageButton("step", frame.getApplet(), this);
this.add(stepButton);
skipButton = new ImageButton("skip", frame.getApplet(), this);
this.add(skipButton);
refreshButtons();
} // ControlPanel()
/**
* Perform a repaint()
on each of the image buttons.
*/
public void refreshButtons() {
if (runButton != null)
runButton.repaint();
if (stopButton != null)
stopButton.repaint();
if (stepButton != null)
stepButton.repaint();
if (skipButton != null)
skipButton.repaint();
}
/**
* Action handler for the buttons and choice buttons in the control
* panel.
* @param e Event invoked
* @param arg Object that invokes the event
*/
public boolean action(Event e, Object arg) {
Object target = e.target;
System.out.println("ControlPanel:action - target " + target);
refreshButtons();
if (target == runButton) {
((ImageButton)skipButton).setDisable();
((ImageButton)runButton).setDisable();
frame.setSkip(false);
frame.setText(0, "Running continuously...");
frame.startAlg();
}
else if (target == stopButton) {
frame.setText(0, "Animation stopped");
frame.setStep(false);
if (frame.getAlg().isAlive())
frame.getAlg().stop();
frame.finishAlg();
((ImageButton)skipButton).setEnable();
}
else if (target == stepButton) {
System.out.println("ControlPanel:action - step");
frame.setSkip( false );
((ImageButton)skipButton).setEnable();
frame.setStep( true );
if (!frame.getAlg().isAlive())
frame.startAlg();
// else
//frame.getAlg().resume();
((ImageButton)stepButton).setDisable();
}
else if (target == skipButton) {
frame.setSkip(true);
frame.startAlg();
frame.setText(0, "Skipping to the next phase...");
((ImageButton)skipButton).setDisable();
}
refreshButtons();
return true;
} // action()
/**
* Returns an instance of the run ImageButton
, which is
* cast to java.awt.Button
* @return Run button to initiate the animation of the algorithm.
*/
public Button getRunButton() {
return runButton;
}
/**
* Returns an instance of the stop ImageButton
, which is
* cast to java.awt.Button
* @return Stop button to terminate the execution of algorithm.
*/
public Button getStopButton() {
return stopButton;
}
/**
* Returns an instance of the step ImageButton
, which is
* casted to java.awt.Button
* @return Step button to trace through the execution of the algorithm.
* If the Run
button has already been pressed, the
* execution mode will be switched from RUN
to
* STEP
.
*/
public Button getStepButton() {
return stepButton;
}
/**
* Returns an instance of the skip ImageButton
, which is
* casted to java.awt.Button
* @return Skip button to bypass the animation of the algorithm.
*/
public Button getSkipButton() {
return skipButton;
}
} // class ControlPanel