Newer
Older
piccolo2d.java / examples / src / main / java / edu / umd / cs / piccolo / examples / BirdsEyeViewExample.java
@Marcus Rohrmoser Marcus Rohrmoser on 22 Jul 2008 11 KB issue#6
package edu.umd.cs.piccolo.examples;

import java.awt.BasicStroke;
import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.geom.Ellipse2D;
import java.awt.geom.Line2D;
import java.awt.geom.Rectangle2D;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;

import javax.swing.JDialog;

import edu.umd.cs.piccolo.PCanvas;
import edu.umd.cs.piccolo.PLayer;
import edu.umd.cs.piccolo.PNode;
import edu.umd.cs.piccolo.event.PBasicInputEventHandler;
import edu.umd.cs.piccolo.event.PDragEventHandler;
import edu.umd.cs.piccolo.event.PDragSequenceEventHandler;
import edu.umd.cs.piccolo.event.PInputEvent;
import edu.umd.cs.piccolo.nodes.PImage;
import edu.umd.cs.piccolo.nodes.PPath;
import edu.umd.cs.piccolo.nodes.PText;
import edu.umd.cs.piccolo.util.PBounds;
import edu.umd.cs.piccolo.util.PDimension;
import edu.umd.cs.piccolo.util.PPaintContext;
import edu.umd.cs.piccolox.PFrame;
import edu.umd.cs.piccolox.nodes.P3DRect;

/**
 * This example, contributed by Rowan Christmas, shows how to
 * create a birds-eye view window.
 */
public class BirdsEyeViewExample extends PFrame {

	boolean fIsPressed = false;

	public BirdsEyeViewExample() {
		this(null);
	}

	public BirdsEyeViewExample(PCanvas aCanvas) {
		super("BirdsEyeViewExample", false, aCanvas);
	}

	public void initialize() {

		nodeDemo();
		createNodeUsingExistingClasses();
		subclassExistingClasses();
		composeOtherNodes();
		createCustomNode();

		// Last of all lets remove the default pan event handler, and add a
		// drag event handler instead. This way you will be able to drag the
		// nodes around with the mouse.
		getCanvas().removeInputEventListener(getCanvas().getPanEventHandler());
		getCanvas().addInputEventListener(new PDragEventHandler());

		// this will create the actual BirdsEyeView and put it in a JDialog
		BirdsEyeView bev = new BirdsEyeView();
		bev.connect(getCanvas(), new PLayer[]{getCanvas().getLayer()});
		JDialog bird = new JDialog();
		bird.getContentPane().add(bev);
		bird.pack();
		bird.setSize(150, 150);
		bird.setVisible(true);

	}

	// This method demonstrates the kinds of things that can be done with any
	// node.
	public void nodeDemo() {
		PLayer layer = getCanvas().getLayer();
		PNode aNode = PPath.createRectangle(0, 0, 100, 80);

		// A node needs to be a descendent of the root to be displayed on the
		// screen.
		layer.addChild(aNode);

		// The default color for a node is blue, but you can change that with
		// the setPaint method.
		aNode.setPaint(Color.red);

		// A node can have children nodes added to it.
		aNode.addChild(PPath.createRectangle(0, 0, 100, 80));

		// The base bounds of a node is easy to change. Note that changing the
		// base
		// bounds of a node will not change it's children.
		aNode.setBounds(-10, -10, 200, 110);

		// Each node has a transform that can be used to transform the node, and
		// all its children on the screen.
		aNode.translate(100, 100);
		aNode.scale(1.5);
		aNode.rotate(45);

		// The transparency of any node can be set, this transparency will be
		// applied to any of the nodes children as well.
		aNode.setTransparency(0.75f);

		// Its easy to copy nodes.
		PNode aCopy = (PNode) aNode.clone();

		// Make is so that the copies children are not pickable. For this
		// example
		// that means you will not be able to grab the child and remove it from
		// its parent.
		aNode.setChildrenPickable(false);

		// Change the look of the copy
		aNode.setPaint(Color.GREEN);
		aNode.setTransparency(1.0f);

		// Let's add the copy to the root, and translate it so that it does not
		// cover the original node.
		layer.addChild(aCopy);
		aCopy.setOffset(0, 0);
		aCopy.rotate(-45);
	}

	// So far we have just been using PNode, but of course PNode has many
	// subclasses that you can try out to.
	public void createNodeUsingExistingClasses() {
		PLayer layer = getCanvas().getLayer();
		layer.addChild(PPath.createEllipse(0, 0, 100, 100));
		layer.addChild(PPath.createRectangle(0, 100, 100, 100));
		layer.addChild(new PText("Hello World"));

		// Here we create an image node that displays a thumbnail
		// image of the root node. Note that you can easily get a thumbnail
		// of any node by using PNode.toImage().
		layer.addChild(new PImage(layer.toImage(300, 300, Color.YELLOW)));
	}

