DatasetMosaic

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

com.supermap.data
类 DatasetMosaic

java.lang.Object
  com.supermap.data.Dataset
      com.supermap.data.DatasetMosaic

public class DatasetMosaic
extends Dataset
extends Dataset

镶嵌数据集。用于高效管理和显示海量影像数据。如今，影像的获取已越来越便捷、高效，针对海量影像的管理、服务发布的需求也越来越普遍。为了更便捷高效地完成这一工作，SuperMap GIS提供了基于镶嵌数据集的解决方案。镶嵌数据集采用元数据+原始影像文件的方式进行管理。把影像数据添加到镶嵌数据集时，只会在镶嵌数据集中记录影像文件的路径、轮廓、分辨率等元信息，在使用时才会根据元信息加载所需的影像文件。该模式相比传统的入库管理方式，大大提升了入库的速度，同时也减少了磁盘的占用。

方法摘要
`boolean`	`addFiles(java.lang.String[] directoryPaths, java.lang.String clipFileExtension)` 向镶嵌数据集中批量添加影像。
`boolean`	`addFiles(java.lang.String[] directoryPaths, java.lang.String clipFileExtension, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues)` 向镶嵌数据集中批量添加影像。
`boolean`	`addFiles(java.lang.String[] directoryPaths, java.lang.String clipFileExtension, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues, MosaicSteppedListener listener)` 向镶嵌数据集中批量添加影像。
`boolean`	`addFiles(java.lang.String directoryPath, java.lang.String extension, java.lang.String clipFileExtension)` 向镶嵌数据集中添加影像，实质是将给定路径下的指定扩展名的所有影像的文件名添加并记录，即镶嵌数据集并没有对影像文件进行拷贝入库，只是记录了影像的全路径（绝对路径）信息。
`java.lang.String`	`addFilesWithReport(java.lang.String[] directoryPaths, java.lang.String clipFileExtension)` 向镶嵌数据集中批量添加影像，并返回添加结果信息。
`java.lang.String`	`addFilesWithReport(java.lang.String[] directoryPaths, java.lang.String clipFileExtension, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues)` 向镶嵌数据集中批量添加影像，并返回添加结果信息。
`boolean`	`addFilesWithReport(java.lang.String[] directoryPaths, java.lang.String clipFileExtension, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues, java.lang.StringBuilder resultJson)` 向镶嵌数据集中批量添加影像。
`boolean`	`addFilesWithReport(java.lang.String[] directoryPaths, java.lang.String clipFileExtension, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues, java.lang.StringBuilder resultJson, MosaicSteppedListener listener)` 向镶嵌数据集中批量添加影像。
`static void`	`addMosaicSteppedListener(MosaicSteppedListener l)` 添加一个用于接收镶嵌数据集所有方法的进度注册（`MosaicSteppedEvent`）的监听器。
`boolean`	`append(DatasetMosaic datasetMosaic, java.lang.String sql, boolean appendOverview)` 追加镶嵌数据集，实质是合并镶嵌数据集.
`boolean`	`append(DatasetMosaic datasetMosaic, java.lang.String sql, boolean appendOverview, MosaicSteppedListener listener)` 追加镶嵌数据集，实质是合并镶嵌数据集.
`boolean`	`buildHistograms(boolean isRebuild)` 对镶嵌数据集里的影像文件创建直方图。
`boolean`	`buildHistograms(boolean isRebuild, MosaicSteppedListener listener)` 对镶嵌数据集里的影像文件创建直方图。
`boolean`	`buildOverview(java.lang.String path, int maxWidth, int maxHeight, int ratio, java.lang.Boolean hasNoValue, java.lang.Double noValue)` 创建镶嵌数据集的概视图（Overview）。
`boolean`	`buildOverview(java.lang.String path, int maxWidth, int maxHeight, int ratio, java.lang.Boolean hasNoValue, java.lang.Double noValue, MosaicSteppedListener listener)` 创建镶嵌数据集的概视图（Overview）。
`boolean`	`buildPyramid(PyramidResampleType type, java.lang.Boolean skipExists)` 为镶嵌数据集中的所有影像创建影像金字塔。
`boolean`	`buildPyramid(PyramidResampleType type, TiffCompressType compressType, java.lang.Boolean skipExists)` 对镶嵌数据集中的影像文件创建金字塔。
`boolean`	`buildPyramid(PyramidResampleType type, TiffCompressType compressType, java.lang.Boolean skipExists, MosaicSteppedListener listener)` 对镶嵌数据集中的影像文件创建金字塔。
`boolean`	`buildStatistics()` 构建镶嵌数据集的统计信息。
`boolean`	`buildStatistics(MosaicSteppedListener listener)` 构建镶嵌数据集的统计信息。
`byte[]`	`buildVRT(Rectangle2D bounds, double nodata)` 对镶嵌数据集指定范围内的影像内容输出为一个VRT虚拟数据集(VRT是GDAL库提供的一种虚拟数据格式)。
`boolean`	`cleanColorBalance()` 清除色彩平衡的对照表，清空存储在数据集的字段中的值。
`int`	`clear()` 删除镶嵌数据集所有内容。
`int`	`clear(MosaicSteppedListener listener)` 删除镶嵌数据集所有内容。
`boolean`	`clearThumbnail()` 清除镶嵌数据集所有影像的缩略图，即清除保存在 Thumbnail字段中缩略图。
`boolean`	`clearThumbnail(int[] ids)` 清除镶嵌数据集的指定ID影像的缩略图，即清除保存在Thumbnail字段中缩略图。
`boolean`	`colorBalance(java.lang.String standardImageFile, MosaicColorBalanceMethod method, double varianceRatio, double brightnessRatio)` 创建色彩平衡的对照表，将存储在数据集的字段中，显示时使用。
`boolean`	`createThumbnail()` 创建镶嵌数据集的所有影像的缩略图，生成的缩略图图片将以以字节流的方式保存在镶嵌数据集的 Thumbnail 字段中。
`boolean`	`createThumbnail(int[] ids, int minEdgeLength)` 根据指定的参数，为镶嵌数据集的影像创建缩略图，生成的缩略图图片将以以字节流的方式保存在镶嵌数据集的 Thumbnail 字段中。
`byte[]`	`createThumbnail(java.lang.String filePath, int id, int minEdgeLength)` 创建指定影像文件的缩略图。
`int`	`getBandCount()` 返回镶嵌数据集波段数。
`DatasetVector`	`getBoundaryDataset()` 返回镶嵌数据集的边界子数据集。
`DatasetVector`	`getClipDataset()` 返回镶嵌数据集的裁剪子数据集。
`DatasetVector`	`getFootprintDataset()` 返回镶嵌数据集的轮廓子数据集。
`int`	`getHeight()` 返回镶嵌数据集的高度，单位为像素。
`PixelFormat`	`getPixelFormat()` 返回镶嵌数据集的位深。
`java.lang.String`	`getSatelliteType()` 使用镶嵌数据集管理卫星影像数据产品时，返回卫星类型名称。
`int`	`getWidth()` 返回镶嵌数据集的宽度，单位为像素。
`int`	`rebuild(boolean isRebuildFootprint, boolean isRebuildBoundary, GeoRegion exRegion, boolean isRebuildClip, java.lang.String postfix, boolean isAutoContour, boolean isExactClip, boolean isComplexShape, int tolerance, int clipPixelLength)` 镶嵌数据集的重建，一般用于镶嵌数据集管理的影像发生变化，如新增、删除影像，使用该功能对轮廓、边界、裁剪子数据集进行重新构建。
`int`	`rebuild(boolean isRebuildFootprint, boolean isRebuildBoundary, GeoRegion exRegion, boolean isRebuildClip, java.lang.String postfix, boolean isAutoContour, boolean isExactClip, boolean isComplexShape, int tolerance, int clipPixelLength, MosaicSteppedListener listener)` 镶嵌数据集的重建，一般用于镶嵌数据集管理的影像发生变化，如新增、删除影像，使用该功能对轮廓、边界、裁剪子数据集进行重新构建。
`static void`	`removeMosaicSteppedListener(MosaicSteppedListener l)` 移除一个用于接收镶嵌数据集所有方法的进度注册（`MosaicSteppedEvent`）的监听器。
`int`	`removeOverview()` 移除镶嵌数据集的概视图。
`int`	`removeOverview(MosaicSteppedListener listener)` 移除镶嵌数据集的概视图。
`boolean`	`removePyramid()` 删除镶嵌数据集中所有影像数据的金字塔。
`boolean`	`removePyramid(MosaicSteppedListener listener)` 删除镶嵌数据集中所有影像数据的金字塔。

