fiore@0: /*  
fiore@0:  CCmI Editor - A Collaborative Cross-Modal Diagram Editing Tool
fiore@0:   
fiore@0:  Copyright (C) 2011  Queen Mary University of London (http://ccmi.eecs.qmul.ac.uk/)
fiore@0: 
fiore@0:  This program is free software: you can redistribute it and/or modify
fiore@0:  it under the terms of the GNU General Public License as published by
fiore@0:  the Free Software Foundation, either version 3 of the License, or
fiore@0:  (at your option) any later version.
fiore@0: 
fiore@0:  This program is distributed in the hope that it will be useful,
fiore@0:  but WITHOUT ANY WARRANTY; without even the implied warranty of
fiore@0:  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
fiore@0:  GNU General Public License for more details.
fiore@0: 
fiore@0:  You should have received a copy of the GNU General Public License
fiore@0:  along with this program.  If not, see <http://www.gnu.org/licenses/>.
fiore@0: */
fiore@0: package uk.ac.qmul.eecs.ccmi.gui;
fiore@0: 
fiore@0: import java.awt.Graphics2D;
fiore@0: import java.awt.geom.Point2D;
fiore@0: import java.awt.geom.Rectangle2D;
fiore@0: 
fiore@0: 
fiore@0: /**
fiore@3:  * An interface implemented by {@code Node}, {@code Edge} and {@code Edge.InnerPoint}. It defines methods that 
fiore@3:  * all objects painted on a graph share. The interface is used mainly
fiore@3:  * for convenience in treating the different types of object in a uniformly.  
fiore@0:  *
fiore@0:  */
fiore@0: public interface GraphElement {
fiore@3: 	/**
fiore@3: 	 * Draw the graphic element on a canvas
fiore@3: 	 * 
fiore@3: 	 * @param g2 the graphics object. Use {@code g2.draw()} to get things painted on the graph. 
fiore@3: 	 */
fiore@0: 	public void draw(Graphics2D g2);
fiore@0: 
fiore@3: 	/**
fiore@3: 	 * Translates this graphic element on the graph 
fiore@3: 	 * 
fiore@3: 	 * @param p the starting point where the translation starts (normally where the user clicks
fiore@3: 	 * with their mouse)
fiore@3: 	 * @param dx the distance to translate along the x-axis
fiore@3: 	 * @param dy the distance to translate along the y-axis
fiore@3: 	 * @param source the source of the translate action
fiore@3: 	 */
fiore@3: 	public void translate(Point2D p, double dx, double dy, Object source);
fiore@0: 
fiore@3: 	/**
fiore@3: 	 * This method is to be called before translation or any other operation that changes the 
fiore@3: 	 * position of the graph element or any of its parts. 
fiore@3: 	 * 
fiore@3: 	 * @param p the starting point of the motion 
fiore@3: 	 * @param source the source of the motion action
fiore@3: 	 */
fiore@3: 	public void startMove(Point2D p, Object source);
fiore@3: 
fiore@3: 	/**
fiore@3: 	 * This method is to be called when the motion (e.g. a translation) is over. 
fiore@3: 	 * Note that for instance a translation might be composed on several calls to {@code translate}
fiore@3: 	 * 
fiore@5: 	 * @param source the source of the motion action
fiore@3: 	 */
fiore@3: 	public void stopMove(Object source);
fiore@0: 	
fiore@3: 	/**
fiore@3: 	 * Gets the bounding {@code Rectangle} of this graph element.
fiore@3: 	 * 
fiore@3: 	 * @return a new {@code Rectangle} equals to the bounding {@code Rectangle} of this graph element
fiore@3: 	 */
fiore@0: 	public Rectangle2D getBounds();
fiore@0: 	
fiore@3: 	/**
fiore@3: 	 * Returns the point where an line, with a specified direction, would come in contact with the outline of this 
fiore@3: 	 * graph element. 
fiore@3: 	 * 
fiore@3: 	 * @param d the direction of the line 
fiore@3: 	 * @return a new point on the outline if this graph element where the line comes in contact with it
fiore@3:  	 */
fiore@0: 	public Point2D getConnectionPoint(Direction d);
fiore@0: 	
fiore@3: 	/**
fiore@3: 	 * Tests if a specified {@code Point2D} is inside the boundary of this graph element.
fiore@3: 	 * 
fiore@3: 	 * @param p the point to be tested
fiore@3: 	 * @return {@code true} if the point is inside the boundary, {@code false} otherwise
fiore@3: 	 */
fiore@0: 	public boolean contains(Point2D p);
fiore@0: 	
fiore@0: }