amcharts.rb 3.2.0.1 → 3.2.0.2

data/vendor/assets/javascripts/amcharts/changeLog.txt

@@ -1,85 +1,135 @@
+#### 3.3.2 ####################################################################################################################
+
+   # You can now set theme for all the charts on your page by setting:
+     AmCharts.theme = AmCharts.themes.light;  // or some other theme
+     If you are creating charts using JavaScript API, not JSON, then this is quite a comfortable way, as you won't need to
+     pass theme to each object you create.
+
+   # bug fix: rendered event was fired only on first render, now it is fired each time the chart is rendered after
+     chart.validateNow(); method is called. This bug caused the export buttons to dissapear after the validateNow() method.
+
+   # chartCursror.showNextAvalable property added (default is false). If true, the graph will display balloon on next
+     available data point if currently hovered item doesn't have value for this graph.
+
+   # graph.periodSpan property added (default is 1). This property can be used by step graphs - you can set how many periods
+     one horizontal line should span.
+
+   # "end" option added to graph.pointPosition property.
+
+
+#### 3.3.1 ####################################################################################################################
+
+   # bug fix - \n was replaced with <br> in category axis and the tag was displayed
+   # bug fix - if lineColorField or dashLengthField or fillColorsField was set, the graph could loose the setting if zoomed.
+
+#### 3.3.0 ####################################################################################################################
+
+   # Since this version amCharts and amMap support themes. This means that instead of seting every property for each graph
+     or axis or any other object, you can set new defaults in a theme file. This will make devs' life a lot easier.
+
+     Currently you can find three themes in amcharts/themes folder - dark.js, light.js and chalk.js To set a theme for a chart,
+     simply set theme property to the name of the file: theme:"light". Note, this will work only if you are creating chart
+     using JSON config. If you do it in old way (JSON config is supported since v 3.2.0), you should pass theme object for
+     each new object you build, for example: var graph = new AmCharts.AmGraph(AmCharts.themes.light);
+
+     We will be adding more themes soon. Check _usingThemes.html file in samples folder to see themes in action.
+
+   # patterns property added to AmSlicedChart and AmCoordinateChart - instead of setting a pattern for a slice/graph, you can
+     pass array of patterns using this property.
+
+   # you can now control zoom-out buttons with the following new properties of AmRectangularChart:
+
+        zoomOutButtonImageSize
+        zoomOutButtonImage
+        zoomOutButtonColor
+        zoomOutButtonAlpha
+        zoomOutButtonRollOverAlpha
+        zoomOutButtonPadding
+
+   # some minor bugs fixed
+
 #### 3.2.0 ####################################################################################################################
 
 
    # AmCharts.makeChart(divID, chartConfig); method added. divID is id of a div where your chart should appear. chartConfig is
      JSON object with chart configuration. Check examples with _JSON_ prefix in samples folder to see this in action.
-     
+
    # type property added to AmChart class. It is required to specify type to one of the following, when creating charts from
      JSON config: serial, xy, radar, pie, gauge, funnel, map, stock
-     
+
    # a possibility to export charts as image/pdf/svg added for all modern browsers except IE9 (IE10 is supported). The
      exporting doesn't require any server side software and is made using js libraries only. Check samples with
      _exporting_ prefix to see this in action. Exporting to SVG doesn't work very properly with stock chart or charts with
      legend (will offer saving multiple files).
-   
-   # You can set any legend items via legend.data property, for example:   
+
+   # You can set any legend items via legend.data property, for example:
      legend.data = [{title:"first", color:"#CC0000", value:50}, {title:"second", color:"#00CC00", value:100}];
-     This allows creating any legend items you want. Call chart.legend.validateNow(); if you change legend's data at run time. 
-   
+     This allows creating any legend items you want. Call chart.legend.validateNow(); if you change legend's data at run time.
+
    # AmAngularGauge supports legend now
-   
+
    # bug fix - if a chart with scrollbar was rotated after the chart is created, the scrollbar's graph was shifted to a wrong
      position.
-     
+
    # bug fix - column graph type wasn't displayed in chart scrollbar (since 3.1.0)
-   
+
    # gridAboveGraphs property added to AmCoordinate chart. This allow to show grid lines above your graphs, as world-famous
      data visualization guru Edward Tufte suggests. Note, this won't work properly with 3D charts.
-   
+
    # negative axis labels rotation possible. You can use values from -90 to -1 for labelRotation property since now.