从类 com.supermap.data.Dataset 继承的方法
`addClosedListener, addClosingListener, addSteppedListener, close, dispose, getBounds, getDatasource, getDescription, getEncodeType, getExtInfo, getLockState, getName, getPrjCoordSys, getTableName, getType, hasPrjCoordSys, hasVersion, isOpen, isReadOnly, open, removeClosedListener, removeClosingListener, removeSteppedListener, setBounds, setDescription, setExtInfo, setLockState, setPrjCoordSys, setReadOnly`

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

addClosedListener, addClosingListener, addSteppedListener, close, dispose, getBounds, getDatasource, getDescription, getEncodeType, getExtInfo, getLockState, getName, getPrjCoordSys, getTableName, getType, hasPrjCoordSys, hasVersion, isOpen, isReadOnly, open, removeClosedListener, removeClosingListener, removeSteppedListener, setBounds, setDescription, setExtInfo, setLockState, setPrjCoordSys, setReadOnly

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

方法详细信息

addMosaicSteppedListener

public static void addMosaicSteppedListener(MosaicSteppedListener l)

添加一个用于接收镶嵌数据集所有方法的进度注册（MosaicSteppedEvent）的监听器。

参数：: l - 一个用于接收镶嵌数据集所有方法的进度注册事件的监听器。

removeMosaicSteppedListener

public static void removeMosaicSteppedListener(MosaicSteppedListener l)

移除一个用于接收镶嵌数据集所有方法的进度注册（MosaicSteppedEvent）的监听器。

参数：: l - 一个用于接收镶嵌数据集所有方法的进度注册事件的监听器。

getWidth

public int getWidth()

返回镶嵌数据集的宽度，单位为像素。

返回：: 返回镶嵌数据集的宽度，单位为像素。

getHeight

public int getHeight()

返回镶嵌数据集的高度，单位为像素。

返回：: 返回镶嵌数据集的高度，单位为像素。

getBandCount

public int getBandCount()

返回镶嵌数据集波段数。

返回：: 返回镶嵌数据集波段数。

getPixelFormat

public PixelFormat getPixelFormat()

返回镶嵌数据集的位深。

返回：: 返回镶嵌数据集的位深。

getFootprintDataset

public DatasetVector getFootprintDataset()

返回镶嵌数据集的轮廓子数据集。轮廓是影像的边界。

返回：: 返回镶嵌数据集的轮廓子数据集。轮廓是影像的边界。

getBoundaryDataset

public DatasetVector getBoundaryDataset()

返回镶嵌数据集的边界子数据集。

返回：: 返回镶嵌数据集的边界子数据集。

getClipDataset

public DatasetVector getClipDataset()

返回镶嵌数据集的裁剪子数据集。裁剪子数据集作为裁剪对象，对镶嵌数据集中的影像进行裁剪显示。裁剪子数据集默认内容与轮廓相同，也就是使用影像的轮廓作为裁剪显示的裁剪对象。也可以在导入影像文件时，通过clipFileExtension参数指定存储了裁剪对象的文件，这些对象将作为裁剪范围裁剪显示影像。

返回：: 返回镶嵌数据集的裁剪子数据集。裁剪子数据集作为裁剪对象，对镶嵌数据集中的影像进行裁剪显示。

addFiles

public boolean addFiles(java.lang.String directoryPath,
                        java.lang.String extension,
                        java.lang.String clipFileExtension)

向镶嵌数据集中添加影像，实质是将给定路径下的指定扩展名的所有影像的文件名添加并记录，即镶嵌数据集并没有对影像文件进行拷贝入库，只是记录了影像的全路径（绝对路径）信息。

参数：: directoryPath - 指定添加影像的路径，即要添加的影像所在的文件夹路径（绝对路径）。; extension - 影像文件的扩展名。; clipFileExtension - 裁剪形状文件的后缀名，如.shp，该文件中的对象将作为该影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。另外，影像与裁剪形状是一一对应的关系，因此，裁剪形状文件必须存储在directoryPath参数指定的路径下，即裁剪形状文件与影像文件在同一目录下。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

addFiles

public boolean addFiles(java.lang.String[] directoryPaths,
                        java.lang.String clipFileExtension)

向镶嵌数据集中批量添加影像。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

addFiles

public boolean addFiles(java.lang.String[] directoryPaths,
                        java.lang.String clipFileExtension,
                        java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues)

向镶嵌数据集中批量添加影像。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。; fieldValues - 该参数用于镶嵌数据集管理卫星影像数据产品，将卫星影像的元数据信息添加到镶嵌数据集属性表，其结构为嵌套的两个对照表，第一层对照表的key为卫星影像数据清单文件（.csv）的全路径；value为第二层对照表，key为字段值名称，value为字段值。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

addFiles

public boolean addFiles(java.lang.String[] directoryPaths,
                        java.lang.String clipFileExtension,
                        java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues,
                        MosaicSteppedListener listener)

向镶嵌数据集中批量添加影像。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。; fieldValues - 该参数用于镶嵌数据集管理卫星影像数据产品，将卫星影像的元数据信息添加到镶嵌数据集属性表，其结构为嵌套的两个对照表，第一层对照表的key为卫星影像数据清单文件（.csv）的全路径；value为第二层对照表，key为字段值名称，value为字段值。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

addFilesWithReport

public java.lang.String addFilesWithReport(java.lang.String[] directoryPaths,
                                           java.lang.String clipFileExtension)

向镶嵌数据集中批量添加影像，并返回添加结果信息。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。
返回：: 返回添加结果信息，包括：成功添加的影像文件的信息，以及添加失败的影像文件信息。

addFilesWithReport

public java.lang.String addFilesWithReport(java.lang.String[] directoryPaths,
                                           java.lang.String clipFileExtension,
                                           java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues)

向镶嵌数据集中批量添加影像，并返回添加结果信息。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。; fieldValues - 该参数用于镶嵌数据集管理卫星影像数据产品，将卫星影像的元数据信息添加到镶嵌数据集属性表，其结构为嵌套的两个对照表，第一层对照表的key为卫星影像数据清单文件（.csv）的全路径；value为第二层对照表，key为字段值名称，value为字段值。
返回：: 返回添加结果信息，包括：成功添加的影像文件的信息，以及添加失败的影像文件信息。

addFilesWithReport

public boolean addFilesWithReport(java.lang.String[] directoryPaths,
                                  java.lang.String clipFileExtension,
                                  java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues,
                                  java.lang.StringBuilder resultJson)

向镶嵌数据集中批量添加影像。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。; fieldValues - 该参数用于镶嵌数据集管理卫星影像数据产品，将卫星影像的元数据信息添加到镶嵌数据集属性表，其结构为嵌套的两个对照表，第一层对照表的key为卫星影像数据清单文件（.csv）的全路径；value为第二层对照表，key为字段值名称，value为字段值。; resultJson - 影像文件添加结果以JSON 格式化字符串返回，包括：成功添加的影像文件的信息，以及添加失败的影像文件信息。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

addFilesWithReport

public boolean addFilesWithReport(java.lang.String[] directoryPaths,
                                  java.lang.String clipFileExtension,
                                  java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> fieldValues,
                                  java.lang.StringBuilder resultJson,
                                  MosaicSteppedListener listener)

向镶嵌数据集中批量添加影像。

