org.swtchart.internal.axis

Class AxisTickLabels

java.lang.Object

org.swtchart.internal.axis.AxisTickLabels

All Implemented Interfaces:

java.util.EventListener, org.eclipse.swt.events.PaintListener, org.eclipse.swt.internal.SWTEventListener

public class AxisTickLabels
extends java.lang.Object
implements org.eclipse.swt.events.PaintListener

Axis tick labels.

Field Summary

Fields

Modifier and Type	Field and Description
private Axis	axis the axis
private org.eclipse.swt.graphics.Rectangle	bounds the bounds of tick labels area
private Chart	chart the chart
private static java.lang.String	DEFAULT_DECIMAL_FORMAT the default label format
private static org.eclipse.swt.graphics.Font	DEFAULT_FONT the default font
private static int	DEFAULT_FOREGROUND the default foreground
private org.eclipse.swt.graphics.Font	font the font
private org.eclipse.swt.graphics.Color	foreground the foreground color
private java.text.Format	format the format for tick labels
private int	heightHint the height hint of tick labels area
private java.util.Map<java.lang.Integer,java.lang.Integer[]>	possibleTickSteps the possible tick steps
private java.util.ArrayList<java.lang.Integer>	tickLabelPositions the array of tick label position in pixels
private java.util.ArrayList<java.lang.String>	tickLabels the array of tick label
private java.util.ArrayList<java.lang.Double>	tickLabelValues the array of tick label vales
private java.util.ArrayList<java.lang.Boolean>	tickVisibilities the array of visibility state of tick label
private int	timeUnit the time unit for tick step
private int	widthHint the width hint of tick labels area

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AxisTickLabels(Chart chart, Axis axis) Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	dispose() Disposes the resources.
private static void	drawRotatedText(org.eclipse.swt.graphics.GC gc, java.lang.String text, float x, float y, int angle) Draws the rotated text.
private void	drawXTick(org.eclipse.swt.graphics.GC gc) Draw the X tick.
private void	drawYTick(org.eclipse.swt.graphics.GC gc) Draw the Y tick.
private java.lang.String	format(java.lang.Object obj) Formats the given object.
protected org.eclipse.swt.graphics.Rectangle	getBounds() Gets the bounds on chart panel.
org.eclipse.swt.graphics.Font	getFont() Gets the font.
protected org.eclipse.swt.graphics.Color	getForeground() Gets the foreground color.
protected java.text.Format	getFormat() Gets the format for axis tick label.
private java.math.BigDecimal	getGridStep(int lengthInPixels, double min, double max) Gets the grid step.
ChartLayoutData	getLayoutData() Gets the layout data.
int	getLeftMarginHint(int length) Updates the left margin hint.
private static long	getPeriodInMillis(int unit, int amount) Gets the period in milliseconds of given unit of date and amount.
int	getRightMarginHint(int length) Gets the right margin hint.
int	getTickLabelMaxLength() Gets the max length of tick label.
java.util.ArrayList<java.lang.Integer>	getTickLabelPositions() Gets the tick label positions.
protected java.util.ArrayList<java.lang.Double>	getTickLabelValues() Gets the tick label values.
private int	getTimeUnit(double gridStepHint) Gets the tick step unit.
private boolean	hasSpaceToDraw(int previousPosition, int tickLabelPosition, java.lang.String tickLabel) Returns the state indicating if there is a space to draw tick label.
private void	initializePossibleTickSteps() Initialized the possible tick steps.
private boolean	isMajorTick(double tickValue) Checks if the tick label is major (...,0.01,0.1,1,10,100,...).
void	paintControl(org.eclipse.swt.events.PaintEvent e)
private static java.math.BigDecimal	pow(double base, int exponent) Calculates the value of the first argument raised to the power of the second argument.
void	setBounds(int x, int y, int width, int height) Sets the bounds on chart panel.
protected void	setFont(org.eclipse.swt.graphics.Font font) Sets the font.
void	setForeground(org.eclipse.swt.graphics.Color color) Sets the foreground color.
protected void	setFormat(java.text.Format format) Sets the format for axis tick label.
protected void	update(int length) Updates the tick labels.
protected void	updateLayoutData() Updates the tick labels layout.
private void	updateTickLabelForCategoryAxis(int length) Updates tick label for category axis.
private void	updateTickLabelForDateAxis(int length) Updates tick label for date axis.
private void	updateTickLabelForLinearScale(int length) Updates tick label for normal scale.
private void	updateTickLabelForLinearScale(int length, java.math.BigDecimal tickStep) Updates tick label for normal scale.
private void	updateTickLabelForLogScale(int length) Updates tick label for log scale.
private void	updateTickLabelForMonthOrYear(int length, double gridStepHint, int tickStepUnit) Updates the tick label for month or year.
private void	updateTickVisibility() Updates the visibility of tick labels.

