com.androidplot

Class Plot<SeriesType extends Series,FormatterType extends Formatter,RendererType extends SeriesRenderer>

java.lang.Object

android.view.View

com.androidplot.Plot<SeriesType,FormatterType,RendererType>

All Implemented Interfaces:

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

Direct Known Subclasses:

PieChart, XYPlot

public abstract class Plot<SeriesType extends Series,FormatterType extends Formatter,RendererType extends SeriesRenderer>
extends android.view.View
implements Resizable

Base class for all Plot implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Plot.BorderStyle
static class	Plot.RenderMode The RenderMode used by a Plot to draw it's self onto the screen.

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

android.view.View.AccessibilityDelegate, android.view.View.BaseSavedState, android.view.View.DragShadowBuilder, android.view.View.MeasureSpec, android.view.View.OnApplyWindowInsetsListener, android.view.View.OnAttachStateChangeListener, android.view.View.OnClickListener, android.view.View.OnContextClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnDragListener, android.view.View.OnFocusChangeListener, android.view.View.OnGenericMotionListener, android.view.View.OnHoverListener, android.view.View.OnKeyListener, android.view.View.OnLayoutChangeListener, android.view.View.OnLongClickListener, android.view.View.OnScrollChangeListener, android.view.View.OnSystemUiVisibilityChangeListener, android.view.View.OnTouchListener

Field Summary

Fields inherited from class android.view.View

ACCESSIBILITY_LIVE_REGION_ASSERTIVE, ACCESSIBILITY_LIVE_REGION_NONE, ACCESSIBILITY_LIVE_REGION_POLITE, ALPHA, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, EMPTY_STATE_SET, ENABLED_FOCUSED_SELECTED_STATE_SET, ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_FOCUSED_STATE_SET, ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, ENABLED_SELECTED_STATE_SET, ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_STATE_SET, ENABLED_WINDOW_FOCUSED_STATE_SET, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, FOCUSED_SELECTED_STATE_SET, FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, FOCUSED_STATE_SET, FOCUSED_WINDOW_FOCUSED_STATE_SET, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS, IMPORTANT_FOR_ACCESSIBILITY_YES, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, LAYOUT_DIRECTION_INHERIT, LAYOUT_DIRECTION_LOCALE, LAYOUT_DIRECTION_LTR, LAYOUT_DIRECTION_RTL, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET, PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_SELECTED_STATE_SET, PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_STATE_SET, PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_SELECTED_STATE_SET, PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_STATE_SET, PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_SELECTED_STATE_SET, PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_STATE_SET, PRESSED_WINDOW_FOCUSED_STATE_SET, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLL_AXIS_HORIZONTAL, SCROLL_AXIS_NONE, SCROLL_AXIS_VERTICAL, SCROLL_INDICATOR_BOTTOM, SCROLL_INDICATOR_END, SCROLL_INDICATOR_LEFT, SCROLL_INDICATOR_RIGHT, SCROLL_INDICATOR_START, SCROLL_INDICATOR_TOP, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SELECTED_STATE_SET, SELECTED_WINDOW_FOCUSED_STATE_SET, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_IMMERSIVE, SYSTEM_UI_FLAG_IMMERSIVE_STICKY, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_CENTER, TEXT_ALIGNMENT_GRAVITY, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_TEXT_END, TEXT_ALIGNMENT_TEXT_START, TEXT_ALIGNMENT_VIEW_END, TEXT_ALIGNMENT_VIEW_START, TEXT_DIRECTION_ANY_RTL, TEXT_DIRECTION_FIRST_STRONG, TEXT_DIRECTION_FIRST_STRONG_LTR, TEXT_DIRECTION_FIRST_STRONG_RTL, TEXT_DIRECTION_INHERIT, TEXT_DIRECTION_LOCALE, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, VIEW_LOG_TAG, VISIBLE, WINDOW_FOCUSED_STATE_SET, X, Y, Z

Constructor Summary

Constructors

Constructor and Description
Plot(android.content.Context context, android.util.AttributeSet attrs) Required by super-class.
Plot(android.content.Context context, android.util.AttributeSet attrs, int defStyle) Required by super-class.
Plot(android.content.Context context, String title) Convenience constructor - wraps Plot(android.content.Context, String, com.androidplot.Plot.RenderMode).
Plot(android.content.Context context, String title, Plot.RenderMode mode) Used for programmatic instantiation.

Method Summary

