info.monitorenter.gui.chart.traces.painters

Class TracePainterPolyline

java.lang.Object

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

info.monitorenter.gui.chart.traces.painters.TracePainterPolyline

All Implemented Interfaces:

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

Direct Known Subclasses:

TracePainterFill

public class TracePainterPolyline
extends ATracePainter

A trace painter that increases performance by summing up all points to render for a paint iteration (submitted by paintPoint(int, int, int, int, Graphics, ITracePoint2D) invocations between startPaintIteration(Graphics) and endPaintIteration(Graphics)) and only invoking only one polyline paint for a paint call of the corresponding Chart2D.

Version:

$Revision: 1.22 $

Author:

Achim Westermann

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected List<Integer>	m_xPoints The list of x coordinates collected in one paint iteration.
protected List<Integer>	m_yPoints The list of y coordinates collected in one paint iteration.

Constructor Summary

Constructors

Constructor and Description
TracePainterPolyline() Default Constructor.

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.
protected void	doDrawOperation(Graphics g2d, int[] x, int[] y, int length) Internally invokes the draw operation (to allow subclassing with a different one).
void	endPaintIteration(Graphics g2d) Invoked to inform implementations that a paint iteration ends for the corresponding ITrace2D.
boolean	equals(Object obj)
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_xPoints

protected List<Integer> m_xPoints

The list of x coordinates collected in one paint iteration.

m_yPoints

protected List<Integer> m_yPoints

The list of y coordinates collected in one paint iteration.

Constructor Detail

TracePainterPolyline

public TracePainterPolyline()

Default Constructor.

Method Detail

calculateMaxX

public 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 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 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 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)

doDrawOperation

protected void doDrawOperation(Graphics g2d,
                               int[] x,
                               int[] y,
                               int length)

Internally invokes the draw operation (to allow subclassing with a different one).

This implementation uses Graphics.drawPolyline(int[], int[], int).

endPaintIteration

public 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)

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

IPointPainter.startPaintIteration(java.awt.Graphics)