ChartDirector Ver 4.1 (ColdFusion Edition)

Side Label Layout




This method demonstrates the "side label layout" method for positioning the sector labels.

With "side label layout", the sector labels are positioned on the left and right sides of the chart. In contrast, all previous examples use "circular label layout", in which the labels are positioned circularly around the pie.

"Circular label layout" typically uses less space and is the default layout method. However, if the pie chart contains a lot of small sectors, the labels may overlap with each others. It is because there may be insufficient space on the perimeter to position the labels.

"Side label layout" has the advantages that the labels will automatically shift up and down to avoid overlapping. By default, the labels are joined to the sectors with join lines.

The label layout method to use is specified with PieChart.setLabelLayout.

Source Code Listing

[File: cfdemo/sidelabelpie.cfm]
<cfscript>

// ChartDirector for ColdFusion API Access Point
cd = CreateObject("java", "ChartDirector.CFChart");

// A utility to allow us to create arrays with data in one line of code
function Array() {
    var result = ArrayNew(1);
    var i = 0;
    for (i = 1; i LTE ArrayLen(arguments); i = i + 1)
        result[i] = arguments[i];
    return result;
}

// The data for the pie chart
data = Array(25, 18, 15, 12, 8, 30, 35);

// The labels for the pie chart
labels = Array("Labor", "Licenses", "Taxes", "Legal", "Insurance", "Facilities",
    "Production");

// Create a PieChart object of size 500 x 230 pixels
c = cd.PieChart(500, 230);

// Set the center of the pie at (250, 120) and the radius to 100 pixels
c.setPieSize(250, 120, 100);

// Add a title box using 15 points Times Bold Italic as font
c.addTitle("Project Cost Breakdown", "Times New Roman Bold Italic", 15);

// Draw the pie in 3D
c.set3D();

// Use the side label layout method
c.setLabelLayout(cd.SideLayout);

// Set the pie data and the pie labels
c.setData(data, labels);

// Output the chart
chart1URL = c.makeSession(GetPageContext(), "chart1");

// Include tool tip for the chart
imageMap1 = c.getHTMLImageMap("", "", "title='{label}: US${value}K ({percent}%)'");

</cfscript>
<html>
<body style="margin:5px 0px 0px 5px">
<div style="font-size:18pt; font-family:verdana; font-weight:bold">
    Side Label Layout
</div>
<hr style="border:solid 1px #000080" />
<cfoutput>
<div style="font-size:9pt; font-family:verdana; margin-bottom:1.5em">
    <a href='viewsource.cfm?file=#CGI.SCRIPT_NAME#'>View Source Code</a>
</div>
<img src="getchart.cfm?#chart1URL#" usemap="##map1" border="0" />
<map name="map1">#imageMap1#</map>
</cfoutput>
</body>
</html>