/** Drawable - the ancestor of drawing objects
**/
package ciips.animation;

import java.awt.*;

/**
 * Interface for the drawing object to be drawn in the drawing panel.
 * <p>
 * Any graphical objects to be displayed on the <code>DrawingPanel</code>
 * should implement this interface.
 * All the abstract methods of the interface must be defined in the
 * object class defining the graphical object.
 * <p>
 * For example, if <code>Box</code> is a class which implements
 * <code>DrawingObj</code>, i.e. the class declaration of <code>Box</code>
 * starts with the following line: <code><pre>
 *      class Box implements DrawingObj {
 *        ...
 * </pre></code>
 * Then any instance of class <code>Box</code> can be added to the drawing
 * canvas as follows: <code><pre>
 *      Box box = new Box(...);
 *      drawingPanel.addDrawingObj(box);
 *      box.move(x, y);
 *      drawingPanel.redraw();
 * </pre></code>
 * The first line declares an instance of class <code>Box</code> called
 * <code>box</code>. The next line uses the method <code>addDrawingObj</code>
 * to add <code>box</code> into the canvas <code>drawingPanel</code>, which
 * is an instance of the object class <code>DrawingPanel</code>.
 * <p>
 * The <code>move</code> method of the drawing object (which must be
 * specified) is then called to move the corresponding object to position
 * <code>(x, y)</code>. Finally, the <code>redraw()</code> method of
 * <code>DrawingPanel</code> class is called to refresh the panel and
 * delay for the object to be visible.
 * @see DrawingPanel
 * @see DrawingPanel#addDrawingObj
 * @see DrawingPanel#redraw
 */
public abstract class Drawable implements DrawingObj {

		protected int x, y;
		protected boolean highlight, grey;
		protected Color colour;
		protected String label;

		public static final int DEFAULT_START = 20;

		public Drawable() {
			x = y = DEFAULT_START;
			colour = Color.blue;
			}

    public abstract void draw(Graphics g);
	
    /**
     * This method repositions the drawing object to the new location
     * specified by the paramters.
     * @param x The x coordinate of the drawing object's new position.
     * @param y The y coordinate of the drawing object's new position.
     */
    public void move(int x, int y) {
			this.x = x; this.y = y;
			}

    /**
     * Returns the x coordinate of the drawing object's reference point.
     * @return The x coordinate of the drawing object's reference point.
     */
    public int getX() { return x; }

    /**
     * Returns the y coordinate of the drawing object's reference point.
     * @return The y coordinate of the drawing object's reference point.
     */
    public int getY() { return y; }

    /**
     * Set the highlight attribute
     */
		public void setHighlight( boolean on ) { highlight = on; }

    /**
     * Set the grey attribute
     */
		public void setGrey( boolean on ) { grey = on; }

		/**
		 * Return the colour to be used to draw this object
		 * based on it's current status.
		 * Note that highlight takes precedence over grey
		**/
		public Color getCurrentColour() {
			if ( highlight ) { return Color.yellow; }
			if ( grey ) { return Color.gray; }
			return colour;
			}

		/**
		 * Set an object's label
		 *
		**/
		public void setText( String t ) { label = t; }	

} // interface