ChartDirector 5.1 (ColdFusion Edition)

Multi-Color Gantt Chart




This example demonstrates a multi-color gantt chart with milestone symbols.

The bars in this chart come from a multi-color box-whisker layer created using XYChart.addBoxWhiskerLayer2. The scatter symbols come from scatter layers created using XYChart.addScatterLayer.

In this example, a data series is used to specify the task number of the bars. This allows multiple bars to associated with the same task. The task numbers act as the x-coordinates of the bars and are set to the box-whisker layer using Layer.setXData. Another data series is used to specify the colors of the bars. This allows the bars to have different colors.

Source Code Listing

[File: cfdemo/colorgantt.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 tasks for the gantt chart
labels = Array("Market Research", "Define Specifications", "Overall Archiecture",
    "Project Planning", "Detail Design", "Software Development", "Test Plan",
    "Testing and QA", "User Documentation");

// The task index, start date, end date and color for each bar
taskNo = Array(0, 0, 1, 2, 3, 4, 5, 6, 6, 7, 8, 8);
startDate = Array(CreateDate(2004, 8, 16), CreateDate(2004, 10, 4), CreateDate(2004,
    8, 30), CreateDate(2004, 9, 13), CreateDate(2004, 9, 20), CreateDate(2004, 9, 27
    ), CreateDate(2004, 10, 4), CreateDate(2004, 10, 4), CreateDate(2004, 10, 25),
    CreateDate(2004, 11, 1), CreateDate(2004, 10, 18), CreateDate(2004, 11, 8));
endDate = Array(CreateDate(2004, 8, 30), CreateDate(2004, 10, 18), CreateDate(2004,
    9, 13), CreateDate(2004, 9, 27), CreateDate(2004, 10, 4), CreateDate(2004, 10, 11
    ), CreateDate(2004, 11, 8), CreateDate(2004, 10, 18), CreateDate(2004, 11, 8),
    CreateDate(2004, 11, 22), CreateDate(2004, 11, 1), CreateDate(2004, 11, 22));
colors = Array("0x00cc00", "0x00cc00", "0x00cc00", "0x0000cc", "0x0000cc",
    "0xcc0000", "0xcc0000", "0x0000cc", "0xcc0000", "0xcc0000", "0x00cc00",
    "0xcc0000");

// Create a XYChart object of size 620 x 325 pixels. Set background color to light
// red (0xffcccc), with 1 pixel 3D border effect.
c = cd.XYChart(620, 325, "0xffcccc", "0x000000", 1);

// Add a title to the chart using 15 points Times Bold Itatic font, with white
// (ffffff) text on a dark red (800000) background
c.addTitle("Mutli-Color Gantt Chart Demo", "Times New Roman Bold Italic", 15,
    "0xffffff").setBackground("0x800000");

// Set the plotarea at (140, 55) and of size 460 x 200 pixels. Use alternative
// white/grey background. Enable both horizontal and vertical grids by setting their
// colors to grey (c0c0c0). Set vertical major grid (represents month boundaries) 2
// pixels in width
c.setPlotArea(140, 55, 460, 200, "0xffffff", "0xeeeeee", cd.LineColor, "0xc0c0c0",
    "0xc0c0c0").setGridWidth(2, 1, 1, 1);

// swap the x and y axes to create a horziontal box-whisker chart
c.swapXY();

// Set the y-axis scale to be date scale from Aug 16, 2004 to Nov 22, 2004, with
// ticks every 7 days (1 week)
c.yAxis().setDateScale(CreateDate(2004, 8, 16), CreateDate(2004, 11, 22), 86400 * 7);

// Set multi-style axis label formatting. Month labels are in Arial Bold font in "mmm
// d" format. Weekly labels just show the day of month and use minor tick (by using
// '-' as first character of format string).
c.yAxis().setMultiFormat(cd.StartOfMonthFilter(), "<*font=Arial Bold*>{value|mmm d}",
    cd.StartOfDayFilter(), "-{value|d}");

// Set the y-axis to shown on the top (right + swapXY = top)
c.setYAxisOnRight();

// Set the labels on the x axis
c.xAxis().setLabels(labels);

// Reverse the x-axis scale so that it points downwards.
c.xAxis().setReverse();

// Set the horizontal ticks and grid lines to be between the bars
c.xAxis().setTickOffset(0.5);

// Add some symbols to the chart to represent milestones. The symbols are added using
// scatter layers. We need to specify the task index, date, name, symbol shape, size
// and color.
c.addScatterLayer(Array(1), Array(CreateDate(2004, 9, 13)), "Milestone 1",
    cd.Cross2Shape(), 13, "0xffff00").setHTMLImageMap("{disable}");
c.addScatterLayer(Array(3), Array(CreateDate(2004, 10, 4)), "Milestone 2",
    cd.StarShape(5), 15, "0xff00ff").setHTMLImageMap("{disable}");
c.addScatterLayer(Array(5), Array(CreateDate(2004, 11, 8)), "Milestone 3",
    cd.TriangleSymbol, 13, "0xff9933").setHTMLImageMap("{disable}");

// Add a multi-color box-whisker layer to represent the gantt bars
layer = c.addBoxWhiskerLayer2(startDate, endDate, ArrayNew(1), ArrayNew(1), ArrayNew(
    1), colors);
layer.setXData(taskNo);
layer.setBorderColor(cd.SameAsMainColor);

// Divide the plot area height ( = 200 in this chart) by the number of tasks to get
// the height of each slot. Use 80% of that as the bar height.
layer.setDataWidth(Int(200 * 4 / 5 / ArrayLen(labels)));

// Add a legend box at (140, 265) - bottom of the plot area. Use 8 pts Arial Bold as
// the font with auto-grid layout. Set the width to the same width as the plot area.
// Set the backgorund to grey (dddddd).
legendBox = c.addLegend2(140, 265, cd.AutoGrid, "Arial Bold", 8);
legendBox.setWidth(461);
legendBox.setBackground("0xdddddd");

// The keys for the scatter layers (milestone symbols) will automatically be added to
// the legend box. We just need to add keys to show the meanings of the bar colors.
legendBox.addKey("Market Team", "0x00cc00");
legendBox.addKey("Planning Team", "0x0000cc");
legendBox.addKey("Development Team", "0xcc0000");

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

// Include tool tip for the chart
imageMap1 = c.getHTMLImageMap("", "",
    "title='{xLabel}: {top|mmm dd, yyyy} to {bottom|mmm dd, yyyy}'");

</cfscript>
<html>
<body style="margin:5px 0px 0px 5px">
<div style="font-size:18pt; font-family:verdana; font-weight:bold">
    Multi-Color Gantt Chart
</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>