该方法用于给栅格数据创建金字塔。创建金字塔可以提高栅格数据的显示速度。

命名空间：  SuperMap.Data
程序集：  SuperMap.Data (in SuperMap.Data)
版本: dll

语法

C#
public bool BuildPyramid()

返回值

如果创建成功，返回 true；否则返回 false。

备注

金字塔只能针对原始的数据进行创建。

用户仅能给一个数据集创建一次金字塔，如果想再次创建，需要将已创建的金字塔进行删除，当该栅格数据集显示的时候，已创建的金字塔都将被访问。

如下图所示在不同的比例尺下金字塔的建立过程。

示例

以下代码示范如何为栅格数据集创建金字塔。

假设打开了一个工作空间workspace，工作空间中的数据源(datasource)中包含了的一个栅格数据集 Raster(datasetGrid)。

CopyC#
public void TestBuildPyramid(Workspace workspace, Datasource datasource)
{
    //打开栅格数据集
    DatasetGrid datasetGrid = datasource.Datasets["Raster"] as DatasetGrid;
    datasetGrid.Open();

    // 判断当前栅格数据集是否有金字塔，如果有，移除金字塔后重新创建；如果没有，直接创建金字塔
    if (datasetGrid.HasPyramid)
    {
        Boolean isHasPyramid = datasetGrid.RemovePyramid();
        Console.WriteLine("判断当前栅格数据集是否有金字塔的结果为：" + isHasPyramid);
        datasetGrid.BuildPyramid();
    }
    else
    {
        datasetGrid.BuildPyramid();
    }
}

请参见