该方法为影像数据集创建金字塔。目的是提高影像数据集的显示速度。

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

语法

C#
public bool BuildPyramid()

返回值

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

备注

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

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

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

示例

以下代码示范如何为影像数据集创建金字塔，输出影像数据集的高度与宽度。

假设打开了一个工作空间workspace，工作空间中的数据源（datasource）中包含了一个名为 Image 的影像数据集 （datasetImage）。

CopyC#
public void TestBuildPyramid(Workspace workspace, Datasource datasource)
{
    //打开影像数据集
    DatasetImage datasetImage = (DatasetImage)datasource.Datasets["Image"];
    datasetImage.Close();
    // 判断当前影像数据集是否有金字塔，如果有，移除金字塔后重新创建；如果没有，直接创建金字塔
    if (datasetImage.HasPyramid)
    {
        Boolean isHasPyramid = datasetImage.RemovePyramid();
        Console.WriteLine("判断当前影像数据集是否有金字塔的结果为：" + isHasPyramid);
        datasetImage.BuildPyramid();
    }
    else
    {
        datasetImage.BuildPyramid();
    }

    // 输出影像数据集的高度与宽度
    Console.WriteLine("影像数据集的高度为：" + datasetImage.Height);
    Console.WriteLine("影像数据集的宽度为：" + datasetImage.Width);
}

请参见