	// Another way to create nodes is to customize other nodes that already
	// exist. Here we create an ellipse, except when you press the mouse on
	// this ellipse it turns into a square, when you release the mouse it
	// goes back to being an ellipse.
	public void subclassExistingClasses() {
		final PNode n = new PPath(new Ellipse2D.Float(0, 0, 100, 80)) {

			public void paint(PPaintContext aPaintContext) {
				if (fIsPressed) {
					// if mouse is pressed draw self as a square.
					Graphics2D g2 = aPaintContext.getGraphics();
					g2.setPaint(getPaint());
					g2.fill(getBoundsReference());
				} else {
					// if mouse is not pressed draw self normally.
					super.paint(aPaintContext);
				}
			}
		};

		n.addInputEventListener(new PBasicInputEventHandler() {
			public void mousePressed(PInputEvent aEvent) {
				super.mousePressed(aEvent);
				fIsPressed = true;
				n.invalidatePaint(); // this tells the framework that the node
				// needs to be redisplayed.
			}

			public void mouseReleased(PInputEvent aEvent) {
				super.mousePressed(aEvent);
				fIsPressed = false;
				n.invalidatePaint(); // this tells the framework that the node
				// needs to be redisplayed.
			}
		});

		n.setPaint(Color.ORANGE);
		getCanvas().getLayer().addChild(n);
	}

	// Here a new "face" node is created. But instead of drawing the face
	// directly
	// using Graphics2D we compose the face from other nodes.
	public void composeOtherNodes() {
		PNode myCompositeFace = PPath.createRectangle(0, 0, 100, 80);

		// create parts for the face.
		PNode eye1 = PPath.createEllipse(0, 0, 20, 20);
		eye1.setPaint(Color.YELLOW);
		PNode eye2 = (PNode) eye1.clone();
		PNode mouth = PPath.createRectangle(0, 0, 40, 20);
		mouth.setPaint(Color.BLACK);

		// add the face parts
		myCompositeFace.addChild(eye1);
		myCompositeFace.addChild(eye2);
		myCompositeFace.addChild(mouth);

		// don't want anyone grabbing out our eye's.
		myCompositeFace.setChildrenPickable(false);

		// position the face parts.
		eye2.translate(25, 0);
		mouth.translate(0, 30);

		// set the face bounds so that it neatly contains the face parts.
		PBounds b = myCompositeFace.getUnionOfChildrenBounds(null);
		myCompositeFace.setBounds(b.inset(-5, -5));

		// opps it to small, so scale it up.
		myCompositeFace.scale(1.5);

		getCanvas().getLayer().addChild(myCompositeFace);
	}

	// Here a completely new kind of node, a grid node" is created. We do
	// all the drawing ourselves here instead of passing the work off to
	// other parts of the framework.
	public void createCustomNode() {
		PNode n = new PNode() {
			public void paint(PPaintContext aPaintContext) {
				double bx = getX();
				double by = getY();
				double rightBorder = bx + getWidth();
				double bottomBorder = by + getHeight();

				Line2D line = new Line2D.Double();
				Graphics2D g2 = aPaintContext.getGraphics();

				g2.setStroke(new BasicStroke(0));
				g2.setPaint(getPaint());

				// draw vertical lines
				for (double x = bx; x < rightBorder; x += 5) {
					line.setLine(x, by, x, bottomBorder);
					g2.draw(line);
				}

				for (double y = by; y < bottomBorder; y += 5) {
					line.setLine(bx, y, rightBorder, y);
					g2.draw(line);
				}
			}
		};
		n.setBounds(0, 0, 100, 80);
		n.setPaint(Color.black);
		getCanvas().getLayer().addChild(n);
	}

	public static void main(String[] args) {
		new BirdsEyeViewExample();
	}

	/**
	 * The Birds Eye View Class
	 */
	public class BirdsEyeView extends PCanvas implements PropertyChangeListener {

		/**
		 * This is the node that shows the viewed area.
		 */
		PNode areaVisiblePNode;

		/**
		 * This is the canvas that is being viewed
		 */
		PCanvas viewedCanvas;

		/**
		 * The change listener to know when to update the birds eye view.
		 */
		PropertyChangeListener changeListener;

		int layerCount;