-   
+
    # bug fix: step line with changing line color was rendered incorrectly if some values were missing.
-   
+
    # bug fix: labelPosition "inside" and "middle" for bar charts fixed.
-   
-   # bug fix: AmAngularGauge chart wasn't firing "rendered" event.   
+
+   # bug fix: AmAngularGauge chart wasn't firing "rendered" event.
 
 
 #### 3.1.1 ####################################################################################################################
 
    # FireFox error messages about style declarations fixed
-   
+
    # Bug fix: maxWidth property of AmBalloon was ignored
-   
+
    # Some other minor bugs fixed
-   
+
 
 #### 3.1.0 ####################################################################################################################
 
      Great new features added - charts now support patterns (can fill bars, lines and slices with images) and can simulate
      hand drawn charts - the lines will be a bit distorted and produce a nice effect. Check our new inspiring samples at
      http://www.amcharts.com/inspiration/ to see new possibilities in action.
-     
+
    # patterns
      Patterns can be set for entire graphs or for individual columns/slices. In case you want to set pattern for a graph, use
      pattern property of AmGraph. If you want to set individual pattern for a column or slice, describe patterns in chart's
      data and set patternField for a graph or pie/funnel chart. Value of pattern should be object with url, width, height of an
      image, optionally it might have x, y, randomX and randomY values. For example:
-     
+
      graph.pattern = {"url":"../amcharts/patterns/black/pattern1.png", "width":4, "height":4};
-     
+
      check amcharts/patterns folder for some patterns. You can create your own patterns and use them.
-     
+
      Note, x, y, randomX and randomY properties won't work with IE8 and older.
-     
+
      Check handDrawnChart.html, pieWithPatterns.html or columnWithPatterns.html examples to see this in action.
-     
+
      Note, 3D bar/Pie charts won't work properly with patterns.
-     
+
    # hand-drawn style
      if you set chart.handDrawn = true, the lines of a chart will be distorted and will produce hand-drawn effect.
      You can also modify chart.handDrawScatter (default value is 2) and chart.handDrawThickness (default value 1) values for
      more scattered view.
-     
+
    # offsetY and offsetX properties added to AmBalloon. Specifies the distance from the mouse position to balloon's pointer.
      You might want to increase distance when using hand drawn style.
-     
+
    # Some minor problems fixed
 
 #### 3.0.1 ####################################################################################################################
-     
+
      Some very minor bugs which usually pop right after big release fixed.
-     
+
 #### 3.0.0 ####################################################################################################################
 
 **** Several files ****
@@ -100,8 +150,8 @@
    # Funnel / Pyramid chart.
      Check funnelChart.html and pyramidChart.html examples. As this chart type has a lot of in common
      with pie chart, we created one base class for these chart types - AmSlicedChart. AmPieChart and AmFunnelChart now extend
-     this class. Visit our online class reference for properties and methods of AmFunnelChart. 
-     
+     this class. Visit our online class reference for properties and methods of AmFunnelChart.
+
    # Angular Gauge
      Supports multiple axes and multiple arrows. Check the following examples: angularGauge.html,
      angularGaugeWithTwoAxes.html, clock.html, clockWithTwoFaces.html. Visit our online class reference for properties and
@@ -112,11 +162,11 @@
     We added lots of new features to our charts and with these features you can create new chart types, like:
 
     # Horizontal or vertical bullet chart - bulletChart.html
-    
+
     # Waterfall chart - waterFallChart.html
-    
+
     # Step chart without risers - lineStepNoRisers.html
-    
+
     # Error chart (both Serial and XY) - errorChart.html
 
 *** Other new features ***
@@ -124,99 +174,99 @@
     # Possibility to show minor grid for both Category and Value axis. minorGridEnabled (default value false) and
       minorGridAlpha (default 0.07) properties added to AxisBase class.
       Example: lineWithScrollAndZoom.html
-      
-    
+
+
     # Possibility to change line graphs' line/fill color on any data point to create highlighted sections of the graph.
       To achieve this, you should set lineColorField and/or fillColorsField for your graph and have a field in your data
       which would contain color values at a point where you want the graph to change it's color.
       Example: lineWithChangingColor.html
-      
-    
+
+
     # Possibility to switch line from solid to dashed. Columns can also have dashed outline. To achieve this, you should set
       dashLengthField for your graph and have a field in your data which would contain dashLength value at a point where you
       want the graph to change from solid to dashed or vice versa.
       Example: lineWithDifferentBulletSizes.html and columnAndLineMix.html
-      
-    
+
+
     # Date strings in data now supported. Even if your chart parses dates, you can pass them as strings in your data � all you
       need to do is to set data date format and the chart will parse dates to date objects. This means that now data for
       date-based chart can be in legit JSON format. dataDateFormat property added to AmSerialChart and AmStockChart.
       Example: lineWithChangingColor.html, lineWithTrendLines.html and some more.
-      
-      
+
+
     # When moving chart cursor over the chart, hovered bullets can change their size. If a graph has bullets and you added
       ChartCursor to the chart, bullets will become bigger when char cursor is over them. graphBulletSize property with
       default value 1.7 added to ChartCursor. If you want to disable this feature, set the value to 1.
       Example: lineWithLogarithmicValueAxis.html, lineWithScrollAndZoom.html and some more.
-      
-    
+
+
     # Legend can now display period value. When user is not hovering the chart, legend can show sum, average, open, close, low
       or high values of selected period. periodValueText added to AmLegend and legendPeriodValueText added to AmGraph to
       achieve this. The tags should be made out of two parts - the name of a field (value / open / close / high / low) and the
       value of the period you want to be show - open / close / high / low / sum / average / count. For example: [[value.sum]]
       means that  sum of all data points of value field in the selected period will be displayed.
       Example: area100PercentStacked.html and areaStacked.html
-      
+
       To achieve the same with stock chart, we added periodValueTextRegular and periodValueTextComparing proprties to
       StockLegend. To show percent period values, you should add "percent." prefix for your tag, for example:
       [[percents.value.close]] means that last percent value of a period will be displayed.
       Example: stockMultiplePanels.html and stockMultipleDataSets.html
-      
-      
+
+
     # Legend markers can now mirror graph�s settings, displaying a line and a real bullet as in the graph itself.
       useGraphSettings property with default value false was added to AmLegend. Note, we also removed "line" and "dashedLine"
       marker types because of this - use the useGraphSettings feature in case you need lines as markers in the legend.
-      Example: lineWithDifferentBulletSizes.html and lineWithMultipleValueAxes.html   
-     
-     
+      Example: lineWithDifferentBulletSizes.html and lineWithMultipleValueAxes.html
+
+
     # Legend now supports custom markers (images). customMarker property was added to AmGraph. You should set path to the image
       which should be displayed in the legend.
-    
-    
+
+
     # Diamond bullet type added. Set graph.bullet = "diamond" to use it.
-    
-    
+
+
     # Dynamic bullet size based on value axis / Error chart.
       Error chart is a regular serial or XY chart with bullet type set to "errorX" or "errorY". The graph should know which axis
       should be used to determine the size of this bullet - that's when graph.bulletAxis property should be set. Besides that,
       you should also set graph.errorField. You can also use other bullet types with this feature too. For example, if you set
       bulletAxis for XY chart, the size of a bullet will change as you zoom the chart.
       Example: errorChart.html
-    
-    
+
+
     # You can specify custom column width for each graph individually. columnWidth property added to AmGraph. Note, you set
       relative width here (0 - 1), not width in pixels.
       Example: bulletChart.html
-      
-    
+
+
     # Columns can be overlaid on other columns, without making axis as stacked. clustered property added to AmGraph. In case you
       want to place graph's columns in front of other columns, set it to false.
       Example: bulletChart.html
-    
-    
+
+
     # Resize grips were made bigger to make life easier for users on touch devices.
-    
-    
+
+
     # Balloons can now display any HTML and CSS inside them. This means you can add images, format text or display just about
       any HTML/CSS content. Because of this new feature, we removed textShadow property of AmBalloon in this version.
       Example: areaStacked.html, barStacked.html and many other.
-      
-      
+
+
     # Balloon now can animate from point to point and also fade out when user moves away from the chart. animationDuration and
       fadeOutDuration properties added to AmBalloon, with default values 0.3. animationDuration property was also added to
       ChartCursor, so that the cursor line would also animate to its position.
       Example: any chart with balloon.
-      
-    
+
+
     # Balloon now can display shadow. shadowColor (default #000000) and shadowAlpha (default 0.4) added to AmBalloon.
       Example: any chart with balloon.
-      
-    
+
+
     # Some default values of AmBalloon changed for a better usability - adjustBorderColor to true, cornerRadius to 0,
       pointerWidth to 6, color to #000000.
       Example: any chart with balloon.
-      
-      
+
+
     # Stock chart can display scrollbar on top of the chart.
       Example: stockIntradayData.html
 
@@ -315,8 +365,8 @@ takes precedence over categoryField. When a chart calls this method, it passes c
 chart's data provider and reference to categoryAxis: categoryFunction(category, dataItem, categoryAxis);
 This method can be used both when category axis parses dates and when it doesn't. If axis parses dates, your
 categoryFunction should return Date object.
-     
-******     
+
+******
 labelFunction added to AxisBase. You can use it to format both Value and Category axis labels. If this function
 is set for ValueAxis, it is called and these parameters are passed: labelFunction(value, valueText, valueAxis);
 Where value is numeric value, valueText is formatted string and valueAxis is a reference to valueAxis object.
@@ -433,7 +483,7 @@ Init event wasn't fired by AmPieChart.
 Step line's corners sometimes were not perfect (one extra pixel could be added
 in the end of horizontal line)
 
-You couldn't change panEventsEnabled of AmChart class after the chart was 
+You couldn't change panEventsEnabled of AmChart class after the chart was
 initialized.
 
 You couldn't chane legend's position after the chart was initialized.
@@ -489,7 +539,7 @@ Printing in IE8 fixed;
 Two typos in property names fixed:
 
 ValueAxis.minMaxMultiplier (instead of minMaxMultiplayer)
-and                                                      
+and
 ValueAxis.synchronizationMultiplier (instead of synchronizationMultiplyer)
 
 We do not longer support old names with errors, so you should adjust names if you use
@@ -501,7 +551,7 @@ some other minor bugs fixed.
 
 ValueAxis.minMaxMultiplier was ignored if min (or max) value was equal to 0.
 In some cases, when legend position was set to "left", chart might be positioned
-incorrectly. 
+incorrectly.
 
 2.7.6
 
@@ -537,7 +587,7 @@ smaller than 1 numbers were formatted incorrectly in some cases.
 2.7.2
 Usabilty with touch devices improved - scrollbar's drag icons has a bigger hit area.
 
-Some bugs fixed. 
+Some bugs fixed.
 
 2.7.1
 chart.removeLegend() was not working properly.
@@ -556,7 +606,7 @@ displayed behind column graphs.
 "init" event added to AmChart. Event is fired right after the chart is initialized
 for the very first time.
 
-totalText property added to ValueAxis. Usage example: 
+totalText property added to ValueAxis. Usage example:
 valueAxis.totalText = "total: [[total]]"
 It works only if the chart has column graphs and stackType is set to "regular" or "100%".
 
@@ -571,14 +621,14 @@ When viewing a page with a chart from iOS browser, console logged some errors
 
 gradientOrientation was ignored by area charts
 
-plotAreaGradientAngle property added to AmRectangularChart, can accept 0, 90, 
+plotAreaGradientAngle property added to AmRectangularChart, can accept 0, 90,
 180 and 270 values.
 
 2.6.12
 FIXES:
 Pie chart data labels were hidden behind other slices if labelRadius < 0
 
-If chart was in a div with scrollbar, cursor was displayed in wrong position after 
+If chart was in a div with scrollbar, cursor was displayed in wrong position after
 scrolling with FF.
 
 Some other minor bugs fixed.
@@ -613,13 +663,13 @@ chartCursor.bulletsEnabled was ignored, even set to true.
 
 FIX: on IE8, if one slice was 100%, the circle wasn't displayed.
 
-FIX: custom fields in balloonText were not supported by XY chart. 
+FIX: custom fields in balloonText were not supported by XY chart.
 
 2.6.8
 pieAlpha property was ignored.
 plotAreaBorderAlpha was ignored if plotAreaAlphas was 0
 column graph type was ignoring startEffect property.
-chart property referencing to the chart object added to all event objects.  
+chart property referencing to the chart object added to all event objects.
 
 2.6.7
 Pie slices became invisible if startAlpha was < 1 on <= IE8 browsers (since 2.6.6 only)
@@ -637,7 +687,7 @@ some minor bugs fixed.
 2.6.4
 minSelectedTime property added to AmSerialTime
 
-some minor bugs fixed. 
+some minor bugs fixed.
 
 2.6.3
 zoom-out button wasn't working on iPad (only since 2.6.0)
