Module platform

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

public interface XYItemRenderer extends LegendItemSource
Interface for rendering the visual representation of a single (x, y) item on an XYPlot.

To support cloning charts, it is recommended that renderers implement both the Cloneable and PublicCloneable interfaces.

  • Method Details

    • getPlot

      XYPlot getPlot()
      Returns the plot that this renderer has been assigned to.
      Returns:
      The plot.
    • setPlot

      void setPlot(XYPlot plot)
      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

      Range findDomainBounds(XYDataset dataset)
      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

      Range findRangeBounds(XYDataset dataset)
      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 is null or empty).
    • addChangeListener

      void addChangeListener(RendererChangeListener listener)
      Add a renderer change listener.
      Parameters:
      listener - the listener.
      See Also:
    • removeChangeListener

      void removeChangeListener(RendererChangeListener listener)
      Removes a change listener.
      Parameters:
      listener - the listener.
      See Also:
    • getItemVisible

      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).
      Parameters:
      series - the series index.
      item - the item index.
      Returns:
      A boolean.
    • isSeriesVisible

      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).
      Parameters:
      series - the series index.
      Returns:
      A boolean.
    • getSeriesVisible

      Boolean getSeriesVisible(int series)
      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

      void setSeriesVisible(int series, Boolean visible)
      Sets the flag that controls whether a series is visible and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      visible - the flag (null permitted).
      See Also:
    • setSeriesVisible

      void setSeriesVisible(int series, Boolean visible, boolean notify)
      Sets the flag that controls whether a series is visible and, if requested, sends a RendererChangeEvent 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

      void setDefaultSeriesVisible(boolean visible)
      Sets the default visibility and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      visible - the flag.
      See Also:
    • setDefaultSeriesVisible

      void setDefaultSeriesVisible(boolean visible, boolean notify)
      Sets the default visibility and, if requested, sends a RendererChangeEvent to all registered listeners.
      Parameters:
      visible - the visibility.
      notify - notify listeners?
      See Also:
    • isSeriesVisibleInLegend

      boolean isSeriesVisibleInLegend(int series)
      Returns true if the series should be shown in the legend, and false otherwise.
      Parameters:
      series - the series index.
      Returns:
      A boolean.
    • getSeriesVisibleInLegend

      Boolean getSeriesVisibleInLegend(int series)
      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 the isSeriesVisibleInLegend(int) method.
      Parameters:
      series - the series index (zero-based).
      Returns:
      The flag (possibly null).
      See Also:
    • setSeriesVisibleInLegend

      void setSeriesVisibleInLegend(int series, Boolean visible)
      Sets the flag that controls whether a series is visible in the legend and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      visible - the flag (null permitted).
      See Also:
    • setSeriesVisibleInLegend

      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 a RendererChangeEvent 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

      void setDefaultSeriesVisibleInLegend(boolean visible)
      Sets the default visibility in the legend and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      visible - the flag.
      See Also:
    • setDefaultSeriesVisibleInLegend

      void setDefaultSeriesVisibleInLegend(boolean visible, boolean notify)
      Sets the default visibility in the legend and, if requested, sends a RendererChangeEvent to all registered listeners.
      Parameters:
      visible - the visibility.
      notify - notify listeners?
      See Also:
    • getItemPaint

      Paint getItemPaint(int row, int column)
      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

      Paint getSeriesPaint(int series)
      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

      void setSeriesPaint(int series, Paint paint)
      Sets the paint used for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      paint - the paint (null permitted).
      See Also:
    • setSeriesPaint

      void setSeriesPaint(int series, Paint paint, boolean notify)
      Sets the paint used for a series and sends a RendererChangeEvent 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

      Paint getDefaultPaint()
      Returns the default paint.
      Returns:
      The default paint (never null).
      See Also:
    • setDefaultPaint

      void setDefaultPaint(Paint paint)
      Sets the default paint and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null not permitted).
      See Also:
    • setDefaultPaint

      void setDefaultPaint(Paint paint, boolean notify)
      Sets the default paint and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      paint - the paint (null not permitted).
      notify - send a change event?
      See Also:
    • getItemFillPaint

      Paint getItemFillPaint(int row, int column)
      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

      Paint getSeriesFillPaint(int series)
      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

      void setSeriesFillPaint(int series, Paint paint)
      Sets the paint used for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      paint - the paint (null permitted).
    • setSeriesFillPaint

      void setSeriesFillPaint(int series, Paint paint, boolean notify)
      Sets the paint used for a series and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      series - the series index (zero-based).
      paint - the paint (null permitted).
      notify - send a change event?
    • getDefaultFillPaint

      Paint getDefaultFillPaint()
      Returns the default paint.
      Returns:
      The default paint (never null).
    • setDefaultFillPaint

      void setDefaultFillPaint(Paint paint)
      Sets the default paint and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null not permitted).
    • setDefaultFillPaint

      void setDefaultFillPaint(Paint paint, boolean notify)
      Sets the default paint and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      paint - the paint (null not permitted).
      notify - send a change event?
    • getItemOutlinePaint

      Paint getItemOutlinePaint(int row, int column)
      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

      Paint getSeriesOutlinePaint(int series)
      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

      void setSeriesOutlinePaint(int series, Paint paint)
      Sets the paint used for a series outline and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      paint - the paint (null permitted).
      See Also:
    • setSeriesOutlinePaint

      void setSeriesOutlinePaint(int series, Paint paint, boolean notify)
      Sets the paint used for a series outline and sends a RendererChangeEvent 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

      Paint getDefaultOutlinePaint()
      Returns the default outline paint.
      Returns:
      The paint (never null).
      See Also:
    • setDefaultOutlinePaint

      void setDefaultOutlinePaint(Paint paint)
      Sets the default outline paint and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null not permitted).
      See Also:
    • setDefaultOutlinePaint

      void setDefaultOutlinePaint(Paint paint, boolean notify)
      Sets the default outline paint and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      paint - the paint (null not permitted).
      notify - send a change event?
      See Also:
    • getItemStroke

      Stroke getItemStroke(int row, int column)
      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

      Stroke getSeriesStroke(int series)
      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

      void setSeriesStroke(int series, Stroke stroke)
      Sets the stroke used for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      stroke - the stroke (null permitted).
      See Also:
    • setSeriesStroke

      void setSeriesStroke(int series, Stroke stroke, boolean notify)
      Sets the stroke used for a series and sends a RendererChangeEvent 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

      Stroke getDefaultStroke()
      Returns the default stroke.
      Returns:
      The default stroke (never null).
      See Also:
    • setDefaultStroke

      void setDefaultStroke(Stroke stroke)
      Sets the default stroke and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      stroke - the stroke (null not permitted).
      See Also:
    • setDefaultStroke

      void setDefaultStroke(Stroke stroke, boolean notify)
      Sets the default stroke and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      stroke - the stroke (null not permitted).
      notify - send a change event?
      See Also:
    • getItemOutlineStroke

      Stroke getItemOutlineStroke(int row, int column)
      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

      Stroke getSeriesOutlineStroke(int series)
      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

      void setSeriesOutlineStroke(int series, Stroke stroke)
      Sets the outline stroke used for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      stroke - the stroke (null permitted).
      See Also:
    • setSeriesOutlineStroke

      void setSeriesOutlineStroke(int series, Stroke stroke, boolean notify)
      Sets the outline stroke used for a series and sends a RendererChangeEvent 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

      Stroke getDefaultOutlineStroke()
      Returns the default outline stroke.
      Returns:
      The stroke (never null).
      See Also:
    • setDefaultOutlineStroke

      void setDefaultOutlineStroke(Stroke stroke)
      Sets the base outline stroke and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      stroke - the stroke (null not permitted).
      See Also:
    • setDefaultOutlineStroke

      void setDefaultOutlineStroke(Stroke stroke, boolean notify)
      Sets the base outline stroke and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      stroke - the stroke (null not permitted).
      notify - send a change event.
      See Also:
    • getItemShape

      Shape getItemShape(int row, int column)
      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

      Shape getSeriesShape(int series)
      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

      void setSeriesShape(int series, Shape shape)
      Sets the shape used for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      shape - the shape (null permitted).
      See Also:
    • setSeriesShape

      void setSeriesShape(int series, Shape shape, boolean notify)
      Sets the shape used for a series and sends a RendererChangeEvent 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

      Shape getDefaultShape()
      Returns the default shape.
      Returns:
      The shape (never null).
      See Also:
    • setDefaultShape

      void setDefaultShape(Shape shape)
      Sets the default shape and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      shape - the shape (null not permitted).
      See Also:
    • setDefaultShape

      void setDefaultShape(Shape shape, boolean notify)
      Sets the default shape and sends a RendererChangeEvent to all registered listeners if requested.
      Parameters:
      shape - the shape (null not permitted).
      notify - send a change event?
      See Also:
    • getLegendItem

      LegendItem getLegendItem(int datasetIndex, int series)
      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

      XYSeriesLabelGenerator getLegendItemLabelGenerator()
      Returns the legend item label generator.
      Returns:
      The legend item label generator (never null).
      See Also:
    • setLegendItemLabelGenerator

      void setLegendItemLabelGenerator(XYSeriesLabelGenerator generator)
      Sets the legend item label generator and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      generator - the generator (null not permitted).
    • getToolTipGenerator

      XYToolTipGenerator getToolTipGenerator(int row, int column)
      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

      XYToolTipGenerator getSeriesToolTipGenerator(int series)
      Returns the tool tip generator for a series.
      Parameters:
      series - the series index (zero based).
      Returns:
      The generator (possibly null).
      See Also:
    • setSeriesToolTipGenerator

      void setSeriesToolTipGenerator(int series, XYToolTipGenerator generator)
      Sets the tool tip generator for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero based).
      generator - the generator (null permitted).
      See Also:
    • getDefaultToolTipGenerator

      XYToolTipGenerator getDefaultToolTipGenerator()
      Returns the default tool tip generator.
      Returns:
      The generator (possibly null).
      See Also:
    • setDefaultToolTipGenerator

      void setDefaultToolTipGenerator(XYToolTipGenerator generator)
      Sets the default tool tip generator and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      generator - the generator (null permitted).
      See Also:
    • getURLGenerator

      XYURLGenerator getURLGenerator()
      Returns the URL generator for HTML image maps.
      Returns:
      The URL generator (possibly null).
    • setURLGenerator

      void setURLGenerator(XYURLGenerator urlGenerator)
      Sets the URL generator for HTML image maps.
      Parameters:
      urlGenerator - the URL generator (null permitted).
    • isItemLabelVisible

      boolean isItemLabelVisible(int row, int column)
      Returns true if an item label is visible, and false otherwise.
      Parameters:
      row - the row index (zero-based).
      column - the column index (zero-based).
      Returns:
      A boolean.
    • isSeriesItemLabelsVisible

      boolean isSeriesItemLabelsVisible(int series)
      Returns true if the item labels for a series are visible, and false otherwise.
      Parameters:
      series - the series index (zero-based).
      Returns:
      A boolean.
    • setSeriesItemLabelsVisible

      void setSeriesItemLabelsVisible(int series, boolean visible)
      Sets a flag that controls the visibility of the item labels for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      visible - the flag.
      See Also:
    • setSeriesItemLabelsVisible

      void setSeriesItemLabelsVisible(int series, Boolean visible)
      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

      void setSeriesItemLabelsVisible(int series, Boolean visible, boolean notify)
      Sets the visibility of item labels for a series and, if requested, sends a RendererChangeEvent 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

      void setDefaultItemLabelsVisible(boolean visible)
      Sets the default flag that controls whether or not item labels are visible.
      Parameters:
      visible - the flag.
      See Also:
    • setDefaultItemLabelsVisible

      void setDefaultItemLabelsVisible(boolean visible, boolean notify)
      Sets the default visibility for item labels and, if requested, sends a RendererChangeEvent to all registered listeners.
      Parameters:
      visible - the visibility flag.
      notify - a flag that controls whether or not listeners are notified.
      See Also:
    • getItemLabelGenerator

      XYItemLabelGenerator getItemLabelGenerator(int row, int column)
      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

      XYItemLabelGenerator getSeriesItemLabelGenerator(int series)
      Returns the item label generator for a series.
      Parameters:
      series - the series index (zero based).
      Returns:
      The generator (possibly null).
      See Also:
    • setSeriesItemLabelGenerator

      void setSeriesItemLabelGenerator(int series, XYItemLabelGenerator generator)
      Sets the item label generator for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero based).
      generator - the generator (null permitted).
      See Also:
    • getDefaultItemLabelGenerator

      XYItemLabelGenerator getDefaultItemLabelGenerator()
      Returns the default item label generator.
      Returns:
      The generator (possibly null).
      See Also:
    • setDefaultItemLabelGenerator

      void setDefaultItemLabelGenerator(XYItemLabelGenerator generator)
      Sets the default item label generator and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      generator - the generator (null permitted).
      See Also:
    • getItemLabelFont

      Font getItemLabelFont(int row, int column)
      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

      Font getSeriesItemLabelFont(int series)
      Returns the font for all the item labels in a series.
      Parameters:
      series - the series index (zero-based).
      Returns:
      The font (possibly null).
    • setSeriesItemLabelFont

      void setSeriesItemLabelFont(int series, Font font)
      Sets the item label font for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      font - the font (null permitted).
      See Also:
    • getDefaultItemLabelFont

      Font 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

      void setDefaultItemLabelFont(Font font)
      Sets the default item label font and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      font - the font (null not permitted).
      See Also:
    • getItemLabelPaint

      Paint getItemLabelPaint(int row, int column)
      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

      Paint getSeriesItemLabelPaint(int series)
      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

      void setSeriesItemLabelPaint(int series, Paint paint)
      Sets the item label paint for a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series (zero based index).
      paint - the paint (null permitted).
      See Also:
    • getDefaultItemLabelPaint

      Paint getDefaultItemLabelPaint()
      Returns the default item label paint.
      Returns:
      The paint (never null).
    • setDefaultItemLabelPaint

      void setDefaultItemLabelPaint(Paint paint)
      Sets the default item label paint and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null not permitted).
    • getPositiveItemLabelPosition

      ItemLabelPosition getPositiveItemLabelPosition(int row, int column)
      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

      ItemLabelPosition getSeriesPositiveItemLabelPosition(int series)
      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

      void setSeriesPositiveItemLabelPosition(int series, ItemLabelPosition position)
      Sets the item label position for all positive values in a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      position - the position (null permitted).
    • setSeriesPositiveItemLabelPosition

      void setSeriesPositiveItemLabelPosition(int series, ItemLabelPosition position, boolean notify)
      Sets the item label position for all positive values in a series and (if requested) sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      position - the position (null permitted).
      notify - notify registered listeners?
    • getDefaultPositiveItemLabelPosition

      ItemLabelPosition getDefaultPositiveItemLabelPosition()
      Returns the default positive item label position.
      Returns:
      The position (never null).
    • setDefaultPositiveItemLabelPosition

      void setDefaultPositiveItemLabelPosition(ItemLabelPosition position)
      Sets the default positive item label position.
      Parameters:
      position - the position (null not permitted).
    • setDefaultPositiveItemLabelPosition

      void setDefaultPositiveItemLabelPosition(ItemLabelPosition position, boolean notify)
      Sets the default positive item label position and, if requested, sends a RendererChangeEvent to all registered listeners.
      Parameters:
      position - the position (null not permitted).
      notify - notify registered listeners?
    • getNegativeItemLabelPosition

      ItemLabelPosition getNegativeItemLabelPosition(int row, int column)
      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

      ItemLabelPosition getSeriesNegativeItemLabelPosition(int series)
      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

      void setSeriesNegativeItemLabelPosition(int series, ItemLabelPosition position)
      Sets the item label position for negative values in a series and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      position - the position (null permitted).
    • setSeriesNegativeItemLabelPosition

      void setSeriesNegativeItemLabelPosition(int series, ItemLabelPosition position, boolean notify)
      Sets the item label position for negative values in a series and (if requested) sends a RendererChangeEvent to all registered listeners.
      Parameters:
      series - the series index (zero-based).
      position - the position (null permitted).
      notify - notify registered listeners?
    • getDefaultNegativeItemLabelPosition

      ItemLabelPosition getDefaultNegativeItemLabelPosition()
      Returns the default item label position for negative values.
      Returns:
      The position (never null).
    • setDefaultNegativeItemLabelPosition

      void setDefaultNegativeItemLabelPosition(ItemLabelPosition position)
      Sets the default item label position for negative values and sends a RendererChangeEvent to all registered listeners.
      Parameters:
      position - the position (null not permitted).
    • setDefaultNegativeItemLabelPosition

      void setDefaultNegativeItemLabelPosition(ItemLabelPosition position, boolean notify)
      Sets the default negative item label position and, if requested, sends a RendererChangeEvent to all registered listeners.
      Parameters:
      position - the position (null not permitted).
      notify - notify registered listeners?
    • getItemCreateEntity

      boolean getItemCreateEntity(int series, int item)
      Returns true if an entity should be created for an item, and false otherwise.
      Parameters:
      series - the series.
      item - the item.
      Returns:
      A boolean.
    • getSeriesCreateEntities

      Boolean getSeriesCreateEntities(int series)
      Returns true if entities should be created for a series, and false otherwise. This method can return null in which case the renderering framework will look at the default setting.
      Parameters:
      series - the series.
      Returns:
      A boolean.
    • setSeriesCreateEntities

      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.
      Parameters:
      series - the series.
      create - the flag value (null permitted).
    • setSeriesCreateEntities

      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.
      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

      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.
      Parameters:
      create - the flag value.
    • setDefaultCreateEntities

      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.
      Parameters:
      create - the flag value.
      notify - notify listeners?
    • addAnnotation

      void addAnnotation(XYAnnotation annotation)
      Adds an annotation and sends a RendererChangeEvent to all registered listeners. The annotation is added to the foreground layer.
      Parameters:
      annotation - the annotation (null not permitted).
    • addAnnotation

      void addAnnotation(XYAnnotation annotation, Layer layer)
      Adds an annotation to the specified layer.
      Parameters:
      annotation - the annotation (null not permitted).
      layer - the layer (null not permitted).
    • removeAnnotation

      boolean removeAnnotation(XYAnnotation annotation)
      Removes the specified annotation and sends a RendererChangeEvent 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 a RendererChangeEvent 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 specified marker 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.