info.monitorenter.gui.chart.axis
Class AAxisTransformation

java.lang.Object
  info.monitorenter.gui.chart.axis.AAxis
      info.monitorenter.gui.chart.axis.AAxisTransformation

All Implemented Interfaces:

IAxis, PropertyChangeListener, Serializable, EventListener

Direct Known Subclasses:

AxisLog10, AxisLogE

public abstract class AAxisTransformation
extends AAxis

Base class for Axis implementations that transform the scale for changed display.

Version:

$Revision: 1.22 $

Author:

Achim Westermann

See Also:

Serialized Form

Nested Class Summary

class	AAxisTransformation.XDataAccessor An accessor for the x axis of a chart.
class	AAxisTransformation.YDataAccessor Accesses the y axis of the Chart2D.

Nested classes/interfaces inherited from class info.monitorenter.gui.chart.axis.AAxis

AAxis.AChart2DDataAccessor

Field Summary

Fields inherited from class info.monitorenter.gui.chart.axis.AAxis

m_accessor, m_formatter, m_majorTickSpacing, m_minorTickSpacing, m_power

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

PROPERTY_LABELFORMATTER, PROPERTY_PAINTGRID, PROPERTY_RANGEPOLICY, PROPERTY_TITLE, PROPERTY_TITLEFONT, PROPERTY_TITLEPAINTER

Constructor Summary

AAxisTransformation()
Creates a default instance that will use a LabelFormatterAutoUnits for formatting labels.

AAxisTransformation(IAxisLabelFormatter formatter)
Creates an instance that will the given label formatter for formatting labels.

Method Summary

protected AAxis.AChart2DDataAccessor	createAccessor(Chart2D chart, int dimension) Template method to create the proper AAxis.AChart2DDataAccessor implementation.
double	getMax() The maximum value access method for the Axis this instance is aggregated to.
double	getMin() Returns the minimum value access method for the Axis this instance is aggregated to.
double	getScaledValue(double absolute) Deprecated. replaced by AAxis.scaleTrace(ITrace2D)
protected abstract double	transform(double in) Template method for performing the axis transformation.
double	translateMousePosition(MouseEvent mouseEvent) Returns the translation of the mouse event coordinates of the given mouse event to the value within the chart for the dimension (x,y) covered by this axis.
double	translatePxToValue(int pixel) Transforms the given pixel value (which has to be a awt value like MouseEvent.getY() into the chart value.
protected abstract double	untransform(double in) Template method for performing the reverse axis transformation.

Methods inherited from class info.monitorenter.gui.chart.axis.AAxis

addPropertyChangeListener, addTrace, getAccessor, getDimension, getFormatter, getHeight, getLabels, getMajorTickSpacing, getMinorTickSpacing, getPropertyChangeListeners, getRange, getRangePolicy, getScaleValues, getTitle, getTitlePainter, getValueDistanceForPixel, getWidth, initPaintIteration, isPaintGrid, isPaintScale, isStartMajorTick, paintTitle, propertyChange, removePropertyChangeListener, removeTrace, replace, roundToTicks, scale, scaleTrace, setAccessor, setChart, setFormatter, setMajorTickSpacing, setMinorTickSpacing, setPaintGrid, setPaintScale, setRange, setRangePolicy, setStartMajorTick, setTitle, setTitlePainter, translateValueToPx

Methods inherited from class java.lang.Object

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

Constructor Detail

AAxisTransformation

public AAxisTransformation()

Creates a default instance that will use a LabelFormatterAutoUnits for formatting labels.

AAxisTransformation

public AAxisTransformation(IAxisLabelFormatter formatter)

Creates an instance that will the given label formatter for formatting labels.

Parameters:

formatter - needed for formatting labels of this axis.

Method Detail

createAccessor

protected AAxis.AChart2DDataAccessor createAccessor(Chart2D chart,
                                                    int dimension)

Description copied from class: AAxis

Template method to create the proper AAxis.AChart2DDataAccessor implementation.

Specified by:

createAccessor in class AAxis

Parameters:

chart - the chart to access.

dimension - Chart2D.X or Chart2D.Y.

Returns:

the proper AAxis.AChart2DDataAccessor implementation.

See Also:

AAxis.createAccessor(info.monitorenter.gui.chart.Chart2D, int)

getMax

public double getMax()

Description copied from class: AAxis

The maximum value access method for the Axis this instance is aggregated to.

It supports the retrieval of data from the corrcet dimension of the connected Chart2 (X or Y) as well as the respect to the configured IRangePolicy.

Overrides:

getMax in class AAxis

Returns:

the maximum value access method for the Axis this instance is aggregated to.

See Also:

AAxis.getMax()

getMin

public double getMin()

Description copied from class: AAxis

Returns the minimum value access method for the Axis this instance is aggregated to.

It supports the retrieval of data from the corrcet dimension of the connected Chart2 (X or Y) as well as the respect to the configured IRangePolicy.

Overrides:

getMin in class AAxis

Returns:

the minimum value access method for the Axis this instance is aggregated to.

See Also:

AAxis.getMin()

getScaledValue

public final double getScaledValue(double absolute)

Deprecated. replaced by AAxis.scaleTrace(ITrace2D)

Description copied from interface: IAxis

Scales the given absolute value into a value between 0 and 1.0 (if it is in the range of the data).

If the given absolute value is not in the display- range of the Chart2D, negative values or values greater than 1.0 may result.

Parameters:

absolute - a value in the real value range of the corresponding chart.

Returns:

a value between 0.0 and 1.0 that is mapped to a position within the chart.

See Also:

IAxis.getScaledValue(double)

transform

protected abstract double transform(double in)
                             throws IllegalArgumentException

Template method for performing the axis transformation.

The argument should not be negative, so only normalized values (no chart values but their scaled values or pixel values) should be given here.

Parameters:

in - the value to transform.

Returns:

the transformed value.

Throws:

IllegalArgumentException - if scaling is impossible (due to some mathematical transformation in implementations like AxisLog10

translateMousePosition

public final double translateMousePosition(MouseEvent mouseEvent)
                                    throws IllegalArgumentException

Description copied from class: AAxis

Returns the translation of the mouse event coordinates of the given mouse event to the value within the chart for the dimension (x,y) covered by this axis.

Note that the mouse event has to be an event fired on the correspondinig chart component!

Overrides:

translateMousePosition in class AAxis

Parameters:

mouseEvent - a mouse event that has been fired on this component.

Returns:

the translation of the mouse event coordinates of the given mouse event to the value within the chart for the dimension covered by this axis (x or y) or null if no calculations could be performed as the chart was not painted before.

Throws:

IllegalArgumentException - if the given mouse event is out of the current graphics context (not a mouse event of the chart component).

See Also:

AAxis.translateMousePosition(java.awt.event.MouseEvent)

translatePxToValue

public double translatePxToValue(int pixel)

Description copied from interface: IAxis

Transforms the given pixel value (which has to be a awt value like MouseEvent.getY() into the chart value.

Internal use only, the interface does not guarantee that the pixel corresponds to any valid awt pixel value within the chart component.

Specified by:

translatePxToValue in interface IAxis

Overrides:

translatePxToValue in class AAxis

Parameters:

pixel - a pixel value of the chart component as used by awt.

Returns:

the awt pixel value transformed to the chart value.

See Also:

AAxis.translatePxToValue(int)

untransform

protected abstract double untransform(double in)

Template method for performing the reverse axis transformation.

This is the counterpart to transform(double).

Parameters:

in - the transformed value.

Returns:

the normal value;