@@ -657,7 +707,7 @@ inside amcharts.js file. The charts got a lot faster, the file size reduced by 7
 2.5.5
 In new version of Chrome (17) a new bug was introduced - if touchEventsEnabled was set
 to true, mouse events stopped working on normal browsers. Bug fixed in this version.
-  
+
 //////////////////////////////////////////////////////////////////////////////////////
 2.5.4
 Some minor bugs fixed
@@ -690,10 +740,10 @@ source code commented.
 BIG NEW FEATURES:
 
 Automatic margins
-margins of RectangularChart (Serial and XY charts) are calculated automatically now. 
+margins of RectangularChart (Serial and XY charts) are calculated automatically now.
 You can still work in old way by setting margins manually - set chart.autoMargins to
 false.
- 
+
 Axis titles
 Previously you had to use addLabel method in order to give name to the axis. Since
 this version we introduced title property for AxisBase, so you can name both Category
@@ -701,7 +751,7 @@ and Value Axes now much more easily.
 
 Chart title
 Same as with axes titles - previously you had to use addLabel method to name a chart.
-Now you can add any number of titles using 
+Now you can add any number of titles using
 chart.addTitle(text, size, color, alpha, bold) method. Chart title is taken into account
 when calculating margins, also position of pie/radar center.
 
@@ -709,7 +759,7 @@ Trend lines
 Chart can display Trend lines now.
 
 AmCharts.ready() method added so you don't need to use window.onload anymore. You can
-use amCharts.ready as many times in one page as you want. 
+use amCharts.ready as many times in one page as you want.
 
 NOT SO BIG NEW FEATURES:
 
@@ -728,7 +778,7 @@ default value of textClickEnabled of AmLegend changed to false
 default value of hideResizeGrips of ChartScrollbar changed to false
 
 All margins of RectangularChart changed to 20, as they can still be used for sides
-without axes.  
+without axes.
 
 
 //////////////////////////////////////////////////////////////////////////////////////
@@ -751,7 +801,7 @@ in some cases balloon flashed in a wrong position (IE only) for a second.
 
 amFallback used to fail on older IE with <visible_in_legend> set to false.
 
-Rollover balloons used to overlap when all of the datapoints were very near the top of 
+Rollover balloons used to overlap when all of the datapoints were very near the top of
 the plot area.
 
 Sometimes lines became blurry after window was resized.
@@ -766,7 +816,7 @@ FEATURES:
 
 boldPeriodBeginning property with default value true added to CoordinateAxis.
 You can disable bolding of the beginning of a period (like year/month/etc) using
-it. 
+it.
 
 2.4.5
 some bugs fixed
@@ -810,28 +860,28 @@ some minor bugs fixed.
 2.3.0
 Fixes in Flash version:
 
-	Since the release of Flash Player 11, calling setSettings could cause browser 
+	Since the release of Flash Player 11, calling setSettings could cause browser
 	crash. This problem fixed in this version. You only need to overwrite swf files.
 
 Fixes in JavaScript version:
 
 	Rollover balloon with cornerRadius set to 0 was distorted when it's close to the
 	plot area's top.
-	
+
 	amClickGraphItem event wasn't working for Radar Chart.
-	
+
 	graph.showBalloon = false was ignored.
-	
+
 	The last item in chart.colors array was ignored.
-	
+
 	3D stacked bar charts had layer order problems.
 
 New features in JavaScript version:
 
 	minBulletSize property added to AmGraph. Might be useful for XY chart.
-	
+
 	animateAgain() method added to all charts. Will trigger animation.
-   
+
 2.2.1
 Changes were made in JavaScript version only.
 
@@ -844,7 +894,7 @@ at a time will be displayed. Default value is false.
 Some minor bugs were fixed.
 
 2.2.0
-JavaScript version of XY Chart is now available. 
+JavaScript version of XY Chart is now available.
 Code was optimized so even with this new chart the size of a file got smaller!
 Some minor bugs fixed in JS version.
 We decided to remove a possibility to have gradient fills of JS pie chart as this
@@ -875,8 +925,8 @@ an error used to happen with Chrome while animating.
 
 Legend marker type "bubble" wasn't working at all.
 
-Legend marker type "line" or "dashed line" wasn't registering clicks on the marker. 
- 
+Legend marker type "line" or "dashed line" wasn't registering clicks on the marker.
+
 2.1.0
 Radar/Polar chart added to JavaScript charts
 Some bug fixes/tweaks in both flash and JavaScript versions.