001 /* ===========================================================
002 * JFreeChart : a free chart library for the Java(tm) platform
003 * ===========================================================
004 *
005 * (C) Copyright 2000-2006, by Object Refinery Limited and Contributors.
006 *
007 * Project Info: http://www.jfree.org/jfreechart/index.html
008 *
009 * This library is free software; you can redistribute it and/or modify it
010 * under the terms of the GNU Lesser General Public License as published by
011 * the Free Software Foundation; either version 2.1 of the License, or
012 * (at your option) any later version.
013 *
014 * This library is distributed in the hope that it will be useful, but
015 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
016 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
017 * License for more details.
018 *
019 * You should have received a copy of the GNU Lesser General Public
020 * License along with this library; if not, write to the Free Software
021 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
022 * USA.
023 *
024 * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
025 * in the United States and other countries.]
026 *
027 * ----------------
028 * ArrowNeedle.java
029 * ----------------
030 * (C) Copyright 2002-2006, by the Australian Antarctic Division and
031 * Contributors.
032 *
033 * Original Author: Bryan Scott (for the Australian Antarctic Division);
034 * Contributor(s): David Gilbert (for Object Refinery Limited);
035 *
036 * $Id: ArrowNeedle.java,v 1.3.2.3 2006/08/02 10:40:57 mungady Exp $
037 *
038 * Changes:
039 * --------
040 * 25-Sep-2002 : Version 1, contributed by Bryan Scott (DG);
041 * 27-Mar-2003 : Implemented Serializable (DG);
042 * 09-Sep-2003 : Added equals() method (DG);
043 * 08-Jun-2005 : Implemented Cloneable (DG);
044 */
045
046 package org.jfree.chart.needle;
047
048 import java.awt.Graphics2D;
049 import java.awt.Shape;
050 import java.awt.geom.GeneralPath;
051 import java.awt.geom.Line2D;
052 import java.awt.geom.Point2D;
053 import java.awt.geom.Rectangle2D;
054 import java.io.Serializable;
055
056 /**
057 * A needle in the shape of an arrow.
058 */
059 public class ArrowNeedle extends MeterNeedle
060 implements Cloneable, Serializable {
061
062 /** For serialization. */
063 private static final long serialVersionUID = -5334056511213782357L;
064
065 /**
066 * A flag controlling whether or not there is an arrow at the top of the
067 * needle.
068 */
069 private boolean isArrowAtTop = true;
070
071 /**
072 * Constructs a new arrow needle.
073 *
074 * @param isArrowAtTop a flag that controls whether or not there is an
075 * arrow at the top of the needle.
076 */
077 public ArrowNeedle(boolean isArrowAtTop) {
078 this.isArrowAtTop = isArrowAtTop;
079 }
080
081 /**
082 * Draws the needle.
083 *
084 * @param g2 the graphics device.
085 * @param plotArea the plot area.
086 * @param rotate the rotation point.
087 * @param angle the angle.
088 */
089 protected void drawNeedle(Graphics2D g2, Rectangle2D plotArea,
090 Point2D rotate, double angle) {
091
092 Line2D shape = new Line2D.Float();
093 Shape d = null;
094
095 float x = (float) (plotArea.getMinX() + (plotArea.getWidth() / 2));
096 float minY = (float) plotArea.getMinY();
097 float maxY = (float) plotArea.getMaxY();
098 shape.setLine(x, minY, x, maxY);
099
100 GeneralPath shape1 = new GeneralPath();
101 if (this.isArrowAtTop) {
102 shape1.moveTo(x, minY);
103 minY += 4 * getSize();
104 }
105 else {
106 shape1.moveTo(x, maxY);
107 minY = maxY - 4 * getSize();
108 }
109 shape1.lineTo(x + getSize(), minY);
110 shape1.lineTo(x - getSize(), minY);
111 shape1.closePath();
112
113 if ((rotate != null) && (angle != 0)) {
114 getTransform().setToRotation(angle, rotate.getX(), rotate.getY());
115 d = getTransform().createTransformedShape(shape);
116 }
117 else {
118 d = shape;
119 }
120 defaultDisplay(g2, d);
121
122 if ((rotate != null) && (angle != 0)) {
123 d = getTransform().createTransformedShape(shape1);
124 }
125 else {
126 d = shape1;
127 }
128 defaultDisplay(g2, d);
129
130 }
131
132 /**
133 * Tests another object for equality with this object.
134 *
135 * @param obj the object to test (<code>null</code> permitted).
136 *
137 * @return A boolean.
138 */
139 public boolean equals(Object obj) {
140 if (obj == this) {
141 return true;
142 }
143 if (!(obj instanceof ArrowNeedle)) {
144 return false;
145 }
146 if (!super.equals(obj)) {
147 return false;
148 }
149 ArrowNeedle that = (ArrowNeedle) obj;
150 if (this.isArrowAtTop != that.isArrowAtTop) {
151 return false;
152 }
153 return true;
154 }
155
156 /**
157 * Returns a clone of this needle.
158 *
159 * @return A clone.
160 *
161 * @throws CloneNotSupportedException if the <code>ArrowNeedle</code>
162 * cannot be cloned (in theory, this should not happen).
163 */
164 public Object clone() throws CloneNotSupportedException {
165 return super.clone();
166 }
167
168 }