Updated pod spec change log and read me

Multiple Line Support & Tooltips

CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.1.2">2.1.2</a> 
+#### 04/02/14
+- Added dynamic padding to JBLineChartView (based on max line width).
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.1.1">2.1.1</a> 
+#### 04/02/14
+- Fixed minimumValue and maximumValue getter functions.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.1.0">2.1.0</a> 
+#### 03/30/14
+- Added minimumValue and maximumValue properties. 
+- Changed default min value implementation from 0 to chart's actual minimum value.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.0.2">2.0.2</a> 
+#### 03/27/14
+- Added the ability to add point dots for lines in JBLineChartView.
+- Streamlined line styling. 
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.0.1">2.0.1</a> 
+#### 03/19/14
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/22">#22</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v2.0.0">2.0.0</a> 
+#### 03/18/14
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/21">#21</a>.
+- Added multi-line support for JBLineChartView.
+- Added position delegation on touch events. 
+- Added tooltip views (demo-only).
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.6">1.1.6</a>
+#### 03/02/14
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/15">#15</a>.
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/14">#14</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.5">1.1.5</a>
+#### 02/11/14
+- Chart selection improvements.
+- Animation performance improvements. 
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.4">1.1.4</a>
+#### 02/06/14
+- Fixed compilation warnings.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.3">1.1.3</a>
+#### 01/06/14
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/11">#11</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.2">1.1.2</a>
+#### 01/03/14
+- Added CGFloat support for chart heights intead of integers. 
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.1">1.1.1</a>
+#### 01/02/14
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/7">#7</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.1.0">1.1.0</a>
+#### 12/26/13
+- Updated JBBarChartView datasource to request UIView subclasses for bars. 
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.0.3">1.0.3</a>
+#### 12/23/13
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/4">#4</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.0.2">1.0.2</a>
+#### 12/17/13
+- Additional fixes for issue <a href="https://github.com/Jawbone/JBChartView/pull/2">#2</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.0.1">1.0.1</a>
+#### (12/14/13)
+- Fixes issue <a href="https://github.com/Jawbone/JBChartView/pull/2">#2</a>.
+
+## <a href="https://github.com/Jawbone/JBChartView/tree/v1.0">1.0</a>
+#### 12/10/13
+- Initial public release.
+- Base line and bar charts.
+- Basic customization; color, positioning, selections.

Classes/JBBarChartView.h

@@ -18,11 +18,11 @@
 @property (nonatomic, weak) id<JBBarChartViewDataSource> dataSource;
 
 /**
- *  If showsSelection is YES, a vertical highlight will overlayed on a bar during touch events.
- *  
- *  Default: YES
+ *  Vertical highlight overlayed on bar during touch events.
+ *
+ *  Default: YES.
  */
-@property (nonatomic, assign) BOOL showsSelection;
+@property (nonatomic, assign) BOOL showsVerticalSelection;
 
 @end
 
@@ -34,32 +34,33 @@
  *  Height for a bar at a given index (left to right). There is no ceiling on the the height; 
  *  the chart will automatically normalize all values between the overal min and max heights.
  *
- *  @param barChartView The origin chart
- *  @param index        The 0-based index of a given bar (left to right, x-axis)
+ *  @param barChartView     The bar chart object requesting this information.
+ *  @param index            The 0-based index of a given bar (left to right, x-axis).
  *
  *  @return The y-axis height of the supplied bar index (x-axis)
  */
-- (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSInteger)index;
+- (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSUInteger)index;
 
 @optional
 
 /**
- *  Occurs when a touch gesture event occurs on a given bar. The chart must be expanded, showsSelection must be YES,
+ *  Occurs when a touch gesture event occurs on a given bar (chart must be expanded).
  *  and the selection must occur within the bounds of the chart.
  *
- *  @param barChartView The origin chart
- *  @param index        The 0-based index of a given bar (left to right, x-axis)
+ *  @param barChartView     A bar chart object informing the delegate about the new selection.
+ *  @param index            The 0-based index of a given bar (left to right, x-axis).
+ *  @param touchPoint       The touch point in relation to the chart's bounds (excludes footer and header).
  */
-- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSInteger)index;
+- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSUInteger)index touchPoint:(CGPoint)touchPoint;
+- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSUInteger)index;
 
 /**
  *  Occurs when selection ends by either ending a touch event or selecting an area that is outside the view's bounds.
  *  For selection start events, see: didSelectBarAtIndex...
  *
- *  @param barChartView The origin chart
- *  @param index        The 0-based index of a given bar. Index will be -1 if the touch ends outside of the view's bounds. 
+ *  @param barChartView     A bar chart object informing the delegate about the unselection.
  */
-- (void)barChartView:(JBBarChartView *)barChartView didUnselectBarAtIndex:(NSInteger)index;
+- (void)didUnselectBarChartView:(JBBarChartView *)barChartView;
 
 @end
 
@@ -70,11 +71,11 @@
 /**
  *  The number of bars in a given bar chart is the number of vertical views shown along the x-axis.
  *
- *  @param barChartView The origin chart
+ *  @param barChartView     The bar chart object requesting this information.
  *
  *  @return Number of bars in the given chart, displayed horizontally along the chart's x-axis.
  */
-- (NSInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView;
+- (NSUInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView;
 
 @optional
 
@@ -83,34 +84,35 @@
  *
  *  Default: 'best-guess' algorithm based on the the total number of bars and width of the chart.
  *
- *  @param barChartView The origin chart
+ *  @param barChartView     The bar chart object requesting this information.
  *
  *  @return Horizontal width (in pixels) between each bar.
  */
-- (NSInteger)barPaddingForBarChartView:(JBBarChartView *)barChartView;
+- (NSUInteger)barPaddingForBarChartView:(JBBarChartView *)barChartView;
 
 /**
  *  A UIView subclass representing the bar at a particular index.
  *
- *  Default: solid black UIView
+ *  Default: solid black UIView.
  *
- *  @param barChartView The origin chart
- *  @param index        The 0-based index of a given bar (left to right, x-axis)
+ *  @param barChartView     The bar chart object requesting this information.
+ *  @param index            The 0-based index of a given bar (left to right, x-axis).
  *
  *  @return A UIView subclass. The view will automatically be resized by the chart during creation (ie. no need to set the frame).
  */
-- (UIView *)barViewForBarChartView:(JBBarChartView *)barChartView atIndex:(NSInteger)index;
+- (UIView *)barChartView:(JBBarChartView *)barChartView barViewAtIndex:(NSUInteger)index;
 
 /**
  *  The selection color to be overlayed on a bar during touch events. 
- *  The color is automically faded to transparent (vertically).
+ *  The color is automically faded to transparent (vertically). The property showsVerticalSelection
+ *  must be YES for the color to apply.
  *
- *  Default: white color (faded to transparent)
+ *  Default: white color (faded to transparent).
  *
- *  @param barChartView The origin chart
+ *  @param barChartView     The bar chart object requesting this information.
  *
  *  @return The color to be used on each bar selection.
  */
-- (UIColor *)selectionBarColorForBarChartView:(JBBarChartView *)barChartView;
+- (UIColor *)barSelectionColorForBarChartView:(JBBarChartView *)barChartView;
 
 @end

Classes/JBBarChartView.m

@@ -10,7 +10,7 @@
 
 // Numerics
 CGFloat static const kJBBarChartViewBarBasePaddingMutliplier = 50.0f;
-CGFloat static const kJBBarChartViewUndefinedMaxHeight = -1.0f;
+CGFloat static const kJBBarChartViewUndefinedCachedHeight = -1.0f;
 CGFloat static const kJBBarChartViewStateAnimationDuration = 0.05f;
 CGFloat static const kJBBarChartViewPopOffset = 10.0f; // used to offset bars for 'pop' animations
 NSInteger static const kJBBarChartViewUndefinedBarIndex = -1;
@@ -24,24 +24,29 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
 @property (nonatomic, strong) NSArray *barViews;
 @property (nonatomic, assign) CGFloat barPadding;
 @property (nonatomic, assign) CGFloat cachedMaxHeight;
-@property (nonatomic, strong) JBChartSelectionView *selectionView;
-@property (nonatomic, assign) BOOL selectionViewVisible;
+@property (nonatomic, assign) CGFloat cachedMinHeight;
+@property (nonatomic, strong) JBChartVerticalSelectionView *verticalSelectionView;
+@property (nonatomic, assign) BOOL verticalSelectionViewVisible;
+
+// Initialization
+- (void)construct;
 
 // View quick accessors
 - (CGFloat)availableHeight;
 - (CGFloat)normalizedHeightForRawHeight:(NSNumber*)rawHeight;
-- (CGFloat)maxHeight;
 - (CGFloat)minHeight;
+- (CGFloat)maxHeight;
 - (CGFloat)barWidth;
 - (CGFloat)popOffset;
 
 // Touch helpers
 - (NSInteger)barViewIndexForPoint:(CGPoint)point;
 - (UIView *)barViewForForPoint:(CGPoint)point;
+- (void)touchesBeganOrMovedWithTouches:(NSSet *)touches;
 - (void)touchesEndedOrCancelledWithTouches:(NSSet *)touches;
 
 // Setters
-- (void)setSelectionViewVisible:(BOOL)selectionViewVisible animated:(BOOL)animated;
+- (void)setVerticalSelectionViewVisible:(BOOL)verticalSelectionViewVisible animated:(BOOL)animated;
 
 @end
 
@@ -57,18 +62,43 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
 	}
 }
 
+- (id)initWithCoder:(NSCoder *)aDecoder
+{
+    self = [super initWithCoder:aDecoder];
+    if (self)
+    {
+        [self construct];
+    }
+    return self;
+}
+
 - (id)initWithFrame:(CGRect)frame
 {
     self = [super initWithFrame:frame];
     if (self)
     {
-        self.clipsToBounds = NO;
-        _showsSelection = YES;
-        _cachedMaxHeight = kJBBarChartViewUndefinedMaxHeight;
+        [self construct];
     }
     return self;
 }
 
+- (id)init
+{
+    self = [super init];
+    if (self)
+    {
+        [self construct];
+    }
+    return self;
+}
+
+- (void)construct
+{
+    _showsVerticalSelection = YES;
+    _cachedMinHeight = kJBBarChartViewUndefinedCachedHeight;
+    _cachedMaxHeight = kJBBarChartViewUndefinedCachedHeight;
+}
+
 #pragma mark - Memory Management
 
 - (void)dealloc
