info.monitorenter.gui.chart.traces.painters

Class TracePainterConfigurable<T extends IPointPainterConfigurableUI<T>>

java.lang.Object

info.monitorenter.gui.chart.traces.painters.ATracePainter

info.monitorenter.gui.chart.traces.painters.TracePainterConfigurable<T>

Type Parameters:

T - needed for comparable.

All Implemented Interfaces:

IPointPainter<ATracePainter>, ITracePainter<ATracePainter>, Serializable, Comparable<ATracePainter>

Direct Known Subclasses:

TracePainterDisc, TracePainterLine, TracePainterVerticalBar

public class TracePainterConfigurable<T extends IPointPainterConfigurableUI<T>>
extends ATracePainter

An ITracePainter implementation that works on a given IPointPainter. It is configurable by using the point painter to paint the trace (wrapper / delegate).

Configure painting by first calling: getPointPainter() and then: IPointPainterConfigurableUI.setColor(java.awt.Color), IPointPainterConfigurableUI.setColorFill(java.awt.Color) and IPointPainterConfigurableUI.setStroke(java.awt.Stroke) .

Version:

$Revision: 1.14 $

Author:

Achim Westermann

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected T	m_pointPainter The implementation for rendering the point as a disc.

Constructor Summary

Constructors

Constructor and Description
TracePainterConfigurable(T pointPainter) Creates an instance that works with the given point painter.

Method Summary

Modifier and Type	Method and Description
double	calculateMaxX(ITracePoint2D point) Returns the maximum x bound this painter will need to paint the given point.
double	calculateMaxY(ITracePoint2D point) Returns the maximum y bound this painter will need to paint the given point.
double	calculateMinX(ITracePoint2D point) Returns the minimum x bound this painter will need to paint the given point.
double	calculateMinY(ITracePoint2D point) Returns the minimum y bound this painter will need to paint the given point.
int	compareTo(T o)
void	endPaintIteration(Graphics g2d) Invoked to inform implementations that a paint iteration ends for the corresponding ITrace2D.
boolean	equals(Object obj)
T	getPointPainter() Returns the pointPainter.
int	hashCode()
boolean	isAdditionalSpaceRequiredX() Return true if this point painter needs more space in x dimension than TracePoint2D.getX().
boolean	isAdditionalSpaceRequiredY() Return true if this point painter needs more space in y dimension than TracePoint2D.getY().
boolean	isPixelTransformationNeededX() Return true if rendering in x dimension requires a transformation from pixel to value domain.
boolean	isPixelTransformationNeededY() Return true if rendering in y dimension requires a transformation from pixel to value domain.
void	paintPoint(int absoluteX, int absoluteY, int nextX, int nextY, Graphics g, ITracePoint2D original) Paint the point given by absolute coordinates on the given graphic context.
void	startPaintIteration(Graphics g2d) Invoked to inform implementations that a paint iteration starts for the corresponding ITrace2D.

Methods inherited from class info.monitorenter.gui.chart.traces.painters.ATracePainter

compareTo, discontinue, getPreviousPoint, getPreviousX, getPreviousY

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_pointPainter

protected final T extends IPointPainterConfigurableUI<T> m_pointPainter

The implementation for rendering the point as a disc.

Constructor Detail

TracePainterConfigurable

public TracePainterConfigurable(T pointPainter)

Creates an instance that works with the given point painter.

Parameters:

pointPainter - the point painter to use.

Method Detail

calculateMaxX

public final double calculateMaxX(ITracePoint2D point)

Description copied from interface: IPointPainter

Returns the maximum x bound this painter will need to paint the given point.

This is needed because a point's bounds may be exceeded when actually painting it.

Parameters:

point - the point to draw.

Returns:

the maximum x bound this painter will need to paint the given point.

See Also:

IPointPainter.calculateMaxX(info.monitorenter.gui.chart.ITracePoint2D)

calculateMaxY

public final double calculateMaxY(ITracePoint2D point)

Description copied from interface: IPointPainter

Returns the maximum y bound this painter will need to paint the given point.

This is needed because a point's bounds may be exceeded when actually painting it.

Parameters:

point - the point to draw.

Returns:

the maximum y bound this painter will need to paint the given point.

See Also:

IPointPainter.calculateMaxY(info.monitorenter.gui.chart.ITracePoint2D)

calculateMinX

public final double calculateMinX(ITracePoint2D point)

Description copied from interface: IPointPainter

Returns the minimum x bound this painter will need to paint the given point.

This is needed because a point's bounds may be exceeded when actually painting it.

Parameters:

point - the point to draw.

