com.androidplot.xy
Class XYPlot

java.lang.Object
  android.view.View
      com.androidplot.Plot<XYSeries,XYSeriesFormatter,XYSeriesRenderer>
          com.androidplot.xy.XYPlot

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.view.accessibility.AccessibilityEventSource, android.view.KeyEvent.Callback

public class XYPlot
extends Plot<XYSeries,XYSeriesFormatter,XYSeriesRenderer>

A View to graphically display x/y coordinates.

Nested Class Summary

Nested classes/interfaces inherited from class com.androidplot.Plot

Plot.BorderStyle

Nested classes/interfaces inherited from class android.view.View

android.view.View.BaseSavedState, android.view.View.MeasureSpec, android.view.View.OnClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnFocusChangeListener, android.view.View.OnKeyListener, android.view.View.OnLongClickListener, android.view.View.OnTouchListener

Field Summary

Fields inherited from class android.view.View

DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, GONE, HAPTIC_FEEDBACK_ENABLED, INVISIBLE, KEEP_SCREEN_ON, NO_ID, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SOUND_EFFECTS_ENABLED, VISIBLE

Constructor Summary

XYPlot(android.content.Context context, android.util.AttributeSet attributes)

XYPlot(android.content.Context context, android.util.AttributeSet attrs, int defStyle)

XYPlot(android.content.Context context, java.lang.String title)

Method Summary

