Data Input:

; Data Input: Surface DataPoints API

Special Features for Surface Charts
Data Mapping
Enable Data Refresh
Data Points

Set Color

Hide Zero-Value Data Points

Hyperlinks
3D Property Set

Special Features for Surface Charts

3D Approximation

This improves the performance by calculating the approximate positions of the data points.

// get a handle of the chart’s 3D properties and call the method:

// set3DApproximationUsed(boolean state, int threshold)

// default setting is (true, 100)

chart.geth3DProperties().set3DApproximationUsed( true, 100);

Heat Map (API Only)
// set the surface chart area to be of different colors depending on the
// y values.
// set color spectrum, green when y < 12, yellow when 12 < y < 24,
// and red when y > 24
double[] value = {12, 24};
Color[] sColor = { Color.green, Color.yellow, Color.red };
ColorSpectrum colorSpectrum = new ColorSpectrum( sColor, value );
// apply color spectrum specifications to the surface chart
chart.geth3DProperties().setColorSpectrum( colorSpectrum );

Data Mapping
Before a chart is actually created, we need to specify the data mapping information to EspressChart. To do so, we can create an instance of the colInfo class and include this in the QbChart constructor that we will call.

Explanation:
Xvalue, YValue & Zvalue: The X-Axis refers to the x coordinate point in a plane and the Y-Axis refers to the y coordinate point in the same plane while the Z-Axis refers to the z coordinate point in the same plane. The three points together define a point represented in the plane. Each coordinate point represents the position.

// Create an colInfo object that specifies infomation on data mapping

// map {xValue, yValue}
int[] map = {0, 2, 1};

// ColInfo (series, map)
ColInfo sampleColInfo = new ColInfo(-1, map);

// QbChart(java.applet.Applet applet, int dimension, int chartType,
// IDatabaseInfo dbinfo, IColumnMap cmap, java.lang.String template)
QbChart chart = new QbChart( null, QbChart.VIEW3D, QbChart.SURFACE, yourData, sampleColInfo, null);

Enable Data Refresh
For information on Data Refresh, please refer to Enable Data Refresh in 2D DataPoints API.

Data Points
For information on Data Points, please refer to Data Points in 2D DataPoints API.

Set Color
For information on Set Color, please refer to SetColor in 2D DataPoints API.
Hide Zero-Value Data Points
For information on Hide Zero-Value Data Points, please refer to Hide Zero-Value Data Points in 2D DataPoints API.

Hyperlinks
To create charts with Hyperlinks, first create an object that has a handle on the chart’s Hyperlinks properties. Then, hyperlink properties can be specified through the IHyperLinkSet class methods.

// create an IHyperLinkSet object, "hHyperLinks" that
// has a handle on the chart’s HyperLinks
IHyperLinkSet hHyperLinks = chart.gethHyperLinks();
// links for the x = 50 & y = 50, with hint box
// new HyperLink();
HyperLink temp = new HyperLink();
// createHyperLinkForSurfaceChart(java.lang.String xValue,
// java.lang.String zValue, java.lang.String link)
temp.createHyperLinkForSurfaceChart( "50", "50", "http://www.quadbase.com" );
// set the hint box message
temp.setHintValue("Click Here for x=50 & z=50" );
// add the hyperlink to the chart’s hyperlink set
hHyperLinks.add(temp);

3D Property Set
To adjust 3D properties of the chart, first, get a handle of through the chart.geth3DProperties() method. Then, the different properties can be manipulated. Sample codes are given below.

// create an I3DPropertySet object that has a handle

// on the chart’s 3D properties

I3DPropertySet h3DProps = chart.geth3DProperties();

// set light position
Point_3D point3D = new Point_3D(0.5f, 0.5f, 0.5f);
h3DProps.setLightPosition( point3D );

// set ambient light color
h3DProps.setAmbientLight( Color.yellow);

// set view direction of the chart,
// two 3D points define the view direction
Point_3D[] points = new Point_3D[]{ new Point_3D(0.8f, 0.5f, 0.5f),

new Point_3D(0.5f, 0.5f, 0.5f) };

h3DProps.setViewDirection( points);

// zooming in/out on the chart
int zoomFactor = 20; // zoom factor 0 – 100
h3DProps.setZoomFactor( zoomFactor);

// set x, y, and z scale
h3DProps.setXScale( 0.3f);
h3DProps.setYScale( 0.3f);
h3DProps.setZScale( 0.4f);

// set the appearance of bar/columns
h3DProps.setBarWidthToThicknessRatio( 0.5f );

// set the speed of animation, int between 1 to 100, in radians/frame
h3DProps.setAnimationSpeed( 20 );

// draw in the regular mode
h3DProps.setRenderMode(QbChart.FLAT);

// draw only the color wires
h3DProps.setRenderMode(QbChart.WIREFRAME);

// draw in the flat mode with black borders
h3DProps.setRenderMode(QbChart.FLAT_BORDER);

// draw in the Gouraud Shading mode with border
h3DProps.setRenderMode(QbChart.GOURAUD_BORDER);

// draw in the Gouraud Shading mode
h3DProps.setRenderMode(QbChart.GOURAUD);

// get a handle on the chart’s 3D control panel,
// so you can set the components visible/invisible
I3DControlPanel h3DControl = chart.geth3DControlPanel();

// automatically start animation when chart is opened
h3DControl.setAnimationButtonOn(true);

// set Gouraud Shading button invisible
h3DControl. setGouraudButtonVisible(false);

// disable the toggle of double clicking on the canvas to set
// 3D control panel visible/invisible
h3DControl.setToggleEnabled(false);

// set the control panel visible (default is visible)
h3DControl.setVisible(true);

Please refer to QbChart, ColInfo, I3DPropertySet, I3DControlPanel, IColumnMap, IDataPointSet, IHyperLinkSet, & HyperLink in EspressChart APIDocs for additional information.