Class Trace2DSorted

java.lang.Object
info.monitorenter.gui.chart.traces.ATrace2D
info.monitorenter.gui.chart.traces.Trace2DSorted
All Implemented Interfaces:
ITrace2D, PropertyChangeListener, Serializable, Comparable<ITrace2D>, EventListener
Direct Known Subclasses:
Trace2DLtdSorted

public class Trace2DSorted extends ATrace2D implements ITrace2D
Has the behavior of Trace2DReplacing and additional features.

  • All traceoints added whose x- values are not already contained are added to the internal Tree ordered by growing x-values. Therefore it is guaranteed that the tracepoints will be sorted in ascending order of x- values at any time.

Because sorted insertion of a List causes n! index- operations ( get(int i)) additional to the comparisons this class does not extend Trace2DSimple which uses a List. Instead a TreeSet is used.

Version:
$Revision: 1.15 $
Author:
Achim Westermann
See Also:
  • Field Details

  • Constructor Details

    • Trace2DSorted

      public Trace2DSorted()
      Defcon.

  • Method Details

    • addPointInternal

      protected boolean addPointInternal(ITracePoint2D p)
      In case p has an x- value already contained, the old tracepoint with that value will be replaced by the new one. Else the new tracepoint will be added at an index in order to keep the ascending order of tracepoints with a higher x- value are contained.

      Specified by:
      addPointInternal in class ATrace2D
      Parameters:
      p - the point to add.
      Returns:
      true if the given point was successfully added.
    • getMaxSize

      public int getMaxSize()
      Description copied from interface: ITrace2D

      Returns the maximum amount of TracePoint2D instances that may be added. For implementations that limit the maximum amount this is a reasonable amount. Non-limiting implementations should return Integer.MAX_VALUE. This allows to detect the unlimitedness. Of course no implementation could store that amount of points.

      Specified by:
      getMaxSize in interface ITrace2D
      Returns:
      The maximum amount of TracePoint2D instances that may be added.
      See Also:
    • getSize

      public int getSize()
      Description copied from interface: ITrace2D
      Returns the amount of TracePoint2D instances currently contained.

      Specified by:
      getSize in interface ITrace2D
      Returns:
      The amount of TracePoint2D instances currently contained.
      See Also:
    • isEmpty

      public boolean isEmpty()
      Description copied from interface: ITrace2D
      Returns false if internal TracePoint2D instances are contained or true if not.

      Specified by:
      isEmpty in interface ITrace2D
      Returns:
      false if internal TracePoint2D instances are contained or true if not.
      See Also:
    • iterator

      public Iterator<ITracePoint2D> iterator()
      Description copied from interface: ITrace2D
      Returns an Iterator over the internal TracePoint2D instances.

      Implementations should be synchronized. This method is meant to allow modifications of the intenal TracePoint2D instances, so the original points should be returned.

      There is no guarantee that changes made to the contained tracepoints will be reflected in the display immediately. The order the iterator returns the TracePoint2D instances decides how the Chart2D will paint the trace.

      Specified by:
      iterator in interface ITrace2D
      Returns:
      an Iterator over the internal TracePoint2D instances.
      See Also:
    • removeAllPointsInternal

      protected void removeAllPointsInternal()
      Description copied from class: ATrace2D
      Override this template method for the custom remove operation that depends on the Collection used in the implementation.

      No change events have to be fired, this is done by ATrace2D.

      Specified by:
      removeAllPointsInternal in class ATrace2D
      See Also:
    • removePointInternal

      protected ITracePoint2D removePointInternal(ITracePoint2D point)
      Description copied from class: ATrace2D
      Override this template method for the custom remove operation that depends on the internal storage the implementation.

      The returned point may be the same as the given. But some "computing" traces like Trace2DArithmeticMean will internally delete a different point and return that one.

      No property change events have to be fired by default. If this method returns null the outer logic of the calling method ATrace2D.removePoint(ITracePoint2D) will perform bound checks for the returned point and fire property changes for the properties ITrace2D.PROPERTY_MAX_X, ITrace2D.PROPERTY_MIN_X, ITrace2D.PROPERTY_MAX_Y and ITrace2D.PROPERTY_MIN_Y.

      In special cases - when additional modifications to the internal set of points take place (e.g. a further point get added) this method should return false (regardless whether the old point was really removed or not) and perform bound checks and fire the property changes as mentioned above "manually".

      Specified by:
      removePointInternal in class ATrace2D
      Parameters:
      point - the point to remove.
      Returns:
      null if unsuccessful (and no events should be fired) or the point that actually was removed (in case different than the given one it should be somehow related to the given one).
      See Also: