Module platform

Class PaintScaleLegend

All Implemented Interfaces:
Serializable, Cloneable, EventListener, Block, AxisChangeListener, Drawable, PublicCloneable

public class PaintScaleLegend extends Title implements AxisChangeListener, PublicCloneable
A legend that shows a range of values and their associated colors, driven by an underlying PaintScale implementation.
See Also:
  • Constructor Details

    • PaintScaleLegend

      public PaintScaleLegend(PaintScale scale, ValueAxis axis)
      Creates a new instance.
      Parameters:
      scale - the scale (null not permitted).
      axis - the axis (null not permitted).
  • Method Details

    • getScale

      public PaintScale getScale()
      Returns the scale used to convert values to colors.
      Returns:
      The scale (never null).
      See Also:
    • setScale

      public void setScale(PaintScale scale)
      Sets the scale and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      scale - the scale (null not permitted).
      See Also:
    • getAxis

      public ValueAxis getAxis()
      Returns the axis for the paint scale.
      Returns:
      The axis (never null).
      See Also:
    • setAxis

      public void setAxis(ValueAxis axis)
      Sets the axis for the paint scale and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      axis - the axis (null not permitted).
      See Also:
    • getAxisLocation

      public AxisLocation getAxisLocation()
      Returns the axis location.
      Returns:
      The axis location (never null).
      See Also:
    • setAxisLocation

      public void setAxisLocation(AxisLocation location)
      Sets the axis location and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      location - the location (null not permitted).
      See Also:
    • getAxisOffset

      public double getAxisOffset()
      Returns the offset between the axis and the paint strip.
      Returns:
      The offset between the axis and the paint strip.
      See Also:
    • setAxisOffset

      public void setAxisOffset(double offset)
      Sets the offset between the axis and the paint strip and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      offset - the offset.
    • getStripWidth

      public double getStripWidth()
      Returns the width of the paint strip, in Java2D units.
      Returns:
      The width of the paint strip.
      See Also:
    • setStripWidth

      public void setStripWidth(double width)
      Sets the width of the paint strip and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      width - the width.
      See Also:
    • isStripOutlineVisible

      public boolean isStripOutlineVisible()
      Returns the flag that controls whether or not an outline is drawn around the paint strip.
      Returns:
      A boolean.
      See Also:
    • setStripOutlineVisible

      public void setStripOutlineVisible(boolean visible)
      Sets the flag that controls whether or not an outline is drawn around the paint strip, and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      visible - the flag.
      See Also:
    • getStripOutlinePaint

      public Paint getStripOutlinePaint()
      Returns the paint used to draw the outline of the paint strip.
      Returns:
      The paint (never null).
      See Also:
    • setStripOutlinePaint

      public void setStripOutlinePaint(Paint paint)
      Sets the paint used to draw the outline of the paint strip, and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null not permitted).
      See Also:
    • getStripOutlineStroke

      public Stroke getStripOutlineStroke()
      Returns the stroke used to draw the outline around the paint strip.
      Returns:
      The stroke (never null).
      See Also:
    • setStripOutlineStroke

      public void setStripOutlineStroke(Stroke stroke)
      Sets the stroke used to draw the outline around the paint strip and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      stroke - the stroke (null not permitted).
      See Also:
    • getBackgroundPaint

      public Paint getBackgroundPaint()
      Returns the background paint.
      Returns:
      The background paint.
    • setBackgroundPaint

      public void setBackgroundPaint(Paint paint)
      Sets the background paint and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      paint - the paint (null permitted).
    • getSubdivisionCount

      public int getSubdivisionCount()
      Returns the number of subdivisions used to draw the scale.
      Returns:
      The subdivision count.
    • setSubdivisionCount

      public void setSubdivisionCount(int count)
      Sets the subdivision count and sends a TitleChangeEvent to all registered listeners.
      Parameters:
      count - the count.
    • axisChanged

      public void axisChanged(AxisChangeEvent event)
      Receives notification of an axis change event and responds by firing a title change event.
      Specified by:
      axisChanged in interface AxisChangeListener
      Parameters:
      event - the event.
    • arrange

      public Size2D arrange(Graphics2D g2, RectangleConstraint constraint)
      Arranges the contents of the block, within the given constraints, and returns the block size.
      Specified by:
      arrange in interface Block
      Overrides:
      arrange in class AbstractBlock
      Parameters:
      g2 - the graphics device.
      constraint - the constraint (null not permitted).
      Returns:
      The block size (in Java2D units, never null).
    • arrangeRR

      protected Size2D arrangeRR(Graphics2D g2, Range widthRange, Range heightRange)
      Returns the content size for the title. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated 90 degrees.
      Parameters:
      g2 - the graphics device.
      widthRange - the width range.
      heightRange - the height range.
      Returns:
      The content size.
    • draw

      public void draw(Graphics2D g2, Rectangle2D area)
      Draws the legend within the specified area.
      Specified by:
      draw in interface Drawable
      Specified by:
      draw in class Title
      Parameters:
      g2 - the graphics target (null not permitted).
      area - the drawing area (null not permitted).
    • draw

      public Object draw(Graphics2D g2, Rectangle2D area, Object params)
      Draws the legend within the specified area.
      Specified by:
      draw in interface Block
      Parameters:
      g2 - the graphics target (null not permitted).
      area - the drawing area (null not permitted).
      params - drawing parameters (ignored here).
      Returns:
      null.
    • equals

      public boolean equals(Object obj)
      Tests this legend for equality with an arbitrary object.
      Overrides:
      equals in class Title
      Parameters:
      obj - the object (null permitted).
      Returns:
      A boolean.