参数：: directoryPaths - 要添加的多个影像文件的全路径（绝对路径）数组。; clipFileExtension - 裁剪形状文件的后缀名，如.shp。裁剪形状将作为影像的裁剪显示范围。影像的裁剪显示一般用于：当影像经过校正后产生无值区域，通过裁剪形状绘制影像的有效值区域，经过裁剪显示后达到去除无值区域的目的。影像与裁剪形状是一一对应的关系，因此，裁剪形状文件与对应的影像文件必须存储在同一目录下。; fieldValues - 该参数用于镶嵌数据集管理卫星影像数据产品，将卫星影像的元数据信息添加到镶嵌数据集属性表，其结构为嵌套的两个对照表，第一层对照表的key为卫星影像数据清单文件（.csv）的全路径；value为第二层对照表，key为字段值名称，value为字段值。; resultJson - 影像文件添加结果以JSON 格式化字符串返回，包括：成功添加的影像文件的信息，以及添加失败的影像文件信息。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 一个布尔值，指示添加影像是否成功，true表示成功；false表示失败。

buildOverview

public boolean buildOverview(java.lang.String path,
                             int maxWidth,
                             int maxHeight,
                             int ratio,
                             java.lang.Boolean hasNoValue,
                             java.lang.Double noValue)

创建镶嵌数据集的概视图（Overview）。为了提高镶嵌数据集的显示效率，默认小比例尺下只显示轮廓线，不显示影像；如果需要在小比例尺下也能显示影像，需要对镶嵌数据集创建概视图。

参数：: path - 概视图的输出路径。; maxWidth - 每幅概视图影像文件的宽度，单位为像素。; maxHeight - 每幅概视图影像文件的高度，单位为像素。; ratio - 相邻概视图层级间的比率。; hasNoValue - 影像中是否有无值区域。; noValue - 指定无值的具体数值。在生成概视图时，将去除指定的无值。
返回：: 一个布尔值，指示创建概视图是否成功，true表示成功；false表示失败。

buildOverview

public boolean buildOverview(java.lang.String path,
                             int maxWidth,
                             int maxHeight,
                             int ratio,
                             java.lang.Boolean hasNoValue,
                             java.lang.Double noValue,
                             MosaicSteppedListener listener)

参数：: path - 概视图的输出路径。; maxWidth - 每幅概视图影像文件的宽度，单位为像素。; maxHeight - 每幅概视图影像文件的高度，单位为像素。; ratio - 相邻概视图层级间的比率。; hasNoValue - 影像中是否有无值区域。; noValue - 指定无值的具体数值。在生成概视图时，将去除指定的无值。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 一个布尔值，指示创建概视图是否成功，true表示成功；false表示失败。

buildStatistics

public boolean buildStatistics()

构建镶嵌数据集的统计信息。

返回：: 一个布尔值，指示统计信息构建是否成功，true表示成功；false表示失败。

buildStatistics

public boolean buildStatistics(MosaicSteppedListener listener)

构建镶嵌数据集的统计信息。

参数：: listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 一个布尔值，指示统计信息构建是否成功，true表示成功；false表示失败。

buildHistograms

public boolean buildHistograms(boolean isRebuild)

对镶嵌数据集里的影像文件创建直方图。

参数：: isRebuild - 一个布尔值，指示是否重建直方图，true，表示重建直方图，即删除影像已有直方图，重新创建新的直方图；false，表示跳过已有直方图的影像。
返回：: 一个布尔值，指示创建直方图是否成功，true表示成功；false表示失败。

buildHistograms

public boolean buildHistograms(boolean isRebuild,
                               MosaicSteppedListener listener)

对镶嵌数据集里的影像文件创建直方图。

参数：: isRebuild - 一个布尔值，指示是否重建直方图，true，表示重建直方图，即删除影像已有直方图，重新创建新的直方图；false，表示跳过已有直方图的影像。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 一个布尔值，指示创建直方图是否成功，true表示成功；false表示失败。

buildPyramid

public boolean buildPyramid(PyramidResampleType type,
                            java.lang.Boolean skipExists)

为镶嵌数据集中的所有影像创建影像金字塔。

参数：: type - 金字塔重采样方式。; skipExists - 一个布尔值，指示如果影像已经创建了金字塔是否忽略，true表示忽略，即不再重新创建金字塔；false表示对已经创建金字塔的影像重新创建金字塔。
返回：: 成功创建返回true；否则返回false。