Modifier and Type	Method and Description
boolean	addListener(PlotListener listener)
boolean	addSeries(SeriesType series, FormatterType formatter) Add a new Series to the Plot.
void	clear() Remove all series from the plot.
protected void	drawBackground(android.graphics.Canvas canvas, android.graphics.RectF dims)
protected void	drawBorder(android.graphics.Canvas canvas, android.graphics.RectF dims) Draws the plot's outer border.
protected void	drawRect(android.graphics.Canvas canvas, android.graphics.RectF dims, android.graphics.Paint paint)
android.graphics.Paint	getBackgroundPaint()
android.graphics.Paint	getBorderPaint()
DisplayDimensions	getDisplayDimensions()
FormatterType	getFormatter(SeriesType series, Class<? extends RendererType> rendererClass)
LayoutManager	getLayoutManager()
float	getPlotMarginBottom()
float	getPlotMarginLeft()
float	getPlotMarginRight()
float	getPlotMarginTop()
float	getPlotPaddingBottom()
float	getPlotPaddingLeft()
float	getPlotPaddingRight()
float	getPlotPaddingTop()
RendererType	getRenderer(Class<? extends RendererType> rendererClass)
List<RendererType>	getRendererList()
HashMap<Class<? extends RendererType>,RendererType>	getRenderers() Used for caching renderer instances.
Plot.RenderMode	getRenderMode()
protected List<SeriesAndFormatter<SeriesType,FormatterType>>	getSeries(SeriesType series)
protected SeriesAndFormatter<SeriesType,FormatterType>	getSeries(SeriesType series, Class<? extends RendererType> rendererClass)
ArrayList<SeriesAndFormatter<SeriesType,FormatterType>>	getSeriesRegistry() Associates lists series and getFormatter pairs with the class of the Renderer used to render them.
String	getTitle()
TextLabelWidget	getTitleWidget()
boolean	isEmpty()
protected boolean	isHwAccelerationSupported() Can be overridden by derived classes to control hardware acceleration state.
void	layout(DisplayDimensions dims) Called when a change to the class' dimensions is made.
protected void	notifyListenersAfterDraw(android.graphics.Canvas canvas)
protected void	notifyListenersBeforeDraw(android.graphics.Canvas canvas)
protected void	onDetachedFromWindow()
protected void	onDraw(android.graphics.Canvas canvas) Called whenever the plot needs to be drawn via the Handler, which invokes invalidate().
protected abstract void	onPreInit() Concrete implementations should do any final setup / initialization here.
protected void	onSizeChanged(int w, int h, int oldw, int oldh)
protected abstract void	processAttrs(android.content.res.TypedArray attrs) If a styleable is available for the derived class, this method will be invoked with those attrs.
void	redraw() Causes the plot to be redrawn.
boolean	removeListener(PlotListener listener)
void	removeSeries(SeriesType series) Remove all occurrences of series regardless of the associated Renderer.
SeriesAndFormatter<SeriesType,FormatterType>	removeSeries(SeriesType series, Class<? extends RendererType> rendererClass) Remove a series for a specific Renderer only.
protected void	renderOnCanvas(android.graphics.Canvas canvas) Renders the plot onto a canvas.
void	setBackgroundPaint(android.graphics.Paint backgroundPaint)
void	setBorderPaint(android.graphics.Paint borderPaint) Set's the paint used to draw the border.
void	setBorderStyle(Plot.BorderStyle style, Float radiusX, Float radiusY) Sets the visual style of the plot's border.
void	setLayoutManager(LayoutManager layoutManager)
void	setMarkupEnabled(boolean enabled)
void	setPlotMarginBottom(float plotMarginBottom)
void	setPlotMarginLeft(float plotMarginLeft)
void	setPlotMarginRight(float plotMarginRight)
void	setPlotMargins(float left, float top, float right, float bottom) Convenience method - wraps the individual setMarginXXX methods into a single method.
void	setPlotMarginTop(float plotMarginTop)
void	setPlotPadding(float left, float top, float right, float bottom) Convenience method - wraps the individual setPaddingXXX methods into a single method.
void	setPlotPaddingBottom(float plotPaddingBottom)
void	setPlotPaddingLeft(float plotPaddingLeft)
void	setPlotPaddingRight(float plotPaddingRight)
void	setPlotPaddingTop(float plotPaddingTop)
void	setRenderMode(Plot.RenderMode mode) Sets the render mode used by the Plot.
void	setTitle(String title)
void	setTitleWidget(TextLabelWidget titleWidget)

