Charts and Graphs - Bluff in Charts and Graphs 6
Same filename and directory in other branches
Library pages
For definitive info about Bluff library please see it's home page and it's reference page.
Installation
You should download Bluff library and grab following three javascript files:
- bluff-min.js
- excanvas.js
- js-class.js
and place them under sites/all/modules/charts_graphs/apis/charts_bluff/bluff folder.
Usage
The quickest code to get something graphed using bluff:
<?php function charts_graphs_test() { $canvas = chart_graphs_get_graph('bluff'); $canvas->title = "Bluff Chart"; $canvas->type = "line"; // a chart type supported by the charting engine. See further in the doc for the list. $canvas->y_legend = "Y Legend"; $canvas->colour = '#D54C78'; $canvas->theme = 'keynote'; $canvas->series = array( 'Some Value' => array(9,6,7,9,5,7,6,9,7), 'Page Views' => array(6,7,9,5,7,6,9,7,3), ); $canvas->x_labels = array('one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine'); $out = $canvas->get_chart(); return $out; }
Graph types supported
Bluff supports all main and standardized graph types, except the donut graph type. It also supports the following graph types:
- mini_bar
- Bar graph suitable for small graphs.
- mini_pie
- Pie graph suitable for small graphs.
- mini_side_bar
- Side bar graph suitable for small graphs.
Special parameters
Charts and Graphs supports the following special parameters for Bluff:
- transpose
- the optional parameter transpose, if set to true, will cause Bluff to pick the opposite data orientation to the one it would have picked automatically. This orientation defines if each column or each row is one data serie.
Unsupported properties
The Bluff charting library doesn't support the y_legend property.
Examples
The examples below will only work if you have the Bluff submodule configured correctly.
File
help/bluff.htmlView source
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>Charts and Graphs - Bluff</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> </head> <body> <h3>Library pages</h3> <p>For definitive info about Bluff library please see it's <a href="http://bluff.jcoglan.com">home page</a> and it's <a href="http://bluff.jcoglan.com/api.html">reference page</a>.</p> <h3>Installation</h3> <p>You should download <a href="http://bluff.jcoglan.com/assets/">Bluff</a> library and grab following three javascript files:</p> <ul> <li>bluff-min.js</li> <li>excanvas.js</li> <li>js-class.js</li> </ul> <p>and place them under <i>sites/all/modules/charts_graphs/apis/charts_bluff/bluff</i> folder.</p> <h3>Usage</h3> <p>The quickest code to get something graphed using bluff:</p> <pre> <?php function charts_graphs_test() { $canvas = chart_graphs_get_graph('bluff'); $canvas->title = "Bluff Chart"; $canvas->type = "line"; // a chart type supported by the charting engine. See further in the doc for the list. $canvas->y_legend = "Y Legend"; $canvas->colour = '#D54C78'; $canvas->theme = 'keynote'; $canvas->series = array( 'Some Value' => array(9,6,7,9,5,7,6,9,7), 'Page Views' => array(6,7,9,5,7,6,9,7,3), ); $canvas->x_labels = array('one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine'); $out = $canvas->get_chart(); return $out; } </pre> <h3>Graph types supported</h3> <p>Bluff supports all <a href="general_reference#type">main</a> and <a href="general_reference#other_standardized_types">standardized graph</a> types, except the donut graph type. It also supports the following graph types:</p> <dl> <dt>mini_bar</dt> <dd>Bar graph suitable for small graphs.</dd> <dt>mini_pie</dt> <dd>Pie graph suitable for small graphs.</dd> <dt>mini_side_bar</dt> <dd>Side bar graph suitable for small graphs.</dd> </dl> <h3>Special parameters</h3> <p>Charts and Graphs supports the following special parameters for Bluff:</p> <dl> <dt>transpose</dt> <dd>the optional parameter <b>transpose</b>, if set to true, will cause Bluff to pick the opposite data orientation to the one it would have picked automatically. This orientation defines if each column or each row is one data serie.</dd> </dl> <h3>Unsupported properties</h3> <p>The Bluff charting library doesn't support the <a href="general_reference#y_legend">y_legend</a> property.</p> <h3>Examples</h3> <p>The examples below will only work if you have the Bluff submodule configured correctly.</p> <ul> <li><a href="/charts_graphs/test/bluff/line/Bluff - Line example">Line example</a></li> <li><a href="/charts_graphs/test/bluff/bar/Bluff - Bar example">Bar example</a></li> <li><a href="/charts_graphs/test/bluff/pie/Bluff - Pie example">Pie example</a></li> </ul> </body> </html>