- Resolved #11141: Documented rotated labels on axis.

3 files changed, 50 insertions, 0 deletions

diff --git a/docs/img/tutorial_rotated_labels.svg.png b/docs/img/tutorial_rotated_labels.svg.png
new file mode 100644
index 0000000..53e6c19
--- /dev/null
+++ b/docs/img/tutorial_rotated_labels.svg.png
diff --git a/docs/tutorial.txt b/docs/tutorial.txt
index 7234201..90de08d 100644
--- a/docs/tutorial.txt
+++ b/docs/tutorial.txt
@@ -580,6 +580,32 @@ for all available axis label renderers, but here is an overview:
   between two labels. This helps to recognize which bars belong together.
   Labels are rendered centered between two steps on the axis.
 
+Rotatad labels on axis
+~~~~~~~~~~~~~~~~~~~~~~
+
+There is one more new axis label renderer since version 1.1 of ezcGraph - the
+ezcGraphAxisRotatedLabelRenderer which enables you to render rotated labels on
+an axis.
+
+.. include:: tutorial/tutorial_rotated_labels.php
+   :literal:
+
+In line 9 a custom renderer is defined used for the labeled x axis. You can
+assign custom axis label renderers on the property $axisLabelRenderer for
+ezcGraphChartAxisElement objects.
+
+The renderer used in this example has custom properties like the rotation of
+the labels, which is set in degree, while the rotation direction depends on
+the direction of the axis.
+
+It makes sense to define more vertical space below the the axis for the
+rotated labels like done in line 11 of the above example.
+
+.. image:: img/tutorial_rotated_labels.svg.png
+   :alt:   Date axis example
+
+The results conatins rotated labels, which enables you to pack a lot more
+labels on one axis.
 
 Datasets
 ========
diff --git a/docs/tutorial/tutorial_rotated_labels.php b/docs/tutorial/tutorial_rotated_labels.php
new file mode 100644
index 0000000..98aba88
--- /dev/null
+++ b/docs/tutorial/tutorial_rotated_labels.php
@@ -0,0 +1,24 @@
+<?php
+
+require_once 'tutorial_autoload.php';
+$wikidata = include 'tutorial_wikipedia_data.php';
+
+$graph = new ezcGraphLineChart();
+$graph->title = 'Wikipedia articles';
+
+$graph->xAxis->axisLabelRenderer = new ezcGraphAxisRotatedLabelRenderer();
+$graph->xAxis->axisLabelRenderer->angle = 45;
+$graph->xAxis->axisSpace = .2;
+
+// Add data
+foreach ( $wikidata as $language => $data )
+{
+    $graph->data[$language] = new ezcGraphArrayDataSet( $data );
+}
+$graph->data['German']->displayType = ezcGraph::LINE;
+
+$graph->options->fillLines = 210;
+
+$graph->render( 400, 150, 'tutorial_rotated_labels.svg' );
+
+?>