Methods inherited from class android.view.View

addChildrenForAccessibility, addFocusables, addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addTouchables, animate, announceForAccessibility, awakenScrollBars, awakenScrollBars, awakenScrollBars, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelLongPress, cancelPendingInputEvents, canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearFocus, combineMeasuredStates, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeSystemWindowInsets, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchApplyWindowInsets, dispatchConfigurationChanged, dispatchDisplayHint, dispatchDragEvent, dispatchDraw, dispatchDrawableHotspotChanged, dispatchGenericFocusedEvent, dispatchGenericMotionEvent, dispatchGenericPointerEvent, dispatchHoverEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, dispatchProvideStructure, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchSetActivated, dispatchSetPressed, dispatchSetSelected, dispatchSystemUiVisibilityChanged, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchVisibilityChanged, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, draw, drawableHotspotChanged, drawableStateChanged, findFocus, findViewById, findViewsWithText, findViewWithTag, fitSystemWindows, focusSearch, forceLayout, generateViewId, getAccessibilityClassName, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAlpha, getAnimation, getApplicationWindowToken, getBackground, getBackgroundTintList, getBackgroundTintMode, getBaseline, getBottom, getBottomFadingEdgeStrength, getBottomPaddingOffset, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentDescription, getContext, getContextMenuInfo, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintList, getForegroundTintMode, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getImportantForAccessibility, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLeftPaddingOffset, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOutlineProvider, getOverlay, getOverScrollMode, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getParent, getParentForAccessibility, getPivotX, getPivotY, getResources, getRight, getRightFadingEdgeStrength, getRightPaddingOffset, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getStateListAnimator, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTop, getTopFadingEdgeStrength, getTopPaddingOffset, getTouchables, getTouchDelegate, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowId, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasFocus, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasOverlappingRendering, hasTransientState, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, invalidateOutline, isAccessibilityFocused, isActivated, isAttachedToWindow, isClickable, isContextClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isInEditMode, isInLayout, isInTouchMode, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isOpaque, isPaddingOffsetRequired, isPaddingRelative, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, jumpDrawablesToCurrentState, layout, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAnimationEnd, onAnimationStart, onApplyWindowInsets, onAttachedToWindow, onCancelPendingInputEvents, onCheckIsTextEditor, onConfigurationChanged, onCreateContextMenu, onCreateDrawableState, onCreateInputConnection, onDisplayHint, onDragEvent, onDrawForeground, onDrawScrollBars, onFilterTouchEventForSecurity, onFinishInflate, onFinishTemporaryDetach, onFocusChanged, onGenericMotionEvent, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onLayout, onMeasure, onOverScrolled, onPopulateAccessibilityEvent, onProvideStructure, onProvideVirtualStructure, onRestoreInstanceState, onRtlPropertiesChanged, onSaveInstanceState, onScreenStateChanged, onScrollChanged, onSetAlpha, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onVisibilityChanged, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, onWindowVisibilityChanged, overScrollBy, performAccessibilityAction, performClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setAccessibilityLiveRegion, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAlpha, setAnimation, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentDescription, setContextClickable, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusableInTouchMode, setForeground, setForegroundGravity, setForegroundTintList, setForegroundTintMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setKeepScreenOn, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineProvider, setOverScrollMode, setPadding, setPaddingRelative, setPivotX, setPivotY, setPressed, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSelected, setSoundEffectsEnabled, setStateListAnimator, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTop, setTouchDelegate, setTransitionName, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setVisibility, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startNestedScroll, stopNestedScroll, toString, unscheduleDrawable, unscheduleDrawable, verifyDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Constructor Detail

Plot

public Plot(android.content.Context context,
            String title)

Convenience constructor - wraps Plot(android.content.Context, String, com.androidplot.Plot.RenderMode). RenderMode is set to Plot.RenderMode.USE_BACKGROUND_THREAD.

Parameters:

context -

title - The display title of this Plot.

Plot

public Plot(android.content.Context context,
            String title,
            Plot.RenderMode mode)

Used for programmatic instantiation.

Parameters:

context -

title - The display title of this Plot.

Plot

public Plot(android.content.Context context,
            android.util.AttributeSet attrs)

Required by super-class. Extending class' implementations should add the following code immediately before exiting to ensure that loadAttrs is called only once by the derived class: if(getClass().equals(DerivedPlot.class) { loadAttrs(context, attrs); } See XYPlot.XYPlot(android.content.Context, android.util.AttributeSet) for an example.