Returns:

the minimum x bound this painter will need to paint the given point.

See Also:

IPointPainter.calculateMinX(info.monitorenter.gui.chart.ITracePoint2D)

calculateMinY

public final double calculateMinY(ITracePoint2D point)

Description copied from interface: IPointPainter

Returns the minimum y bound this painter will need to paint the given point.

This is needed because a point's bounds may be exceeded when actually painting it.

Parameters:

point - the point to draw.

Returns:

the minimum y bound this painter will need to paint the given point.

See Also:

IPointPainter.calculateMinY(info.monitorenter.gui.chart.ITracePoint2D)

compareTo

public final int compareTo(T o)

Parameters:

o - the instance to compare oneself to.

Returns:

see super.

See Also:

Comparable.compareTo(java.lang.Object)

endPaintIteration

public final void endPaintIteration(Graphics g2d)

Description copied from interface: IPointPainter

Invoked to inform implementations that a paint iteration ends for the corresponding ITrace2D.

Specified by:

endPaintIteration in interface IPointPainter<ATracePainter>

Overrides:

endPaintIteration in class ATracePainter

Parameters:

g2d - provided in case pending paint operations have to be performed.

See Also:

IPointPainter.endPaintIteration(java.awt.Graphics)

equals

public boolean equals(Object obj)

Overrides:

equals in class ATracePainter

See Also:

Object.equals(java.lang.Object)

getPointPainter

public T getPointPainter()

Returns the pointPainter.

Returns:

the pointPainter

hashCode

public int hashCode()

Overrides:

hashCode in class ATracePainter

See Also:

Object.hashCode()

isAdditionalSpaceRequiredX

public boolean isAdditionalSpaceRequiredX()

Description copied from interface: IPointPainter

Return true if this point painter needs more space in x dimension than TracePoint2D.getX().

Returns:

true if this point painter needs more space in x dimension than TracePoint2D.getX().

See Also:

IPointPainter.isAdditionalSpaceRequiredX()

isAdditionalSpaceRequiredY

public boolean isAdditionalSpaceRequiredY()

Description copied from interface: IPointPainter

Return true if this point painter needs more space in y dimension than TracePoint2D.getY().

Returns:

true if this point painter needs more space in y dimension than TracePoint2D.getY().

See Also:

IPointPainter.isAdditionalSpaceRequiredY()

isPixelTransformationNeededX

public final boolean isPixelTransformationNeededX()

Description copied from interface: IPointPainter

Return true if rendering in x dimension requires a transformation from pixel to value domain.

If this is the case min-max - search of the trace is much slower (points * 2 * amount of painters).

Returns:

true if rendering in x dimension requires a transformation from pixel to value domain.

See Also:

IPointPainter.isPixelTransformationNeededX()

isPixelTransformationNeededY

public final boolean isPixelTransformationNeededY()

Description copied from interface: IPointPainter

Return true if rendering in y dimension requires a transformation from pixel to value domain.

If this is the case min-max - search of the trace is much slower (points * 2 * amount of painters).

Returns:

true if rendering in y dimension requires a transformation from pixel to value domain.

See Also:

IPointPainter.isPixelTransformationNeededY()

paintPoint

public void paintPoint(int absoluteX,
                       int absoluteY,
                       int nextX,
                       int nextY,
                       Graphics g,
                       ITracePoint2D original)

Description copied from interface: IPointPainter

Paint the point given by absolute coordinates on the given graphic context.

The next coordinates are also provided to allow to check how much distance is available for the graphic representation of the current point.

Specified by:

paintPoint in interface IPointPainter<ATracePainter>

Overrides:

paintPoint in class ATracePainter

Parameters:

absoluteX - the ready to use x value for the point to paint.

absoluteY - the ready to use y value for the point to paint.

nextX - the ready to use next x value for the point to paint.

nextY - the ready to use next y value for the point to paint.

g - the graphic context to paint on.

original - just for information, for painting this should be irrelevant and it should not be changed too!

See Also:

ATracePainter.paintPoint(int, int, int, int, java.awt.Graphics, info.monitorenter.gui.chart.ITracePoint2D)

startPaintIteration

public final void startPaintIteration(Graphics g2d)

Description copied from interface: IPointPainter

Invoked to inform implementations that a paint iteration starts for the corresponding ITrace2D.

Specified by:

startPaintIteration in interface IPointPainter<ATracePainter>

Overrides:

startPaintIteration in class ATracePainter

Parameters:

g2d - provided in case pending paint operations have to be performed.

See Also:

ATracePainter.startPaintIteration(java.awt.Graphics)