com.jjoe64.graphview.series

Class BaseSeries<E extends DataPointInterface>

java.lang.Object

com.jjoe64.graphview.series.BaseSeries<E>

All Implemented Interfaces:

Series<E>

Direct Known Subclasses:

BarGraphSeries, LineGraphSeries, PointsGraphSeries

public abstract class BaseSeries<E extends DataPointInterface>
extends java.lang.Object
implements Series<E>

Basis implementation for series. Used for series that are plotted on a default x/y 2d viewport. Extend this class to implement your own custom graph type. This implementation uses a internal Array to store the data. If you want to implement a custom data provider you may want to implement Series.

Field Summary

Fields

Modifier and Type	Field and Description
protected OnDataPointTapListener	mOnDataPointTapListener listener to handle tap events on a data point

Constructor Summary

Constructors

Constructor and Description
BaseSeries() creates series without data
BaseSeries(E[] data) creates series with data

Method Summary

Modifier and Type	Method and Description
void	appendData(E dataPoint, boolean scrollToEnd, int maxDataPoints)
void	appendData(E dataPoint, boolean scrollToEnd, int maxDataPoints, boolean silent)
protected void	checkValueOrder(DataPointInterface onlyLast) checks that the data is in the correct order
void	clearCursorModeCache()
void	clearReference(GraphView graphView) clear reference to view and activity
abstract void	drawSelection(GraphView mGraphView, Canvas canvas, boolean b, DataPointInterface value)
protected E	findDataPoint(float x, float y) find the data point which is next to the coordinates
E	findDataPointAtX(float x)
int	getColor()
double	getHighestValueX()
double	getHighestValueY()
double	getLowestValueX()
double	getLowestValueY()
java.lang.String	getTitle()
java.util.Iterator<E>	getValues(double from, double until) get the values for a given x range.
boolean	isEmpty()
void	onGraphViewAttached(GraphView graphView) stores the reference of the used graph
void	onTap(float x, float y) called by the tap detector in order to trigger the on tap on datapoint event.
protected void	registerDataPoint(float x, float y, E dp) register the datapoint to find it at a tap
void	resetData(E[] data) clears the data of this series and sets new.
protected void	resetDataPoints() clears the cached data point coordinates
void	setColor(int mColor) set the color of the series.
void	setOnDataPointTapListener(OnDataPointTapListener l) set a listener for tap on a data point.
void	setTitle(java.lang.String mTitle) set the title of the series.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jjoe64.graphview.series.Series

draw

Field Detail

mOnDataPointTapListener

protected OnDataPointTapListener mOnDataPointTapListener

listener to handle tap events on a data point

Constructor Detail

BaseSeries

public BaseSeries()

creates series without data

BaseSeries

public BaseSeries(E[] data)

creates series with data

Parameters:

data - data points important: array has to be sorted from lowest x-value to the highest

Method Detail

getLowestValueX

public double getLowestValueX()

Specified by:

getLowestValueX in interface Series<E extends DataPointInterface>

Returns:

the lowest x value, or 0 if there is no data

getHighestValueX

public double getHighestValueX()

Specified by:

getHighestValueX in interface Series<E extends DataPointInterface>

Returns:

the highest x value, or 0 if there is no data

getLowestValueY

public double getLowestValueY()

Specified by:

getLowestValueY in interface Series<E extends DataPointInterface>

Returns:

the lowest y value, or 0 if there is no data

getHighestValueY

public double getHighestValueY()

Specified by:

getHighestValueY in interface Series<E extends DataPointInterface>

Returns:

the highest y value, or 0 if there is no data

getValues

public java.util.Iterator<E> getValues(double from,
                                       double until)

get the values for a given x range. if from and until are bigger or equal than all the data, the original data is returned. If it is only a part of the data, the range is returned plus one datapoint before and after to get a nice scrolling.

Specified by:

getValues in interface Series<E extends DataPointInterface>

Parameters:

from - minimal x-value

until - maximal x-value

Returns:

data for the range +/- 1 datapoint

getTitle

public java.lang.String getTitle()

Specified by:

getTitle in interface Series<E extends DataPointInterface>

Returns:

the title of the series

setTitle

public void setTitle(java.lang.String mTitle)

set the title of the series. This will be used in the legend.

Parameters:

mTitle - title of the series

getColor

public int getColor()

Specified by:

getColor in interface Series<E extends DataPointInterface>

Returns:

color of the series

setColor

public void setColor(int mColor)

set the color of the series. This will be used in plotting (depends on the series implementation) and is used in the legend.

Parameters:

mColor -

setOnDataPointTapListener

public void setOnDataPointTapListener(OnDataPointTapListener l)

set a listener for tap on a data point.

Specified by:

setOnDataPointTapListener in interface Series<E extends DataPointInterface>

Parameters:

l - listener

onTap

public void onTap(float x,
                  float y)

called by the tap detector in order to trigger the on tap on datapoint event.

Specified by:

onTap in interface Series<E extends DataPointInterface>

Parameters:

x - pixel

y - pixel

findDataPoint

protected E findDataPoint(float x,
                          float y)

find the data point which is next to the coordinates

Parameters:

x - pixel

y - pixel

Returns:

the data point or null if nothing was found

findDataPointAtX

public E findDataPointAtX(float x)

registerDataPoint

protected void registerDataPoint(float x,
                                 float y,
                                 E dp)

register the datapoint to find it at a tap

Parameters:

x - pixel

y - pixel

dp - the data point to save

resetDataPoints

protected void resetDataPoints()

clears the cached data point coordinates

resetData

public void resetData(E[] data)

clears the data of this series and sets new. will redraw the graph

Parameters:

data - the values must be in the correct order! x-value has to be ASC. First the lowest x value and at least the highest x value.

onGraphViewAttached

public void onGraphViewAttached(GraphView graphView)

stores the reference of the used graph

Specified by:

onGraphViewAttached in interface Series<E extends DataPointInterface>

Parameters:

graphView - graphview

appendData

public void appendData(E dataPoint,
                       boolean scrollToEnd,
                       int maxDataPoints,
                       boolean silent)

Parameters:

dataPoint - values the values must be in the correct order! x-value has to be ASC. First the lowest x value and at least the highest x value.

scrollToEnd - true => graphview will scroll to the end (maxX)

maxDataPoints - if max data count is reached, the oldest data value will be lost to avoid memory leaks

silent - set true to avoid rerender the graph

appendData

public void appendData(E dataPoint,
                       boolean scrollToEnd,
                       int maxDataPoints)

Parameters:

dataPoint - values the values must be in the correct order! x-value has to be ASC. First the lowest x value and at least the highest x value.

scrollToEnd - true => graphview will scroll to the end (maxX)

maxDataPoints - if max data count is reached, the oldest data value will be lost to avoid memory leaks

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Series<E extends DataPointInterface>

Returns:

whether there are data points

checkValueOrder

protected void checkValueOrder(DataPointInterface onlyLast)

checks that the data is in the correct order

Parameters:

onlyLast - if not null, it will only check that this datapoint is after the last point.

drawSelection

public abstract void drawSelection(GraphView mGraphView,
                                   Canvas canvas,
                                   boolean b,
                                   DataPointInterface value)

clearCursorModeCache

public void clearCursorModeCache()

clearReference

public void clearReference(GraphView graphView)

Description copied from interface: Series

clear reference to view and activity

Specified by:

clearReference in interface Series<E extends DataPointInterface>