@@ -81,7 +111,8 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
 - (void)reloadData
 {
     // reset cached max height
-    self.cachedMaxHeight = kJBBarChartViewUndefinedMaxHeight;
+    self.cachedMinHeight = kJBBarChartViewUndefinedCachedHeight;
+    self.cachedMaxHeight = kJBBarChartViewUndefinedCachedHeight;
     
     /*
      * The data collection holds all position information:
@@ -90,15 +121,17 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     dispatch_block_t createDataDictionaries = ^{
         
         // Grab the count
-        NSAssert([self.dataSource respondsToSelector:@selector(numberOfBarsInBarChartView:)], @"JBBarChartView // datasource must implement - (NSInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView");
-        NSInteger dataCount = [self.dataSource numberOfBarsInBarChartView:self];
-        
+        NSAssert([self.dataSource respondsToSelector:@selector(numberOfBarsInBarChartView:)], @"JBBarChartView // datasource must implement - (NSUInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView");
+        NSUInteger dataCount = [self.dataSource numberOfBarsInBarChartView:self];
+
         // Build up the data collection
-        NSAssert([self.delegate respondsToSelector:@selector(barChartView:heightForBarViewAtAtIndex:)], @"JBBarChartView // delegate must implement - (NSInteger)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSInteger)index");
+        NSAssert([self.delegate respondsToSelector:@selector(barChartView:heightForBarViewAtAtIndex:)], @"JBBarChartView // delegate must implement - (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSUInteger)index");
         NSMutableDictionary *dataDictionary = [NSMutableDictionary dictionary];
-        for (NSInteger index=0; index<dataCount; index++)
+        for (NSUInteger index=0; index<dataCount; index++)
         {
-            [dataDictionary setObject:[NSNumber numberWithFloat:[self.delegate barChartView:self heightForBarViewAtAtIndex:index]] forKey:[NSNumber numberWithInt:(int)index]];
+            CGFloat height = [self.delegate barChartView:self heightForBarViewAtAtIndex:index];
+            NSAssert(height >= 0, @"JBBarChartView // datasource function - (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSUInteger)index must return a CGFloat >= 0");
+            [dataDictionary setObject:[NSNumber numberWithFloat:height] forKey:[NSNumber numberWithInt:(int)index]];
         }
         self.chartDataDictionary = [NSDictionary dictionaryWithDictionary:dataDictionary];
 	};
@@ -113,7 +146,7 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
         }
         else
         {
-            NSInteger totalBars = [[self.chartDataDictionary allKeys] count];
+            NSUInteger totalBars = [[self.chartDataDictionary allKeys] count];
             self.barPadding = (1/(float)totalBars) * kJBBarChartViewBarBasePaddingMutliplier;
         }
     };
@@ -130,14 +163,15 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
         }
         
         CGFloat xOffset = 0;
-        NSInteger index = 0;
+        NSUInteger index = 0;
         NSMutableArray *mutableBarViews = [NSMutableArray array];
         for (NSNumber *key in [[self.chartDataDictionary allKeys] sortedArrayUsingSelector:@selector(compare:)])
         {
             UIView *barView = nil; // since all bars are visible at once, no need to cache this view
-            if ([self.dataSource respondsToSelector:@selector(barViewForBarChartView:atIndex:)])
+            if ([self.dataSource respondsToSelector:@selector(barChartView:barViewAtIndex:)])
             {
-                barView = [self.dataSource barViewForBarChartView:self atIndex:index];
+                barView = [self.dataSource barChartView:self barViewAtIndex:index];
+                NSAssert(barView != nil, @"JBBarChartView // datasource function - (UIView *)barChartView:(JBBarChartView *)barChartView barViewAtIndex:(NSUInteger)index must return a non-nil UIView subclass");
             }
             else
             {
@@ -171,27 +205,28 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     dispatch_block_t createSelectionView = ^{
         
         // Remove old selection bar
-        if (self.selectionView)
+        if (self.verticalSelectionView)
         {
-            [self.selectionView removeFromSuperview];
-            self.selectionView = nil;
+            [self.verticalSelectionView removeFromSuperview];
+            self.verticalSelectionView = nil;
         }
         
-        self.selectionView = [[JBChartSelectionView alloc] initWithFrame:CGRectMake(0, 0, [self barWidth], self.bounds.size.height - self.footerView.frame.size.height)];
-        self.selectionView.alpha = 0.0;
-        if ([self.dataSource respondsToSelector:@selector(selectionBarColorForBarChartView:)])
+        self.verticalSelectionView = [[JBChartVerticalSelectionView alloc] initWithFrame:CGRectMake(0, 0, [self barWidth], self.bounds.size.height - self.footerView.frame.size.height)];
+        self.verticalSelectionView.alpha = 0.0;
+        self.verticalSelectionView.hidden = !self.showsVerticalSelection;
+        if ([self.dataSource respondsToSelector:@selector(barSelectionColorForBarChartView:)])
         {
-            self.selectionView.bgColor = [self.dataSource selectionBarColorForBarChartView:self];
+            self.verticalSelectionView.bgColor = [self.dataSource barSelectionColorForBarChartView:self];
         }
         
         // Add new selection bar
         if (self.footerView)
         {
-            [self insertSubview:self.selectionView belowSubview:self.footerView];
+            [self insertSubview:self.verticalSelectionView belowSubview:self.footerView];
         }
         else
         {
-            [self addSubview:self.selectionView];
+            [self addSubview:self.verticalSelectionView];
         }
     };
     
@@ -226,25 +261,27 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     return ((value - minHeight) / (maxHeight - minHeight)) * [self availableHeight];
 }
 
+- (CGFloat)minHeight
+{
+    if (self.mininumValue != kJBChartViewUndefinedMinimumValue)
+    {
+        return MIN(self.mininumValue, self.cachedMinHeight);
+    }
+    return self.cachedMinHeight;
+}
+
 - (CGFloat)maxHeight
 {
-    if (self.cachedMaxHeight == kJBBarChartViewUndefinedMaxHeight)
+    if (self.maximumValue != kJBChartViewUndefinedMaximumValue)
     {
-        // max height is max value across all goals and values
-        NSArray *chartValues = [[[self.chartDataDictionary allValues] arrayByAddingObjectsFromArray:[self.chartDataDictionary allValues]] sortedArrayUsingSelector:@selector(compare:)];
-        self.cachedMaxHeight =  [[chartValues lastObject] floatValue];
+        return MAX(self.maximumValue, self.cachedMaxHeight);
     }
     return self.cachedMaxHeight;
 }
 
-- (CGFloat)minHeight
-{
-    return 0;
-}
-
 - (CGFloat)barWidth
 {
-    NSInteger barCount = [[self.chartDataDictionary allKeys] count];
+    NSUInteger barCount = [[self.chartDataDictionary allKeys] count];
     if (barCount > 0)
     {
         CGFloat totalPadding = (barCount - 1) * self.barPadding;
@@ -267,51 +304,61 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     
     dispatch_block_t callbackCopy = [callback copy];
     
-    if (animated)
+    if ([self.barViews count] > 0)
     {
-        CGFloat popOffset = [self popOffset];
-        
-        NSUInteger index = 0;
-        for (UIView *barView in self.barViews)
+        if (animated)
         {
-            [UIView animateWithDuration:kJBBarChartViewStateAnimationDuration delay:(kJBBarChartViewStateAnimationDuration * 0.5) * index options:UIViewAnimationOptionBeginFromCurrentState animations:^{
-                barView.frame = CGRectMake(barView.frame.origin.x, popOffset - barView.frame.size.height, barView.frame.size.width, barView.frame.size.height);
-            } completion:^(BOOL finished) {
-                [UIView animateWithDuration:kJBBarChartViewStateAnimationDuration delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
-                    if (state == JBChartViewStateExpanded)
-                    {
-                        barView.frame = CGRectMake(barView.frame.origin.x, popOffset - barView.frame.size.height + kJBBarChartViewPopOffset, barView.frame.size.width, barView.frame.size.height);
-                    }
-                    else if (state == JBChartViewStateCollapsed)
-                    {
-                        barView.frame = CGRectMake(barView.frame.origin.x, self.bounds.size.height, barView.frame.size.width, barView.frame.size.height);
-                    }
-                } completion:^(BOOL lastBarFinished) {
-                    if (index == [self.barViews count] - 1)
-                    {
-                        if (callbackCopy)
+            CGFloat popOffset = [self popOffset];
+            
+            NSUInteger index = 0;
+            for (UIView *barView in self.barViews)
+            {
+                [UIView animateWithDuration:kJBBarChartViewStateAnimationDuration delay:(kJBBarChartViewStateAnimationDuration * 0.5) * index options:UIViewAnimationOptionBeginFromCurrentState animations:^{
+                    barView.frame = CGRectMake(barView.frame.origin.x, popOffset - barView.frame.size.height, barView.frame.size.width, barView.frame.size.height);
+                } completion:^(BOOL finished) {
+                    [UIView animateWithDuration:kJBBarChartViewStateAnimationDuration delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
+                        if (state == JBChartViewStateExpanded)
                         {
-                            callbackCopy();
+                            barView.frame = CGRectMake(barView.frame.origin.x, popOffset - barView.frame.size.height + kJBBarChartViewPopOffset, barView.frame.size.width, barView.frame.size.height);
                         }
-                    }
+                        else if (state == JBChartViewStateCollapsed)
+                        {
+                            barView.frame = CGRectMake(barView.frame.origin.x, self.bounds.size.height, barView.frame.size.width, barView.frame.size.height);
+                        }
+                    } completion:^(BOOL lastBarFinished) {
+                        if (index == [self.barViews count] - 1)
+                        {
+                            if (callbackCopy)
+                            {
+                                callbackCopy();
+                            }
+                        }
+                    }];
                 }];
-            }];
-            index++;
+                index++;
+            }
         }
+        else
+        {
+            for (UIView *barView in self.barViews)
+            {
+                if (state == JBChartViewStateExpanded)
+                {
+                    barView.frame = CGRectMake(barView.frame.origin.x, (self.bounds.size.height + kJBBarChartViewPopOffset) - (barView.frame.size.height + self.footerView.frame.size.height), barView.frame.size.width, barView.frame.size.height);
+                }
+                else if (state == JBChartViewStateCollapsed)
+                {
+                    barView.frame = CGRectMake(barView.frame.origin.x, self.bounds.size.height, barView.frame.size.width, barView.frame.size.height);
+                }
+            }
+            if (callbackCopy)
+            {
+                callbackCopy();
+            }
+        }   
     }
     else
     {
-        for (UIView *barView in self.barViews)
-        {
-            if (state == JBChartViewStateExpanded)
-            {
-                barView.frame = CGRectMake(barView.frame.origin.x, (self.bounds.size.height + kJBBarChartViewPopOffset) - (barView.frame.size.height + self.footerView.frame.size.height), barView.frame.size.width, barView.frame.size.height);
-            }
-            else if (state == JBChartViewStateCollapsed)
-            {
-                barView.frame = CGRectMake(barView.frame.origin.x, self.bounds.size.height, barView.frame.size.width, barView.frame.size.height);
-            }
-        }
         if (callbackCopy)
         {
             callbackCopy();
@@ -319,6 +366,48 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     }
 }
 
+#pragma mark - Getters
+
+- (CGFloat)cachedMinHeight
+{
+    if(_cachedMinHeight == kJBBarChartViewUndefinedCachedHeight)
+    {
+        // min height is min value across all goals and values
+        NSArray *chartValues = [[[self.chartDataDictionary allValues] arrayByAddingObjectsFromArray:[self.chartDataDictionary allValues]] sortedArrayUsingSelector:@selector(compare:)];
+        _cachedMinHeight =  [[chartValues firstObject] floatValue];
+    }
+    return _cachedMinHeight;
+}
+
+- (CGFloat)cachedMaxHeight
+{
+    if (_cachedMaxHeight == kJBBarChartViewUndefinedCachedHeight)
+    {
+        // max height is max value across all goals and values
+        NSArray *chartValues = [[[self.chartDataDictionary allValues] arrayByAddingObjectsFromArray:[self.chartDataDictionary allValues]] sortedArrayUsingSelector:@selector(compare:)];
+        _cachedMaxHeight =  [[chartValues lastObject] floatValue];
+    }
+    return _cachedMaxHeight;
+}
+
+- (CGFloat)mininumValue
+{
+    if ([super mininumValue] == kJBChartViewUndefinedMinimumValue)
+    {
+        return self.cachedMinHeight;
+    }
+    return [super mininumValue];
+}
+
+- (CGFloat)maximumValue
+{
+    if ([super maximumValue] == kJBChartViewUndefinedMaximumValue)
+    {
+        return self.cachedMaxHeight;
+    }
+    return [super maximumValue];
+}
+
 #pragma mark - Touch Helpers
 
 - (NSInteger)barViewIndexForPoint:(CGPoint)point
@@ -352,103 +441,97 @@ static UIColor *kJBBarChartViewDefaultBarColor = nil;
     NSInteger selectedIndex = [self barViewIndexForPoint:point];
     if (selectedIndex >= 0)
     {
-        barView = [self.barViews objectAtIndex:[self barViewIndexForPoint:point]];
+        return [self.barViews objectAtIndex:[self barViewIndexForPoint:point]];
     }
     return barView;
 }
 
-- (void)touchesEndedOrCancelledWithTouches:(NSSet *)touches
+- (void)touchesBeganOrMovedWithTouches:(NSSet *)touches
 {
-    if (!self.showsSelection || self.state == JBChartViewStateCollapsed)
+    if (self.state == JBChartViewStateCollapsed || [[self.chartDataDictionary allKeys] count] <= 0)
     {
         return;
     }
-    [self setSelectionViewVisible:NO animated:YES];
     
     UITouch *touch = [touches anyObject];
     CGPoint touchPoint = [touch locationInView:self];
-    NSInteger index = [self barViewIndexForPoint:touchPoint];
-    if ([self.delegate respondsToSelector:@selector(barChartView:didUnselectBarAtIndex:)])
+    UIView *barView = [self barViewForForPoint:touchPoint];
+    if (barView == nil)
     {
-        [self.delegate barChartView:self didUnselectBarAtIndex:index];
+        [self setVerticalSelectionViewVisible:NO animated:YES];
+        return;
+    }
+    CGRect barViewFrame = barView.frame;
+    CGRect selectionViewFrame = self.verticalSelectionView.frame;
+    selectionViewFrame.origin.x = barViewFrame.origin.x;
+    self.verticalSelectionView.frame = selectionViewFrame;
+    [self setVerticalSelectionViewVisible:YES animated:YES];
+    
+    if ([self.delegate respondsToSelector:@selector(barChartView:didSelectBarAtIndex:touchPoint:)])
+    {
+        [self.delegate barChartView:self didSelectBarAtIndex:[self barViewIndexForPoint:touchPoint] touchPoint:touchPoint];
+    }
+    
+    if ([self.delegate respondsToSelector:@selector(barChartView:didSelectBarAtIndex:)])
+    {
+        [self.delegate barChartView:self didSelectBarAtIndex:[self barViewIndexForPoint:touchPoint]];
+    }
+}
+
+- (void)touchesEndedOrCancelledWithTouches:(NSSet *)touches
+{
+    if (self.state == JBChartViewStateCollapsed || [[self.chartDataDictionary allKeys] count] <= 0)
+    {
+        return;
+    }
+    
+    [self setVerticalSelectionViewVisible:NO animated:YES];
+    
+    if ([self.delegate respondsToSelector:@selector(didUnselectBarChartView:)])
+    {
+        [self.delegate didUnselectBarChartView:self];
     }
 }
 
 #pragma mark - Setters
 
-- (void)setSelectionViewVisible:(BOOL)selectionViewVisible animated:(BOOL)animated
+- (void)setVerticalSelectionViewVisible:(BOOL)verticalSelectionViewVisible animated:(BOOL)animated
 {
-    _selectionViewVisible = selectionViewVisible;
+    _verticalSelectionViewVisible = verticalSelectionViewVisible;
     
     if (animated)
     {
         [UIView animateWithDuration:kJBChartViewDefaultAnimationDuration delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
-            self.selectionView.alpha = self.selectionViewVisible ? 1.0 : 0.0;
+            self.verticalSelectionView.alpha = self.verticalSelectionViewVisible ? 1.0 : 0.0;
         } completion:nil];
     }
     else
     {
-        self.selectionView.alpha = _selectionViewVisible ? 1.0 : 0.0;
+        self.verticalSelectionView.alpha = _verticalSelectionViewVisible ? 1.0 : 0.0;
     }
 }
 
-- (void)setSelectionViewVisible:(BOOL)selectionViewVisible
+- (void)setVerticalSelectionViewVisible:(BOOL)verticalSelectionViewVisible
 {
-    [self setSelectionViewVisible:selectionViewVisible animated:NO];
+    [self setVerticalSelectionViewVisible:verticalSelectionViewVisible animated:NO];
+}
+
+- (void)setShowsVerticalSelection:(BOOL)showsVerticalSelection
+{
+    _showsVerticalSelection = showsVerticalSelection;
+    self.verticalSelectionView.hidden = _showsVerticalSelection ? NO : YES;
 }
 
 #pragma mark - Touches
 
 - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
 {
-    if (!self.showsSelection || self.state == JBChartViewStateCollapsed)
-    {
-        return;
-    }
-    UITouch *touch = [touches anyObject];
-    CGPoint touchPoint = [touch locationInView:self];
-    UIView *barView = [self barViewForForPoint:touchPoint];
-    if (barView == nil)
-    {
-        [self setSelectionViewVisible:NO animated:YES];
-        return;
-    }
-    CGRect barViewFrame = barView.frame;
-    CGRect selectionViewFrame = self.selectionView.frame;
-    selectionViewFrame.origin.x = barViewFrame.origin.x;
-    self.selectionView.frame = selectionViewFrame;
-    [self setSelectionViewVisible:YES animated:YES];
-    
-    if ([self.delegate respondsToSelector:@selector(barChartView:didSelectBarAtIndex:)])
-    {
-        [self.delegate barChartView:self didSelectBarAtIndex:[self barViewIndexForPoint:touchPoint]];
-    }
+    [self touchesBeganOrMovedWithTouches:touches];
 }
 
 - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event
 {
-    if (!self.showsSelection || self.state == JBChartViewStateCollapsed)
-    {
-        return;
-    }
-    UITouch *touch = [touches anyObject];
-    CGPoint touchPoint = [touch locationInView:self];
-    UIView *barView = [self barViewForForPoint:touchPoint];
-    if (barView == nil)
-    {
-        [self setSelectionViewVisible:NO animated:YES];
-        return;
-    }
-    CGRect barViewFrame = barView.frame;
-    CGRect selectionViewFrame = self.selectionView.frame;
-    selectionViewFrame.origin.x = barViewFrame.origin.x;
-    self.selectionView.frame = selectionViewFrame;
-    [self setSelectionViewVisible:YES animated:YES];
-    
-    if ([self.delegate respondsToSelector:@selector(barChartView:didSelectBarAtIndex:)])
-    {
-        [self.delegate barChartView:self didSelectBarAtIndex:[self barViewIndexForPoint:touchPoint]];
-    }
+    [self touchesBeganOrMovedWithTouches:touches];
 }
 
 - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event

Classes/JBChartView.h

@@ -9,6 +9,8 @@
 #import <Foundation/Foundation.h>
 
 extern CGFloat const kJBChartViewDefaultAnimationDuration;
+extern CGFloat const kJBChartViewUndefinedMinimumValue; // helper for undefined min/max values
+extern CGFloat const kJBChartViewUndefinedMaximumValue;
 
 /**
  * At a minimum, a chart can support two states, along with animations to-and-from.
@@ -29,15 +31,29 @@ typedef NS_ENUM(NSInteger, JBChartViewState){
 /**
  *  Header and footer views are shown above and below the chart respectively.
  *  Each view will be stretched horizontally to fill width of chart.
+ *  Each view's bounds are clipped to support chart state animations. 
  */
 @property (nonatomic, strong) UIView *footerView;
 @property (nonatomic, strong) UIView *headerView;
 
 /**
- *  The vertical padding between the header and highest chart point (bar, line, etc)
+ *  The vertical padding between the header and highest chart point (bar, line, etc).
  */
 @property (nonatomic, assign) CGFloat headerPadding;
 
+/**
+ *  The minimum and maxmimum values of the chart. 
+ *  If no value(s) are supplied, the min and max values of the chart's data source are used.
+ *
+ *  If value(s) are supplied, they must be >= 0, otherwise an assertion will be thrown. 
+ *  The min/max values are clamped to the ceiling and floor of the actual min/max values of the chart's data source;
+ *  for example, if a maximumValue of 20 is supplied & the chart's actual max is 100, then 100 will be used.
+ *
+ *  For min/max modifications to take effect, reloadData must be called.
+ */
+@property (nonatomic, assign) CGFloat mininumValue;
+@property (nonatomic, assign) CGFloat maximumValue;
+
 /**
  *  Charts can either be expanded or contracted. 
  *  By default, a chart should be expanded on initialization.
@@ -51,19 +67,19 @@ typedef NS_ENUM(NSInteger, JBChartViewState){
 - (void)reloadData;
 
 /**
- *  State setter
+ *  State setter.
  *
- *  @param state    Either collapse or expanded.
- *  @param animated Whether or not the state should be animated or not.
- *  @param callback Called once the animation is completed. If animated == NO, then callback is immediate.
+ *  @param state        Either collapse or expanded.
+ *  @param animated     Whether or not the state should be animated or not.
+ *  @param callback     Called once the animation is completed. If animated == NO, then callback is immediate.
  */
 - (void)setState:(JBChartViewState)state animated:(BOOL)animated callback:(void (^)())callback;
 
 /**
- *  State setter
+ *  State setter.
  *
- *  @param state    Either collapse or expanded.
- *  @param animated Whether or not the state should be animated or not.
+ *  @param state        Either collapse or expanded.
+ *  @param animated     Whether or not the state should be animated or not.
  */
 - (void)setState:(JBChartViewState)state animated:(BOOL)animated;
 
@@ -71,14 +87,14 @@ typedef NS_ENUM(NSInteger, JBChartViewState){
 
 /**
  * A simple UIView subclass that fades a base color from current alpha to 0.0 (vertically).
- * Used as a selection ivew in JBChartView subclasses.
+ * Used as a vertical selection view in JBChartView subclasses.
  */
-@interface JBChartSelectionView : UIView
+@interface JBChartVerticalSelectionView : UIView
 
 /**
- * Base selection view color. This color will be faded to transparent vertically
+ * Base selection view color. This color will be faded to transparent vertically.
  *
- * Default: white color
+ * Default: white color.
  *
  */
 @property (nonatomic, strong) UIColor *bgColor;

Classes/JBChartView.m

@@ -9,9 +9,11 @@
 #import "JBChartView.h"
 
 CGFloat const kJBChartViewDefaultAnimationDuration = 0.25f;
+CGFloat const kJBChartViewUndefinedMinimumValue = -1.0f;
+CGFloat const kJBChartViewUndefinedMaximumValue = -1.0f;
 
 // Color (JBChartSelectionView)
-static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
+static UIColor *kJBChartVerticalSelectionViewDefaultBgColor = nil;
 
 @interface JBChartView ()
 
@@ -29,6 +31,8 @@ static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
     if (self)
     {
         self.clipsToBounds = YES;
+        _mininumValue = kJBChartViewUndefinedMinimumValue;
+        _maximumValue = kJBChartViewUndefinedMaximumValue;
     }
     return self;
 }
@@ -62,6 +66,7 @@ static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
         _headerView = nil;
     }
     _headerView = headerView;
+    _headerView.clipsToBounds = YES;
     
     [self validateHeaderAndFooterHeights];
     
@@ -77,6 +82,7 @@ static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
         _footerView = nil;
     }
     _footerView = footerView;
+    _footerView.clipsToBounds = YES;
     
     [self validateHeaderAndFooterHeights];
     
@@ -106,17 +112,29 @@ static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
     [self setState:state animated:NO];
 }
 
+- (void)setMininumValue:(CGFloat)mininumValue
+{
+    NSAssert(mininumValue >= 0, @"JBChartView // the minimumValue must be >= 0.");
+    _mininumValue = mininumValue;
+}
+
+- (void)setMaximumValue:(CGFloat)maximumValue
+{
+    NSAssert(maximumValue >= 0, @"JBChartView // the maximumValue must be >= 0.");
+    _maximumValue = maximumValue;
+}
+
 @end
 
-@implementation JBChartSelectionView
+@implementation JBChartVerticalSelectionView
 
 #pragma mark - Alloc/Init
 
 + (void)initialize
 {
-	if (self == [JBChartSelectionView class])
+	if (self == [JBChartVerticalSelectionView class])
 	{
-		kJBChartSelectionViewDefaultBgColor = [UIColor whiteColor];
+		kJBChartVerticalSelectionViewDefaultBgColor = [UIColor whiteColor];
 	}
 }
 
@@ -148,7 +166,7 @@ static UIColor *kJBChartSelectionViewDefaultBgColor = nil;
     }
     else
     {
-        colors = @[(__bridge id)kJBChartSelectionViewDefaultBgColor.CGColor, (__bridge id)[kJBChartSelectionViewDefaultBgColor colorWithAlphaComponent:0.0].CGColor];
+        colors = @[(__bridge id)kJBChartVerticalSelectionViewDefaultBgColor.CGColor, (__bridge id)[kJBChartVerticalSelectionViewDefaultBgColor colorWithAlphaComponent:0.0].CGColor];
     }
     
     CGGradientRef gradient = CGGradientCreateWithColors(colorSpace, (__bridge CFArrayRef) colors, locations);

Classes/JBChartView.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name         = "JBChartView"
-  s.version      = "1.1.5"
+  s.version      = "2.1.2"
   s.summary      = "Jawbone's iOS-based charting library for both line and bar graphs."
   s.homepage     = "https://github.com/Jawbone/JBChartView"
 
@@ -8,7 +8,7 @@ Pod::Spec.new do |s|
   s.author       = { "Terry Worona" => "tworona@jawbone.com" }
   s.source       = { 
 	:git => "https://github.com/Jawbone/JBChartView.git",
-	:tag => "v1.1.5"
+	:tag => "v2.1.2"
   }
 
   s.platform     = :ios, '7.0'

Classes/JBLineChartView.h

@@ -8,6 +8,20 @@
 
 #import "JBChartView.h"
 
+/**
+ * Current support for two line styles: solid (default) and dashed. 
+ */
+typedef NS_ENUM(NSInteger, JBLineChartViewLineStyle){
+    /**
+     *  Solid line.
+     */
+    JBLineChartViewLineStyleSolid,
+    /**
+     *  Dashed line with a phase of 3:2 (3 points dashed, 2 points spaced).
+     */
+	JBLineChartViewLineStyleDashed
+};
+
 @protocol JBLineChartViewDelegate;
 @protocol JBLineChartViewDataSource;
 
@@ -17,11 +31,20 @@
 @property (nonatomic, weak) id<JBLineChartViewDataSource> dataSource;
 
 /**
- *  If showsSelection is YES, a vertical highlight will overlayed on a the line graph during touch events.
+ *  Vertical highlight overlayed on a line graph during touch events.
  *
- *  Default: YES
+ *  Default: YES.
  */
-@property (nonatomic, assign) BOOL showsSelection;
+@property (nonatomic, assign) BOOL showsVerticalSelection;
+
+/**
+ *  A highlight shown on a line within the graph during touch events. The highlighted line
+ *  is the closest line to the touch point and corresponds to the lineIndex delegatd back via 
+ *  didSelectChartAtHorizontalIndex:atLineIndex: and didUnSlectChartAtHorizontalIndex:atLineIndex:
+ *
+ *  Default: YES.
+ */
+@property (nonatomic, assign) BOOL showsLineSelection;
 
 @end
 
@@ -30,35 +53,39 @@
 @required
 
 /**
- *  Vertical position for line point at a given index (left to right). There is no ceiling on the the height;
+ *  Vertical value for a line point at a given index (left to right). There is no ceiling on the the height;
  *  the chart will automatically normalize all values between the overal min and max heights.
  *
- *  @param lineChartView The origin chart
- *  @param index         The 0-based index of a given line height (left to right, x-axis)
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param horizontalIndex  The 0-based horizontal index of a selection point (left to right, x-axis).
+ *  @param lineIndex        An index number identifying the closest line in the chart to the current touch point.
  *
  *  @return The y-axis value of the supplied line index (x-axis)
  */
-- (CGFloat)lineChartView:(JBLineChartView *)lineChartView heightForIndex:(NSInteger)index;
+- (CGFloat)lineChartView:(JBLineChartView *)lineChartView verticalValueForHorizontalIndex:(NSUInteger)horizontalIndex atLineIndex:(NSUInteger)lineIndex;
 
 @optional
 
 /**
- *  Occurs when a touch gesture event occurs anywhere on the chart. The chart must be expanded, showsSelection must be YES,
- *  and the selection must occur within the bounds of the chart.
+ *  Occurs whenever there is a touch gesture on the chart (chart must be expanded).
+ *  The horizontal index is the closest index to the touch point & is clamped to it's max/min value if it moves outside of the view's bounds.
+ *  The lineIndex remains constant until the line is unselected and will be highlighted using the (optional) selectionColorForLineAtLineIndex: protocol. 
+ *  Futhermore, all other lines that aren't selected will be dimmed to 50% opacity throughout the duration of the touch/move.
  *
- *  @param lineChartView The origin chart
- *  @param index         The 0-based index of a selection point (left to right, x-axis)
+ *  @param lineChartView    A line chart object informing the delegate about the new selection.
+ *  @param lineIndex        An index number identifying the closest line in the chart to the current touch
+ *  @param horizontalIndex  The 0-based horizontal index of a selection point (left to right, x-axis).point.
+ *  @param touchPoint       The touch point in relation to the chart's bounds (excludes footer and header).
  */
-- (void)lineChartView:(JBLineChartView *)lineChartView didSelectChartAtIndex:(NSInteger)index;
+- (void)lineChartView:(JBLineChartView *)lineChartView didSelectLineAtIndex:(NSUInteger)lineIndex horizontalIndex:(NSUInteger)horizontalIndex touchPoint:(CGPoint)touchPoint;
+- (void)lineChartView:(JBLineChartView *)lineChartView didSelectLineAtIndex:(NSUInteger)lineIndex horizontalIndex:(NSUInteger)horizontalIndex;
 
 /**
- *  Occurs when selection ends by either ending a touch event or selecting an area that is outside the view's bounds.
- *  For selection start events, see: didSelectChartAtIndex...
+ *  Occurs when selection ends by ending a touch event. For selection start events, see: didSelectChartAtIndex:
  *
- *  @param lineChartView The origin chart
- *  @param index         The 0-based index of a selection point. Index will be -1 if the touch ends outside of the view's bounds.
+ *  @param lineChartView    A line chart object informing the delegate about the unselection.
  */
-- (void)lineChartView:(JBLineChartView *)lineChartView didUnselectChartAtIndex:(NSInteger)index;
+- (void)didUnselectLineInLineChartView:(JBLineChartView *)lineChartView;
 
 @end
 
@@ -67,37 +94,113 @@
 @required
 
 /**
- *  The number of points in a given line chart equates to the number of values along the x-axis.
+ *  Returns the number of lines for the line chart.
  *
- *  @param lineChartView The origin chart
+ *  @param lineChartView    The line chart object requesting this information.
  *
- *  @return Number of points in the given chart.
+ *  @return The number of lines in the line chart.
  */
-- (NSInteger)numberOfPointsInLineChartView:(JBLineChartView *)lineChartView;
+- (NSUInteger)numberOfLinesInLineChartView:(JBLineChartView *)lineChartView;
+
+/**
+ *  Returns the number of vertical values for a particular line at lineIndex within the chart.
+ *
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return The number of vertical values for a given line in the line chart.
+ */
+- (NSUInteger)lineChartView:(JBLineChartView *)lineChartView numberOfVerticalValuesAtLineIndex:(NSUInteger)lineIndex;
 
 @optional
 
 /**
- *  The color of the line within the chart.
- * 
- *  Default: black color
+ *  Returns the color of particular line at lineIndex within the chart.
  *
- *  @param lineChartView The origin chart
+ *  Default: black color.
  *
- *  @return The color to be used to draw the line on the chart (alphas < 1 are supported)
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return The color to be used to shade a line in the chart.
  */
-- (UIColor *)lineColorForLineChartView:(JBLineChartView *)lineChartView;
+- (UIColor *)lineChartView:(JBLineChartView *)lineChartView colorForLineAtLineIndex:(NSUInteger)lineIndex;
 
 /**
- *  The selection color to be overlayed on the chart during touch events.
- *  The color is automically faded to transparent (vertically).
+ *  Returns the width of particular line at lineIndex within the chart.
  *
- *  Default: white color (faded to transparent)
+ *  Default: 5 points.
  *
- *  @param lineChartView The origin chart
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return The width to be used to draw a line in the chart.
+ */
+- (CGFloat)lineChartView:(JBLineChartView *)lineChartView widthForLineAtLineIndex:(NSUInteger)lineIndex;
+
+/**
+ *  Returns the (vertical) selection color to be overlayed on the chart during touch events.
+ *  The color is automically faded to transparent (vertically). The property showsVerticalSelection
+ *  must be YES for the color to apply.
+ *
+ *  Default: white color (faded to transparent).
+ *
+ *  @param lineChartView    The line chart object requesting this information.
  *
  *  @return The color to be used on chart selections.
  */
-- (UIColor *)selectionColorForLineChartView:(JBLineChartView *)lineChartView;
+- (UIColor *)verticalSelectionColorForLineChartView:(JBLineChartView *)lineChartView;
+
+/**
+ *  Returns the selection color to be overlayed on a line within the chart during touch events.
+ *  The property showsLineSelection must be YES for the color to apply.
+ *
+ *  Default: white color.
+ *
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return The color to be used to highlight a line during chart selections.
+ */
+- (UIColor *)lineChartView:(JBLineChartView *)lineChartView selectionColorForLineAtLineIndex:(NSUInteger)lineIndex;
+
+/**
+ *  Returns the line style of a particular line at lineIndex within the chart.
+ *  See JBLineChartViewLineStyle for line style descriptions.
+ *
+ *  Default: JBLineChartViewLineStyleSolid
+ *
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return The line style to be used to draw a line in the chart.
+ */
+- (JBLineChartViewLineStyle)lineChartView:(JBLineChartView *)lineChartView lineStyleForLineAtLineIndex:(NSUInteger)lineIndex;
+
+/**
+ *  Returns whether or not a line should show a dot for each point.
+ *  Dot size is relative to the line width and not adjustable.
+ *  Dot color is equal to the line color and not adjustable.
+ *
+ *  Default: NO
+ *
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return Whether or not a line should show a dot for each chart point.
+ */
+- (BOOL)lineChartView:(JBLineChartView *)lineChartView showsDotsForLineAtLineIndex:(NSUInteger)lineIndex;
+
+/**
+ *  Returns whether or not a line should be smoothed (rounded end caps and connections).
+ *
+ *  Default: NO
+ *
+ *  @param lineChartView    The line chart object requesting this information.
+ *  @param lineIndex        An index number identifying a line in the chart.
+ *
+ *  @return Whether or not a line should smooth it's ends and connections. 
+ */
+- (BOOL)lineChartView:(JBLineChartView *)lineChartView smoothLineAtLineIndex:(NSUInteger)lineIndex;
 
 @end

JBChartViewDemo/JBChartViewDemo.xcodeproj/project.pbxproj

@@ -15,6 +15,7 @@
 		9B2E531118218CF20079B9D2 /* main.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B2E531018218CF20079B9D2 /* main.m */; };
 		9B2E532018218CF30079B9D2 /* Images.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 9B2E531F18218CF30079B9D2 /* Images.xcassets */; };
 		9B2E533F18218D310079B9D2 /* AppDelegate.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B2E533E18218D310079B9D2 /* AppDelegate.m */; };
+		9B4437AD18D7686800682EF0 /* JBChartTooltipTipView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B4437AC18D7686800682EF0 /* JBChartTooltipTipView.m */; };
 		9B603D3E182C6E79000A76D0 /* JBBaseNavigationController.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B603D3D182C6E79000A76D0 /* JBBaseNavigationController.m */; };
 		9B603D47182C7002000A76D0 /* icon-jawbone-logo.png in Resources */ = {isa = PBXBuildFile; fileRef = 9B603D45182C7002000A76D0 /* icon-jawbone-logo.png */; };
 		9B603D48182C7002000A76D0 /* icon-jawbone-logo@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 9B603D46182C7002000A76D0 /* icon-jawbone-logo@2x.png */; };
@@ -32,10 +33,12 @@
 		9B6A68DB1829ADE1006DB3BF /* JBBarChartView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B6A68DA1829ADE1006DB3BF /* JBBarChartView.m */; };
 		9B6A68DE1829BE63006DB3BF /* JBBarChartViewController.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B6A68DD1829BE63006DB3BF /* JBBarChartViewController.m */; };
 		9B6A68E11829BED5006DB3BF /* JBLineChartViewController.m in Sources */ = {isa = PBXBuildFile; fileRef = 9B6A68E01829BED5006DB3BF /* JBLineChartViewController.m */; };
+		9BD57BBC18D13D1A00ACFA52 /* JBChartTooltipView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BD57BBB18D13D1A00ACFA52 /* JBChartTooltipView.m */; };
 		9BE0B0AD182AD26400232023 /* JBLineChartView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BE0B0AC182AD26400232023 /* JBLineChartView.m */; };
 		9BE0B0C7182B161000232023 /* JBChartHeaderView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BE0B0C6182B161000232023 /* JBChartHeaderView.m */; };
 		9BE0B0CE182B162E00232023 /* JBBarChartFooterView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BE0B0CD182B162E00232023 /* JBBarChartFooterView.m */; };
 		9BEBE9D2183167050046E4A8 /* JBChartInformationView.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BEBE9D1183167050046E4A8 /* JBChartInformationView.m */; };
+		9BEE694618D2789E005D9BA7 /* JBBaseChartViewController.m in Sources */ = {isa = PBXBuildFile; fileRef = 9BEE694518D2789E005D9BA7 /* JBBaseChartViewController.m */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXFileReference section */
@@ -55,6 +58,8 @@
 		9B2E533E18218D310079B9D2 /* AppDelegate.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = AppDelegate.m; sourceTree = "<group>"; };
 		9B3FBA54182C3B6900CF1C5F /* JBColorConstants.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBColorConstants.h; sourceTree = "<group>"; };
 		9B3FBA57182C3BFB00CF1C5F /* JBFontConstants.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBFontConstants.h; sourceTree = "<group>"; };
+		9B4437AB18D7686800682EF0 /* JBChartTooltipTipView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBChartTooltipTipView.h; sourceTree = "<group>"; };
+		9B4437AC18D7686800682EF0 /* JBChartTooltipTipView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBChartTooltipTipView.m; sourceTree = "<group>"; };
 		9B603D3C182C6E79000A76D0 /* JBBaseNavigationController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBBaseNavigationController.h; sourceTree = "<group>"; };
 		9B603D3D182C6E79000A76D0 /* JBBaseNavigationController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBBaseNavigationController.m; sourceTree = "<group>"; };
 		9B603D45182C7002000A76D0 /* icon-jawbone-logo.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = "icon-jawbone-logo.png"; sourceTree = "<group>"; };
@@ -81,6 +86,8 @@
 		9B6A68DD1829BE63006DB3BF /* JBBarChartViewController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBBarChartViewController.m; sourceTree = "<group>"; };
 		9B6A68DF1829BED5006DB3BF /* JBLineChartViewController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBLineChartViewController.h; sourceTree = "<group>"; };
 		9B6A68E01829BED5006DB3BF /* JBLineChartViewController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBLineChartViewController.m; sourceTree = "<group>"; };
+		9BD57BBA18D13D1A00ACFA52 /* JBChartTooltipView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBChartTooltipView.h; sourceTree = "<group>"; };
+		9BD57BBB18D13D1A00ACFA52 /* JBChartTooltipView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBChartTooltipView.m; sourceTree = "<group>"; };
 		9BE0B0AB182AD26400232023 /* JBLineChartView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = JBLineChartView.h; path = ../../Classes/JBLineChartView.h; sourceTree = "<group>"; };
 		9BE0B0AC182AD26400232023 /* JBLineChartView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = JBLineChartView.m; path = ../../Classes/JBLineChartView.m; sourceTree = "<group>"; };
 		9BE0B0C5182B161000232023 /* JBChartHeaderView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBChartHeaderView.h; sourceTree = "<group>"; };
@@ -92,6 +99,8 @@
 		9BE0B0D3182B16F700232023 /* JBStringConstants.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBStringConstants.h; sourceTree = "<group>"; };
 		9BEBE9D0183167050046E4A8 /* JBChartInformationView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBChartInformationView.h; sourceTree = "<group>"; };
 		9BEBE9D1183167050046E4A8 /* JBChartInformationView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBChartInformationView.m; sourceTree = "<group>"; };
+		9BEE694418D2789E005D9BA7 /* JBBaseChartViewController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = JBBaseChartViewController.h; sourceTree = "<group>"; };
+		9BEE694518D2789E005D9BA7 /* JBBaseChartViewController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = JBBaseChartViewController.m; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -187,6 +196,8 @@
 		9B603D3B182C6E79000A76D0 /* Base */ = {
 			isa = PBXGroup;
 			children = (
+				9BEE694418D2789E005D9BA7 /* JBBaseChartViewController.h */,
+				9BEE694518D2789E005D9BA7 /* JBBaseChartViewController.m */,
 				9B603D3C182C6E79000A76D0 /* JBBaseNavigationController.h */,
 				9B603D3D182C6E79000A76D0 /* JBBaseNavigationController.m */,
 				9B603D4C182C7163000A76D0 /* JBBaseTableViewController.h */,
@@ -291,6 +302,10 @@
 			children = (
 				9BEBE9D0183167050046E4A8 /* JBChartInformationView.h */,
 				9BEBE9D1183167050046E4A8 /* JBChartInformationView.m */,
+				9B4437AB18D7686800682EF0 /* JBChartTooltipTipView.h */,
+				9B4437AC18D7686800682EF0 /* JBChartTooltipTipView.m */,
+				9BD57BBA18D13D1A00ACFA52 /* JBChartTooltipView.h */,
+				9BD57BBB18D13D1A00ACFA52 /* JBChartTooltipView.m */,
 			);
 			path = Misc;
 			sourceTree = "<group>";
@@ -321,7 +336,7 @@
 		9B2E52F918218CF20079B9D2 /* Project object */ = {
 			isa = PBXProject;
 			attributes = {
-				LastUpgradeCheck = 0500;
+				LastUpgradeCheck = 0510;
 				ORGANIZATIONNAME = Jawbone;
 			};
 			buildConfigurationList = 9B2E52FC18218CF20079B9D2 /* Build configuration list for PBXProject "JBChartViewDemo" */;
@@ -378,9 +393,12 @@
 				9BE0B0C7182B161000232023 /* JBChartHeaderView.m in Sources */,
 				9B603D4E182C7163000A76D0 /* JBBaseTableViewController.m in Sources */,
 				9B6A68DE1829BE63006DB3BF /* JBBarChartViewController.m in Sources */,
+				9B4437AD18D7686800682EF0 /* JBChartTooltipTipView.m in Sources */,
 				9BE0B0AD182AD26400232023 /* JBLineChartView.m in Sources */,
+				9BEE694618D2789E005D9BA7 /* JBBaseChartViewController.m in Sources */,
 				9B6A68E11829BED5006DB3BF /* JBLineChartViewController.m in Sources */,
 				9B2E533F18218D310079B9D2 /* AppDelegate.m in Sources */,
+				9BD57BBC18D13D1A00ACFA52 /* JBChartTooltipView.m in Sources */,
 				9B603D4B182C7117000A76D0 /* JBBaseViewController.m in Sources */,
 				9B0725211829822A0052109B /* JBChartListViewController.m in Sources */,
 			);
@@ -404,7 +422,6 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
-				ARCHS = "$(ARCHS_STANDARD_INCLUDING_64_BIT)";
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
 				CLANG_ENABLE_MODULES = YES;
@@ -444,7 +461,6 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
-				ARCHS = "$(ARCHS_STANDARD_INCLUDING_64_BIT)";
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
 				CLANG_ENABLE_MODULES = YES;

JBChartViewDemo/JBChartViewDemo/Constants/JBColorConstants.h

@@ -21,10 +21,18 @@
 #define kJBColorBarChartBarGreen UIColorFromHex(0x34b234)
 #define kJBColorBarChartHeaderSeparatorColor UIColorFromHex(0x686868)
 
-#pragma mark - Line Char
+#pragma mark - Line Chart
 
 #define kJBColorLineChartControllerBackground UIColorFromHex(0xb7e3e4)
 #define kJBColorLineChartBackground UIColorFromHex(0xb7e3e4)
 #define kJBColorLineChartHeader UIColorFromHex(0x1c474e)
 #define kJBColorLineChartHeaderSeparatorColor UIColorFromHex(0x8eb6b7)
-#define kJBColorLineChartLineColor [UIColor colorWithWhite:1.0 alpha:0.5]
+#define kJBColorLineChartDefaultSolidLineColor [UIColor colorWithWhite:1.0 alpha:0.5]
+#define kJBColorLineChartDefaultSolidSelectedLineColor [UIColor colorWithWhite:1.0 alpha:1.0]
+#define kJBColorLineChartDefaultDashedLineColor [UIColor colorWithRed:1.0 green:0.0 blue:0.0 alpha:1.0]
+#define kJBColorLineChartDefaultDashedSelectedLineColor [UIColor colorWithWhite:1.0 alpha:1.0]
+
+#pragma mark - Tooltips
+
+#define kJBColorTooltipColor [UIColor colorWithWhite:1.0 alpha:0.9]
+#define kJBColorTooltipTextColor UIColorFromHex(0x313131)

JBChartViewDemo/JBChartViewDemo/Constants/JBFontConstants.h

@@ -21,3 +21,7 @@
 #define kJBFontInformationTitle [UIFont fontWithName:@"HelveticaNeue" size:20]
 #define kJBFontInformationValue [UIFont fontWithName:@"HelveticaNeue-CondensedBold" size:100]
 #define kJBFontInformationUnit [UIFont fontWithName:@"HelveticaNeue" size:60]
+
+#pragma mark - Tooltip
+
+#define kJBFontTooltipText [UIFont fontWithName:@"HelveticaNeue-Bold" size:14]

JBChartViewDemo/JBChartViewDemo/Constants/JBStringConstants.h

@@ -10,11 +10,20 @@
 
 #pragma mark - Labels
 
-#define kJBStringLabel1987 localize(@"label.1985", @"1987")
+#pragma mark - Labels (Bar Chart)
+
+#define kJBStringLabel2012 localize(@"label.2012", @"2012")
+#define kJBStringLabelAverageMonthlyTemperature localize(@"label.average.monthly.temperature", @"Average Monthly Temperature")
+#define kJBStringLabelWorldwide2012 localize(@"label.worldwide.2013", @"Worldwide - 2012")
+#define kJBStringLabelWorldwideAverage localize(@"label.worldwide.average", @"Worldwide Average")
+#define kJBStringLabelDegreesFahrenheit localize(@"label.degrees.fahrenheit", @"%d%@F")
+#define kJBStringLabelDegreeSymbol localize(@"label.degree.symbol", @"\u00B0")
+
+#pragma mark - Labels (Line Chart)
+
 #define kJBStringLabel2013 localize(@"label.2013", @"2013")
-#define kJBStringLabeJanuary localize(@"label.january", @"January")
-#define kJBStringLabelDecember localize(@"label.august", @"December")
-#define kJBStringLabelAverageMonthlyRainfall localize(@"label.annual.monthly.rainfall", @"Average Monthly Rainfall")
-#define kJBStringLabelAverageAnnualRainfall localize(@"label.average.annual.rainfall", @"Average Annual Rainfall")
-#define kJBStringLabelSanFrancisco localize(@"label.san.francisco", @"San Francisco")
+#define kJBStringLabelSanFrancisco2013 localize(@"label.san.francisco.2013", @"San Francisco - 2013")
+#define kJBStringLabelAverageDailyRainfall localize(@"label.average.daily.rainfall", @"Average Daily Rainfall")
 #define kJBStringLabelMm localize(@"label.mm", @"mm")
+#define kJBStringLabelMetropolitanAverage localize(@"label.metropolitan.average", @"Metropolitan Average")
+#define kJBStringLabelNationalAverage localize(@"label.national.average", @"National Average")

JBChartViewDemo/JBChartViewDemo/Constants/JBUIConstants.h

@@ -6,11 +6,6 @@
 //  Copyright (c) 2013 Jawbone. All rights reserved.
 //
 
-#pragma mark - Numerics
-
-#define kJBNumericDefaultPadding 10.0f
-#define kJBNumericDefaultAnimationDuration 0.25f
-
 #pragma mark - Images
 
 #define kJBImageIconJawboneLogo @"icon-jawbone-logo.png"

JBChartViewDemo/JBChartViewDemo/Controllers/Base/JBBaseChartViewController.h

@@ -0,0 +1,27 @@
+//
+//  JBBaseChartViewController.h
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/13/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import "JBBaseViewController.h"
+
+// Views
+#import "JBChartTooltipView.h"
+#import "JBChartView.h"
+
+@interface JBBaseChartViewController : JBBaseViewController
+
+@property (nonatomic, strong, readonly) JBChartTooltipView *tooltipView;
+@property (nonatomic, assign) BOOL tooltipVisible;
+
+// Settres
+- (void)setTooltipVisible:(BOOL)tooltipVisible animated:(BOOL)animated atTouchPoint:(CGPoint)touchPoint;
+- (void)setTooltipVisible:(BOOL)tooltipVisible animated:(BOOL)animated;
+
+// Getters
+- (JBChartView *)chartView; // subclasses to return chart instance for tooltip functionality
+
+@end

JBChartViewDemo/JBChartViewDemo/Controllers/Base/JBBaseChartViewController.m

@@ -0,0 +1,130 @@
+//
+//  JBBaseChartViewController.m
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/13/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import "JBBaseChartViewController.h"
+
+// Views
+#import "JBChartTooltipTipView.h"
+
+// Numerics
+CGFloat const kJBBaseChartViewControllerAnimationDuration = 0.25f;
+
+@interface JBBaseChartViewController ()
+
+@property (nonatomic, strong) JBChartTooltipView *tooltipView;
+@property (nonatomic, strong) JBChartTooltipTipView *tooltipTipView;
+
+@end
+
+@implementation JBBaseChartViewController
+
+#pragma mark - Setters
+
+- (void)setTooltipVisible:(BOOL)tooltipVisible animated:(BOOL)animated atTouchPoint:(CGPoint)touchPoint
+{
+    _tooltipVisible = tooltipVisible;
+    
+    JBChartView *chartView = [self chartView];
+    
+    if (!chartView)
+    {
+        return;
+    }
+    
+    if (!self.tooltipView)
+    {
+        self.tooltipView = [[JBChartTooltipView alloc] init];
+        self.tooltipView.alpha = 0.0;
+        [self.view addSubview:self.tooltipView];
+    }
+    
+    if (!self.tooltipTipView)
+    {
+        self.tooltipTipView = [[JBChartTooltipTipView alloc] init];
+        self.tooltipTipView.alpha = 0.0;
+        [self.view addSubview:self.tooltipTipView];
+    }
+    
+    dispatch_block_t adjustTooltipPosition = ^{
+        CGPoint originalTouchPoint = [self.view convertPoint:touchPoint fromView:chartView];
+        CGPoint convertedTouchPoint = originalTouchPoint; // modified
+        JBChartView *chartView = [self chartView];
+        if (chartView)
+        {
+            CGFloat minChartX = (chartView.frame.origin.x + ceil(self.tooltipView.frame.size.width * 0.5));
+            if (convertedTouchPoint.x < minChartX)
+            {
+                convertedTouchPoint.x = minChartX;
+            }
+            CGFloat maxChartX = (chartView.frame.origin.x + chartView.frame.size.width - ceil(self.tooltipView.frame.size.width * 0.5));
+            if (convertedTouchPoint.x > maxChartX)
+            {
+                convertedTouchPoint.x = maxChartX;
+            }
+            self.tooltipView.frame = CGRectMake(convertedTouchPoint.x - ceil(self.tooltipView.frame.size.width * 0.5), CGRectGetMaxY(chartView.headerView.frame), self.tooltipView.frame.size.width, self.tooltipView.frame.size.height);
+            
+            CGFloat minTipX = (chartView.frame.origin.x + self.tooltipTipView.frame.size.width);
+            if (originalTouchPoint.x < minTipX)
+            {
+                originalTouchPoint.x = minTipX;
+            }
+            CGFloat maxTipX = (chartView.frame.origin.x + chartView.frame.size.width - self.tooltipTipView.frame.size.width);
+            if (originalTouchPoint.x > maxTipX)
+            {
+                originalTouchPoint.x = maxTipX;
+            }
+            self.tooltipTipView.frame = CGRectMake(originalTouchPoint.x - ceil(self.tooltipTipView.frame.size.width * 0.5), CGRectGetMaxY(self.tooltipView.frame), self.tooltipTipView.frame.size.width, self.tooltipTipView.frame.size.height);
+        }
+    };
+    
+    dispatch_block_t adjustTooltipVisibility = ^{
+        self.tooltipView.alpha = _tooltipVisible ? 1.0 : 0.0;
+        self.tooltipTipView.alpha = _tooltipVisible ? 1.0 : 0.0;
+	};
+    
+    if (tooltipVisible)
+    {
+        adjustTooltipPosition();
+    }
+    
+    if (animated)
+    {
+        [UIView animateWithDuration:kJBBaseChartViewControllerAnimationDuration animations:^{
+            adjustTooltipVisibility();
+        } completion:^(BOOL finished) {
+            if (!tooltipVisible)
+            {
+                adjustTooltipPosition();
+            }
+        }];
+    }
+    else
+    {
+        adjustTooltipVisibility();
+    }
+}
+
+- (void)setTooltipVisible:(BOOL)tooltipVisible animated:(BOOL)animated
+{
+    [self setTooltipVisible:tooltipVisible animated:animated atTouchPoint:CGPointZero];
+}
+
+- (void)setTooltipVisible:(BOOL)tooltipVisible
+{
+    [self setTooltipVisible:tooltipVisible animated:NO];
+}
+
+#pragma mark - Getters
+
+- (JBChartView *)chartView
+{
+    // Subclasses should return chart instance for tooltip functionality
+    return nil;
+}
+
+@end

JBChartViewDemo/JBChartViewDemo/Controllers/Base/JBBaseNavigationController.m

@@ -20,6 +20,7 @@
         self.navigationBar.translucent = NO;
         [[UINavigationBar appearance] setBarTintColor:kJBColorNavigationTint];
         [[UINavigationBar appearance] setTintColor:kJBColorNavigationBarTint];
+        self.interactivePopGestureRecognizer.enabled = NO;
     }
     return self;
 }

JBChartViewDemo/JBChartViewDemo/Controllers/JBBarChartViewController.h

@@ -6,8 +6,8 @@
 //  Copyright (c) 2013 Jawbone. All rights reserved.
 //
 
-#import "JBBaseViewController.h"
+#import "JBBaseChartViewController.h"
 
-@interface JBBarChartViewController : JBBaseViewController
+@interface JBBarChartViewController : JBBaseChartViewController
 
 @end

JBChartViewDemo/JBChartViewDemo/Controllers/JBBarChartViewController.m

@@ -16,14 +16,15 @@
 
 // Numerics
 CGFloat const kJBBarChartViewControllerChartHeight = 250.0f;
+CGFloat const kJBBarChartViewControllerChartPadding = 10.0f;
 CGFloat const kJBBarChartViewControllerChartHeaderHeight = 80.0f;
 CGFloat const kJBBarChartViewControllerChartHeaderPadding = 10.0f;
 CGFloat const kJBBarChartViewControllerChartFooterHeight = 25.0f;
 CGFloat const kJBBarChartViewControllerChartFooterPadding = 5.0f;
 CGFloat const kJBBarChartViewControllerBarPadding = 1;
 NSInteger const kJBBarChartViewControllerNumBars = 12;
-NSInteger const kJBBarChartViewControllerMaxBarHeight = 100; // max random value
-NSInteger const kJBBarChartViewControllerMinBarHeight = 20;
+NSInteger const kJBBarChartViewControllerMaxBarHeight = 10;
+NSInteger const kJBBarChartViewControllerMinBarHeight = 5;
 
 // Strings
 NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
@@ -52,8 +53,27 @@ NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
     self = [super init];
     if (self)
     {
-        [self initFakeData]; // fake rain data
-        _monthlySymbols = [[[NSDateFormatter alloc] init] monthSymbols];
+        [self initFakeData];
+    }
+    return self;
+}
+
+- (id)initWithCoder:(NSCoder *)aDecoder
+{
+    self = [super initWithCoder:aDecoder];
+    if (self)
+    {
+        [self initFakeData];
+    }
+    return self;
+}
+
+- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
+{
+    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
+    if (self)
+    {
+        [self initFakeData];
     }
     return self;
 }
@@ -65,9 +85,12 @@ NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
     NSMutableArray *mutableChartData = [NSMutableArray array];
     for (int i=0; i<kJBBarChartViewControllerNumBars; i++)
     {
-        [mutableChartData addObject:[NSNumber numberWithFloat:MAX(kJBBarChartViewControllerMinBarHeight, arc4random() % kJBBarChartViewControllerMaxBarHeight)]]; // fake height
+        NSInteger delta = (kJBBarChartViewControllerNumBars - abs((kJBBarChartViewControllerNumBars - i) - i)) + 2;
+        [mutableChartData addObject:[NSNumber numberWithFloat:MAX((delta * kJBBarChartViewControllerMinBarHeight), arc4random() % (delta * kJBBarChartViewControllerMaxBarHeight))]];
+
     }
     _chartData = [NSArray arrayWithArray:mutableChartData];
+    _monthlySymbols = [[[NSDateFormatter alloc] init] shortMonthSymbols];
 }
 
 #pragma mark - View Lifecycle
@@ -79,23 +102,24 @@ NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
     self.view.backgroundColor = kJBColorBarChartControllerBackground;
     self.navigationItem.rightBarButtonItem = [self chartToggleButtonWithTarget:self action:@selector(chartToggleButtonPressed:)];
 
-    self.barChartView = [[JBBarChartView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, kJBNumericDefaultPadding, self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBBarChartViewControllerChartHeight)];
+    self.barChartView = [[JBBarChartView alloc] init];
+    self.barChartView.frame = CGRectMake(kJBBarChartViewControllerChartPadding, kJBBarChartViewControllerChartPadding, self.view.bounds.size.width - (kJBBarChartViewControllerChartPadding * 2), kJBBarChartViewControllerChartHeight);
     self.barChartView.delegate = self;
     self.barChartView.dataSource = self;
     self.barChartView.headerPadding = kJBBarChartViewControllerChartHeaderPadding;
     self.barChartView.backgroundColor = kJBColorBarChartBackground;
     
-    JBChartHeaderView *headerView = [[JBChartHeaderView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBBarChartViewControllerChartHeaderHeight * 0.5), self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBBarChartViewControllerChartHeaderHeight)];
-    headerView.titleLabel.text = [kJBStringLabelAverageMonthlyRainfall uppercaseString];
-    headerView.subtitleLabel.text = [NSString stringWithFormat:@"%@ - %@", kJBStringLabelSanFrancisco, kJBStringLabel2013];
+    JBChartHeaderView *headerView = [[JBChartHeaderView alloc] initWithFrame:CGRectMake(kJBBarChartViewControllerChartPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBBarChartViewControllerChartHeaderHeight * 0.5), self.view.bounds.size.width - (kJBBarChartViewControllerChartPadding * 2), kJBBarChartViewControllerChartHeaderHeight)];
+    headerView.titleLabel.text = [kJBStringLabelAverageMonthlyTemperature uppercaseString];
+    headerView.subtitleLabel.text = kJBStringLabel2012;
     headerView.separatorColor = kJBColorBarChartHeaderSeparatorColor;
     self.barChartView.headerView = headerView;
     
-    JBBarChartFooterView *footerView = [[JBBarChartFooterView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBBarChartViewControllerChartFooterHeight * 0.5), self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBBarChartViewControllerChartFooterHeight)];
+    JBBarChartFooterView *footerView = [[JBBarChartFooterView alloc] initWithFrame:CGRectMake(kJBBarChartViewControllerChartPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBBarChartViewControllerChartFooterHeight * 0.5), self.view.bounds.size.width - (kJBBarChartViewControllerChartPadding * 2), kJBBarChartViewControllerChartFooterHeight)];
     footerView.padding = kJBBarChartViewControllerChartFooterPadding;
-    footerView.leftLabel.text = [kJBStringLabeJanuary uppercaseString];
+    footerView.leftLabel.text = [[self.monthlySymbols firstObject] uppercaseString];
     footerView.leftLabel.textColor = [UIColor whiteColor];
-    footerView.rightLabel.text = [kJBStringLabelDecember uppercaseString];
+    footerView.rightLabel.text = [[self.monthlySymbols lastObject] uppercaseString];
     footerView.rightLabel.textColor = [UIColor whiteColor];
     self.barChartView.footerView = footerView;
     
@@ -106,60 +130,57 @@ NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
     [self.barChartView reloadData];
 }
 
-- (void)viewDidAppear:(BOOL)animated
-{
-    [super viewDidAppear:animated];
-    [self.barChartView setState:JBChartViewStateExpanded animated:YES callback:nil];
-}
-
 - (void)viewWillAppear:(BOOL)animated
 {
     [super viewWillAppear:animated];
-    [self.barChartView setState:JBChartViewStateCollapsed];
+    [self.barChartView setState:JBChartViewStateExpanded];
 }
 
 #pragma mark - JBBarChartViewDelegate
 
-- (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSInteger)index
+- (CGFloat)barChartView:(JBBarChartView *)barChartView heightForBarViewAtAtIndex:(NSUInteger)index
 {
     return [[self.chartData objectAtIndex:index] floatValue];
 }
 
 #pragma mark - JBBarChartViewDataSource
 
-- (NSInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView
+- (NSUInteger)numberOfBarsInBarChartView:(JBBarChartView *)barChartView
 {
     return kJBBarChartViewControllerNumBars;
 }
 
-- (NSInteger)barPaddingForBarChartView:(JBBarChartView *)barChartView
+- (NSUInteger)barPaddingForBarChartView:(JBBarChartView *)barChartView
 {
     return kJBBarChartViewControllerBarPadding;
 }
 
-- (UIView *)barViewForBarChartView:(JBBarChartView *)barChartView atIndex:(NSInteger)index
+- (UIView *)barChartView:(JBBarChartView *)barChartView barViewAtIndex:(NSUInteger)index
 {
     UIView *barView = [[UIView alloc] init];
     barView.backgroundColor = (index % 2 == 0) ? kJBColorBarChartBarBlue : kJBColorBarChartBarGreen;
     return barView;
 }
 
-- (UIColor *)selectionBarColorForBarChartView:(JBBarChartView *)barChartView
+- (UIColor *)barSelectionColorForBarChartView:(JBBarChartView *)barChartView
 {
     return [UIColor whiteColor];
 }
 
-- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSInteger)index
+- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSUInteger)index touchPoint:(CGPoint)touchPoint
 {
     NSNumber *valueNumber = [self.chartData objectAtIndex:index];
-    [self.informationView setValueText:[NSString stringWithFormat:@"%d", [valueNumber intValue]] unitText:kJBStringLabelMm];
-    [self.informationView setTitleText:[self.monthlySymbols objectAtIndex:index]];
+    [self.informationView setValueText:[NSString stringWithFormat:kJBStringLabelDegreesFahrenheit, [valueNumber intValue], kJBStringLabelDegreeSymbol] unitText:nil];
+    [self.informationView setTitleText:kJBStringLabelWorldwideAverage];
     [self.informationView setHidden:NO animated:YES];
+    [self setTooltipVisible:YES animated:YES atTouchPoint:touchPoint];
+    [self.tooltipView setText:[[self.monthlySymbols objectAtIndex:index] uppercaseString]];
 }
 
-- (void)barChartView:(JBBarChartView *)barChartView didUnselectBarAtIndex:(NSInteger)index
+- (void)didUnselectBarChartView:(JBBarChartView *)barChartView
 {
     [self.informationView setHidden:YES animated:YES];
+    [self setTooltipVisible:NO animated:YES];
 }
 
 #pragma mark - Buttons
@@ -177,4 +198,11 @@ NSString * const kJBBarChartViewControllerNavButtonViewKey = @"view";
     }];
 }
 
+#pragma mark - Overrides
+
+- (JBChartView *)chartView
+{
+    return self.barChartView;
+}
+
 @end

JBChartViewDemo/JBChartViewDemo/Controllers/JBChartListViewController.m

@@ -51,8 +51,8 @@ NSInteger const kJBChartListViewControllerCellHeight = 100;
 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
 {
     JBChartTableCell *cell = [tableView dequeueReusableCellWithIdentifier:kJBChartListViewControllerCellIdentifier forIndexPath:indexPath];    
-    cell.textLabel.text = indexPath.row == JBChartListViewControllerRowLineChart ? kJBStringLabelAverageAnnualRainfall : kJBStringLabelAverageMonthlyRainfall;
-    cell.detailTextLabel.text = kJBStringLabelSanFrancisco;
+    cell.textLabel.text = indexPath.row == JBChartListViewControllerRowLineChart ? kJBStringLabelAverageDailyRainfall : kJBStringLabelAverageMonthlyTemperature;
+    cell.detailTextLabel.text = indexPath.row == JBChartListViewControllerRowLineChart ? kJBStringLabelSanFrancisco2013 : kJBStringLabelWorldwide2012;
     cell.type = indexPath.row == JBChartListViewControllerRowLineChart ? JBChartTableCellTypeLineChart : JBChartTableCellTypeBarChart;
     return cell;
 }

JBChartViewDemo/JBChartViewDemo/Controllers/JBLineChartViewController.h

@@ -6,8 +6,8 @@
 //  Copyright (c) 2013 Jawbone. All rights reserved.
 //
 
-#import "JBBaseViewController.h"
+#import "JBBaseChartViewController.h"
 
-@interface JBLineChartViewController : JBBaseViewController
+@interface JBLineChartViewController : JBBaseChartViewController
 
 @end

JBChartViewDemo/JBChartViewDemo/Controllers/JBLineChartViewController.m

@@ -16,12 +16,21 @@
 
 #define ARC4RANDOM_MAX 0x100000000
 
+typedef NS_ENUM(NSInteger, JBLineChartLine){
+	JBLineChartLineSolid,
+    JBLineChartLineDashed,
+    JBLineChartLineCount
+};
+
 // Numerics
 CGFloat const kJBLineChartViewControllerChartHeight = 250.0f;
+CGFloat const kJBLineChartViewControllerChartPadding = 10.0f;
 CGFloat const kJBLineChartViewControllerChartHeaderHeight = 75.0f;
 CGFloat const kJBLineChartViewControllerChartHeaderPadding = 20.0f;
 CGFloat const kJBLineChartViewControllerChartFooterHeight = 20.0f;
-NSInteger const kJBLineChartViewControllerNumChartPoints = 27;
+CGFloat const kJBLineChartViewControllerChartSolidLineWidth = 6.0f;
+CGFloat const kJBLineChartViewControllerChartDashedLineWidth = 2.0f;
+NSInteger const kJBLineChartViewControllerMaxNumChartPoints = 7;
 
 // Strings
 NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
@@ -31,12 +40,14 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
 @property (nonatomic, strong) JBLineChartView *lineChartView;
 @property (nonatomic, strong) JBChartInformationView *informationView;
 @property (nonatomic, strong) NSArray *chartData;
+@property (nonatomic, strong) NSArray *daysOfWeek;
 
 // Buttons
 - (void)chartToggleButtonPressed:(id)sender;
 
 // Helpers
 - (void)initFakeData;
+- (NSArray *)largestLineData; // largest collection of fake line data
 
 @end
 
@@ -49,7 +60,27 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
     self = [super init];
     if (self)
     {
-        [self initFakeData]; // fake rain data
+        [self initFakeData];
+    }
+    return self;
+}
+
+- (id)initWithCoder:(NSCoder *)aDecoder
+{
+    self = [super initWithCoder:aDecoder];
+    if (self)
+    {
+        [self initFakeData];
+    }
+    return self;
+}
+
+- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
+{
+    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
+    if (self)
+    {
+        [self initFakeData];
     }
     return self;
 }
@@ -58,12 +89,31 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
 
 - (void)initFakeData
 {
-    NSMutableArray *mutableChartData = [NSMutableArray array];
-    for (int i=0; i<kJBLineChartViewControllerNumChartPoints; i++)
+    NSMutableArray *mutableLineCharts = [NSMutableArray array];
+    for (int lineIndex=0; lineIndex<JBLineChartLineCount; lineIndex++)
     {
-        [mutableChartData addObject:[NSNumber numberWithFloat:((double)arc4random() / ARC4RANDOM_MAX)]]; // random number between 0 and 1
+        NSMutableArray *mutableChartData = [NSMutableArray array];
+        for (int i=0; i<kJBLineChartViewControllerMaxNumChartPoints; i++)
+        {
+            [mutableChartData addObject:[NSNumber numberWithFloat:((double)arc4random() / ARC4RANDOM_MAX)]]; // random number between 0 and 1
+        }
+        [mutableLineCharts addObject:mutableChartData];
     }
-    _chartData = [NSArray arrayWithArray:mutableChartData];
+    _chartData = [NSArray arrayWithArray:mutableLineCharts];
+    _daysOfWeek = [[[NSDateFormatter alloc] init] shortWeekdaySymbols];
+}
+
+- (NSArray *)largestLineData
+{
+    NSArray *largestLineData = nil;
+    for (NSArray *lineData in self.chartData)
+    {
+        if ([lineData count] > [largestLineData count])
+        {
+            largestLineData = lineData;
+        }
+    }
+    return largestLineData;
 }
 
 #pragma mark - View Lifecycle
@@ -75,36 +125,37 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
     self.view.backgroundColor = kJBColorLineChartControllerBackground;
     self.navigationItem.rightBarButtonItem = [self chartToggleButtonWithTarget:self action:@selector(chartToggleButtonPressed:)];
         
-    self.lineChartView = [[JBLineChartView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, kJBNumericDefaultPadding, self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBLineChartViewControllerChartHeight)];
+    self.lineChartView = [[JBLineChartView alloc] init];
+    self.lineChartView.frame = CGRectMake(kJBLineChartViewControllerChartPadding, kJBLineChartViewControllerChartPadding, self.view.bounds.size.width - (kJBLineChartViewControllerChartPadding * 2), kJBLineChartViewControllerChartHeight);
     self.lineChartView.delegate = self;
     self.lineChartView.dataSource = self;
     self.lineChartView.headerPadding = kJBLineChartViewControllerChartHeaderPadding;
     self.lineChartView.backgroundColor = kJBColorLineChartBackground;
     
-    JBChartHeaderView *headerView = [[JBChartHeaderView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBLineChartViewControllerChartHeaderHeight * 0.5), self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBLineChartViewControllerChartHeaderHeight)];
-    headerView.titleLabel.text = [kJBStringLabelAverageAnnualRainfall uppercaseString];
+    JBChartHeaderView *headerView = [[JBChartHeaderView alloc] initWithFrame:CGRectMake(kJBLineChartViewControllerChartPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBLineChartViewControllerChartHeaderHeight * 0.5), self.view.bounds.size.width - (kJBLineChartViewControllerChartPadding * 2), kJBLineChartViewControllerChartHeaderHeight)];
+    headerView.titleLabel.text = [kJBStringLabelAverageDailyRainfall uppercaseString];
     headerView.titleLabel.textColor = kJBColorLineChartHeader;
     headerView.titleLabel.shadowColor = [UIColor colorWithWhite:1.0 alpha:0.25];
     headerView.titleLabel.shadowOffset = CGSizeMake(0, 1);
-    headerView.subtitleLabel.text = [kJBStringLabelSanFrancisco uppercaseString];
+    headerView.subtitleLabel.text = kJBStringLabel2013;
     headerView.subtitleLabel.textColor = kJBColorLineChartHeader;
     headerView.subtitleLabel.shadowColor = [UIColor colorWithWhite:1.0 alpha:0.25];
     headerView.subtitleLabel.shadowOffset = CGSizeMake(0, 1);
     headerView.separatorColor = kJBColorLineChartHeaderSeparatorColor;
     self.lineChartView.headerView = headerView;
     
-    JBLineChartFooterView *footerView = [[JBLineChartFooterView alloc] initWithFrame:CGRectMake(kJBNumericDefaultPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBLineChartViewControllerChartFooterHeight * 0.5), self.view.bounds.size.width - (kJBNumericDefaultPadding * 2), kJBLineChartViewControllerChartFooterHeight)];
+    JBLineChartFooterView *footerView = [[JBLineChartFooterView alloc] initWithFrame:CGRectMake(kJBLineChartViewControllerChartPadding, ceil(self.view.bounds.size.height * 0.5) - ceil(kJBLineChartViewControllerChartFooterHeight * 0.5), self.view.bounds.size.width - (kJBLineChartViewControllerChartPadding * 2), kJBLineChartViewControllerChartFooterHeight)];
     footerView.backgroundColor = [UIColor clearColor];
-    footerView.leftLabel.text = kJBStringLabel1987;
+    footerView.leftLabel.text = [[self.daysOfWeek firstObject] uppercaseString];
     footerView.leftLabel.textColor = [UIColor whiteColor];
-    footerView.rightLabel.text = kJBStringLabel2013;
+    footerView.rightLabel.text = [[self.daysOfWeek lastObject] uppercaseString];;
     footerView.rightLabel.textColor = [UIColor whiteColor];
-    footerView.sectionCount = kJBLineChartViewControllerNumChartPoints;
+    footerView.sectionCount = [[self largestLineData] count];
     self.lineChartView.footerView = footerView;
     
     [self.view addSubview:self.lineChartView];
     
-    self.informationView = [[JBChartInformationView alloc] initWithFrame:CGRectMake(self.view.bounds.origin.x, CGRectGetMaxY(self.lineChartView.frame), self.view.bounds.size.width, self.view.bounds.size.height - CGRectGetMaxY(self.lineChartView.frame) - CGRectGetMaxY(self.navigationController.navigationBar.frame)) layout:JBChartInformationViewLayoutVertical];
+    self.informationView = [[JBChartInformationView alloc] initWithFrame:CGRectMake(self.view.bounds.origin.x, CGRectGetMaxY(self.lineChartView.frame), self.view.bounds.size.width, self.view.bounds.size.height - CGRectGetMaxY(self.lineChartView.frame) - CGRectGetMaxY(self.navigationController.navigationBar.frame))];
     [self.informationView setValueAndUnitTextColor:[UIColor colorWithWhite:1.0 alpha:0.75]];
     [self.informationView setTitleTextColor:kJBColorLineChartHeader];
     [self.informationView setTextShadowColor:nil];
@@ -114,55 +165,82 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
     [self.lineChartView reloadData];
 }
 
-- (void)viewDidAppear:(BOOL)animated
-{
-    [super viewDidAppear:animated];
-    [self.lineChartView setState:JBChartViewStateExpanded animated:YES];
-}
-
 - (void)viewWillAppear:(BOOL)animated
 {
     [super viewWillAppear:animated];
-    [self.lineChartView setState:JBChartViewStateCollapsed];
+    [self.lineChartView setState:JBChartViewStateExpanded];
 }
 
 #pragma mark - JBLineChartViewDelegate
 
