Standard item renderer for an
XYPlot
. This class can draw (a)
shapes at each point, or (b) lines between points, or (c) both shapes and
lines.
DISCONTINUOUS
public static final int DISCONTINUOUS
Constant for the type of rendering (discontinuous lines).
DISCONTINUOUS_LINES
public static final int DISCONTINUOUS_LINES
Constant for the type of rendering (discontinuous lines).
IMAGES
public static final int IMAGES
Constant for the type of rendering (images only).
LINES
public static final int LINES
Constant for the type of rendering (lines only).
SHAPES
public static final int SHAPES
Constant for the type of rendering (shapes only).
SHAPES_AND_LINES
public static final int SHAPES_AND_LINES
Constant for the type of rendering (shapes and lines).
StandardXYItemRenderer
public StandardXYItemRenderer(int type)
Constructs a new renderer.
To specify the type of renderer, use one of the constants: SHAPES, LINES
or SHAPES_AND_LINES.
StandardXYItemRenderer
public StandardXYItemRenderer(int type,
XYToolTipGenerator toolTipGenerator)
Constructs a new renderer.
To specify the type of renderer, use one of the constants: SHAPES, LINES
or SHAPES_AND_LINES.
type
- the type of renderer.toolTipGenerator
- the item label generator (null
permitted).
StandardXYItemRenderer
public StandardXYItemRenderer(int type,
XYToolTipGenerator toolTipGenerator,
XYURLGenerator urlGenerator)
Constructs a new renderer.
To specify the type of renderer, use one of the constants: SHAPES, LINES
or SHAPES_AND_LINES.
type
- the type of renderer.toolTipGenerator
- the item label generator (null
permitted).urlGenerator
- the URL generator.
drawItem
public void drawItem(Graphics2D g2,
XYItemRendererState state,
Rectangle2D dataArea,
PlotRenderingInfo info,
XYPlot plot,
ValueAxis domainAxis,
ValueAxis rangeAxis,
XYDataset dataset,
int series,
int item,
CrosshairState crosshairState,
int pass)
Draws the visual representation of a single data item.
- drawItem in interface XYItemRenderer
g2
- the graphics device.state
- the renderer state.dataArea
- the area within which the data is being drawn.info
- collects information about the drawing.plot
- the plot (can be used to obtain standard color information
etc).domainAxis
- the domain axis.rangeAxis
- the range axis.dataset
- the dataset.series
- the series index (zero-based).item
- the item index (zero-based).crosshairState
- crosshair information for the plot
(null
permitted).pass
- the pass index.
equals
public boolean equals(Object obj)
Tests this renderer for equality with another object.
- equals in interface AbstractXYItemRenderer
obj
- the object (null
permitted).
getBaseShapesFilled
public boolean getBaseShapesFilled()
Returns the base 'shape filled' attribute.
getBaseShapesVisible
public boolean getBaseShapesVisible()
Returns true if shapes are being plotted by the renderer.
true
if shapes are being plotted by the renderer.
getDrawSeriesLineAsPath
public boolean getDrawSeriesLineAsPath()
Returns a flag that controls whether or not each series is drawn as a
single path.
getGapThreshold
public double getGapThreshold()
Returns the gap threshold for discontinuous lines.
getGapThresholdType
public UnitType getGapThresholdType()
Returns the gap threshold type (relative or absolute).
getImage
protected Image getImage(Plot plot,
int series,
int item,
double x,
double y)
Returns the image used to draw a single data item.
plot
- the plot (can be used to obtain standard color information
etc).series
- the series index.item
- the item index.x
- the x value of the item.y
- the y value of the item.
getImageHotspot
protected Point getImageHotspot(Plot plot,
int series,
int item,
double x,
double y,
Image image)
Returns the hotspot of the image used to draw a single data item.
The hotspot is the point relative to the top left of the image
that should indicate the data item. The default is the center of the
image.
plot
- the plot (can be used to obtain standard color information
etc).series
- the series indexitem
- the item indexx
- the x value of the itemy
- the y value of the itemimage
- the image (can be used to get size information about the
image)
- The hotspot used to draw the data item.
getItemShapeFilled
public boolean getItemShapeFilled(int series,
int item)
Returns the flag used to control whether or not the shape for an item is
filled.
The default implementation passes control to the
getSeriesShapesFilled
method. You can override this method
if you require different behaviour.
series
- the series index (zero-based).item
- the item index (zero-based).
getLegendLine
public Shape getLegendLine()
Returns the shape used to represent a line in the legend.
- The legend line (never
null
).
getPlotDiscontinuous
public boolean getPlotDiscontinuous()
Returns true if lines should be discontinuous.
true
if lines should be discontinuous.
getPlotImages
public boolean getPlotImages()
Returns true if images are being plotted by the renderer.
true
if images are being plotted by the renderer.
getPlotLines
public boolean getPlotLines()
Returns true if lines are being plotted by the renderer.
true
if lines are being plotted by the renderer.
getSeriesShapesFilled
public boolean getSeriesShapesFilled(int series)
Returns the flag used to control whether or not the shapes for a series
are filled.
series
- the series index (zero-based).
initialise
public XYItemRendererState initialise(Graphics2D g2,
Rectangle2D dataArea,
XYPlot plot,
XYDataset data,
PlotRenderingInfo info)
Initialises the renderer.
This method will be called before the first item is rendered, giving the
renderer an opportunity to initialise any state information it wants to
maintain. The renderer can do nothing if it chooses.
- initialise in interface XYItemRenderer
- initialise in interface AbstractXYItemRenderer
g2
- the graphics device.dataArea
- the area inside the axes.plot
- the plot.data
- the data.info
- an optional info collection object to return data back to
the caller.
setBaseShapesFilled
public void setBaseShapesFilled(boolean flag)
Sets the base 'shapes filled' flag.
setBaseShapesVisible
public void setBaseShapesVisible(boolean flag)
Sets the flag that controls whether or not a shape is plotted at each
data point.
setDrawSeriesLineAsPath
public void setDrawSeriesLineAsPath(boolean flag)
Sets the flag that controls whether or not each series is drawn as a
single path.
setGapThreshold
public void setGapThreshold(double t)
Sets the gap threshold for discontinuous lines.
setGapThresholdType
public void setGapThresholdType(UnitType thresholdType)
Sets the gap threshold type.
thresholdType
- the type (null
not permitted).
setLegendLine
public void setLegendLine(Shape line)
Sets the shape used as a line in each legend item and sends a
RendererChangeEvent
to all registered listeners.
line
- the line (null
not permitted).
setPlotImages
public void setPlotImages(boolean flag)
Sets the flag that controls whether or not an image is drawn at each
data point.
setPlotLines
public void setPlotLines(boolean flag)
Sets the flag that controls whether or not a line is plotted between
each data point.
setSeriesShapesFilled
public void setSeriesShapesFilled(int series,
Boolean flag)
Sets the 'shapes filled' flag for a series.
series
- the series index (zero-based).flag
- the flag.
setShapesFilled
public void setShapesFilled(Boolean filled)
Sets the 'shapes filled' for ALL series.
filled
- the flag (null
permitted).
setShapesFilled
public void setShapesFilled(boolean filled)
Sets the 'shapes filled' for ALL series.