001 /* =========================================================== 002 * JFreeChart : a free chart library for the Java(tm) platform 003 * =========================================================== 004 * 005 * (C) Copyright 2000-2009, 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 * NumberAxis3D.java 029 * ----------------- 030 * (C) Copyright 2001-2009, by Serge V. Grachov and Contributors. 031 * 032 * Original Author: Serge V. Grachov; 033 * Contributor(s): David Gilbert (for Object Refinery Limited); 034 * Jonathan Nash; 035 * Richard Atkinson; 036 * Tin Luu; 037 * 038 * Changes 039 * ------- 040 * 31-Oct-2001 : Version 1 contributed by Serge V. Grachov (DG); 041 * 23-Nov-2001 : Overhauled auto tick unit code for all axes (DG); 042 * 12-Dec-2001 : Minor change due to grid lines bug fix (DG); 043 * 08-Jan-2002 : Added flag allowing the axis to be 'inverted'. That is, run 044 * from positive to negative. Added default values to 045 * constructors (DG); 046 * 16-Jan-2002 : Added an optional crosshair, based on the implementation by 047 * Jonathan Nash (DG); 048 * 25-Feb-2002 : Updated constructors for new autoRangeStickyZero flag (DG); 049 * 19-Apr-2002 : drawVerticalString() is now drawRotatedString() in 050 * RefineryUtilities (DG); 051 * 25-Jun-2002 : Removed redundant import (DG); 052 * 25-Jul-2002 : Changed order of parameters in ValueAxis constructor (DG); 053 * 06-Aug-2002 : Modified draw method to not draw axis label if label is empty 054 * String (RA); 055 * 05-Sep-2002 : Updated constructor for changes in the Axis class, and changed 056 * draw method to observe tickMarkPaint (DG); 057 * 22-Sep-2002 : Fixed errors reported by Checkstyle (DG); 058 * 08-Nov-2002 : Moved to new package com.jrefinery.chart.axis (DG); 059 * 20-Jan-2003 : Removed unnecessary constructors (DG); 060 * 26-Mar-2003 : Implemented Serializable (DG); 061 * 13-May-2003 : Merged HorizontalNumberAxis3D and VerticalNumberAxis3D (DG); 062 * 21-Aug-2003 : Updated draw() method signature (DG); 063 * 07-Nov-2003 : Modified refreshTicks method signature (DG); 064 * ------------- JFREECHART 1.0.x --------------------------------------------- 065 * 18-Jan-2006 : Fixed bug 1408904 (axis assumes CategoryPlot) (DG): 066 * 16-Apr-2009 : Changed axis line visibility default (DG); 067 * 068 */ 069 070 package org.jfree.chart.axis; 071 072 import java.awt.Graphics2D; 073 import java.awt.geom.Rectangle2D; 074 import java.io.Serializable; 075 import java.util.List; 076 077 import org.jfree.chart.Effect3D; 078 import org.jfree.chart.plot.CategoryPlot; 079 import org.jfree.chart.plot.Plot; 080 import org.jfree.chart.plot.PlotRenderingInfo; 081 import org.jfree.chart.renderer.category.CategoryItemRenderer; 082 import org.jfree.ui.RectangleEdge; 083 084 /** 085 * A standard linear value axis with a 3D effect corresponding to the 086 * offset specified by some renderers. 087 */ 088 public class NumberAxis3D extends NumberAxis implements Serializable { 089 090 /** For serialization. */ 091 private static final long serialVersionUID = -1790205852569123512L; 092 093 /** 094 * Default constructor. 095 */ 096 public NumberAxis3D() { 097 this(null); 098 } 099 100 /** 101 * Constructs a new axis. 102 * 103 * @param label the axis label (<code>null</code> permitted). 104 */ 105 public NumberAxis3D(String label) { 106 super(label); 107 } 108 109 /** 110 * Draws the axis on a Java 2D graphics device (such as the screen or a 111 * printer). 112 * 113 * @param g2 the graphics device. 114 * @param cursor the cursor. 115 * @param plotArea the area for drawing the axes and data. 116 * @param dataArea the area for drawing the data (a subset of the 117 * plotArea). 118 * @param edge the axis location. 119 * @param plotState collects information about the plot (<code>null</code> 120 * permitted). 121 * 122 * @return The updated cursor value. 123 */ 124 public AxisState draw(Graphics2D g2, double cursor, Rectangle2D plotArea, 125 Rectangle2D dataArea, RectangleEdge edge, 126 PlotRenderingInfo plotState) { 127 128 // if the axis is not visible, don't draw it... 129 if (!isVisible()) { 130 AxisState state = new AxisState(cursor); 131 // even though the axis is not visible, we need ticks for the 132 // gridlines... 133 List ticks = refreshTicks(g2, state, dataArea, edge); 134 state.setTicks(ticks); 135 return state; 136 } 137 138 // calculate the adjusted data area taking into account the 3D effect... 139 double xOffset = 0.0; 140 double yOffset = 0.0; 141 Plot plot = getPlot(); 142 if (plot instanceof CategoryPlot) { 143 CategoryPlot cp = (CategoryPlot) plot; 144 CategoryItemRenderer r = cp.getRenderer(); 145 if (r instanceof Effect3D) { 146 Effect3D e3D = (Effect3D) r; 147 xOffset = e3D.getXOffset(); 148 yOffset = e3D.getYOffset(); 149 } 150 } 151 152 double adjustedX = dataArea.getMinX(); 153 double adjustedY = dataArea.getMinY(); 154 double adjustedW = dataArea.getWidth() - xOffset; 155 double adjustedH = dataArea.getHeight() - yOffset; 156 157 if (edge == RectangleEdge.LEFT || edge == RectangleEdge.BOTTOM) { 158 adjustedY += yOffset; 159 } 160 else if (edge == RectangleEdge.RIGHT || edge == RectangleEdge.TOP) { 161 adjustedX += xOffset; 162 } 163 Rectangle2D adjustedDataArea = new Rectangle2D.Double(adjustedX, 164 adjustedY, adjustedW, adjustedH); 165 166 // draw the tick marks and labels... 167 AxisState info = drawTickMarksAndLabels(g2, cursor, plotArea, 168 adjustedDataArea, edge); 169 170 // draw the axis label... 171 info = drawLabel(getLabel(), g2, plotArea, dataArea, edge, info); 172 173 return info; 174 175 } 176 177 }