|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jfree.chart.plot.Plot
org.jfree.chart.plot.XYPlot
A general class for plotting data in the form of (x, y) pairs. This plot can
use data from any class that implements the XYDataset
interface.
XYPlot
makes use of an XYItemRenderer
to draw each point
on the plot. By using different renderers, various chart types can be
produced.
The ChartFactory
class contains static methods for
creating pre-configured charts.
Field Summary | |
static java.awt.Paint |
DEFAULT_CROSSHAIR_PAINT
The default crosshair paint. |
static java.awt.Stroke |
DEFAULT_CROSSHAIR_STROKE
The default crosshair stroke. |
static boolean |
DEFAULT_CROSSHAIR_VISIBLE
The default crosshair visibility. |
static java.awt.Paint |
DEFAULT_GRIDLINE_PAINT
The default grid line paint. |
static java.awt.Stroke |
DEFAULT_GRIDLINE_STROKE
The default grid line stroke. |
protected static java.util.ResourceBundle |
localizationResources
The resourceBundle for the localization. |
Fields inherited from class org.jfree.chart.plot.Plot |
DEFAULT_BACKGROUND_ALPHA, DEFAULT_BACKGROUND_PAINT, DEFAULT_FOREGROUND_ALPHA, DEFAULT_INSETS, DEFAULT_LEGEND_ITEM_BOX, DEFAULT_LEGEND_ITEM_CIRCLE, DEFAULT_OUTLINE_PAINT, DEFAULT_OUTLINE_STROKE, MINIMUM_HEIGHT_TO_DRAW, MINIMUM_WIDTH_TO_DRAW, ZERO |
Constructor Summary | |
XYPlot()
Default constructor. |
|
XYPlot(XYDataset dataset,
ValueAxis domainAxis,
ValueAxis rangeAxis,
XYItemRenderer renderer)
Creates a new plot. |
Method Summary | |
void |
addAnnotation(XYAnnotation annotation)
Adds an annotation to the plot and sends a PlotChangeEvent to all
registered listeners. |
void |
addDomainMarker(int index,
Marker marker,
Layer layer)
Adds a marker for a renderer and sends a PlotChangeEvent to
all registered listeners. |
void |
addDomainMarker(Marker marker)
Adds a marker for the domain axis and sends a PlotChangeEvent
to all registered listeners. |
void |
addDomainMarker(Marker marker,
Layer layer)
Adds a marker for the domain axis in the specified layer and sends a PlotChangeEvent to all registered listeners. |
void |
addRangeMarker(int index,
Marker marker,
Layer layer)
Adds a marker for a renderer and sends a PlotChangeEvent to
all registered listeners. |
void |
addRangeMarker(Marker marker)
Adds a marker for the range axis and sends a PlotChangeEvent to
all registered listeners. |
void |
addRangeMarker(Marker marker,
Layer layer)
Adds a marker for the range axis in the specified layer and sends a PlotChangeEvent to all registered listeners. |
protected AxisSpace |
calculateAxisSpace(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D plotArea)
Calculates the space required for all the axes in the plot. |
protected AxisSpace |
calculateDomainAxisSpace(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D plotArea,
AxisSpace space)
Calculates the space required for the domain axis/axes. |
protected AxisSpace |
calculateRangeAxisSpace(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D plotArea,
AxisSpace space)
Calculates the space required for the range axis/axes. |
void |
clearAnnotations()
Clears all the annotations and sends a PlotChangeEvent to all
registered listeners. |
void |
clearDomainAxes()
Clears the domain axes from the plot and sends a PlotChangeEvent
to all registered listeners. |
void |
clearDomainMarkers()
Clears all the (foreground and background) domain markers and sends a PlotChangeEvent to all registered listeners. |
void |
clearRangeAxes()
Clears the range axes from the plot and sends a PlotChangeEvent
to all registered listeners. |
void |
clearRangeMarkers()
Clears all the range markers and sends a PlotChangeEvent to all
registered listeners. |
void |
clearRangeMarkers(int index)
Clears the (foreground and background) range markers for a particular renderer. |
java.lang.Object |
clone()
Returns a clone of the plot. |
void |
configureDomainAxes()
Configures the domain axes. |
void |
configureRangeAxes()
Configures the range axes. |
void |
datasetChanged(DatasetChangeEvent event)
Receives notification of a change to the plot's dataset. |
void |
draw(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D area,
PlotState parentState,
PlotRenderingInfo state)
Draws the plot on a Java 2D graphics device (such as the screen or a printer). |
void |
draw(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D area,
java.awt.geom.Point2D anchor,
PlotState parentState,
PlotRenderingInfo info)
Draws the plot within the specified area on a graphics device. |
void |
drawAnnotations(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
PlotRenderingInfo info)
Draws the annotations for the plot. |
protected java.util.Map |
drawAxes(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D plotArea,
java.awt.geom.Rectangle2D dataArea,
PlotRenderingInfo plotState)
A utility method for drawing the axes. |
void |
drawBackground(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D area)
Draws the background for the plot. |
protected void |
drawDomainGridlines(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
java.util.List ticks)
Draws the gridlines for the plot, if they are visible. |
protected void |
drawDomainMarkers(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
int index,
Layer layer)
Draws the domain markers (if any) for an axis and layer. |
protected void |
drawDomainMarkers(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
Layer layer)
Draws the domain markers (if any) for the specified layer. |
void |
drawDomainTickBands(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
java.util.List ticks)
Draws the domain tick bands, if any. |
protected void |
drawHorizontalLine(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
double value,
java.awt.Stroke stroke,
java.awt.Paint paint)
Utility method for drawing a horizontal line across the data area of the plot. |
protected void |
drawQuadrants(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D area)
Draws the quadrants. |
protected void |
drawRangeGridlines(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
java.util.List ticks)
Draws the gridlines for the plot's primary range axis, if they are visible. |
protected void |
drawRangeMarkers(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
int index,
Layer layer)
Draws the range markers (if any) for a renderer and layer. |
protected void |
drawRangeMarkers(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
Layer layer)
Draws the range markers (if any) for the specified layer. |
void |
drawRangeTickBands(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
java.util.List ticks)
Draws the range tick bands, if any. |
protected void |
drawVerticalLine(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
double value,
java.awt.Stroke stroke,
java.awt.Paint paint)
Utility method for drawing a vertical line on the data area of the plot. |
protected void |
drawZeroRangeBaseline(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea)
Draws the gridlines for the plot's primary range axis, if they are visible. |
boolean |
equals(java.lang.Object obj)
Tests this plot for equality with another object. |
RectangleInsets |
getAxisOffset()
Returns the axis offset. |
Range |
getDataRange(ValueAxis axis)
Returns the range for the specified axis. |
XYDataset |
getDataset()
Returns the primary dataset for the plot. |
XYDataset |
getDataset(int index)
Returns a dataset. |
int |
getDatasetCount()
Returns the number of datasets. |
DatasetRenderingOrder |
getDatasetRenderingOrder()
Returns the dataset rendering order. |
ValueAxis |
getDomainAxis()
Returns the domain axis for the plot. |
ValueAxis |
getDomainAxis(int index)
Returns a domain axis. |
int |
getDomainAxisCount()
Returns the number of domain axes. |
RectangleEdge |
getDomainAxisEdge()
Returns the edge for the primary domain axis (taking into account the plot's orientation. |
RectangleEdge |
getDomainAxisEdge(int index)
Returns the edge for a domain axis. |
ValueAxis |
getDomainAxisForDataset(int index)
Returns the domain axis for a dataset. |
protected int |
getDomainAxisIndex(ValueAxis axis)
Returns the index of the given domain axis. |
AxisLocation |
getDomainAxisLocation()
Returns the location of the primary domain axis. |
AxisLocation |
getDomainAxisLocation(int index)
Returns the location for a domain axis. |
java.awt.Paint |
getDomainCrosshairPaint()
Returns the domain crosshair color. |
java.awt.Stroke |
getDomainCrosshairStroke()
Returns the Stroke used to draw the crosshair (if visible). |
double |
getDomainCrosshairValue()
Returns the domain crosshair value. |
java.awt.Paint |
getDomainGridlinePaint()
Returns the paint for the grid lines (if any) plotted against the domain axis. |
java.awt.Stroke |
getDomainGridlineStroke()
Returns the stroke for the grid-lines (if any) plotted against the domain axis. |
java.util.Collection |
getDomainMarkers(int index,
Layer layer)
Returns a collection of domain markers for a particular renderer and layer. |
java.util.Collection |
getDomainMarkers(Layer layer)
Returns the list of domain markers (read only) for the specified layer. |
java.awt.Paint |
getDomainTickBandPaint()
Returns the paint used for the domain tick bands. |
AxisSpace |
getFixedDomainAxisSpace()
Returns the fixed domain axis space. |
LegendItemCollection |
getFixedLegendItems()
Returns the fixed legend items, if any. |
AxisSpace |
getFixedRangeAxisSpace()
Returns the fixed range axis space. |
int |
getIndexOf(XYItemRenderer renderer)
Returns the index of the specified renderer, or -1 if the
renderer is not assigned to this plot. |
LegendItemCollection |
getLegendItems()
Returns the legend items for the plot. |
PlotOrientation |
getOrientation()
Returns the orientation of the plot. |
java.lang.String |
getPlotType()
Returns the plot type as a string. |
java.awt.geom.Point2D |
getQuadrantOrigin()
Returns the origin for the quadrants that can be displayed on the plot. |
java.awt.Paint |
getQuadrantPaint(int index)
Returns the paint used for the specified quadrant. |
ValueAxis |
getRangeAxis()
Returns the range axis for the plot. |
ValueAxis |
getRangeAxis(int index)
Returns a range axis. |
int |
getRangeAxisCount()
Returns the number of range axes. |
RectangleEdge |
getRangeAxisEdge()
Returns the edge for the primary range axis. |
RectangleEdge |
getRangeAxisEdge(int index)
Returns the edge for a range axis. |
ValueAxis |
getRangeAxisForDataset(int index)
Returns the range axis for a dataset. |
protected int |
getRangeAxisIndex(ValueAxis axis)
Returns the index of the given range axis. |
AxisLocation |
getRangeAxisLocation()
Returns the location of the primary range axis. |
AxisLocation |
getRangeAxisLocation(int index)
Returns the location for a range axis. |
java.awt.Paint |
getRangeCrosshairPaint()
Returns the range crosshair color. |
java.awt.Stroke |
getRangeCrosshairStroke()
Returns the Stroke used to draw the crosshair (if visible). |
double |
getRangeCrosshairValue()
Returns the range crosshair value. |
java.awt.Paint |
getRangeGridlinePaint()
Returns the paint for the grid lines (if any) plotted against the range axis. |
java.awt.Stroke |
getRangeGridlineStroke()
Returns the stroke for the grid lines (if any) plotted against the range axis. |
java.util.Collection |
getRangeMarkers(int index,
Layer layer)
Returns a collection of range markers for a particular renderer and layer. |
java.util.Collection |
getRangeMarkers(Layer layer)
Returns the list of range markers (read only) for the specified layer. |
java.awt.Paint |
getRangeTickBandPaint()
Returns the paint used for the range tick bands. |
XYItemRenderer |
getRenderer()
Returns the renderer for the primary dataset. |
XYItemRenderer |
getRenderer(int index)
Returns the renderer for a dataset, or null . |
XYItemRenderer |
getRendererForDataset(XYDataset dataset)
Returns the renderer for the specified dataset. |
int |
getSeriesCount()
Returns the number of series in the primary dataset for this plot. |
int |
getWeight()
Returns the weight for this plot when it is used as a subplot within a combined plot. |
java.awt.Paint |
getZeroRangeBaselinePaint()
Returns the paint for the zero baseline (if any) plotted against the range axis. |
java.awt.Stroke |
getZeroRangeBaselineStroke()
Returns the stroke used for the zero baseline against the range axis. |
void |
handleClick(int x,
int y,
PlotRenderingInfo info)
Handles a 'click' on the plot by updating the anchor values... |
int |
indexOf(XYDataset dataset)
Returns the index of the specified dataset, or -1 if the
dataset does not belong to the plot. |
boolean |
isDomainCrosshairLockedOnData()
Returns a flag indicating whether or not the crosshair should "lock-on" to actual data values. |
boolean |
isDomainCrosshairVisible()
Returns a flag indicating whether or not the domain crosshair is visible. |
boolean |
isDomainGridlinesVisible()
Returns true if the domain gridlines are visible, and
false |
boolean |
isDomainZoomable()
Returns true |
boolean |
isRangeCrosshairLockedOnData()
Returns a flag indicating whether or not the crosshair should "lock-on" to actual data values. |
boolean |
isRangeCrosshairVisible()
Returns a flag indicating whether or not the range crosshair is visible. |
boolean |
isRangeGridlinesVisible()
Returns true if the range axis grid is visible, and
false |
boolean |
isRangeZoomable()
Returns true |
boolean |
isZeroRangeBaselineVisible()
Returns a flag that controls whether or not a zero baseline is displayed for the range axis. |
void |
mapDatasetToDomainAxis(int index,
int axisIndex)
Maps a dataset to a particular domain axis. |
void |
mapDatasetToRangeAxis(int index,
int axisIndex)
Maps a dataset to a particular range axis. |
boolean |
removeAnnotation(XYAnnotation annotation)
Removes an annotation from the plot and sends a PlotChangeEvent
to all registered listeners. |
boolean |
render(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
int index,
PlotRenderingInfo info,
CrosshairState crosshairState)
Draws a representation of the data within the dataArea region, using the current renderer. |
void |
rendererChanged(RendererChangeEvent event)
Receives notification of a renderer change event. |
void |
setAxisOffset(RectangleInsets offset)
Sets the axis offsets (gap between the data area and the axes). |
void |
setDataset(int index,
XYDataset dataset)
Sets a dataset for the plot. |
void |
setDataset(XYDataset dataset)
Sets the primary dataset for the plot, replacing the existing dataset if there is one. |
void |
setDatasetRenderingOrder(DatasetRenderingOrder order)
Sets the rendering order and sends a PlotChangeEvent to all
registered listeners. |
void |
setDomainAxis(int index,
ValueAxis axis)
Sets a domain axis and sends a PlotChangeEvent to all
registered listeners. |
void |
setDomainAxis(ValueAxis axis)
Sets the domain axis for the plot and sends a PlotChangeEvent
to all registered listeners. |
void |
setDomainAxisLocation(AxisLocation location)
Sets the location of the domain axis and sends a PlotChangeEvent
to all registered listeners. |
void |
setDomainAxisLocation(AxisLocation location,
boolean notify)
Sets the location of the domain axis and, if requested, sends a PlotChangeEvent to all registered listeners. |
void |
setDomainAxisLocation(int index,
AxisLocation location)
Sets the location for a domain axis and sends a PlotChangeEvent
to all registered listeners. |
void |
setDomainCrosshairLockedOnData(boolean flag)
Sets the flag indicating whether or not the domain crosshair should "lock-on" to actual data values. |
void |
setDomainCrosshairPaint(java.awt.Paint paint)
Sets the Paint used to color the crosshairs (if visible) and notifies registered listeners that the axis has been modified. |
void |
setDomainCrosshairStroke(java.awt.Stroke stroke)
Sets the Stroke used to draw the crosshairs (if visible) and notifies registered listeners that the axis has been modified. |
void |
setDomainCrosshairValue(double value)
Sets the domain crosshair value and sends a PlotChangeEvent to
all registered listeners (provided that the domain crosshair is visible). |
void |
setDomainCrosshairValue(double value,
boolean notify)
Sets the domain crosshair value and, if requested, sends a PlotChangeEvent to all registered listeners (provided that the
domain crosshair is visible). |
void |
setDomainCrosshairVisible(boolean flag)
Sets the flag indicating whether or not the domain crosshair is visible. |
void |
setDomainGridlinePaint(java.awt.Paint paint)
Sets the paint for the grid lines plotted against the domain axis. |
void |
setDomainGridlineStroke(java.awt.Stroke stroke)
Sets the stroke for the grid lines plotted against the domain axis. |
void |
setDomainGridlinesVisible(boolean visible)
Sets the flag that controls whether or not the domain grid-lines are visible. |
void |
setDomainTickBandPaint(java.awt.Paint paint)
Sets the paint for the domain tick bands. |
void |
setFixedDomainAxisSpace(AxisSpace space)
Sets the fixed domain axis space. |
void |
setFixedLegendItems(LegendItemCollection items)
Sets the fixed legend items for the plot. |
void |
setFixedRangeAxisSpace(AxisSpace space)
Sets the fixed range axis space. |
void |
setOrientation(PlotOrientation orientation)
Sets the orientation for the plot. |
void |
setQuadrantOrigin(java.awt.geom.Point2D origin)
Sets the quadrant origin and sends a PlotChangeEvent to all
registered listeners. |
void |
setQuadrantPaint(int index,
java.awt.Paint paint)
Sets the paint used for the specified quadrant and sends a PlotChangeEvent to all registered listeners. |
void |
setRangeAxis(int index,
ValueAxis axis)
Sets a range axis and sends a PlotChangeEvent to all registered
listeners. |
void |
setRangeAxis(ValueAxis axis)
Sets the range axis for the plot and sends a PlotChangeEvent to
all registered listeners. |
void |
setRangeAxisLocation(AxisLocation location)
Sets the location of the primary range axis and sends a PlotChangeEvent to all registered listeners. |
void |
setRangeAxisLocation(AxisLocation location,
boolean notify)
Sets the location of the primary range axis and, if requested, sends a PlotChangeEvent to all registered listeners. |
void |
setRangeAxisLocation(int index,
AxisLocation location)
Sets the location for a range axis and sends a PlotChangeEvent
to all registered listeners. |
void |
setRangeCrosshairLockedOnData(boolean flag)
Sets the flag indicating whether or not the range crosshair should "lock-on" to actual data values. |
void |
setRangeCrosshairPaint(java.awt.Paint paint)
Sets the Paint used to color the crosshairs (if visible) and notifies registered listeners that the axis has been modified. |
void |
setRangeCrosshairStroke(java.awt.Stroke stroke)
Sets the Stroke used to draw the crosshairs (if visible) and notifies registered listeners that the axis has been modified. |
void |
setRangeCrosshairValue(double value)
Sets the domain crosshair value. |
void |
setRangeCrosshairValue(double value,
boolean notify)
Sets the range crosshair value. |
void |
setRangeCrosshairVisible(boolean flag)
Sets the flag indicating whether or not the range crosshair is visible. |
void |
setRangeGridlinePaint(java.awt.Paint paint)
Sets the paint for the grid lines plotted against the range axis and sends a PlotChangeEvent to all registered listeners. |
void |
setRangeGridlineStroke(java.awt.Stroke stroke)
Sets the stroke for the grid lines plotted against the range axis, and sends a PlotChangeEvent to all registered listeners. |
void |
setRangeGridlinesVisible(boolean visible)
Sets the flag that controls whether or not the range axis grid lines are visible. |
void |
setRangeTickBandPaint(java.awt.Paint paint)
Sets the paint for the range tick bands. |
void |
setRenderer(int index,
XYItemRenderer renderer)
Sets a renderer and sends a PlotChangeEvent is sent to all
registered listeners. |
void |
setRenderer(XYItemRenderer renderer)
Sets the renderer for the primary dataset and sends a PlotChangeEvent to all registered listeners. |
void |
setWeight(int weight)
Sets the weight for the plot. |
void |
setZeroRangeBaselinePaint(java.awt.Paint paint)
Sets the paint for the zero baseline plotted against the range axis and sends a PlotChangeEvent to all registered listeners. |
void |
setZeroRangeBaselineStroke(java.awt.Stroke stroke)
Sets the stroke for the zero baseline for the range axis, and sends a PlotChangeEvent to all registered listeners. |
void |
setZeroRangeBaselineVisible(boolean visible)
Sets the flag that controls whether or not the zero baseline is displayed for the range axis, and sends a PlotChangeEvent to
all registered listeners. |
void |
zoomDomainAxes(double lowerPercent,
double upperPercent,
PlotRenderingInfo info,
java.awt.geom.Point2D source)
Zooms in on the domain axis/axes. |
void |
zoomDomainAxes(double factor,
PlotRenderingInfo info,
java.awt.geom.Point2D source)
Multiplies the range on the domain axis/axes by the specified factor. |
void |
zoomRangeAxes(double lowerPercent,
double upperPercent,
PlotRenderingInfo info,
java.awt.geom.Point2D source)
Zooms in on the range axes. |
void |
zoomRangeAxes(double factor,
PlotRenderingInfo info,
java.awt.geom.Point2D source)
Multiplies the range on the range axis/axes by the specified factor. |
Methods inherited from class java.lang.Object |
finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final java.awt.Stroke DEFAULT_GRIDLINE_STROKE
public static final java.awt.Paint DEFAULT_GRIDLINE_PAINT
public static final boolean DEFAULT_CROSSHAIR_VISIBLE
public static final java.awt.Stroke DEFAULT_CROSSHAIR_STROKE
public static final java.awt.Paint DEFAULT_CROSSHAIR_PAINT
protected static java.util.ResourceBundle localizationResources
Constructor Detail |
public XYPlot()
public XYPlot(XYDataset dataset, ValueAxis domainAxis, ValueAxis rangeAxis, XYItemRenderer renderer)
dataset
- the dataset (null
permitted).domainAxis
- the domain axis (null
permitted).rangeAxis
- the range axis (null
permitted).renderer
- the renderer (null
permitted).Method Detail |
public java.lang.String getPlotType()
getPlotType
in class Plot
public PlotOrientation getOrientation()
getOrientation
in interface Zoomable
public void setOrientation(PlotOrientation orientation)
orientation
- the orientation (null
not allowed).public RectangleInsets getAxisOffset()
null
).public void setAxisOffset(RectangleInsets offset)
offset
- the offset (null
not permitted).public ValueAxis getDomainAxis()
public ValueAxis getDomainAxis(int index)
index
- the axis index.
null
possible).public void setDomainAxis(ValueAxis axis)
PlotChangeEvent
to all registered listeners.
axis
- the new axis (null
permitted).public void setDomainAxis(int index, ValueAxis axis)
PlotChangeEvent
to all
registered listeners.
index
- the axis index.axis
- the axis.public AxisLocation getDomainAxisLocation()
null
).public void setDomainAxisLocation(AxisLocation location)
PlotChangeEvent
to all registered listeners.
location
- the location (null
not permitted).public void setDomainAxisLocation(AxisLocation location, boolean notify)
PlotChangeEvent
to all registered listeners.
location
- the location (null
not permitted).notify
- notify listeners?public RectangleEdge getDomainAxisEdge()
public int getDomainAxisCount()
public void clearDomainAxes()
PlotChangeEvent
to all registered listeners.
public void configureDomainAxes()
public AxisLocation getDomainAxisLocation(int index)
index
- the axis index.
null
).public void setDomainAxisLocation(int index, AxisLocation location)
PlotChangeEvent
to all registered listeners.
index
- the axis index.location
- the location (null
permitted).public RectangleEdge getDomainAxisEdge(int index)
index
- the axis index.
public ValueAxis getRangeAxis()
public void setRangeAxis(ValueAxis axis)
PlotChangeEvent
to
all registered listeners.
axis
- the axis (null
permitted).public AxisLocation getRangeAxisLocation()
null
).public void setRangeAxisLocation(AxisLocation location)
PlotChangeEvent
to all registered listeners.
location
- the location (null
not permitted).public void setRangeAxisLocation(AxisLocation location, boolean notify)
PlotChangeEvent
to all registered listeners.
location
- the location (null
not permitted).notify
- notify listeners?public RectangleEdge getRangeAxisEdge()
public ValueAxis getRangeAxis(int index)
index
- the axis index.
null
possible).public void setRangeAxis(int index, ValueAxis axis)
PlotChangeEvent
to all registered
listeners.
index
- the axis index.axis
- the axis (null
permitted).public int getRangeAxisCount()
public void clearRangeAxes()
PlotChangeEvent
to all registered listeners.
public void configureRangeAxes()
public AxisLocation getRangeAxisLocation(int index)
index
- the axis index.
null
).public void setRangeAxisLocation(int index, AxisLocation location)
PlotChangeEvent
to all registered listeners.
index
- the axis index.location
- the location (null
permitted).public RectangleEdge getRangeAxisEdge(int index)
index
- the axis index.
public XYDataset getDataset()
null
).public XYDataset getDataset(int index)
index
- the dataset index.
null
).public void setDataset(XYDataset dataset)
dataset
- the dataset (null
permitted).public void setDataset(int index, XYDataset dataset)
index
- the dataset index.dataset
- the dataset (null
permitted).public int getDatasetCount()
public int indexOf(XYDataset dataset)
-1
if the
dataset does not belong to the plot.
dataset
- the dataset (null
not permitted).
public void mapDatasetToDomainAxis(int index, int axisIndex)
index
- the dataset index (zero-based).axisIndex
- the axis index.public void mapDatasetToRangeAxis(int index, int axisIndex)
index
- the dataset index (zero-based).axisIndex
- the axis index.public XYItemRenderer getRenderer()
null
).public XYItemRenderer getRenderer(int index)
null
.
index
- the renderer index.
null
).public void setRenderer(XYItemRenderer renderer)
PlotChangeEvent
to all registered listeners. If the renderer
is set to null
, no data will be displayed.
renderer
- the renderer (null
permitted).public void setRenderer(int index, XYItemRenderer renderer)
PlotChangeEvent
is sent to all
registered listeners.
index
- the index.renderer
- the renderer.public DatasetRenderingOrder getDatasetRenderingOrder()
null
).public void setDatasetRenderingOrder(DatasetRenderingOrder order)
PlotChangeEvent
to all
registered listeners. By default, the plot renders the primary dataset
last (so that the primary dataset overlays the secondary datasets).
You can reverse this if you want to.
order
- the rendering order (null
not permitted).public int getIndexOf(XYItemRenderer renderer)
-1
if the
renderer is not assigned to this plot.
renderer
- the renderer (null
permitted).
public XYItemRenderer getRendererForDataset(XYDataset dataset)
dataset
- the dataset (null
permitted).
null
).public int getWeight()
public void setWeight(int weight)
weight
- the weight.public boolean isDomainGridlinesVisible()
true
if the domain gridlines are visible, and
false otherwise.
- Returns:
true
or false
.
public void setDomainGridlinesVisible(boolean visible)
If the flag value is changed, a PlotChangeEvent
is sent to all
registered listeners.
visible
- the new value of the flag.public java.awt.Stroke getDomainGridlineStroke()
public void setDomainGridlineStroke(java.awt.Stroke stroke)
If you set this to null
, no grid lines will be drawn.
stroke
- the stroke (null
permitted).public java.awt.Paint getDomainGridlinePaint()
public void setDomainGridlinePaint(java.awt.Paint paint)
If you set this to null
, no grid lines will be drawn.
paint
- the paint (null
permitted).public boolean isRangeGridlinesVisible()
true
if the range axis grid is visible, and
false otherwise.
- Returns:
- A boolean.
public void setRangeGridlinesVisible(boolean visible)
If the flag value is changed, a PlotChangeEvent
is sent to all
registered listeners.
visible
- the new value of the flag.public java.awt.Stroke getRangeGridlineStroke()
null
).public void setRangeGridlineStroke(java.awt.Stroke stroke)
PlotChangeEvent
to all registered listeners.
stroke
- the stroke (null
not permitted).public java.awt.Paint getRangeGridlinePaint()
null
).public void setRangeGridlinePaint(java.awt.Paint paint)
PlotChangeEvent
to all registered listeners.
paint
- the paint (null
permitted).public boolean isZeroRangeBaselineVisible()
public void setZeroRangeBaselineVisible(boolean visible)
PlotChangeEvent
to
all registered listeners.
visible
- the flag.public java.awt.Stroke getZeroRangeBaselineStroke()
null
).public void setZeroRangeBaselineStroke(java.awt.Stroke stroke)
PlotChangeEvent
to all registered listeners.
stroke
- the stroke (null
not permitted).public java.awt.Paint getZeroRangeBaselinePaint()
null
).public void setZeroRangeBaselinePaint(java.awt.Paint paint)
PlotChangeEvent
to all registered listeners.
paint
- the paint (null
permitted).public java.awt.Paint getDomainTickBandPaint()
null
, no tick bands will be drawn.
null
).public void setDomainTickBandPaint(java.awt.Paint paint)
paint
- the paint (null
permitted).public java.awt.Paint getRangeTickBandPaint()
null
, no tick bands will be drawn.
null
).public void setRangeTickBandPaint(java.awt.Paint paint)
paint
- the paint (null
permitted).public java.awt.geom.Point2D getQuadrantOrigin()
null
).public void setQuadrantOrigin(java.awt.geom.Point2D origin)
PlotChangeEvent
to all
registered listeners.
origin
- the origin (null
not permitted).public java.awt.Paint getQuadrantPaint(int index)
index
- the quadrant index (0-3).
null
).public void setQuadrantPaint(int index, java.awt.Paint paint)
PlotChangeEvent
to all registered listeners.
index
- the quadrant index (0-3).paint
- the paint (null
permitted).public void addDomainMarker(Marker marker)
PlotChangeEvent
to all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the range axis, however this is entirely up to the renderer.
marker
- the marker (null
not permitted).public void addDomainMarker(Marker marker, Layer layer)
PlotChangeEvent
to all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the range axis, however this is entirely up to the renderer.
marker
- the marker (null
not permitted).layer
- the layer (foreground or background).public void clearDomainMarkers()
PlotChangeEvent
to all registered listeners.
public void addDomainMarker(int index, Marker marker, Layer layer)
PlotChangeEvent
to
all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the domain axis (that the renderer is mapped to), however this is entirely up to the renderer.
index
- the renderer index.marker
- the marker.layer
- the layer (foreground or background).public void addRangeMarker(Marker marker)
PlotChangeEvent
to
all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the range axis, however this is entirely up to the renderer.
marker
- the marker (null
not permitted).public void addRangeMarker(Marker marker, Layer layer)
PlotChangeEvent
to all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the range axis, however this is entirely up to the renderer.
marker
- the marker (null
not permitted).layer
- the layer (foreground or background).public void clearRangeMarkers()
PlotChangeEvent
to all
registered listeners.
public void addRangeMarker(int index, Marker marker, Layer layer)
PlotChangeEvent
to
all registered listeners.
Typically a marker will be drawn by the renderer as a line perpendicular to the range axis, however this is entirely up to the renderer.
index
- the renderer index.marker
- the marker.layer
- the layer (foreground or background).public void clearRangeMarkers(int index)
index
- the renderer index.public void addAnnotation(XYAnnotation annotation)
PlotChangeEvent
to all
registered listeners.
annotation
- the annotation (null
not permitted).public boolean removeAnnotation(XYAnnotation annotation)
PlotChangeEvent
to all registered listeners.
annotation
- the annotation (null
not permitted).
public void clearAnnotations()
PlotChangeEvent
to all
registered listeners.
protected AxisSpace calculateAxisSpace(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea)
g2
- the graphics device.plotArea
- the plot area.
protected AxisSpace calculateDomainAxisSpace(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea, AxisSpace space)
g2
- the graphics device.plotArea
- the plot area.space
- a carrier for the result (null
permitted).
protected AxisSpace calculateRangeAxisSpace(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea, AxisSpace space)
g2
- the graphics device.plotArea
- the plot area.space
- a carrier for the result (null
permitted).
public void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area, PlotState parentState, PlotRenderingInfo state)
This plot relies on an XYItemRenderer
to draw each item in the
plot. This allows the visual representation of the data to be changed
easily.
The optional info argument collects information about the rendering of
the plot (dimensions, tooltip information etc). Just pass in
null
if you do not need this information.
draw
in class Plot
g2
- the graphics device.area
- the area within which the plot (including axes and labels)
should be drawn.parentState
- the state from the parent plot, if there is one.state
- collects chart drawing information (null
permitted).public void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area, java.awt.geom.Point2D anchor, PlotState parentState, PlotRenderingInfo info)
draw
in class Plot
g2
- the graphics device.area
- the plot area (in Java2D space).anchor
- an anchor point in Java2D space (null
permitted).parentState
- the state from the parent plot, if there is one
(null
permitted).info
- collects chart drawing information (null
permitted).public void drawBackground(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area)
drawBackground
in class Plot
g2
- the graphics device.area
- the area.protected void drawQuadrants(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area)
g2
- the graphics device.area
- the area.public void drawDomainTickBands(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, java.util.List ticks)
g2
- the graphics device.dataArea
- the data area.ticks
- the ticks.public void drawRangeTickBands(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, java.util.List ticks)
g2
- the graphics device.dataArea
- the data area.ticks
- the ticks.protected java.util.Map drawAxes(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea, java.awt.geom.Rectangle2D dataArea, PlotRenderingInfo plotState)
g2
- the graphics device (null
not permitted).plotArea
- the plot area (null
not permitted).dataArea
- the data area (null
not permitted).plotState
- collects information about the plot (null
permitted).
public boolean render(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, int index, PlotRenderingInfo info, CrosshairState crosshairState)
The info
and crosshairState
arguments may be
null
.
g2
- the graphics device.dataArea
- the region in which the data is to be drawn.index
- the dataset index.info
- an optional object for collection dimension information.crosshairState
- collects crosshair information
(null
permitted).
public ValueAxis getDomainAxisForDataset(int index)
index
- the dataset index.
public ValueAxis getRangeAxisForDataset(int index)
index
- the dataset index.
protected void drawDomainGridlines(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, java.util.List ticks)
g2
- the graphics device.dataArea
- the data area.ticks
- the ticks.protected void drawRangeGridlines(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, java.util.List ticks)
g2
- the graphics device.dataArea
- the data area.ticks
- the ticks.protected void drawZeroRangeBaseline(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea)
g2
- the graphics device.dataArea
- the data area.public void drawAnnotations(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, PlotRenderingInfo info)
g2
- the graphics device.dataArea
- the data area.info
- the chart rendering info.protected void drawDomainMarkers(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, Layer layer)
g2
- the graphics device.dataArea
- the data area.layer
- the layer (foreground or background).protected void drawRangeMarkers(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, Layer layer)
g2
- the graphics device.dataArea
- the data area.layer
- the layer (foreground or background).protected void drawDomainMarkers(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, int index, Layer layer)
g2
- the graphics device.dataArea
- the data area.index
- the renderer index.layer
- the layer (foreground or background).protected void drawRangeMarkers(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, int index, Layer layer)
g2
- the graphics device.dataArea
- the data area.index
- the renderer index.layer
- the layer (foreground or background).public java.util.Collection getDomainMarkers(Layer layer)
layer
- the layer (foreground or background).
public java.util.Collection getRangeMarkers(Layer layer)
layer
- the layer (foreground or background).
public java.util.Collection getDomainMarkers(int index, Layer layer)
index
- the renderer index.layer
- the layer.
null
).public java.util.Collection getRangeMarkers(int index, Layer layer)
index
- the renderer index.layer
- the layer.
null
).protected void drawHorizontalLine(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, double value, java.awt.Stroke stroke, java.awt.Paint paint)
g2
- the graphics device.dataArea
- the data area.value
- the coordinate, where to draw the line.stroke
- the stroke to use.paint
- the paint to use.protected void drawVerticalLine(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, double value, java.awt.Stroke stroke, java.awt.Paint paint)
g2
- the graphics device.dataArea
- the data area.value
- the coordinate, where to draw the line.stroke
- the stroke to use.paint
- the paint to use.public void handleClick(int x, int y, PlotRenderingInfo info)
handleClick
in class Plot
x
- the x-coordinate, where the click occurred, in Java2D space.y
- the y-coordinate, where the click occurred, in Java2D space.info
- object containing information about the plot dimensions.protected int getDomainAxisIndex(ValueAxis axis)
axis
- the axis.
protected int getRangeAxisIndex(ValueAxis axis)
axis
- the axis.
public Range getDataRange(ValueAxis axis)
getDataRange
in interface ValueAxisPlot
axis
- the axis.
public void datasetChanged(DatasetChangeEvent event)
The axis ranges are updated if necessary.
datasetChanged
in interface DatasetChangeListener
datasetChanged
in class Plot
event
- information about the event (not used here).public void rendererChanged(RendererChangeEvent event)
rendererChanged
in interface RendererChangeListener
event
- the event.public boolean isDomainCrosshairVisible()
public void setDomainCrosshairVisible(boolean flag)
flag
- the new value of the flag.public boolean isDomainCrosshairLockedOnData()
public void setDomainCrosshairLockedOnData(boolean flag)
flag
- the flag.public double getDomainCrosshairValue()
public void setDomainCrosshairValue(double value)
PlotChangeEvent
to
all registered listeners (provided that the domain crosshair is visible).
value
- the value.public void setDomainCrosshairValue(double value, boolean notify)
PlotChangeEvent
to all registered listeners (provided that the
domain crosshair is visible).
value
- the new value.notify
- notify listeners?public java.awt.Stroke getDomainCrosshairStroke()
Stroke
used to draw the crosshair (if visible).
public void setDomainCrosshairStroke(java.awt.Stroke stroke)
stroke
- the new crosshair stroke.public java.awt.Paint getDomainCrosshairPaint()
public void setDomainCrosshairPaint(java.awt.Paint paint)
paint
- the new crosshair paint.public boolean isRangeCrosshairVisible()
public void setRangeCrosshairVisible(boolean flag)
flag
- the new value of the flag.public boolean isRangeCrosshairLockedOnData()
public void setRangeCrosshairLockedOnData(boolean flag)
flag
- the flag.public double getRangeCrosshairValue()
public void setRangeCrosshairValue(double value)
Registered listeners are notified that the plot has been modified, but only if the crosshair is visible.
value
- the new value.public void setRangeCrosshairValue(double value, boolean notify)
Registered listeners are notified that the axis has been modified, but only if the crosshair is visible.
value
- the new value.notify
- a flag that controls whether or not listeners are
notified.public java.awt.Stroke getRangeCrosshairStroke()
public void setRangeCrosshairStroke(java.awt.Stroke stroke)
stroke
- the new crosshair stroke.public java.awt.Paint getRangeCrosshairPaint()
public void setRangeCrosshairPaint(java.awt.Paint paint)
paint
- the new crosshair paint.public AxisSpace getFixedDomainAxisSpace()
null
).public void setFixedDomainAxisSpace(AxisSpace space)
space
- the space.public AxisSpace getFixedRangeAxisSpace()
public void setFixedRangeAxisSpace(AxisSpace space)
space
- the space.public void zoomDomainAxes(double factor, PlotRenderingInfo info, java.awt.geom.Point2D source)
zoomDomainAxes
in interface Zoomable
factor
- the zoom factor.info
- the plot rendering info.source
- the source point.public void zoomDomainAxes(double lowerPercent, double upperPercent, PlotRenderingInfo info, java.awt.geom.Point2D source)
zoomDomainAxes
in interface Zoomable
lowerPercent
- a percentage that determines the new lower bound
for the axis (e.g. 0.20 is twenty percent).upperPercent
- a percentage that determines the new upper bound
for the axis (e.g. 0.80 is eighty percent).info
- the plot rendering info.source
- the source point.public void zoomRangeAxes(double factor, PlotRenderingInfo info, java.awt.geom.Point2D source)
zoomRangeAxes
in interface Zoomable
factor
- the zoom factor.info
- the plot rendering info.source
- the source point.public void zoomRangeAxes(double lowerPercent, double upperPercent, PlotRenderingInfo info, java.awt.geom.Point2D source)
zoomRangeAxes
in interface Zoomable
lowerPercent
- the lower bound.upperPercent
- the upper bound.info
- the plot rendering info.source
- the source point.public boolean isDomainZoomable()
true
isDomainZoomable
in interface Zoomable
public boolean isRangeZoomable()
true
isRangeZoomable
in interface Zoomable
public int getSeriesCount()
null
, the method returns 0.
public LegendItemCollection getFixedLegendItems()
null
).public void setFixedLegendItems(LegendItemCollection items)
null
if you prefer the legend items to be created
automatically.
items
- the legend items (null
permitted).public LegendItemCollection getLegendItems()
getLegendItems
in interface LegendItemSource
getLegendItems
in class Plot
public boolean equals(java.lang.Object obj)
equals
in class Plot
obj
- the object (null
permitted).
true
or false
.public java.lang.Object clone() throws java.lang.CloneNotSupportedException
clone
in class Plot
java.lang.CloneNotSupportedException
- this can occur if some component of
the plot cannot be cloned.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |