DatasetImage

java.lang.Object
- com.supermap.data.Dataset
- - com.supermap.data.DatasetImage

```
public class DatasetImage
extends Dataset
```
影像数据集类。

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

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

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

嵌套类概要

嵌套类
限定符和类型	类和说明
`class`	`DatasetImage.MapCacheService` 地图预缓存服务类，用于网络地图预缓存，目前支持iServerRest地图、SuperMapCloud地图、Google地图和WMTS地图服务。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`buildPyramid()` 创建影像金字塔,创建前，必须先关闭数据集
`int`	`getBandCount()` 获取影像数据集的波段数
`ColorSpaceType`	`getColorSpace()` 返回色彩显示模式。
`boolean`	`getHasPyramid()` 判断影像数据集是否已创建影像金字塔。
`int`	`getHeight()` 返回影像数据集的影像数据的高度。
`DatasetImage.MapCacheService`	`getMapCacheService()` 获取地图预缓存服务。
`Color`	`getPixel(int column, int row, int[] indexes)` 根据指定的像素所在的行数、列数以及索引号，返回像素的颜色。
`PixelFormat`	`getPixelFormat()` 返回影像数据存储的像素格式。
`int`	`getPyramidFirstLevel()` 获取建立金字塔的初始级别，默认为2
`int`	`getWidth()` 返回影像数据集的影像数据的宽度。
`boolean`	`isOriginalPyramid()` 获取是否使用原始金字塔层级
`boolean`	`removePyramid()` 删除已创建的金字塔
`void`	`setOriginalPyramid(boolean bOriginalPyramid)` 设置是否使用原始金字塔层级
`void`	`setPyramidFirstLevel(int nFirstLevel)` 设置建立金字塔的初始级别,默认从第2级到顶级,可以设置成第1级/第2级/第4级...
`boolean`	`updatePyramid(Rectangle2D bounds)` 按指定范围更新栅格数据集影像金字塔

从类继承的方法 com.supermap.data.Dataset
close, getBounds, getDatasource, getDescription, getEncodeType, getName, getPrjCoordSys, getType, isOpen, isReadOnly, open, setDescription, setName, setPrjCoordSys, setReadOnly

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getWidth
```
public int getWidth()
```
    返回影像数据集的影像数据的宽度。单位为像素。
    
    返回:
    
    影像数据集的影像数据的宽度。
  - getHeight
```
public int getHeight()
```
    返回影像数据集的影像数据的高度。单位为像素。
    
    返回:
    
    影像数据集的影像数据的高度。
  - getPixelFormat
```
public PixelFormat getPixelFormat()
```
    返回影像数据存储的像素格式。每个象素采用不同的字节进行表示，单位是比特（bit）。详细信息请参考 PixelFormat 枚举类。
    注意：影像数据集类不支持 DOUBLE、SINGLE、BIT64 类型的像素格式。
    
    返回:
    
    影像数据存储的像素格式。
    
    另请参阅:
    
    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()
```
    获取是否使用原始金字塔层级
    
    返回:
    
    是否使用原始金字塔层级

类 DatasetImage

嵌套类概要

方法概要

从类继承的方法 com.supermap.data.Dataset

从类继承的方法 java.lang.Object

方法详细资料

getWidth

getHeight

getPixelFormat

getHasPyramid

getColorSpace

getPixel

getMapCacheService

getBandCount

buildPyramid

updatePyramid

removePyramid

setPyramidFirstLevel

getPyramidFirstLevel

setOriginalPyramid

isOriginalPyramid