		/**
		 * Creates a new instance of a BirdsEyeView
		 */
		public BirdsEyeView() {

			// create the PropertyChangeListener for listening to the viewed
			// canvas
			changeListener = new PropertyChangeListener() {
				public void propertyChange(PropertyChangeEvent evt) {
					updateFromViewed();
				}
			};

			// create the coverage node
			areaVisiblePNode = new P3DRect();
			areaVisiblePNode.setPaint(new Color(128, 128, 255));
			areaVisiblePNode.setTransparency(.8f);
			areaVisiblePNode.setBounds(0, 0, 100, 100);
			getCamera().addChild(areaVisiblePNode);

			// add the drag event handler
			getCamera().addInputEventListener(new PDragSequenceEventHandler() {
				protected void startDrag(PInputEvent e) {
					if (e.getPickedNode() == areaVisiblePNode)
						super.startDrag(e);
				}

				protected void drag(PInputEvent e) {
					PDimension dim = e.getDelta();
					viewedCanvas.getCamera().translateView(0 - dim.getWidth(),
							0 - dim.getHeight());
				}

			});

			// remove Pan and Zoom
			removeInputEventListener(getPanEventHandler());
			removeInputEventListener(getZoomEventHandler());

			setDefaultRenderQuality(PPaintContext.LOW_QUALITY_RENDERING);

		}

		public void connect(PCanvas canvas, PLayer[] viewed_layers) {

			this.viewedCanvas = canvas;
			layerCount = 0;

			viewedCanvas.getCamera().addPropertyChangeListener(changeListener);

			for (layerCount = 0; layerCount < viewed_layers.length; ++layerCount) {
				getCamera().addLayer(layerCount, viewed_layers[layerCount]);
			}

		}

		/**
		 * Add a layer to list of viewed layers
		 */
		public void addLayer(PLayer new_layer) {
			getCamera().addLayer(new_layer);
			layerCount++;
		}

		/**
		 * Remove the layer from the viewed layers
		 */
		public void removeLayer(PLayer old_layer) {
			getCamera().removeLayer(old_layer);
			layerCount--;
		}

		/**
		 * Stop the birds eye view from receiving events from the viewed canvas
		 * and remove all layers
		 */
		public void disconnect() {
			viewedCanvas.getCamera().removePropertyChangeListener(
					changeListener);

			for (int i = 0; i < getCamera().getLayerCount(); ++i) {
				getCamera().removeLayer(i);
			}

		}

		/**
		 * This method will get called when the viewed canvas changes
		 */
		public void propertyChange(PropertyChangeEvent event) {
			updateFromViewed();
		}

		/**
		 * This method gets the state of the viewed canvas and updates the
		 * BirdsEyeViewer This can be called from outside code
		 */
		public void updateFromViewed() {

			double viewedX;
			double viewedY;
			double viewedHeight;
			double viewedWidth;

			double ul_camera_x = viewedCanvas.getCamera().getViewBounds()
					.getX();
			double ul_camera_y = viewedCanvas.getCamera().getViewBounds()
					.getY();
			double lr_camera_x = ul_camera_x
					+ viewedCanvas.getCamera().getViewBounds().getWidth();
			double lr_camera_y = ul_camera_y
					+ viewedCanvas.getCamera().getViewBounds().getHeight();

			Rectangle2D drag_bounds = getCamera().getUnionOfLayerFullBounds();

			double ul_layer_x = drag_bounds.getX();
			double ul_layer_y = drag_bounds.getY();
			double lr_layer_x = drag_bounds.getX() + drag_bounds.getWidth();
			double lr_layer_y = drag_bounds.getY() + drag_bounds.getHeight();

			// find the upper left corner

			// set to the lesser value
			if (ul_camera_x < ul_layer_x)
				viewedX = ul_layer_x;
			else
				viewedX = ul_camera_x;

			// same for y
			if (ul_camera_y < ul_layer_y)
				viewedY = ul_layer_y;
			else
				viewedY = ul_camera_y;

			// find the lower right corner

			// set to the greater value
			if (lr_camera_x < lr_layer_x)
				viewedWidth = lr_camera_x - viewedX;
			else
				viewedWidth = lr_layer_x - viewedX;

			// same for height
			if (lr_camera_y < lr_layer_y)
				viewedHeight = lr_camera_y - viewedY;
			else
				viewedHeight = lr_layer_y - viewedY;

			Rectangle2D bounds = new Rectangle2D.Double(viewedX, viewedY,
					viewedWidth, viewedHeight);
			bounds = getCamera().viewToLocal(bounds);
			areaVisiblePNode.setBounds(bounds);

			// keep the birds eye view centered
			getCamera().animateViewToCenterBounds(drag_bounds, true, 0);

		}

	} // class BirdsEyeView

}