info.monitorenter.gui.chart.traces

Class Trace2DSimple

java.lang.Object

info.monitorenter.gui.chart.traces.ATrace2D

info.monitorenter.gui.chart.traces.Trace2DSimple

All Implemented Interfaces:

ITrace2D, ITrace2DDataAccumulating, PropertyChangeListener, Serializable, Comparable<ITrace2D>, EventListener

Direct Known Subclasses:

Trace2DBijective, Trace2DReplacing

public class Trace2DSimple
extends ATrace2D
implements ITrace2D

A basic ITrace2D implementation that stores the internal ITracePoint2D instances in a List.

This class has the following behavior:

• All tracepoints that are added are stored unchanged in a LinkedList.
• All traceoints that are added are added to the end.
• If a tracepoint is inserted whose x - value already exists in the List, it is ok - the old point may remain. (no bijective assigement of X and Y)

Version:

$Revision: 1.16 $

Author:

Achim Westermann

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface info.monitorenter.gui.chart.ITrace2D

ITrace2D.DistancePoint

Field Summary

Fields

Modifier and Type	Field and Description
protected LinkedList<ITracePoint2D>	m_points Internal List <ITracePoint2D>.

Fields inherited from class info.monitorenter.gui.chart.traces.ATrace2D

m_computingTraces, m_maxX, m_maxXErrorBar, m_maxY, m_maxYErrorBar, m_minX, m_minXErrorBar, m_minY, m_minYErrorBar, m_name, m_physicalUnitsX, m_physicalUnitsY, m_propertyChangeSupport, m_renderer

Fields inherited from interface info.monitorenter.gui.chart.ITrace2D

PROPERTY_COLOR, PROPERTY_ERRORBARPOLICY, PROPERTY_ERRORBARPOLICY_CONFIGURATION, PROPERTY_LABEL, PROPERTY_MAX_X, PROPERTY_MAX_Y, PROPERTY_MIN_X, PROPERTY_MIN_Y, PROPERTY_NAME, PROPERTY_PAINTERS, PROPERTY_PHYSICALUNITS, PROPERTY_STROKE, PROPERTY_TRACEPOINT_CHANGED_HIGHLIGHTERS, PROPERTY_TRACEPOINT_CHANGED_LOCATION, PROPERTY_TRACEPOINT_CHANGED_RENDERING, PROPERTY_TRACEPOINTS, PROPERTY_VISIBLE, PROPERTY_ZINDEX, Z_INDEX_MIN, ZINDEX_MAX

Fields inherited from interface info.monitorenter.gui.chart.ITrace2DDataAccumulating

PROPERTY_ACCUMULATION_STRATEGY, PROPERTY_ACCUMULATION_STRATEGY_ACCUMULATION_FUNCTION_CHANGED

Constructor Summary

Constructors

Constructor and Description
Trace2DSimple() Creates an empty trace.
Trace2DSimple(String name) Creates an emtpy trace with the given name.

Method Summary

Modifier and Type	Method and Description
protected boolean	addPointInternal(ITracePoint2D p) Override this template method for the custom add operation that depends on the policies of the implementation.
Iterator<ITracePoint2D>	descendingIterator() Returns an Iterator over the internal ITrace2D instances in reverse order.
int	getMaxSize() Returns the maximum amount of ITracePoint2D instances that may be added.
int	getSize() Returns the amount of ITracePoint2D instances currently contained.
boolean	isEmpty() Returns false if internal ITracePoint2D instances are contained or true if not.
Iterator<ITracePoint2D>	iterator() Returns an Iterator over the internal ITrace2D instances.
protected void	removeAllPointsInternal() Override this template method for the custom remove operation that depends on the Collection used in the implementation.
protected ITracePoint2D	removePointInternal(ITracePoint2D point) Override this template method for the custom remove operation that depends on the internal storage the implementation.

Methods inherited from class info.monitorenter.gui.chart.traces.ATrace2D

addComputingTrace, addErrorBarPolicy, addPoint, addPoint, addPoint, addPointHighlighter, addPropertyChangeListener, addTracePainter, boundSearch, compareTo, containsTracePainter, ensureInitialized, finalize, firePointAdded, firePointChanged, firePointRemoved, firePropertyChange, getAccumulationStrategy, getChangeListeners, getColor, getErrorBarPolicies, getHasErrorBars, getInstanceCount, getLabel, getMaxX, getMaxY, getMinX, getMinY, getName, getNearestPointEuclid, getNearestPointManhattan, getPhysicalUnits, getPhysicalUnitsX, getPhysicalUnitsY, getPointHighlighters, getPropertyChangeListeners, getRenderer, getStroke, getTracePainters, getTracePointProvider, getZIndex, initPaintIteration, isAdditionalSpaceRequired, isPixelTransformationRequired, isVisible, iterator, maxXSearch, maxYSearch, minXSearch, minYSearch, onAdded2ChartBeforeFirstPaint, propertyChange, removeAllPointHighlighters, removeAllPoints, removeComputingTrace, removeErrorBarPolicy, removePoint, removePointHighlighter, removePropertyChangeListener, removePropertyChangeListener, removeTracePainter, setAccumulationStrategy, setColor, setErrorBarPolicy, setName, setPhysicalUnits, setPointHighlighter, setRenderer, setStroke, setTracePainter, setTracePointProvider, setVisible, setZIndex, showsErrorBars, showsNegativeXErrorBars, showsNegativeYErrorBars, showsPositiveXErrorBars, showsPositiveYErrorBars, toString

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface info.monitorenter.gui.chart.ITrace2D