Methods inherited from class java.lang.Object

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

Field Detail

chart

private final Chart chart

the chart

axis

private final Axis axis

the axis

foreground

private org.eclipse.swt.graphics.Color foreground

the foreground color

widthHint

private int widthHint

the width hint of tick labels area

heightHint

private int heightHint

the height hint of tick labels area

bounds

private org.eclipse.swt.graphics.Rectangle bounds

the bounds of tick labels area

tickLabelValues

private final java.util.ArrayList<java.lang.Double> tickLabelValues

the array of tick label vales

tickLabels

private final java.util.ArrayList<java.lang.String> tickLabels

the array of tick label

tickLabelPositions

private final java.util.ArrayList<java.lang.Integer> tickLabelPositions

the array of tick label position in pixels

tickVisibilities

private final java.util.ArrayList<java.lang.Boolean> tickVisibilities

the array of visibility state of tick label

format

private java.text.Format format

the format for tick labels

DEFAULT_FOREGROUND

private static final int DEFAULT_FOREGROUND

the default foreground

See Also:

Constant Field Values

DEFAULT_FONT

private static final org.eclipse.swt.graphics.Font DEFAULT_FONT

the default font

DEFAULT_DECIMAL_FORMAT

private static final java.lang.String DEFAULT_DECIMAL_FORMAT

the default label format

See Also:

Constant Field Values

possibleTickSteps

private java.util.Map<java.lang.Integer,java.lang.Integer[]> possibleTickSteps

the possible tick steps

timeUnit

private int timeUnit

the time unit for tick step

font

private org.eclipse.swt.graphics.Font font

the font

Constructor Detail

AxisTickLabels

protected AxisTickLabels(Chart chart,
                         Axis axis)

Constructor.

Parameters:

chart - the chart

axis - the axis

Method Detail

initializePossibleTickSteps

private void initializePossibleTickSteps()

Initialized the possible tick steps.

setForeground

public void setForeground(org.eclipse.swt.graphics.Color color)

Sets the foreground color.

Parameters:

color - the foreground color

getForeground

protected org.eclipse.swt.graphics.Color getForeground()

Gets the foreground color.

Returns:

the foreground color

update

protected void update(int length)

Updates the tick labels.

Parameters:

length - the axis length

updateTickLabelForDateAxis

private void updateTickLabelForDateAxis(int length)

Updates tick label for date axis.

Parameters:

length - the length of axis

updateTickLabelForMonthOrYear

private void updateTickLabelForMonthOrYear(int length,
                                           double gridStepHint,
                                           int tickStepUnit)

Updates the tick label for month or year. The month and year are handled differently from other units of time, since 1 month and 1 year can be different depending on which time to start counting.

Parameters:

length - the length of axis

gridStepHint - the grid step hint

tickStepUnit - the tick step unit of time

updateTickLabelForCategoryAxis

private void updateTickLabelForCategoryAxis(int length)

Updates tick label for category axis.

Parameters:

length - the length of axis

updateTickLabelForLogScale

private void updateTickLabelForLogScale(int length)

Updates tick label for log scale.

Parameters:

length - the length of axis

updateTickLabelForLinearScale

private void updateTickLabelForLinearScale(int length)

Updates tick label for normal scale.

Parameters:

length - axis length (>0)

updateTickLabelForLinearScale

private void updateTickLabelForLinearScale(int length,
                                           java.math.BigDecimal tickStep)

Updates tick label for normal scale.

Parameters:

length - axis length (>0)

tickStep - the tick step

updateTickVisibility

private void updateTickVisibility()

Updates the visibility of tick labels.

getTimeUnit

private int getTimeUnit(double gridStepHint)