Parameters:

context -

attrs -

Plot

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

Required by super-class. Extending class' implementations should add the following code immediately before exiting to ensure that loadAttrs is called only once by the derived class: if(getClass().equals(DerivedPlot.class) { loadAttrs(context, attrs); } See XYPlot.XYPlot(android.content.Context, android.util.AttributeSet, int) for an example.

Parameters:

context -

attrs -

defStyle -

Method Detail

getDisplayDimensions

public DisplayDimensions getDisplayDimensions()

getRenderers

public HashMap<Class<? extends RendererType>,RendererType> getRenderers()

Used for caching renderer instances. Note that once a renderer is initialized it remains initialized for the life of the application; does not and should not be destroyed until the application exits.

getSeriesRegistry

public ArrayList<SeriesAndFormatter<SeriesType,FormatterType>> getSeriesRegistry()

Associates lists series and getFormatter pairs with the class of the Renderer used to render them.

isHwAccelerationSupported

protected boolean isHwAccelerationSupported()

Can be overridden by derived classes to control hardware acceleration state. Note that this setting is only used on Honeycomb and later environments.

Returns:

True if hardware acceleration is allowed, false otherwise.

Since:

0.5.1

setRenderMode

public void setRenderMode(Plot.RenderMode mode)

Sets the render mode used by the Plot. WARNING: This method is not currently designed for general use outside of Configurator. Attempting to reassign the render mode at runtime will result in unexpected behavior.

Parameters:

mode -

onPreInit

protected abstract void onPreInit()

Concrete implementations should do any final setup / initialization here. Immediately following this method's invocation, AndroidPlot assumes that the Plot instance is ready for final configuration via the Configurator.

processAttrs

protected abstract void processAttrs(android.content.res.TypedArray attrs)

If a styleable is available for the derived class, this method will be invoked with those attrs. The derived implementation is only responsible for setting derived class attributes, ie. it should not attempt to apply the Plot.title styleable attribute etc. Do not invoke recycle() on attrs.

Parameters:

attrs - Attrs for the derived class.

getRenderMode

public Plot.RenderMode getRenderMode()

addListener

public boolean addListener(PlotListener listener)

removeListener

public boolean removeListener(PlotListener listener)

notifyListenersBeforeDraw

protected void notifyListenersBeforeDraw(android.graphics.Canvas canvas)

notifyListenersAfterDraw

protected void notifyListenersAfterDraw(android.graphics.Canvas canvas)

addSeries

public boolean addSeries(SeriesType series,
                         FormatterType formatter)

Add a new Series to the Plot.

Parameters:

series -

formatter -

Returns:

True if the series was added or false if the series / formatter pair already exists in the registry.

getSeries

protected SeriesAndFormatter<SeriesType,FormatterType> getSeries(SeriesType series,
                                                                 Class<? extends RendererType> rendererClass)

Parameters:

series -

rendererClass -

Returns:

The SeriesAndFormatter that matches the series and rendererClass params, or null if one is not found.

getSeries

protected List<SeriesAndFormatter<SeriesType,FormatterType>> getSeries(SeriesType series)

Parameters:

series -

Returns:

A List of SeriesAndFormatter instances that reference series.

removeSeries

public SeriesAndFormatter<SeriesType,FormatterType> removeSeries(SeriesType series,
                                                                 Class<? extends RendererType> rendererClass)

Remove a series for a specific Renderer only. Use removeSeries(Series) to remove the series from the plot completely.

Parameters:

series -

rendererClass -

Returns:

The SeriesAndFormatterPair that was removed or null if nothing was removed.

removeSeries

public void removeSeries(SeriesType series)

Remove all occurrences of series regardless of the associated Renderer.

Parameters:

series -

clear

public void clear()

Remove all series from the plot.

isEmpty

public boolean isEmpty()

getFormatter

public FormatterType getFormatter(SeriesType series,
                                  Class<? extends RendererType> rendererClass)

Parameters:

series -

rendererClass -

Returns:

The Formatter instance corresponding to the specified series / renderer pair.

getRenderer

public RendererType getRenderer(Class<? extends RendererType> rendererClass)

getRendererList

public List<RendererType> getRendererList()

setMarkupEnabled

public void setMarkupEnabled(boolean enabled)

redraw

public void redraw()

Causes the plot to be redrawn.

Since:

0.5.1

layout

public void layout(DisplayDimensions dims)

Description copied from interface: Resizable

