com.supermap.data
类 DatasetGridInfo
- java.lang.Object
-
- com.supermap.data.InternalHandle
-
- com.supermap.data.InternalHandleDisposable
-
- com.supermap.data.DatasetGridInfo
-
- 所有已实现的接口:
- IDisposable
public class DatasetGridInfo extends com.supermap.data.InternalHandleDisposable
栅格数据集信息类。
该类包括了返回和设置栅格数据集的相应的设置信息等,例如栅格数据集的名称、宽度、高度、像素格式、编码方式、存储分块大小和空值等。
- 示范代码:
- 以下代码示范如何根据给定的栅格数据集信息,创建栅格数据集。
public void datasetGridInfoTest() { // 假设打开一个工作空间 workspace 对象,工作空间中存在一个数据源 datasource 对象 // 创建一个栅格数据集信息对象,对其进行必要的设置 DatasetGridInfo datasetGridInfo = new DatasetGridInfo(); datasetGridInfo.setName("栅格数据集信息"); datasetGridInfo.setBlockSizeOption(BlockSizeOption.BS_128); datasetGridInfo.setHeight(200); datasetGridInfo.setWidth(200); datasetGridInfo.setNoValue(1.0); datasetGridInfo.setPixelFormat(PixelFormat.SINGLE); datasetGridInfo.setEncodeType(EncodeType.LZW); // 通过栅格数据集信息创建栅格数据集 DatasetGrid datasetGrid = datasource.getDatasets().create( datasetGridInfo); if (datasetGrid != null) { System.out.println(datasetGrid.getName() + "创建成功!"); } }
-
-
构造器概要
构造器 构造器和说明 DatasetGridInfo()
构造一个新的 DatasetGridInfo 对象。DatasetGridInfo(DatasetGridInfo datasetGridInfo)
根据给定的 DatasetGridInfo 对象构造一个与其完全相同的新对象。DatasetGridInfo(String name, DatasetGrid templateDataset)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。DatasetGridInfo(String name, int width, int height, PixelFormat pixelFormat, EncodeType encodeType)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。DatasetGridInfo(String name, int width, int height, PixelFormat pixelFormat, EncodeType encodeType, BlockSizeOption option)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 void
dispose()
释放该对象所占用的资源。BlockSizeOption
getBlockSizeOption()
设置栅格数据集的像素分块。Rectangle2D
getBounds()
返回栅格数据集的地理范围。double
getCommendNoValue()
获取栅格的推荐无值。EncodeType
getEncodeType()
返回栅格数据集数据存储时的编码方式。int
getHeight()
返回栅格数据集的栅格数据的高度。double
getMaxValue()
返回栅格数据集栅格行列中的最大值。double
getMinValue()
返回栅格数据集栅格行列中的最小值。String
getName()
返回栅格数据集信息类的名称。double
getNoValue()
返回栅格数据集的空值,当此数据集为空值时,用户可采用-9999来表示。PixelFormat
getPixelFormat()
返回栅格数据存储的像素格式。int
getWidth()
返回栅格数据集的栅格数据的宽度。void
setBlockSizeOption(BlockSizeOption option)
返回栅格数据集的像素分块。void
setBounds(Rectangle2D value)
设置栅格数据集的地理范围。void
setEncodeType(EncodeType encodeType)
设置格栅格数据集数据存储时的编码方式。void
setHeight(int value)
设置栅格数据集的栅格数据的高度。void
setMaxValue(double value)
设置栅格数据集栅格行列中的最大值。void
setMinValue(double value)
设置栅格数据集栅格行列中的最小值。void
setName(String value)
设置栅格数据集信息类的名称。void
setNoValue(double value)
设置栅格数据集的空值,当此数据集为空值时,用户可采用-9999来表示。void
setPixelFormat(PixelFormat value)
设置栅格数据存储的像素格式。void
setWidth(int value)
设置栅格数据集的栅格数据的宽度。String
toString()
返回一个表示此栅格数据集信息类的格式化字符串。
-
-
-
构造器详细资料
-
DatasetGridInfo
public DatasetGridInfo()
构造一个新的 DatasetGridInfo 对象。
-
DatasetGridInfo
public DatasetGridInfo(DatasetGridInfo datasetGridInfo)
根据给定的 DatasetGridInfo 对象构造一个与其完全相同的新对象。- 参数:
datasetGridInfo
- 用于构造栅格数据集信息新实例的对象。
-
DatasetGridInfo
public DatasetGridInfo(String name, int width, int height, PixelFormat pixelFormat, EncodeType encodeType)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。- 参数:
name
- 栅格数据集的名称。width
- 栅格数据集的宽度。单位为像素。height
- 栅格数据集的高度。单位为像素。pixelFormat
- 栅格数据集的存储的像素格式。encodeType
- 栅格数据集的存储时的编码方式。
-
DatasetGridInfo
public DatasetGridInfo(String name, int width, int height, PixelFormat pixelFormat, EncodeType encodeType, BlockSizeOption option)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。- 参数:
name
- 栅格数据集的名称。width
- 栅格数据集的宽度。单位为像素。height
- 栅格数据集的高度。单位为像素。pixelFormat
- 栅格数据集的存储的像素格式。encodeType
- 栅格数据集的存储时的编码方式。option
- 栅格数据集的像素分块。
-
DatasetGridInfo
public DatasetGridInfo(String name, DatasetGrid templateDataset)
根据指定的参数来构造一个 DatasetGridInfo 的新对象。- 参数:
name
- 指定的名称templateDataset
- 指定的模板数据集。
-
-
方法详细资料
-
getName
public String getName()
返回栅格数据集信息类的名称。- 返回:
- 栅格数据集信息类的名称。
- 默认值:
- 默认值为 "UntitledDatasetGrid"。
-
setName
public void setName(String value)
设置栅格数据集信息类的名称。- 参数:
value
- 栅格数据集信息类的名称。
-
getBounds
public Rectangle2D getBounds()
返回栅格数据集的地理范围。- 返回:
- 栅格数据集的地理范围。
- 默认值:
- 栅格数据集的地理范围即矩形的范围,默认值为(0,0,255,255), 分别为矩形的左边界 X 坐标值、下边界 Y 坐标值、右边界 X 坐标值和上边界 Y 坐标值。
-
setBounds
public void setBounds(Rectangle2D value)
设置栅格数据集的地理范围。- 参数:
value
- 栅格数据集的地理范围。
-
getWidth
public int getWidth()
返回栅格数据集的栅格数据的宽度。单位为像素。- 返回:
- 栅格数据集的栅格数据的宽度。
- 默认值:
- 默认值为 256 像素。
-
setWidth
public void setWidth(int value)
设置栅格数据集的栅格数据的宽度。单位为像素。- 参数:
value
- 栅格数据集的栅格数据的宽度。
-
getHeight
public int getHeight()
返回栅格数据集的栅格数据的高度。单位为像素。- 返回:
- 栅格数据集的栅格数据的高度。
- 默认值:
- 默认值为 256 像素。
-
setHeight
public void setHeight(int value)
设置栅格数据集的栅格数据的高度。单位为像素。- 参数:
value
- 栅格数据集的栅格数据的高度。
-
getPixelFormat
public PixelFormat getPixelFormat()
返回栅格数据存储的像素格式。每个象素采用不同的字节进行表示,单位是比特(bit)。详细信息请参考PixelFormat
枚举类。DatasetGridInfo
目前不支持BIT32
,BIT64
三种像素格式。- 返回:
- 栅格数据存储的像素格式。
- 另请参阅:
PixelFormat
- 默认值:
- 默认值为
DOUBLE
类型。
-
setPixelFormat
public void setPixelFormat(PixelFormat value)
设置栅格数据存储的像素格式。每个象素采用不同的字节进行表示,单位是比特(bit)。详细信息请参考PixelFormat
枚举类。DatasetGridInfo
目前不支持BIT32
,BIT64
三种像素格式。- 参数:
value
- 栅格数据存储的像素格式。- 另请参阅:
PixelFormat
-
getBlockSizeOption
public BlockSizeOption getBlockSizeOption()
设置栅格数据集的像素分块。以正方形方式进行分块存储,如下图所示按照4*4像素进行分块,将栅格数据分为3行*3列的矩阵。其中在进行分块过程中,如果栅格数据不足以进行完整地分块,那么采用空格补充完整进行存储。- 返回:
- 栅格数据集的像素分块。
- 默认值:
- 默认值为
BlockSizeOption.BS_256
。
-
setBlockSizeOption
public void setBlockSizeOption(BlockSizeOption option)
返回栅格数据集的像素分块。- 参数:
option
- 栅格数据集的像素分块。
-
getEncodeType
public EncodeType getEncodeType()
返回栅格数据集数据存储时的编码方式。对数据集采用压缩编码方式,可以减少数据存储所占用的空间,降低数据传输时的网络负载和服务器的负载。矢量数据集支持的编码方式有 Byte,Int16,Int24,Int32,SGL,LZW,DCT,也可以指定为不使用编码方式。光栅数据支持的编码方式有 DCT,SGL,LZW 或不使用编码方式。具体请参见EncodeType
类型。注意:对于某些编码方式,系统有可能会将其改变为更适合该数据集存储时的编码方式。
- 返回:
- 栅格数据集数据存储时的编码方式。
- 另请参阅:
EncodeType
- 默认值:
- 默认值为
NONE
类型。
-
setEncodeType
public void setEncodeType(EncodeType encodeType)
设置格栅格数据集数据存储时的编码方式。对数据集采用压缩编码方式,可以减少数据存储所占用的空间,降低数据传输时的网络负载和服务器的负载。矢量数据集支持的编码方式有 Byte,Int16,Int24,Int32,SGL,LZW,DCT,也可以指定为不使用编码方式。光栅数据支持的编码方式有 DCT,SGL,LZW 或不使用编码方式。具体请参见EncodeType
类型。注意:对于某些编码方式,系统有可能会将其改变为更适合该数据集存储时的编码方式。
- 参数:
encodeType
- 栅格数据集数据存储时的编码方式。- 另请参阅:
EncodeType
-
getNoValue
public double getNoValue()
返回栅格数据集的空值,当此数据集为空值时,用户可采用-9999来表示。- 返回:
- 栅格数据集的空值。
- 默认值:
- 默认值为 -9999。
-
setNoValue
public void setNoValue(double value)
设置栅格数据集的空值,当此数据集为空值时,用户可采用-9999来表示。- 参数:
value
- 栅格数据集的空值。
-
getMinValue
public double getMinValue()
返回栅格数据集栅格行列中的最小值。- 返回:
- 栅格数据集栅格行列中的最小值。
- 默认值:
- 默认值为 0。
-
setMinValue
public void setMinValue(double value)
设置栅格数据集栅格行列中的最小值。- 参数:
value
- 栅格数据集栅格行列中的最小值。
-
getMaxValue
public double getMaxValue()
返回栅格数据集栅格行列中的最大值。- 返回:
- 栅格数据集栅格行列中的最大值。
- 默认值:
- 默认值为 0。
-
setMaxValue
public void setMaxValue(double value)
设置栅格数据集栅格行列中的最大值。- 参数:
value
- 栅格数据集栅格行列中的最大值。
-
toString
public String toString()
返回一个表示此栅格数据集信息类的格式化字符串。该字符串格式为{Name=””,Bounds={},Width=,Height=,PixelFormat=,BlockSize=,EncodeType=,NoValue=,MinValue=,MaxValue=}。
-
dispose
public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
getCommendNoValue
public double getCommendNoValue()
获取栅格的推荐无值。- 返回:
- 根据像素格式推荐一个无值。
-
-
Copyright © 2021–2025 SuperMap. All rights reserved.