boolean	addMarker(XValueMarker marker) Appends the specified marker to the end of plot's xValueMarkers list.
boolean	addMarker(YValueMarker marker) Appends the specified marker to the end of plot's yValueMarkers list.
boolean	addSeries(XYSeries series, XYSeriesFormatter formatter)
void	calculateMinMaxVals()
void	centerOnDomainOrigin(java.lang.Number origin) Centers the domain axis on origin.
void	centerOnDomainOrigin(java.lang.Number origin, java.lang.Number extent, BoundaryMode mode) Centers the domain on origin, calculating the upper and lower boundaries of the axis using mode and extent.
void	centerOnRangeOrigin(java.lang.Number origin) Centers the range axis on origin.
void	centerOnRangeOrigin(java.lang.Number origin, java.lang.Number extent, BoundaryMode mode) Centers the domain on origin, calculating the upper and lower boundaries of the axis using mode and extent.
boolean	containsPoint(float x, float y) Checks whether the point is within the plot's graph area.
boolean	containsPoint(android.graphics.PointF point) Convenience method - wraps containsPoint(PointF).
java.lang.Number	getCalculatedMaxX()
java.lang.Number	getCalculatedMaxY()
java.lang.Number	getCalculatedMinX()
java.lang.Number	getCalculatedMinY()
RectRegion	getDefaultBounds()
XYFramingModel	getDomainFramingModel()
java.lang.String	getDomainLabel()
DomainLabelWidget	getDomainLabelWidget()
java.lang.Number	getDomainOrigin()
XYStepMode	getDomainStepMode()
double	getDomainStepValue()
java.text.Format	getDomainValueFormat() Convenience method - wraps XYGraphWidget.getDomainValueFormat().
XYGraphWidget	getGraphWidget()
XYLegendWidget	getLegendWidget()
XYFramingModel	getRangeFramingModel()
java.lang.String	getRangeLabel()
RangeLabelWidget	getRangeLabelWidget()
java.lang.Number	getRangeOrigin()
XYStepMode	getRangeStepMode()
double	getRangeStepValue()
java.text.Format	getRangeValueFormat() Convenience method - wraps XYGraphWidget.getRangeValueFormat().
int	getTicksPerDomainLabel() Convenience method - wraps XYGraphWidget.getTicksPerDomainLabel().
int	getTicksPerRangeLabel() Convenience method - wraps XYGraphWidget.getTicksPerRangeLabel().
java.lang.Number	getXVal(android.graphics.PointF point)
java.lang.Number	getYVal(android.graphics.PointF point)
boolean	isDrawDomainOriginEnabled()
boolean	isDrawRangeOriginEnabled()
XValueMarker	removeMarker(XValueMarker marker) Removes the specified marker from the plot.
YValueMarker	removeMarker(YValueMarker marker) Removes the specified marker from the plot.
int	removeMarkers() Convenience method - combines removeYMarkers() and removeXMarkers().
int	removeXMarkers() Removes all XValueMarker instances from the plot.
int	removeYMarkers() Removes all YValueMarker instances from the plot.
void	setCursorPosition(float x, float y)
void	setCursorPosition(android.graphics.PointF point)
void	setDefaultBounds(RectRegion defaultBounds)
void	setDomainBoundaries(java.lang.Number lowerBoundary, BoundaryMode lowerBoundaryMode, java.lang.Number upperBoundary, BoundaryMode upperBoundaryMode)
void	setDomainBoundaries(java.lang.Number lowerBoundary, java.lang.Number upperBoundary, BoundaryMode mode)
void	setDomainLabel(java.lang.String domainLabel)
void	setDomainLabelWidget(DomainLabelWidget domainLabelWidget)
void	setDomainLowerBoundary(java.lang.Number boundary, BoundaryMode mode)
void	setDomainStep(XYStepMode mode, double value)
void	setDomainStepMode(XYStepMode domainStepMode)
void	setDomainStepValue(double domainStepValue)
void	setDomainUpperBoundary(java.lang.Number boundary, BoundaryMode mode)
void	setDomainUpperBoundaryMode(BoundaryMode mode)
void	setDomainValueFormat(java.text.Format domainValueFormat) Convenience method - wraps XYGraphWidget.setDomainValueFormat().
void	setDrawDomainOriginEnabled(boolean drawDomainOriginEnabled)
void	setDrawRangeOriginEnabled(boolean drawRangeOriginEnabled)
void	setGraphWidget(XYGraphWidget graphWidget)
void	setGridPadding(float left, float top, float right, float bottom)
void	setLegendWidget(XYLegendWidget legendWidget)
void	setRangeBoundaries(java.lang.Number lowerBoundary, BoundaryMode lowerBoundaryMode, java.lang.Number upperBoundary, BoundaryMode upperBoundaryMode)
void	setRangeBoundaries(java.lang.Number lowerBoundary, java.lang.Number upperBoundary, BoundaryMode mode)
void	setRangeLabel(java.lang.String rangeLabel)
void	setRangeLabelWidget(RangeLabelWidget rangeLabelWidget)
void	setRangeLowerBoundary(java.lang.Number boundary, BoundaryMode mode)
void	setRangeStep(XYStepMode mode, double value)
void	setRangeStepMode(XYStepMode rangeStepMode)
void	setRangeStepValue(double rangeStepValue)
void	setRangeUpperBoundary(java.lang.Number boundary, BoundaryMode mode)
void	setRangeValueFormat(java.text.Format rangeValueFormat) Convenience method - wraps XYGraphWidget.setRangeValueFormat().
void	setTicksPerDomainLabel(int ticksPerDomainLabel) Convenience method - wraps XYGraphWidget.setTicksPerDomainLabel().
void	setTicksPerRangeLabel(int ticksPerRangeLabel) Convenience method - wraps XYGraphWidget.setTicksPerRangeLabel().
void	setUserDomainOrigin(java.lang.Number origin)
void	setUserMaxX(java.lang.Number boundary)
void	setUserRangeOrigin(java.lang.Number origin)
void	updateDomainMinMaxForOriginModel()
void	updateRangeMinMaxForEdgeModel()
void	updateRangeMinMaxForOriginModel()

Methods inherited from class com.androidplot.Plot

addListener, addSeries, disableAllMarkup, getBackgroundPaint, getBorderPaint, getFormatter, getLayoutManager, getPlotMarginBottom, getPlotMarginLeft, getPlotMarginRight, getPlotMarginTop, getPlotPaddingBottom, getPlotPaddingLeft, getPlotPaddingRight, getPlotPaddingTop, getRenderer, getRendererList, getSeriesAndFormatterListForRenderer, getSeriesListForRenderer, getSeriesSet, getTitle, getTitleWidget, isDrawBorderEnabled, isEmpty, position, position, postRedraw, postRedraw, redraw, removeListener, removeSeries, removeSeries, setBackgroundPaint, setBorderPaint, setBorderStyle, setDrawBorderEnabled, setFormatter, setLayoutManager, setPlotMarginBottom, setPlotMarginLeft, setPlotMarginRight, setPlotMargins, setPlotMarginTop, setPlotPadding, setPlotPaddingBottom, setPlotPaddingLeft, setPlotPaddingRight, setPlotPaddingTop, setTitle, setTitleWidget

Methods inherited from class android.view.View

addFocusables, addFocusables, addTouchables, bringToFront, buildDrawingCache, buildDrawingCache, cancelLongPress, checkInputConnectionProxy, clearAnimation, clearFocus, computeScroll, createContextMenu, destroyDrawingCache, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchWindowFocusChanged, dispatchWindowVisibilityChanged, draw, findFocus, findViewById, findViewWithTag, focusSearch, forceLayout, getAnimation, getApplicationWindowToken, getBackground, getBaseline, getBottom, getContentDescription, getContext, getDefaultSize, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getFocusables, getFocusedRect, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getId, getKeepScreenOn, getKeyDispatcherState, getLayoutParams, getLeft, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMeasuredHeight, getMeasuredWidth, getNextFocusDownId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getParent, getResources, getRight, getRootView, getScrollBarStyle, getScrollX, getScrollY, getSolidColor, getTag, getTag, getTop, getTouchables, getTouchDelegate, getVerticalFadingEdgeLength, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, hasFocus, hasFocusable, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, isClickable, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isInEditMode, isInTouchMode, isLayoutRequested, isLongClickable, isOpaque, isPressed, isSaveEnabled, isScrollbarFadingEnabled, isSelected, isShown, isSoundEffectsEnabled, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, layout, measure, offsetLeftAndRight, offsetTopAndBottom, onCheckIsTextEditor, onCreateInputConnection, onFinishTemporaryDetach, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onWindowFocusChanged, performClick, performHapticFeedback, performHapticFeedback, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, refreshDrawableState, removeCallbacks, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, resolveSize, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAnimation, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setClickable, setContentDescription, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setEnabled, setFadingEdgeLength, setFocusable, setFocusableInTouchMode, setHapticFeedbackEnabled, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setId, setKeepScreenOn, setLayoutParams, setLongClickable, setMinimumHeight, setMinimumWidth, setNextFocusDownId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnClickListener, setOnCreateContextMenuListener, setOnFocusChangeListener, setOnKeyListener, setOnLongClickListener, setOnTouchListener, setPadding, setPressed, setSaveEnabled, setScrollbarFadingEnabled, setScrollBarStyle, setScrollContainer, setSelected, setSoundEffectsEnabled, setTag, setTag, setTouchDelegate, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVisibility, setWillNotCacheDrawing, setWillNotDraw, showContextMenu, startAnimation, unscheduleDrawable, unscheduleDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Constructor Detail

XYPlot

public XYPlot(android.content.Context context,
              java.lang.String title)

XYPlot

public XYPlot(android.content.Context context,
              android.util.AttributeSet attributes)

XYPlot

public XYPlot(android.content.Context context,
              android.util.AttributeSet attrs,
              int defStyle)

Method Detail

setGridPadding

public void setGridPadding(float left,
                           float top,
                           float right,
                           float bottom)

containsPoint

public boolean containsPoint(float x,
                             float y)

Checks whether the point is within the plot's graph area.

Parameters:

x -

y -

Returns:

containsPoint

public boolean containsPoint(android.graphics.PointF point)

Convenience method - wraps containsPoint(PointF).

Parameters:

point -

Returns:

setCursorPosition

public void setCursorPosition(android.graphics.PointF point)

setCursorPosition

public void setCursorPosition(float x,
                              float y)

getYVal

public java.lang.Number getYVal(android.graphics.PointF point)

getXVal

public java.lang.Number getXVal(android.graphics.PointF point)

calculateMinMaxVals

public void calculateMinMaxVals()

updateRangeMinMaxForEdgeModel

public void updateRangeMinMaxForEdgeModel()

centerOnDomainOrigin

public void centerOnDomainOrigin(java.lang.Number origin)

Centers the domain axis on origin.

Parameters:

origin -

centerOnDomainOrigin

public void centerOnDomainOrigin(java.lang.Number origin,
                                 java.lang.Number extent,
                                 BoundaryMode mode)

Centers the domain on origin, calculating the upper and lower boundaries of the axis using mode and extent.

Parameters:

origin -

extent -

mode -

centerOnRangeOrigin

public void centerOnRangeOrigin(java.lang.Number origin)

Centers the range axis on origin.

Parameters:

origin -

centerOnRangeOrigin

public void centerOnRangeOrigin(java.lang.Number origin,
                                java.lang.Number extent,
                                BoundaryMode mode)

Centers the domain on origin, calculating the upper and lower boundaries of the axis using mode and extent.

Parameters:

origin -

extent -

mode -

updateDomainMinMaxForOriginModel

public void updateDomainMinMaxForOriginModel()

updateRangeMinMaxForOriginModel

public void updateRangeMinMaxForOriginModel()

addSeries

public boolean addSeries(XYSeries series,
                         XYSeriesFormatter formatter)

getTicksPerRangeLabel

public int getTicksPerRangeLabel()

Convenience method - wraps XYGraphWidget.getTicksPerRangeLabel(). Equivalent to getGraphWidget().getTicksPerRangeLabel().

Returns:

setTicksPerRangeLabel

public void setTicksPerRangeLabel(int ticksPerRangeLabel)

Convenience method - wraps XYGraphWidget.setTicksPerRangeLabel(). Equivalent to getGraphWidget().setTicksPerRangeLabel().

Parameters:

ticksPerRangeLabel -

getTicksPerDomainLabel

public int getTicksPerDomainLabel()

Convenience method - wraps XYGraphWidget.getTicksPerDomainLabel(). Equivalent to getGraphWidget().getTicksPerDomainLabel().

Returns:

setTicksPerDomainLabel

public void setTicksPerDomainLabel(int ticksPerDomainLabel)

Convenience method - wraps XYGraphWidget.setTicksPerDomainLabel(). Equivalent to getGraphWidget().setTicksPerDomainLabel().

Parameters:

ticksPerDomainLabel -

getDomainStepMode

public XYStepMode getDomainStepMode()

setDomainStepMode

public void setDomainStepMode(XYStepMode domainStepMode)

getDomainStepValue

public double getDomainStepValue()

setDomainStepValue

public void setDomainStepValue(double domainStepValue)

setDomainStep

public void setDomainStep(XYStepMode mode,
                          double value)

getRangeStepMode

public XYStepMode getRangeStepMode()

setRangeStepMode

public void setRangeStepMode(XYStepMode rangeStepMode)

getRangeStepValue

public double getRangeStepValue()

setRangeStepValue

public void setRangeStepValue(double rangeStepValue)

setRangeStep

public void setRangeStep(XYStepMode mode,
                         double value)

getDomainLabel

public java.lang.String getDomainLabel()

setDomainLabel

public void setDomainLabel(java.lang.String domainLabel)

getRangeLabel

public java.lang.String getRangeLabel()

setRangeLabel

public void setRangeLabel(java.lang.String rangeLabel)

getLegendWidget

public XYLegendWidget getLegendWidget()

setLegendWidget

public void setLegendWidget(XYLegendWidget legendWidget)

getGraphWidget

public XYGraphWidget getGraphWidget()

setGraphWidget

public void setGraphWidget(XYGraphWidget graphWidget)

getDomainLabelWidget

public DomainLabelWidget getDomainLabelWidget()

setDomainLabelWidget

public void setDomainLabelWidget(DomainLabelWidget domainLabelWidget)

getRangeLabelWidget

public RangeLabelWidget getRangeLabelWidget()

setRangeLabelWidget

public void setRangeLabelWidget(RangeLabelWidget rangeLabelWidget)

getRangeValueFormat

public java.text.Format getRangeValueFormat()

Convenience method - wraps XYGraphWidget.getRangeValueFormat().

Returns:

setRangeValueFormat

public void setRangeValueFormat(java.text.Format rangeValueFormat)

Convenience method - wraps XYGraphWidget.setRangeValueFormat().

Parameters:

rangeValueFormat -

getDomainValueFormat

public java.text.Format getDomainValueFormat()

Convenience method - wraps XYGraphWidget.getDomainValueFormat().

Returns:

setDomainValueFormat