Called when a change to the class' dimensions is made. This method is responsible for cascading calls to update for any logical children of this class, for example the Plot class is responsible for updating the LayoutManager. Note that while dims is marked final in this interface, the compiler will not enforce it. Implementors of this method should take care not to make changes to dims as this will affect parent Resizables in likely undesired ways.

Specified by:

layout in interface Resizable

onDetachedFromWindow

protected void onDetachedFromWindow()

Overrides:

onDetachedFromWindow in class android.view.View

onSizeChanged

protected void onSizeChanged(int w,
                             int h,
                             int oldw,
                             int oldh)

Overrides:

onSizeChanged in class android.view.View

onDraw

protected void onDraw(android.graphics.Canvas canvas)

Called whenever the plot needs to be drawn via the Handler, which invokes invalidate(). Should never be called directly; use redraw() instead.

Overrides:

onDraw in class android.view.View

Parameters:

canvas -

renderOnCanvas

protected void renderOnCanvas(android.graphics.Canvas canvas)

Renders the plot onto a canvas. Used by both main thread to draw directly onto the View's canvas as well as by background draw to render onto a Bitmap buffer. At the end of the day this is the main entry for a plot's "heavy lifting".

Parameters:

canvas -

setBorderStyle

public void setBorderStyle(Plot.BorderStyle style,
                           Float radiusX,
                           Float radiusY)

Sets the visual style of the plot's border.

Parameters:

style -

radiusX - Sets the X radius for BorderStyle.ROUNDED. Use null for all other styles.

radiusY - Sets the Y radius for BorderStyle.ROUNDED. Use null for all other styles.

drawBorder

protected void drawBorder(android.graphics.Canvas canvas,
                          android.graphics.RectF dims)

Draws the plot's outer border.

Parameters:

canvas -

Throws:

PlotRenderException

drawBackground

protected void drawBackground(android.graphics.Canvas canvas,
                              android.graphics.RectF dims)

drawRect

protected void drawRect(android.graphics.Canvas canvas,
                        android.graphics.RectF dims,
                        android.graphics.Paint paint)

getTitle

public String getTitle()

Returns:

The displayed title of this Plot.

setTitle

public void setTitle(String title)

Parameters:

title - The title to display on this Plot.

getLayoutManager

public LayoutManager getLayoutManager()

setLayoutManager

public void setLayoutManager(LayoutManager layoutManager)

getTitleWidget

public TextLabelWidget getTitleWidget()

setTitleWidget

public void setTitleWidget(TextLabelWidget titleWidget)

getBackgroundPaint

public android.graphics.Paint getBackgroundPaint()

setBackgroundPaint

public void setBackgroundPaint(android.graphics.Paint backgroundPaint)

setPlotMargins

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

Convenience method - wraps the individual setMarginXXX methods into a single method.

Parameters:

left -

top -

right -

bottom -

setPlotPadding

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

Convenience method - wraps the individual setPaddingXXX methods into a single method.

Parameters:

left -

top -

right -

bottom -

getPlotMarginTop

public float getPlotMarginTop()

setPlotMarginTop

public void setPlotMarginTop(float plotMarginTop)

getPlotMarginBottom

public float getPlotMarginBottom()

setPlotMarginBottom

public void setPlotMarginBottom(float plotMarginBottom)

getPlotMarginLeft

public float getPlotMarginLeft()

setPlotMarginLeft

public void setPlotMarginLeft(float plotMarginLeft)

getPlotMarginRight

public float getPlotMarginRight()

setPlotMarginRight

public void setPlotMarginRight(float plotMarginRight)

getPlotPaddingTop

public float getPlotPaddingTop()

setPlotPaddingTop

public void setPlotPaddingTop(float plotPaddingTop)

getPlotPaddingBottom

public float getPlotPaddingBottom()

setPlotPaddingBottom

public void setPlotPaddingBottom(float plotPaddingBottom)

getPlotPaddingLeft

public float getPlotPaddingLeft()

setPlotPaddingLeft

public void setPlotPaddingLeft(float plotPaddingLeft)

getPlotPaddingRight

public float getPlotPaddingRight()

setPlotPaddingRight

public void setPlotPaddingRight(float plotPaddingRight)

getBorderPaint

public android.graphics.Paint getBorderPaint()

setBorderPaint

public void setBorderPaint(android.graphics.Paint borderPaint)

Set's the paint used to draw the border. Note that this method copies borderPaint and set's the copy's Paint.Style attribute to Paint.Style.STROKE.

Parameters:

borderPaint -