buildPyramid

public boolean buildPyramid(PyramidResampleType type,
                            TiffCompressType compressType,
                            java.lang.Boolean skipExists)

对镶嵌数据集中的影像文件创建金字塔。

参数：: type - 重采样方法。; compressType - 压缩编码方式。; skipExists - 是否跳过已有金字塔的影像，如果为true，表示跳过已有金字塔的影像，不再对其创建金字塔；false，表示将对已有金字塔的影像重新创建金字塔。
返回：: 创建成功返回true，否则为false。

buildPyramid

public boolean buildPyramid(PyramidResampleType type,
                            TiffCompressType compressType,
                            java.lang.Boolean skipExists,
                            MosaicSteppedListener listener)

对镶嵌数据集中的影像文件创建金字塔。

参数：: type - 重采样方法。; compressType - 压缩编码方式。; skipExists - 是否跳过已有金字塔的影像，如果为true，表示跳过已有金字塔的影像，不再对其创建金字塔；false，表示将对已有金字塔的影像重新创建金字塔。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 创建成功返回true，否则为false。

removePyramid

public boolean removePyramid()

删除镶嵌数据集中所有影像数据的金字塔。

返回：: 删除成功返回true，否则为false。

removePyramid

public boolean removePyramid(MosaicSteppedListener listener)

删除镶嵌数据集中所有影像数据的金字塔。

参数：: listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 删除成功返回true，否则为false。

clear

public int clear()

删除镶嵌数据集所有内容。

返回：: 删除成功返回0；否则返回一个非零的错误码。

clear

public int clear(MosaicSteppedListener listener)

删除镶嵌数据集所有内容。

参数：: listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 删除成功返回0；否则返回一个非零的错误码。

removeOverview

public int removeOverview()

移除镶嵌数据集的概视图。

返回：: 移除成功返回0；否则返回一个非零的错误码。

removeOverview

public int removeOverview(MosaicSteppedListener listener)

移除镶嵌数据集的概视图。

参数：: listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 移除成功返回0；否则返回一个非零的错误码。

rebuild

public int rebuild(boolean isRebuildFootprint,
                   boolean isRebuildBoundary,
                   GeoRegion exRegion,
                   boolean isRebuildClip,
                   java.lang.String postfix,
                   boolean isAutoContour,
                   boolean isExactClip,
                   boolean isComplexShape,
                   int tolerance,
                   int clipPixelLength)

镶嵌数据集的重建，一般用于镶嵌数据集管理的影像发生变化，如新增、删除影像，使用该功能对轮廓、边界、裁剪子数据集进行重新构建。

参数：: isRebuildFootprint - 是否重新构建轮廓。; isRebuildBoundary - 是否以exRegion参数指定的对象，更新边界数据集内容。; exRegion - 用于更新边界数据集内容为指定的几何面对象。; isRebuildClip - 是否以postfix参数指定的文件中的裁剪形状，更新裁剪数据集内容。; postfix - 用于影像裁剪显示的裁剪形状文件的扩展名。用于影像裁剪显示的裁剪区形状文件的扩展名。影像裁剪区的矢量文件类型。影像的裁剪区为影像的有效值范围，若影像有配套的限定其裁剪区的矢量文件，通过指定该参数，影像添加时，将影像的裁剪区将更新到镶嵌数据集的裁剪子数据集中，后续用于去除无值的显示设置。若裁剪区的矢量文件类型为shapefile，该参数值为.shp。; isAutoContour - 是否使用系统自动提取影像有效轮廓的功能来重建镶嵌数据集轮廓。; isExactClip - 是否使用精确裁剪提取影像有效轮廓来重建镶嵌数据集轮廓。精确裁剪将基于原始影像文件提取影像有效轮廓；否则，基于影像金字塔文件提取影像有效轮廓，提取效率高于精确裁剪。; isComplexShape - 该参数用于使用精确裁剪的方式（即 isExactClip 参数设置为true时）重建镶嵌数据集的裁剪范围。若影像有效值轮廓为不规则的复杂多边形时，该参数值必须设置为true。; tolerance - 当使用自动计算裁剪范围功能时，该容限可以调整所判断的无值，即无值不再是一个值，而是在容限范围内的所有值，这样可以避免提取后影像有效区域边界出现噪音的情况。; clipPixelLength - 有时影像轮廓所确定的裁剪区，其边界存在一些无值，所以可以设置该参数，从而使裁剪区小于轮廓，即为影像轮廓向内缩小该参数指定像素值后的区域。
返回：: 成功返回0；否则返回一个非零的错误码。

