com.supermap.data

类 DatasetImage



  • public class DatasetImage
    extends Dataset

    影像数据集类。

    影像数据集类,该类用于描述影像数据,不具备属性信息,例如影像地图、多波段影像和实物地图等。影像不支持单波段8位。

    光栅数据采用网格形式组织并使用二维栅格的像素值来记录数据,每个栅格(cell)代表一个像素要素,栅格值可以描述各种数据信息。影像数据集中每一个栅格存储的是一个颜色值或颜色的索引值(RGB 值)。

    注意:在对数据集进行操作前需要先打开数据集,即调用 Dataset.open() 方法。

    • 方法详细资料

      • getWidth

        public int getWidth()
        返回影像数据集的影像数据的宽度。单位为像素。
        返回:
        影像数据集的影像数据的宽度。
      • getHeight

        public int getHeight()
        返回影像数据集的影像数据的高度。单位为像素。
        返回:
        影像数据集的影像数据的高度。
      • getPixelFormat

        public PixelFormat getPixelFormat()
        返回影像数据存储的像素格式。每个象素采用不同的字节进行表示,单位是比特(bit)。详细信息请参考 PixelFormat 枚举类。

        注意:影像数据集类不支持 DOUBLESINGLEBIT64 类型的像素格式。

        返回:
        影像数据存储的像素格式。
        另请参阅:
        PixelFormat
      • getHasPyramid

        public boolean getHasPyramid()
        判断影像数据集是否已创建影像金字塔。true 表示已经创建,false 表示未创建。
        返回:
        影像数据集是否已创建影像金字塔。
      • getColorSpace

        public ColorSpaceType getColorSpace()
        返回色彩显示模式。
        返回:
        色彩显示模式。
      • getPixel

        public Color getPixel(int column,
                              int row,
                              int[] indexes)
        根据指定的像素所在的行数、列数以及索引号,返回像素的颜色。
        参数:
        column - 指定的像素所在的列数。
        row - 指定的像素所在的行数。
        indexes - 指定的像素的序列号。
        返回:
        指定像素的颜色。
      • getMapCacheService

        public DatasetImage.MapCacheService getMapCacheService()
        获取地图预缓存服务。
        返回:
        地图预缓存服务。
      • getBandCount

        public int getBandCount()
        获取影像数据集的波段数
        返回:
        影像数据集的波段数。
      • buildPyramid

        public boolean buildPyramid()
        创建影像金字塔,创建前,必须先关闭数据集
        返回:
        返回创建影像金字塔是否创建成功,成功返回true,否则返回false。
      • updatePyramid

        public boolean updatePyramid(Rectangle2D bounds)
        按指定范围更新栅格数据集影像金字塔
        参数:
        bounds - 指定的更新范围。
        返回:
        返回是否更新成功,成功返回true,否则返回false。
      • removePyramid

        public boolean removePyramid()
        删除已创建的金字塔
        返回:
        是否删除成功,成功返回true,否则返回false。
      • setPyramidFirstLevel

        public void setPyramidFirstLevel(int nFirstLevel)
        设置建立金字塔的初始级别,默认从第2级到顶级,可以设置成第1级/第2级/第4级...
        参数:
        nFirstLevel - 开始创建金字塔的级别
      • getPyramidFirstLevel

        public int getPyramidFirstLevel()
        获取建立金字塔的初始级别,默认为2
        返回:
        建立金字塔的初始级别
      • setOriginalPyramid

        public void setOriginalPyramid(boolean bOriginalPyramid)
        设置是否使用原始金字塔层级
        参数:
        bOriginalPyramid - 是否使用原始金字塔层级
      • isOriginalPyramid

        public boolean isOriginalPyramid()
        获取是否使用原始金字塔层级
        返回:
        是否使用原始金字塔层级