From 4662832d5c73b7bceba53c9dd948f8e9ff1f9026 Mon Sep 17 00:00:00 2001
From: guycnicholas <Guy@Gui-Soft.com>
Date: Wed, 8 Nov 2017 09:40:24 -0800
Subject: [PATCH 01/48] For issue #61 updated screenToSeriesY to use the
 vertical bounds rather than horizontal (#62)

---
 .../com/androidplot/xy/XYGraphWidget.java     |  2 +-
 .../com/androidplot/xy/XYGraphWidgetTest.java | 22 +++++++++----------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index a6460799..d1ce96ec 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -489,7 +489,7 @@ protected float seriesToScreenX(Number x) {
 
     protected float seriesToScreenY(Number y) {
         return (float) plot.getBounds().getyRegion().
-                transform(y.doubleValue(), gridRect.left, gridRect.right, true);
+                transform(y.doubleValue(), gridRect.bottom, gridRect.top, true);
     }
 
     @Override
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 4b9f156a..0bfe4d9d 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -79,7 +79,7 @@ public void setUp() throws Exception {
         xyPlot.setRangeStep(StepMode.INCREMENT_BY_VAL, 1);
 
         graphWidget = spy(new XYGraphWidget(layoutManager, xyPlot, size));
-        graphWidget.setGridRect(new RectF(0, 0, 100, 100));
+        graphWidget.setGridRect(new RectF(0, 0, 10, 100));
         graphWidget.setLabelRect(new RectF(0, 0, 100, 100));
     }
 
@@ -253,11 +253,11 @@ public void testScreenToSeries() throws Exception {
         assertEquals(-100, coords.x.intValue());
         assertEquals(100, coords.y.intValue());
 
-        coords = graphWidget.screenToSeries(new PointF(100, 100));
+        coords = graphWidget.screenToSeries(new PointF(10, 100));
         assertEquals(100, coords.x.intValue());
         assertEquals(-100, coords.y.intValue());
 
-        coords = graphWidget.screenToSeries(new PointF(50, 50));
+        coords = graphWidget.screenToSeries(new PointF(5, 50));
         assertEquals(0, coords.x.intValue());
         assertEquals(0, coords.y.intValue());
     }
@@ -271,11 +271,11 @@ public void testSeriesToScreen() throws Exception {
         assertEquals(0f, point.y);
 
         point = graphWidget.seriesToScreen(new XYCoords(100, -100));
-        assertEquals(100f, point.x);
+        assertEquals(10f, point.x);
         assertEquals(100f, point.y);
 
         point = graphWidget.seriesToScreen(new XYCoords(0, 0));
-        assertEquals(50f, point.x);
+        assertEquals(5f, point.x);
         assertEquals(50f, point.y);
     }
 
@@ -284,8 +284,8 @@ public void testScreenToSeriesX() throws Exception {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(-100, graphWidget.screenToSeriesX(new PointF(0, 0)).intValue());
-        assertEquals(100, graphWidget.screenToSeriesX(new PointF(100, 100)).intValue());
-        assertEquals(0, graphWidget.screenToSeriesX(new PointF(50, 50)).intValue());
+        assertEquals(100, graphWidget.screenToSeriesX(new PointF(10, 100)).intValue());
+        assertEquals(0, graphWidget.screenToSeriesX(new PointF(5, 50)).intValue());
     }
 
     @Test
@@ -302,16 +302,16 @@ public void testSeriesToScreenX() throws Exception {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(0f, graphWidget.seriesToScreenX(-100));
-        assertEquals(100f, graphWidget.seriesToScreenX(100));
-        assertEquals(50f, graphWidget.seriesToScreenX(0));
+        assertEquals(10f, graphWidget.seriesToScreenX(100));
+        assertEquals(5f, graphWidget.seriesToScreenX(0));
     }
 
     @Test
     public void testSeriesToScreenY() throws Exception {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
-        assertEquals(0f, graphWidget.seriesToScreenY(100));
-        assertEquals(100f, graphWidget.seriesToScreenY(-100));
+        assertEquals(100f, graphWidget.seriesToScreenY(100));
+        assertEquals(0f, graphWidget.seriesToScreenY(-100));
         assertEquals(50f, graphWidget.seriesToScreenY(0));
     }
 }

From 55fce04bff334e0988aa253b25eeb667456d5be8 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@users.noreply.github.com>
Date: Fri, 8 Dec 2017 08:43:17 -0600
Subject: [PATCH 02/48] Androidplot 1.5.2 (#65)

* target Android SDK 26
* update fig dependency for gradle 3.x.x support
* adds custom renderer documentation
* remove obsolete class / unnecessary casts
* adds sizing section to plot_composition.md
* adds more sizing and positioning documentation
---
 .circleci/config.yml                          |   2 +-
 androidplot-core/build.gradle                 |   6 +-
 .../src/main/java/com/androidplot/Plot.java   |   8 +-
 .../java/com/androidplot/ui/Formatter.java    |   6 +-
 .../java/com/androidplot/ui/SizeMetric.java   |   1 -
 .../ui/widget/LegendItemOrganizer.java        |   9 --
 .../java/com/androidplot/xy/BarRenderer.java  |   2 +-
 .../com/androidplot/xy/XYRegionFormatter.java |   6 +-
 .../src/main/res/values/attrs.xml             |  51 ++++++-
 build.gradle                                  |  13 +-
 demoapp-wearable/build.gradle                 |   2 +-
 demoapp/build.gradle                          |  11 +-
 .../demos/SimpleXYPlotActivity.java           |   6 +-
 .../demos/TouchZoomExampleActivity.java       |   8 +-
 .../demos/XYRegionExampleActivity.java        |  12 +-
 .../src/main/res/layout/bar_plot_example.xml  |  54 ++++----
 .../src/main/res/layout/demo_app_widget.xml   |  17 ++-
 .../res/layout/dynamic_xyplot_example.xml     |  22 +--
 demoapp/src/main/res/layout/main.xml          |  54 +++++---
 demoapp/src/main/res/layout/pie_chart.xml     |   3 +-
 .../main/res/layout/step_chart_example.xml    |  25 ++--
 .../main/res/layout/time_series_example.xml   |  42 +++---
 .../main/res/layout/touch_zoom_example.xml    |  49 +++----
 demoapp/src/main/res/values-hdpi/dimens.xml   |  18 ---
 demoapp/src/main/res/values-ldpi/dimens.xml   |  20 ---
 demoapp/src/main/res/values/dimens.xml        |  18 ---
 demoapp/src/main/res/values/style.xml         |  28 ----
 docs/attrs.md                                 |  50 ++++++-
 docs/custom_renderer.md                       | 101 ++++++++++++++
 docs/grouprenderer.md                         |   8 +-
 docs/images/rounded_bar_renderer.png          | Bin 0 -> 70585 bytes
 docs/images/sizing/abs100x-abs100y.png        | Bin 0 -> 5852 bytes
 docs/images/sizing/abs100x-abs150y.png        | Bin 0 -> 6725 bytes
 docs/images/sizing/abs100x-rel1y.png          | Bin 0 -> 6049 bytes
 docs/images/sizing/fil50x-fil50y.png          | Bin 0 -> 7882 bytes
 docs/images/sizing/rel075x-abs100y.png        | Bin 0 -> 5907 bytes
 docs/index.md                                 |   1 +
 docs/plot_composition.md                      | 131 +++++++++++++++++-
 docs/quickstart.md                            |   2 +-
 docs/release_notes.md                         |  12 ++
 gradle/wrapper/gradle-wrapper.properties      |   4 +-
 41 files changed, 527 insertions(+), 275 deletions(-)
 delete mode 100644 androidplot-core/src/main/java/com/androidplot/ui/widget/LegendItemOrganizer.java
 delete mode 100644 demoapp/src/main/res/values-ldpi/dimens.xml
 delete mode 100644 demoapp/src/main/res/values/style.xml
 create mode 100644 docs/custom_renderer.md
 create mode 100644 docs/images/rounded_bar_renderer.png
 create mode 100644 docs/images/sizing/abs100x-abs100y.png
 create mode 100644 docs/images/sizing/abs100x-abs150y.png
 create mode 100644 docs/images/sizing/abs100x-rel1y.png
 create mode 100644 docs/images/sizing/fil50x-fil50y.png
 create mode 100644 docs/images/sizing/rel075x-abs100y.png

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 43c50cfc..6a24c3f8 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -16,7 +16,7 @@ jobs:
 
       # CircleCI maintains a library of pre-built images
             # documented at https://circleci.com/docs/2.0/circleci-images/
-      - image: circleci/android:api-25-alpha
+      - image: circleci/android:api-26-alpha
 
     working_directory: ~/repo
 
diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 3e305c7d..a814a4c1 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -58,7 +58,6 @@ task generateAttrsMarkdown(type: AttrMarkdown) {
 
 android {
     compileSdkVersion theCompileSdkVersion
-    buildToolsVersion theBuildToolsVersion
 
     defaultConfig {
         versionCode theVersionCode
@@ -74,7 +73,6 @@ android {
     lintOptions {
         abortOnError false
     }
-    buildToolsVersion theBuildToolsVersion
 }
 
 group = 'com.androidplot'
@@ -85,8 +83,8 @@ def gitUrl = 'https://github.com/halfhp/androidplot.git'
 
 dependencies {
 
-    compile 'com.halfhp.fig:figlib:1.0.3'
-    compile 'com.android.support:support-annotations:25.3.1'
+    compile 'com.halfhp.fig:figlib:1.0.7'
+    compile 'com.android.support:support-annotations:27.0.2'
     testCompile "org.mockito:mockito-core:1.10.19"
     testCompile group: 'junit', name: 'junit', version: '4.12'
     testCompile "org.robolectric:robolectric:3.1"
diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index 3ee10174..8b436199 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -520,7 +520,7 @@ private void loadAttrs(AttributeSet attrs, int defStyle) {
 
             // apply "configurator" attrs: (overrides any previously applied styleable attrs)
             // filter out androidplot prefixed attrs:
-            HashMap<String, String> attrHash = new HashMap<String, String>();
+            HashMap<String, String> attrHash = new HashMap<>();
             for (int i = 0; i < attrs.getAttributeCount(); i++) {
                 String attrName = attrs.getAttributeName(i);
 
@@ -529,7 +529,11 @@ private void loadAttrs(AttributeSet attrs, int defStyle) {
                     attrHash.put(attrName.substring(XML_ATTR_PREFIX.length() + 1), attrs.getAttributeValue(i));
                 }
             }
-            Fig.configure(getContext(), this, attrHash);
+            try {
+                Fig.configure(getContext(), this, attrHash);
+            } catch (FigException e) {
+                throw new RuntimeException(e);
+            }
         }
     }
 
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/Formatter.java b/androidplot-core/src/main/java/com/androidplot/ui/Formatter.java
index 8f2a354b..d920ab36 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/Formatter.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/Formatter.java
@@ -48,7 +48,11 @@ public Formatter(Context ctx, int xmlCfgId) {
     }
 
     public void configure(Context ctx, int xmlCfgId) {
-        Fig.configure(ctx, this, xmlCfgId);
+        try {
+            Fig.configure(ctx, this, xmlCfgId);
+        } catch (FigException e) {
+            throw new RuntimeException(e);
+        }
     }
 
     /**
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/SizeMetric.java b/androidplot-core/src/main/java/com/androidplot/ui/SizeMetric.java
index e3819acd..d7f3e58b 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/SizeMetric.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/SizeMetric.java
@@ -43,7 +43,6 @@ protected void validatePair(float value, SizeMode layoutType) {
 
     @Override
     public float getPixelValue(float size) {
-        //switch(layoutType)
         switch(getLayoutType()) {
             case ABSOLUTE:
                 return getValue();
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendItemOrganizer.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendItemOrganizer.java
deleted file mode 100644
index 536ee9d8..00000000
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendItemOrganizer.java
+++ /dev/null
@@ -1,9 +0,0 @@
-package com.androidplot.ui.widget;
-
-import java.util.List;
-
-
-public interface LegendItemOrganizer<LegendItemT extends  LegendItem> {
-
-    void organize(List<LegendItemT> items);
-}
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
index c696bbf2..bb8c4c7f 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
@@ -238,7 +238,7 @@ protected RectF createBarRect(float w1, float h1, float w2, float h2, BarFormatt
         return result;
     }
 
-    protected void drawBar(Canvas canvas, Bar bar, RectF rect) {
+    protected void drawBar(Canvas canvas, Bar<FormatterType> bar, RectF rect) {
 
         // null yVals are skipped:
         if(bar.getY() == null) {
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYRegionFormatter.java b/androidplot-core/src/main/java/com/androidplot/xy/XYRegionFormatter.java
index b0a3186f..0492c6c2 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYRegionFormatter.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYRegionFormatter.java
@@ -43,7 +43,11 @@ public class XYRegionFormatter {
     public XYRegionFormatter(Context ctx, int xmlCfgId) {
         // prevent configuration of classes derived from this one:
         if (getClass().equals(XYRegionFormatter.class)) {
-            Fig.configure(ctx, this, xmlCfgId);
+            try {
+                Fig.configure(ctx, this, xmlCfgId);
+            } catch (FigException e) {
+                throw new RuntimeException(e);
+            }
         }
     }
 
diff --git a/androidplot-core/src/main/res/values/attrs.xml b/androidplot-core/src/main/res/values/attrs.xml
index e640706e..c9dc65a0 100644
--- a/androidplot-core/src/main/res/values/attrs.xml
+++ b/androidplot-core/src/main/res/values/attrs.xml
@@ -16,12 +16,17 @@
   -->
 
 <!--
+_This documentation is auto generated from [attrs.xml](../androidplot-core/src/main/res/values/attrs.xml)._
+
 # Androidplot XML Attributes
 Attributes are broken down by element followed by either their type or list of accepted values.
-<br/>
-<br/>
-_This documentation is auto generated from [attrs.xml](../androidplot-core/src/main/res/values/attrs.xml) and should not be edited directly._
+Supported Elements:
+
+* [Plot](#Plot)
+* [XYPlot](#XYPlot)
+* [PieChart](#PieChart)
 -->
+<!--NODOC to generate from command line use: `./gradlew generateAttrsMarkdown` -->
 <resources>
 
     <attr name="renderMode" format="enum">
@@ -442,6 +447,10 @@ __dimension|float|integer__
 * relative_from_left
 * relative_from_right
 * relative_from_center
+
+`HorizontalPositioning` component of the `HorizontalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="domainTitleHorizontalPositioning"/>
 <!--
@@ -452,16 +461,28 @@ __dimension|float|integer__
 * relative_from_top
 * relative_from_bottom
 * relative_from_center
+
+`VerticalPositioning` component of the `VerticalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="domainTitleVerticalPositioning"/>
 <!--
 ### domainTitleHorizontalPosition
 __dimension|float|integer__
+
+`float` value component of the `HorizontalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="domainTitleHorizontalPosition" format="dimension|float|integer"/>
 <!--
 ### domainTitleVerticalPosition
 __dimension|float|integer__
+
+`float` value component of the `VerticalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="domainTitleVerticalPosition" format="dimension|float|integer"/>
 <!--
@@ -570,7 +591,7 @@ __boolean__
 -->
         <attr name="rangeTitleVisible" format="boolean"/>
 <!--
-### graphHeight
+### drawGridOnTop
 __boolean__
 <br/>
 (default is false) When set to true, grid lines are drawn on top of rendered series data
@@ -617,6 +638,9 @@ __dimension|float|integer__
 * relative_from_left
 * relative_from_right
 * relative_from_center
+
+`HorizontalPositioning` component of the `HorizontalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="graphHorizontalPositioning"/>
 <!--
@@ -627,16 +651,25 @@ __dimension|float|integer__
 * relative_from_top
 * relative_from_bottom
 * relative_from_center
+
+`VerticalPositioning` component of the `VerticalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="graphVerticalPositioning"/>
 <!--
 ### graphHorizontalPosition
 __dimension|float|integer__
+
+`float` value component of the `HorizontalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="graphHorizontalPosition" format="dimension|float|integer"/>
 <!--
 ### graphVerticalPosition
 __dimension|float|integer__
+
+`float` value component of the `VerticalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="graphVerticalPosition" format="dimension|float|integer"/>
 <!--
@@ -977,6 +1010,8 @@ __dimension|float|integer__
         <attr name="legendWidth" format="dimension|float|integer"/>
 <!--
 ### legendHorizontalPositioning
+`HorizontalPositioning` component of the `HorizontalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 * absolute_from_left
 * absolute_from_right
 * absolute_from_center
@@ -987,6 +1022,8 @@ __dimension|float|integer__
         <attr name="legendHorizontalPositioning"/>
 <!--
 ### legendVerticalPositioning
+`VerticalPositioning` component of the `VerticalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 * absolute_from_top
 * absolute_from_bottom
 * absolute_from_center
@@ -998,11 +1035,17 @@ __dimension|float|integer__
 <!--
 ### legendHorizontalPosition
 __dimension|float|integer__
+
+`float` value component of the `HorizontalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="legendHorizontalPosition" format="dimension|float|integer"/>
 <!--
 ### legendVerticalPosition
 __dimension|float|integer__
+
+`float` value component of the `VerticalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 -->
         <attr name="legendVerticalPosition" format="dimension|float|integer"/>
 <!--
diff --git a/build.gradle b/build.gradle
index dad2f2f7..ff256eab 100644
--- a/build.gradle
+++ b/build.gradle
@@ -23,9 +23,8 @@ allprojects {
 }
 
 ext {
-    theBuildToolsVersion = '25.0.2'
-    theCompileSdkVersion = 25
-    theTargetSdkVersion = 25
+    theCompileSdkVersion = 26
+    theTargetSdkVersion = 26
     theMinSdkVersion = 5
     theVersionName = '1.5.2'
     theVersionCode = 0
@@ -35,13 +34,14 @@ buildscript {
     repositories {
         mavenCentral()
         jcenter()
+        google()
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.3.3'
+        classpath 'com.android.tools.build:gradle:3.0.1'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
-        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7'
-        classpath 'com.vanniktech:gradle-android-junit-jacoco-plugin:0.5.0'
+        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
+        classpath 'com.vanniktech:gradle-android-junit-jacoco-plugin:0.6.0'
         classpath 'org.kt3k.gradle.plugin:coveralls-gradle-plugin:2.6.3'
     }
 }
@@ -49,6 +49,7 @@ buildscript {
 allprojects {
     repositories {
         mavenCentral()
+        google()
     }
 }
 
diff --git a/demoapp-wearable/build.gradle b/demoapp-wearable/build.gradle
index 8154801c..b4afad27 100644
--- a/demoapp-wearable/build.gradle
+++ b/demoapp-wearable/build.gradle
@@ -19,7 +19,7 @@ buildscript {
         jcenter()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.3.3'
+        classpath 'com.android.tools.build:gradle:3.0.1'
     }
 }
 apply plugin: 'com.android.application'
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index 8702a396..c501ed33 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -21,9 +21,9 @@ dependencies {
 	compile project(':androidplot-core')
     compile 'com.crittercism:crittercism-android-agent:5.4.0'
 
-    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5'
-    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5'
-    testCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5'
+    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.1'
+    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.1'
+    testCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.1'
 }
 
 buildscript {
@@ -31,7 +31,6 @@ buildscript {
     repositories {
         mavenCentral()
     }
-
     dependencies {
         classpath 'com.github.triplet.gradle:play-publisher:1.1.5'
     }
@@ -39,12 +38,11 @@ buildscript {
 
 android {
     compileSdkVersion theCompileSdkVersion
-    buildToolsVersion theBuildToolsVersion
 
     defaultConfig {
         versionCode theVersionCode
         versionName theVersionName
-        minSdkVersion 11
+        minSdkVersion 14
         targetSdkVersion theTargetSdkVersion
         applicationId "com.androidplot.demos"
     }
@@ -76,7 +74,6 @@ android {
     lintOptions {
         abortOnError false
     }
-    buildToolsVersion '25.0.0'
 }
 
 play {
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index 69326b2e..b673f512 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -21,6 +21,8 @@
 import android.os.Bundle;
 import android.support.annotation.NonNull;
 
+import com.androidplot.ui.Size;
+import com.androidplot.ui.SizeMode;
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.CatmullRomInterpolator;
 import com.androidplot.xy.LineAndPointFormatter;
@@ -91,9 +93,7 @@ public void onCreate(Bundle savedInstanceState)
 
         plot.getGraph().getLineLabelStyle(XYGraphWidget.Edge.BOTTOM).setFormat(new Format() {
             @Override
-            public StringBuffer format(Object obj,
-                                       @NonNull StringBuffer toAppendTo,
-                                       @NonNull FieldPosition pos) {
+            public StringBuffer format(Object obj, @NonNull StringBuffer toAppendTo, @NonNull FieldPosition pos) {
                 int i = Math.round(((Number) obj).floatValue());
                 return toAppendTo.append(domainLabels[i]);
             }
diff --git a/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java b/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
index 94d1efa5..c4105cde 100644
--- a/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
@@ -41,14 +41,14 @@ public class TouchZoomExampleActivity extends Activity {
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.touch_zoom_example);
-        resetButton = (Button) findViewById(R.id.resetButton);
+        resetButton = findViewById(R.id.resetButton);
         resetButton.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View view) {
                 reset();
             }
         });
-        plot = (XYPlot) findViewById(R.id.plot);
+        plot = findViewById(R.id.plot);
 
         // set a fixed origin and a "by-value" step mode so that grid lines will
         // move dynamically with the data when the users pans or zooms:
@@ -63,8 +63,8 @@ public void onClick(View view) {
         plot.setRangeStepModel( new StepModelFit(plot.getBounds().getyRegion(),inc_range,NUM_GRIDLINES));
 
 
-        panSpinner = (Spinner) findViewById(R.id.pan_spinner);
-        zoomSpinner = (Spinner) findViewById(R.id.zoom_spinner);
+        panSpinner = findViewById(R.id.pan_spinner);
+        zoomSpinner = findViewById(R.id.zoom_spinner);
         plot.getGraph().setLinesPerRangeLabel(2);
         plot.getGraph().setLinesPerDomainLabel(2);
         plot.getGraph().getBackgroundPaint().setColor(Color.TRANSPARENT);
diff --git a/demoapp/src/main/java/com/androidplot/demos/XYRegionExampleActivity.java b/demoapp/src/main/java/com/androidplot/demos/XYRegionExampleActivity.java
index c9cc953d..0f48c3c2 100644
--- a/demoapp/src/main/java/com/androidplot/demos/XYRegionExampleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/XYRegionExampleActivity.java
@@ -69,8 +69,8 @@ public class XYRegionExampleActivity extends Activity {
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.xyregion_example);
-        plot = (XYPlot) findViewById(R.id.xyRegionExamplePlot);
-        timCB = (CheckBox) findViewById(R.id.s1CheckBox);
+        plot = findViewById(R.id.xyRegionExamplePlot);
+        timCB = findViewById(R.id.s1CheckBox);
         timCB.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
@@ -78,7 +78,7 @@ public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
             }
         });
 
-        nickCB = (CheckBox) findViewById(R.id.s2CheckBox);
+        nickCB = findViewById(R.id.s2CheckBox);
         nickCB.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
@@ -86,7 +86,7 @@ public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
             }
         });
 
-        r2CheckBox = (CheckBox) findViewById(R.id.r2CheckBox);
+        r2CheckBox = findViewById(R.id.r2CheckBox);
         r2CheckBox.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
@@ -94,7 +94,7 @@ public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
             }
         });
 
-        r3CheckBox = (CheckBox) findViewById(R.id.r3CheckBox);
+        r3CheckBox = findViewById(R.id.r3CheckBox);
         r3CheckBox.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
@@ -102,7 +102,7 @@ public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
             }
         });
 
-        r4CheckBox = (CheckBox) findViewById(R.id.r4CheckBox);
+        r4CheckBox = findViewById(R.id.r4CheckBox);
         r4CheckBox.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton compoundButton, boolean b) {
diff --git a/demoapp/src/main/res/layout/bar_plot_example.xml b/demoapp/src/main/res/layout/bar_plot_example.xml
index e607f973..3182342d 100644
--- a/demoapp/src/main/res/layout/bar_plot_example.xml
+++ b/demoapp/src/main/res/layout/bar_plot_example.xml
@@ -1,5 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
+<?xml version="1.0" encoding="utf-8"?><!--
   ~ Copyright 2015 AndroidPlot.com
   ~
   ~    Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,49 +15,50 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              xmlns:ap="http://schemas.android.com/apk/res-auto"
-              style="@style/sample_activity"
-              android:orientation="vertical">
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
 
     <com.androidplot.xy.XYPlot
-        style="@style/APDefacto.Light"
         android:id="@+id/plot"
+        style="@style/APDefacto.Light"
         android:layout_width="fill_parent"
         android:layout_height="fill_parent"
-        ap:title="Growth"
+        android:layout_weight="1"
+        ap:gridClippingEnabled="false"
         ap:gridInsetLeft="35dp"
         ap:gridInsetRight="10dp"
-        ap:gridClippingEnabled="false"
-        android:layout_weight="1"/>
+        ap:title="Growth" />
 
     <LinearLayout
-        android:layout_height="wrap_content"
         android:layout_width="fill_parent"
+        android:layout_height="wrap_content"
         android:layout_gravity="center"
         android:orientation="horizontal">
 
         <Spinner
             android:id="@+id/spRenderStyle"
             android:layout_width="wrap_content"
-            android:layout_height="wrap_content"/>
+            android:layout_height="wrap_content" />
 
         <Spinner
             android:id="@+id/spSeriesSize"
             android:layout_width="wrap_content"
-            android:layout_height="wrap_content"/>
+            android:layout_height="wrap_content" />
 
     </LinearLayout>
 
     <LinearLayout
-        android:layout_height="wrap_content"
         android:layout_width="fill_parent"
+        android:layout_height="wrap_content"
         android:layout_gravity="center"
         android:orientation="horizontal">
 
         <Spinner
             android:id="@+id/spWidthStyle"
             android:layout_width="wrap_content"
-            android:layout_height="wrap_content"/>
+            android:layout_height="wrap_content" />
 
         <RelativeLayout
             android:id="@+id/sectionGraph"
@@ -66,43 +66,43 @@
             android:layout_height="wrap_content">
 
             <SeekBar
+                android:id="@+id/sbFixed"
                 android:layout_width="fill_parent"
                 android:layout_height="wrap_content"
+                android:max="300"
                 android:paddingLeft="10dp"
                 android:paddingRight="10dp"
-                android:max="300"
-                android:progress="10"
-                android:id="@+id/sbFixed"/>
+                android:progress="10" />
 
             <SeekBar
+                android:id="@+id/sbVariable"
                 android:layout_width="fill_parent"
                 android:layout_height="wrap_content"
+                android:max="50"
                 android:paddingLeft="10dp"
                 android:paddingRight="10dp"
-                android:max="50"
-                android:progress="1"
-                android:id="@+id/sbVariable"/>
+                android:progress="1" />
         </RelativeLayout>
     </LinearLayout>
 
     <LinearLayout
-        android:layout_height="wrap_content"
         android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
         android:layout_gravity="center"
         android:orientation="horizontal">
 
         <CheckBox
             android:id="@+id/s1CheckBox"
-            android:text="Series 1"
-            android:checked="true"
+            android:layout_width="fill_parent"
             android:layout_height="wrap_content"
-            android:layout_width="fill_parent"/>
+            android:checked="true"
+            android:text="Series 1" />
 
         <CheckBox
             android:id="@+id/s2CheckBox"
-            android:text="Series 2"
-            android:checked="true"
+            android:layout_width="fill_parent"
             android:layout_height="wrap_content"
-            android:layout_width="fill_parent"/>
+            android:checked="true"
+            android:text="Series 2" />
     </LinearLayout>
 </LinearLayout>
\ No newline at end of file
diff --git a/demoapp/src/main/res/layout/demo_app_widget.xml b/demoapp/src/main/res/layout/demo_app_widget.xml
index 85b5fe6b..81977453 100644
--- a/demoapp/src/main/res/layout/demo_app_widget.xml
+++ b/demoapp/src/main/res/layout/demo_app_widget.xml
@@ -17,14 +17,13 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              style="@style/sample_activity"
-              android:orientation="vertical">
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
 
-    <ImageView
-            xmlns:android="http://schemas.android.com/apk/res/android"
-            android:id="@+id/imgView"
-            android:scaleType="centerInside"
-            android:layout_width="fill_parent"
-            android:layout_height="fill_parent">
-    </ImageView>
+    <ImageView xmlns:android="http://schemas.android.com/apk/res/android"
+        android:id="@+id/imgView"
+        android:layout_width="fill_parent"
+        android:layout_height="fill_parent"
+        android:scaleType="centerInside"></ImageView>
 </LinearLayout>
\ No newline at end of file
diff --git a/demoapp/src/main/res/layout/dynamic_xyplot_example.xml b/demoapp/src/main/res/layout/dynamic_xyplot_example.xml
index ddfd0cba..5b0c5644 100644
--- a/demoapp/src/main/res/layout/dynamic_xyplot_example.xml
+++ b/demoapp/src/main/res/layout/dynamic_xyplot_example.xml
@@ -1,5 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
+<?xml version="1.0" encoding="utf-8"?><!--
   ~ Copyright 2015 AndroidPlot.com
   ~
   ~    Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,22 +15,23 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              xmlns:ap="http://schemas.android.com/apk/res-auto"
-              style="@style/sample_activity">
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
 
     <com.androidplot.xy.XYPlot
-        style="@style/APDefacto.Dark"
         android:id="@+id/dynamicXYPlot"
+        style="@style/APDefacto.Dark"
+        androidplot.renderMode="use_background_thread"
         android:layout_width="fill_parent"
         android:layout_height="fill_parent"
-        androidplot.renderMode="use_background_thread"
-        ap:title="A Dynamic XY Plot"
         ap:domainTitle="Domain"
-        ap:rangeTitle="Range"
-        ap:legendTextSize="15sp"
+        ap:legendAnchor="right_bottom"
+        ap:legendHeight="25dp"
         ap:legendIconHeight="15dp"
         ap:legendIconWidth="15dp"
-        ap:legendHeight="25dp"
-        ap:legendAnchor="right_bottom"/>
+        ap:legendTextSize="15sp"
+        ap:rangeTitle="Range"
+        ap:title="A Dynamic XY Plot" />
 
 </LinearLayout>
diff --git a/demoapp/src/main/res/layout/main.xml b/demoapp/src/main/res/layout/main.xml
index 65a43ef9..590087de 100644
--- a/demoapp/src/main/res/layout/main.xml
+++ b/demoapp/src/main/res/layout/main.xml
@@ -32,99 +32,117 @@
 
             <Button
                 android:id="@+id/startSimplePieExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Pie Chart"/>
 
             <Button
                 android:id="@+id/startSimpleXYExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="A Simple XY Plot"/>
 
             <Button
                 android:id="@+id/animatedXYPlotExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Animated XY Plot"/>
 
             <Button
                 android:id="@+id/startScatterExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="XY Scatter Plot"/>
 
             <Button
                 android:id="@+id/startDynamicXYExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="A Dynamic XY Plot"/>
 
             <Button
                 android:id="@+id/startCandlestickExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Candlestick Chart"/>
 
             <Button
                 android:id="@+id/startOrSensorExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Realtime Orientation Sensor Plot"/>
 
             <Button
                 android:id="@+id/startDualScaleExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Dual Scale XY"/>
 
             <Button
                 android:id="@+id/startTimeSeriesExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="@string/ts_title"/>
 
             <Button
                 android:id="@+id/startStepChartExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Step Chart"
                 />
 
             <Button
                 android:id="@+id/startScrollZoomButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Scroll and Zoom"
                 />
 
             <Button
                 android:id="@+id/startBarPlotExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Bar Plot"/>
 
             <Button
                 android:id="@+id/startXyRegionExampleButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="XYRegion Example"
                 android:enabled="true"/>
 
             <Button
                 android:id="@+id/startXyListViewExButton"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="ListView of XYPlots"
                 android:enabled="true"/>
 
             <Button
                 android:id="@+id/startXYPlotWithBgImgExample"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="XY Background Example"
                 android:enabled="true"/>
 
             <Button
                 android:id="@+id/startECGExample"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="ECG Example"
                 android:enabled="true"/>
 
             <Button
                 android:id="@+id/fxPlotExample"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="f(x) Example"
                 android:enabled="true"/>
 
             <Button
                 android:id="@+id/bubbleChartExample"
-                style="@style/toc_button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
                 android:text="Bubble Chart Example"
                 android:enabled="true"/>
         </LinearLayout>
diff --git a/demoapp/src/main/res/layout/pie_chart.xml b/demoapp/src/main/res/layout/pie_chart.xml
index e6fd0b0c..3722d9e2 100644
--- a/demoapp/src/main/res/layout/pie_chart.xml
+++ b/demoapp/src/main/res/layout/pie_chart.xml
@@ -16,7 +16,8 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              style="@style/sample_activity"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
               android:orientation="vertical">
 
     <com.androidplot.pie.PieChart
diff --git a/demoapp/src/main/res/layout/step_chart_example.xml b/demoapp/src/main/res/layout/step_chart_example.xml
index 9ce501ab..d72dc051 100644
--- a/demoapp/src/main/res/layout/step_chart_example.xml
+++ b/demoapp/src/main/res/layout/step_chart_example.xml
@@ -1,5 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
+<?xml version="1.0" encoding="utf-8"?><!--
   ~ Copyright 2015 AndroidPlot.com
   ~
   ~    Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,18 +15,18 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              xmlns:ap="http://schemas.android.com/apk/res-auto"
-              android:orientation="vertical"
-              style="@style/sample_activity"
-    >
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
 
     <com.androidplot.xy.XYPlot
-    android:id="@+id/stepChartExamplePlot"
-    style="@style/APDefacto.Dark"
-    android:layout_width="fill_parent"
-    android:layout_height="fill_parent"
-    ap:title="HTTP Server State (15  Sec)"
-    ap:domainTitle="time (secs)"
-    ap:rangeTitle="server state"/>
+        android:id="@+id/stepChartExamplePlot"
+        style="@style/APDefacto.Dark"
+        android:layout_width="fill_parent"
+        android:layout_height="fill_parent"
+        ap:domainTitle="time (secs)"
+        ap:rangeTitle="server state"
+        ap:title="HTTP Server State (15  Sec)" />
 </LinearLayout>
 
diff --git a/demoapp/src/main/res/layout/time_series_example.xml b/demoapp/src/main/res/layout/time_series_example.xml
index 2bcaa251..37b59957 100644
--- a/demoapp/src/main/res/layout/time_series_example.xml
+++ b/demoapp/src/main/res/layout/time_series_example.xml
@@ -17,27 +17,27 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              xmlns:ap="http://schemas.android.com/apk/res-auto"
-
-              style="@style/sample_activity"
-              android:orientation="vertical">
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
 
     <com.androidplot.xy.XYPlot
-            android:id="@+id/plot1"
-            style="@style/APDefacto.Light"
-            android:layout_width="fill_parent"
-            android:layout_height="fill_parent"
-            ap:title="@string/ts_plot1_title"
-            ap:paddingTop="10dp"
-            ap:paddingBottom="10dp"
-            ap:paddingLeft="10dp"
-            ap:paddingRight="10dp"
-            ap:backgroundColor="@color/ap_white"
-            ap:graphBackgroundColor="@color/ap_white"
-            ap:lineLabelRotationBottom="-45"
-            ap:gridInsetLeft="35dp"
-            ap:gridInsetBottom="40dp"
-            ap:lineLabelInsetLeft="25dp"
-            ap:lineLabelInsetBottom="25dp"
-            renderMode="use_main_thread"/>
+        android:id="@+id/plot1"
+        style="@style/APDefacto.Light"
+        renderMode="use_main_thread"
+        android:layout_width="fill_parent"
+        android:layout_height="fill_parent"
+        ap:backgroundColor="@color/ap_white"
+        ap:graphBackgroundColor="@color/ap_white"
+        ap:gridInsetBottom="40dp"
+        ap:gridInsetLeft="35dp"
+        ap:lineLabelInsetBottom="25dp"
+        ap:lineLabelInsetLeft="25dp"
+        ap:lineLabelRotationBottom="-45"
+        ap:paddingBottom="10dp"
+        ap:paddingLeft="10dp"
+        ap:paddingRight="10dp"
+        ap:paddingTop="10dp"
+        ap:title="@string/ts_plot1_title" />
 </LinearLayout>
\ No newline at end of file
diff --git a/demoapp/src/main/res/layout/touch_zoom_example.xml b/demoapp/src/main/res/layout/touch_zoom_example.xml
index 654b0c67..5f3bd5da 100644
--- a/demoapp/src/main/res/layout/touch_zoom_example.xml
+++ b/demoapp/src/main/res/layout/touch_zoom_example.xml
@@ -1,5 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
+<?xml version="1.0" encoding="utf-8"?><!--
   ~ Copyright 2015 AndroidPlot.com
   ~
   ~    Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,46 +15,47 @@
   -->
 
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              xmlns:ap="http://schemas.android.com/apk/res-auto"
-              style="@style/sample_activity"
-              android:background="@color/ap_black"
-              android:orientation="vertical">
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="@color/ap_black"
+    android:orientation="vertical">
 
     <com.androidplot.xy.XYPlot
-        style="@style/APDefacto.Dark"
         android:id="@+id/plot"
-        ap:renderMode="use_background_thread"
+        style="@style/APDefacto.Dark"
         android:layout_width="fill_parent"
         android:layout_height="fill_parent"
-        ap:title="A Simple XY Plot"
+        android:layout_weight="1"
         ap:drawGridOnTop="true"
-        android:layout_weight="1"/>
+        ap:renderMode="use_background_thread"
+        ap:title="A Simple XY Plot" />
 
     <LinearLayout
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
-        android:gravity="center"
         android:layout_margin="3dp"
+        android:gravity="center"
         android:orientation="horizontal">
 
         <LinearLayout
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
-            android:orientation="vertical"
-            android:layout_weight="5">
+            android:layout_weight="5"
+            android:orientation="vertical">
 
             <TextView
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:paddingLeft="15dp"
-                android:textSize="12sp"
-                android:text="Pan"/>
+                android:text="Pan"
+                android:textSize="12sp" />
 
             <Spinner
                 android:id="@+id/pan_spinner"
-                android:padding="0dp"
                 android:layout_width="match_parent"
-                android:layout_height="wrap_content">
+                android:layout_height="wrap_content"
+                android:padding="0dp">
 
             </Spinner>
         </LinearLayout>
@@ -63,29 +63,30 @@
         <LinearLayout
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
-            android:orientation="vertical"
-            android:layout_weight="3">
+            android:layout_weight="3"
+            android:orientation="vertical">
 
             <TextView
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:paddingLeft="15dp"
-                android:textSize="12sp"
-                android:text="Zoom"/>
+                android:text="Zoom"
+                android:textSize="12sp" />
 
             <Spinner
                 android:id="@+id/zoom_spinner"
-                android:padding="0dp"
                 android:layout_width="match_parent"
-                android:layout_height="wrap_content">
+                android:layout_height="wrap_content"
+                android:padding="0dp">
 
             </Spinner>
         </LinearLayout>
     </LinearLayout>
+
     <Button
         android:id="@+id/resetButton"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
 
-        android:text="Reset"/>
+        android:text="Reset" />
 </LinearLayout>
\ No newline at end of file
diff --git a/demoapp/src/main/res/values-hdpi/dimens.xml b/demoapp/src/main/res/values-hdpi/dimens.xml
index df9a1f9f..2c320eef 100644
--- a/demoapp/src/main/res/values-hdpi/dimens.xml
+++ b/demoapp/src/main/res/values-hdpi/dimens.xml
@@ -1,21 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-  ~ Copyright 2015 AndroidPlot.com
-  ~
-  ~    Licensed under the Apache License, Version 2.0 (the "License");
-  ~    you may not use this file except in compliance with the License.
-  ~    You may obtain a copy of the License at
-  ~
-  ~        http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~    Unless required by applicable law or agreed to in writing, software
-  ~    distributed under the License is distributed on an "AS IS" BASIS,
-  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~    See the License for the specific language governing permissions and
-  ~    limitations under the License.
-  -->
-
-<!-- HDPI DIMENSIONS -->
 <resources>
     <dimen name="title_font_size">30dp</dimen>
     <dimen name="pie_segment_label_font_size">20dp</dimen>
diff --git a/demoapp/src/main/res/values-ldpi/dimens.xml b/demoapp/src/main/res/values-ldpi/dimens.xml
deleted file mode 100644
index a58e6c64..00000000
--- a/demoapp/src/main/res/values-ldpi/dimens.xml
+++ /dev/null
@@ -1,20 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-  ~ Copyright 2015 AndroidPlot.com
-  ~
-  ~    Licensed under the Apache License, Version 2.0 (the "License");
-  ~    you may not use this file except in compliance with the License.
-  ~    You may obtain a copy of the License at
-  ~
-  ~        http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~    Unless required by applicable law or agreed to in writing, software
-  ~    distributed under the License is distributed on an "AS IS" BASIS,
-  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~    See the License for the specific language governing permissions and
-  ~    limitations under the License.
-  -->
-
-<!-- LDPI DIMENSIONS -->
-<resources>
-</resources>
\ No newline at end of file
diff --git a/demoapp/src/main/res/values/dimens.xml b/demoapp/src/main/res/values/dimens.xml
index a4ea138d..23de7062 100644
--- a/demoapp/src/main/res/values/dimens.xml
+++ b/demoapp/src/main/res/values/dimens.xml
@@ -1,21 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-  ~ Copyright 2015 AndroidPlot.com
-  ~
-  ~    Licensed under the Apache License, Version 2.0 (the "License");
-  ~    you may not use this file except in compliance with the License.
-  ~    You may obtain a copy of the License at
-  ~
-  ~        http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~    Unless required by applicable law or agreed to in writing, software
-  ~    distributed under the License is distributed on an "AS IS" BASIS,
-  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~    See the License for the specific language governing permissions and
-  ~    limitations under the License.
-  -->
-
-<!-- DEFAULT DIMENSIONS -->
 <resources>
 
     <!-- Default screen margins, per the Android Design guidelines. -->
diff --git a/demoapp/src/main/res/values/style.xml b/demoapp/src/main/res/values/style.xml
deleted file mode 100644
index df216a42..00000000
--- a/demoapp/src/main/res/values/style.xml
+++ /dev/null
@@ -1,28 +0,0 @@
-<!--
-  ~ Copyright 2015 AndroidPlot.com
-  ~
-  ~    Licensed under the Apache License, Version 2.0 (the "License");
-  ~    you may not use this file except in compliance with the License.
-  ~    You may obtain a copy of the License at
-  ~
-  ~        http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~    Unless required by applicable law or agreed to in writing, software
-  ~    distributed under the License is distributed on an "AS IS" BASIS,
-  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~    See the License for the specific language governing permissions and
-  ~    limitations under the License.
-  -->
-
-<resources xmlns="http://schemas.android.com/apk/lib/com.androidplot.xy">
-
-    <style name="sample_activity">
-        <item name="android:layout_width">fill_parent</item>
-        <item name="android:layout_height">fill_parent</item>
-    </style>
-
-    <style name="toc_button">
-        <item name="android:layout_width">fill_parent</item>
-        <item name="android:layout_height">wrap_content</item>
-    </style>
-</resources>
\ No newline at end of file
diff --git a/docs/attrs.md b/docs/attrs.md
index 00f79651..256852d7 100644
--- a/docs/attrs.md
+++ b/docs/attrs.md
@@ -1,8 +1,12 @@
+_This documentation is auto generated from [attrs.xml](../androidplot-core/src/main/res/values/attrs.xml)._
+
 # Androidplot XML Attributes
 Attributes are broken down by element followed by either their type or list of accepted values.
-<br/>
-<br/>
-_This documentation is auto generated from [attrs.xml](../androidplot-core/src/main/res/values/attrs.xml) and should not be edited directly._
+Supported Elements:
+
+* [Plot](#Plot)
+* [XYPlot](#XYPlot)
+* [PieChart](#PieChart)
 
 ## Plot
 Plot's attrs are available in all Plot types.
@@ -111,6 +115,10 @@ __dimension|float|integer__
 * relative_from_right
 * relative_from_center
 
+`HorizontalPositioning` component of the `HorizontalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### domainTitleVerticalPositioning
 * absolute_from_top
 * absolute_from_bottom
@@ -119,12 +127,24 @@ __dimension|float|integer__
 * relative_from_bottom
 * relative_from_center
 
+`VerticalPositioning` component of the `VerticalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### domainTitleHorizontalPosition
 __dimension|float|integer__
 
+`float` value component of the `HorizontalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### domainTitleVerticalPosition
 __dimension|float|integer__
 
+`float` value component of the `VerticalPosition` of the `TextLabelWidget`
+that displays the domain title.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### domainTitleAnchor
 * top_middle
 * left_top
@@ -200,7 +220,7 @@ __dimension|float|integer__
 ### rangeTitleVisible
 __boolean__
 
-### graphHeight
+### drawGridOnTop
 __boolean__
 <br/>
 (default is false) When set to true, grid lines are drawn on top of rendered series data
@@ -236,6 +256,9 @@ __dimension|float|integer__
 * relative_from_right
 * relative_from_center
 
+`HorizontalPositioning` component of the `HorizontalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### graphVerticalPositioning
 * absolute_from_top
 * absolute_from_bottom
@@ -244,12 +267,21 @@ __dimension|float|integer__
 * relative_from_bottom
 * relative_from_center
 
+`VerticalPositioning` component of the `VerticalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### graphHorizontalPosition
 __dimension|float|integer__
 
+`float` value component of the `HorizontalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### graphVerticalPosition
 __dimension|float|integer__
 
+`float` value component of the `VerticalPosition` of the `XYGraphWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### graphAnchor
 * top_middle
 * left_top
@@ -478,6 +510,8 @@ __dimension|float|integer__
 __dimension|float|integer__
 
 ### legendHorizontalPositioning
+`HorizontalPositioning` component of the `HorizontalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 * absolute_from_left
 * absolute_from_right
 * absolute_from_center
@@ -486,6 +520,8 @@ __dimension|float|integer__
 * relative_from_center
 
 ### legendVerticalPositioning
+`VerticalPositioning` component of the `VerticalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
 * absolute_from_top
 * absolute_from_bottom
 * absolute_from_center
@@ -496,9 +532,15 @@ __dimension|float|integer__
 ### legendHorizontalPosition
 __dimension|float|integer__
 
+`float` value component of the `HorizontalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### legendVerticalPosition
 __dimension|float|integer__
 
+`float` value component of the `VerticalPosition` of the `XYLegendWidget`.
+See [Positioning Widgets](plot_composition.md#positioning-widgets) documentation.
+
 ### legendAnchor
 * top_middle
 * left_top
diff --git a/docs/custom_renderer.md b/docs/custom_renderer.md
new file mode 100644
index 00000000..e9302b24
--- /dev/null
+++ b/docs/custom_renderer.md
@@ -0,0 +1,101 @@
+# Custom Renderers
+Androidplot renderers can be extended with extra functionality in the form of custom renderers.
+For the example below we'll look at creating a custom implementation of BarRenderer that will
+draw bars with rounded edges.  While this example demonstrates an `XYPlot`, the steps apply to
+`PieChart` etc. as well.
+
+## Create the Formatter
+The first step to creating a custom renderer is defining it's `Formatter`.  Aside from providing
+the visual configuration used by the `Renderer` to draw series data, it's also used by Androidplot
+to map a series to a specific renderer type and if necessary, obtain a new instance of that renderer.
+Here's the most basic implementation:
+
+```java
+class RoundedBarFormatter extends BarFormatter {
+    
+    {
+        // for now we'll hardcode some formatting values.
+        // a real implementation would probably provide a constructor instead
+        getLinePaint().setColor(Color.WHITE);
+        getFillPaint().setColor(Color.RED);
+    }
+
+    @Override
+    public Class<RoundedBarRenderer> getRendererClass() {
+        return RoundedBarRenderer.class;
+    }
+
+    @Override
+    public RoundedBarRenderer doGetRendererInstance(XYPlot xyPlot) {
+        return new RoundedBarRenderer(plot);
+    }
+}
+```
+
+## Create the Renderer
+All we want to do here is tweak the way `BarRenderer` behaves a little so we'll use it as our base class:
+
+```java
+class RoundedBarRenderer extends BarRenderer<RoundedBarFormatter> {
+
+    public RoundedBarRenderer(XYPlot plot) {
+        super(plot);
+    }
+
+    @Override
+    protected void drawBar(Canvas canvas, Bar<RoundedBarFormatter> bar, RectF rect) {
+        // TODO this is where we'll add our custom behavior
+    }
+}
+```
+
+In the case of our RoundedBarFormatter, the behavior we need to change all exits within the 
+`drawBar(Canvas, Bar, RectF)` method.  The existing implementation uses `Canvas.drawRect(...)` to
+draw bars.  We could use a stroke with rounded edges, but this would cause the edges on both the top
+and the bottom to be rounded, which won't look right.  We'll draw using a path instead:
+
+```java
+@Override
+protected void drawBar(Canvas canvas, Bar<RoundedBarFormatter> bar, RectF rect) {
+
+    // skip nulls:
+    if(bar.getY() == null) {
+        return;
+    }
+
+    RoundedBarFormatter formatter = getFormatter(bar.i, bar.series);
+    if(formatter == null) {
+        formatter = bar.formatter;
+    }
+
+    // don't need to draw if the bar lacks height or width:
+    if (rect.height() > 0 && rect.width() > 0) {
+        final Path path = new Path();
+        final float arcHeightPx = 20;
+        final float adjustedTop = rect.top + arcHeightPx;
+        final RectF cap = new RectF(rect.left, rect.top, rect.right,rect.top + 2 * arcHeightPx);
+
+        // start at bottom-left and move clock-wise around the shape:
+        path.moveTo(rect.left, rect.bottom);
+        path.lineTo(rect.left, adjustedTop);
+        path.arcTo(cap, 180, 180, false);
+        path.lineTo(rect.right, rect.bottom);
+        path.close();
+
+        canvas.drawPath(path, formatter.getFillPaint());
+        canvas.drawPath(path, formatter.getBorderPaint());
+    }
+}
+```
+
+## Use It
+Using the new custom renderer is as easy as adding a series to a plot using `RoundedBarFormatter`:
+
+```java
+plot.addSeries(series1, new RoundedBarFormatter(Color.RED));
+plot.addSeries(series2, new RoundedBarFormatter(Color.BLUE));
+```
+
+Here's what this would look like used in the demo app's `SimpleXYPlotActivity`:
+
+![image](images/screens/rounded_bar_renderer.png)
\ No newline at end of file
diff --git a/docs/grouprenderer.md b/docs/grouprenderer.md
index 755b05eb..8a8ce9d1 100644
--- a/docs/grouprenderer.md
+++ b/docs/grouprenderer.md
@@ -1,11 +1,11 @@
 # GroupRenderer
-GroupRenderer is a special implementation of XYSeriesRenderer that combines multiple instances
-of XYSeries into a single virtual series of s higher dimension.  Examples of GroupRenderer are:
+`GroupRenderer` is a special implementation of `XYSeriesRenderer` that combines multiple instances
+of `XYSeries` into a single virtual series of s higher dimension.  Examples of `GroupRenderer` are:
 
 * BarRenderer
 * CandlestickRenderer
 
-Let's take a quick look at CandlestickRenderer.  A candlestick chart is basically a two two dimensional 
+Let's take a quick look at `CandlestickRenderer`.  A candlestick chart is basically a two two dimensional 
 representation of a complex value; for every value of x a single candlestick is drawn, but there are 
 four values (dimensions) that make up each candlestick:
 
@@ -14,5 +14,5 @@ four values (dimensions) that make up each candlestick:
 * high
 * low
 
-When a series is added to the plot with a formatter associated with a renderer that extends GroupRenderer,
+When a series is added to the plot with a formatter associated with a renderer that extends `GroupRenderer`,
 all series added with formatters of the same type are automatically "grouped" together during rendering.
\ No newline at end of file
diff --git a/docs/images/rounded_bar_renderer.png b/docs/images/rounded_bar_renderer.png
new file mode 100644
index 0000000000000000000000000000000000000000..4afd37d44b28cee727b4b16a8ec1820c08445fac
GIT binary patch
literal 70585
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%0DO_GT-{m~Qx7ID2E)<emSWv+t<DGQ{$J}VZl
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
Yw!an(_+jY194&W7PDwUZ#^~mM0KjFh2mk;8

literal 0
HcmV?d00001

diff --git a/docs/images/sizing/abs100x-abs100y.png b/docs/images/sizing/abs100x-abs100y.png
new file mode 100644
index 0000000000000000000000000000000000000000..03176840ddf420693e4c469d62aa57ee4ed63be0
GIT binary patch
literal 5852
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
Hhv5GLr6uvq

literal 0
HcmV?d00001

diff --git a/docs/images/sizing/abs100x-abs150y.png b/docs/images/sizing/abs100x-abs150y.png
new file mode 100644
index 0000000000000000000000000000000000000000..c1c8159dfb00e851a0eaec8278650920e33760ce
GIT binary patch
literal 6725
zcmd^E<yTZ)+aKa4q!~s+Kw<!CX++wg8|iN8ZlrUD1}PcB0Rf2_L<FU!C8a?rsi7N`
z5TA3u|H8B0FYo)|oU_had!4=4-q-c31J~77A-l(L4+H{{sj0&Bf#(`<%@GlRKser|
z?bg5xj-S4YA_zUkxB~*w|5bx27zE=SScW7)1}<f#4u|RdmCJn8`YovzQ86t2`Lrv7
z>QHzBD{TFtKy+Rd8{M~09Mr1vx-m)ABShD|NvhMg(@73r;BJie7CsV5J|)|9{>YuV
zO3mh9%b$N~2Q5_}?iOQKm(hpSQUPPXE_SL9(P*|TlD|#KrY;e_lhV1=5ZQ=Z6ZfFQ
z#hpj1?}B5eEj0239C1v0YE3`DLSqSZ5J3mu4fn&ihw1m=i^P#uB%CxSOm(*JXo=l-
zc4umK;%Ti)C(2Y>mE7Z(f}4`KG?*ksh^4|V`2zN4`MIAI;x6<5>3F2(yr$hu@|R6r
zOD;E`{fU)ah(x}OK{W*1f+u*xZQa(X(U<*)uP(BpMcMUB<YgZ7jZOj$TY|BHvvr#i
z=gr!I6SIgDX~6C@oKvS*b8oiJFCEL^BS`*^*6V(o{Qx;@XL)(t?@FHFPSVi08NFKZ
z;G&n&9(!rSUHWxghL4UzPoK{?CEB?>%9)LtV}G?HwNdP#W@>6;qWYuRi?)SH%0DSr
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

literal 0
HcmV?d00001

diff --git a/docs/images/sizing/abs100x-rel1y.png b/docs/images/sizing/abs100x-rel1y.png
new file mode 100644
index 0000000000000000000000000000000000000000..b62cf708f5b3c7a3cb85753c374f8a3986adc489
GIT binary patch
literal 6049
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

literal 0
HcmV?d00001

diff --git a/docs/images/sizing/fil50x-fil50y.png b/docs/images/sizing/fil50x-fil50y.png
new file mode 100644
index 0000000000000000000000000000000000000000..6dd24012348abca8fdf61865a99627926dc8bcda
GIT binary patch
literal 7882
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
NPD)v_UfeY7e*tH2)L8%k

literal 0
HcmV?d00001

diff --git a/docs/images/sizing/rel075x-abs100y.png b/docs/images/sizing/rel075x-abs100y.png
new file mode 100644
index 0000000000000000000000000000000000000000..d0328550f7e5790ae864d9bf60d1372fb4fe3678
GIT binary patch
literal 5907
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

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
index abb8a729..8eed3556 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -23,6 +23,7 @@ specific plot types explaining styling and other advanced topics.
 * [Bubble Charts](bubblechart.md)
 * [Dynamic Plots](dynamicdata.md)
 * [Advanced XY Plot Topics](advanced_xy_plot.md)
+* [Custom Renderers](custom_renderer.md)
 
 # Examples
 Source code examples of the various plot types.
diff --git a/docs/plot_composition.md b/docs/plot_composition.md
index 3252b9f5..5812d7d7 100644
--- a/docs/plot_composition.md
+++ b/docs/plot_composition.md
@@ -76,6 +76,9 @@ Using example #1 above, an Anchor value of `Anchor.LEFT_TOP` means that  the top
 would be positioned at the screen coordinate [200, 50].
 
 #### Examples
+The examples below illustrate positioning an `XYGraphWidget` of an `XYPlot`.
+
+xml:
 ```xml
 ap:graphAnchor="right_bottom"
 ap:graphHorizontalPositioning="absolute_from_right"
@@ -83,8 +86,16 @@ ap:graphHorizontalPosition="0dp"
 ap:graphVerticalPositioning="relative_from_bottom"
 ap:graphVerticalPosition="0dp"
 ```
+java:
+```java
+plot.getGraph().position(
+        0, HorizontalPositioning.ABSOLUTE_FROM_RIGHT,
+        0, VerticalPositioning.RELATIVE_TO_BOTTOM);
+```
 ![alt text](images/positioning/bottom-right-absolute.png "bottom-right-absolute")
 ***
+
+xml:
 ```xml
 ap:graphAnchor="right_bottom"
 ap:graphHorizontalPositioning="absolute_from_right"
@@ -92,8 +103,16 @@ ap:graphHorizontalPosition="10dp"
 ap:graphVerticalPositioning="relative_from_bottom"
 ap:graphVerticalPosition="10dp"
 ```
+java:
+```java
+plot.getGraph().position(
+        PixelUtils.dpToPix(10), HorizontalPositioning.ABSOLUTE_FROM_RIGHT,
+        PixelUtils.dpToPix(10), VerticalPositioning.RELATIVE_TO_BOTTOM);
+```
 ![alt text](images/positioning/bottom-right-absolute-with-offset.png "bottom-right-absolute-with-offset")
 ***
+
+xml:
 ```xml
 ap:graphAnchor="right_bottom"
 ap:graphHorizontalPositioning="absolute_from_left"
@@ -101,8 +120,16 @@ ap:graphHorizontalPosition="0dp"
 ap:graphVerticalPositioning="relative_from_top"
 ap:graphVerticalPosition="0dp"
 ```
-![alt text](images/positioning/top-left-absolute.png "top-left-absolute")
+java:
+```java
+plot.getGraph().position(
+        0, HorizontalPositioning.ABSOLUTE_FROM_LEFT,
+        0, VerticalPositioning.RELATIVE_TO_TOP);
+```
+![alt text](image``s/positioning/top-left-absolute.png "top-left-absolute")
 ***
+
+xml:
 ```xml
 ap:graphAnchor="center"
 ap:graphHorizontalPositioning="absolute_from_center"
@@ -110,17 +137,111 @@ ap:graphHorizontalPosition="0dp"
 ap:graphVerticalPositioning="absolute_from_center"
 ap:graphVerticalPosition="0dp"
 ```
+java:
+```java
+plot.getGraph().position(
+        0, HorizontalPositioning.ABSOLUTE_FROM_CENTER,
+        0, VerticalPositioning.ABSOLUTE_FROM_CENTER);
+```
 ![alt text](images/positioning/center-absolute.png "center-absolute")
 
 
-## Scaling Widgets
-TODO
+## Sizing Widgets
+The size and shape of a `Widget` is controlled by it's `setSize(Size)` method.
+
+### Size
+The `Size` parameter of `Widget.setSize(Size)` defines the height and width of the associated Widget.
+It is composed of two `SizeMetric` instances; one for height and one for width.
+`Size` provides two constructors: `Size(SizeMetric, SizeMetric)` or
+`Size(int, SizeMode, int, SizeMode)`.  Constructor params represent height and width respectively.
 
 ### SizeMetric
-TODO
+A `SizeMetric` is composed of a `SizeMode` and a float value.  There are three kinds of `SizeMode`:
+
+* ABSOLUTE - float value defines the size metric as an absolute value in pixels.
+* RELATIVE - float value defines the size of the metric relative to the size of the containing Plot along
+the associated axis, in the range of 0.0 to 1.0.
+* FILL - float value defines an absolute value in pixels to subtract from the size of the containing 
+Plot along the associated axis and the SizeMetric "fills" the difference.
 
 #### Examples
-TODO
+The examples below illustrate positioning an `XYGraphWidget` of an `XYPlot` and
+assume centered positioning is applied as described in the [Positioning Widgets](#positioning-widgets) section above.
+
+xml:
+```xml
+ap:graphHeightMode="absolute"
+ap:graphHeight="100dp"
+ap:graphWidthMode="absolute"
+ap:graphWidth="100dp"
+```
+java:
+```java
+plot.getGraph().setSize(new Size(
+        PixelUtils.dpToPix(100), SizeMode.ABSOLUTE,
+        PixelUtils.dpToPix(100), SizeMode.ABSOLUTE));
+```
+![alt text](images/sizing/abs100x-abs100y.png "x=100|ABSOLUTE, y=100|ABSOLUTE")
+***
+xml:
+```xml
+ap:graphHeightMode="absolute"
+ap:graphHeight="150dp"
+ap:graphWidthMode="absolute"
+ap:graphWidth="100dp"
+```
+java:
+```java
+plot.getGraph().setSize(new Size(
+        PixelUtils.dpToPix(150), SizeMode.ABSOLUTE,
+        PixelUtils.dpToPix(100), SizeMode.ABSOLUTE));
+```
+![alt text](images/sizing/abs100x-abs150y.png "x=100|ABSOLUTE, y=150|ABSOLUTE")
+***
+xml:
+```xml
+ap:graphHeightMode="relative"
+ap:graphHeight="1.0"
+ap:graphWidthMode="absolute"
+ap:graphWidth="100dp"
+```
+java:
+```java
+plot.getGraph().setSize(new Size(
+        1.0f, SizeMode.RELATIVE,
+        PixelUtils.dpToPix(100), SizeMode.ABSOLUTE));
+```
+![alt text](images/sizing/abs100x-rel1y.png "x=100|ABSOLUTE, y=1.0|RELATIVE")
+***
+xml:
+```xml
+ap:graphHeightMode="absolute"
+ap:graphHeight="100dp"
+ap:graphWidthMode="relative"
+ap:graphWidth="0.75"
+```
+java:
+```java
+plot.getGraph().setSize(new Size(
+        PixelUtils.dpToPix(100), SizeMode.ABSOLUTE,
+        0.75f, SizeMode.RELATIVE));
+```
+![alt text](images/sizing/rel075x-abs100y.png "x=0.75|RELATIVE, y=100|ABSOLUTE")
+***
+xml:
+```xml
+ap:graphHeightMode="fill"
+ap:graphHeight="50dp"
+ap:graphWidthMode="fill"
+ap:graphWidth="50dp"
+```
+java:
+```java
+plot.getGraph().setSize(new Size(
+        PixelUtils.dpToPix(50), SizeMode.FILL,
+        PixelUtils.dpToPix(50), SizeMode.FILL));
+```
+![alt text](images/sizing/fil50x-fil50y.png "x=50|FILL, y=50|FILL")
 
 ## Margins and Padding
 Every widget has a margin, padding and an optional border that can be drawn around it.  These params behave 
diff --git a/docs/quickstart.md b/docs/quickstart.md
index cf238b57..5cdd05e2 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.1"
+    compile "com.androidplot:androidplot-core:1.5.2"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 7ea22016..a874032d 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,18 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.2
+_This version is pickier than it's predecessors about proper XML configuration.  Where
+previous versions would silently ignore illegal XML attrs, a `RuntimeException` will be thrown._
+* Added [sizing documentation](plot_composition.md#sizing-widgets)
+* Added [custom renderer documentation](custom_renderer.md)
+* Fixed (#61) Bug in `XYGraphWidget.screenToSeriesY(...)`.
+* Fixed (#63) Fixed compatibility issue with Gradle 3.x.x that caused issues with XML parsing.
+
+# 1.5.1
+* (#52) Fixed minor NPE issue
+* (#55) Fixed bug with `PieRenderer.getContainingSegment` not working for very large segments.
+
 # 1.5.0
 
 _Updates to legend functionality in this version may result in changes to the display order
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 12d6c54e..6bd840a3 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
-#Thu Mar 23 07:48:11 CDT 2017
+#Tue Dec 05 07:26:55 CST 2017
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-4.0-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip

From b60683f070fdf4a568c5099c2d2cf7acee19d119 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 18 Dec 2017 23:04:39 -0600
Subject: [PATCH 03/48] documentation cleanup

---
 androidplot-core/src/main/res/values/attrs.xml     |   6 +++---
 docs/custom_renderer.md                            |   2 +-
 docs/images/{ => screens}/rounded_bar_renderer.png | Bin
 docs/plot_composition.md                           |   4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)
 rename docs/images/{ => screens}/rounded_bar_renderer.png (100%)

diff --git a/androidplot-core/src/main/res/values/attrs.xml b/androidplot-core/src/main/res/values/attrs.xml
index c9dc65a0..535ccf18 100644
--- a/androidplot-core/src/main/res/values/attrs.xml
+++ b/androidplot-core/src/main/res/values/attrs.xml
@@ -22,9 +22,9 @@ _This documentation is auto generated from [attrs.xml](../androidplot-core/src/m
 Attributes are broken down by element followed by either their type or list of accepted values.
 Supported Elements:
 
-* [Plot](#Plot)
-* [XYPlot](#XYPlot)
-* [PieChart](#PieChart)
+* [Plot](#plot)
+* [XYPlot](#xyplot)
+* [PieChart](#piechart)
 -->
 <!--NODOC to generate from command line use: `./gradlew generateAttrsMarkdown` -->
 <resources>
diff --git a/docs/custom_renderer.md b/docs/custom_renderer.md
index e9302b24..e82f3ecf 100644
--- a/docs/custom_renderer.md
+++ b/docs/custom_renderer.md
@@ -16,7 +16,7 @@ class RoundedBarFormatter extends BarFormatter {
     {
         // for now we'll hardcode some formatting values.
         // a real implementation would probably provide a constructor instead
-        getLinePaint().setColor(Color.WHITE);
+        getBorderPaint().setColor(Color.WHITE);
         getFillPaint().setColor(Color.RED);
     }
 
diff --git a/docs/images/rounded_bar_renderer.png b/docs/images/screens/rounded_bar_renderer.png
similarity index 100%
rename from docs/images/rounded_bar_renderer.png
rename to docs/images/screens/rounded_bar_renderer.png
diff --git a/docs/plot_composition.md b/docs/plot_composition.md
index 5812d7d7..2c51e349 100644
--- a/docs/plot_composition.md
+++ b/docs/plot_composition.md
@@ -247,7 +247,7 @@ plot.getGraph().setSize(new Size(
 Every widget has a margin, padding and an optional border that can be drawn around it.  These params behave 
 very similarly to those defined in the [CSS Box Model](http://www.w3schools.com/css/css_boxmodel.asp).
 
-## Markup Mode.
+## Markup Mode
 If you're having trouble visualizing the effects of tweaking margins and padding, you can enable
 markup mode which will highlight these spaces on each widget, as well as draw a green line around it's
 absolute border.  
@@ -281,7 +281,7 @@ text style, etc. to apply while drawing.
 ## Renderers
 The Renderer is what renders Series data onto a Plot.  Users can provide their own custom rendering behavior
 by writing their own Renderer implementation along with a custom Formatter telling Androidplot about the
-Renderer via the `Formatter.getRendererClass()` method.
+Renderer via the `Formatter.getRendererClass()` method.  See [Custom Renderer](custom_rnderer.md) documentation.
 
 # XML Styling
 Androidplot supports an increasing number of XML attributes.  The two best resources for learning about

From 02ef341e0d924e81530cd3af8ef77de0946ab9a9 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Wed, 10 Jan 2018 07:25:56 -0600
Subject: [PATCH 04/48] minor tweaks to widget example

---
 .../demos/widget/DemoAppWidgetProvider.java       | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/demoapp/src/main/java/com/androidplot/demos/widget/DemoAppWidgetProvider.java b/demoapp/src/main/java/com/androidplot/demos/widget/DemoAppWidgetProvider.java
index fe3627b3..592fbce3 100644
--- a/demoapp/src/main/java/com/androidplot/demos/widget/DemoAppWidgetProvider.java
+++ b/demoapp/src/main/java/com/androidplot/demos/widget/DemoAppWidgetProvider.java
@@ -25,6 +25,8 @@
 import android.widget.RemoteViews;
 import com.androidplot.demos.R;
 import com.androidplot.ui.*;
+import com.androidplot.util.PixelUtils;
+import com.androidplot.xy.XYGraphWidget;
 import com.androidplot.xy.XYSeries;
 import com.androidplot.xy.LineAndPointFormatter;
 import com.androidplot.xy.SimpleXYSeries;
@@ -43,10 +45,6 @@ public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] a
 
             plot.getGraph().setMargins(0, 0, 0 , 0);
             plot.getGraph().setPadding(0, 0, 0, 0);
-//            plot.getGraphWidget().getDomainLineLabelPaint().setTextSize(PixelUtils.spToPix(10));
-//            plot.getGraphWidget().getRangeLineLabelPaint().setTextSize(PixelUtils.spToPix(10));
-//            plot.getGraphWidget().getDomainOriginLineLabelPaint().setTextSize(PixelUtils.spToPix(10));
-//            plot.getGraphWidget().getRangeOriginLineLabelPaint().setTextSize(PixelUtils.spToPix(10));
 
             plot.getGraph().position(0, HorizontalPositioning.ABSOLUTE_FROM_LEFT, 0,
                     VerticalPositioning.ABSOLUTE_FROM_TOP, Anchor.LEFT_TOP);
@@ -55,6 +53,15 @@ public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] a
 
             plot.getLayoutManager().moveToTop(plot.getTitle());
 
+            plot.getGraph().setLineLabelEdges(XYGraphWidget.Edge.LEFT, XYGraphWidget.Edge.BOTTOM);
+            plot.getGraph().getLineLabelInsets().setLeft(PixelUtils.dpToPix(16));
+            plot.getGraph().getLineLabelInsets().setBottom(PixelUtils.dpToPix(4));
+            plot.getGraph().getLineLabelStyle(XYGraphWidget.Edge.LEFT).getPaint().setColor(Color.RED);
+            plot.getGraph().getGridInsets().setTop(PixelUtils.dpToPix(12));
+            plot.getGraph().getGridInsets().setRight(PixelUtils.dpToPix(12));
+            plot.getGraph().getGridInsets().setLeft(PixelUtils.dpToPix(36));
+            plot.getGraph().getGridInsets().setBottom(PixelUtils.dpToPix(16));
+
             plot.measure(w, h);
             plot.layout(0, 0, w, h);
 

From 98ee573d5cde4cbbc5d412716672ce8ada5a09dd Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Wed, 10 Jan 2018 07:40:34 -0600
Subject: [PATCH 05/48] adds javadoc artifact to circleci builds

---
 .circleci/config.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 6a24c3f8..a3cd7bfe 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -79,6 +79,10 @@ jobs:
           path: androidplot-core/build/reports/tests/
           destination: test_results
 
+      - store_artifacts:
+          path: androidplot-core/build/docs/javadoc
+          destination: javadoc
+
       - store_test_results:
           path: androidplot-core/build/test-results/
 

From dcddd7f6f5f05334352d561702ddfa26f8da4485 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Wed, 10 Jan 2018 09:56:45 -0600
Subject: [PATCH 06/48] #66 adds basic unit tests for CatmullRomInterpolator

---
 .../xy/CatmullRomInterpolator.java            |  6 +-
 .../xy/CatmullRomInterpolatorTest.java        | 59 +++++++++++++++++++
 2 files changed, 62 insertions(+), 3 deletions(-)
 create mode 100644 androidplot-core/src/test/java/com/androidplot/xy/CatmullRomInterpolatorTest.java

diff --git a/androidplot-core/src/main/java/com/androidplot/xy/CatmullRomInterpolator.java b/androidplot-core/src/main/java/com/androidplot/xy/CatmullRomInterpolator.java
index 31e272f6..aea93ecd 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/CatmullRomInterpolator.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/CatmullRomInterpolator.java
@@ -20,7 +20,7 @@
 import java.util.List;
 
 /**
- * A primitive implementation of Catmull-Rom interpolation, based on the information found at:
+ * An implementation of Catmull-Rom interpolation, based on the information found at:
  * http://stackoverflow.com/questions/9489736/catmull-rom-curve-with-no-cusps-and-no-self-intersections/19283471#19283471
  */
 public class CatmullRomInterpolator implements Interpolator<CatmullRomInterpolator.Params> {
@@ -196,7 +196,7 @@ public List<XYCoords> interpolate(XYSeries series, Params params) {
      * @return the list of coordinates that define the CatmullRom curve
      * between the points defined by index+1 and index+2.
      */
-    public List<XYCoords> interpolate(XYSeries series, int index, Params params) {
+    protected List<XYCoords> interpolate(XYSeries series, int index, Params params) {
         List<XYCoords> result = new ArrayList<>();
         double[] x = new double[4];
         double[] y = new double[4];
@@ -251,7 +251,7 @@ public List<XYCoords> interpolate(XYSeries series, int index, Params params) {
      *             position between p1 and p2 to interpolate the value.
      * @return
      */
-    public static double interpolate(double[] p, double[] time, double t) {
+    protected static double interpolate(double[] p, double[] time, double t) {
         double L01 = p[0] * (time[1] - t) / (time[1] - time[0]) + p[1] * (t - time[0]) / (time[1] - time[0]);
         double L12 = p[1] * (time[2] - t) / (time[2] - time[1]) + p[2] * (t - time[1]) / (time[2] - time[1]);
         double L23 = p[2] * (time[3] - t) / (time[3] - time[2]) + p[3] * (t - time[2]) / (time[3] - time[2]);
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/CatmullRomInterpolatorTest.java b/androidplot-core/src/test/java/com/androidplot/xy/CatmullRomInterpolatorTest.java
new file mode 100644
index 00000000..1d672daf
--- /dev/null
+++ b/androidplot-core/src/test/java/com/androidplot/xy/CatmullRomInterpolatorTest.java
@@ -0,0 +1,59 @@
+package com.androidplot.xy;
+
+import org.junit.Test;
+
+import java.util.List;
+
+import static junit.framework.Assert.assertEquals;
+import static org.mockito.Mockito.mock;
+
+public class CatmullRomInterpolatorTest {
+
+    @Test(expected = IllegalArgumentException.class)
+    public void interpolate_invalidPointsPerSegment_throwsIllegalArgumentException() {
+        final XYSeries series = mock(XYSeries.class);
+        final CatmullRomInterpolator.Params params =
+                new CatmullRomInterpolator.Params(1, CatmullRomInterpolator.Type.Centripetal);
+
+        new CatmullRomInterpolator().interpolate(series, params);
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void interpolate_twoElementSeries_throwsIllegalArgumentException() {
+        final XYSeries series = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "test", 1, 2);
+        final CatmullRomInterpolator.Params params =
+                new CatmullRomInterpolator.Params(2, CatmullRomInterpolator.Type.Centripetal);
+
+        new CatmullRomInterpolator().interpolate(series, params);
+    }
+
+    @Test
+    public void interpolate_threeElementSeriesAndThreePointsPerSegment_producesFivePoints() {
+        final XYSeries series = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "test", 1, 2, 3);
+        final CatmullRomInterpolator.Params params =
+                new CatmullRomInterpolator.Params(3, CatmullRomInterpolator.Type.Centripetal);
+        final List<XYCoords> interpolated = new CatmullRomInterpolator().interpolate(series, params);
+
+        assertEquals(5, interpolated.size());
+
+        // control points should exactly match input:
+        assertEquals(1, interpolated.get(0).y);
+        assertEquals(2, interpolated.get(2).y);
+        assertEquals(3, interpolated.get(4).y);
+    }
+
+    @Test
+    public void interpolate_threeElementSeriesAndFourPointsPerSegment_producesSavenPoints() {
+        final XYSeries series = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "test", 1, 2, 3);
+        final CatmullRomInterpolator.Params params =
+                new CatmullRomInterpolator.Params(4, CatmullRomInterpolator.Type.Centripetal);
+        final List<XYCoords> interpolated = new CatmullRomInterpolator().interpolate(series, params);
+
+        assertEquals(7, interpolated.size());
+
+        // control points should exactly match input:
+        assertEquals(1, interpolated.get(0).y);
+        assertEquals(2, interpolated.get(3).y);
+        assertEquals(3, interpolated.get(6).y);
+    }
+}

From 5c4950baf1cbb73512e3256c00bb1c590f890eb5 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Wed, 10 Jan 2018 09:58:23 -0600
Subject: [PATCH 07/48] uprev to 1.5.3

---
 build.gradle          | 2 +-
 docs/index.md         | 2 +-
 docs/quickstart.md    | 2 +-
 docs/release_notes.md | 7 +++++++
 4 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/build.gradle b/build.gradle
index ff256eab..b1e30c15 100644
--- a/build.gradle
+++ b/build.gradle
@@ -26,7 +26,7 @@ ext {
     theCompileSdkVersion = 26
     theTargetSdkVersion = 26
     theMinSdkVersion = 5
-    theVersionName = '1.5.2'
+    theVersionName = '1.5.3'
     theVersionCode = 0
 }
 
diff --git a/docs/index.md b/docs/index.md
index 8eed3556..4959db92 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -42,7 +42,7 @@ Source code examples of the various plot types.
 # XML Attributes
 A complete list of XML attributes is [available here](attrs.md).
 # Javadoc
-The latest Javadocs are [available here](https://circleci.com/api/v1/project/halfhp/androidplot/latest/artifacts/0/$CIRCLE_ARTIFACTS/javadoc/index.html).
+The latest Javadocs are [available here](https://javadoc.io/doc/com.androidplot/androidplot-core).
 
 # Release Notes
 Full release notes are [available here](release_notes.md)
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 5cdd05e2..16f58280 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.2"
+    compile "com.androidplot:androidplot-core:1.5.3"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index a874032d..1a7c1984 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,7 +2,13 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.3
+
+* Minor cleanup of Widget example source.
+* (#67) Fixes Javadoc link
+
 # 1.5.2
+
 _This version is pickier than it's predecessors about proper XML configuration.  Where
 previous versions would silently ignore illegal XML attrs, a `RuntimeException` will be thrown._
 * Added [sizing documentation](plot_composition.md#sizing-widgets)
@@ -11,6 +17,7 @@ previous versions would silently ignore illegal XML attrs, a `RuntimeException`
 * Fixed (#63) Fixed compatibility issue with Gradle 3.x.x that caused issues with XML parsing.
 
 # 1.5.1
+
 * (#52) Fixed minor NPE issue
 * (#55) Fixed bug with `PieRenderer.getContainingSegment` not working for very large segments.
 

From a26e5377d5782a244a20a1456e28e341bafb73e0 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@users.noreply.github.com>
Date: Wed, 28 Feb 2018 21:03:33 -0600
Subject: [PATCH 08/48] 1.5.4 Changes (#74)

* #69 Fixes resize etc. for Y_VALS_ONLY format for SimpleXYSeries.

* #73 Fixes issue with XYGraphWidget not laying out on size change.  Also adds Widget.onResize to efficiently detect when new layout dimensions may need recalculation.

* Adds license and issue template for Github display
---
 .github/ISSUE_TEMPLATE.md                     |  14 ++
 LICENSE.md                                    |  13 ++
 README.md                                     |   2 +-
 .../com/androidplot/ui/LayoutManager.java     |   2 +-
 .../com/androidplot/ui/widget/Widget.java     | 132 +++++++++++-------
 .../com/androidplot/xy/SimpleXYSeries.java    |  13 +-
 .../com/androidplot/xy/XYGraphWidget.java     |  16 +--
 .../com/androidplot/ui/widget/WidgetTest.java | 112 +++++++++++++++
 .../androidplot/xy/SimpleXYSeriesTest.java    |  30 +++-
 .../com/androidplot/xy/XYGraphWidgetTest.java |   8 +-
 build.gradle                                  |   2 +-
 .../res/layout/simple_xy_plot_example.xml     |  17 ++-
 docs/quickstart.md                            |   2 +-
 docs/release_notes.md                         |   7 +-
 14 files changed, 283 insertions(+), 87 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE.md
 create mode 100644 LICENSE.md
 create mode 100644 androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
new file mode 100644
index 00000000..1e022fdb
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,14 @@
+Thanks for taking the time to help make Androidplot better!  Please note
+that issues should be submitted on Github for bugs only.
+
+How-to questions may be posted under the [Androidplot tag on Stack Overflow](https://stackoverflow.com/questions/tagged/androidplot)
+and feature requests etc. may be posted to the [Google Group Forum](https://groups.google.com/forum/#!forum/androidplot).
+
+When possible, please include the following in your bug report:
+
+* Description of the problem
+* Steps to reproduce the issue
+* Version(s) of Androidplot being used
+* A stacktrace if the issue is causing a crash
+
+
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 00000000..3fbf0a78
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,13 @@
+    Copyright 2018 Androidplot.com
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
\ No newline at end of file
diff --git a/README.md b/README.md
index 0e4e127d..7d7020d2 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@ Technical questions should be posted using the [androidplot tag](http://stackove
 # License
 Androidplot has been made available under the Apache 2.0 license:
 
-    Copyright 2016 Androidplot.com
+    Copyright 2018 Androidplot.com
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
index 9e66e80c..e4c5cce5 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
@@ -96,7 +96,7 @@ public void draw(Canvas canvas) throws PlotRenderException {
                 PositionMetrics metrics = widget.getPositionMetrics();
                 float elementWidth = widget.getWidthPix(displayDims.paddedRect.width());
                 float elementHeight = widget.getHeightPix(displayDims.paddedRect.height());
-                PointF coords = widget.getElementCoordinates(elementHeight,
+                PointF coords = Widget.calculateCoordinates(elementHeight,
                         elementWidth, displayDims.paddedRect, metrics);
 
                 DisplayDimensions dims = widget.getWidgetDimensions();
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
index 6009ce36..d66b85a8 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
@@ -17,6 +17,9 @@
 package com.androidplot.ui.widget;
 
 import android.graphics.*;
+import android.support.annotation.NonNull;
+import android.support.annotation.Nullable;
+
 import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.*;
 import com.androidplot.util.DisplayDimensions;
@@ -42,6 +45,7 @@ public abstract class Widget implements BoxModelable, Resizable {
     private LayoutManager layoutManager;
 
     private Rotation rotation = Rotation.NONE;
+    private RectF lastWidgetRect = null;
 
     public enum Rotation {
         NINETY_DEGREES,
@@ -77,6 +81,7 @@ public void setAnchor(Anchor anchor) {
     /**
      * Same as {@link #position(float, HorizontalPositioning, float, VerticalPositioning, Anchor)}
      * but with the anchor parameter defaulted to the upper left corner.
+     *
      * @param x
      * @param horizontalPositioning
      * @param y
@@ -87,11 +92,11 @@ public void position(float x, HorizontalPositioning horizontalPositioning, float
     }
 
     /**
-     * @param x            X-Coordinate of the top left corner of element.  When using RELATIVE, must be a value between 0 and 1.
+     * @param x                     X-Coordinate of the top left corner of element.  When using RELATIVE, must be a value between 0 and 1.
      * @param horizontalPositioning LayoutType to use when orienting this element's X-Coordinate.
-     * @param y            Y_VALS_ONLY-Coordinate of the top-left corner of element.  When using RELATIVE, must be a value between 0 and 1.
-     * @param verticalPositioning LayoutType to use when orienting this element's Y_VALS_ONLY-Coordinate.
-     * @param anchor       The point of reference used by this positioning call.
+     * @param y                     Y_VALS_ONLY-Coordinate of the top-left corner of element.  When using RELATIVE, must be a value between 0 and 1.
+     * @param verticalPositioning   LayoutType to use when orienting this element's Y_VALS_ONLY-Coordinate.
+     * @param anchor                The point of reference used by this positioning call.
      */
     public void position(float x, HorizontalPositioning horizontalPositioning, float y,
                          VerticalPositioning verticalPositioning, Anchor anchor) {
@@ -271,7 +276,7 @@ public float getMarginRight() {
      * into this Widget's size or position is altered.
      */
     public synchronized void refreshLayout() {
-        if(positionMetrics == null) {
+        if (positionMetrics == null) {
             // make sure positionMetrics have been set.  this method can be
             // automatically called during xml configuration of certain params
             // before the widget is fully configured.
@@ -279,7 +284,7 @@ public synchronized void refreshLayout() {
         }
         float elementWidth = getWidthPix(plotDimensions.paddedRect.width());
         float elementHeight = getHeightPix(plotDimensions.paddedRect.height());
-        PointF coords = getElementCoordinates(elementHeight,
+        PointF coords = calculateCoordinates(elementHeight,
                 elementWidth, plotDimensions.paddedRect, positionMetrics);
 
         RectF widgetRect = new RectF(coords.x, coords.y,
@@ -296,56 +301,76 @@ public synchronized void layout(final DisplayDimensions plotDimensions) {
         refreshLayout();
     }
 
-    public PointF getElementCoordinates(float height, float width, RectF viewRect, PositionMetrics metrics) {
-            float x = metrics.getXPositionMetric().getPixelValue(viewRect.width()) + viewRect.left;
-            float y = metrics.getYPositionMetric().getPixelValue(viewRect.height()) + viewRect.top;
-            PointF point = new PointF(x, y);
-            return PixelUtils.sub(point, getAnchorOffset(width, height, metrics.getAnchor()));
-        }
+
+    public static PointF calculateCoordinates(float height, float width, RectF viewRect, PositionMetrics metrics) {
+        float x = metrics.getXPositionMetric().getPixelValue(viewRect.width()) + viewRect.left;
+        float y = metrics.getYPositionMetric().getPixelValue(viewRect.height()) + viewRect.top;
+        PointF point = new PointF(x, y);
+        return PixelUtils.sub(point, getAnchorOffset(width, height, metrics.getAnchor()));
+    }
 
     public static PointF getAnchorOffset(float width, float height, Anchor anchor) {
-            PointF point = new PointF();
-            switch (anchor) {
-                case LEFT_TOP:
-                    break;
-                case LEFT_MIDDLE:
-                    point.set(0, height / 2);
-                    break;
-                case LEFT_BOTTOM:
-                    point.set(0, height);
-                    break;
-                case RIGHT_TOP:
-                    point.set(width, 0);
-                    break;
-                case RIGHT_BOTTOM:
-                    point.set(width, height);
-                    break;
-                case RIGHT_MIDDLE:
-                    point.set(width, height / 2);
-                    break;
-                case TOP_MIDDLE:
-                    point.set(width / 2, 0);
-                    break;
-                case BOTTOM_MIDDLE:
-                    point.set(width / 2, height);
-                    break;
-                case CENTER:
-                    point.set(width / 2, height / 2);
-                    break;
-                default:
-                    throw new IllegalArgumentException("Unsupported anchor location: " + anchor);
-            }
-            return point;
+        PointF point = new PointF();
+        switch (anchor) {
+            case LEFT_TOP:
+                break;
+            case LEFT_MIDDLE:
+                point.set(0, height / 2);
+                break;
+            case LEFT_BOTTOM:
+                point.set(0, height);
+                break;
+            case RIGHT_TOP:
+                point.set(width, 0);
+                break;
+            case RIGHT_BOTTOM:
+                point.set(width, height);
+                break;
+            case RIGHT_MIDDLE:
+                point.set(width, height / 2);
+                break;
+            case TOP_MIDDLE:
+                point.set(width / 2, 0);
+                break;
+            case BOTTOM_MIDDLE:
+                point.set(width / 2, height);
+                break;
+            case CENTER:
+                point.set(width / 2, height / 2);
+                break;
+            default:
+                throw new IllegalArgumentException("Unsupported anchor location: " + anchor);
         }
+        return point;
+    }
 
     public static PointF getAnchorCoordinates(RectF widgetRect, Anchor anchor) {
-            return PixelUtils.add(new PointF(widgetRect.left, widgetRect.top),
-                    getAnchorOffset(widgetRect.width(), widgetRect.height(), anchor));
-        }
+        return PixelUtils.add(new PointF(widgetRect.left, widgetRect.top),
+                getAnchorOffset(widgetRect.width(), widgetRect.height(), anchor));
+    }
+
+    public static PointF getAnchorCoordinates(float x, float y, float width, float height, Anchor anchor) {
+        return getAnchorCoordinates(new RectF(x, y, x + width, y + height), anchor);
+    }
 
-        public static PointF getAnchorCoordinates(float x, float y, float width, float height, Anchor anchor) {
-            return getAnchorCoordinates(new RectF(x, y, x+width, y+height), anchor);
+    private void checkSize(@NonNull RectF widgetRect) {
+        if (lastWidgetRect == null || !lastWidgetRect.equals(widgetRect)) {
+            onResize(lastWidgetRect, widgetRect);
         }
+        lastWidgetRect = widgetRect;
+    }
+
+    /**
+     * Called whenever the height or width of the Widget's reserved space has changed,
+     * immediately before {@link #doOnDraw(Canvas, RectF)}.
+     * May be used to efficiently carry out expensive operations only when necessary.
+     *
+     * @param oldRect
+     * @param newRect
+     */
+    protected void onResize(@Nullable RectF oldRect, @NonNull RectF newRect) {
+        // do nothing by default
+    }
 
     public void draw(Canvas canvas) throws PlotRenderException {
         if (isVisible()) {
@@ -353,12 +378,13 @@ public void draw(Canvas canvas) throws PlotRenderException {
                 drawBackground(canvas, widgetDimensions.canvasRect);
             }
             canvas.save();
-            final RectF paddedRect = applyRotation(canvas, widgetDimensions.paddedRect);
-            doOnDraw(canvas, paddedRect);
+            final RectF widgetRect = applyRotation(canvas, widgetDimensions.paddedRect);
+            checkSize(widgetRect);
+            doOnDraw(canvas, widgetRect);
             canvas.restore();
 
             if (borderPaint != null) {
-                drawBorder(canvas, paddedRect);
+                drawBorder(canvas, widgetRect);
             }
         }
     }
@@ -395,7 +421,7 @@ protected RectF applyRotation(Canvas canvas, RectF rect) {
                 throw new UnsupportedOperationException("Not yet implemented.");
 
         }
-        if(rotation != Rotation.NONE) {
+        if (rotation != Rotation.NONE) {
             canvas.rotate(rotationDegs, cx, cy);
         }
         return rect;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/SimpleXYSeries.java b/androidplot-core/src/main/java/com/androidplot/xy/SimpleXYSeries.java
index 4d3ebaac..b9178123 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/SimpleXYSeries.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/SimpleXYSeries.java
@@ -33,9 +33,6 @@
  * A convenience class used to create instances of XYPlot generated from Lists of Numbers.
  */
 public class SimpleXYSeries implements EditableXYSeries, OrderedXYSeries, PlotListener {
-
-    private static final String TAG = SimpleXYSeries.class.getName();
-
     private volatile LinkedList<Number> xVals = new LinkedList<>();
     private volatile LinkedList<Number> yVals = new LinkedList<>();
     private volatile String title = null;
@@ -144,7 +141,7 @@ public void setModel(List<? extends Number> model, ArrayFormat format) {
         lock.writeLock().lock();
         try {
             // empty the current values:
-            xVals = null;
+            xVals.clear();
             yVals.clear();
 
             // make sure the new model has data:
@@ -156,15 +153,16 @@ public void setModel(List<? extends Number> model, ArrayFormat format) {
 
                 // array containing only y-vals. assume x = index:
                 case Y_VALS_ONLY:
-                    for(Number n : model) {
-                        yVals.add(n);
+                    yVals.addAll(model);
+                    for(int i = 0; i < yVals.size(); i++) {
+                        xVals.add(i);
                     }
                     break;
 
                 // xy interleaved array:
                 case XY_VALS_INTERLEAVED:
                     if (xVals == null) {
-                        xVals = new LinkedList<Number>();
+                        xVals = new LinkedList<>();
                     }
                     if (model.size() % 2 != 0) {
                         throw new IndexOutOfBoundsException("Cannot auto-generate series from odd-sized xy List.");
@@ -217,7 +215,6 @@ public void resize(int size) {
         try {
             lock.writeLock().lock();
             if (xVals.size() < size) {
-
                 for (int i = xVals.size(); i < size; i++) {
                     xVals.add(null);
                     yVals.add(null);
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index d1ce96ec..2ecd4fcb 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -22,6 +22,8 @@
 import android.graphics.Paint;
 import android.graphics.PointF;
 import android.graphics.RectF;
+import android.support.annotation.NonNull;
+import android.support.annotation.Nullable;
 
 import com.androidplot.R;
 import com.androidplot.Region;
@@ -492,18 +494,16 @@ protected float seriesToScreenY(Number y) {
                 transform(y.doubleValue(), gridRect.bottom, gridRect.top, true);
     }
 
+    @Override
+    protected void onResize(@Nullable RectF oldRect, @NonNull RectF newRect) {
+        gridRect = RectFUtils.applyInsets(newRect, gridInsets);
+        labelRect = RectFUtils.applyInsets(newRect, lineLabelInsets);
+    }
+
     @Override
     protected void doOnDraw(Canvas canvas, RectF widgetRect)
             throws PlotRenderException {
 
-        if(gridRect == null) {
-            gridRect = RectFUtils.applyInsets(widgetRect, gridInsets);
-        }
-
-        if(labelRect == null) {
-            labelRect = RectFUtils.applyInsets(widgetRect, lineLabelInsets);
-        }
-
         // don't draw if we have no space to draw into
         if (gridRect.height() > ZERO && gridRect.width() > ZERO) {
             final RectRegion bounds = plot.getBounds();
diff --git a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
new file mode 100644
index 00000000..db81d57c
--- /dev/null
+++ b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
@@ -0,0 +1,112 @@
+package com.androidplot.ui.widget;
+
+import android.graphics.Canvas;
+import android.graphics.RectF;
+import android.support.annotation.NonNull;
+
+import com.androidplot.exception.PlotRenderException;
+import com.androidplot.test.AndroidplotTest;
+import com.androidplot.ui.Anchor;
+import com.androidplot.ui.HorizontalPositioning;
+import com.androidplot.ui.LayoutManager;
+import com.androidplot.ui.PositionMetrics;
+import com.androidplot.ui.Size;
+import com.androidplot.ui.SizeMetric;
+import com.androidplot.ui.SizeMode;
+import com.androidplot.ui.VerticalPositioning;
+
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.InOrder;
+import org.mockito.Mock;
+import org.mockito.Mockito;
+
+import static junit.framework.Assert.assertEquals;
+import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.spy;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+public class WidgetTest extends AndroidplotTest {
+
+    @Mock
+    LayoutManager layoutManager;
+
+    @Mock
+    Size size;
+
+    @Mock
+    Canvas canvas;
+
+    Widget widget;
+
+    PositionMetrics positionMetrics;
+
+    @Before
+    public void before() {
+
+        positionMetrics = new PositionMetrics(
+                0, HorizontalPositioning.ABSOLUTE_FROM_LEFT,
+                0, VerticalPositioning.ABSOLUTE_FROM_TOP, Anchor.LEFT_TOP);
+        when(size.getHeight()).thenReturn(new SizeMetric(100, SizeMode.ABSOLUTE));
+        when(size.getWidth()).thenReturn(new SizeMetric(100, SizeMode.ABSOLUTE));
+        widget = spy(new TestWidget(layoutManager, size));
+        widget.setPositionMetrics(positionMetrics);
+        widget.refreshLayout();
+    }
+
+    @Test
+    public void setGetAnchor_setsAndGetsAnchor() {
+        widget.setAnchor(Anchor.LEFT_TOP);
+        assertEquals(Anchor.LEFT_TOP, widget.getAnchor());
+
+        widget.setAnchor(Anchor.RIGHT_BOTTOM);
+        assertEquals(Anchor.RIGHT_BOTTOM, widget.getAnchor());
+    }
+
+    @Test
+    public void position_withoutAnchor_updatesPositionWithExistingAnchor() {
+        final Anchor existingAnchor = widget.getAnchor();
+        widget.position(1, HorizontalPositioning.ABSOLUTE_FROM_RIGHT,
+                1, VerticalPositioning.ABSOLUTE_FROM_BOTTOM);
+
+        assertEquals(existingAnchor, widget.getAnchor());
+        assertEquals(1F, widget.getPositionMetrics().getYPositionMetric().getValue());
+        assertEquals(1F, widget.getPositionMetrics().getXPositionMetric().getValue());
+    }
+
+    @Test
+    public void position_withAnchor_updatesPositionWithNewAnchor() {
+        final Anchor newAnchor = Anchor.CENTER;
+        widget.position(1, HorizontalPositioning.ABSOLUTE_FROM_RIGHT,
+                1, VerticalPositioning.ABSOLUTE_FROM_BOTTOM, newAnchor);
+
+        assertEquals(newAnchor, widget.getAnchor());
+        assertEquals(1F, widget.getPositionMetrics().getYPositionMetric().getValue());
+        assertEquals(1F, widget.getPositionMetrics().getXPositionMetric().getValue());
+    }
+
+    @Test
+    public void draw_sizeChanged_invokesOnResizeBeforeDoOnDraw() throws Exception {
+        InOrder inOrder = Mockito.inOrder(widget);
+
+        widget.draw(canvas);
+
+        inOrder.verify(widget).onResize(any(RectF.class), any(RectF.class));
+        inOrder.verify(widget).doOnDraw(eq(canvas), any(RectF.class));
+        verify(widget).onResize(any(RectF.class), any(RectF.class));
+    }
+
+    static class TestWidget extends Widget {
+
+        public TestWidget(@NonNull LayoutManager layoutManager, @NonNull Size size) {
+            super(layoutManager, size);
+        }
+
+        @Override
+        protected void doOnDraw(Canvas canvas, RectF widgetRect) throws PlotRenderException {
+            // nothing to do
+        }
+    }
+}
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/SimpleXYSeriesTest.java b/androidplot-core/src/test/java/com/androidplot/xy/SimpleXYSeriesTest.java
index 50fd0f8a..dc21ab7c 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/SimpleXYSeriesTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/SimpleXYSeriesTest.java
@@ -26,7 +26,7 @@
 public class SimpleXYSeriesTest {
 
     @Test
-    public void testYValsOnlyConstructor() throws Exception {
+    public void constructor_yValsOnly() throws Exception {
         Number[] yVals = {5, 6, 7, 8, 9};
         SimpleXYSeries series = new SimpleXYSeries(Arrays.asList(yVals), SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "test");
 
@@ -44,7 +44,7 @@ public void testYValsOnlyConstructor() throws Exception {
     }
 
     @Test
-    public void testXYInterleavedConstructor() throws Exception {
+    public void constructor_xyInterleaved() throws Exception {
         Number[] yVals = {55, 5, 66, 6, 77, 7, 88, 8, 99, 9};
         SimpleXYSeries series = new SimpleXYSeries(Arrays.asList(yVals), SimpleXYSeries.ArrayFormat.XY_VALS_INTERLEAVED, "test");
 
@@ -62,7 +62,7 @@ public void testXYInterleavedConstructor() throws Exception {
     }
 
     @Test
-    public void testTwoListConstructor() throws Exception {
+    public void constructor_xAndYLists() throws Exception {
         Number[] yVals = {5, 6, 7, 8, 9};
         Number[] xVals = {1, 2, 3, 4, 5};
         SimpleXYSeries series = new SimpleXYSeries(Arrays.asList(xVals), Arrays.asList(yVals), "test");
@@ -81,7 +81,7 @@ public void testTwoListConstructor() throws Exception {
     }
 
     @Test
-    public void testPushPopStuff() throws Exception {
+    public void addRemove_modifiesSeries() throws Exception {
         Number[] yVals = {5, 6, 7, 8, 9};
         Number[] xVals = {1, 2, 3, 4, 5};
         SimpleXYSeries series = new SimpleXYSeries(Arrays.asList(xVals), Arrays.asList(yVals), "test");
@@ -108,7 +108,7 @@ public void testPushPopStuff() throws Exception {
     }
 
     @Test
-    public void testSet() throws Exception {
+    public void set_setsExpectedValue() throws Exception {
         Number[] yVals = {5, 6, 7, 8, 9};
         Number[] xVals = {1, 2, 3, 4, 5};
         SimpleXYSeries series = new SimpleXYSeries(Arrays.asList(xVals), Arrays.asList(yVals), "test");
@@ -129,7 +129,7 @@ public void testSet() throws Exception {
     }
 
     @Test
-    public void testResize() throws Exception {
+    public void resize_emptySeries_resizesSeries() {
         SimpleXYSeries series = new SimpleXYSeries("series");
         series.resize(10);
         assertEquals(10, series.size());
@@ -148,7 +148,15 @@ public void testResize() throws Exception {
     }
 
     @Test
-    public void setXY_setsXAndY() {
+    public void resize_yValsOnly_resizesSeries() {
+        SimpleXYSeries series = new SimpleXYSeries(
+                SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "", 1, 2, 3);
+        series.resize(10);
+        assertEquals(10, series.size());
+    }
+
+    @Test
+    public void setXY_modifiesSeries() {
         SimpleXYSeries series = new SimpleXYSeries("series");
         series.resize(5);
         series.setXY(100, 200, 0);
@@ -158,6 +166,14 @@ public void setXY_setsXAndY() {
 
     }
 
+    @Test
+    public void setX_yValsOnly_changesValue() {
+        SimpleXYSeries series = new SimpleXYSeries(
+                SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "", 1, 2, 3);
+        series.setX(9, 0);
+        assertEquals(9, series.getX(0));
+    }
+
     @Test(expected = NoSuchElementException.class)
     public void removeFirst_throwsNoSuchElementException_ifEmpty() {
         new SimpleXYSeries("series").removeFirst();
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 0bfe4d9d..9f92afa8 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -103,7 +103,9 @@ public void testDoOnDraw_drawGridOnTopFalse() throws Exception {
         doNothing().when(graphWidget).drawGrid(canvas);
         doNothing().when(graphWidget).drawData(canvas);
 
-        graphWidget.doOnDraw(canvas, new RectF(0, 0, 100, 100));
+        final RectF canvasRect = new RectF(0, 0, 100, 100);
+        graphWidget.onResize(null, canvasRect);
+        graphWidget.doOnDraw(canvas, canvasRect);
 
         InOrder io = inOrder(graphWidget);
         io.verify(graphWidget).drawGrid(canvas);
@@ -117,7 +119,9 @@ public void testDoOnDraw_drawGridOnTopTrue() throws Exception {
         doNothing().when(graphWidget).drawGrid(canvas);
         doNothing().when(graphWidget).drawData(canvas);
 
-        graphWidget.doOnDraw(canvas, new RectF(0, 0, 100, 100));
+        final RectF canvasRect = new RectF(0, 0, 100, 100);
+        graphWidget.onResize(null, canvasRect);
+        graphWidget.doOnDraw(canvas, canvasRect);
 
         InOrder io = inOrder(graphWidget);
         io.verify(graphWidget).drawData(canvas);
diff --git a/build.gradle b/build.gradle
index b1e30c15..c45af2f9 100644
--- a/build.gradle
+++ b/build.gradle
@@ -26,7 +26,7 @@ ext {
     theCompileSdkVersion = 26
     theTargetSdkVersion = 26
     theMinSdkVersion = 5
-    theVersionName = '1.5.3'
+    theVersionName = '1.5.4'
     theVersionCode = 0
 }
 
diff --git a/demoapp/src/main/res/layout/simple_xy_plot_example.xml b/demoapp/src/main/res/layout/simple_xy_plot_example.xml
index fecf1241..48aeb5cb 100644
--- a/demoapp/src/main/res/layout/simple_xy_plot_example.xml
+++ b/demoapp/src/main/res/layout/simple_xy_plot_example.xml
@@ -18,16 +18,25 @@
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
               xmlns:ap="http://schemas.android.com/apk/res-auto"
               android:layout_height="match_parent"
-              android:layout_width="match_parent">
+              android:layout_width="match_parent"
+    android:orientation="vertical">
 
     <com.androidplot.xy.XYPlot
         style="@style/APDefacto.Dark"
         android:id="@+id/plot"
-        android:layout_width="fill_parent"
-        android:layout_height="fill_parent"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
         ap:title="A Simple XY Plot"
         ap:rangeTitle="range"
         ap:domainTitle="domain"
         ap:lineLabels="left|bottom"
-        ap:lineLabelRotationBottom="-45"/>
+        ap:lineLabelRotationBottom="-45"
+        android:layout_weight="1"/>
+
+    <Button
+        android:id="@+id/hide_button"
+        android:layout_width="match_parent"
+        android:layout_height="300dp"
+        android:text="HIDE"/>
+
 </LinearLayout>
\ No newline at end of file
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 16f58280..5b1ae96c 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.3"
+    compile "com.androidplot:androidplot-core:1.5.4"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 1a7c1984..a4c834f5 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,10 +2,15 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.4
+
+* (#69) Fixed a bug in `SimpleXYPlot` preventing the resizing of `Y_VALS_ONLY` formatted series.
+* (#73) Fixed a bug where dynamically resizing a Plot (by marking a sibling view as `GONE`, etc.) would not resize the graph widget.
+
 # 1.5.3
 
 * Minor cleanup of Widget example source.
-* (#67) Fixes Javadoc link
+* (#67) Fixed Javadoc link
 
 # 1.5.2
 

From 12fa563ebddc29b8307d9e2718173a04c6b98ced Mon Sep 17 00:00:00 2001
From: Jonathan <Jonathan+Git@jacksonengineering.net>
Date: Sun, 11 Mar 2018 08:29:05 -0500
Subject: [PATCH 09/48] Fix app freeze when gridsteps are much larger than the
 actual plot range (#76)

---
 .../src/main/java/com/androidplot/Plot.java   |  31 +-
 .../java/com/androidplot/util/Redrawer.java   |   2 +-
 .../com/androidplot/util/SeriesUtils.java     |  17 +-
 .../xy/FastLineAndPointRenderer.java          |  19 +-
 .../com/androidplot/xy/SampledXYSeries.java   |   2 +-
 .../com/androidplot/xy/XYGraphWidget.java     | 306 ++++++++++--------
 6 files changed, 218 insertions(+), 159 deletions(-)

diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index 8b436199..5e009635 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -18,28 +18,43 @@
 
 import android.content.Context;
 import android.content.res.TypedArray;
-import android.graphics.*;
+import android.graphics.Bitmap;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
+import android.graphics.PorterDuff;
+import android.graphics.RectF;
 import android.os.Build;
 import android.os.Looper;
 import android.support.annotation.Nullable;
 import android.util.AttributeSet;
 import android.util.Log;
 import android.view.View;
+
 import com.androidplot.exception.PlotRenderException;
-import com.androidplot.ui.*;
+import com.androidplot.ui.Anchor;
+import com.androidplot.ui.BoxModel;
 import com.androidplot.ui.Formatter;
+import com.androidplot.ui.HorizontalPositioning;
+import com.androidplot.ui.LayoutManager;
+import com.androidplot.ui.Resizable;
+import com.androidplot.ui.SeriesBundle;
+import com.androidplot.ui.SeriesRenderer;
+import com.androidplot.ui.Size;
+import com.androidplot.ui.SizeMode;
 import com.androidplot.ui.TextOrientation;
+import com.androidplot.ui.VerticalPositioning;
 import com.androidplot.ui.widget.TextLabelWidget;
-import com.androidplot.ui.SeriesRenderer;
 import com.androidplot.util.AttrUtils;
 import com.androidplot.util.DisplayDimensions;
 import com.androidplot.util.PixelUtils;
-import com.androidplot.ui.HorizontalPositioning;
-import com.androidplot.ui.VerticalPositioning;
-import com.halfhp.fig.*;
+import com.halfhp.fig.Fig;
+import com.halfhp.fig.FigException;
 
 import java.lang.reflect.Field;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
 
 /**
  * Base class for all Plot implementations.
@@ -406,7 +421,7 @@ public void run() {
                     }
                     pingPong.recycle();
                 }
-            });
+            }, "Androidplot renderThread");
         }
     }
 
diff --git a/androidplot-core/src/main/java/com/androidplot/util/Redrawer.java b/androidplot-core/src/main/java/com/androidplot/util/Redrawer.java
index 6cf3b4eb..4bc118e0 100644
--- a/androidplot-core/src/main/java/com/androidplot/util/Redrawer.java
+++ b/androidplot-core/src/main/java/com/androidplot/util/Redrawer.java
@@ -58,7 +58,7 @@ public Redrawer(List<Plot> plots, float maxRefreshRate, boolean startImmediately
             this.plots.add(new WeakReference<>(plot));
         }
         setMaxRefreshRate(maxRefreshRate);
-        thread = new Thread(this);
+        thread = new Thread(this, "Androidplot Redrawer");
         thread.start();
         if(startImmediately) {
             start();
diff --git a/androidplot-core/src/main/java/com/androidplot/util/SeriesUtils.java b/androidplot-core/src/main/java/com/androidplot/util/SeriesUtils.java
index bd265582..b9526a24 100644
--- a/androidplot-core/src/main/java/com/androidplot/util/SeriesUtils.java
+++ b/androidplot-core/src/main/java/com/androidplot/util/SeriesUtils.java
@@ -85,25 +85,24 @@ public static RectRegion minMax(XYConstraints constraints, XYSeries... seriesArr
             for (XYSeries series : seriesArray) {
 
                 // if this is an advanced xy series then minMax have already been calculated for us:
-                boolean isPreCalculated = false;
                 if (series instanceof FastXYSeries) {
                     final RectRegion b = ((FastXYSeries) series).minMax();
                     if(b == null) {
+                        //this series doesn't currently have min or max region (might be empty)
                         continue;
                     }
                     if(constraints == null || constraints.contains(b)) {
                         bounds.union(b);
+                        continue;
                     }
                 }
-                if (!isPreCalculated && series.size() > 0) {
-                    for (int i = 0; i < series.size(); i++) {
-                        final Number xi = series.getX(i);
-                        final Number yi = series.getY(i);
+                for (int i = 0; i < series.size(); i++) {
+                    final Number xi = series.getX(i);
+                    final Number yi = series.getY(i);
 
-                        // if constraints have been set, make sure this xy coordinate exists within them:
-                        if (constraints == null || constraints.contains(xi, yi)) {
-                            bounds.union(xi, yi);
-                        }
+                    // if constraints have been set, make sure this xy coordinate exists within them:
+                    if (constraints == null || constraints.contains(xi, yi)) {
+                        bounds.union(xi, yi);
                     }
                 }
             }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
index 4e117252..d1e3fc8e 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
@@ -17,8 +17,10 @@
 package com.androidplot.xy;
 
 import android.graphics.Canvas;
+import android.graphics.Paint;
 import android.graphics.PointF;
 import android.graphics.RectF;
+import android.support.annotation.NonNull;
 
 import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.RenderStack;
@@ -36,6 +38,11 @@
  */
 public class FastLineAndPointRenderer extends XYSeriesRenderer<XYSeries, FastLineAndPointRenderer.Formatter> {
 
+    /**
+     * A line drawn by {@link Canvas#drawLines(float[], int, int, Paint)} must be defined by at
+     * least four points {@code x0, y0, x1, y1}
+     */
+    private static final int MINIMUM_NUMBER_OF_POINTS_TO_DEFINE_A_LINE = 4;
     private float[] points;
     List<Integer> segmentOffsets = new ArrayList<>();
     List<Integer> segmentLengths = new ArrayList<>();
@@ -94,10 +101,14 @@ protected void onRender(Canvas canvas, RectF plotArea, XYSeries series, Formatte
         }
     }
 
-    protected void drawSegment(Canvas canvas, float[] points, int offset, int len, Formatter formatter) {
+    protected void drawSegment(@NonNull Canvas canvas,
+                               @NonNull float[] points,
+                               int offset,
+                               int len,
+                               Formatter formatter) {
         if(formatter.linePaint != null) {
             // draw lines:
-            if (len >= 4) {
+            if (len >= MINIMUM_NUMBER_OF_POINTS_TO_DEFINE_A_LINE) {
                 // optimization to avoid using 2x storage space to represent the full path:
                 if ((len & 2) != 0) {
                     canvas.drawLines(points, offset, len - 2, formatter.linePaint);
@@ -116,7 +127,9 @@ protected void drawSegment(Canvas canvas, float[] points, int offset, int len, F
     }
 
     @Override
-    protected void doDrawLegendIcon(Canvas canvas, RectF rect, Formatter formatter) {
+    protected void doDrawLegendIcon(@NonNull Canvas canvas,
+                                    @NonNull RectF rect,
+                                    @NonNull Formatter formatter) {
         if(formatter.hasLinePaint()) {
             canvas.drawLine(rect.left, rect.bottom, rect.right, rect.top, formatter.getLinePaint());
         }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/SampledXYSeries.java b/androidplot-core/src/main/java/com/androidplot/xy/SampledXYSeries.java
index b10903b1..f795536b 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/SampledXYSeries.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/SampledXYSeries.java
@@ -89,7 +89,7 @@ public void run() {
                         lastResamplingException = ex;
                     }
                 }
-            });
+            }, "Androidplot XY Series Sampler");
             getZoomLevels().add(thisSeries);
             threads.add(thread);
             thread.start();
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index 2ecd4fcb..23506f64 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -47,8 +47,8 @@
 import java.util.Map;
 
 /**
- * Displays graphical data (lines, points, etc.) annotated with domain and range tick markers.
- * The inner area of the graph upon which grid lines and points are rendered is called the "grid" area.
+ * Displays graphical data (lines, points, etc.) annotated with domain and range tick markers. The
+ * inner area of the graph upon which grid lines and points are rendered is called the "grid" area.
  */
 public class XYGraphWidget extends Widget {
 
@@ -148,7 +148,12 @@ public class XYGraphWidget extends Widget {
 
     public static class LineLabelRenderer {
 
-        public void drawLabel(Canvas canvas, LineLabelStyle style, Number val, float x, float y, boolean isOrigin) {
+        public void drawLabel(Canvas canvas,
+                              LineLabelStyle style,
+                              Number val,
+                              float x,
+                              float y,
+                              boolean isOrigin) {
             final int canvasState = canvas.save();
             try {
                 final String txt = style.format.format(val);
@@ -159,7 +164,12 @@ public void drawLabel(Canvas canvas, LineLabelStyle style, Number val, float x,
             }
         }
 
-        protected void drawLabel(Canvas canvas, String text, Paint paint, float x, float y, boolean isOrigin) {
+        protected void drawLabel(Canvas canvas,
+                                 String text,
+                                 Paint paint,
+                                 float x,
+                                 float y,
+                                 boolean isOrigin) {
             canvas.drawText(text, x, y, paint);
         }
     }
@@ -175,6 +185,7 @@ public static class LineLabelStyle {
             paint.setTextAlign(Paint.Align.CENTER);
             paint.setTextSize(DEFAULT_LINE_LABEL_TEXT_SIZE_PX);
         }
+
         public Format getFormat() {
             return format;
         }
@@ -203,17 +214,16 @@ public void setPaint(Paint paint) {
     public interface CursorLabelFormatter {
 
         /**
-         *
          * @return The Paint to be used to draw the cursor text label.
          */
         Paint getTextPaint();
 
         /**
-         *
-         * @return Null if no background should be drawn,
-         * the Paint used to draw the background otherwise.
+         * @return Null if no background should be drawn, the Paint used to draw the background
+         * otherwise.
          */
         Paint getBackgroundPaint();
+
         String getLabelText(Number x, Number y);
     }
 
@@ -272,18 +282,21 @@ public XYGraphWidget(LayoutManager layoutManager, XYPlot plot, Size size) {
 
     /**
      * Apply xml attrs
+     *
      * @param attrs
      */
     public void processAttrs(TypedArray attrs) {
 
         setDrawGridOnTop(attrs.getBoolean(R.styleable.xy_XYPlot_drawGridOnTop, isDrawGridOnTop()));
         int tlp = attrs.getInt(R.styleable.xy_XYPlot_lineLabels, 0);
-        if(tlp != 0) {
+        if (tlp != 0) {
             setLineLabelEdges(tlp);
         }
 
-        setGridClippingEnabled(attrs.getBoolean(R.styleable.xy_XYPlot_gridClippingEnabled,
-                isGridClippingEnabled()));
+        setGridClippingEnabled(attrs.getBoolean(
+                R.styleable.xy_XYPlot_gridClippingEnabled,
+                isGridClippingEnabled()
+        ));
 
         final LineLabelStyle lineLabelStyleTop = getLineLabelStyle(Edge.TOP);
         final LineLabelStyle lineLabelStyleBottom = getLineLabelStyle(Edge.BOTTOM);
@@ -292,19 +305,23 @@ public void processAttrs(TypedArray attrs) {
 
         lineLabelStyleTop.setRotation(attrs.getFloat(
                 R.styleable.xy_XYPlot_lineLabelRotationTop,
-                lineLabelStyleTop.getRotation()));
+                lineLabelStyleTop.getRotation()
+        ));
 
         lineLabelStyleBottom.setRotation(attrs.getFloat(
                 R.styleable.xy_XYPlot_lineLabelRotationBottom,
-                lineLabelStyleBottom.getRotation()));
+                lineLabelStyleBottom.getRotation()
+        ));
 
         lineLabelStyleLeft.setRotation(attrs.getFloat(
                 R.styleable.xy_XYPlot_lineLabelRotationLeft,
-                lineLabelStyleLeft.getRotation()));
+                lineLabelStyleLeft.getRotation()
+        ));
 
         lineLabelStyleRight.setRotation(attrs.getFloat(
                 R.styleable.xy_XYPlot_lineLabelRotationRight,
-                lineLabelStyleRight.getRotation()));
+                lineLabelStyleRight.getRotation()
+        ));
 
         setLineExtensionTop(attrs.getDimension(
                 R.styleable.xy_XYPlot_lineExtensionTop, getLineExtensionTop()));
@@ -318,34 +335,40 @@ public void processAttrs(TypedArray attrs) {
         AttrUtils.configureTextPaint(attrs, lineLabelStyleTop.getPaint(),
                 R.styleable.xy_XYPlot_lineLabelTextColorTop,
                 R.styleable.xy_XYPlot_lineLabelTextSizeTop,
-                R.styleable.xy_XYPlot_lineLabelAlignTop);
+                R.styleable.xy_XYPlot_lineLabelAlignTop
+        );
 
         AttrUtils.configureTextPaint(attrs, lineLabelStyleBottom.getPaint(),
                 R.styleable.xy_XYPlot_lineLabelTextColorBottom,
                 R.styleable.xy_XYPlot_lineLabelTextSizeBottom,
-                R.styleable.xy_XYPlot_lineLabelAlignBottom);
+                R.styleable.xy_XYPlot_lineLabelAlignBottom
+        );
 
         AttrUtils.configureTextPaint(attrs, lineLabelStyleLeft.getPaint(),
                 R.styleable.xy_XYPlot_lineLabelTextColorLeft,
                 R.styleable.xy_XYPlot_lineLabelTextSizeLeft,
-                R.styleable.xy_XYPlot_lineLabelAlignLeft);
+                R.styleable.xy_XYPlot_lineLabelAlignLeft
+        );
 
         AttrUtils.configureTextPaint(attrs, lineLabelStyleRight.getPaint(),
                 R.styleable.xy_XYPlot_lineLabelTextColorRight,
                 R.styleable.xy_XYPlot_lineLabelTextSizeRight,
-                R.styleable.xy_XYPlot_lineLabelAlignRight);
+                R.styleable.xy_XYPlot_lineLabelAlignRight
+        );
 
         AttrUtils.configureInsets(attrs, getGridInsets(),
                 R.styleable.xy_XYPlot_gridInsetTop,
                 R.styleable.xy_XYPlot_gridInsetBottom,
                 R.styleable.xy_XYPlot_gridInsetLeft,
-                R.styleable.xy_XYPlot_gridInsetRight);
+                R.styleable.xy_XYPlot_gridInsetRight
+        );
 
         AttrUtils.configureInsets(attrs, getLineLabelInsets(),
                 R.styleable.xy_XYPlot_lineLabelInsetTop,
                 R.styleable.xy_XYPlot_lineLabelInsetBottom,
                 R.styleable.xy_XYPlot_lineLabelInsetLeft,
-                R.styleable.xy_XYPlot_lineLabelInsetRight);
+                R.styleable.xy_XYPlot_lineLabelInsetRight
+        );
 
         // graph size & position
         AttrUtils.configureWidget(attrs, this,
@@ -353,7 +376,8 @@ public void processAttrs(TypedArray attrs) {
                 R.styleable.xy_XYPlot_graphWidthMode, R.styleable.xy_XYPlot_graphWidth,
                 R.styleable.xy_XYPlot_graphHorizontalPositioning, R.styleable.xy_XYPlot_graphHorizontalPosition,
                 R.styleable.xy_XYPlot_graphVerticalPositioning, R.styleable.xy_XYPlot_graphVerticalPosition,
-                R.styleable.xy_XYPlot_graphAnchor, R.styleable.xy_XYPlot_graphVisible);
+                R.styleable.xy_XYPlot_graphAnchor, R.styleable.xy_XYPlot_graphVisible
+        );
 
         // domainLabel size & position
         AttrUtils.configureWidget(attrs, this,
@@ -361,7 +385,8 @@ public void processAttrs(TypedArray attrs) {
                 R.styleable.xy_XYPlot_domainTitleWidthMode, R.styleable.xy_XYPlot_domainTitleWidth,
                 R.styleable.xy_XYPlot_domainTitleHorizontalPositioning, R.styleable.xy_XYPlot_domainTitleHorizontalPosition,
                 R.styleable.xy_XYPlot_domainTitleVerticalPositioning, R.styleable.xy_XYPlot_domainTitleVerticalPosition,
-                R.styleable.xy_XYPlot_domainTitleAnchor, R.styleable.xy_XYPlot_domainTitleVisible);
+                R.styleable.xy_XYPlot_domainTitleAnchor, R.styleable.xy_XYPlot_domainTitleVisible
+        );
 
         // rangeLabel size & position
         AttrUtils.configureWidget(attrs, this,
@@ -369,7 +394,8 @@ public void processAttrs(TypedArray attrs) {
                 R.styleable.xy_XYPlot_rangeTitleWidthMode, R.styleable.xy_XYPlot_rangeTitleWidth,
                 R.styleable.xy_XYPlot_rangeTitleHorizontalPositioning, R.styleable.xy_XYPlot_rangeTitleHorizontalPosition,
                 R.styleable.xy_XYPlot_rangeTitleVerticalPositioning, R.styleable.xy_XYPlot_rangeTitleVerticalPosition,
-                R.styleable.xy_XYPlot_rangeTitleAnchor, R.styleable.xy_XYPlot_rangeTitleVisible);
+                R.styleable.xy_XYPlot_rangeTitleAnchor, R.styleable.xy_XYPlot_rangeTitleVisible
+        );
 
         // rotation
         AttrUtils.configureWidgetRotation(attrs, this, R.styleable.xy_XYPlot_graphRotation);
@@ -379,31 +405,38 @@ public void processAttrs(TypedArray attrs) {
                 R.styleable.xy_XYPlot_graphMarginTop, R.styleable.xy_XYPlot_graphMarginBottom,
                 R.styleable.xy_XYPlot_graphMarginLeft, R.styleable.xy_XYPlot_graphMarginRight,
                 R.styleable.xy_XYPlot_graphPaddingTop, R.styleable.xy_XYPlot_graphPaddingBottom,
-                R.styleable.xy_XYPlot_graphPaddingLeft, R.styleable.xy_XYPlot_graphPaddingRight);
+                R.styleable.xy_XYPlot_graphPaddingLeft, R.styleable.xy_XYPlot_graphPaddingRight
+        );
 
         // domainOriginLinePaint
         AttrUtils.configureLinePaint(attrs, getDomainOriginLinePaint(),
                 R.styleable.xy_XYPlot_domainOriginLineColor,
-                R.styleable.xy_XYPlot_domainOriginLineThickness);
+                R.styleable.xy_XYPlot_domainOriginLineThickness
+        );
 
         // rangeOriginLinePaint
         AttrUtils.configureLinePaint(attrs, getRangeOriginLinePaint(),
                 R.styleable.xy_XYPlot_rangeOriginLineColor,
-                R.styleable.xy_XYPlot_rangeOriginLineThickness);
+                R.styleable.xy_XYPlot_rangeOriginLineThickness
+        );
 
         AttrUtils.configureLinePaint(attrs, getDomainGridLinePaint(),
                 R.styleable.xy_XYPlot_domainLineColor,
-                R.styleable.xy_XYPlot_domainLineThickness);
+                R.styleable.xy_XYPlot_domainLineThickness
+        );
 
         AttrUtils.configureLinePaint(attrs, getRangeGridLinePaint(),
                 R.styleable.xy_XYPlot_rangeLineColor,
-                R.styleable.xy_XYPlot_rangeLineThickness);
+                R.styleable.xy_XYPlot_rangeLineThickness
+        );
 
         AttrUtils.setColor(attrs, getBackgroundPaint(),
-                R.styleable.xy_XYPlot_graphBackgroundColor);
+                R.styleable.xy_XYPlot_graphBackgroundColor
+        );
 
         AttrUtils.setColor(attrs, getGridBackgroundPaint(),
-                R.styleable.xy_XYPlot_gridBackgroundColor);
+                R.styleable.xy_XYPlot_gridBackgroundColor
+        );
     }
 
     /**
@@ -415,7 +448,7 @@ public void processAttrs(TypedArray attrs) {
      * @return
      */
     protected XYCoords screenToSeries(PointF point) {
-        if(!plot.getBounds().isFullyDefined()) {
+        if (!plot.getBounds().isFullyDefined()) {
             return null;
         }
         return new RectRegion(gridRect)
@@ -466,6 +499,7 @@ protected Number screenToSeriesX(float xPix) {
      * Converts a y pixel to a y value.
      * This is a relatively slow operation and should not be used for operations that are a part of
      * the main render loop of a dynamic plot.
+     *
      * @param yPix
      * @return
      */
@@ -478,7 +512,7 @@ protected Number screenToSeriesY(float yPix) {
     }
 
     protected PointF seriesToScreen(XYCoords xy) {
-        if(!plot.getBounds().isFullyDefined()) {
+        if (!plot.getBounds().isFullyDefined()) {
             return null;
         }
         return plot.getBounds().transform(xy, gridRect, false, true);
@@ -511,7 +545,7 @@ protected void doOnDraw(Canvas canvas, RectF widgetRect)
                     && bounds.getMaxX() != null
                     && bounds.getMinY() != null
                     && bounds.getMaxY() != null) {
-                if(drawGridOnTop) {
+                if (drawGridOnTop) {
                     drawData(canvas);
                     drawGrid(canvas);
                 } else {
@@ -527,12 +561,13 @@ protected void doOnDraw(Canvas canvas, RectF widgetRect)
     }
 
     protected void drawDomainLine(Canvas canvas, float xPix, Number xVal,
-            Paint linePaint, boolean isOrigin) {
+                                  Paint linePaint, boolean isOrigin) {
 
         // lines
         if (linePaint != null) {
-                canvas.drawLine(xPix, gridRect.top - lineExtensionTop,
-                        xPix, gridRect.bottom + lineExtensionBottom, linePaint);
+            canvas.drawLine(xPix, gridRect.top - lineExtensionTop,
+                    xPix, gridRect.bottom + lineExtensionBottom, linePaint
+            );
         }
 
         // labels
@@ -541,11 +576,12 @@ protected void drawDomainLine(Canvas canvas, float xPix, Number xVal,
     }
 
     protected void drawRangeLine(Canvas canvas, float yPix, Number yVal,
-            Paint linePaint, boolean isOrigin) {
+                                 Paint linePaint, boolean isOrigin) {
         // lines
         if (linePaint != null) {
             canvas.drawLine(gridRect.left - lineExtensionLeft, yPix,
-                    gridRect.right + lineExtensionRight, yPix, linePaint);
+                    gridRect.right + lineExtensionRight, yPix, linePaint
+            );
         }
 
         // labels
@@ -553,8 +589,13 @@ protected void drawRangeLine(Canvas canvas, float yPix, Number yVal,
         drawLineLabel(canvas, Edge.RIGHT, yVal, labelRect.right, yPix, isOrigin);
     }
 
-    protected void drawLineLabel(Canvas canvas, Edge edge, Number val, float x, float y, boolean isOrigin) {
-        if(isLineLabelEnabled(edge)) {
+    protected void drawLineLabel(Canvas canvas,
+                                 Edge edge,
+                                 Number val,
+                                 float x,
+                                 float y,
+                                 boolean isOrigin) {
+        if (isLineLabelEnabled(edge)) {
             getLineLabelRenderer(edge).drawLabel(canvas, getLineLabelStyle(edge), val, x, y, isOrigin);
         }
     }
@@ -565,63 +606,48 @@ protected void drawLineLabel(Canvas canvas, Edge edge, Number val, float x, floa
      * @param canvas
      */
     protected void drawGrid(Canvas canvas) {
-        if(!drawGridOnTop) {
+        if (!drawGridOnTop) {
             drawGridBackground(canvas);
         }
 
 
         Number domainOrigin = plot.getDomainOrigin();
-        double domainOriginPix;
+        final double domainOriginPix;
         if (domainOrigin != null) {
             domainOriginPix = plot.getBounds().getxRegion().transform(
                     plot.getDomainOrigin().doubleValue(), gridRect.left, gridRect.right, false);
         } else {
             // if no domain origin is set, use the leftmost value visible on the grid:
             domainOriginPix = gridRect.left;
-            domainOrigin=plot.getBounds().getMinX();
+            domainOrigin = plot.getBounds().getMinX();
         }
 
         Step domainStep = XYStepCalculator.getStep(plot, Axis.DOMAIN, gridRect);
 
-        // draw domain origin:
-        if (domainOriginPix >= gridRect.left
-                && domainOriginPix <= gridRect.right) {
-            drawDomainLine(canvas, (float) domainOriginPix,
-                    domainOrigin, domainOriginLinePaint, true);
-        }
-
-        // draw lines LEFT of origin:
-        double xPix = domainOriginPix - domainStep.getStepPix();
-        for (int i = ONE; xPix >= gridRect.left - FUDGE; xPix = domainOriginPix
-                - (i * domainStep.getStepPix())) {
-            double xVal = domainOrigin.doubleValue() - i
-                    * domainStep.getStepVal();
-
-            if (xPix <= gridRect.right) {
-                final boolean isDomainTick = i% getLinesPerDomainLabel() == ZERO;
-                final Paint lp = isDomainTick ? domainGridLinePaint : domainSubGridLinePaint;
-                    drawDomainLine(canvas, (float) xPix, xVal, lp, false);
+        // Draw Domain Lines:
+
+        final double domainStepPix = domainStep.getStepPix();
+        final double iMin = (gridRect.left - domainOriginPix - FUDGE) / domainStepPix;
+        final double iMax = (gridRect.right - domainOriginPix + FUDGE) / domainStepPix;
+
+        for (int i = (int) Math.ceil(iMin); i <= iMax; i++) {
+            double xVal = domainOrigin.doubleValue() + i * domainStep.getStepVal();
+            double xPix = domainOriginPix + i * domainStepPix;
+            boolean isMajorTick = i % getLinesPerDomainLabel() == ZERO;
+            boolean isOrigin = i == 0;
+            Paint linePaint;
+            if (isOrigin) {
+                linePaint = domainOriginLinePaint;
+            } else if (isMajorTick) {
+                linePaint = domainGridLinePaint;
+            } else {
+                linePaint = domainSubGridLinePaint;
             }
-            i++;
-        }
-
-        // draw lines RIGHT of origin:
-        xPix = domainOriginPix + domainStep.getStepPix();
-        for (int i = ONE; xPix <= gridRect.right + FUDGE; xPix = domainOriginPix
-                + (i * domainStep.getStepPix())) {
-            double xVal = domainOrigin.doubleValue() + i
-                    * domainStep.getStepVal();
-
-            if (xPix >= gridRect.left) {
-                    final boolean isDomainTick = i% getLinesPerDomainLabel() == ZERO;
-                    final Paint lp = isDomainTick ? domainGridLinePaint : domainSubGridLinePaint;
-                    drawDomainLine(canvas, (float) xPix, xVal, lp, false);
-            }
-            i++;
+            drawDomainLine(canvas, (float) xPix, xVal, linePaint, isOrigin);
         }
 
         Number rangeOrigin = plot.getRangeOrigin();
-        double rangeOriginPix;
+        final double rangeOriginPix;
         if (rangeOrigin != null) {
             rangeOriginPix = plot.getBounds().getyRegion().transform(
                     rangeOrigin.doubleValue(), gridRect.top, gridRect.bottom, true);
@@ -633,39 +659,29 @@ protected void drawGrid(Canvas canvas) {
 
         Step rangeStep = XYStepCalculator.getStep(plot, Axis.RANGE, gridRect);
 
-        // draw range origin:
-        if (rangeOriginPix >= gridRect.top && rangeOriginPix <= gridRect.bottom) {
-            drawRangeLine(canvas, (float) rangeOriginPix,
-                    rangeOrigin, rangeOriginLinePaint, true);
-        }
+        // Draw Range Lines:
 
         final double rangeStepPix = rangeStep.getStepPix();
-
-        // draw lines ABOVE origin:
-        double yPix = rangeOriginPix - rangeStep.getStepPix();
-        for (int i = ONE; yPix >= gridRect.top - FUDGE; yPix = rangeOriginPix - (i * rangeStepPix)) {
-            double yVal = rangeOrigin.doubleValue() + i
-                    * rangeStep.getStepVal();
-
-            if (yPix <= gridRect.bottom) {
-                final boolean isRangeTick = i% getLinesPerRangeLabel() == ZERO;
-                final Paint lp = isRangeTick ? rangeGridLinePaint : rangeSubGridLinePaint;
-                drawRangeLine(canvas, (float)yPix, yVal, lp, false);
+        final double kMin = (gridRect.top - rangeOriginPix - FUDGE) / rangeStepPix;
+        final double kMax = (gridRect.bottom - rangeOriginPix + FUDGE) / rangeStepPix;
+
+        for (int k = (int) Math.ceil(kMin); k <= kMax; k++) {
+            // Android vertical coordinates (zero at the top of the screen) are the opposite
+            // direction of default range values (lowest on bottom of screen) so we subtract when
+            // calculating yVal
+            double yVal = rangeOrigin.doubleValue() - k * rangeStep.getStepVal();
+            double yPix = rangeOriginPix + k * rangeStepPix;
+            boolean isMajorTick = k % getLinesPerRangeLabel() == ZERO;
+            boolean isOrigin = k == 0;
+            Paint linePaint;
+            if (isOrigin) {
+                linePaint = rangeOriginLinePaint;
+            } else if (isMajorTick) {
+                linePaint = rangeGridLinePaint;
+            } else {
+                linePaint = rangeSubGridLinePaint;
             }
-            i++;
-        }
-
-        // draw lines BENEATH origin:
-        yPix = rangeOriginPix + rangeStep.getStepPix();
-        for (int i = ONE; yPix <= gridRect.bottom + FUDGE; yPix = rangeOriginPix + (i * rangeStepPix)) {
-            double yVal = rangeOrigin.doubleValue() - i
-                    * rangeStep.getStepVal();
-            if (yPix >= gridRect.top) {
-                final boolean isRangeTick = i% getLinesPerRangeLabel() == ZERO;
-                final Paint lp = isRangeTick ? rangeGridLinePaint : rangeSubGridLinePaint;
-                drawRangeLine(canvas, (float)yPix, yVal, lp, false);
-            }
-            i++;
+            drawRangeLine(canvas, (float) yPix, yVal, linePaint, isOrigin);
         }
     }
 
@@ -679,11 +695,13 @@ protected void drawGrid(Canvas canvas) {
      * @param y
      */
     private void drawMarkerText(Canvas canvas, String text, ValueMarker marker,
-            float x, float y) {
+                                float x, float y) {
         x += MARKER_LABEL_SPACING;
         y -= MARKER_LABEL_SPACING;
-        RectF textRect = new RectF(FontUtils.getStringDimensions(text,
-                marker.getTextPaint()));
+        RectF textRect = new RectF(FontUtils.getStringDimensions(
+                text,
+                marker.getTextPaint()
+        ));
         textRect.offsetTo(x, y - textRect.height());
 
         if (textRect.right > gridRect.right) {
@@ -695,18 +713,20 @@ private void drawMarkerText(Canvas canvas, String text, ValueMarker marker,
         }
 
         canvas.drawText(text, textRect.left, textRect.bottom,
-                marker.getTextPaint());
+                marker.getTextPaint()
+        );
     }
 
     protected void drawMarkers(Canvas canvas) {
-        if(plot.getYValueMarkers() != null && plot.getYValueMarkers().size() > 0) {
+        if (plot.getYValueMarkers() != null && plot.getYValueMarkers().size() > 0) {
             for (YValueMarker marker : plot.getYValueMarkers()) {
                 if (marker.getValue() != null) {
                     float yPix = (float) plot.getBounds().yRegion
                             .transform(marker.getValue()
                                     .doubleValue(), gridRect.top, gridRect.bottom, true);
                     canvas.drawLine(gridRect.left, yPix,
-                            gridRect.right, yPix, marker.getLinePaint());
+                            gridRect.right, yPix, marker.getLinePaint()
+                    );
 
                     float xPix = marker.getTextPosition().getPixelValue(
                             gridRect.width());
@@ -719,14 +739,15 @@ protected void drawMarkers(Canvas canvas) {
             }
         }
 
-        if(plot.getXValueMarkers() != null && plot.getXValueMarkers().size() > 0) {
+        if (plot.getXValueMarkers() != null && plot.getXValueMarkers().size() > 0) {
             for (XValueMarker marker : plot.getXValueMarkers()) {
                 if (marker.getValue() != null) {
                     float xPix = (float) plot.getBounds().xRegion
                             .transform(marker.getValue()
                                     .doubleValue(), gridRect.left, gridRect.right, false);
                     canvas.drawLine(xPix, gridRect.top, xPix, gridRect.bottom,
-                            marker.getLinePaint());
+                            marker.getLinePaint()
+                    );
                     float yPix = marker.getTextPosition().getPixelValue(gridRect.height());
                     yPix += gridRect.top;
                     if (marker.getText() != null) {
@@ -747,7 +768,8 @@ protected void drawCursors(Canvas canvas) {
             hasDomainCursor = true;
             canvas.drawLine(domainCursorPosition, gridRect.top,
                     domainCursorPosition, gridRect.bottom,
-                    domainCursorPaint);
+                    domainCursorPaint
+            );
         }
 
         boolean hasRangeCursor = false;
@@ -758,10 +780,11 @@ protected void drawCursors(Canvas canvas) {
                 && rangeCursorPosition <= gridRect.bottom) {
             hasRangeCursor = true;
             canvas.drawLine(gridRect.left, rangeCursorPosition,
-                    gridRect.right, rangeCursorPosition, rangeCursorPaint);
+                    gridRect.right, rangeCursorPosition, rangeCursorPaint
+            );
         }
 
-        if(getCursorLabelFormatter() != null && hasRangeCursor && hasDomainCursor) {
+        if (getCursorLabelFormatter() != null && hasRangeCursor && hasDomainCursor) {
             drawCursorLabel(canvas);
         }
     }
@@ -779,8 +802,10 @@ protected void drawCursorLabel(Canvas canvas) {
         // if we are too close to the right edge of the plot, we will move
         // the label to the left side of our cursor:
         if (cursorRect.right >= gridRect.right) {
-            cursorRect.offsetTo(domainCursorPosition - cursorRect.width(),
-                    cursorRect.top);
+            cursorRect.offsetTo(
+                    domainCursorPosition - cursorRect.width(),
+                    cursorRect.top
+            );
         }
 
         // same thing for the top edge of the plot:
@@ -794,11 +819,12 @@ protected void drawCursorLabel(Canvas canvas) {
         }
 
         canvas.drawText(label, cursorRect.left, cursorRect.bottom,
-                getCursorLabelFormatter().getTextPaint());
+                getCursorLabelFormatter().getTextPaint()
+        );
     }
 
     protected void drawGridBackground(Canvas canvas) {
-        if(gridBackgroundPaint != null) {
+        if (gridBackgroundPaint != null) {
             canvas.drawRect(gridRect, gridBackgroundPaint);
         }
     }
@@ -814,15 +840,15 @@ protected void drawData(Canvas canvas) throws PlotRenderException {
             drawGridBackground(canvas);
         }
         try {
-            if(isGridClippingEnabled) {
+            if (isGridClippingEnabled) {
                 canvas.save(Canvas.ALL_SAVE_FLAG);
                 canvas.clipRect(gridRect, android.graphics.Region.Op.INTERSECT);
             }
 
             renderStack.sync();
 
-            for(RenderStack.StackElement thisElement : renderStack.getElements()) {
-                if(thisElement.isEnabled()) {
+            for (RenderStack.StackElement thisElement : renderStack.getElements()) {
+                if (thisElement.isEnabled()) {
                     Class<? extends XYSeriesRenderer> rendererClass =
                             thisElement.get().getFormatter().getRendererClass();
                     plot.getRenderer(rendererClass).render(
@@ -831,7 +857,7 @@ protected void drawData(Canvas canvas) throws PlotRenderException {
             }
 
         } finally {
-            if(isGridClippingEnabled) {
+            if (isGridClippingEnabled) {
                 canvas.restore();
             }
         }
@@ -858,6 +884,7 @@ public Paint getDomainGridLinePaint() {
 
     /**
      * Set the paint used to draw the domain grid line.
+     *
      * @param gridLinePaint
      */
     public void setDomainGridLinePaint(Paint gridLinePaint) {
@@ -880,6 +907,7 @@ public Paint getDomainSubGridLinePaint() {
 
     /**
      * Set the paint used to draw the domain grid line.
+     *
      * @param gridLinePaint
      */
     public void setDomainSubGridLinePaint(Paint gridLinePaint) {
@@ -888,6 +916,7 @@ public void setDomainSubGridLinePaint(Paint gridLinePaint) {
 
     /**
      * Set the Paint used to draw the range grid line.
+     *
      * @param gridLinePaint
      */
     public void setRangeGridLinePaint(Paint gridLinePaint) {
@@ -903,6 +932,7 @@ public Paint getRangeSubGridLinePaint() {
 
     /**
      * Set the Paint used to draw the range grid line.
+     *
      * @param gridLinePaint
      */
     public void setRangeSubGridLinePaint(Paint gridLinePaint) {
@@ -943,6 +973,7 @@ public void setRangeOriginLinePaint(Paint rangeOriginLinePaint) {
 
     /**
      * Set domain and range cursor position using screen coordinates
+     *
      * @param x
      * @param y
      */
@@ -953,6 +984,7 @@ public void setCursorPosition(Float x, Float y) {
 
     /**
      * Set domain and range cursor position using screen coordinates
+     *
      * @param point
      */
     public void setCursorPosition(PointF point) {
@@ -969,6 +1001,7 @@ public Number getDomainCursorVal() {
 
     /**
      * Set domain cursor position using screen coordinates
+     *
      * @param domainCursorPosition
      */
     public void setDomainCursorPosition(Float domainCursorPosition) {
@@ -985,6 +1018,7 @@ public Number getRangeCursorVal() {
 
     /**
      * Set range cursor position using screen coordinates
+     *
      * @param rangeCursorPosition
      */
     public void setRangeCursorPosition(Float rangeCursorPosition) {
@@ -1012,9 +1046,8 @@ public Paint getDomainCursorPaint() {
     }
 
     /**
-     *
-     * @param domainCursorPaint The {@link Paint} used to draw the domain cursor line.
-     *                          Set to null (default) to disable.
+     * @param domainCursorPaint The {@link Paint} used to draw the domain cursor line. Set to null
+     *                          (default) to disable.
      */
     public void setDomainCursorPaint(Paint domainCursorPaint) {
         this.domainCursorPaint = domainCursorPaint;
@@ -1025,9 +1058,8 @@ public Paint getRangeCursorPaint() {
     }
 
     /**
-     *
-     * @param rangeCursorPaint The {@link Paint} used to draw the range cursor line.
-     *                         Set to null (default) to disable.
+     * @param rangeCursorPaint The {@link Paint} used to draw the range cursor line. Set to null
+     *                         (default) to disable.
      */
     public void setRangeCursorPaint(Paint rangeCursorPaint) {
         this.rangeCursorPaint = rangeCursorPaint;
@@ -1160,7 +1192,7 @@ public boolean isLineLabelEnabled(Edge position) {
 
     public void setLineLabelEdges(Edge... positions) {
         EnumSet<Edge> positionSet = EnumSet.noneOf(Edge.class);
-        if(positions != null) {
+        if (positions != null) {
             Collections.addAll(positionSet, positions);
         }
         this.lineLabelEdges = positionSet;
@@ -1171,8 +1203,8 @@ public void setLineLabelEdges(Collection<Edge> positions) {
     }
 
     protected void setLineLabelEdges(int bitfield) {
-        for(Edge tp : Edge.values()) {
-            if((tp.value & bitfield) == tp.value) {
+        for (Edge tp : Edge.values()) {
+            if ((tp.value & bitfield) == tp.value) {
                 lineLabelEdges.add(tp);
             }
         }

From 0de08c598bb483ba9cd95b190460403f52602948 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 11 Mar 2018 09:15:39 -0500
Subject: [PATCH 10/48] uprev dev to 1.5.5

---
 build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index c45af2f9..d9bdfbfc 100644
--- a/build.gradle
+++ b/build.gradle
@@ -26,7 +26,7 @@ ext {
     theCompileSdkVersion = 26
     theTargetSdkVersion = 26
     theMinSdkVersion = 5
-    theVersionName = '1.5.4'
+    theVersionName = '1.5.5'
     theVersionCode = 0
 }
 

From 7893160306fcba7baacd8db46745ede00b35bc0a Mon Sep 17 00:00:00 2001
From: hannesa2 <hannes.achleitner@googlemail.com>
Date: Sun, 22 Apr 2018 18:24:06 +0200
Subject: [PATCH 11/48] update to Android Studio 3.1.1 (#77)

---
 build.gradle                             | 6 +++---
 demoapp-wearable/build.gradle            | 5 +++--
 demoapp/build.gradle                     | 8 ++++----
 gradle/wrapper/gradle-wrapper.properties | 2 +-
 4 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/build.gradle b/build.gradle
index d9bdfbfc..a7aa9c13 100644
--- a/build.gradle
+++ b/build.gradle
@@ -38,9 +38,9 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.0.1'
-        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
-        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
+        classpath 'com.android.tools.build:gradle:3.1.1'
+        classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
+        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.0'
         classpath 'com.vanniktech:gradle-android-junit-jacoco-plugin:0.6.0'
         classpath 'org.kt3k.gradle.plugin:coveralls-gradle-plugin:2.6.3'
     }
diff --git a/demoapp-wearable/build.gradle b/demoapp-wearable/build.gradle
index b4afad27..22e5186d 100644
--- a/demoapp-wearable/build.gradle
+++ b/demoapp-wearable/build.gradle
@@ -17,9 +17,10 @@
 buildscript {
     repositories {
         jcenter()
+        google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.0.1'
+        classpath 'com.android.tools.build:gradle:3.1.1'
     }
 }
 apply plugin: 'com.android.application'
@@ -54,6 +55,6 @@ android {
 
 dependencies {
     compile project(':androidplot-core')
-    compile 'com.google.android.support:wearable:1.3.0'
+    compile 'com.google.android.support:wearable:2.3.0'
     compile 'com.google.android.gms:play-services-wearable:8.3.0'
 }
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index c501ed33..36a7c800 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -21,9 +21,9 @@ dependencies {
 	compile project(':androidplot-core')
     compile 'com.crittercism:crittercism-android-agent:5.4.0'
 
-    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.1'
-    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.1'
-    testCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.1'
+    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.4'
+    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
+    testCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
 }
 
 buildscript {
@@ -32,7 +32,7 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.github.triplet.gradle:play-publisher:1.1.5'
+        classpath 'com.github.triplet.gradle:play-publisher:1.2.0'
     }
 }
 
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 6bd840a3..42a64d0b 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip

From c53ac24397e25032c444304951c50152ff5a39ad Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Fri, 4 May 2018 13:47:45 -0500
Subject: [PATCH 12/48] include full apache 2.0 license in LICENSE.md

---
 LICENSE.md | 208 ++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 198 insertions(+), 10 deletions(-)

diff --git a/LICENSE.md b/LICENSE.md
index 3fbf0a78..f49a4e16 100644
--- a/LICENSE.md
+++ b/LICENSE.md
@@ -1,13 +1,201 @@
-    Copyright 2018 Androidplot.com
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
 
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
-        http://www.apache.org/licenses/LICENSE-2.0
+   1. Definitions.
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
\ No newline at end of file
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file

From f58cd6b43859886a7141d8294c16069d85baf768 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@users.noreply.github.com>
Date: Wed, 23 May 2018 11:18:38 -0500
Subject: [PATCH 13/48] 1.5.5 changes (#79)

* remove unused button from simple xy plot

* #78 Fixes issue where setting XYGraphWidget insets has no effect.

* XYGraphWidget.drawMarkerText is now protected instead of private.

* 1.5.5 documentation updates
---
 .../com/androidplot/xy/XYGraphWidget.java     | 54 +++++-----
 .../com/androidplot/xy/XYGraphWidgetTest.java | 98 ++++++++++---------
 .../demos/SimpleXYPlotActivity.java           | 17 +++-
 .../res/layout/simple_xy_plot_example.xml     |  6 --
 docs/quickstart.md                            |  2 +-
 docs/release_notes.md                         |  6 ++
 6 files changed, 107 insertions(+), 76 deletions(-)

diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index 23506f64..1ca3de77 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -530,8 +530,15 @@ protected float seriesToScreenY(Number y) {
 
     @Override
     protected void onResize(@Nullable RectF oldRect, @NonNull RectF newRect) {
-        gridRect = RectFUtils.applyInsets(newRect, gridInsets);
-        labelRect = RectFUtils.applyInsets(newRect, lineLabelInsets);
+        recalculateSizes(newRect);
+    }
+
+    protected void recalculateSizes(@Nullable RectF rect) {
+        if(rect == null) {
+            rect = getWidgetDimensions().paddedRect;
+        }
+        gridRect = RectFUtils.applyInsets(rect, gridInsets);
+        labelRect = RectFUtils.applyInsets(rect, lineLabelInsets);
     }
 
     @Override
@@ -694,27 +701,29 @@ protected void drawGrid(Canvas canvas) {
      * @param x
      * @param y
      */
-    private void drawMarkerText(Canvas canvas, String text, ValueMarker marker,
+    protected void drawMarkerText(Canvas canvas, String text, ValueMarker marker,
                                 float x, float y) {
-        x += MARKER_LABEL_SPACING;
-        y -= MARKER_LABEL_SPACING;
-        RectF textRect = new RectF(FontUtils.getStringDimensions(
-                text,
-                marker.getTextPaint()
-        ));
-        textRect.offsetTo(x, y - textRect.height());
+        if (marker.getText() != null) {
+            x += MARKER_LABEL_SPACING;
+            y -= MARKER_LABEL_SPACING;
+            RectF textRect = new RectF(FontUtils.getStringDimensions(
+                    text,
+                    marker.getTextPaint()
+            ));
+            textRect.offsetTo(x, y - textRect.height());
+
+            if (textRect.right > gridRect.right) {
+                textRect.offset(-(textRect.right - gridRect.right), ZERO);
+            }
 
-        if (textRect.right > gridRect.right) {
-            textRect.offset(-(textRect.right - gridRect.right), ZERO);
-        }
+            if (textRect.top < gridRect.top) {
+                textRect.offset(0, gridRect.top - textRect.top);
+            }
 
-        if (textRect.top < gridRect.top) {
-            textRect.offset(0, gridRect.top - textRect.top);
+            canvas.drawText(text, textRect.left, textRect.bottom,
+                    marker.getTextPaint()
+            );
         }
-
-        canvas.drawText(text, textRect.left, textRect.bottom,
-                marker.getTextPaint()
-        );
     }
 
     protected void drawMarkers(Canvas canvas) {
@@ -731,10 +740,7 @@ protected void drawMarkers(Canvas canvas) {
                     float xPix = marker.getTextPosition().getPixelValue(
                             gridRect.width());
                     xPix += gridRect.left;
-
-                    if (marker.getText() != null) {
-                        drawMarkerText(canvas, marker.getText(), marker, xPix, yPix);
-                    }
+                    drawMarkerText(canvas, marker.getText(), marker, xPix, yPix);
                 }
             }
         }
@@ -1149,6 +1155,7 @@ public Insets getGridInsets() {
 
     public void setGridInsets(Insets gridInsets) {
         this.gridInsets = gridInsets;
+        recalculateSizes(null);
     }
 
     /**
@@ -1160,6 +1167,7 @@ public Insets getLineLabelInsets() {
 
     public void setLineLabelInsets(Insets lineLabelInsets) {
         this.lineLabelInsets = lineLabelInsets;
+        recalculateSizes(null);
     }
 
     public RectF getGridRect() {
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 9f92afa8..65d3898a 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -21,6 +21,7 @@
 
 import com.androidplot.test.*;
 import com.androidplot.ui.*;
+import com.androidplot.util.DisplayDimensions;
 
 import org.junit.*;
 import org.mockito.*;
@@ -67,7 +68,7 @@ public class XYGraphWidgetTest extends AndroidplotTest {
 
 
     @Before
-    public void setUp() throws Exception {
+    public void setUp() {
         size = spy(new Size(100, SizeMode.ABSOLUTE, 100, SizeMode.ABSOLUTE));
         xyPlot = spy(new XYPlot(getContext(), "XYPlot"));
         when(xyPlot.getRegistry()).thenReturn(seriesRegistry);
@@ -83,13 +84,8 @@ public void setUp() throws Exception {
         graphWidget.setLabelRect(new RectF(0, 0, 100, 100));
     }
 
-    @After
-    public void tearDown() throws Exception {
-
-    }
-
     @Test
-    public void testProcessAttrs() throws Exception {
+    public void processAttrs_withDefaults_disablesGridClipping() {
         XYGraphWidget graphWidget = spy(new XYGraphWidget(layoutManager, xyPlot, size));
 
         graphWidget.processAttrs(typedArray);
@@ -97,7 +93,7 @@ public void testProcessAttrs() throws Exception {
     }
 
     @Test
-    public void testDoOnDraw_drawGridOnTopFalse() throws Exception {
+    public void doOnDraw_drawGridOnTopFalse_drawsGridAfterData() throws Exception {
         XYGraphWidget graphWidget = spy(new XYGraphWidget(layoutManager, xyPlot, size));
         graphWidget.setDrawGridOnTop(false);
         doNothing().when(graphWidget).drawGrid(canvas);
@@ -113,7 +109,7 @@ public void testDoOnDraw_drawGridOnTopFalse() throws Exception {
     }
 
     @Test
-    public void testDoOnDraw_drawGridOnTopTrue() throws Exception {
+    public void doOnDraw_drawGridOnTopTrue_drawsGridBeforeData() throws Exception {
         XYGraphWidget graphWidget = spy(new XYGraphWidget(layoutManager, xyPlot, size));
         graphWidget.setDrawGridOnTop(true);
         doNothing().when(graphWidget).drawGrid(canvas);
@@ -129,7 +125,7 @@ public void testDoOnDraw_drawGridOnTopTrue() throws Exception {
     }
 
     @Test
-    public void testDrawMarkers() throws Exception {
+    public void drawMarkers_drawsLineForEachMarker() {
         xyPlot.addMarker(new XValueMarker(1, "x"));
         xyPlot.addMarker(new YValueMarker(-1, "y"));
 
@@ -140,42 +136,22 @@ public void testDrawMarkers() throws Exception {
                 .drawLine(anyFloat(), anyFloat(), anyFloat(), anyFloat(), any(Paint.class));
     }
 
-    protected void runDrawGridTest() {
-        doNothing().when(graphWidget).
-                drawDomainLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
-
-        doNothing().when(graphWidget).
-                drawRangeLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
-
-        xyPlot.setRangeBoundaries(0, 100, BoundaryMode.FIXED);
-        xyPlot.setDomainBoundaries(0, 100, BoundaryMode.FIXED);
-
-        graphWidget.drawGrid(canvas);
-
-        // expecting a 100x100 grid to be drawn:
-        verify(graphWidget, times(100))
-                .drawDomainLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
-
-        verify(graphWidget, times(100))
-                .drawRangeLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
-    }
-
     @Test
-    public void testDrawGrid_nullOrigin() throws Exception {
+    public void drawGrid_nullOrigin_drawsGrid() {
         when(xyPlot.getDomainOrigin()).thenReturn(null);
         when(xyPlot.getRangeOrigin()).thenReturn(null);
         runDrawGridTest();
     }
 
     @Test
-    public void testDrawGrid_zeroOrigin() throws Exception {
+    public void drawGrid_zeroOrigin_drawsGrid() {
         when(xyPlot.getDomainOrigin()).thenReturn(0);
         when(xyPlot.getRangeOrigin()).thenReturn(0);
         runDrawGridTest();
     }
 
     @Test
-    public void testDrawGrid_centeredOrigin() throws Exception {
+    public void drawGrid_centeredOrigin_drawsGrid() {
 
         // set origin to midpoint so we exercise
         // code to draw lines on both sides of the origin:
@@ -185,7 +161,7 @@ public void testDrawGrid_centeredOrigin() throws Exception {
     }
 
     @Test
-    public void testDrawCursors_ifCursorPaintAndPositionAreSet() throws Exception {
+    public void drawCursors_withCursorPaintAndPosition_drawsCursorLines() {
         final Paint domainCursorPaint = new Paint();
         graphWidget.setDomainCursorPaint(domainCursorPaint);
 
@@ -201,7 +177,7 @@ public void testDrawCursors_ifCursorPaintAndPositionAreSet() throws Exception {
     }
 
     @Test
-    public void testDrawCursors_ifCursorPaintAndPositionAreNotSet() throws Exception {
+    public void testDrawCursors_noCursorPaintOrPosition_drawsNoCursorLines() {
         graphWidget.setDomainCursorPaint(null);
         graphWidget.setRangeCursorPaint(null);
 
@@ -212,7 +188,7 @@ public void testDrawCursors_ifCursorPaintAndPositionAreNotSet() throws Exception
     }
 
     @Test
-    public void testDrawCursorLabel() throws Exception {
+    public void drawCursorLabel_drawsText() {
         graphWidget.setDomainCursorPosition(0f);
         graphWidget.setRangeCursorPosition(0f);
         XYGraphWidget.CursorLabelFormatter clf = mock(XYGraphWidget.CursorLabelFormatter.class);
@@ -224,7 +200,7 @@ public void testDrawCursorLabel() throws Exception {
     }
 
     @Test
-    public void testSetLineLabelEdges() throws Exception {
+    public void setLineLabelEdges_setsEdges() {
 
         graphWidget.setLineLabelEdges(XYGraphWidget.Edge.LEFT, XYGraphWidget.Edge.BOTTOM);
         assertTrue(graphWidget.isLineLabelEnabled(XYGraphWidget.Edge.LEFT));
@@ -238,7 +214,7 @@ public void testSetLineLabelEdges() throws Exception {
     }
 
     @Test
-    public void testSetLineLabelEdges_bitfield() throws Exception {
+    public void setLineLabelEdges_bitfield_setsEdges() {
 
         graphWidget.setLineLabelEdges(
                 XYGraphWidget.Edge.TOP.getValue() | XYGraphWidget.Edge.RIGHT.getValue());
@@ -250,7 +226,7 @@ public void testSetLineLabelEdges_bitfield() throws Exception {
     }
 
     @Test
-    public void testScreenToSeries() throws Exception {
+    public void screenToSeries_returnsSeriesCoords() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         XYCoords coords = graphWidget.screenToSeries(new PointF(0, 0));
@@ -267,7 +243,7 @@ public void testScreenToSeries() throws Exception {
     }
 
     @Test
-    public void testSeriesToScreen() throws Exception {
+    public void seriesToScreen_returnsScreenPoint() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         PointF point = graphWidget.seriesToScreen(new XYCoords(-100, 100));
@@ -284,7 +260,7 @@ public void testSeriesToScreen() throws Exception {
     }
 
     @Test
-    public void testScreenToSeriesX() throws Exception {
+    public void screenToSeriesX_returnsSeriesValue() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(-100, graphWidget.screenToSeriesX(new PointF(0, 0)).intValue());
@@ -293,7 +269,7 @@ public void testScreenToSeriesX() throws Exception {
     }
 
     @Test
-    public void testScreenToSeriesY() throws Exception {
+    public void screenToSeriesY_returnsSeriesValue() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(100, graphWidget.screenToSeriesY(new PointF(0, 0)).intValue());
@@ -302,7 +278,7 @@ public void testScreenToSeriesY() throws Exception {
     }
 
     @Test
-    public void testSeriesToScreenX() throws Exception {
+    public void seriesToScreenX_returnsScreenValue() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(0f, graphWidget.seriesToScreenX(-100));
@@ -311,11 +287,45 @@ public void testSeriesToScreenX() throws Exception {
     }
 
     @Test
-    public void testSeriesToScreenY() throws Exception {
+    public void seriesToScreenY_returnsScreenValue() {
         when(xyPlot.getBounds()).thenReturn(new RectRegion(-100, 100, -100, 100));
 
         assertEquals(100f, graphWidget.seriesToScreenY(100));
         assertEquals(0f, graphWidget.seriesToScreenY(-100));
         assertEquals(50f, graphWidget.seriesToScreenY(0));
     }
+
+    @Test
+    public void setGridInsets_updatesGridRect() {
+        graphWidget.setGridInsets(new Insets(0, 0, 0, 0));
+        final RectF oldRect = graphWidget.getGridRect();
+
+        graphWidget.setGridInsets(new Insets(2, 2, 2, 2));
+        final RectF newRect = graphWidget.getGridRect();
+
+        assertEquals(oldRect.left + 2, newRect.left);
+        assertEquals(oldRect.top + 2, newRect.top);
+        assertEquals(oldRect.right - 2, newRect.right);
+        assertEquals(oldRect.bottom -2, newRect.bottom);
+    }
+
+    private void runDrawGridTest() {
+        doNothing().when(graphWidget).
+                drawDomainLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
+
+        doNothing().when(graphWidget).
+                drawRangeLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
+
+        xyPlot.setRangeBoundaries(0, 100, BoundaryMode.FIXED);
+        xyPlot.setDomainBoundaries(0, 100, BoundaryMode.FIXED);
+
+        graphWidget.drawGrid(canvas);
+
+        // expecting a 100x100 grid to be drawn:
+        verify(graphWidget, times(100))
+                .drawDomainLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
+
+        verify(graphWidget, times(100))
+                .drawRangeLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
+    }
 }
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index b673f512..6238e4df 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -21,8 +21,7 @@
 import android.os.Bundle;
 import android.support.annotation.NonNull;
 
-import com.androidplot.ui.Size;
-import com.androidplot.ui.SizeMode;
+import com.androidplot.ui.Insets;
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.CatmullRomInterpolator;
 import com.androidplot.xy.LineAndPointFormatter;
@@ -102,5 +101,19 @@ public Object parseObject(String source, @NonNull ParsePosition pos) {
                 return null;
             }
         });
+
+        new Thread(new Runnable() {
+
+            @Override
+            public void run() {
+                try {
+                    Thread.sleep(2000);
+                } catch (InterruptedException e) {
+                    throw new RuntimeException(e);
+                }
+                plot.getGraph().setGridInsets(new Insets(120, 120, 120, 120));
+                plot.redraw();
+            }
+        }).start();
     }
 }
diff --git a/demoapp/src/main/res/layout/simple_xy_plot_example.xml b/demoapp/src/main/res/layout/simple_xy_plot_example.xml
index 48aeb5cb..08a2c5af 100644
--- a/demoapp/src/main/res/layout/simple_xy_plot_example.xml
+++ b/demoapp/src/main/res/layout/simple_xy_plot_example.xml
@@ -33,10 +33,4 @@
         ap:lineLabelRotationBottom="-45"
         android:layout_weight="1"/>
 
-    <Button
-        android:id="@+id/hide_button"
-        android:layout_width="match_parent"
-        android:layout_height="300dp"
-        android:text="HIDE"/>
-
 </LinearLayout>
\ No newline at end of file
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 5b1ae96c..e6ae7ff5 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.4"
+    compile "com.androidplot:androidplot-core:1.5.5"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index a4c834f5..762ac5a6 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,12 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.5
+
+* (#76) Fixed a bug that could cause a deadlock when grid steps are much larger than actual plot range.
+* (#78) Fixed a bug where setting insets on XYGraphWidget would have no effect after the plot was drawn.
+* XYGraphWidget.drawMarkerText is now marked `protected`.
+
 # 1.5.4
 
 * (#69) Fixed a bug in `SimpleXYPlot` preventing the resizing of `Y_VALS_ONLY` formatted series.

From d7019ab9ffc5688ca76da916dc68a798fe6b509e Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sat, 18 Aug 2018 14:30:33 -0500
Subject: [PATCH 14/48] 1.5.6 Changes (#81)

* adds convenience methods for saving and restoring pan / zoom state
* #80 Target SDK 28
* readme updates
---
 .circleci/config.yml                          |  2 +-
 .../java/com/androidplot/pie/PieRenderer.java |  2 +-
 .../com/androidplot/ui/LayoutManager.java     |  4 +-
 .../com/androidplot/ui/SeriesRenderer.java    |  2 +-
 .../ui/widget/TextLabelWidget.java            |  2 +-
 .../androidplot/xy/LineAndPointRenderer.java  |  2 +-
 .../main/java/com/androidplot/xy/PanZoom.java | 82 ++++++++++++++++---
 .../com/androidplot/xy/XYGraphWidget.java     |  2 +-
 build.gradle                                  |  6 +-
 .../demos/SimpleXYPlotActivity.java           | 19 +----
 .../demos/TouchZoomExampleActivity.java       | 15 ++++
 docs/quickstart.md                            |  2 +-
 docs/release_notes.md                         |  5 ++
 docs/xyplot.md                                | 19 +++++
 14 files changed, 122 insertions(+), 42 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index a3cd7bfe..c5579475 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -16,7 +16,7 @@ jobs:
 
       # CircleCI maintains a library of pre-built images
             # documented at https://circleci.com/docs/2.0/circleci-images/
-      - image: circleci/android:api-26-alpha
+      - image: circleci/android:api-28-alpha
 
     working_directory: ~/repo
 
diff --git a/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java b/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
index dc83e620..caaddc06 100644
--- a/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
@@ -170,7 +170,7 @@ protected void drawSegment(Canvas canvas, RectF bounds, Segment seg, SegmentForm
             canvas.drawLine(r1Inner.x, r1Inner.y, r1Outer.x, r1Outer.y, f.getRadialEdgePaint());
             canvas.drawLine(r2Inner.x, r2Inner.y, r2Outer.x, r2Outer.y, f.getRadialEdgePaint());
         } else {
-            canvas.save(Canvas.CLIP_SAVE_FLAG);
+            canvas.save();
             Path chart = new Path();
             chart.addCircle(cx, cy, outerRad, Path.Direction.CW);
             Path inside = new Path();
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
index e4c5cce5..0fb1a04c 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
@@ -92,7 +92,7 @@ public void draw(Canvas canvas) throws PlotRenderException {
         }
         for (Widget widget : elements()) {
             try {
-                canvas.save(Canvas.ALL_SAVE_FLAG);
+                canvas.save();
                 PositionMetrics metrics = widget.getPositionMetrics();
                 float elementWidth = widget.getWidthPix(displayDims.paddedRect.width());
                 float elementHeight = widget.getHeightPix(displayDims.paddedRect.height());
@@ -140,7 +140,7 @@ public void draw(Canvas canvas) throws PlotRenderException {
 
     private static void drawSpacing(Canvas canvas, RectF outer, RectF inner, Paint paint) {
         try {
-            canvas.save(Canvas.ALL_SAVE_FLAG);
+            canvas.save();
             canvas.clipRect(inner, Region.Op.DIFFERENCE);
             canvas.drawRect(outer, paint);
         } finally {
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java b/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
index 882bdcfc..afc1b142 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
@@ -81,7 +81,7 @@ protected abstract void onRender(Canvas canvas, RectF plotArea, SeriesType serie
 
     public void drawSeriesLegendIcon(Canvas canvas, RectF rect, SeriesFormatterType formatter) {
         try {
-            canvas.save(Canvas.ALL_SAVE_FLAG);
+            canvas.save();
             canvas.clipRect(rect, Region.Op.INTERSECT);
             doDrawLegendIcon(canvas, rect, formatter);
         } finally {
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/TextLabelWidget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/TextLabelWidget.java
index 8c6e84cd..06bf54ff 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/TextLabelWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/TextLabelWidget.java
@@ -101,7 +101,7 @@ public void doOnDraw(Canvas canvas, RectF widgetRect) {
                 Anchor.CENTER);
 
         try {
-            canvas.save(Canvas.ALL_SAVE_FLAG);
+            canvas.save();
             canvas.translate(start.x, start.y);
             switch (orientation) {
                 case HORIZONTAL:
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
index e8c0c23b..53e80dca 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
@@ -309,7 +309,7 @@ protected void renderPath(Canvas canvas, RectF plotArea, Path path, PointF first
                 RectF thisRegionRectF = thisRegionTransformed.asRectF();
                 if (thisRegionRectF != null) {
                     try {
-                        canvas.save(Canvas.ALL_SAVE_FLAG);
+                        canvas.save();
                         canvas.clipPath(path);
                         canvas.drawRect(thisRegionRectF, regionFormatter.getPaint());
                     } finally {
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java b/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
index a8793264..33d61369 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
@@ -2,11 +2,13 @@
 
 import android.graphics.RectF;
 import android.graphics.PointF;
+import android.support.annotation.NonNull;
 import android.view.*;
 
 import com.androidplot.*;
 import com.androidplot.util.*;
 
+import java.io.Serializable;
 import java.util.*;
 
 /**
@@ -35,6 +37,7 @@ public class PanZoom implements View.OnTouchListener {
     // rectangle created by the space between two fingers
     protected RectF fingersRect;
     private View.OnTouchListener delegate;
+    private State state = new State();
 
     // Definition of the touch states
     protected enum DragState {
@@ -95,7 +98,42 @@ public enum ZoomLimit {
         MIN_TICKS
     }
 
-    protected PanZoom(XYPlot plot, Pan pan, Zoom zoom) {
+    // TODO: consider making this immutable / threadsafe
+    public static class State implements Serializable {
+        private Number domainLowerBoundary;
+        private Number domainUpperBoundary;
+        private Number rangeLowerBoundary;
+        private Number rangeUpperBoundary;
+        private BoundaryMode domainBoundaryMode;
+        private BoundaryMode rangeBoundaryMode;
+
+        public void setDomainBoundaries(Number lowerBoundary, Number upperBoundary, BoundaryMode mode) {
+            this.domainLowerBoundary = lowerBoundary;
+            this.domainUpperBoundary = upperBoundary;
+            this.domainBoundaryMode = mode;
+        }
+
+        public void setRangeBoundaries(Number lowerBoundary, Number upperBoundary, BoundaryMode mode) {
+            this.rangeLowerBoundary = lowerBoundary;
+            this.rangeUpperBoundary = upperBoundary;
+            this.rangeBoundaryMode = mode;
+        }
+
+        public void applyDomainBoundaries(@NonNull XYPlot plot) {
+            plot.setDomainBoundaries(domainLowerBoundary, domainUpperBoundary, domainBoundaryMode);
+        }
+
+        public void applyRangeBoundaries(@NonNull XYPlot plot) {
+            plot.setRangeBoundaries(rangeLowerBoundary, rangeUpperBoundary, rangeBoundaryMode);
+        }
+
+        public void apply(@NonNull XYPlot plot) {
+            applyDomainBoundaries(plot);
+            applyRangeBoundaries(plot);
+        }
+    }
+
+    protected PanZoom(@NonNull XYPlot plot, Pan pan, Zoom zoom) {
         this.plot = plot;
         this.pan = pan;
         this.zoom = zoom;
@@ -103,13 +141,32 @@ protected PanZoom(XYPlot plot, Pan pan, Zoom zoom) {
     }
 
     // additional constructor not to break api
-    protected PanZoom(XYPlot plot, Pan pan, Zoom zoom, ZoomLimit limit) {
+    protected PanZoom(@NonNull XYPlot plot, Pan pan, Zoom zoom, ZoomLimit limit) {
         this.plot = plot;
         this.pan = pan;
         this.zoom = zoom;
         this.zoomLimit = limit;
     }
 
+    public State getState() {
+        return this.state;
+    }
+
+    public void setState(@NonNull State state) {
+        this.state = state;
+        state.apply(plot);
+    }
+
+    protected void adjustRangeBoundary(Number lower, Number upper,  BoundaryMode mode) {
+        state.setRangeBoundaries(lower, upper, mode);
+        state.applyRangeBoundaries(plot);
+    }
+
+    protected void adjustDomainBoundary(Number lower, Number upper, BoundaryMode mode) {
+        state.setDomainBoundaries(lower, upper, mode);
+        state.applyDomainBoundaries(plot);
+    }
+
     /**
      * Convenience method for enabling pan/zoom behavior on an instance of {@link XYPlot}, using
      * a default behavior of {@link Pan#BOTH} and {@link Zoom#SCALE}.
@@ -117,7 +174,7 @@ protected PanZoom(XYPlot plot, Pan pan, Zoom zoom, ZoomLimit limit) {
      * @param plot
      * @return
      */
-    public static PanZoom attach(XYPlot plot) {
+    public static PanZoom attach(@NonNull XYPlot plot) {
         return attach(plot, Pan.BOTH, Zoom.SCALE);
     }
 
@@ -130,7 +187,7 @@ public static PanZoom attach(XYPlot plot) {
      * @param zoom
      * @return
      */
-    public static PanZoom attach(XYPlot plot, Pan pan, Zoom zoom) {
+    public static PanZoom attach(@NonNull XYPlot plot, @NonNull Pan pan, @NonNull Zoom zoom) {
         return attach(plot,pan,zoom, ZoomLimit.OUTER);
     }
 
@@ -142,7 +199,7 @@ public static PanZoom attach(XYPlot plot, Pan pan, Zoom zoom) {
      * @param limit
      * @return
      */
-    public static PanZoom attach(XYPlot plot, Pan pan, Zoom zoom, ZoomLimit limit) {
+    public static PanZoom attach(@NonNull XYPlot plot, @NonNull Pan pan, @NonNull Zoom zoom, @NonNull ZoomLimit limit) {
         PanZoom pz = new PanZoom(plot, pan, zoom, limit);
         plot.setOnTouchListener(pz);
         return pz;
@@ -237,12 +294,12 @@ protected void pan(final MotionEvent motionEvent) {
         if (EnumSet.of(Pan.HORIZONTAL, Pan.BOTH).contains(pan)) {
             Region newBounds = new Region();
             calculatePan(oldFirstFinger, newBounds, true);
-            plot.setDomainBoundaries(newBounds.getMin(), newBounds.getMax(), BoundaryMode.FIXED);
+            adjustDomainBoundary(newBounds.getMin(), newBounds.getMax(), BoundaryMode.FIXED);
         }
         if (EnumSet.of(Pan.VERTICAL, Pan.BOTH).contains(pan)) {
             Region newBounds = new Region();
             calculatePan(oldFirstFinger, newBounds, false);
-            plot.setRangeBoundaries(newBounds.getMin(), newBounds.getMax(), BoundaryMode.FIXED);
+            adjustRangeBoundary(newBounds.getMin(), newBounds.getMax(), BoundaryMode.FIXED);
         }
 
         plot.redraw();
@@ -291,10 +348,9 @@ protected void calculatePan(final PointF oldFirstFinger, Region bounds, final bo
     }
 
     protected boolean isValidScale(float scale) {
-        if (Float.isInfinite(scale) || Float.isNaN(scale) || scale > -0.001 && scale < 0.001) {
-            return false;
-        }
-        return true;
+        return !Float.isInfinite(scale)
+                && !Float.isNaN(scale)
+                && (!(scale > -0.001) || !(scale < 0.001));
     }
 
     protected void zoom(final MotionEvent motionEvent) {
@@ -349,14 +405,14 @@ protected void zoom(final MotionEvent motionEvent) {
                 Zoom.STRETCH_BOTH,
                 Zoom.SCALE).contains(zoom)) {
             calculateZoom(newRect, scaleX, true);
-            plot.setDomainBoundaries(newRect.left, newRect.right, BoundaryMode.FIXED);
+            adjustDomainBoundary(newRect.left, newRect.right, BoundaryMode.FIXED);
         }
         if (EnumSet.of(
                 Zoom.STRETCH_VERTICAL,
                 Zoom.STRETCH_BOTH,
                 Zoom.SCALE).contains(zoom)) {
             calculateZoom(newRect, scaleY, false);
-            plot.setRangeBoundaries(newRect.top, newRect.bottom, BoundaryMode.FIXED);
+            adjustRangeBoundary(newRect.top, newRect.bottom, BoundaryMode.FIXED);
         }
         plot.redraw();
     }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index 1ca3de77..22c551e9 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -847,7 +847,7 @@ protected void drawData(Canvas canvas) throws PlotRenderException {
         }
         try {
             if (isGridClippingEnabled) {
-                canvas.save(Canvas.ALL_SAVE_FLAG);
+                canvas.save();
                 canvas.clipRect(gridRect, android.graphics.Region.Op.INTERSECT);
             }
 
diff --git a/build.gradle b/build.gradle
index a7aa9c13..d45fb28b 100644
--- a/build.gradle
+++ b/build.gradle
@@ -23,10 +23,10 @@ allprojects {
 }
 
 ext {
-    theCompileSdkVersion = 26
-    theTargetSdkVersion = 26
+    theCompileSdkVersion = 28
+    theTargetSdkVersion = 28
     theMinSdkVersion = 5
-    theVersionName = '1.5.5'
+    theVersionName = '1.5.6'
     theVersionCode = 0
 }
 
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index 6238e4df..46118949 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2015 AndroidPlot.com
+ * Copyright 2018 AndroidPlot.com
  *
  *    Licensed under the Apache License, Version 2.0 (the "License");
  *    you may not use this file except in compliance with the License.
@@ -21,7 +21,6 @@
 import android.os.Bundle;
 import android.support.annotation.NonNull;
 
-import com.androidplot.ui.Insets;
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.CatmullRomInterpolator;
 import com.androidplot.xy.LineAndPointFormatter;
@@ -49,7 +48,7 @@ public void onCreate(Bundle savedInstanceState)
         setContentView(R.layout.simple_xy_plot_example);
 
         // initialize our XYPlot reference:
-        plot = (XYPlot) findViewById(R.id.plot);
+        plot = findViewById(R.id.plot);
 
         // create a couple arrays of y-values to plot:
         final Number[] domainLabels = {1, 2, 3, 6, 7, 8, 9, 10, 13, 14};
@@ -101,19 +100,5 @@ public Object parseObject(String source, @NonNull ParsePosition pos) {
                 return null;
             }
         });
-
-        new Thread(new Runnable() {
-
-            @Override
-            public void run() {
-                try {
-                    Thread.sleep(2000);
-                } catch (InterruptedException e) {
-                    throw new RuntimeException(e);
-                }
-                plot.getGraph().setGridInsets(new Insets(120, 120, 120, 120));
-                plot.redraw();
-            }
-        }).start();
     }
 }
diff --git a/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java b/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
index c4105cde..dfae19d9 100644
--- a/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java
@@ -152,6 +152,7 @@ public void onNothingSelected(AdapterView<?> parent) {
             }
         });
 
+
         zoomSpinner.setAdapter(
                 new ArrayAdapter<>(this, R.layout.spinner_item, PanZoom.Zoom.values()));
         zoomSpinner.setSelection(panZoom.getZoom().ordinal());
@@ -167,5 +168,19 @@ public void onNothingSelected(AdapterView<?> parent) {
             }
         });
     }
+
+    // (optional) save the current pan/zoom state
+    @Override
+    public void onSaveInstanceState(Bundle bundle) {
+         bundle.putSerializable("pan-zoom-state", panZoom.getState());
+    }
+
+    // (optional) restore the previously saved pan/zoom state
+    @Override
+    public void onRestoreInstanceState(Bundle bundle) {
+        PanZoom.State state = (PanZoom.State) bundle.getSerializable("pan-zoom-state");
+        panZoom.setState(state);
+        plot.redraw();
+    }
 }
 
diff --git a/docs/quickstart.md b/docs/quickstart.md
index e6ae7ff5..ffc3827d 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.5"
+    compile "com.androidplot:androidplot-core:1.5.6"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 762ac5a6..6bebeb8c 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,11 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.6
+
+* Adds convenience methods for saving / restoring `PanZoom` state.
+* (#80) Targets SDK 28, fixing compatibility issues.
+
 # 1.5.5
 
 * (#76) Fixed a bug that could cause a deadlock when grid steps are much larger than actual plot range.
diff --git a/docs/xyplot.md b/docs/xyplot.md
index 2dab08db..99128178 100644
--- a/docs/xyplot.md
+++ b/docs/xyplot.md
@@ -217,6 +217,25 @@ then the plot will pan and zoom on both axes infinitely.  To set the plot's oute
 plot.getOuterLimits().set(0, 100, 0, 100);
 ```
 
+# Saving & Restoring PanZoom State
+The `PanZoom` class provides convenience methods for saving and restoring state from your `Activity`:
+
+```java
+// save the current pan/zoom state
+@Override
+public void onSaveInstanceState(Bundle bundle) {
+     bundle.putSerializable("pan-zoom-state", panZoom.getState());
+}
+
+// restore the previously saved pan/zoom state
+@Override
+public void onRestoreInstanceState(Bundle bundle) {
+    PanZoom.State state = (PanZoom.State) bundle.getSerializable("pan-zoom-state");
+    panZoom.setState(state);
+    plot.redraw();
+}
+```
+
 For a more detailed look at pan & zoom behavior, check out the [Touch Zoom Example source code](../demoapp/src/main/java/com/androidplot/demos/TouchZoomExampleActivity.java).
 
 # Series Renderers

From f04f2b945a579da20f1ec725bac3ab2a003b439b Mon Sep 17 00:00:00 2001
From: Chukwuemeka Nwagu <c_nwagu@yahoo.com>
Date: Mon, 10 Sep 2018 16:36:34 +0100
Subject: [PATCH 15/48] Update attrs.md (#85)

change rangeTitleColor to rangeTitleTextColor
---
 docs/attrs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/attrs.md b/docs/attrs.md
index 256852d7..afda917c 100644
--- a/docs/attrs.md
+++ b/docs/attrs.md
@@ -162,7 +162,7 @@ __boolean__
 ### rangeTitle
 __string__
 
-### rangeTitleColor
+### rangeTitleTextColor
 __color__
 
 ### rangeTitleTextSize

From ef6dd8b1bd48175cffafa20153ae54ac5842aef6 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 10 Sep 2018 10:37:48 -0500
Subject: [PATCH 16/48] uprev to 1.5.7

---
 build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index d45fb28b..1e1d8c9f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -26,7 +26,7 @@ ext {
     theCompileSdkVersion = 28
     theTargetSdkVersion = 28
     theMinSdkVersion = 5
-    theVersionName = '1.5.6'
+    theVersionName = '1.5.7'
     theVersionCode = 0
 }
 

From a4d350a3a0e228d1206507f708154cc1a262d721 Mon Sep 17 00:00:00 2001
From: Tim Hepner <tim@hepners.net>
Date: Fri, 21 Sep 2018 18:29:14 -0700
Subject: [PATCH 17/48] fix docs

---
 docs/custom_renderer.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/custom_renderer.md b/docs/custom_renderer.md
index e82f3ecf..73cac354 100644
--- a/docs/custom_renderer.md
+++ b/docs/custom_renderer.md
@@ -27,7 +27,7 @@ class RoundedBarFormatter extends BarFormatter {
 
     @Override
     public RoundedBarRenderer doGetRendererInstance(XYPlot xyPlot) {
-        return new RoundedBarRenderer(plot);
+        return new RoundedBarRenderer(xyPlot);
     }
 }
 ```
@@ -98,4 +98,4 @@ plot.addSeries(series2, new RoundedBarFormatter(Color.BLUE));
 
 Here's what this would look like used in the demo app's `SimpleXYPlotActivity`:
 
-![image](images/screens/rounded_bar_renderer.png)
\ No newline at end of file
+![image](images/screens/rounded_bar_renderer.png)

From c960518cf7b024eda576b41bb2dbf9f5acdcbaee Mon Sep 17 00:00:00 2001
From: Tim Hepner <tim@hepners.net>
Date: Sat, 22 Sep 2018 12:57:16 -0700
Subject: [PATCH 18/48] should be StepMode not BoundryMode

---
 docs/xyplot.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/xyplot.md b/docs/xyplot.md
index 99128178..ce7e1526 100644
--- a/docs/xyplot.md
+++ b/docs/xyplot.md
@@ -87,14 +87,14 @@ These are the horizontal lines drawn on a graph.  These lines are configured via
 Androidplot provides these step modes:
 
 ### Subdivide
-When using `BoundaryMode.SUBDIVIDE`, the graph is subdivided into the specified number of sections.
+When using `StepMode.SUBDIVIDE`, the graph is subdivided into the specified number of sections.
 
 ### IncrementByValue
-`BoundaryMode.INCREMENT_BY_VALUE` instructs Androidplot draw grid lines at the specified interval.  This
+`StepMode.INCREMENT_BY_VALUE` instructs Androidplot draw grid lines at the specified interval.  This
 is the most commonly used modes as is produces an easy to read result.
 
 ### IncrementByPixels
-`BoundaryMode.INCREMENT_BY_PIXELS` behaves identically to `BoundaryMode.INCREMENT_BY_VALUE` except that 
+`StepMode.INCREMENT_BY_PIXELS` behaves identically to `StepMode.INCREMENT_BY_VALUE` except that 
 the increment quantity is expressed in pixels.
 
 ## Domain & Range Labels

From 3e4c0bcc2b70848f5d02eac3d3c4eb09a05c5d09 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sat, 20 Jul 2019 11:36:28 -0500
Subject: [PATCH 19/48] v1.5.7 Changes (#95)

* adds convenience methods for saving and restoring pan / zoom state

* adds IN_ORDER mode to BarRenderer

* remove unused PlotRenderException

* valuemarkers now contain their own draw logic, making it easier to customize

* update project / dependencies

* #94 update createBitmap to use ARGB_8888 to address ARGB_4444 deprecation warning.  adds better error message on failure.

* #83 Perform a null check before recycling buffered canvas instances

* update app version / release notes
---
 .circleci/config.yml                          |    2 +-
 androidplot-core/build.gradle                 |   23 +-
 .../src/main/java/com/androidplot/Plot.java   | 2078 +++++++++--------
 .../exception/PlotRenderException.java        |   23 -
 .../java/com/androidplot/pie/PieRenderer.java |    3 +-
 .../java/com/androidplot/pie/PieWidget.java   |    3 +-
 .../com/androidplot/ui/LayoutManager.java     |    3 +-
 .../com/androidplot/ui/SeriesRenderer.java    |    7 +-
 .../androidplot/ui/widget/LegendWidget.java   |    5 +-
 .../com/androidplot/ui/widget/Widget.java     |    5 +-
 .../xy/AdvancedLineAndPointRenderer.java      |    3 +-
 .../java/com/androidplot/xy/BarRenderer.java  |   10 +-
 .../com/androidplot/xy/BubbleRenderer.java    |    3 +-
 .../xy/FastLineAndPointRenderer.java          |    3 +-
 .../com/androidplot/xy/GroupRenderer.java     |    3 +-
 .../androidplot/xy/LineAndPointRenderer.java  |    3 +-
 .../java/com/androidplot/xy/ValueMarker.java  |   39 +
 .../java/com/androidplot/xy/XValueMarker.java |   18 +
 .../com/androidplot/xy/XYGraphWidget.java     |   71 +-
 .../java/com/androidplot/xy/YValueMarker.java |   20 +
 .../test/java/com/androidplot/PlotTest.java   |   24 +-
 .../java/com/androidplot/test/TestUtils.java  |    6 +-
 .../com/androidplot/ui/widget/WidgetTest.java |   11 +-
 .../com/androidplot/xy/BarRendererTest.java   |   45 +-
 .../com/androidplot/xy/XYGraphWidgetTest.java |    5 +-
 build.gradle                                  |   11 +-
 demoapp/build.gradle                          |   10 +-
 docs/quickstart.md                            |    2 +-
 docs/release_notes.md                         |    9 +-
 gradle/wrapper/gradle-wrapper.properties      |    4 +-
 30 files changed, 1240 insertions(+), 1212 deletions(-)
 delete mode 100644 androidplot-core/src/main/java/com/androidplot/exception/PlotRenderException.java

diff --git a/.circleci/config.yml b/.circleci/config.yml
index c5579475..f333b5c2 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -52,7 +52,7 @@ jobs:
           key: v1-dependencies-{{ checksum "build.gradle" }}
 
       # run tests & code coc!
-      - run: ./gradlew testDebug jacocoTestReportDebug
+      - run: ./gradlew testDebugUnitTest jacocoTestDebugUnitTestReport
 
       # build release
       - run: ./gradlew assembleRelease
diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index a814a4c1..0592389b 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -17,8 +17,7 @@
 apply plugin: 'com.android.library'
 apply plugin: 'com.github.dcendents.android-maven'
 apply plugin: 'com.jfrog.bintray'
-apply plugin: 'com.vanniktech.android.junit.jacoco'
-apply plugin: 'com.github.kt3k.coveralls'
+apply plugin: 'jacoco-android'
 
 class AttrMarkdown extends DefaultTask {
 
@@ -67,6 +66,14 @@ android {
         testApplicationId "com.androidplot.test"
     }
 
+    testOptions {
+        unitTests.all {
+            jacoco {
+                includeNoLocationClasses = true
+            }
+        }
+    }
+
     /**
      * TODO: enable and address lint issues.
      */
@@ -83,15 +90,15 @@ def gitUrl = 'https://github.com/halfhp/androidplot.git'
 
 dependencies {
 
-    compile 'com.halfhp.fig:figlib:1.0.7'
-    compile 'com.android.support:support-annotations:27.0.2'
-    testCompile "org.mockito:mockito-core:1.10.19"
-    testCompile group: 'junit', name: 'junit', version: '4.12'
-    testCompile "org.robolectric:robolectric:3.1"
+    implementation 'com.halfhp.fig:figlib:1.0.7'
+    implementation 'com.android.support:support-annotations:28.0.0'
+    testImplementation "org.mockito:mockito-core:2.13.0"
+    testImplementation group: 'junit', name: 'junit', version: '4.12'
+    testImplementation "org.robolectric:robolectric:4.0.1"
 
     // temp fix for:
     // https://github.com/robolectric/robolectric/issues/1932
-    testCompile 'org.khronos:opengl-api:gl1.1-android-2.1_r1'
+    testImplementation 'org.khronos:opengl-api:gl1.1-android-2.1_r1'
 }
 
 task javadoc(type: Javadoc) {
diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index 5e009635..47ef0fd6 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -1,1034 +1,1044 @@
-/*
- * Copyright 2015 AndroidPlot.com
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-package com.androidplot;
-
-import android.content.Context;
-import android.content.res.TypedArray;
-import android.graphics.Bitmap;
-import android.graphics.Canvas;
-import android.graphics.Color;
-import android.graphics.Paint;
-import android.graphics.PorterDuff;
-import android.graphics.RectF;
-import android.os.Build;
-import android.os.Looper;
-import android.support.annotation.Nullable;
-import android.util.AttributeSet;
-import android.util.Log;
-import android.view.View;
-
-import com.androidplot.exception.PlotRenderException;
-import com.androidplot.ui.Anchor;
-import com.androidplot.ui.BoxModel;
-import com.androidplot.ui.Formatter;
-import com.androidplot.ui.HorizontalPositioning;
-import com.androidplot.ui.LayoutManager;
-import com.androidplot.ui.Resizable;
-import com.androidplot.ui.SeriesBundle;
-import com.androidplot.ui.SeriesRenderer;
-import com.androidplot.ui.Size;
-import com.androidplot.ui.SizeMode;
-import com.androidplot.ui.TextOrientation;
-import com.androidplot.ui.VerticalPositioning;
-import com.androidplot.ui.widget.TextLabelWidget;
-import com.androidplot.util.AttrUtils;
-import com.androidplot.util.DisplayDimensions;
-import com.androidplot.util.PixelUtils;
-import com.halfhp.fig.Fig;
-import com.halfhp.fig.FigException;
-
-import java.lang.reflect.Field;
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.List;
-
-/**
- * Base class for all Plot implementations.
- */
-public abstract class Plot<SeriesType extends Series, FormatterType extends Formatter,
-        RendererType extends SeriesRenderer, BundleType extends SeriesBundle<SeriesType, FormatterType>,
-        RegistryType extends SeriesRegistry<BundleType, SeriesType, FormatterType>>
-        extends View implements Resizable {
-    private static final String TAG = Plot.class.getName();
-    private static final String XML_ATTR_PREFIX      = "androidplot";
-    private static final String BASE_PACKAGE = "com.androidplot.";
-
-    private static final int DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP = 10;
-
-    public DisplayDimensions getDisplayDimensions() {
-        return displayDims;
-    }
-
-    /**
-     * 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.
-     */
-    public HashMap<Class<? extends RendererType>, RendererType> getRenderers() {
-        return renderers;
-    }
-
-    /**
-     * Associates lists series and getFormatter pairs with the class of the Renderer used to render them.
-     */
-    public RegistryType getRegistry() {
-        return registry;
-    }
-
-    public void setRegistry(RegistryType registry) {
-        this.registry = registry;
-        for(BundleType bundle : registry.getSeriesAndFormatterList()) {
-            attachSeries(bundle.getSeries(), bundle.getFormatter());
-        }
-    }
-
-    /**
-     *
-     * @return A new instance of RegistryType
-     */
-    protected abstract RegistryType getRegistryInstance();
-
-    public TextLabelWidget getTitle() {
-        return title;
-    }
-
-    public void setTitle(TextLabelWidget title) {
-        this.title = title;
-    }
-
-    public void setTitle(String title) {
-        getTitle().setText(title);
-    }
-
-    public enum BorderStyle {
-        ROUNDED,
-        SQUARE,
-        NONE
-    }
-
-    /**
-     * The RenderMode used by a Plot to draw it's self onto the screen.  The RenderMode can be set
-     * in two ways.
-     *
-     * In an xml layout:
-     *
-     * <code>
-     * <com.androidplot.xy.XYPlot
-     * android:id="@+id/mySimpleXYPlot"
-     * android:layout_width="fill_parent"
-     * android:layout_height="fill_parent"
-     * title="@string/sxy_title"
-     * renderMode="useBackgroundThread"/>
-     * </code>
-     *
-     * Programatically:
-     *
-     * <code>
-     * XYPlot myPlot = new XYPlot(context "MyPlot", Plot.RenderMode.USE_MAIN_THREAD);
-     * </code>
-     *
-     * A Plot's  RenderMode cannot be changed after the plot has been initialized.
-     * @since 0.5.1
-     */
-    public enum RenderMode {
-        /**
-         * Use a second thread and an off-screen buffer to do drawing.  This is the preferred method
-         * of drawing dynamic data and static data that consists of a large number of points.  This mode
-         * provides more efficient CPU utilization at the cost of increased memory usage.  As of
-         * version 0.5.1 this is the default RenderMode.
-         *
-         * XML value: use_background_thread
-         * @since 0.5.1
-         */
-        USE_BACKGROUND_THREAD,
-
-        /**
-         * Do everything in the primary thread.  This is the preferred method of drawing static charts
-         * and dynamic data that consists of a small number of points. This mode uses less memory at
-         * the cost of poor CPU utilization.
-         *
-         * XML value: use_main_thread
-         * @since 0.5.1
-         */
-        USE_MAIN_THREAD
-    }
-    private BoxModel boxModel = new BoxModel();
-
-    // no border by default:
-    private BorderStyle borderStyle = Plot.BorderStyle.NONE;
-    private float borderRadiusX = 15;
-    private float borderRadiusY = 15;
-    private Paint borderPaint;
-    private Paint backgroundPaint;
-    private LayoutManager layoutManager;
-    private TextLabelWidget title;
-    private DisplayDimensions displayDims = new DisplayDimensions();
-    private RenderMode renderMode = RenderMode.USE_MAIN_THREAD;
-    private final BufferedCanvas pingPong = new BufferedCanvas();
-
-    // used to get rid of flickering when drawing offScreenBitmap to the visible Canvas.
-    private final Object renderSync = new Object();
-
-    private HashMap<Class<? extends RendererType>, RendererType> renderers;
-
-    private RegistryType registry;
-    private final ArrayList<PlotListener> listeners;
-
-    private Thread renderThread;
-    private boolean keepRunning = false;
-    private boolean isIdle = true;
-
-    {
-        listeners = new ArrayList<>();
-        registry = getRegistryInstance();
-        renderers = new HashMap<>();
-
-        borderPaint = new Paint();
-        borderPaint.setColor(Color.rgb(150, 150, 150));
-        borderPaint.setStyle(Paint.Style.STROKE);
-        borderPaint.setStrokeWidth(1.0f);
-        borderPaint.setAntiAlias(true);
-        backgroundPaint = new Paint();
-        backgroundPaint.setColor(Color.DKGRAY);
-        backgroundPaint.setStyle(Paint.Style.FILL);
-    }
-
-
-    /**
-     *  Any rendering that utilizes a buffer from this class should synchronize rendering on the instance of this class
-     *  that is being used.
-     */
-    private static class BufferedCanvas {
-        private volatile Bitmap bgBuffer;  // all drawing is done on this buffer.
-        private volatile Bitmap fgBuffer;
-        private Canvas canvas = new Canvas();
-
-        /**
-         * Call this method once drawing on a Canvas retrieved by {@link #getCanvas()} to mark
-         * the buffer as fully rendered.  Failure to call this method will result in nothing being drawn.
-         */
-        public synchronized void swap() {
-            Bitmap tmp = bgBuffer;
-            bgBuffer = fgBuffer;
-            fgBuffer = tmp;
-        }
-
-        public synchronized void resize(int h, int w) {
-            if (w <= 0 || h <= 0) {
-                bgBuffer = null;
-                fgBuffer = null;
-            } else {
-                bgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_4444);
-                fgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_4444);
-            }
-        }
-
-        public void recycle() {
-            bgBuffer.recycle();
-            bgBuffer = null;
-
-            fgBuffer.recycle();
-            fgBuffer = null;
-            System.gc();
-        }
-
-        /**
-         * Get a Canvas for drawing.  Actual drawing should be synchronized on the instance
-         * of BufferedCanvas being used.
-         * @return The Canvas instance to draw onto.  Returns null if drawing buffers have not
-         *         been initialized a la {@link #resize(int, int)}.
-         */
-        public synchronized Canvas getCanvas() {
-            if(bgBuffer != null) {
-                canvas.setBitmap(bgBuffer);
-                return canvas;
-            } else {
-                return null;
-            }
-        }
-
-        /**
-         * @return The most recent fully rendered Bitmsp
-         */
-        public Bitmap getBitmap() {
-            return fgBuffer;
-        }
-    }
-
-    /**
-     * Convenience constructor - wraps {@link #Plot(android.content.Context, String, com.androidplot.Plot.RenderMode)}.
-     * RenderMode is set to {@link RenderMode#USE_BACKGROUND_THREAD}.
-     * @param context
-     * @param title The display title of this Plot.
-     */
-    public Plot(Context context, String title) {
-        this(context, title, RenderMode.USE_MAIN_THREAD);
-    }
-
-    /**
-     * Used for programmatic instantiation.
-     * @param context
-     * @param title The display title of this Plot.
-     */
-    public Plot(Context context, String title, RenderMode mode) {
-        super(context);
-        this.renderMode = mode;
-        init(context, null, 0);
-        getTitle().setText(title);
-    }
-
-
-    /**
-     * 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:
-     * <code>
-     * if(getClass().equals(DerivedPlot.class) {
-     *     loadAttrs(context, attrs);
-     * }
-     * </code>
-     *
-     * See {@link com.androidplot.xy.XYPlot#XYPlot(android.content.Context, android.util.AttributeSet)}
-     * for an example.
-     * @param context
-     * @param attrs
-     */
-    public Plot(Context context, AttributeSet attrs) {
-        super(context, attrs);
-        init(context, attrs, 0);
-    }
-
-    /**
-     * 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:
-     * <code>
-     * if(getClass().equals(DerivedPlot.class) {
-     *     loadAttrs(context, attrs);
-     * }
-     * </code>
-     *
-     * See {@link com.androidplot.xy.XYPlot#XYPlot(android.content.Context, android.util.AttributeSet, int)}
-     * for an example.
-     * @param context
-     * @param attrs
-     * @param defStyle
-     */
-    public Plot(Context context, AttributeSet attrs, int defStyle) {
-        super(context, attrs, defStyle);
-        init(context, attrs, defStyle);
-    }
-
-    /**
-     * Can be overridden by derived classes to control hardware acceleration state.
-     * Note that this setting is only used on Honeycomb and later environments.
-     * @return True if hardware acceleration is allowed, false otherwise.
-     * @since 0.5.1
-     */
-    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
-    protected boolean isHwAccelerationSupported() {
-        return false;
-    }
-
-    /**
-     * 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.
-     * @param mode
-     */
-    public void setRenderMode(RenderMode mode) {
-        this.renderMode = mode;
-    }
-
-    /**
-     * Concrete implementations may 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.
-     */
-    protected void onPreInit() {
-        // nothing to do by default
-    }
-
-    /**
-     * Invoked immediately following configurator / styleable attr application.
-     */
-    protected void onAfterConfig() {
-        // nothing to do by default
-    }
-
-    protected final void init(Context context, AttributeSet attrs, int defStyle) {
-        PixelUtils.init(context);
-        layoutManager = new LayoutManager();
-        title = new TextLabelWidget(layoutManager, new Size(25,
-                SizeMode.ABSOLUTE, 100,
-                SizeMode.ABSOLUTE),
-                TextOrientation.HORIZONTAL);
-        title.position(0, HorizontalPositioning.RELATIVE_TO_CENTER, 0,
-                VerticalPositioning.ABSOLUTE_FROM_TOP, Anchor.TOP_MIDDLE);
-
-        // initialize attr defaults:
-        title.getLabelPaint().setTextSize(
-                PixelUtils.spToPix(DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP));
-
-        onPreInit();
-        // make sure the title widget is always the topmost widget:
-        layoutManager.moveToTop(title);
-        if(context != null && attrs != null) {
-            loadAttrs(attrs, defStyle);
-        }
-
-        onAfterConfig();
-
-        layoutManager.onPostInit();
-        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
-            renderThread = new Thread(new Runnable() {
-                @Override
-                public void run() {
-
-                    keepRunning = true;
-                    while (keepRunning) {
-                        isIdle = false;
-                        synchronized (pingPong) {
-                            Canvas c = pingPong.getCanvas();
-                            renderOnCanvas(c);
-                            pingPong.swap();
-                        }
-                        synchronized (renderSync) {
-                            postInvalidate();
-                            // prevent this thread from becoming an orphan
-                            // after the view is destroyed
-                            if (keepRunning) {
-                                try {
-                                    renderSync.wait();
-                                } catch (InterruptedException e) {
-                                    keepRunning = false;
-                                }
-                            }
-                        }
-                    }
-                    pingPong.recycle();
-                }
-            }, "Androidplot renderThread");
-        }
-    }
-
-    /**
-     * 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.
-     * @param attrs Attrs for the derived class.
-     */
-    protected abstract void processAttrs(TypedArray attrs);
-
-    /**
-     * Apply base class attrs.
-     * @param attrs
-     */
-    private void processBaseAttrs(TypedArray attrs) {
-
-        // markup mode
-        boolean markupEnabled = attrs.getBoolean(R.styleable.Plot_markupEnabled, false);
-        setMarkupEnabled(markupEnabled);
-
-        // renderMode
-        RenderMode renderMode = RenderMode.values()
-                [attrs.getInt(R.styleable.Plot_renderMode, getRenderMode().ordinal())];
-        if(renderMode != getRenderMode()) {
-            setRenderMode(renderMode);
-        }
-
-        // margins & padding
-        AttrUtils.configureBoxModelable(attrs, boxModel, R.styleable.Plot_marginTop, R.styleable.Plot_marginBottom,
-                R.styleable.Plot_marginLeft, R.styleable.Plot_marginRight, R.styleable.Plot_paddingTop,
-                R.styleable.Plot_paddingBottom, R.styleable.Plot_paddingLeft, R.styleable.Plot_paddingRight);
-
-        // title
-        getTitle().setText(attrs.getString(R.styleable.Plot_title));
-        getTitle().getLabelPaint().setTextSize(
-                attrs.getDimension(R.styleable.Plot_titleTextSize,
-                        PixelUtils.spToPix(DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP)));
-
-        getTitle().getLabelPaint().setColor(attrs.getColor(
-                R.styleable.Plot_titleTextColor, getTitle().getLabelPaint().getColor()));
-
-        getBackgroundPaint().setColor(
-                attrs.getColor(R.styleable.Plot_backgroundColor, getBackgroundPaint().getColor()));
-
-        AttrUtils.configureLinePaint(attrs, getBorderPaint(),
-                R.styleable.Plot_borderColor, R.styleable.Plot_borderThickness);
-    }
-
-    /**
-     * Parse XML Attributes.  Should only be called once and at the end of the base class constructor.
-     * The first-pass attempts to locate styleable attributes and apply those first.  After that,
-     * configurator-style attributes are applied, overriding any styleable attrs that may have
-     * been previously applied.
-     *
-     * @param attrs
-     */
-    private void loadAttrs(AttributeSet attrs, int defStyle) {
-
-        if (attrs != null) {
-
-            Field styleableFieldInR = null;
-            TypedArray typedAttrs = null;
-            
-            Class styleableClass = R.styleable.class;
-            String styleableName = getClass().getName().substring(BASE_PACKAGE.length());
-            styleableName = styleableName.replace('.', '_');
-            try {
-                /**
-                 * Use reflection to safely run for the existence of styleable defs for Plot
-                 * and it's derivatives.  This safety run is necessary to avoid runtime exceptions
-                 * in apps that don't include Androidplot as a .aar and won't have access to
-                 * the resources defined in the core library.
-                 */
-                styleableFieldInR = styleableClass.getField(styleableName);
-            } catch (NoSuchFieldException e) {
-                Log.d(TAG, "Styleable definition not found for: " + styleableName);
-            }
-            if (styleableFieldInR != null) {
-                try {
-                    int[] resIds = (int[]) styleableFieldInR.get(null);
-                    typedAttrs = getContext().obtainStyledAttributes(attrs, resIds, defStyle, 0);
-                } catch (IllegalAccessException e) {
-                    // nothing to do
-                } finally {
-                    if (typedAttrs != null) {
-                        // apply derived class' attrs:
-                        processAttrs(typedAttrs);
-                        typedAttrs.recycle();
-                    }
-                }
-            }
-
-            try {
-                styleableFieldInR = styleableClass.getField(Plot.class.getSimpleName());
-                if (styleableFieldInR != null) {
-                    int[] resIds = (int[]) styleableFieldInR.get(null);
-                    typedAttrs = getContext().obtainStyledAttributes(attrs, resIds, defStyle, 0);
-                }
-            } catch (IllegalAccessException e) {
-                // nothing to do
-            } catch (NoSuchFieldException e) {
-                Log.d(TAG, "Styleable definition not found for: " + Plot.class.getSimpleName());
-            } finally {
-                if (typedAttrs != null) {
-                    // apply base attrs:
-                    processBaseAttrs(typedAttrs);
-                    typedAttrs.recycle();
-                }
-            }
-
-            // apply "configurator" attrs: (overrides any previously applied styleable attrs)
-            // filter out androidplot prefixed attrs:
-            HashMap<String, String> attrHash = new HashMap<>();
-            for (int i = 0; i < attrs.getAttributeCount(); i++) {
-                String attrName = attrs.getAttributeName(i);
-
-                // case insensitive run to see if this attr begins with our prefix:
-                if (attrName != null && attrName.toUpperCase().startsWith(XML_ATTR_PREFIX.toUpperCase())) {
-                    attrHash.put(attrName.substring(XML_ATTR_PREFIX.length() + 1), attrs.getAttributeValue(i));
-                }
-            }
-            try {
-                Fig.configure(getContext(), this, attrHash);
-            } catch (FigException e) {
-                throw new RuntimeException(e);
-            }
-        }
-    }
-
-    public RenderMode getRenderMode() {
-        return renderMode;
-    }
-
-    public synchronized boolean addListener(PlotListener listener) {
-        return !listeners.contains(listener) && listeners.add(listener);
-    }
-
-    public synchronized boolean removeListener(PlotListener listener) {
-        return listeners.remove(listener);
-    }
-
-    protected ArrayList<PlotListener> getListeners() {
-        return listeners;
-    }
-
-    protected void notifyListenersBeforeDraw(Canvas canvas) {
-        for (PlotListener listener : listeners) {
-            listener.onBeforeDraw(this, canvas);
-        }
-    }
-
-    protected void notifyListenersAfterDraw(Canvas canvas) {
-        for (PlotListener listener : listeners) {
-            listener.onAfterDraw(this, canvas);
-        }
-    }
-
-    /**
-     * Convenience method to add a multiple series at once using the same formatter.
-     * If a problem is encountered, the method immediately returns false and the plot
-     * will contain whatever series were added before the failure.
-     * @param formatter
-     * @param series
-     * @return True if all series were successfully added, false otherwise.
-     * @since 0.9.7
-     */
-    public synchronized boolean addSeries(FormatterType formatter, SeriesType... series) {
-        for(SeriesType s : series) {
-            if(!addSeries(s, formatter)) {
-                return false;
-            }
-        }
-        return true;
-    }
-
-    /**
-     * Add a new Series to the Plot.
-     * @param series
-     * @param formatter
-     * @return True if the series was added or false if the series / formatter pair already exists in the registry.
-     */
-    public synchronized boolean addSeries(SeriesType series, FormatterType formatter) {
-        final boolean result = getRegistry().add(series, formatter);
-        attachSeries(series, formatter);
-        return result;
-    }
-
-    protected void attachSeries(SeriesType series, FormatterType formatter) {
-
-        Class rendererClass = formatter.getRendererClass();
-
-        // initialize the Renderer if necessary:
-        if(!getRenderers().containsKey(rendererClass)) {
-            getRenderers().put(rendererClass, (RendererType) formatter.getRendererInstance(this));
-        }
-
-        // if this series implements PlotListener, add it as a listener:
-        if(series instanceof PlotListener) {
-            addListener((PlotListener)series);
-        }
-    }
-
-    /**
-     *
-     * @param series
-     * @param rendererClass
-     * @return The {@link SeriesBundle} that matches the series and rendererClass params, or null if one is not found.
-     */
-    protected SeriesBundle<SeriesType, FormatterType> getSeries(SeriesType series, Class<? extends RendererType> rendererClass) {
-        for(SeriesBundle<SeriesType, FormatterType> thisPair : getSeries(series)) {
-            if(thisPair.getFormatter().getRendererClass() == rendererClass) {
-                return thisPair;
-            }
-        }
-        return null;
-    }
-
-    /**
-     *
-     * @param series
-     * @return A List of {@link SeriesBundle} instances that reference series.
-     */
-    protected List<SeriesBundle<SeriesType, FormatterType>> getSeries(SeriesType series) {
-        return getRegistry().get(series);
-    }
-
-    /**
-     *
-     * Remove a series for a specific Renderer only.  Use {@link #removeSeries(Series)} to remove the series
-     * from the plot completely.
-     * @param series
-     * @param rendererClass
-     * @return True if anything was removed, false otherwise
-     */
-    public synchronized boolean removeSeries(SeriesType series, Class<? extends RendererType> rendererClass) {
-
-        List removedItems = getRegistry().remove(series, rendererClass);
-
-        // if series implements PlotListener and is not assigned to any other renderers remove it as a listener:
-        if (removedItems.size() == 1 && series instanceof PlotListener) {
-            removeListener((PlotListener) series);
-            return true;
-        }
-        return false;
-    }
-
-    /**
-     * Remove all occurrences of series regardless of the associated Renderer.
-     * @param series
-     */
-    public synchronized void removeSeries(SeriesType series) {
-        // if series implements PlotListener, remove it from listeners:
-        if (series instanceof PlotListener) {
-            removeListener((PlotListener) series);
-        }
-
-        getRegistry().remove(series);
-    }
-
-    /**
-     * Remove all series from the plot.
-     */
-    public void clear() {
-        for(SeriesType series : getRegistry().getSeriesList()) {
-            if(series instanceof  PlotListener) {
-                removeListener((PlotListener) series);
-            }
-        }
-        getRegistry().clear();
-    }
-
-    public boolean isEmpty() {
-        return getRegistry().isEmpty();
-    }
-
-    /**
-     *
-     * @param series
-     * @param rendererClass
-     * @return The Formatter instance corresponding to the specified  series / renderer pair.
-     */
-    public FormatterType getFormatter(SeriesType series, Class<? extends RendererType> rendererClass) {
-        return getSeries(series, rendererClass).getFormatter();
-    }
-
-    public <T extends RendererType> T getRenderer(Class<T> rendererClass) {
-        return (T) getRenderers().get(rendererClass);
-    }
-
-    public List<RendererType> getRendererList() {
-        return new ArrayList<>(getRenderers().values());
-    }
-
-    public void setMarkupEnabled(boolean enabled) {
-        this.layoutManager.setMarkupEnabled(enabled);
-    }
-
-    /**
-     * Causes the plot to be redrawn.
-     * @since 0.5.1
-     */
-    public void redraw() {
-
-        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
-
-            // only enter synchronized block if the call is expected to block OR
-            // if the render thread is idle, so we know that we won't have to wait to
-            // obtain a lock.
-            if (isIdle) {
-                synchronized (renderSync) {
-                    renderSync.notify();
-                }
-            }
-        } else if(renderMode == RenderMode.USE_MAIN_THREAD) {
-
-            // are we on the UI thread?
-            if (Looper.myLooper() == Looper.getMainLooper()) {
-                invalidate();
-            } else {
-                postInvalidate();
-            }
-        } else {
-            throw new IllegalArgumentException("Unsupported Render Mode: " + renderMode);
-        }
-    }
-
-    @Override
-    public synchronized void layout(final DisplayDimensions dims) {
-        this.displayDims = dims;
-        layoutManager.layout(displayDims);
-    }
-
-    @Override
-    protected void onDetachedFromWindow() {
-        super.onDetachedFromWindow();
-        synchronized(renderSync) {
-            keepRunning = false;
-            renderSync.notify();
-        }
-    }
-
-
-    @Override
-    protected synchronized void onSizeChanged (int w, int h, int oldw, int oldh) {
-
-        // update pixel conversion values
-        PixelUtils.init(getContext());
-
-        // disable hardware acceleration if it's not explicitly supported
-        // by the current Plot implementation. this run only applies to
-        // honeycomb and later environments.
-        if (Build.VERSION.SDK_INT >= 11) {
-            if (!isHwAccelerationSupported() && isHardwareAccelerated()) {
-                setLayerType(View.LAYER_TYPE_SOFTWARE, null);
-            }
-        }
-
-        // pingPong is only used in background rendering mode.
-        if(renderMode == RenderMode.USE_BACKGROUND_THREAD) {
-            pingPong.resize(h, w);
-        }
-
-        RectF cRect = new RectF(0, 0, w, h);
-        RectF mRect = boxModel.getMarginatedRect(cRect);
-        RectF pRect = boxModel.getPaddedRect(mRect);
-
-        layout(new DisplayDimensions(cRect, mRect, pRect));
-        super.onSizeChanged(w, h, oldw, oldh);
-        if(renderThread != null && !renderThread.isAlive()) {
-            renderThread.start();
-        }
-    }
-
-    /**
-     * Called whenever the plot needs to be drawn via the Handler, which invokes invalidate().
-     * Should never be called directly; use {@link #redraw()} instead.
-     * @param canvas
-     */
-    @Override
-    protected void onDraw(Canvas canvas) {
-        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
-            synchronized(pingPong) {
-                Bitmap bmp = pingPong.getBitmap();
-                if(bmp != null) {
-                    canvas.drawBitmap(bmp, 0, 0, null);
-                }
-            }
-        } else if (renderMode == RenderMode.USE_MAIN_THREAD) {
-            renderOnCanvas(canvas);
-        } else {
-            throw new IllegalArgumentException("Unsupported Render Mode: " + renderMode);
-        }
-    }
-
-    /**
-     * 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".
-     * @param canvas
-     */
-    protected synchronized void renderOnCanvas(@Nullable Canvas canvas) {
-        if(canvas == null) {
-            return;
-        }
-        try {
-            // any series interested in synchronizing with plot should
-            // implement PlotListener.onBeforeDraw(...) and do a read lock from within its
-            // invocation.  This is the entry point into that call:
-            notifyListenersBeforeDraw(canvas);
-            try {
-                // need to completely erase what was on the canvas before redrawing, otherwise
-                // some odd aliasing artifacts begin to build up around the edges of aa'd entities
-                // over time.
-                canvas.drawColor(Color.TRANSPARENT, PorterDuff.Mode.CLEAR);
-                if (backgroundPaint != null) {
-                    drawBackground(canvas, displayDims.marginatedRect);
-                }
-
-                layoutManager.draw(canvas);
-
-                if (getBorderPaint() != null) {
-                    drawBorder(canvas, displayDims.marginatedRect);
-                }
-            } catch (PlotRenderException e) {
-                Log.e(TAG, "Exception while rendering Plot.", e);
-            } catch (Exception e) {
-                Log.e(TAG, "Exception while rendering Plot.", e);
-            }
-
-            isIdle = true;
-            // any series interested in synchronizing with plot should
-            // implement PlotListener.onAfterDraw(...) and do a read unlock from within that
-            // invocation. This is the entry point for that invocation.
-            notifyListenersAfterDraw(canvas);
-        } finally {
-        }
-    }
-
-
-    /**
-     * Sets the visual style of the plot's border.
-     * @param style
-     * @param radiusX Sets the X radius for BorderStyle.ROUNDED.  Use null for all other styles.
-     * @param radiusY Sets the Y radius for BorderStyle.ROUNDED.  Use null for all other styles.
-     */
-    public void setBorderStyle(BorderStyle style, Float radiusX, Float radiusY) {
-        if (style == Plot.BorderStyle.ROUNDED) {
-            if (radiusX == null || radiusY == null){
-                throw new IllegalArgumentException("radiusX and radiusY cannot be null when using BorderStyle.ROUNDED");
-            }
-            this.borderRadiusX = radiusX;
-            this.borderRadiusY = radiusY;
-        }
-        this.borderStyle = style;
-    }
-
-    /**
-     * Draws the plot's outer border.
-     * @param canvas
-     * @throws PlotRenderException
-     */
-    protected void drawBorder(Canvas canvas, RectF dims) {
-        drawRect(canvas, dims, borderPaint);
-    }
-
-    protected void drawBackground(Canvas canvas, RectF dims) {
-        drawRect(canvas, dims, backgroundPaint);
-    }
-
-    protected void drawRect(Canvas canvas, RectF dims, Paint paint) {
-        switch (borderStyle) {
-            case ROUNDED:
-                canvas.drawRoundRect(dims, borderRadiusX, borderRadiusY, paint);
-                break;
-            case SQUARE:
-            default:
-                canvas.drawRect(dims, paint);
-                break;
-        }
-    }
-
-    public LayoutManager getLayoutManager() {
-        return layoutManager;
-    }
-
-    public void setLayoutManager(LayoutManager layoutManager) {
-        this.layoutManager = layoutManager;
-    }
-
-    public Paint getBackgroundPaint() {
-        return backgroundPaint;
-    }
-
-    public void setBackgroundPaint(Paint backgroundPaint) {
-        this.backgroundPaint = backgroundPaint;
-    }
-
-    /**
-     * Convenience method - wraps the individual setMarginXXX methods into a single method.
-     * @param left
-     * @param top
-     * @param right
-     * @param bottom
-     */
-    public void setPlotMargins(float left, float top, float right, float bottom) {
-        setPlotMarginLeft(left);
-        setPlotMarginTop(top);
-        setPlotMarginRight(right);
-        setPlotMarginBottom(bottom);
-    }
-
-    /**
-     * Convenience method - wraps the individual setPaddingXXX methods into a single method.
-     * @param left
-     * @param top
-     * @param right
-     * @param bottom
-     */
-    public void setPlotPadding(float left, float top, float right, float bottom) {
-        setPlotPaddingLeft(left);
-        setPlotPaddingTop(top);
-        setPlotPaddingRight(right);
-        setPlotPaddingBottom(bottom);
-    }
-
-    public float getPlotMarginTop() {
-        return boxModel.getMarginTop();
-    }
-
-    public void setPlotMarginTop(float plotMarginTop) {
-        boxModel.setMarginTop(plotMarginTop);
-    }
-
-    public float getPlotMarginBottom() {
-        return boxModel.getMarginBottom();
-    }
-
-    public void setPlotMarginBottom(float plotMarginBottom) {
-        boxModel.setMarginBottom(plotMarginBottom);
-    }
-
-    public float getPlotMarginLeft() {
-        return boxModel.getMarginLeft();
-    }
-
-    public void setPlotMarginLeft(float plotMarginLeft) {
-        boxModel.setMarginLeft(plotMarginLeft);
-    }
-
-    public float getPlotMarginRight() {
-        return boxModel.getMarginRight();
-    }
-
-    public void setPlotMarginRight(float plotMarginRight) {
-        boxModel.setMarginRight(plotMarginRight);
-    }
-
-    public float getPlotPaddingTop() {
-        return boxModel.getPaddingTop();
-    }
-
-    public void setPlotPaddingTop(float plotPaddingTop) {
-        boxModel.setPaddingTop(plotPaddingTop);
-    }
-
-    public float getPlotPaddingBottom() {
-        return boxModel.getPaddingBottom();
-    }
-
-    public void setPlotPaddingBottom(float plotPaddingBottom) {
-        boxModel.setPaddingBottom(plotPaddingBottom);
-    }
-
-    public float getPlotPaddingLeft() {
-        return boxModel.getPaddingLeft();
-    }
-
-    public void setPlotPaddingLeft(float plotPaddingLeft) {
-        boxModel.setPaddingLeft(plotPaddingLeft);
-    }
-
-    public float getPlotPaddingRight() {
-        return boxModel.getPaddingRight();
-    }
-
-    public void setPlotPaddingRight(float plotPaddingRight) {
-        boxModel.setPaddingRight(plotPaddingRight);
-    }
-
-    public Paint getBorderPaint() {
-        return 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.
-     * @param borderPaint
-     */
-    public void setBorderPaint(Paint borderPaint) {
-        if(borderPaint == null) {
-            this.borderPaint = null;
-        } else {
-            this.borderPaint = new Paint(borderPaint);
-            this.borderPaint.setStyle(Paint.Style.STROKE);
-        }
-    }
-}
+/*
+ * Copyright 2015 AndroidPlot.com
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+package com.androidplot;
+
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Bitmap;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
+import android.graphics.PorterDuff;
+import android.graphics.RectF;
+import android.os.Build;
+import android.os.Looper;
+import android.support.annotation.Nullable;
+import android.util.AttributeSet;
+import android.util.Log;
+import android.view.View;
+
+import com.androidplot.ui.Anchor;
+import com.androidplot.ui.BoxModel;
+import com.androidplot.ui.Formatter;
+import com.androidplot.ui.HorizontalPositioning;
+import com.androidplot.ui.LayoutManager;
+import com.androidplot.ui.Resizable;
+import com.androidplot.ui.SeriesBundle;
+import com.androidplot.ui.SeriesRenderer;
+import com.androidplot.ui.Size;
+import com.androidplot.ui.SizeMode;
+import com.androidplot.ui.TextOrientation;
+import com.androidplot.ui.VerticalPositioning;
+import com.androidplot.ui.widget.TextLabelWidget;
+import com.androidplot.util.AttrUtils;
+import com.androidplot.util.DisplayDimensions;
+import com.androidplot.util.PixelUtils;
+import com.halfhp.fig.Fig;
+import com.halfhp.fig.FigException;
+
+import java.lang.reflect.Field;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+
+/**
+ * Base class for all Plot implementations.
+ */
+public abstract class Plot<SeriesType extends Series, FormatterType extends Formatter,
+        RendererType extends SeriesRenderer, BundleType extends SeriesBundle<SeriesType, FormatterType>,
+        RegistryType extends SeriesRegistry<BundleType, SeriesType, FormatterType>>
+        extends View implements Resizable {
+    private static final String TAG = Plot.class.getName();
+    private static final String XML_ATTR_PREFIX      = "androidplot";
+    private static final String BASE_PACKAGE = "com.androidplot.";
+
+    private static final int DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP = 10;
+
+    public DisplayDimensions getDisplayDimensions() {
+        return displayDims;
+    }
+
+    /**
+     * 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.
+     */
+    public HashMap<Class<? extends RendererType>, RendererType> getRenderers() {
+        return renderers;
+    }
+
+    /**
+     * Associates lists series and getFormatter pairs with the class of the Renderer used to render them.
+     */
+    public RegistryType getRegistry() {
+        return registry;
+    }
+
+    public void setRegistry(RegistryType registry) {
+        this.registry = registry;
+        for(BundleType bundle : registry.getSeriesAndFormatterList()) {
+            attachSeries(bundle.getSeries(), bundle.getFormatter());
+        }
+    }
+
+    /**
+     *
+     * @return A new instance of RegistryType
+     */
+    protected abstract RegistryType getRegistryInstance();
+
+    public TextLabelWidget getTitle() {
+        return title;
+    }
+
+    public void setTitle(TextLabelWidget title) {
+        this.title = title;
+    }
+
+    public void setTitle(String title) {
+        getTitle().setText(title);
+    }
+
+    public enum BorderStyle {
+        ROUNDED,
+        SQUARE,
+        NONE
+    }
+
+    /**
+     * The RenderMode used by a Plot to draw it's self onto the screen.  The RenderMode can be set
+     * in two ways.
+     *
+     * In an xml layout:
+     *
+     * <code>
+     * <com.androidplot.xy.XYPlot
+     * android:id="@+id/mySimpleXYPlot"
+     * android:layout_width="fill_parent"
+     * android:layout_height="fill_parent"
+     * title="@string/sxy_title"
+     * renderMode="useBackgroundThread"/>
+     * </code>
+     *
+     * Programatically:
+     *
+     * <code>
+     * XYPlot myPlot = new XYPlot(context "MyPlot", Plot.RenderMode.USE_MAIN_THREAD);
+     * </code>
+     *
+     * A Plot's  RenderMode cannot be changed after the plot has been initialized.
+     * @since 0.5.1
+     */
+    public enum RenderMode {
+        /**
+         * Use a second thread and an off-screen buffer to do drawing.  This is the preferred method
+         * of drawing dynamic data and static data that consists of a large number of points.  This mode
+         * provides more efficient CPU utilization at the cost of increased memory usage.  As of
+         * version 0.5.1 this is the default RenderMode.
+         *
+         * XML value: use_background_thread
+         * @since 0.5.1
+         */
+        USE_BACKGROUND_THREAD,
+
+        /**
+         * Do everything in the primary thread.  This is the preferred method of drawing static charts
+         * and dynamic data that consists of a small number of points. This mode uses less memory at
+         * the cost of poor CPU utilization.
+         *
+         * XML value: use_main_thread
+         * @since 0.5.1
+         */
+        USE_MAIN_THREAD
+    }
+    private BoxModel boxModel = new BoxModel();
+
+    // no border by default:
+    private BorderStyle borderStyle = Plot.BorderStyle.NONE;
+    private float borderRadiusX = 15;
+    private float borderRadiusY = 15;
+    private Paint borderPaint;
+    private Paint backgroundPaint;
+    private LayoutManager layoutManager;
+    private TextLabelWidget title;
+    private DisplayDimensions displayDims = new DisplayDimensions();
+    private RenderMode renderMode = RenderMode.USE_MAIN_THREAD;
+    private final BufferedCanvas pingPong = new BufferedCanvas();
+
+    // used to get rid of flickering when drawing offScreenBitmap to the visible Canvas.
+    private final Object renderSync = new Object();
+
+    private HashMap<Class<? extends RendererType>, RendererType> renderers;
+
+    private RegistryType registry;
+    private final ArrayList<PlotListener> listeners;
+
+    private Thread renderThread;
+    private boolean keepRunning = false;
+    private boolean isIdle = true;
+
+    {
+        listeners = new ArrayList<>();
+        registry = getRegistryInstance();
+        renderers = new HashMap<>();
+
+        borderPaint = new Paint();
+        borderPaint.setColor(Color.rgb(150, 150, 150));
+        borderPaint.setStyle(Paint.Style.STROKE);
+        borderPaint.setStrokeWidth(1.0f);
+        borderPaint.setAntiAlias(true);
+        backgroundPaint = new Paint();
+        backgroundPaint.setColor(Color.DKGRAY);
+        backgroundPaint.setStyle(Paint.Style.FILL);
+    }
+
+
+    /**
+     *  Any rendering that utilizes a buffer from this class should synchronize rendering on the instance of this class
+     *  that is being used.
+     */
+    private static class BufferedCanvas {
+        private volatile Bitmap bgBuffer;  // all drawing is done on this buffer.
+        private volatile Bitmap fgBuffer;
+        private Canvas canvas = new Canvas();
+
+        /**
+         * Call this method once drawing on a Canvas retrieved by {@link #getCanvas()} to mark
+         * the buffer as fully rendered.  Failure to call this method will result in nothing being drawn.
+         */
+        public synchronized void swap() {
+            Bitmap tmp = bgBuffer;
+            bgBuffer = fgBuffer;
+            fgBuffer = tmp;
+        }
+
+        public synchronized void resize(int h, int w) {
+            if (w <= 0 || h <= 0) {
+                bgBuffer = null;
+                fgBuffer = null;
+            } else {
+                try {
+                    bgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
+                    fgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
+                } catch(IllegalArgumentException e) {
+                    throw new IllegalArgumentException("Illegal argument passed to Bitmap.createBitmap.  width: " + w + " height: " + h);
+                }
+            }
+        }
+
+        public void recycle() {
+            /**
+             * TODO: Issue #93 There have been rare reports of NPE's originating from here.
+             * Most likely there is something deeper that is amiss, but for now we'll simply
+             * do a null check before recycling.
+             */
+            if(bgBuffer != null) {
+                bgBuffer.recycle();
+                bgBuffer = null;
+            }
+
+            if(fgBuffer != null) {
+                fgBuffer.recycle();
+                fgBuffer = null;
+            }
+
+            System.gc();
+        }
+
+        /**
+         * Get a Canvas for drawing.  Actual drawing should be synchronized on the instance
+         * of BufferedCanvas being used.
+         * @return The Canvas instance to draw onto.  Returns null if drawing buffers have not
+         *         been initialized a la {@link #resize(int, int)}.
+         */
+        public synchronized Canvas getCanvas() {
+            if(bgBuffer != null) {
+                canvas.setBitmap(bgBuffer);
+                return canvas;
+            } else {
+                return null;
+            }
+        }
+
+        /**
+         * @return The most recent fully rendered Bitmsp
+         */
+        public Bitmap getBitmap() {
+            return fgBuffer;
+        }
+    }
+
+    /**
+     * Convenience constructor - wraps {@link #Plot(android.content.Context, String, com.androidplot.Plot.RenderMode)}.
+     * RenderMode is set to {@link RenderMode#USE_BACKGROUND_THREAD}.
+     * @param context
+     * @param title The display title of this Plot.
+     */
+    public Plot(Context context, String title) {
+        this(context, title, RenderMode.USE_MAIN_THREAD);
+    }
+
+    /**
+     * Used for programmatic instantiation.
+     * @param context
+     * @param title The display title of this Plot.
+     */
+    public Plot(Context context, String title, RenderMode mode) {
+        super(context);
+        this.renderMode = mode;
+        init(context, null, 0);
+        getTitle().setText(title);
+    }
+
+
+    /**
+     * 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:
+     * <code>
+     * if(getClass().equals(DerivedPlot.class) {
+     *     loadAttrs(context, attrs);
+     * }
+     * </code>
+     *
+     * See {@link com.androidplot.xy.XYPlot#XYPlot(android.content.Context, android.util.AttributeSet)}
+     * for an example.
+     * @param context
+     * @param attrs
+     */
+    public Plot(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init(context, attrs, 0);
+    }
+
+    /**
+     * 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:
+     * <code>
+     * if(getClass().equals(DerivedPlot.class) {
+     *     loadAttrs(context, attrs);
+     * }
+     * </code>
+     *
+     * See {@link com.androidplot.xy.XYPlot#XYPlot(android.content.Context, android.util.AttributeSet, int)}
+     * for an example.
+     * @param context
+     * @param attrs
+     * @param defStyle
+     */
+    public Plot(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);
+        init(context, attrs, defStyle);
+    }
+
+    /**
+     * Can be overridden by derived classes to control hardware acceleration state.
+     * Note that this setting is only used on Honeycomb and later environments.
+     * @return True if hardware acceleration is allowed, false otherwise.
+     * @since 0.5.1
+     */
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    protected boolean isHwAccelerationSupported() {
+        return false;
+    }
+
+    /**
+     * 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.
+     * @param mode
+     */
+    public void setRenderMode(RenderMode mode) {
+        this.renderMode = mode;
+    }
+
+    /**
+     * Concrete implementations may 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.
+     */
+    protected void onPreInit() {
+        // nothing to do by default
+    }
+
+    /**
+     * Invoked immediately following configurator / styleable attr application.
+     */
+    protected void onAfterConfig() {
+        // nothing to do by default
+    }
+
+    protected final void init(Context context, AttributeSet attrs, int defStyle) {
+        PixelUtils.init(context);
+        layoutManager = new LayoutManager();
+        title = new TextLabelWidget(layoutManager, new Size(25,
+                SizeMode.ABSOLUTE, 100,
+                SizeMode.ABSOLUTE),
+                TextOrientation.HORIZONTAL);
+        title.position(0, HorizontalPositioning.RELATIVE_TO_CENTER, 0,
+                VerticalPositioning.ABSOLUTE_FROM_TOP, Anchor.TOP_MIDDLE);
+
+        // initialize attr defaults:
+        title.getLabelPaint().setTextSize(
+                PixelUtils.spToPix(DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP));
+
+        onPreInit();
+        // make sure the title widget is always the topmost widget:
+        layoutManager.moveToTop(title);
+        if(context != null && attrs != null) {
+            loadAttrs(attrs, defStyle);
+        }
+
+        onAfterConfig();
+
+        layoutManager.onPostInit();
+        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
+            renderThread = new Thread(new Runnable() {
+                @Override
+                public void run() {
+
+                    keepRunning = true;
+                    while (keepRunning) {
+                        isIdle = false;
+                        synchronized (pingPong) {
+                            Canvas c = pingPong.getCanvas();
+                            renderOnCanvas(c);
+                            pingPong.swap();
+                        }
+                        synchronized (renderSync) {
+                            postInvalidate();
+                            // prevent this thread from becoming an orphan
+                            // after the view is destroyed
+                            if (keepRunning) {
+                                try {
+                                    renderSync.wait();
+                                } catch (InterruptedException e) {
+                                    keepRunning = false;
+                                }
+                            }
+                        }
+                    }
+                    pingPong.recycle();
+                }
+            }, "Androidplot renderThread");
+        }
+    }
+
+    /**
+     * 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.
+     * @param attrs Attrs for the derived class.
+     */
+    protected abstract void processAttrs(TypedArray attrs);
+
+    /**
+     * Apply base class attrs.
+     * @param attrs
+     */
+    private void processBaseAttrs(TypedArray attrs) {
+
+        // markup mode
+        boolean markupEnabled = attrs.getBoolean(R.styleable.Plot_markupEnabled, false);
+        setMarkupEnabled(markupEnabled);
+
+        // renderMode
+        RenderMode renderMode = RenderMode.values()
+                [attrs.getInt(R.styleable.Plot_renderMode, getRenderMode().ordinal())];
+        if(renderMode != getRenderMode()) {
+            setRenderMode(renderMode);
+        }
+
+        // margins & padding
+        AttrUtils.configureBoxModelable(attrs, boxModel, R.styleable.Plot_marginTop, R.styleable.Plot_marginBottom,
+                R.styleable.Plot_marginLeft, R.styleable.Plot_marginRight, R.styleable.Plot_paddingTop,
+                R.styleable.Plot_paddingBottom, R.styleable.Plot_paddingLeft, R.styleable.Plot_paddingRight);
+
+        // title
+        getTitle().setText(attrs.getString(R.styleable.Plot_title));
+        getTitle().getLabelPaint().setTextSize(
+                attrs.getDimension(R.styleable.Plot_titleTextSize,
+                        PixelUtils.spToPix(DEFAULT_TITLE_WIDGET_TEXT_SIZE_SP)));
+
+        getTitle().getLabelPaint().setColor(attrs.getColor(
+                R.styleable.Plot_titleTextColor, getTitle().getLabelPaint().getColor()));
+
+        getBackgroundPaint().setColor(
+                attrs.getColor(R.styleable.Plot_backgroundColor, getBackgroundPaint().getColor()));
+
+        AttrUtils.configureLinePaint(attrs, getBorderPaint(),
+                R.styleable.Plot_borderColor, R.styleable.Plot_borderThickness);
+    }
+
+    /**
+     * Parse XML Attributes.  Should only be called once and at the end of the base class constructor.
+     * The first-pass attempts to locate styleable attributes and apply those first.  After that,
+     * configurator-style attributes are applied, overriding any styleable attrs that may have
+     * been previously applied.
+     *
+     * @param attrs
+     */
+    private void loadAttrs(AttributeSet attrs, int defStyle) {
+
+        if (attrs != null) {
+
+            Field styleableFieldInR = null;
+            TypedArray typedAttrs = null;
+            
+            Class styleableClass = R.styleable.class;
+            String styleableName = getClass().getName().substring(BASE_PACKAGE.length());
+            styleableName = styleableName.replace('.', '_');
+            try {
+                /**
+                 * Use reflection to safely run for the existence of styleable defs for Plot
+                 * and it's derivatives.  This safety run is necessary to avoid runtime exceptions
+                 * in apps that don't include Androidplot as a .aar and won't have access to
+                 * the resources defined in the core library.
+                 */
+                styleableFieldInR = styleableClass.getField(styleableName);
+            } catch (NoSuchFieldException e) {
+                Log.d(TAG, "Styleable definition not found for: " + styleableName);
+            }
+            if (styleableFieldInR != null) {
+                try {
+                    int[] resIds = (int[]) styleableFieldInR.get(null);
+                    typedAttrs = getContext().obtainStyledAttributes(attrs, resIds, defStyle, 0);
+                } catch (IllegalAccessException e) {
+                    // nothing to do
+                } finally {
+                    if (typedAttrs != null) {
+                        // apply derived class' attrs:
+                        processAttrs(typedAttrs);
+                        typedAttrs.recycle();
+                    }
+                }
+            }
+
+            try {
+                styleableFieldInR = styleableClass.getField(Plot.class.getSimpleName());
+                if (styleableFieldInR != null) {
+                    int[] resIds = (int[]) styleableFieldInR.get(null);
+                    typedAttrs = getContext().obtainStyledAttributes(attrs, resIds, defStyle, 0);
+                }
+            } catch (IllegalAccessException e) {
+                // nothing to do
+            } catch (NoSuchFieldException e) {
+                Log.d(TAG, "Styleable definition not found for: " + Plot.class.getSimpleName());
+            } finally {
+                if (typedAttrs != null) {
+                    // apply base attrs:
+                    processBaseAttrs(typedAttrs);
+                    typedAttrs.recycle();
+                }
+            }
+
+            // apply "configurator" attrs: (overrides any previously applied styleable attrs)
+            // filter out androidplot prefixed attrs:
+            HashMap<String, String> attrHash = new HashMap<>();
+            for (int i = 0; i < attrs.getAttributeCount(); i++) {
+                String attrName = attrs.getAttributeName(i);
+
+                // case insensitive run to see if this attr begins with our prefix:
+                if (attrName != null && attrName.toUpperCase().startsWith(XML_ATTR_PREFIX.toUpperCase())) {
+                    attrHash.put(attrName.substring(XML_ATTR_PREFIX.length() + 1), attrs.getAttributeValue(i));
+                }
+            }
+            try {
+                Fig.configure(getContext(), this, attrHash);
+            } catch (FigException e) {
+                throw new RuntimeException(e);
+            }
+        }
+    }
+
+    public RenderMode getRenderMode() {
+        return renderMode;
+    }
+
+    public synchronized boolean addListener(PlotListener listener) {
+        return !listeners.contains(listener) && listeners.add(listener);
+    }
+
+    public synchronized boolean removeListener(PlotListener listener) {
+        return listeners.remove(listener);
+    }
+
+    protected ArrayList<PlotListener> getListeners() {
+        return listeners;
+    }
+
+    protected void notifyListenersBeforeDraw(Canvas canvas) {
+        for (PlotListener listener : listeners) {
+            listener.onBeforeDraw(this, canvas);
+        }
+    }
+
+    protected void notifyListenersAfterDraw(Canvas canvas) {
+        for (PlotListener listener : listeners) {
+            listener.onAfterDraw(this, canvas);
+        }
+    }
+
+    /**
+     * Convenience method to add a multiple series at once using the same formatter.
+     * If a problem is encountered, the method immediately returns false and the plot
+     * will contain whatever series were added before the failure.
+     * @param formatter
+     * @param series
+     * @return True if all series were successfully added, false otherwise.
+     * @since 0.9.7
+     */
+    public synchronized boolean addSeries(FormatterType formatter, SeriesType... series) {
+        for(SeriesType s : series) {
+            if(!addSeries(s, formatter)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * Add a new Series to the Plot.
+     * @param series
+     * @param formatter
+     * @return True if the series was added or false if the series / formatter pair already exists in the registry.
+     */
+    public synchronized boolean addSeries(SeriesType series, FormatterType formatter) {
+        final boolean result = getRegistry().add(series, formatter);
+        attachSeries(series, formatter);
+        return result;
+    }
+
+    protected void attachSeries(SeriesType series, FormatterType formatter) {
+
+        Class rendererClass = formatter.getRendererClass();
+
+        // initialize the Renderer if necessary:
+        if(!getRenderers().containsKey(rendererClass)) {
+            getRenderers().put(rendererClass, (RendererType) formatter.getRendererInstance(this));
+        }
+
+        // if this series implements PlotListener, add it as a listener:
+        if(series instanceof PlotListener) {
+            addListener((PlotListener)series);
+        }
+    }
+
+    /**
+     *
+     * @param series
+     * @param rendererClass
+     * @return The {@link SeriesBundle} that matches the series and rendererClass params, or null if one is not found.
+     */
+    protected SeriesBundle<SeriesType, FormatterType> getSeries(SeriesType series, Class<? extends RendererType> rendererClass) {
+        for(SeriesBundle<SeriesType, FormatterType> thisPair : getSeries(series)) {
+            if(thisPair.getFormatter().getRendererClass() == rendererClass) {
+                return thisPair;
+            }
+        }
+        return null;
+    }
+
+    /**
+     *
+     * @param series
+     * @return A List of {@link SeriesBundle} instances that reference series.
+     */
+    protected List<SeriesBundle<SeriesType, FormatterType>> getSeries(SeriesType series) {
+        return getRegistry().get(series);
+    }
+
+    /**
+     *
+     * Remove a series for a specific Renderer only.  Use {@link #removeSeries(Series)} to remove the series
+     * from the plot completely.
+     * @param series
+     * @param rendererClass
+     * @return True if anything was removed, false otherwise
+     */
+    public synchronized boolean removeSeries(SeriesType series, Class<? extends RendererType> rendererClass) {
+
+        List removedItems = getRegistry().remove(series, rendererClass);
+
+        // if series implements PlotListener and is not assigned to any other renderers remove it as a listener:
+        if (removedItems.size() == 1 && series instanceof PlotListener) {
+            removeListener((PlotListener) series);
+            return true;
+        }
+        return false;
+    }
+
+    /**
+     * Remove all occurrences of series regardless of the associated Renderer.
+     * @param series
+     */
+    public synchronized void removeSeries(SeriesType series) {
+        // if series implements PlotListener, remove it from listeners:
+        if (series instanceof PlotListener) {
+            removeListener((PlotListener) series);
+        }
+
+        getRegistry().remove(series);
+    }
+
+    /**
+     * Remove all series from the plot.
+     */
+    public void clear() {
+        for(SeriesType series : getRegistry().getSeriesList()) {
+            if(series instanceof  PlotListener) {
+                removeListener((PlotListener) series);
+            }
+        }
+        getRegistry().clear();
+    }
+
+    public boolean isEmpty() {
+        return getRegistry().isEmpty();
+    }
+
+    /**
+     *
+     * @param series
+     * @param rendererClass
+     * @return The Formatter instance corresponding to the specified  series / renderer pair.
+     */
+    public FormatterType getFormatter(SeriesType series, Class<? extends RendererType> rendererClass) {
+        return getSeries(series, rendererClass).getFormatter();
+    }
+
+    public <T extends RendererType> T getRenderer(Class<T> rendererClass) {
+        return (T) getRenderers().get(rendererClass);
+    }
+
+    public List<RendererType> getRendererList() {
+        return new ArrayList<>(getRenderers().values());
+    }
+
+    public void setMarkupEnabled(boolean enabled) {
+        this.layoutManager.setMarkupEnabled(enabled);
+    }
+
+    /**
+     * Causes the plot to be redrawn.
+     * @since 0.5.1
+     */
+    public void redraw() {
+
+        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
+
+            // only enter synchronized block if the call is expected to block OR
+            // if the render thread is idle, so we know that we won't have to wait to
+            // obtain a lock.
+            if (isIdle) {
+                synchronized (renderSync) {
+                    renderSync.notify();
+                }
+            }
+        } else if(renderMode == RenderMode.USE_MAIN_THREAD) {
+
+            // are we on the UI thread?
+            if (Looper.myLooper() == Looper.getMainLooper()) {
+                invalidate();
+            } else {
+                postInvalidate();
+            }
+        } else {
+            throw new IllegalArgumentException("Unsupported Render Mode: " + renderMode);
+        }
+    }
+
+    @Override
+    public synchronized void layout(final DisplayDimensions dims) {
+        this.displayDims = dims;
+        layoutManager.layout(displayDims);
+    }
+
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        synchronized(renderSync) {
+            keepRunning = false;
+            renderSync.notify();
+        }
+    }
+
+
+    @Override
+    protected synchronized void onSizeChanged (int w, int h, int oldw, int oldh) {
+
+        // update pixel conversion values
+        PixelUtils.init(getContext());
+
+        // disable hardware acceleration if it's not explicitly supported
+        // by the current Plot implementation. this run only applies to
+        // honeycomb and later environments.
+        if (Build.VERSION.SDK_INT >= 11) {
+            if (!isHwAccelerationSupported() && isHardwareAccelerated()) {
+                setLayerType(View.LAYER_TYPE_SOFTWARE, null);
+            }
+        }
+
+        // pingPong is only used in background rendering mode.
+        if(renderMode == RenderMode.USE_BACKGROUND_THREAD) {
+            pingPong.resize(h, w);
+        }
+
+        RectF cRect = new RectF(0, 0, w, h);
+        RectF mRect = boxModel.getMarginatedRect(cRect);
+        RectF pRect = boxModel.getPaddedRect(mRect);
+
+        layout(new DisplayDimensions(cRect, mRect, pRect));
+        super.onSizeChanged(w, h, oldw, oldh);
+        if(renderThread != null && !renderThread.isAlive()) {
+            renderThread.start();
+        }
+    }
+
+    /**
+     * Called whenever the plot needs to be drawn via the Handler, which invokes invalidate().
+     * Should never be called directly; use {@link #redraw()} instead.
+     * @param canvas
+     */
+    @Override
+    protected void onDraw(Canvas canvas) {
+        if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
+            synchronized(pingPong) {
+                Bitmap bmp = pingPong.getBitmap();
+                if(bmp != null) {
+                    canvas.drawBitmap(bmp, 0, 0, null);
+                }
+            }
+        } else if (renderMode == RenderMode.USE_MAIN_THREAD) {
+            renderOnCanvas(canvas);
+        } else {
+            throw new IllegalArgumentException("Unsupported Render Mode: " + renderMode);
+        }
+    }
+
+    /**
+     * 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".
+     * @param canvas
+     */
+    protected synchronized void renderOnCanvas(@Nullable Canvas canvas) {
+        if(canvas == null) {
+            return;
+        }
+        try {
+            // any series interested in synchronizing with plot should
+            // implement PlotListener.onBeforeDraw(...) and do a read lock from within its
+            // invocation.  This is the entry point into that call:
+            notifyListenersBeforeDraw(canvas);
+            try {
+                // need to completely erase what was on the canvas before redrawing, otherwise
+                // some odd aliasing artifacts begin to build up around the edges of aa'd entities
+                // over time.
+                canvas.drawColor(Color.TRANSPARENT, PorterDuff.Mode.CLEAR);
+                if (backgroundPaint != null) {
+                    drawBackground(canvas, displayDims.marginatedRect);
+                }
+
+                layoutManager.draw(canvas);
+
+                if (getBorderPaint() != null) {
+                    drawBorder(canvas, displayDims.marginatedRect);
+                }
+            } catch (Exception e) {
+                Log.e(TAG, "Exception while rendering Plot.", e);
+            }
+
+            isIdle = true;
+            // any series interested in synchronizing with plot should
+            // implement PlotListener.onAfterDraw(...) and do a read unlock from within that
+            // invocation. This is the entry point for that invocation.
+            notifyListenersAfterDraw(canvas);
+        } finally {
+        }
+    }
+
+
+    /**
+     * Sets the visual style of the plot's border.
+     * @param style
+     * @param radiusX Sets the X radius for BorderStyle.ROUNDED.  Use null for all other styles.
+     * @param radiusY Sets the Y radius for BorderStyle.ROUNDED.  Use null for all other styles.
+     */
+    public void setBorderStyle(BorderStyle style, Float radiusX, Float radiusY) {
+        if (style == Plot.BorderStyle.ROUNDED) {
+            if (radiusX == null || radiusY == null){
+                throw new IllegalArgumentException("radiusX and radiusY cannot be null when using BorderStyle.ROUNDED");
+            }
+            this.borderRadiusX = radiusX;
+            this.borderRadiusY = radiusY;
+        }
+        this.borderStyle = style;
+    }
+
+    /**
+     * Draws the plot's outer border.
+     * @param canvas
+     */
+    protected void drawBorder(Canvas canvas, RectF dims) {
+        drawRect(canvas, dims, borderPaint);
+    }
+
+    protected void drawBackground(Canvas canvas, RectF dims) {
+        drawRect(canvas, dims, backgroundPaint);
+    }
+
+    protected void drawRect(Canvas canvas, RectF dims, Paint paint) {
+        switch (borderStyle) {
+            case ROUNDED:
+                canvas.drawRoundRect(dims, borderRadiusX, borderRadiusY, paint);
+                break;
+            case SQUARE:
+            default:
+                canvas.drawRect(dims, paint);
+                break;
+        }
+    }
+
+    public LayoutManager getLayoutManager() {
+        return layoutManager;
+    }
+
+    public void setLayoutManager(LayoutManager layoutManager) {
+        this.layoutManager = layoutManager;
+    }
+
+    public Paint getBackgroundPaint() {
+        return backgroundPaint;
+    }
+
+    public void setBackgroundPaint(Paint backgroundPaint) {
+        this.backgroundPaint = backgroundPaint;
+    }
+
+    /**
+     * Convenience method - wraps the individual setMarginXXX methods into a single method.
+     * @param left
+     * @param top
+     * @param right
+     * @param bottom
+     */
+    public void setPlotMargins(float left, float top, float right, float bottom) {
+        setPlotMarginLeft(left);
+        setPlotMarginTop(top);
+        setPlotMarginRight(right);
+        setPlotMarginBottom(bottom);
+    }
+
+    /**
+     * Convenience method - wraps the individual setPaddingXXX methods into a single method.
+     * @param left
+     * @param top
+     * @param right
+     * @param bottom
+     */
+    public void setPlotPadding(float left, float top, float right, float bottom) {
+        setPlotPaddingLeft(left);
+        setPlotPaddingTop(top);
+        setPlotPaddingRight(right);
+        setPlotPaddingBottom(bottom);
+    }
+
+    public float getPlotMarginTop() {
+        return boxModel.getMarginTop();
+    }
+
+    public void setPlotMarginTop(float plotMarginTop) {
+        boxModel.setMarginTop(plotMarginTop);
+    }
+
+    public float getPlotMarginBottom() {
+        return boxModel.getMarginBottom();
+    }
+
+    public void setPlotMarginBottom(float plotMarginBottom) {
+        boxModel.setMarginBottom(plotMarginBottom);
+    }
+
+    public float getPlotMarginLeft() {
+        return boxModel.getMarginLeft();
+    }
+
+    public void setPlotMarginLeft(float plotMarginLeft) {
+        boxModel.setMarginLeft(plotMarginLeft);
+    }
+
+    public float getPlotMarginRight() {
+        return boxModel.getMarginRight();
+    }
+
+    public void setPlotMarginRight(float plotMarginRight) {
+        boxModel.setMarginRight(plotMarginRight);
+    }
+
+    public float getPlotPaddingTop() {
+        return boxModel.getPaddingTop();
+    }
+
+    public void setPlotPaddingTop(float plotPaddingTop) {
+        boxModel.setPaddingTop(plotPaddingTop);
+    }
+
+    public float getPlotPaddingBottom() {
+        return boxModel.getPaddingBottom();
+    }
+
+    public void setPlotPaddingBottom(float plotPaddingBottom) {
+        boxModel.setPaddingBottom(plotPaddingBottom);
+    }
+
+    public float getPlotPaddingLeft() {
+        return boxModel.getPaddingLeft();
+    }
+
+    public void setPlotPaddingLeft(float plotPaddingLeft) {
+        boxModel.setPaddingLeft(plotPaddingLeft);
+    }
+
+    public float getPlotPaddingRight() {
+        return boxModel.getPaddingRight();
+    }
+
+    public void setPlotPaddingRight(float plotPaddingRight) {
+        boxModel.setPaddingRight(plotPaddingRight);
+    }
+
+    public Paint getBorderPaint() {
+        return 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.
+     * @param borderPaint
+     */
+    public void setBorderPaint(Paint borderPaint) {
+        if(borderPaint == null) {
+            this.borderPaint = null;
+        } else {
+            this.borderPaint = new Paint(borderPaint);
+            this.borderPaint.setStyle(Paint.Style.STROKE);
+        }
+    }
+}
diff --git a/androidplot-core/src/main/java/com/androidplot/exception/PlotRenderException.java b/androidplot-core/src/main/java/com/androidplot/exception/PlotRenderException.java
deleted file mode 100644
index 62a6e6d9..00000000
--- a/androidplot-core/src/main/java/com/androidplot/exception/PlotRenderException.java
+++ /dev/null
@@ -1,23 +0,0 @@
-/*
- * Copyright 2015 AndroidPlot.com
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-package com.androidplot.exception;
-
-public class PlotRenderException extends Exception {
-    public PlotRenderException(String message) {
-        super(message);
-    }
-}
diff --git a/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java b/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
index caaddc06..db8921dc 100644
--- a/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/pie/PieRenderer.java
@@ -18,7 +18,6 @@
 
 import android.graphics.*;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.SeriesBundle;
 import com.androidplot.ui.SeriesRenderer;
 import com.androidplot.ui.RenderStack;
@@ -58,7 +57,7 @@ public float getRadius(RectF rect) {
 
     @Override
     public void onRender(Canvas canvas, RectF plotArea, Segment series, SegmentFormatter formatter,
-            RenderStack stack) throws PlotRenderException {
+            RenderStack stack) {
 
         // This renderer renders all series in one shot, so exclude any remaining series
         // from causing subsequent invocations of onRender:
diff --git a/androidplot-core/src/main/java/com/androidplot/pie/PieWidget.java b/androidplot-core/src/main/java/com/androidplot/pie/PieWidget.java
index 38c23b27..1b7b2a80 100644
--- a/androidplot-core/src/main/java/com/androidplot/pie/PieWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/pie/PieWidget.java
@@ -17,7 +17,6 @@
 package com.androidplot.pie;
 
 import android.graphics.*;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.Size;
 import com.androidplot.ui.widget.Widget;
@@ -38,7 +37,7 @@ public PieWidget(LayoutManager layoutManager, PieChart pieChart, Size metrics) {
     }
 
     @Override
-    protected void doOnDraw(Canvas canvas, RectF widgetRect) throws PlotRenderException {
+    protected void doOnDraw(Canvas canvas, RectF widgetRect) {
         renderStack.sync();
         for(RenderStack.StackElement thisElement : renderStack.getElements()) {
             if(thisElement.isEnabled()) {
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
index 0fb1a04c..45f79a43 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/LayoutManager.java
@@ -25,7 +25,6 @@
 import android.view.MotionEvent;
 import android.view.View;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.widget.Widget;
 import com.androidplot.util.DisplayDimensions;
 import com.androidplot.util.LinkedLayerList;
@@ -83,7 +82,7 @@ public void setMarkupEnabled(boolean enabled) {
         setDrawOutlineShadowsEnabled(enabled);
     }
 
-    public void draw(Canvas canvas) throws PlotRenderException {
+    public void draw(Canvas canvas) {
         if(isDrawMarginsEnabled()) {
             drawSpacing(canvas, displayDims.canvasRect, displayDims.marginatedRect, marginPaint);
         }
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java b/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
index afc1b142..bfedeeb8 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/SeriesRenderer.java
@@ -20,7 +20,6 @@
 import android.graphics.RectF;
 import android.graphics.Region;
 import com.androidplot.Series;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.Plot;
 
 import java.util.ArrayList;
@@ -52,10 +51,9 @@ public SeriesFormatterType getFormatter(SeriesType series) {
      * @param canvas
      * @param plotArea
      * @param sfPair The series / formatter pair to be rendered
-     * @throws PlotRenderException
      */
     public void render(Canvas canvas, RectF plotArea, SeriesBundle<SeriesType,
-                SeriesFormatterType> sfPair, RenderStack stack) throws PlotRenderException {
+                SeriesFormatterType> sfPair, RenderStack stack) {
         onRender(canvas, plotArea, sfPair.getSeries(), sfPair.getFormatter(), stack);
     }
 
@@ -67,10 +65,9 @@ public void render(Canvas canvas, RectF plotArea, SeriesBundle<SeriesType,
      * @param formatter The getFormatter that should be used to render the series
      * @param stack Ordered list of all series being renderered.  May be manipulated by the Renderer
      *              to gain effect.
-     * @throws PlotRenderException
      */
     protected abstract void onRender(Canvas canvas, RectF plotArea, SeriesType series,
-                                  SeriesFormatterType formatter, RenderStack stack) throws PlotRenderException;
+                                  SeriesFormatterType formatter, RenderStack stack);
 
     /**
      * Draw the legend icon in the rect passed in.
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
index 69e41407..e9222888 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
@@ -5,9 +5,6 @@
 import android.graphics.Paint;
 import android.graphics.RectF;
 import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
-
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.Size;
 import com.androidplot.ui.TableModel;
@@ -62,7 +59,7 @@ public LegendWidget(@NonNull TableModel tableModel, @NonNull LayoutManager layou
     }
 
     @Override
-    protected void doOnDraw(Canvas canvas, RectF widgetRect) throws PlotRenderException {
+    protected void doOnDraw(Canvas canvas, RectF widgetRect) {
         final List<ItemT> items = getLegendItems();
         if(legendItemComparator != null) {
             Collections.sort(items, legendItemComparator);
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
index d66b85a8..87a43a02 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
@@ -20,7 +20,6 @@
 import android.support.annotation.NonNull;
 import android.support.annotation.Nullable;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.*;
 import com.androidplot.util.DisplayDimensions;
 import com.androidplot.ui.HorizontalPositioning;
@@ -372,7 +371,7 @@ protected void onResize(@Nullable RectF oldRect, @NonNull RectF newRect) {
         // do nothing by default
     }
 
-    public void draw(Canvas canvas) throws PlotRenderException {
+    public void draw(Canvas canvas) {
         if (isVisible()) {
             if (backgroundPaint != null) {
                 drawBackground(canvas, widgetDimensions.canvasRect);
@@ -439,7 +438,7 @@ protected void drawBackground(Canvas canvas, RectF widgetRect) {
      * @param canvas     The Canvas to draw onto
      * @param widgetRect the size and coordinates of this widget
      */
-    protected abstract void doOnDraw(Canvas canvas, RectF widgetRect) throws PlotRenderException;
+    protected abstract void doOnDraw(Canvas canvas, RectF widgetRect);
 
     public Paint getBorderPaint() {
         return borderPaint;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/AdvancedLineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/AdvancedLineAndPointRenderer.java
index ee3e7e24..11b9e8e8 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/AdvancedLineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/AdvancedLineAndPointRenderer.java
@@ -18,7 +18,6 @@
 
 import android.content.*;
 import android.graphics.*;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.RenderStack;
 import com.androidplot.ui.SeriesRenderer;
 
@@ -41,7 +40,7 @@ public AdvancedLineAndPointRenderer(XYPlot plot) {
     }
 
     @Override
-    protected void onRender(Canvas canvas, RectF plotArea, XYSeries series, Formatter formatter, RenderStack stack) throws PlotRenderException {
+    protected void onRender(Canvas canvas, RectF plotArea, XYSeries series, Formatter formatter, RenderStack stack) {
         PointF thisPoint;
         PointF lastPoint = null;
         for (int i = 0; i < series.size(); i++) {
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
index bb8c4c7f..ced83885 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/BarRenderer.java
@@ -51,7 +51,13 @@ public class BarRenderer<FormatterType extends BarFormatter> extends GroupRender
     public enum BarOrientation {
 
         /**
-         * Bars are drawn "overlapping" one another, with taller bars being drawn behind
+         * Bars are drawn overlapping one another, in the order their respective series
+         * was added to the plot.
+         */
+        IN_ORDER,
+
+        /**
+         * Bars are drawn overlapping one another, with taller bars being drawn behind
          * the shorter ones.
          */
         OVERLAID,           // bars are overlaid in descending y-val order (largest val in back)
@@ -187,6 +193,7 @@ public void onRender(Canvas canvas, RectF plotArea, List<SeriesBundle<XYSeries,
 
             final BarComparator comparator = getBarComparator(rangeOriginPx);
             switch (barOrientation) {
+                case IN_ORDER:
                 case OVERLAID:
                     Collections.sort(barGroup.bars, comparator);
                     for (Bar bar : barGroup.bars) {
@@ -366,6 +373,7 @@ public int compare(Bar bar1, Bar bar2) {
                     } else {
                         return Float.valueOf(bar1.yPix).compareTo(bar2.yPix);
                     }
+                case IN_ORDER:
                 case SIDE_BY_SIDE:
                 case STACKED:
                 default:
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/BubbleRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/BubbleRenderer.java
index 1e0ba9c5..dcebf6cb 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/BubbleRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/BubbleRenderer.java
@@ -3,7 +3,6 @@
 import android.graphics.*;
 
 import com.androidplot.Region;
-import com.androidplot.exception.*;
 import com.androidplot.ui.*;
 import com.androidplot.util.*;
 
@@ -45,7 +44,7 @@ public BubbleRenderer(XYPlot plot) {
 
     @Override
     protected void onRender(Canvas canvas, RectF plotArea, BubbleSeries series,
-            FormatterType formatter, RenderStack stack) throws PlotRenderException {
+            FormatterType formatter, RenderStack stack) {
 
         Region magnitudeBounds = calculateBounds();
         for(int i = 0; i < series.size(); i++) {
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
index d1e3fc8e..5f469ce2 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
@@ -22,7 +22,6 @@
 import android.graphics.RectF;
 import android.support.annotation.NonNull;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.RenderStack;
 import com.androidplot.ui.SeriesRenderer;
 
@@ -51,7 +50,7 @@ public FastLineAndPointRenderer(XYPlot plot) {
     }
 
     @Override
-    protected void onRender(Canvas canvas, RectF plotArea, XYSeries series, Formatter formatter, RenderStack stack) throws PlotRenderException {
+    protected void onRender(Canvas canvas, RectF plotArea, XYSeries series, Formatter formatter, RenderStack stack) {
 
         segmentOffsets.clear();
         segmentLengths.clear();
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/GroupRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/GroupRenderer.java
index d2fe4c73..503d624d 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/GroupRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/GroupRenderer.java
@@ -19,7 +19,6 @@
 import android.graphics.Canvas;
 import android.graphics.RectF;
 import android.util.Log;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.RenderStack;
 import com.androidplot.ui.SeriesBundle;
 
@@ -42,7 +41,7 @@ public GroupRenderer(XYPlot plot) {
 
     @Override
     protected void onRender(Canvas canvas, RectF plotArea, XYSeries series,
-                         FormatterType formatter, RenderStack stack) throws PlotRenderException {
+                         FormatterType formatter, RenderStack stack) {
 
 
         // get all the data  associated with this renderer:
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
index 53e80dca..f50d6186 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/LineAndPointRenderer.java
@@ -25,7 +25,6 @@
 import com.androidplot.Plot;
 import com.androidplot.PlotListener;
 import com.androidplot.Region;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.RenderStack;
 import com.androidplot.util.*;
 
@@ -63,7 +62,7 @@ public void onAfterDraw(Plot source, Canvas canvas) {
     }
 
     @Override
-    public void onRender(Canvas canvas, RectF plotArea, XYSeries series, FormatterType formatter, RenderStack stack) throws PlotRenderException {
+    public void onRender(Canvas canvas, RectF plotArea, XYSeries series, FormatterType formatter, RenderStack stack) {
         drawSeries(canvas, plotArea, series, formatter);
     }
 
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/ValueMarker.java b/androidplot-core/src/main/java/com/androidplot/xy/ValueMarker.java
index 30e9aacd..de0436b2 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/ValueMarker.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/ValueMarker.java
@@ -16,10 +16,14 @@
 
 package com.androidplot.xy;
 
+import android.graphics.Canvas;
 import android.graphics.Color;
 import android.graphics.Paint;
+import android.graphics.RectF;
+
 import com.androidplot.ui.PositionMetric;
 import com.androidplot.ui.TextOrientation;
+import com.androidplot.util.FontUtils;
 
 /**
  * Encapsulates a single axis line marker drawn onto an XYPlot at a specified value.
@@ -27,6 +31,8 @@
  */
 public abstract class ValueMarker<PositionMetricType extends PositionMetric> {
 
+    private static final int MARKER_LABEL_SPACING = 2;
+
     public String getText() {
         return text;
     }
@@ -135,4 +141,37 @@ public PositionMetricType getTextPosition() {
     public void setTextPosition(PositionMetricType textPosition) {
         this.textPosition = textPosition;
     }
+
+    /**
+     * Renders the text associated with user defined markers
+     *
+     * @param canvas
+     * @param text
+     * @param gridRect
+     * @param x
+     * @param y
+     */
+    protected void drawMarkerText(Canvas canvas, String text, RectF gridRect,
+                                  float x, float y) {
+        if (getText() != null) {
+            x += MARKER_LABEL_SPACING;
+            y -= MARKER_LABEL_SPACING;
+            RectF textRect = new RectF(FontUtils.getStringDimensions(text, getTextPaint()
+            ));
+            textRect.offsetTo(x, y - textRect.height());
+
+            if (textRect.right > gridRect.right) {
+                textRect.offset(-(textRect.right - gridRect.right), 0);
+            }
+
+            if (textRect.top < gridRect.top) {
+                textRect.offset(0, gridRect.top - textRect.top);
+            }
+
+            canvas.drawText(text, textRect.left, textRect.bottom, getTextPaint()
+            );
+        }
+    }
+
+    public abstract void draw(Canvas canvas, XYPlot plot, RectF gridRect);
 }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XValueMarker.java b/androidplot-core/src/main/java/com/androidplot/xy/XValueMarker.java
index af02ca64..a4c12438 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XValueMarker.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XValueMarker.java
@@ -16,7 +16,10 @@
 
 package com.androidplot.xy;
 
+import android.graphics.Canvas;
 import android.graphics.Paint;
+import android.graphics.RectF;
+
 import com.androidplot.ui.VerticalPositioning;
 import com.androidplot.ui.VerticalPosition;
 
@@ -55,4 +58,19 @@ public XValueMarker(Number value, String text, VerticalPosition textPosition, Pa
     public XValueMarker(Number value, String text, VerticalPosition textPosition, int linePaint, int textPaint) {
         super(value, text, textPosition, linePaint, textPaint);
     }
+
+    @Override
+    public void draw(Canvas canvas, XYPlot plot, RectF gridRect) {
+        if (getValue() != null) {
+            float xPix = (float) plot.getBounds().xRegion
+                    .transform(getValue().doubleValue(), gridRect.left, gridRect.right, false);
+            canvas.drawLine(xPix, gridRect.top, xPix, gridRect.bottom, getLinePaint()
+            );
+            float yPix = getTextPosition().getPixelValue(gridRect.height());
+            yPix += gridRect.top;
+            if (getText() != null) {
+                drawMarkerText(canvas, getText(), gridRect, xPix, yPix);
+            }
+        }
+    }
 }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index 22c551e9..af1f2729 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -27,7 +27,6 @@
 
 import com.androidplot.R;
 import com.androidplot.Region;
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.ui.Insets;
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.RenderStack;
@@ -63,8 +62,6 @@ public class XYGraphWidget extends Widget {
 
     private static final float DEFAULT_LINE_LABEL_TEXT_SIZE_PX = PixelUtils.spToPix(15);
 
-    private static final int MARKER_LABEL_SPACING = TWO;
-
     /**
      * Line interval per range label
      */
@@ -542,8 +539,7 @@ protected void recalculateSizes(@Nullable RectF rect) {
     }
 
     @Override
-    protected void doOnDraw(Canvas canvas, RectF widgetRect)
-            throws PlotRenderException {
+    protected void doOnDraw(Canvas canvas, RectF widgetRect) {
 
         // don't draw if we have no space to draw into
         if (gridRect.height() > ZERO && gridRect.width() > ZERO) {
@@ -692,74 +688,16 @@ protected void drawGrid(Canvas canvas) {
         }
     }
 
-    /**
-     * Renders the text associated with user defined markers
-     *
-     * @param canvas
-     * @param text
-     * @param marker
-     * @param x
-     * @param y
-     */
-    protected void drawMarkerText(Canvas canvas, String text, ValueMarker marker,
-                                float x, float y) {
-        if (marker.getText() != null) {
-            x += MARKER_LABEL_SPACING;
-            y -= MARKER_LABEL_SPACING;
-            RectF textRect = new RectF(FontUtils.getStringDimensions(
-                    text,
-                    marker.getTextPaint()
-            ));
-            textRect.offsetTo(x, y - textRect.height());
-
-            if (textRect.right > gridRect.right) {
-                textRect.offset(-(textRect.right - gridRect.right), ZERO);
-            }
-
-            if (textRect.top < gridRect.top) {
-                textRect.offset(0, gridRect.top - textRect.top);
-            }
-
-            canvas.drawText(text, textRect.left, textRect.bottom,
-                    marker.getTextPaint()
-            );
-        }
-    }
-
     protected void drawMarkers(Canvas canvas) {
         if (plot.getYValueMarkers() != null && plot.getYValueMarkers().size() > 0) {
             for (YValueMarker marker : plot.getYValueMarkers()) {
-                if (marker.getValue() != null) {
-                    float yPix = (float) plot.getBounds().yRegion
-                            .transform(marker.getValue()
-                                    .doubleValue(), gridRect.top, gridRect.bottom, true);
-                    canvas.drawLine(gridRect.left, yPix,
-                            gridRect.right, yPix, marker.getLinePaint()
-                    );
-
-                    float xPix = marker.getTextPosition().getPixelValue(
-                            gridRect.width());
-                    xPix += gridRect.left;
-                    drawMarkerText(canvas, marker.getText(), marker, xPix, yPix);
-                }
+                marker.draw(canvas, plot, gridRect);
             }
         }
 
         if (plot.getXValueMarkers() != null && plot.getXValueMarkers().size() > 0) {
             for (XValueMarker marker : plot.getXValueMarkers()) {
-                if (marker.getValue() != null) {
-                    float xPix = (float) plot.getBounds().xRegion
-                            .transform(marker.getValue()
-                                    .doubleValue(), gridRect.left, gridRect.right, false);
-                    canvas.drawLine(xPix, gridRect.top, xPix, gridRect.bottom,
-                            marker.getLinePaint()
-                    );
-                    float yPix = marker.getTextPosition().getPixelValue(gridRect.height());
-                    yPix += gridRect.top;
-                    if (marker.getText() != null) {
-                        drawMarkerText(canvas, marker.getText(), marker, xPix, yPix);
-                    }
-                }
+                marker.draw(canvas, plot, gridRect);
             }
         }
     }
@@ -839,9 +777,8 @@ protected void drawGridBackground(Canvas canvas) {
      * Draws lines and points for each element in the series.
      *
      * @param canvas
-     * @throws PlotRenderException
      */
-    protected void drawData(Canvas canvas) throws PlotRenderException {
+    protected void drawData(Canvas canvas) {
         if (drawGridOnTop) {
             drawGridBackground(canvas);
         }
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/YValueMarker.java b/androidplot-core/src/main/java/com/androidplot/xy/YValueMarker.java
index f76dadd5..0e4aa435 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/YValueMarker.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/YValueMarker.java
@@ -16,7 +16,10 @@
 
 package com.androidplot.xy;
 
+import android.graphics.Canvas;
 import android.graphics.Paint;
+import android.graphics.RectF;
+
 import com.androidplot.ui.HorizontalPositioning;
 import com.androidplot.ui.HorizontalPosition;
 
@@ -55,4 +58,21 @@ public YValueMarker(Number value, String text, HorizontalPosition textPosition,
     public YValueMarker(Number value, String text, HorizontalPosition textPosition, int linePaint, int textPaint) {
         super(value, text, textPosition, linePaint, textPaint);
     }
+
+    @Override
+    public void draw(Canvas canvas, XYPlot plot, RectF gridRect) {
+        if (getValue() != null) {
+            float yPix = (float) plot.getBounds().yRegion
+                    .transform(getValue()
+                            .doubleValue(), gridRect.top, gridRect.bottom, true);
+            canvas.drawLine(gridRect.left, yPix,
+                    gridRect.right, yPix, getLinePaint()
+            );
+
+            float xPix = getTextPosition().getPixelValue(
+                    gridRect.width());
+            xPix += gridRect.left;
+            drawMarkerText(canvas, getText(), gridRect, xPix, yPix);
+        }
+    }
 }
diff --git a/androidplot-core/src/test/java/com/androidplot/PlotTest.java b/androidplot-core/src/test/java/com/androidplot/PlotTest.java
index dc5e5e88..5a750afd 100644
--- a/androidplot-core/src/test/java/com/androidplot/PlotTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/PlotTest.java
@@ -20,11 +20,8 @@
 import android.graphics.*;
 import android.util.*;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.test.*;
 import com.androidplot.ui.*;
-import com.androidplot.xy.LineAndPointFormatter;
-import com.androidplot.xy.SimpleXYSeries;
 import com.halfhp.fig.*;
 import org.junit.Test;
 import org.mockito.Mock;
@@ -36,7 +33,6 @@
 import static junit.framework.Assert.assertNotSame;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
-import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
@@ -47,7 +43,7 @@ public class PlotTest extends AndroidplotTest {
     SeriesRegistry<MockSeriesBundle, MockSeries, Formatter> mockSeriesRegistry;
 
     @Test
-    public void testInit_withoutAttrs() throws Exception {
+    public void testInit_withoutAttrs() {
         Plot plot = mock(Plot.class);
         plot.init(RuntimeEnvironment.application, null, 0);
 
@@ -56,7 +52,7 @@ public void testInit_withoutAttrs() throws Exception {
     }
 
     @Test
-    public void testInit_withAttrs() throws Exception {
+    public void testInit_withAttrs() {
         Plot plot = new MockPlot("MockPlot");
         AttributeSet attrs = mock(AttributeSet.class);
         plot.init(RuntimeEnvironment.application, attrs, 0);
@@ -64,7 +60,7 @@ public void testInit_withAttrs() throws Exception {
     }
 
     @Test
-    public void testAddSeries() throws Exception {
+    public void testAddSeries() {
         Plot plot = new MockPlot("MockPlot");
 
         MockSeries m1 = new MockSeries();
@@ -97,7 +93,7 @@ public void testAddSeries() throws Exception {
     }
 
     @Test
-    public void testRemoveSeries() throws Exception {
+    public void testRemoveSeries() {
 
         Plot plot = new MockPlot("MockPlot");
 
@@ -157,7 +153,7 @@ public void testRemoveSeries() throws Exception {
 
 
     @Test
-    public void testGetFormatter() throws Exception {
+    public void testGetFormatter() {
         Plot plot = new MockPlot("MockPlot");
 
         MockSeries m1 = new MockSeries();
@@ -185,7 +181,7 @@ public void testGetFormatter() throws Exception {
     }
 
     @Test
-    public void testGetRendererList() throws Exception {
+    public void testGetRendererList() {
 
         Plot plot = new MockPlot("MockPlot");
 
@@ -206,7 +202,7 @@ public void testGetRendererList() throws Exception {
     }
 
     @Test
-    public void testAddListener() throws Exception {
+    public void testAddListener() {
         Plot plot = new MockPlot("MockPlot");
         ArrayList<PlotListener> listeners = plot.getListeners();
 
@@ -232,7 +228,7 @@ public void testAddListener() throws Exception {
     }
 
     @Test
-    public void testRemoveListener() throws Exception {
+    public void testRemoveListener() {
         Plot plot = new MockPlot("MockPlot");
         ArrayList<PlotListener> listeners = plot.getListeners();
 
@@ -379,7 +375,7 @@ public MockRenderer1(Plot plot) {
         }
 
         @Override
-        public void onRender(Canvas canvas, RectF plotArea, Series series, Formatter formatter, RenderStack stack) throws PlotRenderException {
+        public void onRender(Canvas canvas, RectF plotArea, Series series, Formatter formatter, RenderStack stack) {
 
         }
 
@@ -396,7 +392,7 @@ public MockRenderer2(Plot plot) {
         }
 
         @Override
-        public void onRender(Canvas canvas, RectF plotArea, Series series, Formatter formatter, RenderStack stack) throws PlotRenderException {
+        public void onRender(Canvas canvas, RectF plotArea, Series series, Formatter formatter, RenderStack stack) {
 
         }
 
diff --git a/androidplot-core/src/test/java/com/androidplot/test/TestUtils.java b/androidplot-core/src/test/java/com/androidplot/test/TestUtils.java
index ecb78333..1f8f1457 100644
--- a/androidplot-core/src/test/java/com/androidplot/test/TestUtils.java
+++ b/androidplot-core/src/test/java/com/androidplot/test/TestUtils.java
@@ -56,11 +56,11 @@ public static XYSeries generateXYSeriesWithNulls(String title, int size) {
      */
     @SuppressLint("NewApi")
     public static MotionEvent newPointerDownEvent(int finger1x, int finger1y, int finger2x, int finger2y) {
-        MotionEvent me = MotionEvent.obtain(0, 0, 0, 0, 0, 0);
+        MotionEvent me = MotionEvent.obtain(0, 0, MotionEvent.ACTION_POINTER_DOWN, finger1x, finger1y, 0);
         ShadowMotionEvent sme = shadowOf(me);
-        sme.setAction(MotionEvent.ACTION_POINTER_DOWN);
+        //sme.setAction(MotionEvent.ACTION_POINTER_DOWN);
         sme.setPointerIds(0, 1);
-        sme.setLocation(finger1x, finger1y);
+        //sme.setLocation(finger1x, finger1y);
         sme.setPointer2(finger2x, finger2y);
         return me;
     }
diff --git a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
index db81d57c..408edc33 100644
--- a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
@@ -4,7 +4,6 @@
 import android.graphics.RectF;
 import android.support.annotation.NonNull;
 
-import com.androidplot.exception.PlotRenderException;
 import com.androidplot.test.AndroidplotTest;
 import com.androidplot.ui.Anchor;
 import com.androidplot.ui.HorizontalPositioning;
@@ -22,6 +21,8 @@
 import org.mockito.Mockito;
 
 import static junit.framework.Assert.assertEquals;
+import static org.mockito.ArgumentMatchers.isNull;
+import static org.mockito.ArgumentMatchers.nullable;
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.spy;
@@ -88,14 +89,14 @@ public void position_withAnchor_updatesPositionWithNewAnchor() {
     }
 
     @Test
-    public void draw_sizeChanged_invokesOnResizeBeforeDoOnDraw() throws Exception {
+    public void draw_sizeChanged_invokesOnResizeBeforeDoOnDraw() {
         InOrder inOrder = Mockito.inOrder(widget);
 
         widget.draw(canvas);
 
-        inOrder.verify(widget).onResize(any(RectF.class), any(RectF.class));
+        inOrder.verify(widget).onResize(isNull(RectF.class), any(RectF.class));
         inOrder.verify(widget).doOnDraw(eq(canvas), any(RectF.class));
-        verify(widget).onResize(any(RectF.class), any(RectF.class));
+        verify(widget).onResize(isNull(RectF.class), any(RectF.class));
     }
 
     static class TestWidget extends Widget {
@@ -105,7 +106,7 @@ public TestWidget(@NonNull LayoutManager layoutManager, @NonNull Size size) {
         }
 
         @Override
-        protected void doOnDraw(Canvas canvas, RectF widgetRect) throws PlotRenderException {
+        protected void doOnDraw(Canvas canvas, RectF widgetRect) {
             // nothing to do
         }
     }
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
index 2bb317b5..e4624d08 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
@@ -61,14 +61,14 @@ public class BarRendererTest extends AndroidplotTest {
     ArgumentCaptor<RectF> rectCaptor;
 
     @Before
-    public void setUp() throws Exception {
+    public void setUp() {
         canvas = spy(new Canvas());
         xyPlot = spy(new XYPlot(getContext(), "My Plot"));
         barFormatter = spy(new BarFormatter(Color.RED, Color.RED));
     }
 
     @Test
-    public void testOnRender_handlesNullValues() throws Exception {
+    public void onRender_handlesNullValues() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", null, 5, null);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", null, 5, null);
 
@@ -83,7 +83,7 @@ public void testOnRender_handlesNullValues() throws Exception {
     }
 
     @Test
-    public void testOnRender_stacked() throws Exception {
+    public void onRender_stacked() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 2, 5, 7);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 8, 5, 3);
 
@@ -119,7 +119,7 @@ public void testOnRender_stacked() throws Exception {
     }
 
     @Test
-    public void testOnRender_sideBySide() throws Exception {
+    public void onRender_sideBySide() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 0, 5, 10);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 1, 7.5, 10);
 
@@ -150,7 +150,35 @@ public void testOnRender_sideBySide() throws Exception {
     }
 
     @Test
-    public void testOnRender_overlaid() throws Exception {
+    public void onRender_inOrder_drawsFirstAddedSeriesFirst() {
+        XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 1, 5, 6);
+        XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 2, 4, 7);
+
+        BarRenderer renderer = setupRendererForTesting(s1, s2);
+        renderer.setBarOrientation(BarRenderer.BarOrientation.IN_ORDER);
+
+        xyPlot.setUserRangeOrigin(0);
+        xyPlot.calculateMinMaxVals();
+        renderer.onRender(canvas, plotArea, s1, barFormatter, renderStack);
+
+        verify(renderer, times(6))
+                .drawBar(eq(canvas), barCaptor.capture(), rectCaptor.capture());
+
+        // list of all bars drawn, in the exact order they were drawn.
+        List<BarRenderer.Bar> bars = barCaptor.getAllValues();
+
+        assertEquals(bars.get(0).getY(), s1.getY(0));
+        assertEquals(bars.get(1).getY(), s2.getY(0));
+
+        assertEquals(bars.get(2).getY(), s1.getY(1));
+        assertEquals(bars.get(3).getY(), s2.getY(1));
+
+        assertEquals(bars.get(4).getY(), s1.getY(2));
+        assertEquals(bars.get(5).getY(), s2.getY(2));
+    }
+
+    @Test
+    public void onRender_overlaid_drawsBarsWithExpectedHeight() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 0, 5, 10);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 1, 7.5, 10);
 
@@ -183,10 +211,9 @@ public void testOnRender_overlaid() throws Exception {
     /**
      * Verify that positive values are drawn in order of highest yVal, while negative values are
      * drawn in order of lowest yVal.
-     * @throws Exception
      */
     @Test
-    public void testOnRender_overlaid_drawsBarsInOrder() throws Exception {
+    public void onRender_overlaid_drawsSmallestBarsLast() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", -1, -2, 1, 2);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", -2, -1, 2, 1);
 
@@ -211,7 +238,7 @@ public void testOnRender_overlaid_drawsBarsInOrder() throws Exception {
     }
 
     @Test
-    public void testFixedBarWidth() throws Exception {
+    public void onRender_fixedBarWidth_rendersAllBarsWithSameWidth() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 0, 5, 10);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 1, 7.5, 10);
 
@@ -233,7 +260,7 @@ public void testFixedBarWidth() throws Exception {
     }
 
     @Test
-    public void testFixedGapWidth() throws Exception {
+    public void onRender_fixedGapWidth_rendersFixedGapBetweenAllBars() {
         XYSeries s1 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s1", 0, 5, 10);
         XYSeries s2 = new SimpleXYSeries(SimpleXYSeries.ArrayFormat.Y_VALS_ONLY, "s2", 1, 7.5, 10);
 
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 65d3898a..03897972 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -30,6 +30,7 @@
 import static junit.framework.Assert.assertFalse;
 import static junit.framework.Assert.assertTrue;
 import static junit.framework.Assert.fail;
+import static org.mockito.ArgumentMatchers.anyDouble;
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.anyBoolean;
 import static org.mockito.Matchers.anyFloat;
@@ -323,9 +324,9 @@ private void runDrawGridTest() {
 
         // expecting a 100x100 grid to be drawn:
         verify(graphWidget, times(100))
-                .drawDomainLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
+                .drawDomainLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false));
 
         verify(graphWidget, times(100))
-                .drawRangeLine(eq(canvas), anyFloat(), anyFloat(), any(Paint.class), eq(false));
+                .drawRangeLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false));
     }
 }
diff --git a/build.gradle b/build.gradle
index 1e1d8c9f..41312fc7 100644
--- a/build.gradle
+++ b/build.gradle
@@ -27,7 +27,7 @@ ext {
     theTargetSdkVersion = 28
     theMinSdkVersion = 5
     theVersionName = '1.5.7'
-    theVersionCode = 0
+    theVersionCode = 1
 }
 
 buildscript {
@@ -38,11 +38,10 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.1.1'
+        classpath 'com.android.tools.build:gradle:3.4.2'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
         classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.0'
-        classpath 'com.vanniktech:gradle-android-junit-jacoco-plugin:0.6.0'
-        classpath 'org.kt3k.gradle.plugin:coveralls-gradle-plugin:2.6.3'
+        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.4'
     }
 }
 
@@ -52,7 +51,3 @@ allprojects {
         google()
     }
 }
-
-task wrapper(type: Wrapper) {
-    gradleVersion = '2.14.1'
-}
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index 36a7c800..e0e1d1c2 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -18,12 +18,12 @@ apply plugin: 'com.android.application'
 apply plugin: 'com.github.triplet.play'
 
 dependencies {
-	compile project(':androidplot-core')
-    compile 'com.crittercism:crittercism-android-agent:5.4.0'
+	implementation project(':androidplot-core')
+    implementation 'com.crittercism:crittercism-android-agent:5.4.0'
 
-    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.4'
-    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
-    testCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
+    debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
+    releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
+    testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
 }
 
 buildscript {
diff --git a/docs/quickstart.md b/docs/quickstart.md
index ffc3827d..08abc2dd 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.6"
+    compile "com.androidplot:androidplot-core:1.5.7"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 6bebeb8c..b67acaff 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,8 +2,15 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
-# 1.5.6
 
+# 1.5.7
+* (#94) Potential fix / better error logging for a crash caused by a buffered canvas resize with illegal arguments.
+* (#93) Fix Android 9 compiler warnings.
+* (#83) Fix NPE when attempting to recycle an already null buffered canvas instance.
+* Remove unused `PlotRenderException`.
+* Added `IN_ORDER` BarRenderer mode.
+
+# 1.5.6
 * Adds convenience methods for saving / restoring `PanZoom` state.
 * (#80) Targets SDK 28, fixing compatibility issues.
 
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 42a64d0b..4c7210e5 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
-#Tue Dec 05 07:26:55 CST 2017
+#Fri Jul 19 09:24:31 CDT 2019
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-5.1.1-all.zip

From 8ad3fca2e396ad77f13a3d5c134a449f966b38d7 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sat, 20 Jul 2019 12:11:12 -0500
Subject: [PATCH 20/48] fix play deploy

---
 demoapp/build.gradle                     | 31 ++++++++++++++----------
 gradle/wrapper/gradle-wrapper.properties |  2 +-
 2 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index e0e1d1c2..191280a5 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -14,17 +14,8 @@
  *    limitations under the License.
  */
 
-apply plugin: 'com.android.application'
-apply plugin: 'com.github.triplet.play'
-
-dependencies {
-	implementation project(':androidplot-core')
-    implementation 'com.crittercism:crittercism-android-agent:5.4.0'
-
-    debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
-    releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
-    testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
-}
+//apply plugin: 'com.android.application'
+//apply plugin: 'com.github.triplet.play'
 
 buildscript {
 
@@ -32,10 +23,24 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.github.triplet.gradle:play-publisher:1.2.0'
+        classpath 'com.github.triplet.gradle:play-publisher:2.2.1'
     }
 }
 
+plugins {
+    id 'com.android.application'
+    id 'com.github.triplet.play' version '2.2.1'
+}
+
+dependencies {
+	implementation project(':androidplot-core')
+    implementation 'com.crittercism:crittercism-android-agent:5.4.0'
+
+    debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
+    releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
+    testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
+}
+
 android {
     compileSdkVersion theCompileSdkVersion
 
@@ -78,6 +83,6 @@ android {
 
 play {
     // see: https://github.com/Triple-T/gradle-play-publisher
-    jsonFile = file(System.getenv("PUBLISHER_ACCT_JSON_FILE") ?: "publisher.json")
+    serviceAccountCredentials = file(System.getenv("PUBLISHER_ACCT_JSON_FILE") ?: "publisher.json")
     track = 'beta'
 }
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 4c7210e5..b37f1ae6 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.1.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-5.5.1-all.zip

From 3c1da1a5dab6c9f198624b7e894c5a8eec66311a Mon Sep 17 00:00:00 2001
From: JackJackE <37071007+mtjin@users.noreply.github.com>
Date: Thu, 26 Dec 2019 00:33:31 +0900
Subject: [PATCH 21/48] upgrade gradle version and refactoring code in a line
 that doesn't affect the program (#99)

---
 androidplot-core/build.gradle                    |  4 ++--
 build.gradle                                     |  4 ++--
 .../demos/BarPlotExampleActivity.java            |  2 ++
 .../androidplot/demos/DynamicXYPlotActivity.java | 16 ++++++++--------
 .../java/com/androidplot/demos/ECGExample.java   |  6 +++---
 .../com/androidplot/demos/ListViewActivity.java  |  8 ++++----
 .../demos/SimplePieChartActivity.java            |  2 ++
 .../androidplot/demos/TimeSeriesActivity.java    |  2 ++
 8 files changed, 25 insertions(+), 19 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 0592389b..e513a542 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -92,9 +92,9 @@ dependencies {
 
     implementation 'com.halfhp.fig:figlib:1.0.7'
     implementation 'com.android.support:support-annotations:28.0.0'
-    testImplementation "org.mockito:mockito-core:2.13.0"
+    testImplementation "org.mockito:mockito-core:3.0.0"
     testImplementation group: 'junit', name: 'junit', version: '4.12'
-    testImplementation "org.robolectric:robolectric:4.0.1"
+    testImplementation "org.robolectric:robolectric:4.2.1"
 
     // temp fix for:
     // https://github.com/robolectric/robolectric/issues/1932
diff --git a/build.gradle b/build.gradle
index 41312fc7..a00c8e72 100644
--- a/build.gradle
+++ b/build.gradle
@@ -38,9 +38,9 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.4.2'
+        classpath 'com.android.tools.build:gradle:3.5.3'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
-        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.0'
+        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.4'
         classpath 'com.dicedmelon.gradle:jacoco-android:0.1.4'
     }
 }
diff --git a/demoapp/src/main/java/com/androidplot/demos/BarPlotExampleActivity.java b/demoapp/src/main/java/com/androidplot/demos/BarPlotExampleActivity.java
index 8d8720d1..3cc2faa4 100644
--- a/demoapp/src/main/java/com/androidplot/demos/BarPlotExampleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/BarPlotExampleActivity.java
@@ -22,6 +22,7 @@
 import java.text.ParsePosition;
 import java.util.Arrays;
 
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.graphics.Color;
 import android.graphics.Paint;
@@ -86,6 +87,7 @@ private enum SeriesSize {
 
     private Pair<Integer, XYSeries> selection;
 
+    @SuppressLint("ClickableViewAccessibility")
     @Override
     public void onCreate(Bundle savedInstanceState) {
 
diff --git a/demoapp/src/main/java/com/androidplot/demos/DynamicXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/DynamicXYPlotActivity.java
index f76dca01..f18b518b 100644
--- a/demoapp/src/main/java/com/androidplot/demos/DynamicXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/DynamicXYPlotActivity.java
@@ -138,8 +138,8 @@ public void notifyObservers() {
         private static final int MAX_AMP_SEED = 100;
         private static final int MIN_AMP_SEED = 10;
         private static final int AMP_STEP = 1;
-        public static final int SINE1 = 0;
-        public static final int SINE2 = 1;
+        static final int SINE1 = 0;
+        static final int SINE2 = 1;
         private static final int SAMPLE_SIZE = 31;
         private int phase = 0;
         private int sinAmp = 1;
@@ -150,7 +150,7 @@ public void notifyObservers() {
             notifier = new MyObservable();
         }
 
-        public void stopThread() {
+        void stopThread() {
             keepRunning = false;
         }
 
@@ -181,18 +181,18 @@ public void run() {
             }
         }
 
-        public int getItemCount(int series) {
+        int getItemCount(int series) {
             return SAMPLE_SIZE;
         }
 
-        public Number getX(int series, int index) {
+        Number getX(int series, int index) {
             if (index >= SAMPLE_SIZE) {
                 throw new IllegalArgumentException();
             }
             return index;
         }
 
-        public Number getY(int series, int index) {
+        Number getY(int series, int index) {
             if (index >= SAMPLE_SIZE) {
                 throw new IllegalArgumentException();
             }
@@ -208,7 +208,7 @@ public Number getY(int series, int index) {
             }
         }
 
-        public void addObserver(Observer observer) {
+        void addObserver(Observer observer) {
             notifier.addObserver(observer);
         }
 
@@ -223,7 +223,7 @@ class SampleDynamicSeries implements XYSeries {
         private int seriesIndex;
         private String title;
 
-        public SampleDynamicSeries(SampleDynamicXYDatasource datasource, int seriesIndex, String title) {
+        SampleDynamicSeries(SampleDynamicXYDatasource datasource, int seriesIndex, String title) {
             this.datasource = datasource;
             this.seriesIndex = seriesIndex;
             this.title = title;
diff --git a/demoapp/src/main/java/com/androidplot/demos/ECGExample.java b/demoapp/src/main/java/com/androidplot/demos/ECGExample.java
index 31d71e87..2bd7dec5 100644
--- a/demoapp/src/main/java/com/androidplot/demos/ECGExample.java
+++ b/demoapp/src/main/java/com/androidplot/demos/ECGExample.java
@@ -82,7 +82,7 @@ public static class MyFadeFormatter extends AdvancedLineAndPointRenderer.Formatt
 
         private int trailSize;
 
-        public MyFadeFormatter(int trailSize) {
+        MyFadeFormatter(int trailSize) {
             this.trailSize = trailSize;
         }
 
@@ -125,7 +125,7 @@ public static class ECGModel implements XYSeries {
          * @param size Sample size contained within this model
          * @param updateFreqHz Frequency at which new samples are added to the model
          */
-        public ECGModel(int size, int updateFreqHz) {
+        ECGModel(int size, int updateFreqHz) {
             data = new Number[size];
             for(int i = 0; i < data.length; i++) {
                 data[i] = 0;
@@ -176,7 +176,7 @@ public void run() {
             });
         }
 
-        public void start(final WeakReference<AdvancedLineAndPointRenderer> rendererRef) {
+        void start(final WeakReference<AdvancedLineAndPointRenderer> rendererRef) {
             this.rendererRef = rendererRef;
             keepRunning = true;
             thread.start();
diff --git a/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java b/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
index 9d640053..590af815 100644
--- a/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
@@ -78,10 +78,10 @@ protected void generateData() {
                 double bp = Math.random();
 
                 LineAndPointFormatter lpf = new LineAndPointFormatter(
-                        Color.rgb(new Double(rl * 255).intValue(),
-                                new Double(gl * 255).intValue(), new Double(bl * 255).intValue()),
-                        Color.rgb(new Double(rp * 255).intValue(),
-                                new Double(gp * 255).intValue(), new Double(bp * 255).intValue()),
+                        Color.rgb(Double.valueOf(rl * 255).intValue(),
+                                Double.valueOf(gl * 255).intValue(), Double.valueOf(bl * 255).intValue()),
+                        Color.rgb(Double.valueOf(rp * 255).intValue(),
+                                Double.valueOf(gp * 255).intValue(), Double.valueOf(bp * 255).intValue()),
                         null, null);
 
                 // for fun, configure interpolation on the formatter:
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimplePieChartActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimplePieChartActivity.java
index 9484176f..cf419083 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimplePieChartActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimplePieChartActivity.java
@@ -18,6 +18,7 @@
 
 import android.animation.Animator;
 import android.animation.ValueAnimator;
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.graphics.*;
 import android.os.Bundle;
@@ -52,6 +53,7 @@ public class SimplePieChartActivity extends Activity
     private Segment s3;
     private Segment s4;
 
+    @SuppressLint("ClickableViewAccessibility")
     @Override
     public void onCreate(Bundle savedInstanceState)
     {
diff --git a/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java b/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
index c5811bfc..9a8da790 100644
--- a/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
@@ -16,6 +16,7 @@
 
 package com.androidplot.demos;
 
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.graphics.Color;
 import android.graphics.DashPathEffect;
@@ -102,6 +103,7 @@ public void onCreate(Bundle savedInstanceState) {
                     // create a simple date format that draws on the year portion of our timestamp.
                     // see http://download.oracle.com/javase/1.4.2/docs/api/java/text/SimpleDateFormat.html
                     // for a full description of SimpleDateFormat.
+                    @SuppressLint("SimpleDateFormat")
                     private final SimpleDateFormat dateFormat = new SimpleDateFormat("MMM yyyy");
 
                     @Override

From b275635276dc9023be0803c2bdc4b2ed516d1053 Mon Sep 17 00:00:00 2001
From: topherbuckley <topherbuckley@gmail.com>
Date: Sun, 19 Sep 2021 02:09:39 +0900
Subject: [PATCH 22/48] Quick start edits (#108)

* Changed compile keyword to implementation

This is to match updated gradel recommendations

* Reordered quickstart guide to avoid unresolved xml file errors

Creating the xml files first will remove the unresolved errors you get when copy/pasting the activity code. As people are inherently lazy to read ahead, I think this will eliminate some github issue requests in the future :D
---
 docs/quickstart.md | 55 +++++++++++++++++++++++-----------------------
 1 file changed, 27 insertions(+), 28 deletions(-)

diff --git a/docs/quickstart.md b/docs/quickstart.md
index 08abc2dd..18309987 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    compile "com.androidplot:androidplot-core:1.5.7"
+    implementation "com.androidplot:androidplot-core:1.5.7"
 }
 ```
 
@@ -55,6 +55,32 @@ directly within your Plot's XML, prefixing each property with "androidPlot".  Ex
 androidPlot.title="My Plot"
 ```
 
+Add these files to your **/res/xml** directory:
+
+#### /res/xml/line_point_formatter_with_labels.xml
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<config
+    linePaint.strokeWidth="5dp"
+    linePaint.color="#00AA00"
+    vertexPaint.color="#007700"
+    vertexPaint.strokeWidth="20dp"
+    fillPaint.color="#00000000"
+    pointLabelFormatter.textPaint.color="#CCCCCC"/>
+```
+
+#### /res/xml/line_point_formatter_with_labels_2.xml
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<config
+    linePaint.strokeWidth="5dp"
+    linePaint.color="#0000AA"
+    vertexPaint.strokeWidth="20dp"
+    vertexPaint.color="#000099"
+    fillPaint.color="#00000000"
+    pointLabelFormatter.textPaint.color="#CCCCCC"/>
+```
+
 # Create an Activity
 Now let's create an Activity to display the XYPlot we just defined in `simple_xy_plot_example.xml`.  
 The basic steps are:
@@ -151,7 +177,6 @@ public class SimpleXYPlotActivity extends Activity {
 }
 ```
 
-
 One potentially confusing section of the code above are the initializations of LineAndPointFormatter   
 You probably noticed that they take a mysterious reference to an xml resource file. This is actually 
 using [Fig](https://github.com/halfhp/fig) to configure the instance properties from XML.  
@@ -173,31 +198,5 @@ In general XML configuration should be used over programmatic configuration when
 more flexibility in terms of defining properties by screen density etc..  For more details on how to 
 programmatically configure Formatters etc. consult the latest Javadocs.
 
-Continuing with the original example above, add these files to your **/res/xml** directory:
-
-#### /res/xml/line_point_formatter_with_labels.xml
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<config
-    linePaint.strokeWidth="5dp"
-    linePaint.color="#00AA00"
-    vertexPaint.color="#007700"
-    vertexPaint.strokeWidth="20dp"
-    fillPaint.color="#00000000"
-    pointLabelFormatter.textPaint.color="#CCCCCC"/>
-```
-
-#### /res/xml/line_point_formatter_with_labels_2.xml
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<config
-    linePaint.strokeWidth="5dp"
-    linePaint.color="#0000AA"
-    vertexPaint.strokeWidth="20dp"
-    vertexPaint.color="#000099"
-    fillPaint.color="#00000000"
-    pointLabelFormatter.textPaint.color="#CCCCCC"/>
-```
-
 # Whats Next?
 Learn about [Plot Composition](plot_composition.md) or continue with [XYPlots](xyplot.md).
\ No newline at end of file

From 6079afc8f18c32efdb9c88b1186cc5300d14f0da Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 10:59:43 -0500
Subject: [PATCH 23/48] Project updates (#110)

---
 .circleci/config.yml                          |  15 +-
 README.md                                     |   2 +-
 androidplot-core/build.gradle                 | 129 +++++++++---------
 .../src/main/java/com/androidplot/Plot.java   |   3 +-
 .../com/androidplot/pie/PieLegendItem.java    |   2 +-
 .../com/androidplot/pie/PieLegendWidget.java  |   2 +-
 .../com/androidplot/ui/PositionMetrics.java   |   2 +-
 .../androidplot/ui/widget/LegendWidget.java   |   2 +-
 .../com/androidplot/ui/widget/Widget.java     |   4 +-
 .../java/com/androidplot/util/FastNumber.java |   4 +-
 .../xy/FastLineAndPointRenderer.java          |   2 +-
 .../xy/FixedSizeEditableXYSeries.java         |   4 +-
 .../main/java/com/androidplot/xy/PanZoom.java |   2 +-
 .../com/androidplot/xy/XYConstraints.java     |   4 +-
 .../com/androidplot/xy/XYGraphWidget.java     |   4 +-
 .../java/com/androidplot/xy/XYLegendItem.java |   2 +-
 .../com/androidplot/xy/XYLegendWidget.java    |   2 +-
 .../main/java/com/androidplot/xy/XYPlot.java  |   2 +-
 .../com/androidplot/ui/widget/WidgetTest.java |   2 +-
 .../com/androidplot/xy/XYGraphWidgetTest.java |   4 +-
 build.gradle                                  |  23 +---
 demoapp-wearable/build.gradle                 |   8 +-
 demoapp/build.gradle                          |  16 +--
 .../demos/AnimatedXYPlotActivity.java         |   2 +-
 .../demos/CandlestickChartActivity.java       |   2 +-
 .../androidplot/demos/DualScaleActivity.java  |   2 +-
 .../androidplot/demos/ListViewActivity.java   |   2 +-
 .../demos/SimpleXYPlotActivity.java           |   2 +-
 .../demos/StepChartExampleActivity.java       |   2 +-
 .../androidplot/demos/TimeSeriesActivity.java |   2 +-
 docs/quickstart.md                            |   5 +-
 gradle.properties                             |   2 +
 gradle/wrapper/gradle-wrapper.properties      |   2 +-
 33 files changed, 124 insertions(+), 139 deletions(-)
 create mode 100644 gradle.properties

diff --git a/.circleci/config.yml b/.circleci/config.yml
index f333b5c2..bf60104b 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -16,7 +16,7 @@ jobs:
 
       # CircleCI maintains a library of pre-built images
             # documented at https://circleci.com/docs/2.0/circleci-images/
-      - image: circleci/android:api-28-alpha
+      - image: circleci/android:api-30
 
     working_directory: ~/repo
 
@@ -87,17 +87,10 @@ jobs:
           path: androidplot-core/build/test-results/
 
       - deploy:
-          name: "Deploy to Bintray"
+          name: "Publish"
           command: |
-            if [ "${CIRCLE_BRANCH}" == "master" ];
-              then ./gradlew bintrayUpload;
-            fi
-
-      - deploy:
-          name: "Deploy to Google Play"
-          command: |
-            if [ "${CIRCLE_BRANCH}" == "master" ];
+            if [ "${CIRCLE_BRANCH}" == "project-updates" ];
               then
                 ./misc/download_google_publisher_json.sh;
-                ./gradlew publishApkRelease
+                ./gradlew publish;
             fi
\ No newline at end of file
diff --git a/README.md b/README.md
index 7d7020d2..42b3f9ea 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@ Technical questions should be posted using the [androidplot tag](http://stackove
 # License
 Androidplot has been made available under the Apache 2.0 license:
 
-    Copyright 2018 Androidplot.com
+    Copyright 2021 Androidplot.com
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index e513a542..3d255cc2 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -14,10 +14,12 @@
  *    limitations under the License.
  */
 
-apply plugin: 'com.android.library'
-apply plugin: 'com.github.dcendents.android-maven'
-apply plugin: 'com.jfrog.bintray'
-apply plugin: 'jacoco-android'
+plugins {
+    id 'com.android.library'
+    id 'com.dicedmelon.gradle.jacoco-android'
+    id 'maven-publish'
+    id 'signing'
+}
 
 class AttrMarkdown extends DefaultTask {
 
@@ -59,8 +61,6 @@ android {
     compileSdkVersion theCompileSdkVersion
 
     defaultConfig {
-        versionCode theVersionCode
-        versionName theVersionName
         minSdkVersion theMinSdkVersion
         targetSdkVersion theTargetSdkVersion
         testApplicationId "com.androidplot.test"
@@ -70,14 +70,13 @@ android {
         unitTests.all {
             jacoco {
                 includeNoLocationClasses = true
+                jacoco.excludes = ['jdk.internal.*']
             }
         }
     }
 
-    /**
-     * TODO: enable and address lint issues.
-     */
     lintOptions {
+        // TODO: enable and address lint issues.
         abortOnError false
     }
 }
@@ -90,15 +89,12 @@ def gitUrl = 'https://github.com/halfhp/androidplot.git'
 
 dependencies {
 
-    implementation 'com.halfhp.fig:figlib:1.0.7'
+    implementation 'com.halfhp.fig:figlib:1.0.11'
     implementation 'com.android.support:support-annotations:28.0.0'
-    testImplementation "org.mockito:mockito-core:3.0.0"
-    testImplementation group: 'junit', name: 'junit', version: '4.12'
-    testImplementation "org.robolectric:robolectric:4.2.1"
 
-    // temp fix for:
-    // https://github.com/robolectric/robolectric/issues/1932
-    testImplementation 'org.khronos:opengl-api:gl1.1-android-2.1_r1'
+    testImplementation "org.mockito:mockito-core:3.9.0"
+    testImplementation group: 'junit', name: 'junit', version: '4.13.2'
+    testImplementation "org.robolectric:robolectric:4.5.1"
 }
 
 task javadoc(type: Javadoc) {
@@ -123,63 +119,70 @@ task sourcesJar(type: Jar) {
     from android.sourceSets.main.java.srcDirs
 }
 
-install {
-    repositories.mavenInstaller {
-        pom {
-            project {
-                packaging 'aar'
-                name 'Androidplot Core Library'
-                description = "Androidplot is a library for creating dynamic and static charts within your Android application."
-                url siteUrl
-                licenses {
-                    license {
-                        name 'The Apache Software License, Version 2.0'
-                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
-                    }
-                }
-                developers {
-                    developer {
-                        id 'halfhp'
-                        name 'Nick Fellows'
-                        email 'halfhp@gmail.com'
-                    }
-                }
-                scm {
-                    connection gitUrl
-                    developerConnection gitUrl
-                    url siteUrl
+javadoc {
+    options.overview = "src/main/java/overview.html"
+}
 
+afterEvaluate {
+    publishing {
+        repositories {
+            maven {
+                name = "Maven Central"
+                url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+                credentials {
+                    username = System.getenv("OSSRH_ACTOR")
+                    password = System.getenv("OSSRH_TOKEN")
                 }
             }
         }
-    }
-}
-
-bintray {
-
-    // these environment vars must be set when deploying to bintray.
-    // note: BINTRAY_PASSWORD is actually the api key, but naming it 'password'
-    // tells the CI environment to obfuscate the value in public logs.
-    user = System.getenv('BINTRAY_USER')
-    key = System.getenv('BINTRAY_PASSWORD')
 
+        publications {
+            release(MavenPublication) {
+
+                from components.release
+
+                // You can then customize attributes of the publication as shown below.
+                groupId = 'com.androidplot'
+                artifactId = 'androidplot'
+                version = theVersionName
+
+                pom {
+                    packaging 'aar'
+                    name = 'Androidplot'
+                    description = "Configure any object from XML."
+                    url = gitUrl
+                    licenses {
+                        license {
+                            name = 'The Apache Software License, Version 2.0'
+                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                        }
+                    }
+                    developers {
+                        developer {
+                            id = 'halfhp'
+                            name = 'Nick Fellows'
+                            email = 'halfhp@gmail.com'
+                        }
+                    }
+                    scm {
+                        connection = gitUrl
+                        developerConnection = gitUrl
+                        url = gitUrl
 
-    configurations = ['archives']
-    pkg {
-        version {
-            name = theVersionName
+                    }
+                }
+            }
         }
-        repo = "androidplot"
-        name = "com.androidplot:androidplot-core"
-        issueTrackerUrl = "https://github.com/halfhp/androidplot/issues"
-        websiteUrl = siteUrl
-        vcsUrl = gitUrl
-        licenses = ["Apache-2.0"]
     }
 }
 
-javadoc {
-    options.overview = "src/main/java/overview.html"
+afterEvaluate {
+    signing {
+        def signingKey = System.getenv("SIGNING_KEY")
+        def signingPassword = System.getenv("SIGNING_PASSWORD")
+        useInMemoryPgpKeys(signingKey, signingPassword)
+        sign publishing.publications.release
+    }
 }
 
 artifacts {
diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index 47ef0fd6..925a9c78 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -26,11 +26,12 @@
 import android.graphics.RectF;
 import android.os.Build;
 import android.os.Looper;
-import android.support.annotation.Nullable;
 import android.util.AttributeSet;
 import android.util.Log;
 import android.view.View;
 
+import androidx.annotation.Nullable;
+
 import com.androidplot.ui.Anchor;
 import com.androidplot.ui.BoxModel;
 import com.androidplot.ui.Formatter;
diff --git a/androidplot-core/src/main/java/com/androidplot/pie/PieLegendItem.java b/androidplot-core/src/main/java/com/androidplot/pie/PieLegendItem.java
index 8b4e9913..669b188b 100644
--- a/androidplot-core/src/main/java/com/androidplot/pie/PieLegendItem.java
+++ b/androidplot-core/src/main/java/com/androidplot/pie/PieLegendItem.java
@@ -1,7 +1,7 @@
 package com.androidplot.pie;
 
 
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.widget.LegendItem;
 
diff --git a/androidplot-core/src/main/java/com/androidplot/pie/PieLegendWidget.java b/androidplot-core/src/main/java/com/androidplot/pie/PieLegendWidget.java
index c59b7f0b..4d1ccd03 100644
--- a/androidplot-core/src/main/java/com/androidplot/pie/PieLegendWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/pie/PieLegendWidget.java
@@ -2,7 +2,7 @@
 
 import android.graphics.Canvas;
 import android.graphics.RectF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.SeriesBundle;
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/PositionMetrics.java b/androidplot-core/src/main/java/com/androidplot/ui/PositionMetrics.java
index 88efddcb..377e9e04 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/PositionMetrics.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/PositionMetrics.java
@@ -16,7 +16,7 @@
 
 package com.androidplot.ui;
 
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 public class PositionMetrics implements Comparable<PositionMetrics> {
 
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
index e9222888..0da56a3a 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/LegendWidget.java
@@ -4,7 +4,7 @@
 import android.graphics.Color;
 import android.graphics.Paint;
 import android.graphics.RectF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.Size;
 import com.androidplot.ui.TableModel;
diff --git a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
index 87a43a02..6d21767b 100644
--- a/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
+++ b/androidplot-core/src/main/java/com/androidplot/ui/widget/Widget.java
@@ -17,8 +17,8 @@
 package com.androidplot.ui.widget;
 
 import android.graphics.*;
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
+import androidx.annotation.Nullable;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.*;
 import com.androidplot.util.DisplayDimensions;
diff --git a/androidplot-core/src/main/java/com/androidplot/util/FastNumber.java b/androidplot-core/src/main/java/com/androidplot/util/FastNumber.java
index 72e8a25d..4fa11d8a 100644
--- a/androidplot-core/src/main/java/com/androidplot/util/FastNumber.java
+++ b/androidplot-core/src/main/java/com/androidplot/util/FastNumber.java
@@ -1,7 +1,7 @@
 package com.androidplot.util;
 
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 /**
  * An extension of {@link Number} optimized for speed at the cost of memory.
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
index 5f469ce2..df070325 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/FastLineAndPointRenderer.java
@@ -20,7 +20,7 @@
 import android.graphics.Paint;
 import android.graphics.PointF;
 import android.graphics.RectF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.RenderStack;
 import com.androidplot.ui.SeriesRenderer;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/FixedSizeEditableXYSeries.java b/androidplot-core/src/main/java/com/androidplot/xy/FixedSizeEditableXYSeries.java
index 0e6ea1a1..36ff371e 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/FixedSizeEditableXYSeries.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/FixedSizeEditableXYSeries.java
@@ -1,7 +1,7 @@
 package com.androidplot.xy;
 
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 import com.androidplot.util.FastNumber;
 
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java b/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
index 33d61369..9cd80847 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/PanZoom.java
@@ -2,7 +2,7 @@
 
 import android.graphics.RectF;
 import android.graphics.PointF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 import android.view.*;
 
 import com.androidplot.*;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYConstraints.java b/androidplot-core/src/main/java/com/androidplot/xy/XYConstraints.java
index 58338264..c4452d33 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYConstraints.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYConstraints.java
@@ -16,8 +16,8 @@
 
 package com.androidplot.xy;
 
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 /**
  * Calculates the min/max constraints for an xy plane.
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index af1f2729..4f6fa04a 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -22,8 +22,8 @@
 import android.graphics.Paint;
 import android.graphics.PointF;
 import android.graphics.RectF;
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 import com.androidplot.R;
 import com.androidplot.Region;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYLegendItem.java b/androidplot-core/src/main/java/com/androidplot/xy/XYLegendItem.java
index 1fd10ebd..51c67159 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYLegendItem.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYLegendItem.java
@@ -1,6 +1,6 @@
 package com.androidplot.xy;
 
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.widget.LegendItem;
 
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYLegendWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYLegendWidget.java
index f08783cb..680fd4b2 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYLegendWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYLegendWidget.java
@@ -17,7 +17,7 @@
 package com.androidplot.xy;
 
 import android.graphics.*;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.ui.LayoutManager;
 import com.androidplot.ui.SeriesBundle;
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYPlot.java b/androidplot-core/src/main/java/com/androidplot/xy/XYPlot.java
index 67eaafa8..e519b5a0 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYPlot.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYPlot.java
@@ -22,7 +22,7 @@
 import android.graphics.Color;
 import android.graphics.Paint;
 import android.graphics.PointF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 import android.util.AttributeSet;
 
 import com.androidplot.Plot;
diff --git a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
index 408edc33..ce398dc9 100644
--- a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
@@ -2,7 +2,7 @@
 
 import android.graphics.Canvas;
 import android.graphics.RectF;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.test.AndroidplotTest;
 import com.androidplot.ui.Anchor;
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 03897972..5a0da878 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -298,10 +298,10 @@ public void seriesToScreenY_returnsScreenValue() {
 
     @Test
     public void setGridInsets_updatesGridRect() {
-        graphWidget.setGridInsets(new Insets(0, 0, 0, 0));
+        graphWidget.setGridInsets(new com.androidplot.ui.Insets(0, 0, 0, 0));
         final RectF oldRect = graphWidget.getGridRect();
 
-        graphWidget.setGridInsets(new Insets(2, 2, 2, 2));
+        graphWidget.setGridInsets(new com.androidplot.ui.Insets(2, 2, 2, 2));
         final RectF newRect = graphWidget.getGridRect();
 
         assertEquals(oldRect.left + 2, newRect.left);
diff --git a/build.gradle b/build.gradle
index a00c8e72..96bd5758 100644
--- a/build.gradle
+++ b/build.gradle
@@ -14,34 +14,25 @@
  *    limitations under the License.
  */
 
-apply plugin: 'java'
-
-allprojects {
-    repositories {
-        jcenter()
-    }
-}
-
 ext {
-    theCompileSdkVersion = 28
-    theTargetSdkVersion = 28
+    theCompileSdkVersion = 30
+    theTargetSdkVersion = 30
     theMinSdkVersion = 5
-    theVersionName = '1.5.7'
+    theVersionName = '1.5.8'
     theVersionCode = 1
+    gitUrl = 'https://github.com/halfhp/androidplot.git'
 }
 
 buildscript {
     repositories {
         mavenCentral()
-        jcenter()
+        maven { url 'https://s01.oss.sonatype.org/content/repositories/snapshots' }
         google()
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.5.3'
-        classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
-        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.4'
-        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.4'
+        classpath 'com.android.tools.build:gradle:7.0.2'
+        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.5-SNAPSHOT'
     }
 }
 
diff --git a/demoapp-wearable/build.gradle b/demoapp-wearable/build.gradle
index 22e5186d..3bfc0ee0 100644
--- a/demoapp-wearable/build.gradle
+++ b/demoapp-wearable/build.gradle
@@ -16,18 +16,14 @@
 
 buildscript {
     repositories {
-        jcenter()
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.1.1'
+        classpath 'com.android.tools.build:gradle:3.1.4'
     }
 }
-apply plugin: 'com.android.application'
 
-repositories {
-    jcenter()
-}
+apply plugin: 'com.android.application'
 
 android {
     compileSdkVersion theCompileSdkVersion
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index 191280a5..a5583eb9 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -14,22 +14,19 @@
  *    limitations under the License.
  */
 
-//apply plugin: 'com.android.application'
-//apply plugin: 'com.github.triplet.play'
-
 buildscript {
 
     repositories {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.github.triplet.gradle:play-publisher:2.2.1'
+        classpath 'com.github.triplet.gradle:play-publisher:3.6.0'
     }
 }
 
 plugins {
     id 'com.android.application'
-    id 'com.github.triplet.play' version '2.2.1'
+    id 'com.github.triplet.play' version '3.6.0'
 }
 
 dependencies {
@@ -37,7 +34,9 @@ dependencies {
     implementation 'com.crittercism:crittercism-android-agent:5.4.0'
 
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
+
     releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
+
     testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
 }
 
@@ -72,17 +71,14 @@ android {
         }
     }
 
-
-    /**
-     * TODO: uncomment this and address all the lint issues.
-     */
     lintOptions {
+        // TODO: set to true and address all the lint issues.
         abortOnError false
     }
 }
 
 play {
     // see: https://github.com/Triple-T/gradle-play-publisher
-    serviceAccountCredentials = file(System.getenv("PUBLISHER_ACCT_JSON_FILE") ?: "publisher.json")
+    serviceAccountCredentials.set(file(System.getenv("PUBLISHER_ACCT_JSON_FILE") ?: "publisher.json"))
     track = 'beta'
 }
diff --git a/demoapp/src/main/java/com/androidplot/demos/AnimatedXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/AnimatedXYPlotActivity.java
index 75d9553b..43d3adc0 100644
--- a/demoapp/src/main/java/com/androidplot/demos/AnimatedXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/AnimatedXYPlotActivity.java
@@ -21,7 +21,7 @@
 import android.app.Activity;
 import android.graphics.Color;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 import android.view.animation.AccelerateDecelerateInterpolator;
 
 import com.androidplot.xy.BoundaryMode;
diff --git a/demoapp/src/main/java/com/androidplot/demos/CandlestickChartActivity.java b/demoapp/src/main/java/com/androidplot/demos/CandlestickChartActivity.java
index 2c37580a..86ae1fbb 100644
--- a/demoapp/src/main/java/com/androidplot/demos/CandlestickChartActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/CandlestickChartActivity.java
@@ -21,7 +21,7 @@
 import android.graphics.DashPathEffect;
 import android.graphics.Paint;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.Region;
 import com.androidplot.util.PixelUtils;
diff --git a/demoapp/src/main/java/com/androidplot/demos/DualScaleActivity.java b/demoapp/src/main/java/com/androidplot/demos/DualScaleActivity.java
index d164710a..f0116121 100644
--- a/demoapp/src/main/java/com/androidplot/demos/DualScaleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/DualScaleActivity.java
@@ -20,7 +20,7 @@
 import android.graphics.Color;
 import android.graphics.DashPathEffect;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.BoundaryMode;
diff --git a/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java b/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
index 590af815..290b7802 100644
--- a/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/ListViewActivity.java
@@ -20,7 +20,7 @@
 import android.content.Context;
 import android.graphics.Color;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index 46118949..db3a5a28 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -19,7 +19,7 @@
 import android.app.Activity;
 import android.graphics.DashPathEffect;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.CatmullRomInterpolator;
diff --git a/demoapp/src/main/java/com/androidplot/demos/StepChartExampleActivity.java b/demoapp/src/main/java/com/androidplot/demos/StepChartExampleActivity.java
index 79b8272f..4b1fdc35 100644
--- a/demoapp/src/main/java/com/androidplot/demos/StepChartExampleActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/StepChartExampleActivity.java
@@ -23,7 +23,7 @@
 import android.graphics.Paint;
 import android.graphics.Shader;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.SimpleXYSeries;
diff --git a/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java b/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
index 9a8da790..12930bd7 100644
--- a/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/TimeSeriesActivity.java
@@ -22,7 +22,7 @@
 import android.graphics.DashPathEffect;
 import android.graphics.Paint;
 import android.os.Bundle;
-import android.support.annotation.NonNull;
+import androidx.annotation.NonNull;
 
 import com.androidplot.util.PixelUtils;
 import com.androidplot.xy.BoundaryMode;
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 18309987..2f1853d2 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,10 +14,13 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    implementation "com.androidplot:androidplot-core:1.5.7"
+    implementation "com.androidplot:androidplot-core:1.5.8"
 }
 ```
 
+*NOTE: As of version 1.5.8 Androidplot has migrated over from the Android Support Libraries to androidx.
+If you have a very old project and experience issues, may need to stay on version 1.5.7*
+
 If you’re using Proguard obfuscation (Projects created by Android Studio do by default) you’ll also 
 want add this to your proguard-rules.pro file:
 
diff --git a/gradle.properties b/gradle.properties
new file mode 100644
index 00000000..d015431a
--- /dev/null
+++ b/gradle.properties
@@ -0,0 +1,2 @@
+android.useAndroidX=true
+android.enableJetifier=true
\ No newline at end of file
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index b37f1ae6..0a24689e 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.5.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-all.zip

From 44042626cefab91712dcbb923af2332f6438affe Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 17:19:54 -0500
Subject: [PATCH 24/48] render mode attrs should have a distinct ordinal value
 (#111)

---
 .../src/main/java/com/androidplot/Plot.java   | 22 +++++++++----------
 .../src/main/res/values/attrs.xml             |  2 +-
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index 925a9c78..ac2d6a09 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -145,25 +145,25 @@ public enum BorderStyle {
      */
     public enum RenderMode {
         /**
-         * Use a second thread and an off-screen buffer to do drawing.  This is the preferred method
-         * of drawing dynamic data and static data that consists of a large number of points.  This mode
-         * provides more efficient CPU utilization at the cost of increased memory usage.  As of
-         * version 0.5.1 this is the default RenderMode.
+         * Do everything in the primary thread.  This is the preferred method of drawing static charts
+         * and dynamic data that consists of a small number of points. This mode uses less memory at
+         * the cost of poor CPU utilization.
          *
-         * XML value: use_background_thread
+         * XML value: use_main_thread
          * @since 0.5.1
          */
-        USE_BACKGROUND_THREAD,
+        USE_MAIN_THREAD,
 
         /**
-         * Do everything in the primary thread.  This is the preferred method of drawing static charts
-         * and dynamic data that consists of a small number of points. This mode uses less memory at
-         * the cost of poor CPU utilization.
+         * Use a second thread and an off-screen buffer to do drawing.  This is the preferred method
+         * of drawing dynamic data and static data that consists of a large number of points.  This mode
+         * provides more efficient CPU utilization at the cost of increased memory usage.  As of
+         * version 0.5.1 this is the default RenderMode.
          *
-         * XML value: use_main_thread
+         * XML value: use_background_thread
          * @since 0.5.1
          */
-        USE_MAIN_THREAD
+        USE_BACKGROUND_THREAD
     }
     private BoxModel boxModel = new BoxModel();
 
diff --git a/androidplot-core/src/main/res/values/attrs.xml b/androidplot-core/src/main/res/values/attrs.xml
index 535ccf18..5c714912 100644
--- a/androidplot-core/src/main/res/values/attrs.xml
+++ b/androidplot-core/src/main/res/values/attrs.xml
@@ -30,8 +30,8 @@ Supported Elements:
 <resources>
 
     <attr name="renderMode" format="enum">
-        <enum name="use_background_thread" value="0"/>
         <enum name="use_main_thread" value="0"/>
+        <enum name="use_background_thread" value="1"/>
     </attr>
 
     <attr name="previewMode" format="enum">

From b365c634ad994386c85440d656e69071870a8beb Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 17:29:06 -0500
Subject: [PATCH 25/48] fix androidplot artifact coordinates (#112)

---
 androidplot-core/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 3d255cc2..e81e40a2 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -143,7 +143,7 @@ afterEvaluate {
 
                 // You can then customize attributes of the publication as shown below.
                 groupId = 'com.androidplot'
-                artifactId = 'androidplot'
+                artifactId = 'androidplot-core'
                 version = theVersionName
 
                 pom {

From 0a2e28251a4458a3486db4da0a4e2f856d07a7bb Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 18:05:52 -0500
Subject: [PATCH 26/48] #104 - Add support for redrawing plots inside
 recyclerview + example (#113)

---
 .../src/main/java/com/androidplot/Plot.java   |  86 +++++---
 demoapp/build.gradle                          |  15 +-
 demoapp/src/main/AndroidManifest.xml          |   1 +
 .../com/androidplot/demos/MainActivity.java   | 193 ------------------
 .../com/androidplot/demos/MainActivity.kt     | 122 +++++++++++
 .../androidplot/demos/RecyclerViewActivity.kt | 130 ++++++++++++
 demoapp/src/main/res/layout/main.xml          |   7 +
 .../main/res/layout/recyclerview_example.xml  |  31 +++
 .../res/layout/recyclerview_example_item.xml  |  25 +++
 docs/quickstart.md                            |   2 +-
 docs/release_notes.md                         |   7 +
 11 files changed, 397 insertions(+), 222 deletions(-)
 delete mode 100644 demoapp/src/main/java/com/androidplot/demos/MainActivity.java
 create mode 100644 demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
 create mode 100644 demoapp/src/main/java/com/androidplot/demos/RecyclerViewActivity.kt
 create mode 100644 demoapp/src/main/res/layout/recyclerview_example.xml
 create mode 100644 demoapp/src/main/res/layout/recyclerview_example_item.xml

diff --git a/androidplot-core/src/main/java/com/androidplot/Plot.java b/androidplot-core/src/main/java/com/androidplot/Plot.java
index ac2d6a09..63d2e831 100644
--- a/androidplot-core/src/main/java/com/androidplot/Plot.java
+++ b/androidplot-core/src/main/java/com/androidplot/Plot.java
@@ -212,6 +212,8 @@ public enum RenderMode {
      *  that is being used.
      */
     private static class BufferedCanvas {
+        private int lastHeight = 0;
+        private int lastWidth = 0;
         private volatile Bitmap bgBuffer;  // all drawing is done on this buffer.
         private volatile Bitmap fgBuffer;
         private Canvas canvas = new Canvas();
@@ -226,11 +228,21 @@ public synchronized void swap() {
             fgBuffer = tmp;
         }
 
+        /**
+         * Used when rendering in background mode and a view is attached
+         * but not resized, so that rendering buffers will be reinitialized.
+         */
+        public void resizeToLast() {
+            resize(lastHeight, lastWidth);
+        }
+
         public synchronized void resize(int h, int w) {
             if (w <= 0 || h <= 0) {
                 bgBuffer = null;
                 fgBuffer = null;
             } else {
+                lastHeight = h;
+                lastWidth = w;
                 try {
                     bgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
                     fgBuffer = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
@@ -408,35 +420,43 @@ protected final void init(Context context, AttributeSet attrs, int defStyle) {
 
         layoutManager.onPostInit();
         if (renderMode == RenderMode.USE_BACKGROUND_THREAD) {
-            renderThread = new Thread(new Runnable() {
-                @Override
-                public void run() {
-
-                    keepRunning = true;
-                    while (keepRunning) {
-                        isIdle = false;
-                        synchronized (pingPong) {
-                            Canvas c = pingPong.getCanvas();
-                            renderOnCanvas(c);
-                            pingPong.swap();
-                        }
-                        synchronized (renderSync) {
-                            postInvalidate();
-                            // prevent this thread from becoming an orphan
-                            // after the view is destroyed
-                            if (keepRunning) {
-                                try {
-                                    renderSync.wait();
-                                } catch (InterruptedException e) {
-                                    keepRunning = false;
-                                }
-                            }
+            startBackgroundRendering();
+        }
+    }
+
+    protected void startBackgroundRendering() {
+        if(renderThread != null) {
+            return;
+        }
+
+        renderThread = new Thread(() -> {
+            System.out.println("Thread started with id " + this.hashCode());
+
+            keepRunning = true;
+            while (keepRunning) {
+                isIdle = false;
+                synchronized (pingPong) {
+                    Canvas c = pingPong.getCanvas();
+                    renderOnCanvas(c);
+                    pingPong.swap();
+                }
+                synchronized (renderSync) {
+                    postInvalidate();
+                    // prevent this thread from becoming an orphan
+                    // after the view is destroyed
+                    if (keepRunning) {
+                        try {
+                            renderSync.wait();
+                        } catch (InterruptedException e) {
+                            keepRunning = false;
                         }
                     }
-                    pingPong.recycle();
                 }
-            }, "Androidplot renderThread");
-        }
+            }
+            System.out.println("Thread exited with id " + this.hashCode());
+            renderThread = null;
+            pingPong.recycle();
+        }, "Androidplot renderThread");
     }
 
     /**
@@ -745,11 +765,12 @@ public void redraw() {
             // only enter synchronized block if the call is expected to block OR
             // if the render thread is idle, so we know that we won't have to wait to
             // obtain a lock.
-            if (isIdle) {
+            if (renderThread != null && isIdle) {
                 synchronized (renderSync) {
                     renderSync.notify();
                 }
             }
+
         } else if(renderMode == RenderMode.USE_MAIN_THREAD) {
 
             // are we on the UI thread?
@@ -778,6 +799,17 @@ protected void onDetachedFromWindow() {
         }
     }
 
+    @Override
+    protected void onAttachedToWindow() {
+        super.onAttachedToWindow();
+
+        // necessary to support rendering in recyclerview etc.
+        if(renderMode == RenderMode.USE_BACKGROUND_THREAD && renderThread == null) {
+            pingPong.resizeToLast();
+            startBackgroundRendering();
+            renderThread.start();
+        }
+    }
 
     @Override
     protected synchronized void onSizeChanged (int w, int h, int oldw, int oldh) {
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index a5583eb9..b8b76251 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -15,12 +15,13 @@
  */
 
 buildscript {
-
+    ext.kotlin_version = '1.5.31'
     repositories {
         mavenCentral()
     }
     dependencies {
         classpath 'com.github.triplet.gradle:play-publisher:3.6.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 
@@ -29,9 +30,14 @@ plugins {
     id 'com.github.triplet.play' version '3.6.0'
 }
 
+apply plugin: 'kotlin-android'
+
 dependencies {
+    implementation "androidx.core:core-ktx:1.6.0"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 	implementation project(':androidplot-core')
     implementation 'com.crittercism:crittercism-android-agent:5.4.0'
+    implementation 'androidx.recyclerview:recyclerview:1.2.1'
 
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
 
@@ -43,6 +49,10 @@ dependencies {
 android {
     compileSdkVersion theCompileSdkVersion
 
+    buildFeatures {
+        viewBinding true
+    }
+
     defaultConfig {
         versionCode theVersionCode
         versionName theVersionName
@@ -82,3 +92,6 @@ play {
     serviceAccountCredentials.set(file(System.getenv("PUBLISHER_ACCT_JSON_FILE") ?: "publisher.json"))
     track = 'beta'
 }
+repositories {
+    mavenCentral()
+}
diff --git a/demoapp/src/main/AndroidManifest.xml b/demoapp/src/main/AndroidManifest.xml
index 89f1428f..16245b9f 100644
--- a/demoapp/src/main/AndroidManifest.xml
+++ b/demoapp/src/main/AndroidManifest.xml
@@ -95,6 +95,7 @@
             </intent-filter>
         </activity>
         <activity android:name=".ListViewActivity" android:label="ListView Example"/>
+        <activity android:name=".RecyclerViewActivity" android:label="RecyclerView Example"/>
         <activity android:name=".XYRegionExampleActivity" android:label="XYRegion Example">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
diff --git a/demoapp/src/main/java/com/androidplot/demos/MainActivity.java b/demoapp/src/main/java/com/androidplot/demos/MainActivity.java
deleted file mode 100644
index 86dadb68..00000000
--- a/demoapp/src/main/java/com/androidplot/demos/MainActivity.java
+++ /dev/null
@@ -1,193 +0,0 @@
-/*
- * Copyright 2015 AndroidPlot.com
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-package com.androidplot.demos;
-
-import android.app.Activity;
-import android.content.Intent;
-import android.os.Bundle;
-import android.util.Log;
-import android.view.View;
-import android.widget.Button;
-import com.crittercism.app.Crittercism;
-
-public class MainActivity extends Activity {
-
-    private static final String TAG = MainActivity.class.getName();
-
-    // DO *NOT* CHANGE THIS LINE! (CI-MATCH-POPULATE)
-    private static final String CRITTERCISM_APP_ID = null;
-
-    @Override
-    public void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
-
-        if (CRITTERCISM_APP_ID != null) {
-            Log.d(TAG, "Crittercism initialized.");
-            Crittercism.initialize(getApplicationContext(), CRITTERCISM_APP_ID);
-        }
-
-        setContentView(R.layout.main);
-
-        Button startAnimatedXYPlotExButton = (Button) findViewById(R.id.animatedXYPlotExButton);
-        startAnimatedXYPlotExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, AnimatedXYPlotActivity.class));
-            }
-        });
-
-        Button startScatterPlotExButton = (Button) findViewById(R.id.startScatterExButton);
-        startScatterPlotExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, ScatterPlotActivity.class));
-            }
-        });
-
-        Button startSimplePieExButton = (Button) findViewById(R.id.startSimplePieExButton);
-        startSimplePieExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, SimplePieChartActivity.class));
-            }
-        });
-
-        Button startDynamicXYExButton = (Button) findViewById(R.id.startDynamicXYExButton);
-        startDynamicXYExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, DynamicXYPlotActivity.class));
-            }
-        });
-
-        Button startCandlestickExButton = (Button) findViewById(R.id.startCandlestickExButton);
-        startCandlestickExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, CandlestickChartActivity.class));
-            }
-        });
-
-        Button startSimpleXYExButton = (Button) findViewById(R.id.startSimpleXYExButton);
-        startSimpleXYExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, SimpleXYPlotActivity.class));
-            }
-        });
-
-        Button startBarPlotExButton = (Button) findViewById(R.id.startBarPlotExButton);
-        startBarPlotExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, BarPlotExampleActivity.class));
-            }
-        });
-
-        Button startOrSensorExButton = (Button) findViewById(R.id.startOrSensorExButton);
-        startOrSensorExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, OrientationSensorExampleActivity.class));
-            }
-        });
-
-        Button startDualScaleExButton = (Button) findViewById(R.id.startDualScaleExButton);
-        startDualScaleExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, DualScaleActivity.class));
-            }
-        });
-
-        Button startTimeSeriesExButon = (Button) findViewById(R.id.startTimeSeriesExButton);
-        startTimeSeriesExButon.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, TimeSeriesActivity.class));
-            }
-        });
-
-        Button startStepChartExButton = (Button) findViewById(R.id.startStepChartExButton);
-        startStepChartExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, StepChartExampleActivity.class));
-            }
-        });
-
-        Button startScrollZoomExButton = (Button) findViewById(R.id.startScrollZoomButton);
-        startScrollZoomExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, TouchZoomExampleActivity.class));
-            }
-        });
-
-        Button startXyRegionExampleButton = (Button) findViewById(R.id.startXyRegionExampleButton);
-        startXyRegionExampleButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, XYRegionExampleActivity.class));
-            }
-        });
-
-
-        Button listViewExButton = (Button) findViewById(R.id.startXyListViewExButton);
-        listViewExButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, ListViewActivity.class));
-            }
-        });
-
-        Button startXYPlotWithBgImgExampleButton = (Button) findViewById(R.id.startXYPlotWithBgImgExample);
-        startXYPlotWithBgImgExampleButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, XYPlotWithBgImgActivity.class));
-            }
-        });
-
-        // ECG
-        Button startECGExampleButton = (Button) findViewById(R.id.startECGExample);
-        startECGExampleButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, ECGExample.class));
-            }
-        });
-
-        // f(x) plot
-        Button fxPlotExampleButton = (Button) findViewById(R.id.fxPlotExample);
-        fxPlotExampleButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, FXPlotExampleActivity.class));
-            }
-        });
-
-        // bubble chart
-        Button bubbleChartButton = (Button) findViewById(R.id.bubbleChartExample);
-        bubbleChartButton.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View view) {
-                startActivity(new Intent(MainActivity.this, BubbleChartActivity.class));
-            }
-        });
-    }
-}
diff --git a/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
new file mode 100644
index 00000000..6c8320e1
--- /dev/null
+++ b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
@@ -0,0 +1,122 @@
+/*
+ * Copyright 2021 AndroidPlot.com
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package com.androidplot.demos
+
+import android.app.Activity
+import android.os.Bundle
+import com.crittercism.app.Crittercism
+import android.content.Intent
+import android.util.Log
+import com.androidplot.demos.databinding.MainBinding
+
+class MainActivity : Activity() {
+
+    private lateinit var binding: MainBinding
+
+    companion object {
+        private val TAG = MainActivity::class.java.name
+
+        // DO *NOT* CHANGE THIS LINE! (CI-MATCH-POPULATE)
+        private val CRITTERCISM_APP_ID: String? = null
+    }
+
+    public override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        binding = MainBinding.inflate(layoutInflater)
+        if (CRITTERCISM_APP_ID != null) {
+            Log.d(TAG, "Crittercism initialized.")
+            Crittercism.initialize(applicationContext, CRITTERCISM_APP_ID)
+        }
+
+        binding.animatedXYPlotExButton.setOnClickListener {
+            startActivity(Intent(this, AnimatedXYPlotActivity::class.java))
+        }
+
+        binding.startScatterExButton.setOnClickListener {
+            startActivity(Intent(this, ScatterPlotActivity::class.java))
+        }
+
+        binding.startSimplePieExButton.setOnClickListener {
+            startActivity(Intent(this, SimplePieChartActivity::class.java))
+        }
+
+        binding.startDynamicXYExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, DynamicXYPlotActivity::class.java))
+        }
+
+        binding.startCandlestickExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, CandlestickChartActivity::class.java))
+        }
+
+        binding.startSimpleXYExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, SimpleXYPlotActivity::class.java))
+        }
+
+        binding.startBarPlotExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, BarPlotExampleActivity::class.java))
+        }
+
+        binding.startOrSensorExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, OrientationSensorExampleActivity::class.java))
+        }
+
+        binding.startDualScaleExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, DualScaleActivity::class.java))
+        }
+
+        binding.startTimeSeriesExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, TimeSeriesActivity::class.java))
+        }
+
+        binding.startStepChartExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, StepChartExampleActivity::class.java))
+        }
+
+        binding.startScrollZoomButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, TouchZoomExampleActivity::class.java))
+        }
+
+        binding.startXyRegionExampleButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, XYRegionExampleActivity::class.java))
+        }
+
+        binding.startXyListViewExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, ListViewActivity::class.java))
+        }
+
+        binding.startXyRecyclerViewExButton.setOnClickListener {
+            startActivity(Intent(this@MainActivity, RecyclerViewActivity::class.java))
+        }
+
+        binding.startXYPlotWithBgImgExample.setOnClickListener {
+            startActivity(Intent(this@MainActivity, XYPlotWithBgImgActivity::class.java))
+        }
+
+        binding.startECGExample.setOnClickListener {
+            startActivity(Intent(this@MainActivity, ECGExample::class.java))
+        }
+
+        binding.fxPlotExample.setOnClickListener {
+            startActivity(Intent(this@MainActivity, FXPlotExampleActivity::class.java))
+        }
+
+        binding.bubbleChartExample.setOnClickListener {
+            startActivity(Intent(this@MainActivity, BubbleChartActivity::class.java))
+        }
+
+        setContentView(binding.root)
+    }
+}
\ No newline at end of file
diff --git a/demoapp/src/main/java/com/androidplot/demos/RecyclerViewActivity.kt b/demoapp/src/main/java/com/androidplot/demos/RecyclerViewActivity.kt
new file mode 100644
index 00000000..194ee6e0
--- /dev/null
+++ b/demoapp/src/main/java/com/androidplot/demos/RecyclerViewActivity.kt
@@ -0,0 +1,130 @@
+/*
+ * Copyright 2021 AndroidPlot.com
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package com.androidplot.demos
+
+import android.app.Activity
+import android.graphics.Color
+import com.androidplot.ui.SeriesBundle
+import android.os.Bundle
+import android.view.ViewGroup
+import android.view.LayoutInflater
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import com.androidplot.demos.databinding.RecyclerviewExampleBinding
+import com.androidplot.demos.databinding.RecyclerviewExampleItemBinding
+import com.androidplot.util.PixelUtils
+import com.androidplot.xy.*
+import java.util.*
+
+class RecyclerViewActivity : Activity() {
+    private lateinit var binding: RecyclerviewExampleBinding
+
+    companion object {
+        private const val NUM_PLOTS = 10
+        private const val NUM_POINTS_PER_SERIES = 10
+        private const val NUM_SERIES_PER_PLOT = 5
+    }
+
+    public override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        PixelUtils.init(this)
+
+        binding = RecyclerviewExampleBinding.inflate(layoutInflater)
+        setContentView(binding.root)
+
+        binding.recyclerView.setHasFixedSize(true)
+        binding.recyclerView.layoutManager = LinearLayoutManager(this)
+        binding.recyclerView.adapter = MyRecyclerViewAdapter()
+    }
+
+    class MyRecyclerViewHolder(
+        private val binding: RecyclerviewExampleItemBinding
+    ) : RecyclerView.ViewHolder(binding.root) {
+        fun bind(data: List<SeriesBundle<XYSeries, LineAndPointFormatter>>, title: String) {
+            val plot = binding.plot
+            plot.clear()
+            plot.title.text = title
+            data.map { plot.addSeries(it.series, it.formatter) }
+            plot.redraw()
+        }
+    }
+
+    class MyRecyclerViewAdapter : RecyclerView.Adapter<MyRecyclerViewHolder>() {
+        private val seriesData = generateData()
+
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyRecyclerViewHolder {
+            val itemBinding = RecyclerviewExampleItemBinding.inflate(LayoutInflater.from(parent.context), parent, false)
+            return MyRecyclerViewHolder(itemBinding)
+        }
+
+        override fun onBindViewHolder(holder: MyRecyclerViewHolder, position: Int) {
+            holder.bind(seriesData[position], "Series $position")
+        }
+
+        override fun getItemCount() = seriesData.size
+
+        private fun generateData(): List<List<SeriesBundle<XYSeries, LineAndPointFormatter>>> {
+            val theData = mutableListOf<List<SeriesBundle<XYSeries, LineAndPointFormatter>>>()
+            fun generateBundle(seriesLabel: String): SeriesBundle<XYSeries, LineAndPointFormatter> {
+                val generator = Random()
+                val nums = ArrayList<Number>()
+                for (j in 0 until NUM_POINTS_PER_SERIES) {
+                    nums.add(generator.nextFloat())
+                }
+
+                val formatter = LineAndPointFormatter(
+                    Color.rgb(
+                        java.lang.Double.valueOf(Math.random() * 255).toInt(),
+                        java.lang.Double.valueOf(Math.random() * 255).toInt(),
+                        java.lang.Double.valueOf(Math.random() * 255).toInt()
+                    ),
+                    Color.rgb(
+                        java.lang.Double.valueOf(Math.random() * 255).toInt(),
+                        java.lang.Double.valueOf(Math.random() * 255).toInt(),
+                        java.lang.Double.valueOf(Math.random() * 255).toInt()
+                    ),
+                    null, null
+                )
+
+                // for fun, configure interpolation on the formatter:
+                formatter.interpolationParams = CatmullRomInterpolator.Params(
+                    20,
+                    CatmullRomInterpolator.Type.Centripetal
+                )
+
+                return SeriesBundle(
+                    SimpleXYSeries(
+                        nums,
+                        SimpleXYSeries.ArrayFormat.Y_VALS_ONLY,
+                        seriesLabel
+                    ),
+                    formatter
+                )
+            }
+
+            for (i in 0 until NUM_PLOTS) {
+                val seriesList: MutableList<SeriesBundle<XYSeries, LineAndPointFormatter>> =
+                    ArrayList(NUM_SERIES_PER_PLOT)
+
+                for (k in 0 until NUM_SERIES_PER_PLOT) {
+                    seriesList.add(generateBundle("S$k"))
+                }
+                theData.add(seriesList)
+            }
+            return theData
+        }
+    }
+}
\ No newline at end of file
diff --git a/demoapp/src/main/res/layout/main.xml b/demoapp/src/main/res/layout/main.xml
index 590087de..3a2d873f 100644
--- a/demoapp/src/main/res/layout/main.xml
+++ b/demoapp/src/main/res/layout/main.xml
@@ -118,6 +118,13 @@
                 android:text="ListView of XYPlots"
                 android:enabled="true"/>
 
+            <Button
+                android:id="@+id/startXyRecyclerViewExButton"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="RecyclerView of XYPlots"
+                android:enabled="true"/>
+
             <Button
                 android:id="@+id/startXYPlotWithBgImgExample"
                 android:layout_width="match_parent"
diff --git a/demoapp/src/main/res/layout/recyclerview_example.xml b/demoapp/src/main/res/layout/recyclerview_example.xml
new file mode 100644
index 00000000..e92a6f8e
--- /dev/null
+++ b/demoapp/src/main/res/layout/recyclerview_example.xml
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2015 AndroidPlot.com
+  ~
+  ~    Licensed under the Apache License, Version 2.0 (the "License");
+  ~    you may not use this file except in compliance with the License.
+  ~    You may obtain a copy of the License at
+  ~
+  ~        http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~    Unless required by applicable law or agreed to in writing, software
+  ~    distributed under the License is distributed on an "AS IS" BASIS,
+  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~    See the License for the specific language governing permissions and
+  ~    limitations under the License.
+  -->
+
+<LinearLayout android:id="@+id/LinearLayout01"
+              android:layout_width="fill_parent"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_height="fill_parent"
+    android:background="@color/ap_white"
+    android:orientation="vertical">
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/recycler_view"
+        android:layout_weight="1"
+        android:layout_width="match_parent"
+        android:layout_height="0dp" />
+
+</LinearLayout>
\ No newline at end of file
diff --git a/demoapp/src/main/res/layout/recyclerview_example_item.xml b/demoapp/src/main/res/layout/recyclerview_example_item.xml
new file mode 100644
index 00000000..b8392dc9
--- /dev/null
+++ b/demoapp/src/main/res/layout/recyclerview_example_item.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+  ~ Copyright 2015 AndroidPlot.com
+  ~
+  ~    Licensed under the Apache License, Version 2.0 (the "License");
+  ~    you may not use this file except in compliance with the License.
+  ~    You may obtain a copy of the License at
+  ~
+  ~        http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~    Unless required by applicable law or agreed to in writing, software
+  ~    distributed under the License is distributed on an "AS IS" BASIS,
+  ~    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~    See the License for the specific language governing permissions and
+  ~    limitations under the License.
+  -->
+
+<com.androidplot.xy.XYPlot xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:ap="http://schemas.android.com/apk/res-auto"
+    android:id="@+id/plot"
+    style="@style/APDefacto.Light"
+    android:layout_width="fill_parent"
+    android:layout_height="250dp"
+    ap:title="an xy plot" />
\ No newline at end of file
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 2f1853d2..9dde294d 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    implementation "com.androidplot:androidplot-core:1.5.8"
+    implementation "com.androidplot:androidplot-core:1.5.9"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index b67acaff..00a80a5c 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,13 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.9
+* (#107) Fix ambiguous ordinal for render mode attributes
+* (#104) Fix issue with background rendering in RecyclerView.
+* Adds a RecyclerView example to demo app.
+
+# 1.5.8
+* Maintenance release - update dependences, get off jcenter, etc.
 
 # 1.5.7
 * (#94) Potential fix / better error logging for a crash caused by a buffered canvas resize with illegal arguments.

From adf979d88cabe201af7e15f6f933711d61d7968e Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 18:15:30 -0500
Subject: [PATCH 27/48] fix publish step in buildscript

---
 .circleci/config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index bf60104b..35a84a76 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -89,7 +89,7 @@ jobs:
       - deploy:
           name: "Publish"
           command: |
-            if [ "${CIRCLE_BRANCH}" == "project-updates" ];
+            if [ "${CIRCLE_BRANCH}" == "master" ];
               then
                 ./misc/download_google_publisher_json.sh;
                 ./gradlew publish;

From cb114c59fecd2e787611493660dda30597b58248 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 19 Sep 2021 18:19:35 -0500
Subject: [PATCH 28/48] uprev to 1.5.9

---
 build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index 96bd5758..69be2080 100644
--- a/build.gradle
+++ b/build.gradle
@@ -18,7 +18,7 @@ ext {
     theCompileSdkVersion = 30
     theTargetSdkVersion = 30
     theMinSdkVersion = 5
-    theVersionName = '1.5.8'
+    theVersionName = '1.5.9'
     theVersionCode = 1
     gitUrl = 'https://github.com/halfhp/androidplot.git'
 }

From b46fd30f07897e443c21721d411185b42227cd20 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 31 Jul 2022 19:22:07 -0500
Subject: [PATCH 29/48] Release 1.5.10 Changes (#117)

* uprev to 1.5.10
* remove circleci, add github actions build script
* #114 fix setLinesPerRangeLabel & setLinesPerDomainLabel
* fix barchart documentation
---
 .circleci/config.yml                          | 96 -------------------
 .github/workflows/build.yml                   | 53 ++++++++++
 androidplot-core/build.gradle                 |  5 +-
 .../com/androidplot/xy/XYGraphWidget.java     | 35 ++++---
 .../com/androidplot/xy/XYGraphWidgetTest.java | 11 +--
 build.gradle                                  |  7 +-
 demoapp/build.gradle                          |  5 +-
 .../demos/SimpleXYPlotActivity.java           |  2 +
 docs/barchart.md                              |  4 +-
 docs/quickstart.md                            |  2 +-
 docs/release_notes.md                         |  4 +
 gradle/wrapper/gradle-wrapper.properties      |  2 +-
 misc/download_keystore.sh                     |  9 --
 13 files changed, 98 insertions(+), 137 deletions(-)
 delete mode 100644 .circleci/config.yml
 create mode 100644 .github/workflows/build.yml
 delete mode 100755 misc/download_keystore.sh

diff --git a/.circleci/config.yml b/.circleci/config.yml
deleted file mode 100644
index 35a84a76..00000000
--- a/.circleci/config.yml
+++ /dev/null
@@ -1,96 +0,0 @@
-# Java Gradle CircleCI 2.0 configuration file
-#
-# Check https://circleci.com/docs/2.0/language-java/ for more details
-#
-version: 2
-
-general:
-  branches:
-    only:
-      #- circleci
-jobs:
-  build:
-    docker:
-      # specify the version you desire here
-      #- image: circleci/openjdk:8-jdk
-
-      # CircleCI maintains a library of pre-built images
-            # documented at https://circleci.com/docs/2.0/circleci-images/
-      - image: circleci/android:api-30
-
-    working_directory: ~/repo
-
-    environment:
-      # Customize the JVM maximum heap limit
-      JVM_OPTS: -Xmx3200m
-      TERM: dumb
-#      KEYSTORE: ${CIRCLE_WORKING_DIRECTORY}/sigining.keystore
-#      PUBLISHER_ACCT_JSON_FILE: ${CIRCLE_WORKING_DIRECTORY}/publisher_profile.json
-
-    steps:
-      - checkout
-
-      - run: echo 'export KEYSTORE=${HOME}/repo/sigining.keystore' >> $BASH_ENV
-      - run: echo 'export PUBLISHER_ACCT_JSON_FILE=${HOME}/repo/publisher_profile.json' >> $BASH_ENV
-
-      # Download and cache dependencies
-      - restore_cache:
-          keys:
-          - v1-dependencies-{{ checksum "build.gradle" }}
-          # fallback to using the latest cache if no exact match is found
-          - v1-dependencies-
-
-      # Get private keys etc
-      - run: ./misc/download_keystore.sh
-      - run: ./misc/inject_circle_build_number.sh
-
-      - run: ./gradlew dependencies
-
-      - save_cache:
-          paths:
-            - ~/.m2
-          key: v1-dependencies-{{ checksum "build.gradle" }}
-
-      # run tests & code coc!
-      - run: ./gradlew testDebugUnitTest jacocoTestDebugUnitTestReport
-
-      # build release
-      - run: ./gradlew assembleRelease
-
-      # javadoc
-      - run: ./gradlew javadoc
-
-      # trigger codecod.io
-      - run: bash <(curl -s https://codecov.io/bash)
-
-      - store_artifacts:
-          path: androidplot-core/build/outputs/aar/
-          destination: aar
-
-      - store_artifacts:
-          path: demoapp/build/outputs/apk/
-          destination: apk
-
-      - store_artifacts:
-          path: androidplot-core/build/reports/jacoco/debug/
-          destination: coverage_report
-
-      - store_artifacts:
-          path: androidplot-core/build/reports/tests/
-          destination: test_results
-
-      - store_artifacts:
-          path: androidplot-core/build/docs/javadoc
-          destination: javadoc
-
-      - store_test_results:
-          path: androidplot-core/build/test-results/
-
-      - deploy:
-          name: "Publish"
-          command: |
-            if [ "${CIRCLE_BRANCH}" == "master" ];
-              then
-                ./misc/download_google_publisher_json.sh;
-                ./gradlew publish;
-            fi
\ No newline at end of file
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
new file mode 100644
index 00000000..259a938c
--- /dev/null
+++ b/.github/workflows/build.yml
@@ -0,0 +1,53 @@
+name: build androidplot
+on:
+  push:
+    branches:
+      - v1.5.10b # TODO change to master
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Build and Test
+        run: ./gradlew testDebugUnitTest jacocoTestDebugUnitTestReport
+
+      - name: Build Release
+        env:
+          ENCODED: ${{ secrets.DEMOAPP_KEYSTORE }}
+          KEYSTORE: keystore.jks
+          KEY_ALIAS: Key0
+          KEYSTORE_PASSWORD: ${{ secrets.DEMOAPP_KEYSTORE_PASSWORD }}
+          KEY_PASSWORD: ${{ secrets.DEMOAPP_KEY_PASSWORD }}
+        run: |
+          echo $ENCODED | base64 -di > "${GITHUB_WORKSPACE}/demoapp/keystore.jks"
+          ./gradlew assembleRelease
+
+      - name: Javadoc
+        run: ./gradlew javadoc
+
+      - name: Code Coverage
+        run: bash <(curl -s https://codecov.io/bash)
+
+      - uses: actions/upload-artifact@v3
+        with:
+          name: Core Library
+          path: androidplot-core/build/outputs/aar/*.aar
+          retention-days: 30
+
+      - uses: actions/upload-artifact@v3
+        if: github.ref_name == 'master'
+        with:
+          name: Demoapp APK
+          path: demoapp/build/outputs/apk/release/*.apk
+          retention-days: 30
+
+      - name: Stage for Maven Central
+        if: github.ref_name == 'master'
+        env:
+          OSSRH_ACTOR: ${{ secrets.OSSRH_ACTOR }}
+          OSSRH_TOKEN: ${{ secrets.OSSRH_TOKEN }}
+          SIGNING_KEY: ${{ secrets.GPG_SIGNING_KEY }}
+          SIGNING_PASSWORD: ${{ secrets.GPG_SIGNING_PASSWORD }}
+        run: ./gradlew publish
\ No newline at end of file
diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index e81e40a2..c7c4056f 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -74,11 +74,10 @@ android {
             }
         }
     }
-
-    lintOptions {
-        // TODO: enable and address lint issues.
+    lint {
         abortOnError false
     }
+
 }
 
 group = 'com.androidplot'
diff --git a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
index 4f6fa04a..8fa0571f 100644
--- a/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
+++ b/androidplot-core/src/main/java/com/androidplot/xy/XYGraphWidget.java
@@ -564,7 +564,7 @@ protected void doOnDraw(Canvas canvas, RectF widgetRect) {
     }
 
     protected void drawDomainLine(Canvas canvas, float xPix, Number xVal,
-                                  Paint linePaint, boolean isOrigin) {
+                                  Paint linePaint, boolean isOrigin, boolean shouldDrawLabel) {
 
         // lines
         if (linePaint != null) {
@@ -574,12 +574,19 @@ protected void drawDomainLine(Canvas canvas, float xPix, Number xVal,
         }
 
         // labels
-        drawLineLabel(canvas, Edge.TOP, xVal, xPix, labelRect.top, isOrigin);
-        drawLineLabel(canvas, Edge.BOTTOM, xVal, xPix, labelRect.bottom, isOrigin);
+        if(shouldDrawLabel) {
+            if (isLineLabelEnabled(Edge.TOP)) {
+                drawLineLabel(canvas, Edge.TOP, xVal, xPix, labelRect.top, isOrigin);
+            }
+
+            if (isLineLabelEnabled(Edge.BOTTOM)) {
+                drawLineLabel(canvas, Edge.BOTTOM, xVal, xPix, labelRect.bottom, isOrigin);
+            }
+        }
     }
 
     protected void drawRangeLine(Canvas canvas, float yPix, Number yVal,
-                                 Paint linePaint, boolean isOrigin) {
+                                 Paint linePaint, boolean isOrigin, boolean shouldDrawLabel) {
         // lines
         if (linePaint != null) {
             canvas.drawLine(gridRect.left - lineExtensionLeft, yPix,
@@ -587,9 +594,15 @@ protected void drawRangeLine(Canvas canvas, float yPix, Number yVal,
             );
         }
 
-        // labels
-        drawLineLabel(canvas, Edge.LEFT, yVal, labelRect.left, yPix, isOrigin);
-        drawLineLabel(canvas, Edge.RIGHT, yVal, labelRect.right, yPix, isOrigin);
+        if(shouldDrawLabel) {
+            // labels
+            if (isLineLabelEnabled(Edge.LEFT)) {
+                drawLineLabel(canvas, Edge.LEFT, yVal, labelRect.left, yPix, isOrigin);
+            }
+            if (isLineLabelEnabled(Edge.RIGHT)) {
+                drawLineLabel(canvas, Edge.RIGHT, yVal, labelRect.right, yPix, isOrigin);
+            }
+        }
     }
 
     protected void drawLineLabel(Canvas canvas,
@@ -598,9 +611,7 @@ protected void drawLineLabel(Canvas canvas,
                                  float x,
                                  float y,
                                  boolean isOrigin) {
-        if (isLineLabelEnabled(edge)) {
-            getLineLabelRenderer(edge).drawLabel(canvas, getLineLabelStyle(edge), val, x, y, isOrigin);
-        }
+        getLineLabelRenderer(edge).drawLabel(canvas, getLineLabelStyle(edge), val, x, y, isOrigin);
     }
 
     /**
@@ -646,7 +657,7 @@ protected void drawGrid(Canvas canvas) {
             } else {
                 linePaint = domainSubGridLinePaint;
             }
-            drawDomainLine(canvas, (float) xPix, xVal, linePaint, isOrigin);
+            drawDomainLine(canvas, (float) xPix, xVal, linePaint, isOrigin, isMajorTick);
         }
 
         Number rangeOrigin = plot.getRangeOrigin();
@@ -684,7 +695,7 @@ protected void drawGrid(Canvas canvas) {
             } else {
                 linePaint = rangeSubGridLinePaint;
             }
-            drawRangeLine(canvas, (float) yPix, yVal, linePaint, isOrigin);
+            drawRangeLine(canvas, (float) yPix, yVal, linePaint, isOrigin, isMajorTick);
         }
     }
 
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 5a0da878..1d1133dd 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -21,7 +21,6 @@
 
 import com.androidplot.test.*;
 import com.androidplot.ui.*;
-import com.androidplot.util.DisplayDimensions;
 
 import org.junit.*;
 import org.mockito.*;
@@ -29,7 +28,6 @@
 import static junit.framework.Assert.assertEquals;
 import static junit.framework.Assert.assertFalse;
 import static junit.framework.Assert.assertTrue;
-import static junit.framework.Assert.fail;
 import static org.mockito.ArgumentMatchers.anyDouble;
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.anyBoolean;
@@ -202,7 +200,6 @@ public void drawCursorLabel_drawsText() {
 
     @Test
     public void setLineLabelEdges_setsEdges() {
-
         graphWidget.setLineLabelEdges(XYGraphWidget.Edge.LEFT, XYGraphWidget.Edge.BOTTOM);
         assertTrue(graphWidget.isLineLabelEnabled(XYGraphWidget.Edge.LEFT));
         assertTrue(graphWidget.isLineLabelEnabled(XYGraphWidget.Edge.BOTTOM));
@@ -312,10 +309,10 @@ public void setGridInsets_updatesGridRect() {
 
     private void runDrawGridTest() {
         doNothing().when(graphWidget).
-                drawDomainLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
+                drawDomainLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean(), anyBoolean());
 
         doNothing().when(graphWidget).
-                drawRangeLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean());
+                drawRangeLine(any(Canvas.class), anyFloat(), any(Number.class), any(Paint.class), anyBoolean(), anyBoolean());
 
         xyPlot.setRangeBoundaries(0, 100, BoundaryMode.FIXED);
         xyPlot.setDomainBoundaries(0, 100, BoundaryMode.FIXED);
@@ -324,9 +321,9 @@ private void runDrawGridTest() {
 
         // expecting a 100x100 grid to be drawn:
         verify(graphWidget, times(100))
-                .drawDomainLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false));
+                .drawDomainLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false), anyBoolean());
 
         verify(graphWidget, times(100))
-                .drawRangeLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false));
+                .drawRangeLine(eq(canvas), anyFloat(), anyDouble(), any(Paint.class), eq(false), anyBoolean());
     }
 }
diff --git a/build.gradle b/build.gradle
index 69be2080..1850c58e 100644
--- a/build.gradle
+++ b/build.gradle
@@ -18,7 +18,7 @@ ext {
     theCompileSdkVersion = 30
     theTargetSdkVersion = 30
     theMinSdkVersion = 5
-    theVersionName = '1.5.9'
+    theVersionName = '1.5.10'
     theVersionCode = 1
     gitUrl = 'https://github.com/halfhp/androidplot.git'
 }
@@ -26,13 +26,14 @@ ext {
 buildscript {
     repositories {
         mavenCentral()
+        maven { url "https://plugins.gradle.org/m2/" }
         maven { url 'https://s01.oss.sonatype.org/content/repositories/snapshots' }
         google()
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.0.2'
-        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.5-SNAPSHOT'
+        classpath 'com.android.tools.build:gradle:7.2.1'
+        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.5'
     }
 }
 
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index b8b76251..d80c07b6 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -80,11 +80,10 @@ android {
             debuggable true
         }
     }
-
-    lintOptions {
-        // TODO: set to true and address all the lint issues.
+    lint {
         abortOnError false
     }
+
 }
 
 play {
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index db3a5a28..df9799d1 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -88,6 +88,8 @@ public void onCreate(Bundle savedInstanceState)
         // add a new series' to the xyplot:
         plot.addSeries(series1, series1Format);
         plot.addSeries(series2, series2Format);
+        plot.setLinesPerRangeLabel(3);
+        plot.setLinesPerDomainLabel(2);
 
         plot.getGraph().getLineLabelStyle(XYGraphWidget.Edge.BOTTOM).setFormat(new Format() {
             @Override
diff --git a/docs/barchart.md b/docs/barchart.md
index 7da49957..5b384250 100644
--- a/docs/barchart.md
+++ b/docs/barchart.md
@@ -118,14 +118,14 @@ The exact size of the `BarGroup` is specified in pixels and the space between ea
 is dynamically calculated based on that size.
 
 ```java
-barRenderer.setBarWidth(BarRenderer.BarGroupWidthMode.FIXED_WIDTH, PixelUtils.dpToPix(25));
+barRenderer.setBarGroupWidth(BarRenderer.BarGroupWidthMode.FIXED_WIDTH, PixelUtils.dpToPix(25));
 ```
 ##### FIXED_GAP
 The exact size of the "gap" between each `BarGroup` is specified in pixels and the size of each `BarGroup`
 is dynamically calculated based on that spacing.
 
 ```java
-barRenderer.setBarWidth(BarRenderer.BarGroupWidthMode.FIXED_GAP, PixelUtils.dpToPix(5));
+barRenderer.setBarGroupWidth(BarRenderer.BarGroupWidthMode.FIXED_GAP, PixelUtils.dpToPix(5));
 ```
 
 # Example
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 9dde294d..6c0878a2 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    implementation "com.androidplot:androidplot-core:1.5.9"
+    implementation "com.androidplot:androidplot-core:1.5.10"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 00a80a5c..e0c6cb82 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,10 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.10
+* Update project to use latest gradle / build tools
+* (#114) fix `setLinesPerRangeLabel` & `setLinesPerDomainLabel`
+
 # 1.5.9
 * (#107) Fix ambiguous ordinal for render mode attributes
 * (#104) Fix issue with background rendering in RecyclerView.
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 0a24689e..4bde2d74 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-all.zip
diff --git a/misc/download_keystore.sh b/misc/download_keystore.sh
deleted file mode 100755
index 99fd503a..00000000
--- a/misc/download_keystore.sh
+++ /dev/null
@@ -1,9 +0,0 @@
-# use curl to download a keystore from $KEYSTORE_URI, if set,
-# to the path/filename set in $KEYSTORE.
-if [[ $KEYSTORE && ${KEYSTORE} && $KEYSTORE_URI && ${KEYSTORE_URI} ]]
-then
-    echo "Keystore detected - downloading..."
-    curl -L -o ${KEYSTORE} ${KEYSTORE_URI}
-else
-    echo "Keystore uri not set.  .APK artifact will not be signed."
-fi
\ No newline at end of file

From 3b9c2a90d6a233d1d117e8f02b281dc33807109b Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Sun, 31 Jul 2022 19:33:39 -0500
Subject: [PATCH 30/48] build on all pushes

---
 .github/workflows/build.yml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 259a938c..99a0053d 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -1,8 +1,5 @@
 name: build androidplot
-on:
-  push:
-    branches:
-      - v1.5.10b # TODO change to master
+on: [push]
 jobs:
   build-and-test:
     runs-on: ubuntu-latest

From 5d474ad6e774bc701d9cc1eb75b860eceb67bcfd Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 07:01:55 -0500
Subject: [PATCH 31/48] update readme

---
 README.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 42b3f9ea..49d2b78b 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,6 @@
-# ![image](docs/images/aplogo_small.png) Androidplot [![CircleCI](https://circleci.com/gh/halfhp/androidplot.svg?style=shield)](https://circleci.com/gh/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
+# [![AppBrain SDK](https://www.appbrain.com/stats/libraries/shield/appbrain.svg)](https://www.appbrain.com/stats/libraries/details/appbrain/appbrain-sdk) ![image](docs/images/aplogo_small.png) Androidplot [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
 
-A library for creating dynamic and static charts in Android apps. It’s designed from the ground up for Android, 
-compatible with all versions of Android from 1.6 onward and is **used by over 
-[1,000 apps](http://www.appbrain.com/stats/libraries/details/androidplot/androidplot) on Google Play**.
-
-[![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot)
+A library for creating dynamic and static charts in Android apps. Compatible with all versions of Android from 1.6 onward.
 
 If you enjoy the lib, please [rate us on codix.io](http://codix.io/gh/repo/halfhp/androidplot)!
 

From 4ff9a98c309cb9bf5c7f5cb0d0e79e2ecfaa97a1 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 07:02:31 -0500
Subject: [PATCH 32/48] update readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 49d2b78b..e07f36cd 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# [![AppBrain SDK](https://www.appbrain.com/stats/libraries/shield/appbrain.svg)](https://www.appbrain.com/stats/libraries/details/appbrain/appbrain-sdk) ![image](docs/images/aplogo_small.png) Androidplot [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
+# ![image](docs/images/aplogo_small.png) Androidplot [![AppBrain SDK](https://www.appbrain.com/stats/libraries/shield/appbrain.svg)](https://www.appbrain.com/stats/libraries/details/appbrain/appbrain-sdk) [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
 
 A library for creating dynamic and static charts in Android apps. Compatible with all versions of Android from 1.6 onward.
 

From ba09f8fd2fd70767ce5f8c901d90d28e4c66677a Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 07:05:30 -0500
Subject: [PATCH 33/48] update readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e07f36cd..1aafa97c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# ![image](docs/images/aplogo_small.png) Androidplot [![AppBrain SDK](https://www.appbrain.com/stats/libraries/shield/appbrain.svg)](https://www.appbrain.com/stats/libraries/details/appbrain/appbrain-sdk) [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
+# ![image](docs/images/aplogo_small.png) Androidplot [![AndroidPlot](https://www.appbrain.com/stats/libraries/shield/androidplot.svg)](https://www.appbrain.com/stats/libraries/details/androidplot/androidplot) [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
 
 A library for creating dynamic and static charts in Android apps. Compatible with all versions of Android from 1.6 onward.
 

From 89fc2b3f9ec6fab788c0a8637efa8f7d69f56519 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 07:30:36 -0500
Subject: [PATCH 34/48] update readme

---
 README.md                                                    | 5 ++++-
 .../java/com/androidplot/demos/SimpleXYPlotActivity.java     | 2 --
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1aafa97c..9617a26e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,9 @@
 # ![image](docs/images/aplogo_small.png) Androidplot [![AndroidPlot](https://www.appbrain.com/stats/libraries/shield/androidplot.svg)](https://www.appbrain.com/stats/libraries/details/androidplot/androidplot) [![Codix](http://codix.io/gh/badge/halfhp/androidplot)](http://codix.io/gh/repo/halfhp/androidplot) [![codecov](https://codecov.io/gh/halfhp/androidplot/branch/master/graph/badge.svg)](https://codecov.io/gh/halfhp/androidplot) [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/androidplot.svg?style=social&label=Follow%20Us)](https://twitter.com/androidplot)
 
-A library for creating dynamic and static charts in Android apps. Compatible with all versions of Android from 1.6 onward.
+A library for creating dynamic and static charts in Android apps. 
+
+Androidplot is compatible with all versions of Android from 1.6 onward, works equally with Kotlin and Java codebases
+and is compatible with Jetpack compose.
 
 If you enjoy the lib, please [rate us on codix.io](http://codix.io/gh/repo/halfhp/androidplot)!
 
diff --git a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
index df9799d1..db3a5a28 100644
--- a/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
+++ b/demoapp/src/main/java/com/androidplot/demos/SimpleXYPlotActivity.java
@@ -88,8 +88,6 @@ public void onCreate(Bundle savedInstanceState)
         // add a new series' to the xyplot:
         plot.addSeries(series1, series1Format);
         plot.addSeries(series2, series2Format);
-        plot.setLinesPerRangeLabel(3);
-        plot.setLinesPerDomainLabel(2);
 
         plot.getGraph().getLineLabelStyle(XYGraphWidget.Edge.BOTTOM).setFormat(new Format() {
             @Override

From a4d0c32cecb2cf4ed7f9ccf7fe932038472eb1f2 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 07:49:02 -0500
Subject: [PATCH 35/48] remove crittercism, uprev demoapp version code

---
 build.gradle                                              | 2 +-
 demoapp/build.gradle                                      | 1 -
 .../src/main/java/com/androidplot/demos/MainActivity.kt   | 8 --------
 3 files changed, 1 insertion(+), 10 deletions(-)

diff --git a/build.gradle b/build.gradle
index 1850c58e..5796da53 100644
--- a/build.gradle
+++ b/build.gradle
@@ -19,7 +19,7 @@ ext {
     theTargetSdkVersion = 30
     theMinSdkVersion = 5
     theVersionName = '1.5.10'
-    theVersionCode = 1
+    theVersionCode = 226
     gitUrl = 'https://github.com/halfhp/androidplot.git'
 }
 
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index d80c07b6..1506e9ce 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -36,7 +36,6 @@ dependencies {
     implementation "androidx.core:core-ktx:1.6.0"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 	implementation project(':androidplot-core')
-    implementation 'com.crittercism:crittercism-android-agent:5.4.0'
     implementation 'androidx.recyclerview:recyclerview:1.2.1'
 
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
diff --git a/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
index 6c8320e1..b01f3e1c 100644
--- a/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
+++ b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
@@ -17,7 +17,6 @@ package com.androidplot.demos
 
 import android.app.Activity
 import android.os.Bundle
-import com.crittercism.app.Crittercism
 import android.content.Intent
 import android.util.Log
 import com.androidplot.demos.databinding.MainBinding
@@ -28,18 +27,11 @@ class MainActivity : Activity() {
 
     companion object {
         private val TAG = MainActivity::class.java.name
-
-        // DO *NOT* CHANGE THIS LINE! (CI-MATCH-POPULATE)
-        private val CRITTERCISM_APP_ID: String? = null
     }
 
     public override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         binding = MainBinding.inflate(layoutInflater)
-        if (CRITTERCISM_APP_ID != null) {
-            Log.d(TAG, "Crittercism initialized.")
-            Crittercism.initialize(applicationContext, CRITTERCISM_APP_ID)
-        }
 
         binding.animatedXYPlotExButton.setOnClickListener {
             startActivity(Intent(this, AnimatedXYPlotActivity::class.java))

From e0272dad4126bd0441e474898db13dbfcb0c9f0d Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 18:24:49 -0500
Subject: [PATCH 36/48] update dependencies

---
 androidplot-core/build.gradle                 |  4 +-
 build.gradle                                  |  4 +-
 demoapp/build.gradle                          | 10 ++---
 demoapp/src/main/AndroidManifest.xml          | 39 ++++++++++++-------
 .../androidplot/demos/DemoApplication.java    |  8 ----
 .../com/androidplot/demos/MainActivity.kt     |  5 ---
 6 files changed, 33 insertions(+), 37 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index c7c4056f..389a5cfd 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -91,9 +91,9 @@ dependencies {
     implementation 'com.halfhp.fig:figlib:1.0.11'
     implementation 'com.android.support:support-annotations:28.0.0'
 
-    testImplementation "org.mockito:mockito-core:3.9.0"
+    testImplementation "org.mockito:mockito-core:4.0.0"
     testImplementation group: 'junit', name: 'junit', version: '4.13.2'
-    testImplementation "org.robolectric:robolectric:4.5.1"
+    testImplementation "org.robolectric:robolectric:4.7.3"
 }
 
 task javadoc(type: Javadoc) {
diff --git a/build.gradle b/build.gradle
index 5796da53..6360970f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -15,8 +15,8 @@
  */
 
 ext {
-    theCompileSdkVersion = 30
-    theTargetSdkVersion = 30
+    theCompileSdkVersion = 32
+    theTargetSdkVersion = 32
     theMinSdkVersion = 5
     theVersionName = '1.5.10'
     theVersionCode = 226
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index 1506e9ce..8c8c8d2c 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -15,7 +15,7 @@
  */
 
 buildscript {
-    ext.kotlin_version = '1.5.31'
+    ext.kotlin_version = '1.7.10'
     repositories {
         mavenCentral()
     }
@@ -33,16 +33,12 @@ plugins {
 apply plugin: 'kotlin-android'
 
 dependencies {
-    implementation "androidx.core:core-ktx:1.6.0"
+    implementation "androidx.core:core-ktx:1.8.0"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 	implementation project(':androidplot-core')
     implementation 'androidx.recyclerview:recyclerview:1.2.1'
 
-    debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.3'
-
-    releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
-
-    testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.3'
+    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.9.1'
 }
 
 android {
diff --git a/demoapp/src/main/AndroidManifest.xml b/demoapp/src/main/AndroidManifest.xml
index 16245b9f..eaf69362 100644
--- a/demoapp/src/main/AndroidManifest.xml
+++ b/demoapp/src/main/AndroidManifest.xml
@@ -27,76 +27,88 @@
                  android:icon="@drawable/ic_launcher">
 
         <activity android:name=".MainActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="true">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".SimplePieChartActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
         <activity android:name=".AnimatedXYPlotActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
         <activity android:name=".SimpleXYPlotActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".ScatterPlotActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".BarPlotExampleActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
         <activity android:name=".DynamicXYPlotActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
         <activity android:name=".CandlestickChartActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
         <activity android:name=".OrientationSensorExampleActivity"
                   android:label="@string/app_name"
-                  android:screenOrientation="landscape">
+                  android:screenOrientation="landscape"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".StepChartExampleActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".TouchZoomExampleActivity"
-                  android:label="@string/app_name">
+                  android:label="@string/app_name"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity android:name=".ListViewActivity" android:label="ListView Example"/>
         <activity android:name=".RecyclerViewActivity" android:label="RecyclerView Example"/>
-        <activity android:name=".XYRegionExampleActivity" android:label="XYRegion Example">
+        <activity android:name=".XYRegionExampleActivity" android:label="XYRegion Example"
+            android:exported="false">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
@@ -112,7 +124,8 @@
         <receiver
                 android:icon="@drawable/ic_launcher"
                 android:label="Example Widget"
-                android:name="com.androidplot.demos.widget.DemoAppWidgetProvider" >
+                android:name="com.androidplot.demos.widget.DemoAppWidgetProvider"
+            android:exported="false">
             <intent-filter >
                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
             </intent-filter>
diff --git a/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java b/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
index 9c931a73..e5c724c7 100644
--- a/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
+++ b/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
@@ -8,14 +8,6 @@ public class DemoApplication extends Application {
 
     @Override public void onCreate() {
         super.onCreate();
-        initLeakCanary();
-    }
-
-    protected void initLeakCanary() {
-        if (LeakCanary.isInAnalyzerProcess(this)) {
-            return;
-        }
-        LeakCanary.install(this);
     }
 }
 
diff --git a/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
index b01f3e1c..6632af40 100644
--- a/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
+++ b/demoapp/src/main/java/com/androidplot/demos/MainActivity.kt
@@ -18,17 +18,12 @@ package com.androidplot.demos
 import android.app.Activity
 import android.os.Bundle
 import android.content.Intent
-import android.util.Log
 import com.androidplot.demos.databinding.MainBinding
 
 class MainActivity : Activity() {
 
     private lateinit var binding: MainBinding
 
-    companion object {
-        private val TAG = MainActivity::class.java.name
-    }
-
     public override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         binding = MainBinding.inflate(layoutInflater)

From ce9099b31d344c122e1a655e1d7b19a67ee5ed5a Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Mon, 1 Aug 2022 18:33:43 -0500
Subject: [PATCH 37/48] update unit tests to use latest mockito

---
 .../com/androidplot/ui/widget/TextLabelWidgetTest.java    | 6 +++---
 .../test/java/com/androidplot/ui/widget/WidgetTest.java   | 8 ++++----
 .../java/com/androidplot/util/PlotStatisticsTest.java     | 6 +++---
 .../androidplot/xy/AdvanceLineAndPointRendererTest.java   | 1 -
 .../src/test/java/com/androidplot/xy/BarRendererTest.java | 6 +++---
 .../test/java/com/androidplot/xy/BubbleRendererTest.java  | 1 -
 .../java/com/androidplot/xy/CandlestickRendererTest.java  | 1 -
 .../com/androidplot/xy/FastLineAndPointRendererTest.java  | 4 ++--
 .../src/test/java/com/androidplot/xy/LTTBSamplerTest.java | 1 -
 .../java/com/androidplot/xy/LineAndPointRendererTest.java | 1 -
 .../test/java/com/androidplot/xy/XYGraphWidgetTest.java   | 8 ++++----
 .../test/java/com/androidplot/xy/XYLegendWidgetTest.java  | 5 ++---
 .../main/java/com/androidplot/demos/DemoApplication.java  | 2 --
 13 files changed, 21 insertions(+), 29 deletions(-)

diff --git a/androidplot-core/src/test/java/com/androidplot/ui/widget/TextLabelWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/ui/widget/TextLabelWidgetTest.java
index 6ed81b7b..bdb48f92 100644
--- a/androidplot-core/src/test/java/com/androidplot/ui/widget/TextLabelWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/ui/widget/TextLabelWidgetTest.java
@@ -14,9 +14,9 @@
 import org.mockito.InOrder;
 import org.mockito.Mock;
 
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyFloat;
-import static org.mockito.Matchers.eq;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyFloat;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.inOrder;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.spy;
diff --git a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
index ce398dc9..cae6c056 100644
--- a/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/ui/widget/WidgetTest.java
@@ -21,10 +21,10 @@
 import org.mockito.Mockito;
 
 import static junit.framework.Assert.assertEquals;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.ArgumentMatchers.isNull;
 import static org.mockito.ArgumentMatchers.nullable;
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
@@ -94,9 +94,9 @@ public void draw_sizeChanged_invokesOnResizeBeforeDoOnDraw() {
 
         widget.draw(canvas);
 
-        inOrder.verify(widget).onResize(isNull(RectF.class), any(RectF.class));
+        inOrder.verify(widget).onResize(isNull(), any(RectF.class));
         inOrder.verify(widget).doOnDraw(eq(canvas), any(RectF.class));
-        verify(widget).onResize(isNull(RectF.class), any(RectF.class));
+        verify(widget).onResize(isNull(), any(RectF.class));
     }
 
     static class TestWidget extends Widget {
diff --git a/androidplot-core/src/test/java/com/androidplot/util/PlotStatisticsTest.java b/androidplot-core/src/test/java/com/androidplot/util/PlotStatisticsTest.java
index b063235a..4454c69c 100644
--- a/androidplot-core/src/test/java/com/androidplot/util/PlotStatisticsTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/util/PlotStatisticsTest.java
@@ -27,9 +27,9 @@
 import org.mockito.InjectMocks;
 import org.mockito.Mock;
 
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyFloat;
-import static org.mockito.Matchers.anyString;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyFloat;
+import static org.mockito.ArgumentMatchers.anyString;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/AdvanceLineAndPointRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/AdvanceLineAndPointRendererTest.java
index 647882c5..b1600828 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/AdvanceLineAndPointRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/AdvanceLineAndPointRendererTest.java
@@ -24,7 +24,6 @@
 import org.junit.*;
 import org.mockito.*;
 
-import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.*;
 
 /**
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
index e4624d08..08cc1480 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/BarRendererTest.java
@@ -33,9 +33,9 @@
 import java.util.List;
 
 import static junit.framework.Assert.assertEquals;
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyFloat;
-import static org.mockito.Matchers.eq;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyFloat;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.doReturn;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/BubbleRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/BubbleRendererTest.java
index cd0ff2b1..94a0be50 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/BubbleRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/BubbleRendererTest.java
@@ -24,7 +24,6 @@
 import org.junit.*;
 import org.mockito.*;
 
-import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.*;
 
 /**
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/CandlestickRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/CandlestickRendererTest.java
index a7fba775..8eda23b9 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/CandlestickRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/CandlestickRendererTest.java
@@ -24,7 +24,6 @@
 import org.junit.*;
 import org.mockito.*;
 
-import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.*;
 
 public class CandlestickRendererTest extends AndroidplotTest {
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/FastLineAndPointRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/FastLineAndPointRendererTest.java
index de81e70c..cf083d9e 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/FastLineAndPointRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/FastLineAndPointRendererTest.java
@@ -24,8 +24,8 @@
 import org.junit.runner.*;
 import org.mockito.*;
 
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.eq;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/LTTBSamplerTest.java b/androidplot-core/src/test/java/com/androidplot/xy/LTTBSamplerTest.java
index 3269082d..800992f9 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/LTTBSamplerTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/LTTBSamplerTest.java
@@ -27,7 +27,6 @@
 import java.util.*;
 
 import static junit.framework.Assert.assertEquals;
-import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.*;
 
 public class LTTBSamplerTest extends AndroidplotTest {
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/LineAndPointRendererTest.java b/androidplot-core/src/test/java/com/androidplot/xy/LineAndPointRendererTest.java
index 9cb03cd1..44a7b22d 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/LineAndPointRendererTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/LineAndPointRendererTest.java
@@ -26,7 +26,6 @@
 import java.util.*;
 
 import static junit.framework.Assert.assertEquals;
-import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.*;
 
 public class LineAndPointRendererTest extends AndroidplotTest {
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
index 1d1133dd..a9182501 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYGraphWidgetTest.java
@@ -28,11 +28,11 @@
 import static junit.framework.Assert.assertEquals;
 import static junit.framework.Assert.assertFalse;
 import static junit.framework.Assert.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyBoolean;
 import static org.mockito.ArgumentMatchers.anyDouble;
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyBoolean;
-import static org.mockito.Matchers.anyFloat;
-import static org.mockito.Matchers.eq;
+import static org.mockito.ArgumentMatchers.anyFloat;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.doNothing;
 import static org.mockito.Mockito.inOrder;
 import static org.mockito.Mockito.mock;
diff --git a/androidplot-core/src/test/java/com/androidplot/xy/XYLegendWidgetTest.java b/androidplot-core/src/test/java/com/androidplot/xy/XYLegendWidgetTest.java
index b50f7237..778fb40a 100644
--- a/androidplot-core/src/test/java/com/androidplot/xy/XYLegendWidgetTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/xy/XYLegendWidgetTest.java
@@ -32,11 +32,10 @@
 
 import java.util.List;
 
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.eq;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.doReturn;
 import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
diff --git a/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java b/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
index e5c724c7..df3d6117 100644
--- a/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
+++ b/demoapp/src/main/java/com/androidplot/demos/DemoApplication.java
@@ -2,8 +2,6 @@
 
 import android.app.*;
 
-import com.squareup.leakcanary.*;
-
 public class DemoApplication extends Application {
 
     @Override public void onCreate() {

From 7b072e107e6b5efa195b726d1b79053fe4af3174 Mon Sep 17 00:00:00 2001
From: Francisco Salinas Del Riego
 <133713499+fdelriego@users.noreply.github.com>
Date: Thu, 22 Aug 2024 05:05:59 -0700
Subject: [PATCH 38/48] Fix jetifier being required (#122)

This prevents the library from being flagged in Jetifier check build analyzer task. No other changes are needed :) (that I know of)
---
 androidplot-core/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 389a5cfd..7602311b 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -89,7 +89,7 @@ def gitUrl = 'https://github.com/halfhp/androidplot.git'
 dependencies {
 
     implementation 'com.halfhp.fig:figlib:1.0.11'
-    implementation 'com.android.support:support-annotations:28.0.0'
+    implementation 'androidx.annotation:annotation:1.4.0'
 
     testImplementation "org.mockito:mockito-core:4.0.0"
     testImplementation group: 'junit', name: 'junit', version: '4.13.2'

From d47fb53dccd6eff451d98dcb1e37da45e09e555f Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 08:00:37 -0500
Subject: [PATCH 39/48] uprev to 1.5.11

---
 build.gradle          | 2 +-
 docs/quickstart.md    | 2 +-
 docs/release_notes.md | 4 ++++
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index 6360970f..fdbd3e60 100644
--- a/build.gradle
+++ b/build.gradle
@@ -18,7 +18,7 @@ ext {
     theCompileSdkVersion = 32
     theTargetSdkVersion = 32
     theMinSdkVersion = 5
-    theVersionName = '1.5.10'
+    theVersionName = '1.5.11'
     theVersionCode = 226
     gitUrl = 'https://github.com/halfhp/androidplot.git'
 }
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 6c0878a2..3bd87c3d 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -14,7 +14,7 @@ To use the library in your gradle project add the following to your build.gradle
 
 ```groovy
 dependencies {
-    implementation "com.androidplot:androidplot-core:1.5.10"
+    implementation "com.androidplot:androidplot-core:1.5.11"
 }
 ```
 
diff --git a/docs/release_notes.md b/docs/release_notes.md
index e0c6cb82..50d52c11 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -2,6 +2,10 @@
 For details on what to expect in general when updating to a new version of Androiplot, check out the
 [versioning doc](versioning.md).
 
+# 1.5.11
+* Update project to latest gradle / build tools
+* Fix issue with jetifier flagging an outdated dependency
+
 # 1.5.10
 * Update project to use latest gradle / build tools
 * (#114) fix `setLinesPerRangeLabel` & `setLinesPerDomainLabel`

From e2c1bbef640349fb76def7f0f00cf36adab502b4 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 08:15:48 -0500
Subject: [PATCH 40/48] update project files for latest android changes

---
 androidplot-core/build.gradle                 | 1 +
 androidplot-core/src/main/AndroidManifest.xml | 2 +-
 build.gradle                                  | 2 +-
 demoapp/build.gradle                          | 1 +
 demoapp/src/main/AndroidManifest.xml          | 2 +-
 gradle/wrapper/gradle-wrapper.properties      | 2 +-
 6 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 7602311b..acfa2c11 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -77,6 +77,7 @@ android {
     lint {
         abortOnError false
     }
+    namespace 'com.androidplot'
 
 }
 
diff --git a/androidplot-core/src/main/AndroidManifest.xml b/androidplot-core/src/main/AndroidManifest.xml
index e83183d1..3043c930 100644
--- a/androidplot-core/src/main/AndroidManifest.xml
+++ b/androidplot-core/src/main/AndroidManifest.xml
@@ -16,5 +16,5 @@
 
 <!-- This file has been intentionally left empty; values should be
 set in android.defaultConfig in build.gradle wherever possible.-->
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.androidplot">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 </manifest>
\ No newline at end of file
diff --git a/build.gradle b/build.gradle
index fdbd3e60..0e4c8e8c 100644
--- a/build.gradle
+++ b/build.gradle
@@ -32,7 +32,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.2.1'
+        classpath 'com.android.tools.build:gradle:7.4.2'
         classpath 'com.dicedmelon.gradle:jacoco-android:0.1.5'
     }
 }
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index 8c8c8d2c..b5856456 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -78,6 +78,7 @@ android {
     lint {
         abortOnError false
     }
+    namespace 'com.androidplot.demos'
 
 }
 
diff --git a/demoapp/src/main/AndroidManifest.xml b/demoapp/src/main/AndroidManifest.xml
index eaf69362..5b73a2b7 100644
--- a/demoapp/src/main/AndroidManifest.xml
+++ b/demoapp/src/main/AndroidManifest.xml
@@ -15,7 +15,7 @@
   ~    limitations under the License.
   -->
 
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.androidplot.demos">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
     <!-- Used by Crittercism to report crashes -->
     <uses-permission android:name="android.permission.INTERNET"/>
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 4bde2d74..43c64dc4 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip

From 7ef1d0cbcb97879cd733aa16ed82910390cf7fed Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 10:05:07 -0500
Subject: [PATCH 41/48] updates gradle, android plugin, dependencies etc. to
 latest.  also updates to use JDK 17.

---
 androidplot-core/build.gradle            | 36 ++++++++++++++----------
 build.gradle                             |  8 +++---
 demoapp-wearable/build.gradle            |  5 ++--
 demoapp/build.gradle                     | 18 +++++++++---
 demoapp/project.properties               |  2 --
 gradle/wrapper/gradle-wrapper.properties |  2 +-
 6 files changed, 43 insertions(+), 28 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index acfa2c11..36b0ea63 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -16,7 +16,7 @@
 
 plugins {
     id 'com.android.library'
-    id 'com.dicedmelon.gradle.jacoco-android'
+    id 'com.mxalbert.gradle.jacoco-android'
     id 'maven-publish'
     id 'signing'
 }
@@ -58,9 +58,15 @@ task generateAttrsMarkdown(type: AttrMarkdown) {
 }
 
 android {
-    compileSdkVersion theCompileSdkVersion
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
 
     defaultConfig {
+        compileSdk theCompileSdkVersion
         minSdkVersion theMinSdkVersion
         targetSdkVersion theTargetSdkVersion
         testApplicationId "com.androidplot.test"
@@ -90,9 +96,9 @@ def gitUrl = 'https://github.com/halfhp/androidplot.git'
 dependencies {
 
     implementation 'com.halfhp.fig:figlib:1.0.11'
-    implementation 'androidx.annotation:annotation:1.4.0'
+    implementation 'androidx.annotation:annotation:1.8.2'
 
-    testImplementation "org.mockito:mockito-core:4.0.0"
+    testImplementation "org.mockito:mockito-core:5.7.0"
     testImplementation group: 'junit', name: 'junit', version: '4.13.2'
     testImplementation "org.robolectric:robolectric:4.7.3"
 }
@@ -110,12 +116,12 @@ task javadoc(type: Javadoc) {
 }
 
 task javadocJar(type: Jar, dependsOn: javadoc) {
-    classifier = 'javadoc'
+    archiveClassifier.set('javadoc')
     from javadoc.destinationDir
 }
 
 task sourcesJar(type: Jar) {
-    classifier = 'sources'
+    archiveClassifier.set('sources')
     from android.sourceSets.main.java.srcDirs
 }
 
@@ -137,9 +143,11 @@ afterEvaluate {
         }
 
         publications {
-            release(MavenPublication) {
 
-                from components.release
+            publications.withType(MavenPublication) {
+//            release(MavenPublication) {
+//
+//                from components.release
 
                 // You can then customize attributes of the publication as shown below.
                 groupId = 'com.androidplot'
@@ -176,13 +184,11 @@ afterEvaluate {
     }
 }
 
-afterEvaluate {
-    signing {
-        def signingKey = System.getenv("SIGNING_KEY")
-        def signingPassword = System.getenv("SIGNING_PASSWORD")
-        useInMemoryPgpKeys(signingKey, signingPassword)
-        sign publishing.publications.release
-    }
+signing {
+    def signingKey = System.getenv("SIGNING_KEY")
+    def signingPassword = System.getenv("SIGNING_PASSWORD")
+    useInMemoryPgpKeys(signingKey, signingPassword)
+    sign publishing.publications
 }
 
 artifacts {
diff --git a/build.gradle b/build.gradle
index 0e4c8e8c..d1140299 100644
--- a/build.gradle
+++ b/build.gradle
@@ -15,8 +15,8 @@
  */
 
 ext {
-    theCompileSdkVersion = 32
-    theTargetSdkVersion = 32
+    theCompileSdkVersion = 34
+    theTargetSdkVersion = 34
     theMinSdkVersion = 5
     theVersionName = '1.5.11'
     theVersionCode = 226
@@ -32,8 +32,8 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.4.2'
-        classpath 'com.dicedmelon.gradle:jacoco-android:0.1.5'
+        classpath 'com.android.tools.build:gradle:8.5.2'
+        classpath 'com.mxalbert.gradle:jacoco-android:0.2.0'
     }
 }
 
diff --git a/demoapp-wearable/build.gradle b/demoapp-wearable/build.gradle
index 3bfc0ee0..666b353e 100644
--- a/demoapp-wearable/build.gradle
+++ b/demoapp-wearable/build.gradle
@@ -38,9 +38,10 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_1_6
-        targetCompatibility JavaVersion.VERSION_1_6
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
+
     buildTypes {
         release {
             minifyEnabled false
diff --git a/demoapp/build.gradle b/demoapp/build.gradle
index b5856456..2c2fbd52 100644
--- a/demoapp/build.gradle
+++ b/demoapp/build.gradle
@@ -15,7 +15,7 @@
  */
 
 buildscript {
-    ext.kotlin_version = '1.7.10'
+    ext.kotlin_version = '2.0.0'
     repositories {
         mavenCentral()
     }
@@ -33,15 +33,25 @@ plugins {
 apply plugin: 'kotlin-android'
 
 dependencies {
-    implementation "androidx.core:core-ktx:1.8.0"
+    implementation "androidx.core:core-ktx:1.13.1"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 	implementation project(':androidplot-core')
-    implementation 'androidx.recyclerview:recyclerview:1.2.1'
+    implementation 'androidx.recyclerview:recyclerview:1.3.2'
 
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.9.1'
 }
 
+kotlin {
+    jvmToolchain(17)
+}
+
 android {
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
     compileSdkVersion theCompileSdkVersion
 
     buildFeatures {
@@ -51,7 +61,7 @@ android {
     defaultConfig {
         versionCode theVersionCode
         versionName theVersionName
-        minSdkVersion 14
+        minSdkVersion 19
         targetSdkVersion theTargetSdkVersion
         applicationId "com.androidplot.demos"
     }
diff --git a/demoapp/project.properties b/demoapp/project.properties
index 29656f2d..90a2cb18 100644
--- a/demoapp/project.properties
+++ b/demoapp/project.properties
@@ -39,5 +39,3 @@
 #proguard.config=${sdk.dir}\tools\proguard\proguard-android.txt:proguard-project.txt
 # using config with optimization enabled so that things like log statement removal will work:
 proguard.config=${sdk.dir}/tools/proguard/proguard-android-optimize.txt:proguard-project.txt
-# Project target.
-target=android-16
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 43c64dc4..e9defc20 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip

From 01e338e4540918831b7f8d773efec37113b3ba40 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 10:07:05 -0500
Subject: [PATCH 42/48] pull in jdk 17 in build scrip

---
 .github/workflows/build.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 99a0053d..afbda48e 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -7,6 +7,12 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v3
 
+      - name: Set Up JDK 17
+        uses: actions/setup-java@v2
+        with:
+          distribution: 'adopt'
+          java-version: '17'
+
       - name: Build and Test
         run: ./gradlew testDebugUnitTest jacocoTestDebugUnitTestReport
 

From 04e819db59a94ba1c386341973f6c1ff1311c29b Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 10:16:27 -0500
Subject: [PATCH 43/48] Fix broken tests

---
 .../src/test/java/com/androidplot/PlotTest.java        | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/androidplot-core/src/test/java/com/androidplot/PlotTest.java b/androidplot-core/src/test/java/com/androidplot/PlotTest.java
index 5a750afd..9e4753bf 100644
--- a/androidplot-core/src/test/java/com/androidplot/PlotTest.java
+++ b/androidplot-core/src/test/java/com/androidplot/PlotTest.java
@@ -34,6 +34,7 @@
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 
@@ -44,7 +45,8 @@ public class PlotTest extends AndroidplotTest {
 
     @Test
     public void testInit_withoutAttrs() {
-        Plot plot = mock(Plot.class);
+        //Plot plot = mock(Plot.class);
+        Plot plot = spy(new MockPlot("MockPlot"));
         plot.init(RuntimeEnvironment.application, null, 0);
 
         verify(plot, times(1)).onPreInit();
@@ -53,10 +55,12 @@ public void testInit_withoutAttrs() {
 
     @Test
     public void testInit_withAttrs() {
-        Plot plot = new MockPlot("MockPlot");
+        Plot plot = spy(new MockPlot("MockPlot"));
         AttributeSet attrs = mock(AttributeSet.class);
         plot.init(RuntimeEnvironment.application, attrs, 0);
-        // TODO: verifications
+
+        verify(plot, times(1)).onPreInit();
+        verify(plot, times(1)).onAfterConfig();
     }
 
     @Test

From b8b3837de953fcac8f15767cf5ef9002fbac9ce1 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 10:34:18 -0500
Subject: [PATCH 44/48] temporarily disable javadoc artifacts

---
 .github/workflows/build.yml   |  5 ++--
 androidplot-core/build.gradle | 43 +++++++++++++++++++----------------
 docs/index.md                 |  4 +++-
 3 files changed, 29 insertions(+), 23 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index afbda48e..d38f337e 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -27,8 +27,9 @@ jobs:
           echo $ENCODED | base64 -di > "${GITHUB_WORKSPACE}/demoapp/keystore.jks"
           ./gradlew assembleRelease
 
-      - name: Javadoc
-        run: ./gradlew javadoc
+# TODO: get javadoc working again at some point
+#      - name: Javadoc
+#        run: ./gradlew javadoc
 
       - name: Code Coverage
         run: bash <(curl -s https://codecov.io/bash)
diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 36b0ea63..af0adb66 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -103,31 +103,33 @@ dependencies {
     testImplementation "org.robolectric:robolectric:4.7.3"
 }
 
-task javadoc(type: Javadoc) {
-    source = android.sourceSets.main.java.srcDirs
-    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
-    failOnError false
-    options {
-        links "http://docs.oracle.com/javase/7/docs/api/"
-        linksOffline "http://d.android.com/reference","${android.sdkDirectory}/docs/reference"
-    }
-    exclude '**/BuildConfig.java'
-    exclude '**/R.java'
-}
-
-task javadocJar(type: Jar, dependsOn: javadoc) {
-    archiveClassifier.set('javadoc')
-    from javadoc.destinationDir
-}
+// TODO: get javadoc working again at some point
+//task javadoc(type: Javadoc) {
+//    source = android.sourceSets.main.java.srcDirs
+//    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
+//    failOnError false
+//    options {
+//        links "http://docs.oracle.com/javase/7/docs/api/"
+//        linksOffline "http://d.android.com/reference","${android.sdkDirectory}/docs/reference"
+//    }
+//    exclude '**/BuildConfig.java'
+//    exclude '**/R.java'
+//}
+//
+//task javadocJar(type: Jar, dependsOn: javadoc) {
+//    archiveClassifier.set('javadoc')
+//    from javadoc.destinationDir
+//}
 
 task sourcesJar(type: Jar) {
     archiveClassifier.set('sources')
     from android.sourceSets.main.java.srcDirs
 }
 
-javadoc {
-    options.overview = "src/main/java/overview.html"
-}
+// TODO: get javadoc working again at some point
+//javadoc {
+//    options.overview = "src/main/java/overview.html"
+//}
 
 afterEvaluate {
     publishing {
@@ -192,6 +194,7 @@ signing {
 }
 
 artifacts {
-    archives javadocJar
+    // TODO: get javadoc working again at some point
+//    archives javadocJar
     archives sourcesJar
 }
diff --git a/docs/index.md b/docs/index.md
index 4959db92..90a8a021 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -42,7 +42,9 @@ Source code examples of the various plot types.
 # XML Attributes
 A complete list of XML attributes is [available here](attrs.md).
 # Javadoc
-The latest Javadocs are [available here](https://javadoc.io/doc/com.androidplot/androidplot-core).
+Javadocs for versions through 1.5.7 are [available here](https://javadoc.io/doc/com.androidplot/androidplot-core).  Due to a build issue
+producing Javadocs for the latest releases has been paused.  There have been very
+few changes to the API since 1.5.7 so the Javadocs should still be useful in the mean time.
 
 # Release Notes
 Full release notes are [available here](release_notes.md)

From de72e9c24704f8d325c01aa5d45a5fccf9a4ee5b Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 11:17:51 -0500
Subject: [PATCH 45/48] uprev version code for demo app publishing

---
 build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index d1140299..4b5e18de 100644
--- a/build.gradle
+++ b/build.gradle
@@ -19,7 +19,7 @@ ext {
     theTargetSdkVersion = 34
     theMinSdkVersion = 5
     theVersionName = '1.5.11'
-    theVersionCode = 226
+    theVersionCode = 227
     gitUrl = 'https://github.com/halfhp/androidplot.git'
 }
 

From 1e11eb2683ee3b746664564f2fd64ba7c4d22576 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 11:33:10 -0500
Subject: [PATCH 46/48] fix mavencentral publishing

---
 androidplot-core/build.gradle | 110 ++++++++++++++++++----------------
 1 file changed, 58 insertions(+), 52 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index af0adb66..4d7cf020 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -31,13 +31,14 @@ class AttrMarkdown extends DefaultTask {
         def input = project.file(inFile)
 
         def output = project.file(outFile)
-        if(output.exists()) {
+        if (output.exists()) {
             output.delete()
         }
         output.parentFile.mkdirs()
 
-        input.text.findAll(/<!--\n?([\s\S]*?)\n?-->/) { match, g1 -> g1
-            if(!g1.startsWith("NODOC")) {
+        input.text.findAll(/<!--\n?([\s\S]*?)\n?-->/) { match, g1 ->
+            g1
+            if (!g1.startsWith("NODOC")) {
                 output.append(g1)
                 output.append "\n\n"
             }
@@ -53,7 +54,7 @@ class AttrMarkdown extends DefaultTask {
  * The generated doc will appear in / replace androidplot/docs/attrs.md
  */
 task generateAttrsMarkdown(type: AttrMarkdown) {
-    inFile = { "src/main/res/values/attrs.xml"}
+    inFile = { "src/main/res/values/attrs.xml" }
     outFile = { "../docs/attrs.md" }
 }
 
@@ -85,6 +86,13 @@ android {
     }
     namespace 'com.androidplot'
 
+    publishing {
+        singleVariant("release") {
+            //withSourcesJar()
+            //withJavadocJar()
+        }
+    }
+
 }
 
 group = 'com.androidplot'
@@ -121,65 +129,63 @@ dependencies {
 //    from javadoc.destinationDir
 //}
 
-task sourcesJar(type: Jar) {
-    archiveClassifier.set('sources')
-    from android.sourceSets.main.java.srcDirs
-}
+//task sourcesJar(type: Jar) {
+//    archiveClassifier.set('sources')
+//    from android.sourceSets.main.java.srcDirs
+//}
 
 // TODO: get javadoc working again at some point
 //javadoc {
 //    options.overview = "src/main/java/overview.html"
 //}
 
-afterEvaluate {
-    publishing {
-        repositories {
-            maven {
-                name = "Maven Central"
-                url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
-                credentials {
-                    username = System.getenv("OSSRH_ACTOR")
-                    password = System.getenv("OSSRH_TOKEN")
-                }
+publishing {
+    repositories {
+        maven {
+            name = "MavenCentral"
+            url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+            credentials {
+                username = System.getenv("OSSRH_ACTOR")
+                password = System.getenv("OSSRH_TOKEN")
             }
         }
+    }
 
-        publications {
+    publications {
 
-            publications.withType(MavenPublication) {
+        publications.withType(MavenPublication) {
 //            release(MavenPublication) {
 //
 //                from components.release
 
-                // You can then customize attributes of the publication as shown below.
-                groupId = 'com.androidplot'
-                artifactId = 'androidplot-core'
-                version = theVersionName
-
-                pom {
-                    packaging 'aar'
-                    name = 'Androidplot'
-                    description = "Configure any object from XML."
-                    url = gitUrl
-                    licenses {
-                        license {
-                            name = 'The Apache Software License, Version 2.0'
-                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
-                        }
+            // You can then customize attributes of the publication as shown below.
+            groupId = 'com.androidplot'
+            artifactId = 'androidplot-core'
+            version = theVersionName
+
+            pom {
+                packaging 'aar'
+                name = 'Androidplot'
+                description = "Configure any object from XML."
+                url = gitUrl
+                licenses {
+                    license {
+                        name = 'The Apache Software License, Version 2.0'
+                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                     }
-                    developers {
-                        developer {
-                            id = 'halfhp'
-                            name = 'Nick Fellows'
-                            email = 'halfhp@gmail.com'
-                        }
+                }
+                developers {
+                    developer {
+                        id = 'halfhp'
+                        name = 'Nick Fellows'
+                        email = 'halfhp@gmail.com'
                     }
-                    scm {
-                        connection = gitUrl
-                        developerConnection = gitUrl
-                        url = gitUrl
+                }
+                scm {
+                    connection = gitUrl
+                    developerConnection = gitUrl
+                    url = gitUrl
 
-                    }
                 }
             }
         }
@@ -190,11 +196,11 @@ signing {
     def signingKey = System.getenv("SIGNING_KEY")
     def signingPassword = System.getenv("SIGNING_PASSWORD")
     useInMemoryPgpKeys(signingKey, signingPassword)
-    sign publishing.publications
+    sign(publishing.publications)
 }
 
-artifacts {
-    // TODO: get javadoc working again at some point
-//    archives javadocJar
-    archives sourcesJar
-}
+//artifacts {
+//    // TODO: get javadoc working again at some point
+////    archives javadocJar
+//    archives sourcesJar
+//}

From a9f065fbbe20fabcf198a95b4777533ce365572f Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 12:25:24 -0500
Subject: [PATCH 47/48] fix mavencentral publishing

---
 androidplot-core/build.gradle | 83 ++++++++++++++++++-----------------
 1 file changed, 42 insertions(+), 41 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 4d7cf020..7063e0c9 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -88,11 +88,12 @@ android {
 
     publishing {
         singleVariant("release") {
+            withSourcesJar()
+            withJavadocJar()
             //withSourcesJar()
             //withJavadocJar()
         }
     }
-
 }
 
 group = 'com.androidplot'
@@ -139,53 +140,53 @@ dependencies {
 //    options.overview = "src/main/java/overview.html"
 //}
 
-publishing {
-    repositories {
-        maven {
-            name = "MavenCentral"
-            url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
-            credentials {
-                username = System.getenv("OSSRH_ACTOR")
-                password = System.getenv("OSSRH_TOKEN")
+afterEvaluate {
+    publishing {
+        repositories {
+            maven {
+                name = "MavenCentral"
+                url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+                credentials {
+                    username = System.getenv("OSSRH_ACTOR")
+                    password = System.getenv("OSSRH_TOKEN")
+                }
             }
         }
-    }
 
-    publications {
-
-        publications.withType(MavenPublication) {
+        publications {
+            release(MavenPublication) {
 //            release(MavenPublication) {
 //
-//                from components.release
-
-            // You can then customize attributes of the publication as shown below.
-            groupId = 'com.androidplot'
-            artifactId = 'androidplot-core'
-            version = theVersionName
-
-            pom {
-                packaging 'aar'
-                name = 'Androidplot'
-                description = "Configure any object from XML."
-                url = gitUrl
-                licenses {
-                    license {
-                        name = 'The Apache Software License, Version 2.0'
-                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                from components.release
+
+                // You can then customize attributes of the publication as shown below.
+                groupId = 'com.androidplot'
+                artifactId = 'androidplot-core'
+                version = theVersionName
+
+                pom {
+                    packaging 'aar'
+                    name = 'Androidplot'
+                    description = "Configure any object from XML."
+                    url = gitUrl
+                    licenses {
+                        license {
+                            name = 'The Apache Software License, Version 2.0'
+                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                        }
                     }
-                }
-                developers {
-                    developer {
-                        id = 'halfhp'
-                        name = 'Nick Fellows'
-                        email = 'halfhp@gmail.com'
+                    developers {
+                        developer {
+                            id = 'halfhp'
+                            name = 'Nick Fellows'
+                            email = 'halfhp@gmail.com'
+                        }
+                    }
+                    scm {
+                        connection = gitUrl
+                        developerConnection = gitUrl
+                        url = gitUrl
                     }
-                }
-                scm {
-                    connection = gitUrl
-                    developerConnection = gitUrl
-                    url = gitUrl
-
                 }
             }
         }

From 2a15eed4decc4f4b9a604f302068d6de4b055e01 Mon Sep 17 00:00:00 2001
From: Nick Fellows <halfhp@gmail.com>
Date: Thu, 22 Aug 2024 12:38:31 -0500
Subject: [PATCH 48/48] cleanup

---
 androidplot-core/build.gradle | 18 ------------------
 1 file changed, 18 deletions(-)

diff --git a/androidplot-core/build.gradle b/androidplot-core/build.gradle
index 7063e0c9..b37b2b4a 100644
--- a/androidplot-core/build.gradle
+++ b/androidplot-core/build.gradle
@@ -90,8 +90,6 @@ android {
         singleVariant("release") {
             withSourcesJar()
             withJavadocJar()
-            //withSourcesJar()
-            //withJavadocJar()
         }
     }
 }
@@ -125,15 +123,7 @@ dependencies {
 //    exclude '**/R.java'
 //}
 //
-//task javadocJar(type: Jar, dependsOn: javadoc) {
-//    archiveClassifier.set('javadoc')
-//    from javadoc.destinationDir
-//}
 
-//task sourcesJar(type: Jar) {
-//    archiveClassifier.set('sources')
-//    from android.sourceSets.main.java.srcDirs
-//}
 
 // TODO: get javadoc working again at some point
 //javadoc {
@@ -155,8 +145,6 @@ afterEvaluate {
 
         publications {
             release(MavenPublication) {
-//            release(MavenPublication) {
-//
                 from components.release
 
                 // You can then customize attributes of the publication as shown below.
@@ -199,9 +187,3 @@ signing {
     useInMemoryPgpKeys(signingKey, signingPassword)
     sign(publishing.publications)
 }
-
-//artifacts {
-//    // TODO: get javadoc working again at some point
-////    archives javadocJar
-//    archives sourcesJar
-//}