Package org.jfree.chart.renderer.xy
Interface XYItemRenderer
- All Superinterfaces:
LegendItemSource
- All Known Implementing Classes:
AbstractXYItemRenderer
,CandlestickRenderer
,ClusteredXYBarRenderer
,CyclicXYItemRenderer
,DefaultXYItemRenderer
,DeviationRenderer
,DeviationStepRenderer
,HighLowRenderer
,SamplingXYLineRenderer
,StackedXYAreaRenderer
,StackedXYAreaRenderer2
,StackedXYBarRenderer
,StandardXYItemRenderer
,VectorRenderer
,WindItemRenderer
,XYAreaRenderer
,XYAreaRenderer2
,XYBarRenderer
,XYBlockRenderer
,XYBoxAndWhiskerRenderer
,XYBubbleRenderer
,XYDifferenceRenderer
,XYDotRenderer
,XYErrorRenderer
,XYLineAndShapeRenderer
,XYShapeRenderer
,XYSplineRenderer
,XYStepAreaRenderer
,XYStepRenderer
,YIntervalRenderer
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addAnnotation
(XYAnnotation annotation) Adds an annotation and sends aRendererChangeEvent
to all registered listeners.void
addAnnotation
(XYAnnotation annotation, Layer layer) Adds an annotation to the specified layer.void
addChangeListener
(RendererChangeListener listener) Add a renderer change listener.void
drawAnnotations
(Graphics2D g2, Rectangle2D dataArea, ValueAxis domainAxis, ValueAxis rangeAxis, Layer layer, PlotRenderingInfo info) Draws all the annotations for the specified layer.void
drawDomainLine
(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke) Draws a grid line against the domain axis.void
drawDomainMarker
(Graphics2D g2, XYPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea) Draws the specifiedmarker
against the domain axis.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) Called for each item to be plotted.void
drawRangeLine
(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke) Draws a line perpendicular to the range axis.void
drawRangeMarker
(Graphics2D g2, XYPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea) Draws a horizontal line across the chart to represent a 'range marker'.void
fillDomainGridBand
(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double start, double end) Fills a band between two values on the axis.void
fillRangeGridBand
(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double start, double end) Fills a band between two values on the range axis.findDomainBounds
(XYDataset dataset) Returns the lower and upper bounds (range) of the x-values in the specified dataset.findRangeBounds
(XYDataset dataset) Returns the lower and upper bounds (range) of the y-values in the specified dataset.boolean
Returns the default value determining whether or not entities should be created by the renderer.Returns the default paint.Returns the default item label font (this is used when no other font setting is available).Returns the default item label generator.Returns the default item label paint.boolean
Returns the default setting for item label visibility.Returns the default item label position for negative values.Returns the default outline paint.Returns the default outline stroke.Returns the default paint.Returns the default positive item label position.boolean
Returns the default visibility for all series.boolean
Returns the default visibility in the legend for all series.Returns the default shape.Returns the default stroke.Returns the default tool tip generator.boolean
getItemCreateEntity
(int series, int item) Returnstrue
if an entity should be created for an item, andfalse
otherwise.getItemFillPaint
(int row, int column) Returns the paint used to fill data items as they are drawn.getItemLabelFont
(int row, int column) Returns the font for an item label.getItemLabelGenerator
(int row, int column) Returns the item label generator for a data item.getItemLabelPaint
(int row, int column) Returns the paint used to draw an item label.getItemOutlinePaint
(int row, int column) Returns the paint used to outline data items as they are drawn.getItemOutlineStroke
(int row, int column) Returns the stroke used to outline data items.getItemPaint
(int row, int column) Returns the paint used to color data items as they are drawn.getItemShape
(int row, int column) Returns a shape used to represent a data item.getItemStroke
(int row, int column) Returns the stroke used to draw data items.boolean
getItemVisible
(int series, int item) Returns a boolean that indicates whether or not the specified item should be drawn (this is typically used to hide an entire series).getLegendItem
(int datasetIndex, int series) Returns a legend item for a series from a dataset.Returns the legend item label generator.getNegativeItemLabelPosition
(int row, int column) Returns the item label position for negative values.int
Returns the number of passes through the data required by the renderer.getPlot()
Returns the plot that this renderer has been assigned to.getPositiveItemLabelPosition
(int row, int column) Returns the item label position for positive values.getSeriesCreateEntities
(int series) Returnstrue
if entities should be created for a series, andfalse
otherwise.getSeriesFillPaint
(int series) Returns the paint used to fill an item drawn by the renderer.getSeriesItemLabelFont
(int series) Returns the font for all the item labels in a series.getSeriesItemLabelGenerator
(int series) Returns the item label generator for a series.getSeriesItemLabelPaint
(int series) Returns the paint used to draw the item labels for a series.getSeriesNegativeItemLabelPosition
(int series) Returns the item label position for all negative values in a series.getSeriesOutlinePaint
(int series) Returns the paint used to outline an item drawn by the renderer.getSeriesOutlineStroke
(int series) Returns the stroke used to outline the items in a series.getSeriesPaint
(int series) Returns the paint used to color an item drawn by the renderer.getSeriesPositiveItemLabelPosition
(int series) Returns the item label position for all positive values in a series.getSeriesShape
(int series) Returns a shape used to represent the items in a series.getSeriesStroke
(int series) Returns the stroke used to draw the items in a series.getSeriesToolTipGenerator
(int series) Returns the tool tip generator for a series.getSeriesVisible
(int series) Returns the flag that controls whether a series is visible.getSeriesVisibleInLegend
(int series) Returns the flag that controls whether a series is visible in the legend.getToolTipGenerator
(int row, int column) Returns the tool tip generator for a data item.Returns the URL generator for HTML image maps.initialise
(Graphics2D g2, Rectangle2D dataArea, XYPlot plot, XYDataset dataset, PlotRenderingInfo info) Initialises the renderer then returns the number of 'passes' through the data that the renderer will require (usually just one).boolean
isItemLabelVisible
(int row, int column) Returnstrue
if an item label is visible, andfalse
otherwise.boolean
isSeriesItemLabelsVisible
(int series) Returnstrue
if the item labels for a series are visible, andfalse
otherwise.boolean
isSeriesVisible
(int series) Returns a boolean that indicates whether or not the specified series should be drawn (this is typically used to hide an entire series).boolean
isSeriesVisibleInLegend
(int series) Returnstrue
if the series should be shown in the legend, andfalse
otherwise.boolean
removeAnnotation
(XYAnnotation annotation) Removes the specified annotation and sends aRendererChangeEvent
to all registered listeners.void
Removes all annotations and sends aRendererChangeEvent
to all registered listeners.void
removeChangeListener
(RendererChangeListener listener) Removes a change listener.void
setDefaultCreateEntities
(boolean create) Sets the default value determining whether or not entities should be created by the renderer, and sends a change event to all registered listeners.void
setDefaultCreateEntities
(boolean create, boolean notify) Sets the default value determining whether or not entities should be created by the renderer, and sends a change event to all registered listeners.void
setDefaultFillPaint
(Paint paint) Sets the default paint and sends aRendererChangeEvent
to all registered listeners.void
setDefaultFillPaint
(Paint paint, boolean notify) Sets the default paint and sends aRendererChangeEvent
to all registered listeners if requested.void
setDefaultItemLabelFont
(Font font) Sets the default item label font and sends aRendererChangeEvent
to all registered listeners.void
setDefaultItemLabelGenerator
(XYItemLabelGenerator generator) Sets the default item label generator and sends aRendererChangeEvent
to all registered listeners.void
setDefaultItemLabelPaint
(Paint paint) Sets the default item label paint and sends aRendererChangeEvent
to all registered listeners.void
setDefaultItemLabelsVisible
(boolean visible) Sets the default flag that controls whether or not item labels are visible.void
setDefaultItemLabelsVisible
(boolean visible, boolean notify) Sets the default visibility for item labels and, if requested, sends aRendererChangeEvent
to all registered listeners.void
Sets the default item label position for negative values and sends aRendererChangeEvent
to all registered listeners.void
setDefaultNegativeItemLabelPosition
(ItemLabelPosition position, boolean notify) Sets the default negative item label position and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setDefaultOutlinePaint
(Paint paint) Sets the default outline paint and sends aRendererChangeEvent
to all registered listeners.void
setDefaultOutlinePaint
(Paint paint, boolean notify) Sets the default outline paint and sends aRendererChangeEvent
to all registered listeners if requested.void
setDefaultOutlineStroke
(Stroke stroke) Sets the base outline stroke and sends aRendererChangeEvent
to all registered listeners.void
setDefaultOutlineStroke
(Stroke stroke, boolean notify) Sets the base outline stroke and sends aRendererChangeEvent
to all registered listeners if requested.void
setDefaultPaint
(Paint paint) Sets the default paint and sends aRendererChangeEvent
to all registered listeners.void
setDefaultPaint
(Paint paint, boolean notify) Sets the default paint and sends aRendererChangeEvent
to all registered listeners if requested.void
Sets the default positive item label position.void
setDefaultPositiveItemLabelPosition
(ItemLabelPosition position, boolean notify) Sets the default positive item label position and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setDefaultSeriesVisible
(boolean visible) Sets the default visibility and sends aRendererChangeEvent
to all registered listeners.void
setDefaultSeriesVisible
(boolean visible, boolean notify) Sets the default visibility and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setDefaultSeriesVisibleInLegend
(boolean visible) Sets the default visibility in the legend and sends aRendererChangeEvent
to all registered listeners.void
setDefaultSeriesVisibleInLegend
(boolean visible, boolean notify) Sets the default visibility in the legend and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setDefaultShape
(Shape shape) Sets the default shape and sends aRendererChangeEvent
to all registered listeners.void
setDefaultShape
(Shape shape, boolean notify) Sets the default shape and sends aRendererChangeEvent
to all registered listeners if requested.void
setDefaultStroke
(Stroke stroke) Sets the default stroke and sends aRendererChangeEvent
to all registered listeners.void
setDefaultStroke
(Stroke stroke, boolean notify) Sets the default stroke and sends aRendererChangeEvent
to all registered listeners if requested.void
setDefaultToolTipGenerator
(XYToolTipGenerator generator) Sets the default tool tip generator and sends aRendererChangeEvent
to all registered listeners.void
Sets the legend item label generator and sends aRendererChangeEvent
to all registered listeners.void
Sets the plot that this renderer is assigned to.void
setSeriesCreateEntities
(int series, Boolean create) Sets a flag that specifies whether or not entities should be created for a series during rendering, and sends a change event to registered listeners.void
setSeriesCreateEntities
(int series, Boolean create, boolean notify) Sets a flag that specifies whether or not entities should be created for a series during rendering, and sends a change event to registered listeners.void
setSeriesFillPaint
(int series, Paint paint) Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesFillPaint
(int series, Paint paint, boolean notify) Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesItemLabelFont
(int series, Font font) Sets the item label font for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesItemLabelGenerator
(int series, XYItemLabelGenerator generator) Sets the item label generator for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesItemLabelPaint
(int series, Paint paint) Sets the item label paint for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesItemLabelsVisible
(int series, boolean visible) Sets a flag that controls the visibility of the item labels for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesItemLabelsVisible
(int series, Boolean visible) Sets a flag that controls the visibility of the item labels for a series.void
setSeriesItemLabelsVisible
(int series, Boolean visible, boolean notify) Sets the visibility of item labels for a series and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setSeriesNegativeItemLabelPosition
(int series, ItemLabelPosition position) Sets the item label position for negative values in a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesNegativeItemLabelPosition
(int series, ItemLabelPosition position, boolean notify) Sets the item label position for negative values in a series and (if requested) sends aRendererChangeEvent
to all registered listeners.void
setSeriesOutlinePaint
(int series, Paint paint) Sets the paint used for a series outline and sends aRendererChangeEvent
to all registered listeners.void
setSeriesOutlinePaint
(int series, Paint paint, boolean notify) Sets the paint used for a series outline and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesOutlineStroke
(int series, Stroke stroke) Sets the outline stroke used for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesOutlineStroke
(int series, Stroke stroke, boolean notify) Sets the outline stroke used for a series and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesPaint
(int series, Paint paint) Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesPaint
(int series, Paint paint, boolean notify) Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesPositiveItemLabelPosition
(int series, ItemLabelPosition position) Sets the item label position for all positive values in a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesPositiveItemLabelPosition
(int series, ItemLabelPosition position, boolean notify) Sets the item label position for all positive values in a series and (if requested) sends aRendererChangeEvent
to all registered listeners.void
setSeriesShape
(int series, Shape shape) Sets the shape used for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesShape
(int series, Shape shape, boolean notify) Sets the shape used for a series and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesStroke
(int series, Stroke stroke) Sets the stroke used for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesStroke
(int series, Stroke stroke, boolean notify) Sets the stroke used for a series and sends aRendererChangeEvent
to all registered listeners if requested.void
setSeriesToolTipGenerator
(int series, XYToolTipGenerator generator) Sets the tool tip generator for a series and sends aRendererChangeEvent
to all registered listeners.void
setSeriesVisible
(int series, Boolean visible) Sets the flag that controls whether a series is visible and sends aRendererChangeEvent
to all registered listeners.void
setSeriesVisible
(int series, Boolean visible, boolean notify) Sets the flag that controls whether a series is visible and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setSeriesVisibleInLegend
(int series, Boolean visible) Sets the flag that controls whether a series is visible in the legend and sends aRendererChangeEvent
to all registered listeners.void
setSeriesVisibleInLegend
(int series, Boolean visible, boolean notify) Sets the flag that controls whether a series is visible in the legend and, if requested, sends aRendererChangeEvent
to all registered listeners.void
setURLGenerator
(XYURLGenerator urlGenerator) Sets the URL generator for HTML image maps.Methods inherited from interface org.jfree.chart.LegendItemSource
getLegendItems
-
Method Details
-
getPlot
Returns the plot that this renderer has been assigned to.- Returns:
- The plot.
-
setPlot
Sets the plot that this renderer is assigned to. This method will be called by the plot class...you do not need to call it yourself.- Parameters:
plot
- the plot.
-
getPassCount
int getPassCount()Returns the number of passes through the data required by the renderer.- Returns:
- The pass count.
-
findDomainBounds
Returns the lower and upper bounds (range) of the x-values in the specified dataset.- Parameters:
dataset
- the dataset (null
permitted).- Returns:
- The range.
-
findRangeBounds
Returns the lower and upper bounds (range) of the y-values in the specified dataset. The implementation of this method will take into account the presentation used by the renderers (for example, a renderer that "stacks" values will return a bigger range than a renderer that doesn't).- Parameters:
dataset
- the dataset (null
permitted).- Returns:
- The range (or
null
if the dataset isnull
or empty).
-
addChangeListener
Add a renderer change listener.- Parameters:
listener
- the listener.- See Also:
-
removeChangeListener
Removes a change listener.- Parameters:
listener
- the listener.- See Also:
-
getItemVisible
Returns a boolean that indicates whether or not the specified item should be drawn (this is typically used to hide an entire series).- Parameters:
series
- the series index.item
- the item index.- Returns:
- A boolean.
-
isSeriesVisible
Returns a boolean that indicates whether or not the specified series should be drawn (this is typically used to hide an entire series).- Parameters:
series
- the series index.- Returns:
- A boolean.
-
getSeriesVisible
Returns the flag that controls whether a series is visible.- Parameters:
series
- the series index (zero-based).- Returns:
- The flag (possibly
null
). - See Also:
-
setSeriesVisible
Sets the flag that controls whether a series is visible and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).visible
- the flag (null
permitted).- See Also:
-
setSeriesVisible
Sets the flag that controls whether a series is visible and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index.visible
- the flag (null
permitted).notify
- notify listeners?- See Also:
-
getDefaultSeriesVisible
boolean getDefaultSeriesVisible()Returns the default visibility for all series.- Returns:
- The default visibility.
- See Also:
-
setDefaultSeriesVisible
Sets the default visibility and sends aRendererChangeEvent
to all registered listeners.- Parameters:
visible
- the flag.- See Also:
-
setDefaultSeriesVisible
Sets the default visibility and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
visible
- the visibility.notify
- notify listeners?- See Also:
-
isSeriesVisibleInLegend
Returnstrue
if the series should be shown in the legend, andfalse
otherwise.- Parameters:
series
- the series index.- Returns:
- A boolean.
-
getSeriesVisibleInLegend
Returns the flag that controls whether a series is visible in the legend. This method returns only the "per series" settings - to incorporate the override and base settings as well, you need to use theisSeriesVisibleInLegend(int)
method.- Parameters:
series
- the series index (zero-based).- Returns:
- The flag (possibly
null
). - See Also:
-
setSeriesVisibleInLegend
Sets the flag that controls whether a series is visible in the legend and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).visible
- the flag (null
permitted).- See Also:
-
setSeriesVisibleInLegend
Sets the flag that controls whether a series is visible in the legend and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index.visible
- the flag (null
permitted).notify
- notify listeners?- See Also:
-
getDefaultSeriesVisibleInLegend
boolean getDefaultSeriesVisibleInLegend()Returns the default visibility in the legend for all series.- Returns:
- The default visibility.
- See Also:
-
setDefaultSeriesVisibleInLegend
Sets the default visibility in the legend and sends aRendererChangeEvent
to all registered listeners.- Parameters:
visible
- the flag.- See Also:
-
setDefaultSeriesVisibleInLegend
Sets the default visibility in the legend and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
visible
- the visibility.notify
- notify listeners?- See Also:
-
getItemPaint
Returns the paint used to color data items as they are drawn.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The paint (never
null
).
-
getSeriesPaint
Returns the paint used to color an item drawn by the renderer.- Parameters:
series
- the series index (zero-based).- Returns:
- The paint (possibly
null
). - See Also:
-
setSeriesPaint
Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).- See Also:
-
setSeriesPaint
Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).notify
- send a change event?- See Also:
-
getDefaultPaint
Returns the default paint.- Returns:
- The default paint (never
null
). - See Also:
-
setDefaultPaint
Sets the default paint and sends aRendererChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
not permitted).- See Also:
-
setDefaultPaint
Sets the default paint and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
paint
- the paint (null
not permitted).notify
- send a change event?- See Also:
-
getItemFillPaint
Returns the paint used to fill data items as they are drawn.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The paint (never
null
).
-
getSeriesFillPaint
Returns the paint used to fill an item drawn by the renderer.- Parameters:
series
- the series index (zero-based).- Returns:
- The paint (possibly
null
).
-
setSeriesFillPaint
Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).
-
setSeriesFillPaint
Sets the paint used for a series and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).notify
- send a change event?
-
getDefaultFillPaint
Returns the default paint.- Returns:
- The default paint (never
null
).
-
setDefaultFillPaint
Sets the default paint and sends aRendererChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
not permitted).
-
setDefaultFillPaint
Sets the default paint and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
paint
- the paint (null
not permitted).notify
- send a change event?
-
getItemOutlinePaint
Returns the paint used to outline data items as they are drawn.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The paint (never
null
).
-
getSeriesOutlinePaint
Returns the paint used to outline an item drawn by the renderer.- Parameters:
series
- the series (zero-based index).- Returns:
- The paint (possibly
null
). - See Also:
-
setSeriesOutlinePaint
Sets the paint used for a series outline and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).- See Also:
-
setSeriesOutlinePaint
Sets the paint used for a series outline and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).paint
- the paint (null
permitted).notify
- send a change event?- See Also:
-
getDefaultOutlinePaint
Returns the default outline paint.- Returns:
- The paint (never
null
). - See Also:
-
setDefaultOutlinePaint
Sets the default outline paint and sends aRendererChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
not permitted).- See Also:
-
setDefaultOutlinePaint
Sets the default outline paint and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
paint
- the paint (null
not permitted).notify
- send a change event?- See Also:
-
getItemStroke
Returns the stroke used to draw data items.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The stroke (never
null
).
-
getSeriesStroke
Returns the stroke used to draw the items in a series.- Parameters:
series
- the series (zero-based index).- Returns:
- The stroke (possibly
null
). - See Also:
-
setSeriesStroke
Sets the stroke used for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).stroke
- the stroke (null
permitted).- See Also:
-
setSeriesStroke
Sets the stroke used for a series and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).stroke
- the stroke (null
permitted).notify
- send a change event?- See Also:
-
getDefaultStroke
Returns the default stroke.- Returns:
- The default stroke (never
null
). - See Also:
-
setDefaultStroke
Sets the default stroke and sends aRendererChangeEvent
to all registered listeners.- Parameters:
stroke
- the stroke (null
not permitted).- See Also:
-
setDefaultStroke
Sets the default stroke and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
stroke
- the stroke (null
not permitted).notify
- send a change event?- See Also:
-
getItemOutlineStroke
Returns the stroke used to outline data items. The default implementation passes control to the lookupSeriesOutlineStroke method. You can override this method if you require different behaviour.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The stroke (never
null
).
-
getSeriesOutlineStroke
Returns the stroke used to outline the items in a series.- Parameters:
series
- the series (zero-based index).- Returns:
- The stroke (possibly
null
). - See Also:
-
setSeriesOutlineStroke
Sets the outline stroke used for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).stroke
- the stroke (null
permitted).- See Also:
-
setSeriesOutlineStroke
Sets the outline stroke used for a series and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).stroke
- the stroke (null
permitted).notify
- send a change event?- See Also:
-
getDefaultOutlineStroke
Returns the default outline stroke.- Returns:
- The stroke (never
null
). - See Also:
-
setDefaultOutlineStroke
Sets the base outline stroke and sends aRendererChangeEvent
to all registered listeners.- Parameters:
stroke
- the stroke (null
not permitted).- See Also:
-
setDefaultOutlineStroke
Sets the base outline stroke and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
stroke
- the stroke (null
not permitted).notify
- send a change event.- See Also:
-
getItemShape
Returns a shape used to represent a data item.- Parameters:
row
- the row (or series) index (zero-based).column
- the column (or category) index (zero-based).- Returns:
- The shape (never
null
).
-
getSeriesShape
Returns a shape used to represent the items in a series.- Parameters:
series
- the series (zero-based index).- Returns:
- The shape (possibly
null
). - See Also:
-
setSeriesShape
Sets the shape used for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).shape
- the shape (null
permitted).- See Also:
-
setSeriesShape
Sets the shape used for a series and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
series
- the series index (zero-based).shape
- the shape (null
permitted).notify
- send a change event?- See Also:
-
getDefaultShape
Returns the default shape.- Returns:
- The shape (never
null
). - See Also:
-
setDefaultShape
Sets the default shape and sends aRendererChangeEvent
to all registered listeners.- Parameters:
shape
- the shape (null
not permitted).- See Also:
-
setDefaultShape
Sets the default shape and sends aRendererChangeEvent
to all registered listeners if requested.- Parameters:
shape
- the shape (null
not permitted).notify
- send a change event?- See Also:
-
getLegendItem
Returns a legend item for a series from a dataset.- Parameters:
datasetIndex
- the dataset index.series
- the series (zero-based index).- Returns:
- The legend item (possibly
null
).
-
getLegendItemLabelGenerator
Returns the legend item label generator.- Returns:
- The legend item label generator (never
null
). - See Also:
-
setLegendItemLabelGenerator
Sets the legend item label generator and sends aRendererChangeEvent
to all registered listeners.- Parameters:
generator
- the generator (null
not permitted).
-
getToolTipGenerator
Returns the tool tip generator for a data item.- Parameters:
row
- the row index (zero based).column
- the column index (zero based).- Returns:
- The generator (possibly
null
).
-
getSeriesToolTipGenerator
Returns the tool tip generator for a series.- Parameters:
series
- the series index (zero based).- Returns:
- The generator (possibly
null
). - See Also:
-
setSeriesToolTipGenerator
Sets the tool tip generator for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero based).generator
- the generator (null
permitted).- See Also:
-
getDefaultToolTipGenerator
Returns the default tool tip generator.- Returns:
- The generator (possibly
null
). - See Also:
-
setDefaultToolTipGenerator
Sets the default tool tip generator and sends aRendererChangeEvent
to all registered listeners.- Parameters:
generator
- the generator (null
permitted).- See Also:
-
getURLGenerator
Returns the URL generator for HTML image maps.- Returns:
- The URL generator (possibly null).
-
setURLGenerator
Sets the URL generator for HTML image maps.- Parameters:
urlGenerator
- the URL generator (null permitted).
-
isItemLabelVisible
Returnstrue
if an item label is visible, andfalse
otherwise.- Parameters:
row
- the row index (zero-based).column
- the column index (zero-based).- Returns:
- A boolean.
-
isSeriesItemLabelsVisible
Returnstrue
if the item labels for a series are visible, andfalse
otherwise.- Parameters:
series
- the series index (zero-based).- Returns:
- A boolean.
-
setSeriesItemLabelsVisible
Sets a flag that controls the visibility of the item labels for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).visible
- the flag.- See Also:
-
setSeriesItemLabelsVisible
Sets a flag that controls the visibility of the item labels for a series.- Parameters:
series
- the series index (zero-based).visible
- the flag (null
permitted).- See Also:
-
setSeriesItemLabelsVisible
Sets the visibility of item labels for a series and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).visible
- the visible flag.notify
- a flag that controls whether or not listeners are notified.- See Also:
-
getDefaultItemLabelsVisible
boolean getDefaultItemLabelsVisible()Returns the default setting for item label visibility.- Returns:
- A flag (possibly
null
). - See Also:
-
setDefaultItemLabelsVisible
Sets the default flag that controls whether or not item labels are visible.- Parameters:
visible
- the flag.- See Also:
-
setDefaultItemLabelsVisible
Sets the default visibility for item labels and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
visible
- the visibility flag.notify
- a flag that controls whether or not listeners are notified.- See Also:
-
getItemLabelGenerator
Returns the item label generator for a data item.- Parameters:
row
- the row index (zero based).column
- the column index (zero based).- Returns:
- The generator (possibly
null
).
-
getSeriesItemLabelGenerator
Returns the item label generator for a series.- Parameters:
series
- the series index (zero based).- Returns:
- The generator (possibly
null
). - See Also:
-
setSeriesItemLabelGenerator
Sets the item label generator for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero based).generator
- the generator (null
permitted).- See Also:
-
getDefaultItemLabelGenerator
Returns the default item label generator.- Returns:
- The generator (possibly
null
). - See Also:
-
setDefaultItemLabelGenerator
Sets the default item label generator and sends aRendererChangeEvent
to all registered listeners.- Parameters:
generator
- the generator (null
permitted).- See Also:
-
getItemLabelFont
Returns the font for an item label.- Parameters:
row
- the row index (zero-based).column
- the column index (zero-based).- Returns:
- The font (never
null
).
-
getSeriesItemLabelFont
Returns the font for all the item labels in a series.- Parameters:
series
- the series index (zero-based).- Returns:
- The font (possibly
null
).
-
setSeriesItemLabelFont
Sets the item label font for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).font
- the font (null
permitted).- See Also:
-
getDefaultItemLabelFont
Returns the default item label font (this is used when no other font setting is available).- Returns:
- The font (never
null
). - See Also:
-
setDefaultItemLabelFont
Sets the default item label font and sends aRendererChangeEvent
to all registered listeners.- Parameters:
font
- the font (null
not permitted).- See Also:
-
getItemLabelPaint
Returns the paint used to draw an item label.- Parameters:
row
- the row index (zero based).column
- the column index (zero based).- Returns:
- The paint (never
null
).
-
getSeriesItemLabelPaint
Returns the paint used to draw the item labels for a series.- Parameters:
series
- the series index (zero based).- Returns:
- The paint (possibly
null
). - See Also:
-
setSeriesItemLabelPaint
Sets the item label paint for a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series (zero based index).paint
- the paint (null
permitted).- See Also:
-
getDefaultItemLabelPaint
Returns the default item label paint.- Returns:
- The paint (never
null
).
-
setDefaultItemLabelPaint
Sets the default item label paint and sends aRendererChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
not permitted).
-
getPositiveItemLabelPosition
Returns the item label position for positive values.- Parameters:
row
- the row index (zero-based).column
- the column index (zero-based).- Returns:
- The item label position (never
null
).
-
getSeriesPositiveItemLabelPosition
Returns the item label position for all positive values in a series.- Parameters:
series
- the series index (zero-based).- Returns:
- The item label position (never
null
).
-
setSeriesPositiveItemLabelPosition
Sets the item label position for all positive values in a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).position
- the position (null
permitted).
-
setSeriesPositiveItemLabelPosition
Sets the item label position for all positive values in a series and (if requested) sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).position
- the position (null
permitted).notify
- notify registered listeners?
-
getDefaultPositiveItemLabelPosition
Returns the default positive item label position.- Returns:
- The position (never
null
).
-
setDefaultPositiveItemLabelPosition
Sets the default positive item label position.- Parameters:
position
- the position (null
not permitted).
-
setDefaultPositiveItemLabelPosition
Sets the default positive item label position and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
position
- the position (null
not permitted).notify
- notify registered listeners?
-
getNegativeItemLabelPosition
Returns the item label position for negative values. This method can be overridden to provide customisation of the item label position for individual data items.- Parameters:
row
- the row index (zero-based).column
- the column (zero-based).- Returns:
- The item label position (never
null
).
-
getSeriesNegativeItemLabelPosition
Returns the item label position for all negative values in a series.- Parameters:
series
- the series index (zero-based).- Returns:
- The item label position (never
null
).
-
setSeriesNegativeItemLabelPosition
Sets the item label position for negative values in a series and sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).position
- the position (null
permitted).
-
setSeriesNegativeItemLabelPosition
Sets the item label position for negative values in a series and (if requested) sends aRendererChangeEvent
to all registered listeners.- Parameters:
series
- the series index (zero-based).position
- the position (null
permitted).notify
- notify registered listeners?
-
getDefaultNegativeItemLabelPosition
Returns the default item label position for negative values.- Returns:
- The position (never
null
).
-
setDefaultNegativeItemLabelPosition
Sets the default item label position for negative values and sends aRendererChangeEvent
to all registered listeners.- Parameters:
position
- the position (null
not permitted).
-
setDefaultNegativeItemLabelPosition
Sets the default negative item label position and, if requested, sends aRendererChangeEvent
to all registered listeners.- Parameters:
position
- the position (null
not permitted).notify
- notify registered listeners?
-
getItemCreateEntity
Returnstrue
if an entity should be created for an item, andfalse
otherwise.- Parameters:
series
- the series.item
- the item.- Returns:
- A boolean.
-
getSeriesCreateEntities
Returnstrue
if entities should be created for a series, andfalse
otherwise. This method can returnnull
in which case the renderering framework will look at the default setting.- Parameters:
series
- the series.- Returns:
- A boolean.
-
setSeriesCreateEntities
Sets a flag that specifies whether or not entities should be created for a series during rendering, and sends a change event to registered listeners.- Parameters:
series
- the series.create
- the flag value (null
permitted).
-
setSeriesCreateEntities
Sets a flag that specifies whether or not entities should be created for a series during rendering, and sends a change event to registered listeners.- Parameters:
series
- the series.create
- the flag value (null
permitted).notify
- send a change event?
-
getDefaultCreateEntities
boolean getDefaultCreateEntities()Returns the default value determining whether or not entities should be created by the renderer.- Returns:
- A boolean.
-
setDefaultCreateEntities
Sets the default value determining whether or not entities should be created by the renderer, and sends a change event to all registered listeners.- Parameters:
create
- the flag value.
-
setDefaultCreateEntities
Sets the default value determining whether or not entities should be created by the renderer, and sends a change event to all registered listeners.- Parameters:
create
- the flag value.notify
- notify listeners?
-
addAnnotation
Adds an annotation and sends aRendererChangeEvent
to all registered listeners. The annotation is added to the foreground layer.- Parameters:
annotation
- the annotation (null
not permitted).
-
addAnnotation
Adds an annotation to the specified layer.- Parameters:
annotation
- the annotation (null
not permitted).layer
- the layer (null
not permitted).
-
removeAnnotation
Removes the specified annotation and sends aRendererChangeEvent
to all registered listeners.- Parameters:
annotation
- the annotation to remove (null
not permitted).- Returns:
- A boolean to indicate whether or not the annotation was successfully removed.
-
removeAnnotations
void removeAnnotations()Removes all annotations and sends aRendererChangeEvent
to all registered listeners. -
drawAnnotations
void drawAnnotations(Graphics2D g2, Rectangle2D dataArea, ValueAxis domainAxis, ValueAxis rangeAxis, Layer layer, PlotRenderingInfo info) Draws all the annotations for the specified layer.- Parameters:
g2
- the graphics device.dataArea
- the data area.domainAxis
- the domain axis.rangeAxis
- the range axis.layer
- the layer.info
- the plot rendering info.
-
initialise
XYItemRendererState initialise(Graphics2D g2, Rectangle2D dataArea, XYPlot plot, XYDataset dataset, PlotRenderingInfo info) Initialises the renderer then returns the number of 'passes' through the data that the renderer will require (usually just one). 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.- Parameters:
g2
- the graphics device.dataArea
- the area inside the axes.plot
- the plot.dataset
- the dataset.info
- an optional info collection object to return data back to the caller.- Returns:
- The number of passes the renderer requires.
-
drawItem
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) Called for each item to be plotted.The
XYPlot
can make multiple passes through the dataset, depending on the value returned by the renderer's initialise() method.- Parameters:
g2
- the graphics device.state
- the renderer state.dataArea
- the area within which the data is being rendered.info
- collects drawing info.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.
-
fillDomainGridBand
void fillDomainGridBand(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double start, double end) Fills a band between two values on the axis. This can be used to color bands between the grid lines.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the domain axis.dataArea
- the data area.start
- the start value.end
- the end value.
-
fillRangeGridBand
void fillRangeGridBand(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double start, double end) Fills a band between two values on the range axis. This can be used to color bands between the grid lines.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the range axis.dataArea
- the data area.start
- the start value.end
- the end value.
-
drawDomainLine
void drawDomainLine(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke) Draws a grid line against the domain axis.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the value axis.dataArea
- the area for plotting data.value
- the value.paint
- the paint (null
not permitted).stroke
- the stroke (null
not permitted).
-
drawRangeLine
void drawRangeLine(Graphics2D g2, XYPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke) Draws a line perpendicular to the range axis.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the value axis.dataArea
- the area for plotting data.value
- the data value.paint
- the paint (null
not permitted).stroke
- the stroke (null
not permitted).
-
drawDomainMarker
void drawDomainMarker(Graphics2D g2, XYPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea) Draws the specifiedmarker
against the domain axis.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the value axis.marker
- the marker.dataArea
- the axis data area.
-
drawRangeMarker
void drawRangeMarker(Graphics2D g2, XYPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea) Draws a horizontal line across the chart to represent a 'range marker'.- Parameters:
g2
- the graphics device.plot
- the plot.axis
- the value axis.marker
- the marker line.dataArea
- the axis data area.
-