-- (CGFloat)lineChartView:(JBLineChartView *)lineChartView heightForIndex:(NSInteger)index
+- (CGFloat)lineChartView:(JBLineChartView *)lineChartView verticalValueForHorizontalIndex:(NSUInteger)horizontalIndex atLineIndex:(NSUInteger)lineIndex
 {
-    return [[self.chartData objectAtIndex:index] floatValue];
+    return [[[self.chartData objectAtIndex:lineIndex] objectAtIndex:horizontalIndex] floatValue];
 }
 
-- (void)lineChartView:(JBLineChartView *)lineChartView didSelectChartAtIndex:(NSInteger)index
+- (void)lineChartView:(JBLineChartView *)lineChartView didSelectLineAtIndex:(NSUInteger)lineIndex horizontalIndex:(NSUInteger)horizontalIndex touchPoint:(CGPoint)touchPoint
 {
-    NSNumber *valueNumber = [self.chartData objectAtIndex:index];
+    NSNumber *valueNumber = [[self.chartData objectAtIndex:lineIndex] objectAtIndex:horizontalIndex];
     [self.informationView setValueText:[NSString stringWithFormat:@"%.2f", [valueNumber floatValue]] unitText:kJBStringLabelMm];
-    [self.informationView setTitleText:[NSString stringWithFormat:@"%d", [kJBStringLabel1987 intValue] + (int)index]];
+    [self.informationView setTitleText:lineIndex == JBLineChartLineSolid ? kJBStringLabelMetropolitanAverage : kJBStringLabelNationalAverage];
     [self.informationView setHidden:NO animated:YES];
+    [self setTooltipVisible:YES animated:YES atTouchPoint:touchPoint];
+    [self.tooltipView setText:[[self.daysOfWeek objectAtIndex:horizontalIndex] uppercaseString]];
 }
 
-- (void)lineChartView:(JBLineChartView *)lineChartView didUnselectChartAtIndex:(NSInteger)index
+- (void)didUnselectLineInLineChartView:(JBLineChartView *)lineChartView
 {
     [self.informationView setHidden:YES animated:YES];
+    [self setTooltipVisible:NO animated:YES];
 }
 
 #pragma mark - JBLineChartViewDataSource
 
-- (NSInteger)numberOfPointsInLineChartView:(JBLineChartView *)lineChartView
+- (NSUInteger)numberOfLinesInLineChartView:(JBLineChartView *)lineChartView
 {
     return [self.chartData count];
 }
 
-- (UIColor *)lineColorForLineChartView:(JBLineChartView *)lineChartView
+- (NSUInteger)lineChartView:(JBLineChartView *)lineChartView numberOfVerticalValuesAtLineIndex:(NSUInteger)lineIndex
 {
-    return kJBColorLineChartLineColor;
+    return [[self.chartData objectAtIndex:lineIndex] count];
 }
 
-- (UIColor *)selectionColorForLineChartView:(JBLineChartView *)lineChartView
+- (UIColor *)lineChartView:(JBLineChartView *)lineChartView colorForLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return (lineIndex == JBLineChartLineSolid) ? kJBColorLineChartDefaultSolidLineColor: kJBColorLineChartDefaultDashedLineColor;
+}
+
+- (CGFloat)lineChartView:(JBLineChartView *)lineChartView widthForLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return (lineIndex == JBLineChartLineSolid) ? kJBLineChartViewControllerChartSolidLineWidth: kJBLineChartViewControllerChartDashedLineWidth;
+}
+
+- (UIColor *)verticalSelectionColorForLineChartView:(JBLineChartView *)lineChartView
 {
     return [UIColor whiteColor];
 }
 
+- (UIColor *)lineChartView:(JBLineChartView *)lineChartView selectionColorForLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return (lineIndex == JBLineChartLineSolid) ? kJBColorLineChartDefaultSolidSelectedLineColor: kJBColorLineChartDefaultDashedSelectedLineColor;
+}
+
+- (JBLineChartViewLineStyle)lineChartView:(JBLineChartView *)lineChartView lineStyleForLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return (lineIndex == JBLineChartLineSolid) ? JBLineChartViewLineStyleSolid : JBLineChartViewLineStyleDashed;
+}
+
+- (BOOL)lineChartView:(JBLineChartView *)lineChartView showsDotsForLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return lineIndex == JBLineChartViewLineStyleDashed;
+}
+
+- (BOOL)lineChartView:(JBLineChartView *)lineChartView smoothLineAtLineIndex:(NSUInteger)lineIndex
+{
+    return lineIndex == JBLineChartViewLineStyleSolid;
+}
+
 #pragma mark - Buttons
 
 - (void)chartToggleButtonPressed:(id)sender
@@ -178,4 +256,11 @@ NSString * const kJBLineChartViewControllerNavButtonViewKey = @"view";
     }];
 }
 
+#pragma mark - Overrides
+
+- (JBChartView *)chartView
+{
+    return self.lineChartView;
+}
+
 @end

JBChartViewDemo/JBChartViewDemo/Footers/JBBarChartFooterView.m

@@ -57,7 +57,6 @@ static UIColor *kJBBarChartFooterPolygonViewDefaultBackgroundColor = nil;
     if (self)
     {
         self.backgroundColor = kJBBarChartFooterPolygonViewDefaultBackgroundColor;
-        self.clipsToBounds = NO;
         
         _footerBackgroundColor = kJBBarChartFooterPolygonViewDefaultBackgroundColor;
         _padding = kJBBarChartFooterPolygonViewDefaultPadding;
@@ -124,7 +123,6 @@ static UIColor *kJBBarChartFooterPolygonViewDefaultBackgroundColor = nil;
     self = [super initWithFrame:frame];
     if (self)
     {
-        self.clipsToBounds = NO;
         self.backgroundColor = [UIColor clearColor];
     }
     return self;

JBChartViewDemo/JBChartViewDemo/Footers/JBLineChartFooterView.m

@@ -39,7 +39,6 @@ static UIColor *kJBLineChartFooterViewDefaultSeparatorColor = nil;
     self = [super initWithFrame:frame];
     if (self)
     {
-        self.clipsToBounds = NO;
         self.backgroundColor = [UIColor clearColor];
         
         _footerSeparatorColor = kJBLineChartFooterViewDefaultSeparatorColor;

JBChartViewDemo/JBChartViewDemo/Misc/JBChartInformationView.h

@@ -8,19 +8,12 @@
 
 #import <Foundation/Foundation.h>
 
-typedef NS_ENUM(NSInteger, JBChartInformationViewLayout){
-	JBChartInformationViewLayoutHorizontal, // default
-    JBChartInformationViewLayoutVertical
-};
-
 @interface JBChartInformationView : UIView
 
 /*
  * View must be initialized with a layout type (default = horizontal)
  */
-- (id)initWithFrame:(CGRect)frame layout:(JBChartInformationViewLayout)layout;
-
-@property (nonatomic, assign, readonly) JBChartInformationViewLayout layout; // read-only (must be set in init..)
+- (id)initWithFrame:(CGRect)frame;
 
 // Content
 - (void)setTitleText:(NSString *)titleText;

JBChartViewDemo/JBChartViewDemo/Misc/JBChartInformationView.m

@@ -10,9 +10,10 @@
 
 // Numerics
 CGFloat const kJBChartValueViewPadding = 10.0f;
-CGFloat const kJBChartValueViewSeparatorSize = 1.0f;
+CGFloat const kJBChartValueViewSeparatorSize = 0.5f;
 CGFloat const kJBChartValueViewTitleHeight = 50.0f;
 CGFloat const kJBChartValueViewTitleWidth = 75.0f;
+CGFloat const kJBChartValueViewDefaultAnimationDuration = 0.25f;
 
 // Colors (JBChartInformationView)
 static UIColor *kJBChartViewSeparatorColor = nil;
@@ -58,13 +59,12 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
 	}
 }
 
-- (id)initWithFrame:(CGRect)frame layout:(JBChartInformationViewLayout)layout
+- (id)initWithFrame:(CGRect)frame
 {
     self = [super initWithFrame:frame];
     if (self)
     {
         self.clipsToBounds = YES;
-        _layout = layout;
 
         _titleLabel = [[UILabel alloc] init];
         _titleLabel.font = kJBFontInformationTitle;
@@ -74,7 +74,7 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
         _titleLabel.textColor = kJBChartViewTitleColor;
         _titleLabel.shadowColor = kJBChartViewShadowColor;
         _titleLabel.shadowOffset = CGSizeMake(0, 1);
-        _titleLabel.textAlignment = _layout == JBChartInformationViewLayoutHorizontal ? NSTextAlignmentLeft : NSTextAlignmentCenter;
+        _titleLabel.textAlignment = NSTextAlignmentLeft;
         [self addSubview:_titleLabel];
 
         _separatorView = [[UIView alloc] init];
@@ -89,20 +89,15 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
     return self;
 }
 
-- (id)initWithFrame:(CGRect)frame
-{
-    return [self initWithFrame:frame layout:JBChartInformationViewLayoutHorizontal];
-}
-
 #pragma mark - Position
 
 - (CGRect)valueViewRect
 {
     CGRect valueRect = CGRectZero;
-    valueRect.origin.x = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewPadding : (kJBChartValueViewPadding * 3) + kJBChartValueViewTitleWidth;
-    valueRect.origin.y = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewPadding + kJBChartValueViewTitleHeight : kJBChartValueViewPadding;
-    valueRect.size.width = (self.layout == JBChartInformationViewLayoutHorizontal) ? self.bounds.size.width - (kJBChartValueViewPadding * 2) : self.bounds.size.width - valueRect.origin.x - kJBChartValueViewPadding;
-    valueRect.size.height = (self.layout == JBChartInformationViewLayoutHorizontal) ? self.bounds.size.height - valueRect.origin.y - kJBChartValueViewPadding : self.bounds.size.height - (kJBChartValueViewPadding * 2);
+    valueRect.origin.x = kJBChartValueViewPadding;
+    valueRect.origin.y = kJBChartValueViewPadding + kJBChartValueViewTitleHeight;
+    valueRect.size.width = self.bounds.size.width - (kJBChartValueViewPadding * 2);
+    valueRect.size.height = self.bounds.size.height - valueRect.origin.y - kJBChartValueViewPadding;
     return valueRect;
 }
 
@@ -111,28 +106,21 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
     CGRect titleRect = CGRectZero;
     titleRect.origin.x = kJBChartValueViewPadding;
     titleRect.origin.y = hidden ? -kJBChartValueViewTitleHeight : kJBChartValueViewPadding;
-    titleRect.size.width = (self.layout == JBChartInformationViewLayoutHorizontal) ? self.bounds.size.width - (kJBChartValueViewPadding * 2) : kJBChartValueViewTitleWidth;
-    titleRect.size.height = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewTitleHeight : self.bounds.size.height - (kJBChartValueViewPadding * 2);
+    titleRect.size.width = self.bounds.size.width - (kJBChartValueViewPadding * 2);
+    titleRect.size.height = kJBChartValueViewTitleHeight;
     return titleRect;
 }
 
 - (CGRect)separatorViewRectForHidden:(BOOL)hidden
 {
     CGRect separatorRect = CGRectZero;
-    separatorRect.origin.x = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewPadding : (kJBChartValueViewPadding * 2) + kJBChartValueViewTitleWidth;
-    separatorRect.origin.y = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewTitleHeight : kJBChartValueViewPadding;
-    separatorRect.size.width = (self.layout == JBChartInformationViewLayoutHorizontal) ? self.bounds.size.width - (kJBChartValueViewPadding * 2) : kJBChartValueViewSeparatorSize;
-    separatorRect.size.height = (self.layout == JBChartInformationViewLayoutHorizontal) ? kJBChartValueViewSeparatorSize : self.bounds.size.height - (kJBChartValueViewPadding * 2);
+    separatorRect.origin.x = kJBChartValueViewPadding;
+    separatorRect.origin.y = kJBChartValueViewTitleHeight;
+    separatorRect.size.width = self.bounds.size.width - (kJBChartValueViewPadding * 2);
+    separatorRect.size.height = kJBChartValueViewSeparatorSize;
     if (hidden)
     {
-        if (self.layout == JBChartInformationViewLayoutHorizontal)
-        {
-            separatorRect.origin.x -= self.bounds.size.width;
-        }
-        else
-        {
-            separatorRect.origin.y = self.bounds.size.height;
-        }
+        separatorRect.origin.x -= self.bounds.size.width;
     }
     return separatorRect;
 }