addComputingTrace, addErrorBarPolicy, addPoint, addPoint, addPoint, addPointHighlighter, addPropertyChangeListener, addTracePainter, containsTracePainter, firePointChanged, getColor, getErrorBarPolicies, getHasErrorBars, getLabel, getMaxX, getMaxY, getMinX, getMinY, getName, getNearestPointEuclid, getNearestPointManhattan, getPhysicalUnits, getPhysicalUnitsX, getPhysicalUnitsY, getPointHighlighters, getPropertyChangeListeners, getRenderer, getStroke, getTracePainters, getTracePointProvider, getZIndex, initPaintIteration, isAdditionalSpaceRequired, isPixelTransformationRequired, isVisible, maxXSearch, maxYSearch, minXSearch, minYSearch, onAdded2ChartBeforeFirstPaint, removeAllPointHighlighters, removeAllPoints, removeComputingTrace, removeErrorBarPolicy, removePoint, removePointHighlighter, removePropertyChangeListener, removePropertyChangeListener, removeTracePainter, setColor, setErrorBarPolicy, setName, setPhysicalUnits, setPointHighlighter, setRenderer, setStroke, setTracePainter, setTracePointProvider, setVisible, setZIndex, showsErrorBars, showsNegativeXErrorBars, showsNegativeYErrorBars, showsPositiveXErrorBars, showsPositiveYErrorBars

Methods inherited from interface java.beans.PropertyChangeListener

propertyChange

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

m_points

protected LinkedList<ITracePoint2D> m_points

Internal List <ITracePoint2D>.

Constructor Detail

Trace2DSimple

public Trace2DSimple()

Creates an empty trace.

Trace2DSimple

public Trace2DSimple(String name)

Creates an emtpy trace with the given name.

Parameters:

name - the name that will be displayed below the chart.

Method Detail

addPointInternal

protected boolean addPointInternal(ITracePoint2D p)

Description copied from class: ATrace2D

Override this template method for the custom add operation that depends on the policies of the implementation.

No property change events have to be fired by default. If this method returns true the outer logic of the calling method ATrace2D.addPoint(ITracePoint2D) will perform bound checks for the new point and fire property changes as described in method ATrace2D.firePointChanged(ITracePoint2D, info.monitorenter.gui.chart.ITracePoint2D.STATE, Object, Object) .

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

Specified by:

addPointInternal in class ATrace2D

Parameters:

p - the point to add.

Returns:

true if the given point was accepted or false if not.

See Also:

ATrace2D.addPointInternal(info.monitorenter.gui.chart.ITracePoint2D)

getMaxSize

public final int getMaxSize()

Description copied from interface: ITrace2D

Returns the maximum amount of ITracePoint2D 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 ITracePoint2D instances that may be added.

See Also:

ITrace2D.getMaxSize()

getSize

public final int getSize()

Description copied from interface: ITrace2D

Returns the amount of ITracePoint2D instances currently contained.

Specified by:

getSize in interface ITrace2D

Returns:

The amount of ITracePoint2D instances currently contained.

See Also:

ITrace2D.getSize()

isEmpty

public boolean isEmpty()

Description copied from interface: ITrace2D

Returns false if internal ITracePoint2D instances are contained or true if not.

Specified by:

isEmpty in interface ITrace2D

Returns:

false if internal ITracePoint2D instances are contained or true if not.

See Also:

ITrace2D.isEmpty()

iterator

public Iterator<ITracePoint2D> iterator()

Description copied from interface: ITrace2D

Returns an Iterator over the internal ITrace2D instances.

Implementations should be synchronized. This method is meant to allow modifications of the internal ITracePoint2D 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 ITracePoint2D instances decides how the Chart2D will paint the trace.

Specified by:

iterator in interface ITrace2D

Returns:

an Iterator over the internal ITracePoint2D instances.

See Also:

ITrace2D.iterator()

descendingIterator

public Iterator<ITracePoint2D> descendingIterator()

Description copied from interface: ITrace2D

Returns an Iterator over the internal ITrace2D instances in reverse order.

Implementations should be synchronized. This method is meant to allow modifications of the internal ITracePoint2D 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 ITracePoint2D instances decides how the Chart2D will paint the trace.

Specified by:

descendingIterator in interface ITrace2D

Returns:

an Iterator over the internal ITracePoint2D instances in descending order.

See Also:

ITrace2D.descendingIterator()

removeAllPointsInternal

protected final 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:

ATrace2D.removeAllPointsInternal()

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:

ATrace2D.removePointInternal(info.monitorenter.gui.chart.ITracePoint2D)