rebuild

public int rebuild(boolean isRebuildFootprint,
                   boolean isRebuildBoundary,
                   GeoRegion exRegion,
                   boolean isRebuildClip,
                   java.lang.String postfix,
                   boolean isAutoContour,
                   boolean isExactClip,
                   boolean isComplexShape,
                   int tolerance,
                   int clipPixelLength,
                   MosaicSteppedListener listener)

镶嵌数据集的重建，一般用于镶嵌数据集管理的影像发生变化，如新增、删除影像，使用该功能对轮廓、边界、裁剪子数据集进行重新构建。

参数：: isRebuildFootprint - 是否重新构建轮廓。; isRebuildBoundary - 是否以exRegion参数指定的对象，更新边界数据集内容。; exRegion - 用于更新边界数据集内容为指定的几何面对象。; isRebuildClip - 是否以postfix参数指定的文件中的裁剪形状，更新裁剪数据集内容。; postfix - 用于影像裁剪显示的裁剪形状文件的扩展名。用于影像裁剪显示的裁剪区形状文件的扩展名。影像裁剪区的矢量文件类型。影像的裁剪区为影像的有效值范围，若影像有配套的限定其裁剪区的矢量文件，通过指定该参数，影像添加时，将影像的裁剪区将更新到镶嵌数据集的裁剪子数据集中，后续用于去除无值的显示设置。若裁剪区的矢量文件类型为shapefile，该参数值为.shp。; isAutoContour - 是否使用系统自动提取影像有效轮廓的功能来重建镶嵌数据集轮廓。; isExactClip - 是否使用精确裁剪提取影像有效轮廓来重建镶嵌数据集轮廓。精确裁剪将基于原始影像文件提取影像有效轮廓；否则，基于影像金字塔文件提取影像有效轮廓，提取效率高于精确裁剪。; isComplexShape - 该参数用于使用精确裁剪的方式（即 isExactClip 参数设置为true时）重建镶嵌数据集的裁剪范围。若影像有效值轮廓为不规则的复杂多边形时，该参数值必须设置为true。; tolerance - 当使用自动计算裁剪范围功能时，该容限可以调整所判断的无值，即无值不再是一个值，而是在容限范围内的所有值，这样可以避免提取后影像有效区域边界出现噪音的情况。; clipPixelLength - 有时影像轮廓所确定的裁剪区，其边界存在一些无值，所以可以设置该参数，从而使裁剪区小于轮廓，即为影像轮廓向内缩小该参数指定像素值后的区域。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 成功返回0；否则返回一个非零的错误码。

append

public boolean append(DatasetMosaic datasetMosaic,
                      java.lang.String sql,
                      boolean appendOverview)

追加镶嵌数据集，实质是合并镶嵌数据集.

参数：: datasetMosaic - 追加的镶嵌数据集，该镶嵌数据集将被追加到当前镶嵌数据集中。; sql - 过滤表达式，将符合过滤条件的影像追加到目标镶嵌数据集。; appendOverview - 追加的镶嵌数据集的概视图是否参与追加，true，表示概视图也追加到当前镶嵌数据集中；false，表示概视图不参与追加操作。
返回：: 追加成功返回true；否则为false。

append

public boolean append(DatasetMosaic datasetMosaic,
                      java.lang.String sql,
                      boolean appendOverview,
                      MosaicSteppedListener listener)

追加镶嵌数据集，实质是合并镶嵌数据集.