@@ -185,7 +173,7 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
     {
         if (hidden)
         {
-            [UIView animateWithDuration:kJBNumericDefaultAnimationDuration * 0.5 delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
+            [UIView animateWithDuration:kJBChartValueViewDefaultAnimationDuration * 0.5 delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
                 self.titleLabel.alpha = 0.0;
                 self.separatorView.alpha = 0.0;
                 self.valueView.valueLabel.alpha = 0.0;
@@ -197,7 +185,7 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
         }
         else
         {
-            [UIView animateWithDuration:kJBNumericDefaultAnimationDuration delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
+            [UIView animateWithDuration:kJBChartValueViewDefaultAnimationDuration delay:0.0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{
                 self.titleLabel.frame = [self titleViewRectForHidden:NO];
                 self.titleLabel.alpha = 1.0;
                 self.valueView.valueLabel.alpha = 1.0;
@@ -273,14 +261,13 @@ static UIColor *kJBChartInformationViewShadowColor = nil;
 
 - (void)layoutSubviews
 {
-    CGFloat xOffset = kJBChartValueViewPadding;
-    CGFloat width = ceil((self.bounds.size.width - (kJBChartValueViewPadding * 2)) * 0.5);
-    
     CGSize valueLabelSize = [self.valueLabel.text sizeWithAttributes:@{NSFontAttributeName:self.valueLabel.font}];
-    self.valueLabel.frame = CGRectMake(xOffset, ceil(self.bounds.size.height * 0.5) - ceil(valueLabelSize.height * 0.5), width, valueLabelSize.height);
-    
     CGSize unitLabelSize = [self.unitLabel.text sizeWithAttributes:@{NSFontAttributeName:self.unitLabel.font}];
-    self.unitLabel.frame = CGRectMake(CGRectGetMaxX(self.valueLabel.frame), ceil(self.bounds.size.height * 0.5) - ceil(unitLabelSize.height * 0.5) + kJBChartValueViewPadding + 3, width, unitLabelSize.height);
+    
+    CGFloat xOffset = ceil((self.bounds.size.width - (valueLabelSize.width + unitLabelSize.width)) * 0.5);
+
+    self.valueLabel.frame = CGRectMake(xOffset, ceil(self.bounds.size.height * 0.5) - ceil(valueLabelSize.height * 0.5), valueLabelSize.width, valueLabelSize.height);
+    self.unitLabel.frame = CGRectMake(CGRectGetMaxX(self.valueLabel.frame), ceil(self.bounds.size.height * 0.5) - ceil(unitLabelSize.height * 0.5) + kJBChartValueViewPadding + 3, unitLabelSize.width, unitLabelSize.height);
 }
 
 @end

JBChartViewDemo/JBChartViewDemo/Misc/JBChartTooltipTipView.h

@@ -0,0 +1,13 @@
+//
+//  JBChartTooltipTipView.h
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/17/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface JBChartTooltipTipView : UIView
+
+@end

JBChartViewDemo/JBChartViewDemo/Misc/JBChartTooltipTipView.m

@@ -0,0 +1,52 @@
+//
+//  JBChartTooltipTipView.m
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/17/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import "JBChartTooltipTipView.h"
+
+// Numerics
+CGFloat const kJBChartTooltipTipViewDefaultWidth = 8.0f;
+CGFloat const kJBChartTooltipTipViewDefaultHeight = 5.0f;
+
+@implementation JBChartTooltipTipView
+
+#pragma mark - Alloc/Init
+
+- (id)init
+{
+    self = [super initWithFrame:CGRectMake(0, 0, kJBChartTooltipTipViewDefaultWidth, kJBChartTooltipTipViewDefaultHeight)];
+    if (self)
+    {
+        self.backgroundColor = [UIColor clearColor];
+    }
+    return self;
+}
+
+#pragma mark - Drawing
+
+- (void)drawRect:(CGRect)rect
+{
+    [super drawRect:rect];
+    
+    CGContextRef context = UIGraphicsGetCurrentContext();
+    [[UIColor clearColor] set];
+    CGContextFillRect(context, rect);
+    
+    CGContextSaveGState(context);
+    {
+        CGContextBeginPath(context);
+        CGContextMoveToPoint(context, CGRectGetMidX(rect), CGRectGetMaxY(rect));
+        CGContextAddLineToPoint(context, CGRectGetMinX(rect), CGRectGetMinY(rect));
+        CGContextAddLineToPoint(context, CGRectGetMaxX(rect), CGRectGetMinY(rect));
+        CGContextClosePath(context);
+        CGContextSetFillColorWithColor(context, kJBColorTooltipColor.CGColor);
+        CGContextFillPath(context);
+    }
+    CGContextRestoreGState(context);
+}
+
+@end

JBChartViewDemo/JBChartViewDemo/Misc/JBChartTooltipView.h

@@ -0,0 +1,15 @@
+//
+//  JBChartTooltipView.h
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/12/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface JBChartTooltipView : UIView
+
+- (void)setText:(NSString *)text;
+
+@end

JBChartViewDemo/JBChartViewDemo/Misc/JBChartTooltipView.m

@@ -0,0 +1,71 @@
+//
+//  JBChartTooltipView.m
+//  JBChartViewDemo
+//
+//  Created by Terry Worona on 3/12/14.
+//  Copyright (c) 2014 Jawbone. All rights reserved.
+//
+
+#import "JBChartTooltipView.h"
+
+// Drawing
+#import <QuartzCore/QuartzCore.h>
+
+// Numerics
+CGFloat static const kJBChartTooltipViewCornerRadius = 5.0;
+CGFloat const kJBChartTooltipViewDefaultWidth = 50.0f;
+CGFloat const kJBChartTooltipViewDefaultHeight = 25.0f;
+
+@interface JBChartTooltipView ()
+
+@property (nonatomic, strong) UILabel *textLabel;
+
+@end
+
+@implementation JBChartTooltipView
+
+#pragma mark - Alloc/Init
+
+- (id)init
+{
+    self = [super initWithFrame:CGRectMake(0, 0, kJBChartTooltipViewDefaultWidth, kJBChartTooltipViewDefaultHeight)];
+    if (self)
+    {
+        self.backgroundColor = kJBColorTooltipColor;
+        self.layer.cornerRadius = kJBChartTooltipViewCornerRadius;
+        
+        _textLabel = [[UILabel alloc] init];
+        _textLabel.font = kJBFontTooltipText;
+        _textLabel.backgroundColor = [UIColor clearColor];
+        _textLabel.textColor = kJBColorTooltipTextColor;
+        _textLabel.adjustsFontSizeToFitWidth = YES;
+        _textLabel.numberOfLines = 1;
+        _textLabel.textAlignment = NSTextAlignmentCenter;
+        [self addSubview:_textLabel];
+    }
+    return self;
+}
+
+#pragma mark - Setters
+
+- (void)setText:(NSString *)text
+{
+    self.textLabel.text = text;
+    [self setNeedsLayout];
+}
+
+- (void)setTooltipColor:(UIColor *)tooltipColor
+{
+    self.backgroundColor = tooltipColor;
+    [self setNeedsDisplay];
+}
+
+#pragma mark - Layout
+
+- (void)layoutSubviews
+{
+    [super layoutSubviews];
+    _textLabel.frame = self.bounds;
+}
+
+@end

README.md

@@ -1,10 +1,10 @@
 # JBChartView
-
-<center>
+<br/>
+<p align="center">	
 	<img src="https://raw.github.com/Jawbone/JBChartView/master/Screenshots/main.png">
-</center>
+</p>
 
-<b>Introducing JBChartView - </b> Jawbone's iOS-based charting library for both line and bar graphs. It is easy to set-up, and highly customizable. 
+Introducing <b>JBChartView - </b> Jawbone's iOS-based charting library for both line and bar graphs. It is easy to set-up, and highly customizable. 
 
 ## Features
 
@@ -14,6 +14,8 @@
 - Highly customizable.
 - Expand & collapse animation support.
 
+Refer to the <a href="https://github.com/Jawbone/JBChartView/blob/master/CHANGELOG.md"">changelog</a> for an overview of JBChartView's feature history.
+
 ## Requirements
 
 - Requires iOS 7 or later
@@ -36,7 +38,7 @@ Simply add the following line to your <code>Podfile</code>:
 Your Podfile should look something like:
 
 	platform :ios, '7.0'
-	pod 'JBChartView', '~> 1.1.5'
+	pod 'JBChartView', '~> 2.1.2'
 	
 ### The Old School Way
 
@@ -48,11 +50,11 @@ The simpliest way to use JBChartView with your application is to drag and drop t
 
 ## Usage
 
-Both JBChartView implementations have a similiar data source and delgate pattern to <i>UITableView</i>. If you're familiar with using a <i>UITableView</i> or <i>UITableViewController</i>, using a JBChartView subclass should be a breeze!
+All JBChartView implementations have a similiar data source and delgate pattern to <i>UITableView</i>. If you're familiar with using a <i>UITableView</i> or <i>UITableViewController</i>, using a JBChartView subclass should be a breeze!
 
 #### JBBarChartView
 
-To initialize a <i>JBBarChartView</i>, you only need a few lines of code:
+To initialize a <i>JBBarChartView</i>, you only need a few lines of code (see below). Bar charts can also be initialized via a <b>nib</b> or with a <b>frame</b>.
 
 	JBBarChartView *barChartView = [[JBBarChartView alloc] init];
     barChartView.delegate = self;
@@ -72,29 +74,45 @@ Secondly, you need to inform the delegate the height of each bar (automatically
     {
 		return ...; // height of bar at index
 	}
+	
+Lastly, ensure you have set the *frame* of your barChartView & call *reloadData* at least once:
+
+	barChartView.frame = CGRectMake( ... );
+	[barChartView reloadData];
     
 #### JBLineChartView
 
-Similiarily, to initialize a JBLineChartView, you only need a few lines of code:
+Similiarily, to initialize a JBLineChartView, you only need a few lines of code (see below). Line charts can also be initialized via a <b>nib</b> or with a <b>frame</b>.
 
 	JBLineChartView *lineChartView = [[JBLineChartView alloc] init];
     lineChartView.delegate = self;
     lineChartView.dataSource = self;
     [self addSubview:lineChartView];
 
-At a minimum, you need to inform the data source how many points are in the line chart:
+At a minimum, you need to inform the data source how many lines and vertical data points (for each line) are in the chart:
 
-	- (NSInteger)numberOfPointsInLineChartView:(JBLineChartView *)lineChartView
+	- (NSUInteger)numberOfLinesInLineChartView:(JBLineChartView *)lineChartView
 	{
-		return ...; // number of points in chart
+		return ...; // number of lines in chart
+	}
+	
+	- (NSUInteger)lineChartView:(JBLineChartView *)lineChartView numberOfVerticalValuesAtLineIndex:(NSUInteger)lineIndex
+	{
+		return ...; // number of values for a line
 	}
 
-Secondly, you need to inform the delegate the y-position of each point (automatically normalized across the entire chart):
+Secondly, you need to inform the delegate of the y-position of each point (automatically normalized across the entire chart) for each line in the chart:
     
-	- (CGFloat)lineChartView:(JBLineChartView *)lineChartView heightForIndex:(NSInteger)index
+    - (CGFloat)lineChartView:(JBLineChartView *)lineChartView verticalValueForHorizontalIndex:(NSUInteger)horizontalIndex atLineIndex:(NSUInteger)lineIndex
     {
-		return ...; // y-position of poinnt at index (x-axis)
+		return ...; // y-position (y-axis) of point at horizontalIndex (x-axis)
 	}
+
+Lastly, ensure you have set the *frame* of your lineChartView & call *reloadData* at least once:
+
+	lineChartView.frame = CGRectMake( ... );
+	[lineChartView reloadData];
+
 	
 ## Customization
 
@@ -118,61 +136,84 @@ Lastly, any JBChartView subclass can be collapsed or expanded programmatically v
 
 By default, a chart's bars will be black and flat. They can be customized by supplying a UIView subclass through the <i>optional</i> protocol:
 
-	- (UIView *)barViewForBarChartView:(JBBarChartView *)barChartView atIndex:(NSInteger)index
+	- (UIView *)barChartView:(JBBarChartView *)barChartView barViewAtIndex:(NSUInteger)index
 	{
 		return ...; // color of line in chart
 	}
 
 Furthermore, the color of the selection bar (on touch events) can be customized via the <i>optional</i> protocol:
 
-	- (UIColor *)selectionBarColorForBarChartView:(JBBarChartView *)barChartView
+	- (UIColor *)barSelectionColorForBarChartView:(JBBarChartView *)barChartView
 	{
 		return ...; // color of selection view
 	}
 	
 Lastly, a bar chart's selection events are delegated back via:
 
-	- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSInteger)index
+	- (void)barChartView:(JBBarChartView *)barChartView didSelectBarAtIndex:(NSUInteger)index touchPoint:(CGPoint)touchPoint
 	{
 		// Update view
 	}
 
-	- (void)barChartView:(JBBarChartView *)barChartView didUnselectBarAtIndex:(NSInteger)index
+	- (void)didUnselectBarChartView:(JBBarChartView *)barChartView
 	{
 		// Update view
 	}
-	
-A JBBarChartView visuaul overview can be found <a href="https://raw.github.com/Jawbone/JBChartView/master/Screenshots/JBBarChartView.png" target="_blank">here</a>. 
+
+The <b>touchPoint</b> is especially important as it allows you to add custom elements to your chart during  selection events. Refer to the demo project (<b>JBarChartViewController</b>) to see how a tooltip can be used to display additional information during selection events.
 
 #### JBLineChartView
 
-The color of the chart's line can be customized via the <i>optional</i> protocol:
+The color, width and style of each line in the chart can be customized via the <i>optional</i> protocol:
 
-	- (UIColor *)lineColorForLineChartView:(JBLineChartView *)lineChartView
+	- (UIColor *)lineChartView:(JBLineChartView *)lineChartView colorForLineAtLineIndex:(NSUInteger)lineIndex
 	{
 		return ...; // color of line in chart
 	}
 	
-Furthermore, the color of the selection bar (on touch events) can be customized via the <i>optional</i> protocol:
+	- (CGFloat)lineChartView:(JBLineChartView *)lineChartView widthForLineAtLineIndex:(NSUInteger)lineIndex
+	{
+		return ...; // width of line in chart
+	}
+	
+	- (JBLineChartViewLineStyle)lineChartView:(JBLineChartView *)lineChartView lineStyleForLineAtLineIndex:(NSUInteger)lineIndex
+	{
+		return ...; // style of line in chart
+	}
+	
+Furthermore, the color of the selection bar and line can be customized via the <i>optional</i> protocols:
 
-	- (UIColor *)selectionColorForLineChartView:(JBLineChartView *)lineChartView
+	- (UIColor *)verticalSelectionColorForLineChartView:(JBLineChartView *)lineChartView
 	{
 		return ...; // color of selection view
 	}
 	
+	- (UIColor *)lineChartView:(JBLineChartView *)lineChartView selectionColorForLineAtLineIndex:(NSUInteger)lineIndex
+	{
+		return ...; // color of selected line
+	}
+	
+By default, each line will not show dots for each point. To enable this on a per-line basis:
+
+	- (BOOL)lineChartView:(JBLineChartView *)lineChartView showsDotsForLineAtLineIndex:(NSUInteger)lineIndex;
+	
+As well, by default, each line will have squared off end caps and connection points. To enable line smoothing:
+
+	- (BOOL)lineChartView:(JBLineChartView *)lineChartView smoothLineAtLineIndex:(NSUInteger)lineIndex;
+		
 Lastly, a line chart's selection events are delegated back via:
 
-	- (void)lineChartView:(JBLineChartView *)lineChartView didSelectChartAtIndex:(NSInteger)index
+	- (void)lineChartView:(JBLineChartView *)lineChartView didSelectLineAtIndex:(NSUInteger)lineIndex horizontalIndex:(NSUInteger)horizontalIndex touchPoint:(CGPoint)touchPoint
 	{
 		// Update view
 	}
 
-	- (void)lineChartView:(JBLineChartView *)lineChartView didUnselectChartAtIndex:(NSInteger)index
+	- (void)didUnselectLineInLineChartView:(JBLineChartView *)lineChartView
 	{
 		// Update view
 	}
-			
-A JBLineChartView visuaul overview can be found <a href="https://raw.github.com/Jawbone/JBChartView/master/Screenshots/JBLineChartView.png" target="_blank">here</a>.
+	
+The <b>touchPoint</b> is especially important as it allows you to add custom elements to your chart during  selection events. Refer to the demo project (<b>JBLineChartViewController</b>) to see how a tooltip can be used to display additional information during selection events.
 	
 ## License