Surface Color Scale

This example demonstrates using various color scales for surface charts.

ChartDirector supports two ways to configure the color scale:

The ColorAxis.setColorGradient can be used to specify a list of colors to be used for the ColorAxis. With this method, the color scale is determined by other means, and the colors will be applied to the resulting scale, interpolating among the colors if necessary. By default, the color axis scale and labels are automatically determined based on actual data. The axis scale and labels can also be specified by using various Axis methods, such as Axis.setLinearScale, Axis.setLogScale and Axis.setDateScale (please refer to Axis for the full list).
The ColorAxis.setColorScale can be used to specify both the colors and the associated scale and labels.

This example includes 4 charts to demonstrate both of the above methods.

[JSP Version] jspdemo/surfacecolor.jsp

<%@page import="ChartDirector.*, java.util.*" %>
<%!
// Function to create the demo charts
void createChart(WebChartViewer viewer, int chartIndex)
{
    // The x and y coordinates of the grid
    double[] dataX = {-4, -3, -2, -1, 0, 1, 2, 3, 4};
    double[] dataY = {-4, -3, -2, -1, 0, 1, 2, 3, 4};

    // Use random numbers for the z values on the XY grid
    RanSeries r = new RanSeries(99);
    double[] dataZ = r.get2DSeries(dataX.length, dataY.length, -0.9, 0.9);

    // Create a SurfaceChart object of size 460 x 460 pixels with white (0xffffff) background and
    // grey (0x888888) border
    SurfaceChart c = new SurfaceChart(460, 460, 0xffffff, 0x888888);

    // Set the surface data
    c.setData(dataX, dataY, dataZ);

    // Add a color axis (the legend) in at the top center of the chart, with labels at the bottom.
    // Set the axis to flat style.
    ColorAxis cAxis = c.setColorAxis(c.getWidth() / 2, 15, Chart.Top, 250, Chart.Bottom);
    cAxis.setTitle("Color Axis");
    cAxis.setAxisBorder(Chart.Transparent, 0);

    // By default, the color axis is synchronized with the z-axis. The following code remove the
    // synchronization so that the color axis will auto-scale independently. Set the auto-scale
    // minimum tick spacing to 20 pixels.
    cAxis.syncAxis(null);
    cAxis.setTickDensity(20);

    if (chartIndex == 1) {
        // Speicify a color gradient as a list of colors, and use it in the color axis.
        int[] colorGradient = {0x0044cc, 0xffffff, 0x00aa00};
        cAxis.setColorGradient(false, colorGradient);
    } else if (chartIndex == 2) {
        // Specify the color scale to use in the color axis
        double[] colorScale = {-1.0, 0x1a9850, -0.75, 0x66bd63, -0.5, 0xa6d96a, -0.25, 0xd9ef8b, 0,
            0xfee08b, 0.25, 0xfdae61, 0.5, 0xf46d43, 0.75, 0xd73027, 1};
        cAxis.setColorScale(colorScale);
    } else if (chartIndex == 3) {
        // Specify the color scale to use in the color axis. Also specify an underflow color
        // 0x66ccff (blue) for regions that fall below the lower axis limit.
        double[] colorScale = {0, 0xffff99, 0.2, 0x80cdc1, 0.4, 0x35978f, 0.6, 0x01665e, 0.8,
            0x003c30, 1};
        cAxis.setColorScale(colorScale, 0x66ccff);
    }

    // Set the center of the plot region at (230, 250), and set width x depth x height to 240 x 240
    // x 170 pixels
    c.setPlotRegion(230, 250, 240, 240, 170);

    // Set the plot region wall thichness to 3 pixels
    c.setWallThickness(3);

    // Set the elevation and rotation angles to 45 degrees
    c.setViewAngle(45, 45);

    // Set the perspective level to 20
    c.setPerspective(20);

    // Spline interpolate data to a 50 x 50 grid for a smooth surface
    c.setInterpolation(50, 50);

    // Set the axis title
    c.xAxis().setTitle("X-Axis", "Arial Bold", 10);
    c.yAxis().setTitle("Y-Axis", "Arial Bold", 10);
    c.zAxis().setTitle("Z Axis", "Arial Bold", 10);

    // Output the chart
    viewer.setChart(c, Chart.SVG);

    // Include tool tip for the chart
    viewer.setImageMap(c.getHTMLImageMap("", "",
        "title='<*cdml*>X: {x|2}<*br*>Y: {y|2}<*br*>Z: {z|2}'"));
}
%>
<%
// This example includes 4 charts
WebChartViewer[] viewers = new WebChartViewer[4];
for (int i = 0; i < viewers.length; ++i) {
    viewers[i] = new WebChartViewer(request, "chart" + i);
    createChart(viewers[i], i);
}
%>
<!DOCTYPE html>
<html>
<head>
    <title>Surface Color Scale</title>
    <!-- Include ChartDirector Javascript Library to support chart interactions -->
    <script type="text/javascript" src="cdjcv.js"></script>
</head>
<body style="margin:5px 0px 0px 5px">
    <div style="font:bold 18pt verdana;">
        Surface Color Scale
    </div>
    <hr style="border:solid 1px #000080; background:#000080" />
    <div style="font:10pt verdana; margin-bottom:1.5em">
        <a href="viewsource.jsp?file=<%=request.getServletPath()%>">View Source Code</a>
    </div>
    <!-- ****** Here are the chart images ****** -->
    <%
        for (int i = 0; i < viewers.length; ++i) {
            out.write(viewers[i].renderHTML(response));
            out.write(" ");
        }
    %>
</body>
</html>