public void setDomainValueFormat(java.text.Format domainValueFormat)

Convenience method - wraps XYGraphWidget.setDomainValueFormat().

Parameters:

domainValueFormat -

setDomainBoundaries

public void setDomainBoundaries(java.lang.Number lowerBoundary,
                                java.lang.Number upperBoundary,
                                BoundaryMode mode)

setDomainBoundaries

public void setDomainBoundaries(java.lang.Number lowerBoundary,
                                BoundaryMode lowerBoundaryMode,
                                java.lang.Number upperBoundary,
                                BoundaryMode upperBoundaryMode)

setRangeBoundaries

public void setRangeBoundaries(java.lang.Number lowerBoundary,
                               java.lang.Number upperBoundary,
                               BoundaryMode mode)

setRangeBoundaries

public void setRangeBoundaries(java.lang.Number lowerBoundary,
                               BoundaryMode lowerBoundaryMode,
                               java.lang.Number upperBoundary,
                               BoundaryMode upperBoundaryMode)

setDomainUpperBoundaryMode

public void setDomainUpperBoundaryMode(BoundaryMode mode)

setUserMaxX

public void setUserMaxX(java.lang.Number boundary)

setDomainUpperBoundary

public void setDomainUpperBoundary(java.lang.Number boundary,
                                   BoundaryMode mode)

setDomainLowerBoundary

public void setDomainLowerBoundary(java.lang.Number boundary,
                                   BoundaryMode mode)

setRangeUpperBoundary

public void setRangeUpperBoundary(java.lang.Number boundary,
                                  BoundaryMode mode)

setRangeLowerBoundary

public void setRangeLowerBoundary(java.lang.Number boundary,
                                  BoundaryMode mode)

getDomainOrigin

public java.lang.Number getDomainOrigin()

getRangeOrigin

public java.lang.Number getRangeOrigin()

setUserDomainOrigin

public void setUserDomainOrigin(java.lang.Number origin)

setUserRangeOrigin

public void setUserRangeOrigin(java.lang.Number origin)

getDomainFramingModel

public XYFramingModel getDomainFramingModel()

getRangeFramingModel

public XYFramingModel getRangeFramingModel()

getCalculatedMinX

public java.lang.Number getCalculatedMinX()

getCalculatedMaxX

public java.lang.Number getCalculatedMaxX()

getCalculatedMinY

public java.lang.Number getCalculatedMinY()

getCalculatedMaxY

public java.lang.Number getCalculatedMaxY()

isDrawDomainOriginEnabled

public boolean isDrawDomainOriginEnabled()

setDrawDomainOriginEnabled

public void setDrawDomainOriginEnabled(boolean drawDomainOriginEnabled)

isDrawRangeOriginEnabled

public boolean isDrawRangeOriginEnabled()

setDrawRangeOriginEnabled

public void setDrawRangeOriginEnabled(boolean drawRangeOriginEnabled)

addMarker

public boolean addMarker(YValueMarker marker)

Appends the specified marker to the end of plot's yValueMarkers list.

Parameters:

marker - The YValueMarker to be added.

Returns:

true if the object was successfully added, false otherwise.

removeMarker

public YValueMarker removeMarker(YValueMarker marker)

Removes the specified marker from the plot.

Parameters:

marker -

Returns:

The YValueMarker removed if successfull, null otherwise.

removeMarkers

public int removeMarkers()

Convenience method - combines removeYMarkers() and removeXMarkers().

Returns:

removeYMarkers

public int removeYMarkers()

Removes all YValueMarker instances from the plot.

Returns:

addMarker

public boolean addMarker(XValueMarker marker)

Appends the specified marker to the end of plot's xValueMarkers list.

Parameters:

marker - The XValueMarker to be added.

Returns:

true if the object was successfully added, false otherwise.

removeMarker

public XValueMarker removeMarker(XValueMarker marker)

Removes the specified marker from the plot.

Parameters:

marker -

Returns:

The XValueMarker removed if successfull, null otherwise.

removeXMarkers

public int removeXMarkers()

Removes all XValueMarker instances from the plot.

Returns:

getDefaultBounds

public RectRegion getDefaultBounds()

setDefaultBounds

public void setDefaultBounds(RectRegion defaultBounds)