A percentage bar chart is like a stacked bar chart, except the bars are individually scaled so that they stacked up to 100.
Note that in this example, the legend box contains icons. This is achieved by including the icons in the data set name using
CDML.
The key features demonstrated in this example are:
- Add a legend to the chart using BaseChart.addLegend, and set the key size (the color box to the right of each legend entry) to 16 x 32 pixels using LegendBox.setKeySize. This is to better match the size of the icons.
- Reverse the legend box entries using Layer.setLegend, so that the last data set name is on top in the legend box. This is useful for a vertical legend box in a vertical stacked chart with purely positive data. In such case, the last data set will be stacked to the top. Reversing the legend box will make the legend keys visually consistent with the stacking order of the chart.
- Add a percentage bar layer using XYChart.addBarLayer2 with the Percentage pre-defined constant.
- Add multiple data sets to the bar layer using Layer.addDataSet, with data set names expressed using CDML to include icons.
- Include labels for the bar segments using Layer.setDataLabelStyle, with center alignment configured using TextBox.setAlignment.
- The search path to load the icon images is configured to be the same as the script directory using BaseChart.setSearchPath. This is needed in IIS because the current directory in IIS is the directory of the IIS executable, not the script directory.
Note that by default, the data label format is
{percent}% (showing the percentage) for a percentage bar layer, as opposed to
{value} (showing the data value) for other types of bar layer. The data label format can be modified using
Layer.setDataLabelFormat.
[File: phpdemo/percentbar.php".]
setSearchPath(dirname(__FILE__));
#Set the plotarea at (50, 45) and of size 320 x 200 pixels. Use white (0xffffff)
#color as background.
$c->setPlotArea(50, 45, 320, 200, 0xffffff);
#Add a legend box at (370, 45) using vertical layout and 8 points Arial Bold
#font.
$legendBox = $c->addLegend(370, 45, true, "arialbd.ttf", 8);
#Set the legend box background and border to transparent
$legendBox->setBackground(Transparent, Transparent);
#Set the legend box icon size to 16 x 32 pixels to match with custom icon size
$legendBox->setKeySize(16, 32);
#Add a title to the chart using 14 points Times Bold Itatic font and white font
#color, and 0x804020 as the background color
$titleObj = $c->addTitle("Weekly Product Sales", "timesbi.ttf", 14, 0xffffff);
$titleObj->setBackground(0x804020);
#Set the labels on the x axis
$c->xAxis->setLabels($labels);
#Add a percentage bar layer and set the layer 3D depth to 8 pixels
$layer = $c->addBarLayer2(Percentage);
#Add the three data sets to the bar layer, using icons images with labels as
#data set names
$layer->addDataSet($data0, 0xddaa77,
"<*block,valign=absmiddle*><*img=service.png*> Service<*/*>");
$layer->addDataSet($data1, 0xaadd77,
"<*block,valign=absmiddle*><*img=software.png*> Software<*/*>");
$layer->addDataSet($data2, 0xaa77dd,
"<*block,valign=absmiddle*><*img=computer.png*> Hardware<*/*>");
#Disable bar borders by setting their colors to transparent
$layer->setBorderColor(Transparent);
#Enable data label at the middle of the the bar
$dataLabelStyleObj = $layer->setDataLabelStyle();
$dataLabelStyleObj->setAlignment(Center);
#For a vertical stacked chart with positive data only, the last data set is
#always on top. However, in a vertical legend box, the last data set is at the
#bottom. This can be reversed by using the setLegend method.
$layer->setLegend(ReverseLegend);
#output the chart
header("Content-type: image/png");
print($c->makeChart2(PNG));
?> |
© 2004 Advanced Software Engineering Limited. All rights reserved.