The December 2012 release of RGraph is now available. The highlight of this release is the addition of the Radar chart
Trace effect - which operates in much the same way as the Line chart Trace2 effect.
The CSS3 rotateIn animation now rotates in from the left
The RGraph.DrawXAxis() and RGraph.DrawYAxis() functions now support an axis.linewidth option
Added range inputs (sliders) to the 3D example. For best results use Chrome or Safari to view the page: http://www.rgraph.net/docs/howto-3d-effect.html
Added a Contract/Expand HOWTO: http://www.rgraph.net/docs/howto-make-a-contract-expand-transition.html
Added the Contract effect which is the opposite of the Expand effect
Added bevel option to the HProgress chart
You can now turn the bounce effect off in the Expand() effect
The Line chart backdrop option now supports splines
The minify PHP script has been removed - the jsmin C program should be used instead.
The Radar chart default for axes.color has changed from black to rgba(0,0,0,0)
The Radar chart default for background.circles.poly has changed to true
The Radar chart can now have a Trace effect
Added ability to set the density and the color of the Rose chart background concentric circles
Added bevel option to the VProgress bar
The way that the Y coordinates for lines has changed significantly though there shouldn't be any visible changes.
The November 2012 release of RGraph is now available. This release doesn't add anything that is particularly ground-breaking
but does add useful features such as an RGraph.DrawXAxis() function for drawing your own (or extra) X axes and a CSS animation
library. You can see examples of the CSS animation effects here:
Bear in mind though that IE9 doesn't support these effects so you will need IE10+.
The way the multiline text is rendered has changed - you may need to change your labels if you're using multi-line
angled labels. If you need large labels you could also consider using a key, switching from the Bar chart to the Hbar
chart or using tooltips to display the extra information. You can also use carriage returns to spread your labels across two
This change was necessary to enable multi line (horizontal) labels
- and you can see an example of that on the Horizontal Bar chart example page.
The Vertical Progress bar default value for the tickmarks.zerostart property has changed to true
The Radar chart default value for the labels.boxed property has changed from true to false
The method of antialiasing has changed. Instead of a function that rounds to the nearest half-pixel - the canvas is
translated by half a pixel and then values are rounded.
The Horizontal Progress bar default value for the tickmarks.zerostart property has changed to true
Added a new CSS animations library. Recent browsers support these (eg IE10+, Chrome, Firefox, Opera, Safari)
The Expand effect now has a small bounce to it. It also takes less time to run.
The RGraph.Reset() method now removes relevant objects from the ObjectRegistry.
The RGraph.DrawAxes() function has been renamed to RGraph.DrawYAxis() and an RGraph.DrawXAxis() function has been added.
The October 2012 release of RGraph is now available. This release contains some very useful additions that are beneficial to
interactivity: A move back to DOM2 events (but without any slowdown) and dollar events. Also using gradients is now easier
with the Gradient() colour specification.
Switched from DOM1 events to DOM2. This frees up the official DOM1 events for you to use, like this:
// Make your chart first
var myObject = new RGraph.Bar('cvs', [8,4,7]);
// Then add the event listener like this:
myObject.canvas.onclick = function (e)
The HBar settings vmargin and vmargin.grouped for grouped HBars have been updated to act the same as the Bar chart.
The position of the key in gutter mode has been updated - it's now centered regardless of the gutter settings
As an example of the faster and more accurate click-testing that is planned for the November stable release, the Marker1
object and Funnel chart have already been converted.
The API functions RGraph.LinearGradient() and RGraph.RadialGradient() can now take more than two colours if you wish.
The Odometer options green.solid, yellow.solid and red.solid options have been removed. The colors
are now solid by default. You can use the new simple Gradient syntax though.
Added labels.background.fill and labels.boxed to the Radar chart.
Now ALL of the "mercury" in the Thermometer chart is clickable and highlighted.
Certain Bar chart tooltips are now placed above the bar. Or below in the case of negative values when the X axis is central.
Added support for easy events specification for charts that support events.click and events.mousemove:
myChart.$1.onclick = function (e, shape)
// Handle the click event
myChart.$1.onmousemove = function (e, shape)
// Handle the mousemove event, eg:
e.target.style.cursor = 'pointer';
The $X number corresponds to the number of the relevant element in the chart.
Also added basic examples of this for the Bar/Line/Pie chart and a HOWTO doc.
Added support for easy gradients: Gradient(white:red)
The RGraph.getMouseXY(e) function will now accommodate borders and padding on the canvas
The Line chart interactive key will now work when the key is placed outside of the chart area
IMPORTANT: How you specify the Gantt chart events has changed. Instead of using the events property the events are
now given as the second argument to the constructor. The array is the same format. The constructor of the
Gantt chart now looks something like this
var myGantt = new RGraph.Gantt('cvs', [
[31, 28, null, 'Gerry', '#afa'],
[0, 31, null, 'Tom', '#afa']
Now, for the HProgress, VProgress and Thermometer charts, when the cusor is over the whole chart area (including
the background), charts "behind" the chart do not fire their events.
The September 2012 release of RGraph is now available. The major improvement in this release is the addition of Catmull-Rom
splines - which are
a big improvment to the way that curvy lines are drawn. No accuracy is now lost and you can see an example of them in
the Line chart on the front page. Another significant improvment is the support for DOM1 style events.
These make adding your own custom event listener functions much easier and they work like this:
// Make your chart first
var myObject = new RGraph.Bar('cvs', [8,4,7])
// Then add the event listener like this:
myObject.ontooltip = function (obj)
var canvas = obj.canvas;
var context = obj.context;
The curvy option is now called spline and has been improved to not lose any accuracy.
RGraph now supports the DOM1 method of adding custom event listeners - as noted above and below.
The Bipolar has new options: noaxes, linewidth and xlabels
Added the RGraph.DrawAxes() function which can be used to draw multiple Y axes.
Added noyaxis to the Scatter chart.
Added colors.sequential to the Bipolar.
Added new Scissors effects, which as well as stand-alone effects, can also be used to create wipes/transitions.
Added a HOWTO regarding using JSON data with RGraph.
Added the trigonometry function RGraph.getRadiusEndPoint(cx, cy, angle, radius).
The pseudo-events (ie the obj.onclick and obj.onmousemove ones) can now also be added in a DOM1 style like this:
myChart.onclick = function (e, shape)
myChart.onmousemove = function (e, shape)
The July 2012 release of RGraph is now available. This release adds the demos folder - which is included in the download, and
which shows simple and straight-forward demonstrations of the various charts that RGraph supports. Old versions of docs are
now archived on the website. There is now an option for Priority Support - which is available
if you want something above and beyond the standard support. And support has been added for
DOM1 style custom events. These
make it significantly easier to add custom RGraph event listeners - like this:
The June 2012 release of RGraph is now available. This release contains less changes than previous releases of RGraph
have. It mainly contains updates to the website which has had a design change. The biggest thing in this release (which
is still significant) is the fact that the documentation and examples have been unbundled from the download archive and
are now available via the website. This is better for quicker updates and the addition of new information.
Unbundled the documentation and examples from the archive
Added hmargin.grouped to the Bar chart and vmargin.grouped to the HBar chart
The Gauge chart now has more options to control it's appearance and also now supports multiple pointers
The radar chart background circles can now be a polygon
The Radar chart can now have dots highlighting the points
The Thermometer is now graduated by default
As well as the RSS XML feed there is now a HTML version too to make reading it easier
The compressed version of ExCanvas is no longer supplied as part of the archive - only the original is available
The March 2012 release of RGraph is now available. This release is very significant and as such has the RGraph2 moniker.
It introduces the ObjectRegistry which allows you to combine different charts on a single canvas. An obvious example is
the Line and Bar charts, though any combination is allowed. The combining charts docs page has an example and is
here. A less obvious example is the Bar chart combined with the VProgress bar and the
example is here. More HOWTO guides are available which take a
step-by-step approach to demonstrating some common tasks. Other changes include:
There's now a tool that can help you to determine your gutters.
There's now a tool that can help you when converting images to data: URLs.
The Pie chart strokestyle option can now be an array of colors as well as a single color.
Added __index2__ to the Scatter chart
Added the .getValue(e) method to the Bipolar chart.
Added the .getValue(e) method to the Gauge chart.
Circular charts are now positioned using the gutter settings. The positioning can be overridden
though with centerx, centery and radius.
Added border.gradient to the Gauge chart. Keep in mind though that Canvas gradients can slow down animations.
Added a shrink effect to the Pie chart.
Added the Thermometer Grow effect
Added the Pie chart Explode effect to complement the Implode effect.
Important: Tooltips and othe dynamic features have been moved to a new file: RGraph.common.dynamic.js
The name of the coordinates for the interactive key has changed to: obj.coords.key
The file RGraph.common.adjusting.js has been removed. Adjusting is now handled in each individual chart file.
Thumbnail and area zoom have been removed.
Added border.inner to the VProgress and HProgress.
Added labels.specific to the VProgress.
Added labels.specific to the HProgress.
Added background.image.w and background.image.h to the Bar, Line and Scatter charts.
Added radius to the LED display.
The Gauge chart now has a shadow by default. You can turn this off for animations with shadow
Added the Bar chart .getShapeByX(e) method
Added adjusting to the Gauge, Odometer, Fuel and Meter charts
Annotating has been updated - if you use them check your charts.
Added 3D highlighting to the Donut chart
Removed the unused RGraph.lineByAngle() function
Added more HOWTO guides
The VProgress and HProgress strokestyle property is now split into strokestyle.inner and strokestyle.outer
Keep in mind that with the addition of the ObjectRegistry this is a very significant update and
upgrades should be done with caution.
The January 2012 release of RGraph is now available and has these changes:
Relevant charts libraries now have two new properties:
These new properties make it much easier to add your own event listening functions. You can read more about these
new properties here.
The Radar chart origin is now the "north" axis instead of the "east" axis.
The Radar chart now supports a stacked variant when all datasets have the same number of data points.
Implemented the Wave2 animation, which uses the requestAnimationFrame() function. In some browsers the
difference is quite subtle.
In some charts, there is now a getValue() method which can be used in event listener functions
to get the appropriate value (if any) when the chart is clicked for example. This affects the Bar,
HBar, HProgress, Line, Scatter, Thermometer and VProgress charts.
Added a getBar() method to the Thermometer which can be used inside standard event listener functions
(not the RGraph ones) to determine if the bar area was clicked (or mouseover'ed etc).
Added Rose chart Explode/Implode animation effects.
Added Radar chart radius property.
Radar chart labels have been altered so that their placement is now not linked to the number of points on the chart.
They also now go around the edge of the chart.
A Grow effect has been added for the Gantt chart.
The Gantt chart now has a tooltips.event property.
Added the Gantt chart property labels.align
The Gantt chart background grid autofit option now defaults to true (ie enabled).
Added new background image properties:
These are relevant to the Bar, Line and Scatter charts.
Added new HOWTO guides for certain common tasks.
Added a new Conceal effect - the opposite of the Reveal effect.
Added new properties to the Gauge chart:
The two scale properties scale.point and scale.thousand have been synchronised across the majority of