Gets the tick step unit.

Parameters:

gridStepHint - the grid step hint

Returns:

the tick step unit.

getPeriodInMillis

private static long getPeriodInMillis(int unit,
                                      int amount)

Gets the period in milliseconds of given unit of date and amount. The period is calculated based on UTC of January 1, 1970.

Parameters:

unit - the unit of time like Calendar.YEAR.

amount - the amount of period.

Returns:

the period in milliseconds

format

private java.lang.String format(java.lang.Object obj)

Formats the given object.

Parameters:

obj - the object

Returns:

the formatted string

isMajorTick

private boolean isMajorTick(double tickValue)

Checks if the tick label is major (...,0.01,0.1,1,10,100,...).

Parameters:

tickValue - the tick label value

Returns:

true if the tick label is major

hasSpaceToDraw

private boolean hasSpaceToDraw(int previousPosition,
                               int tickLabelPosition,
                               java.lang.String tickLabel)

Returns the state indicating if there is a space to draw tick label.

Parameters:

previousPosition - the previously drawn tick label position.

tickLabelPosition - the tick label position.

tickLabel - the tick label text

Returns:

true if there is a space to draw tick label

getRightMarginHint

public int getRightMarginHint(int length)

Gets the right margin hint.

Parameters:

length - the axis length

Returns:

the right margin hint

getLeftMarginHint

public int getLeftMarginHint(int length)

Updates the left margin hint.

Parameters:

length - the axis length

Returns:

the left margin hint

getTickLabelMaxLength

public int getTickLabelMaxLength()

Gets the max length of tick label.

Returns:

the max length of tick label

pow

private static java.math.BigDecimal pow(double base,
                                        int exponent)

Calculates the value of the first argument raised to the power of the second argument.

Parameters:

base - the base

exponent - the exponent

Returns:

the value a^b in BigDecimal

getGridStep

private java.math.BigDecimal getGridStep(int lengthInPixels,
                                         double min,
                                         double max)

Gets the grid step.

Parameters:

lengthInPixels - axis length in pixels

min - minimum value

max - maximum value

Returns:

rounded value.

getTickLabelPositions

public java.util.ArrayList<java.lang.Integer> getTickLabelPositions()

Gets the tick label positions.

Returns:

the tick label positions

getTickLabelValues

protected java.util.ArrayList<java.lang.Double> getTickLabelValues()

Gets the tick label values.

Returns:

the tick label values

setFont

protected void setFont(org.eclipse.swt.graphics.Font font)

Sets the font.

Parameters:

font - the font

getFont

public org.eclipse.swt.graphics.Font getFont()

Gets the font.

Returns:

the font

getLayoutData

public ChartLayoutData getLayoutData()

Gets the layout data.

Returns:

the layout data

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Sets the bounds on chart panel.

Parameters:

x - the x coordinate

y - the y coordinate

width - the width

height - the height

getBounds

protected org.eclipse.swt.graphics.Rectangle getBounds()

Gets the bounds on chart panel.

Returns:

the bounds on chart panel

dispose

protected void dispose()

Disposes the resources.

updateLayoutData

protected void updateLayoutData()

Updates the tick labels layout.

paintControl

public void paintControl(org.eclipse.swt.events.PaintEvent e)

Specified by:

paintControl in interface org.eclipse.swt.events.PaintListener

drawXTick

private void drawXTick(org.eclipse.swt.graphics.GC gc)

Draw the X tick.

Parameters:

gc - the graphics context

drawRotatedText

private static void drawRotatedText(org.eclipse.swt.graphics.GC gc,
                                    java.lang.String text,
                                    float x,
                                    float y,
                                    int angle)

Draws the rotated text.

Parameters:

gc - the graphics context

text - the text

x - the x coordinate

y - the y coordinate

angle - the angle

drawYTick

private void drawYTick(org.eclipse.swt.graphics.GC gc)

Draw the Y tick.

Parameters:

gc - the graphics context

setFormat

protected void setFormat(java.text.Format format)

Sets the format for axis tick label. DecimalFormat and DateFormat should be used for double[] series and Data[] series respectively.

If null is set, default format will be used.

Parameters:

format - the format

getFormat

protected java.text.Format getFormat()

Gets the format for axis tick label.

Returns:

the format