CBCGPChartSurfaceSeries

Detailed Description

The CBCGPChartSurfaceSeries class implements the functionality of surface series, which enables visualization of 3D surface data.

You can either create a CBCGPChartLineSeries object directly and then call CBCGPChartVisualObject::AddSeries, or call CBCGPChartVisualObject::CreateSeries to create the series indirectly.

Also you can call CBCGPChartVisualObject::SetChartType(BCGPChartSurface3D) to make the surface series created automatically once you begin adding data with CBCGPChartVisualObject::AddChartData.

The series expects ordered data and it automatically calculates surface dimensions (when it sees an X value smaller than the previous, it automatically sets X dimension and then calculates the grid size according to the total number of data points divided by the X dim). However, if the data is not ordered by X, you can call CBCGPChartSurfaceSeries::SetSurfaceDimension and specify the desired X dimension.

The most convinient way to add data is calling CBCGPChartVisualObject::AddChartDataYXZ(y, x, z); where z is an outer loop:

Copy

for (double z = zMin; z < zXax; z += zStep)

{

for (double x = xMin; x < xMax; x += xStep)

{

double y = f(x,z);

pChart->AddChartData(y, x, z, nSeries);

}

}

It's highly recommended using OpenGL renderer for large surfaces. Also it works more correctly for intersecting surfaces. You can set the hardware rendering engine by calling CBCGPChartDiagram3D::SetRenderingType:

Copy

pChart->GetDiagram3D()->SetRenderingType(CBCGPEngine3D::BCGP_RT_OPENGL, FALSE);