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

命名空间:  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);
}

版本信息

SuperMap iObjects .NET


SuperMap Objects .NET

受以下版本支持: 6.1.3

请参见