org.jfree.chart.plot.dial.StandardDialRange Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jfreechart Show documentation
Show all versions of jfreechart Show documentation
JFreeChart is a class library, written in Java, for generating charts.
Utilising the Java2D APIs, it currently supports bar charts, pie charts,
line charts, XY-plots and time series plots.
/* ===========================================================
* JFreeChart : a free chart library for the Java(tm) platform
* ===========================================================
*
* (C) Copyright 2000-2013, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jfreechart/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Oracle and Java are registered trademarks of Oracle and/or its affiliates.
* Other names may be trademarks of their respective owners.]
*
* ----------------------
* StandardDialRange.java
* ----------------------
* (C) Copyright 2006-2013, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): -;
*
* Changes
* -------
* 03-Nov-2006 : Version 1 (DG);
* 08-Mar-2007 : Fix in hashCode() (DG);
* 17-Oct-2007 : Removed increment attribute (DG);
* 24-Oct-2007 : Added scaleIndex (DG);
* 03-Jul-2013 : Use ParamChecks (DG);
*
*/
package org.jfree.chart.plot.dial;
import java.awt.BasicStroke;
import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.Paint;
import java.awt.geom.Arc2D;
import java.awt.geom.Rectangle2D;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import org.jfree.chart.HashUtilities;
import org.jfree.chart.util.ParamChecks;
import org.jfree.io.SerialUtilities;
import org.jfree.util.PaintUtilities;
import org.jfree.util.PublicCloneable;
/**
* A layer that draws a range highlight on a dial plot.
*
* @since 1.0.7
*/
public class StandardDialRange extends AbstractDialLayer implements DialLayer,
Cloneable, PublicCloneable, Serializable {
/** For serialization. */
static final long serialVersionUID = 345515648249364904L;
/** The scale index. */
private int scaleIndex;
/** The minimum data value for the scale. */
private double lowerBound;
/** The maximum data value for the scale. */
private double upperBound;
/**
* The paint used to draw the range highlight. This field is transient
* because it requires special handling for serialization.
*/
private transient Paint paint;
/**
* The factor (in the range 0.0 to 1.0) that determines the inside limit
* of the range highlight.
*/
private double innerRadius;
/**
* The factor (in the range 0.0 to 1.0) that determines the outside limit
* of the range highlight.
*/
private double outerRadius;
/**
* Creates a new instance of StandardDialRange.
*/
public StandardDialRange() {
this(0.0, 100.0, Color.white);
}
/**
* Creates a new instance of StandardDialRange.
*
* @param lower the lower bound.
* @param upper the upper bound.
* @param paint the paint (null not permitted).
*/
public StandardDialRange(double lower, double upper, Paint paint) {
ParamChecks.nullNotPermitted(paint, "paint");
this.scaleIndex = 0;
this.lowerBound = lower;
this.upperBound = upper;
this.innerRadius = 0.48;
this.outerRadius = 0.52;
this.paint = paint;
}
/**
* Returns the scale index.
*
* @return The scale index.
*
* @see #setScaleIndex(int)
*/
public int getScaleIndex() {
return this.scaleIndex;
}
/**
* Sets the scale index and sends a {@link DialLayerChangeEvent} to all
* registered listeners.
*
* @param index the scale index.
*
* @see #getScaleIndex()
*/
public void setScaleIndex(int index) {
this.scaleIndex = index;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns the lower bound (a data value) of the dial range.
*
* @return The lower bound of the dial range.
*
* @see #setLowerBound(double)
*/
public double getLowerBound() {
return this.lowerBound;
}
/**
* Sets the lower bound of the dial range and sends a
* {@link DialLayerChangeEvent} to all registered listeners.
*
* @param bound the lower bound.
*
* @see #getLowerBound()
*/
public void setLowerBound(double bound) {
if (bound >= this.upperBound) {
throw new IllegalArgumentException(
"Lower bound must be less than upper bound.");
}
this.lowerBound = bound;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns the upper bound of the dial range.
*
* @return The upper bound.
*
* @see #setUpperBound(double)
*/
public double getUpperBound() {
return this.upperBound;
}
/**
* Sets the upper bound of the dial range and sends a
* {@link DialLayerChangeEvent} to all registered listeners.
*
* @param bound the upper bound.
*
* @see #getUpperBound()
*/
public void setUpperBound(double bound) {
if (bound <= this.lowerBound) {
throw new IllegalArgumentException(
"Lower bound must be less than upper bound.");
}
this.upperBound = bound;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Sets the bounds for the range and sends a {@link DialLayerChangeEvent}
* to all registered listeners.
*
* @param lower the lower bound.
* @param upper the upper bound.
*/
public void setBounds(double lower, double upper) {
if (lower >= upper) {
throw new IllegalArgumentException(
"Lower must be less than upper.");
}
this.lowerBound = lower;
this.upperBound = upper;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns the paint used to highlight the range.
*
* @return The paint (never null).
*
* @see #setPaint(Paint)
*/
public Paint getPaint() {
return this.paint;
}
/**
* Sets the paint used to highlight the range and sends a
* {@link DialLayerChangeEvent} to all registered listeners.
*
* @param paint the paint (null not permitted).
*
* @see #getPaint()
*/
public void setPaint(Paint paint) {
ParamChecks.nullNotPermitted(paint, "paint");
this.paint = paint;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns the inner radius.
*
* @return The inner radius.
*
* @see #setInnerRadius(double)
*/
public double getInnerRadius() {
return this.innerRadius;
}
/**
* Sets the inner radius and sends a {@link DialLayerChangeEvent} to all
* registered listeners.
*
* @param radius the radius.
*
* @see #getInnerRadius()
*/
public void setInnerRadius(double radius) {
this.innerRadius = radius;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns the outer radius.
*
* @return The outer radius.
*
* @see #setOuterRadius(double)
*/
public double getOuterRadius() {
return this.outerRadius;
}
/**
* Sets the outer radius and sends a {@link DialLayerChangeEvent} to all
* registered listeners.
*
* @param radius the radius.
*
* @see #getOuterRadius()
*/
public void setOuterRadius(double radius) {
this.outerRadius = radius;
notifyListeners(new DialLayerChangeEvent(this));
}
/**
* Returns true to indicate that this layer should be
* clipped within the dial window.
*
* @return true.
*/
@Override
public boolean isClippedToWindow() {
return true;
}
/**
* Draws the range.
*
* @param g2 the graphics target.
* @param plot the plot.
* @param frame the dial's reference frame (in Java2D space).
* @param view the dial's view rectangle (in Java2D space).
*/
@Override
public void draw(Graphics2D g2, DialPlot plot, Rectangle2D frame,
Rectangle2D view) {
Rectangle2D arcRectInner = DialPlot.rectangleByRadius(frame,
this.innerRadius, this.innerRadius);
Rectangle2D arcRectOuter = DialPlot.rectangleByRadius(frame,
this.outerRadius, this.outerRadius);
DialScale scale = plot.getScale(this.scaleIndex);
if (scale == null) {
throw new RuntimeException("No scale for scaleIndex = "
+ this.scaleIndex);
}
double angleMin = scale.valueToAngle(this.lowerBound);
double angleMax = scale.valueToAngle(this.upperBound);
Arc2D arcInner = new Arc2D.Double(arcRectInner, angleMin,
angleMax - angleMin, Arc2D.OPEN);
Arc2D arcOuter = new Arc2D.Double(arcRectOuter, angleMax,
angleMin - angleMax, Arc2D.OPEN);
g2.setPaint(this.paint);
g2.setStroke(new BasicStroke(2.0f));
g2.draw(arcInner);
g2.draw(arcOuter);
}
/**
* Tests this instance for equality with an arbitrary object.
*
* @param obj the object (null permitted).
*
* @return A boolean.
*/
@Override
public boolean equals(Object obj) {
if (obj == this) {
return true;
}
if (!(obj instanceof StandardDialRange)) {
return false;
}
StandardDialRange that = (StandardDialRange) obj;
if (this.scaleIndex != that.scaleIndex) {
return false;
}
if (this.lowerBound != that.lowerBound) {
return false;
}
if (this.upperBound != that.upperBound) {
return false;
}
if (!PaintUtilities.equal(this.paint, that.paint)) {
return false;
}
if (this.innerRadius != that.innerRadius) {
return false;
}
if (this.outerRadius != that.outerRadius) {
return false;
}
return super.equals(obj);
}
/**
* Returns a hash code for this instance.
*
* @return The hash code.
*/
@Override
public int hashCode() {
int result = 193;
long temp = Double.doubleToLongBits(this.lowerBound);
result = 37 * result + (int) (temp ^ (temp >>> 32));
temp = Double.doubleToLongBits(this.upperBound);
result = 37 * result + (int) (temp ^ (temp >>> 32));
temp = Double.doubleToLongBits(this.innerRadius);
result = 37 * result + (int) (temp ^ (temp >>> 32));
temp = Double.doubleToLongBits(this.outerRadius);
result = 37 * result + (int) (temp ^ (temp >>> 32));
result = 37 * result + HashUtilities.hashCodeForPaint(this.paint);
return result;
}
/**
* Returns a clone of this instance.
*
* @return A clone.
*
* @throws CloneNotSupportedException if any of the attributes of this
* instance cannot be cloned.
*/
@Override
public Object clone() throws CloneNotSupportedException {
return super.clone();
}
/**
* Provides serialization support.
*
* @param stream the output stream.
*
* @throws IOException if there is an I/O error.
*/
private void writeObject(ObjectOutputStream stream) throws IOException {
stream.defaultWriteObject();
SerialUtilities.writePaint(this.paint, stream);
}
/**
* Provides serialization support.
*
* @param stream the input stream.
*
* @throws IOException if there is an I/O error.
* @throws ClassNotFoundException if there is a classpath problem.
*/
private void readObject(ObjectInputStream stream)
throws IOException, ClassNotFoundException {
stream.defaultReadObject();
this.paint = SerialUtilities.readPaint(stream);
}
}