参数：: datasetMosaic - 追加的镶嵌数据集，该镶嵌数据集将被追加到当前镶嵌数据集中。; sql - 过滤表达式，将符合过滤条件的影像追加到目标镶嵌数据集。; appendOverview - 追加的镶嵌数据集的概视图是否参与追加，true，表示概视图也追加到当前镶嵌数据集中；false，表示概视图不参与追加操作。; listener - 事件监听，用于获取方法执行的进度与取消操作。
返回：: 追加成功返回true；否则为false。

colorBalance

public boolean colorBalance(java.lang.String standardImageFile,
                            MosaicColorBalanceMethod method,
                            double varianceRatio,
                            double brightnessRatio)

创建色彩平衡的对照表，将存储在数据集的字段中，显示时使用。

参数：: standardImageFile - 色彩平衡标准文件路径。; method - 色彩平衡模式。; varianceRatio - 方差扩展系数。; brightnessRatio - 亮度系数。
返回：: 创建成功返回true；否则为false。

cleanColorBalance

public boolean cleanColorBalance()

清除色彩平衡的对照表，清空存储在数据集的字段中的值。

返回：: 清除成功返回true；否则为false。

getSatelliteType

public java.lang.String getSatelliteType()

使用镶嵌数据集管理卫星影像数据产品时，返回卫星类型名称。

返回：

createThumbnail

public boolean createThumbnail()

创建镶嵌数据集的所有影像的缩略图，生成的缩略图图片将以以字节流的方式保存在镶嵌数据集的 Thumbnail 字段中。

返回：: 创建成功返回true；否则为false。

createThumbnail

public boolean createThumbnail(int[] ids,
                               int minEdgeLength)

根据指定的参数，为镶嵌数据集的影像创建缩略图，生成的缩略图图片将以以字节流的方式保存在镶嵌数据集的 Thumbnail 字段中。

参数：: ids - 指定ID数组，为指定ID影像创建缩略图。如果该参数为空则生成所有影像的缩略图。; minEdgeLength - 指定缩略图图片的最小边长，默认为512像素。
返回：: 创建成功返回true；否则为false。

createThumbnail

public byte[] createThumbnail(java.lang.String filePath,
                              int id,
                              int minEdgeLength)

创建指定影像文件的缩略图。

参数：: filePath - 指定影像文件的全路径。; id - 指定影像的ID。; minEdgeLength - 指定缩略图图片的最小边长，默认为512像素。
返回：: 创建成功返回true；否则为false。

clearThumbnail

public boolean clearThumbnail()

清除镶嵌数据集所有影像的缩略图，即清除保存在 Thumbnail字段中缩略图。

返回：: 清除成功返回true；否则为false。

clearThumbnail

public boolean clearThumbnail(int[] ids)

清除镶嵌数据集的指定ID影像的缩略图，即清除保存在Thumbnail字段中缩略图。

参数：: ids - 指定ID数组，清除指定ID影像的缩略图。如果该参数为空则清除所有影像的缩略图。
返回：: 清除成功返回true；否则为false。

buildVRT

public byte[] buildVRT(Rectangle2D bounds,
                       double nodata)

对镶嵌数据集指定范围内的影像内容输出为一个VRT虚拟数据集(VRT是GDAL库提供的一种虚拟数据格式)。VRT虚拟数据集使用格式化的XML字符串流返回，采用标准的 Warped VRT 描述。

参数：: bounds - 指定影像范围，一个矩形范围。; nodata - 指定影像的无值。
返回：

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

com.supermap.data 类 DatasetMosaic

addMosaicSteppedListener

removeMosaicSteppedListener

getWidth

getHeight

getBandCount

getPixelFormat

getFootprintDataset

getBoundaryDataset

getClipDataset

addFiles

addFiles

addFiles

addFiles

addFilesWithReport

addFilesWithReport

addFilesWithReport

addFilesWithReport

buildOverview

buildOverview

buildStatistics

buildStatistics

buildHistograms

buildHistograms

buildPyramid

buildPyramid

buildPyramid

removePyramid

removePyramid

clear

clear

removeOverview

removeOverview

rebuild

rebuild

append

append

colorBalance

cleanColorBalance

getSatelliteType

createThumbnail

createThumbnail

createThumbnail

clearThumbnail

clearThumbnail

buildVRT

com.supermap.data
类 DatasetMosaic