所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.processing.MapCache3DBuilder

所有已实现的接口:

IDisposable
```
public class MapCache3DBuilder
extends com.supermap.data.InternalHandleDisposable
```
三维地图瓦片生成类，该类主要用于为地图生成供三维场景发布使用的三维地图瓦片，其配置文件为 *.sci3d 格式。三维地图瓦片的金字塔文件目录结构与影像瓦片一致。
三维瓦片是一种用于改善三维场景浏览用户体验的优化策略。服务器端创建了三维瓦片之后，客户端用户的每一次地图浏览，比如平移、放大、缩小地图，都会向服务器端发送一个 URL 请求，此时，服务器端按照匹配的条件，将已瓦片的数据返回到客户端。

需要注意的是，由于三维地图瓦片按经纬度坐标系全球剖分，因此只支持经纬度坐标系，在打开地图数据后必须设置为动态投影（WGS1984）。若地图为投影坐标系，用户可使用 SuperMap Deskpro .NET 6R 产品将坐标系转换为经纬度坐标系后，再生成瓦片。

关于三维地图瓦片的详细介绍请参见《二三维瓦片》技术文档。

构造器概要

构造器
构造器和说明
`MapCache3DBuilder()` 构造一个新的三维瓦片生成类对象。
`MapCache3DBuilder(Map map, String outputFolder)` 根据给定的参数，构造一个新的三维瓦片生成类对象。
`MapCache3DBuilder(Map map, String outputFolder, String name)` 根据给定的参数，构造一个新的三维瓦片生成类对象。

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addSteppedListener(SteppedListener l)` 添加一个用于接收进度条事件（`SteppedEvent`）的监听器。
`boolean`	`build()` 创建地图瓦片。
`boolean`	`buildWithoutConfigFile()` 为地图对象创建三维地图瓦片。
`String[]`	`computeImageFileName()` 返回计算得到的各个层上的瓦片图片名称列表。
`String[]`	`computeImageFileName(int specialLevel)` 根据参数指定的瓦片层数计算该层下的瓦片图片名称列表。
`boolean`	`computeLevel()` 计算生成瓦片的数据集所适合的瓦片层数。
`void`	`dispose()` 释放该对象所占用的资源。
`boolean`	`fromConfigFile(String fileName)` 导入瓦片文件，根据瓦片数据的配置文件中的内容来指定相关设置的值。
`int`	`getBeginLevel()` 返回开始生成瓦片的层数。
`Rectangle2D`	`getBounds()` 返回导出的地理范围。
`boolean`	`getBuildFromOriginalResolution()` 获取是否由精细层瓦片往上合并
`String`	`getCacheName()` 返回生成瓦片的配置文件的名称。
`GeoRegion`	`getClipRegion()` 返回用于生成瓦片的多边形区域。
`int`	`getEndLevel()` 返回结束生成瓦片的层数。
`int`	`getImageCompress()` 返回瓦片图片的压缩率，默认为 75。
`CacheImageSize`	`getImageSize()` 返回瓦片图片的大小，默认为 `CacheImageSize.SIZE256`。
`CacheImageType`	`getImageType()` 返回瓦片图片的类型。
`Map`	`getMap()` 返回用于创建瓦片的地图。
`String`	`getOutputFolder()` 返回生成瓦片的路径。
`String`	`getPassword()` 返回用于创建瓦片时对数据进行加密的密码。
`int`	`getProcessThreadsCount()` 获取生成瓦片线程数
`StorageType`	`getStorageType()` 返回瓦片的存储方式。
`MapTilingMode`	`getTilingMode()` 获取地图生成瓦片的剖分方式。
`boolean`	`isFillMargin()` 返回瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
`boolean`	`isTransparent()` 返回瓦片图片是否背景透明。
`void`	`removeSteppedListener(SteppedListener l)` 移除一个用于接收进度条事件（`SteppedEvent`）的监听器。
`void`	`setBeginLevel(int value)` 设置开始生成瓦片的层数。
`void`	`setBounds(Rectangle2D bounds)` 设置导出的地理范围。
`void`	`setBuildFromOriginalResolution(boolean buildFromOriginalResolution)` 设置是否由精细层瓦片往上合并
`void`	`setCacheName(String value)` 设置生成瓦片的配置文件的名称。
`void`	`setClipRegion(GeoRegion value)` 设置用于生成瓦片的多边形区域。
`void`	`setEndLevel(int value)` 设置结束生成瓦片的层数。
`void`	`setFillMargin(boolean bool)` 设置瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
`void`	`setImageCompress(int imageCompress)` 设置瓦片图片的压缩率。
`void`	`setImageSize(CacheImageSize imageSize)` 设置瓦片图片的大小，默认为 `CacheImageSize.SIZE256`。
`void`	`setImageType(CacheImageType cacheImageType)` 设置瓦片图片的类型。
`static void`	`setIsDisposable(com.supermap.data.InternalHandleDisposable obj, boolean disposable)`
`void`	`setMap(Map map)` 设置需要生成瓦片的地图。
`void`	`setOutputFolder(String outputFolder)` 设置生成瓦片的路径。
`void`	`setPassword(String passwd)` 设置用于创建瓦片时对数据进行加密的密码。
`void`	`setProcessThreadsCount(int threadCount)` 设置生成瓦片线程数
`void`	`setStorageType(StorageType storageType)` 设置瓦片的存储方式
`void`	`setTilingMode(MapTilingMode mode)` 设置地图生成瓦片的剖分方式。
`void`	`setTransparent(boolean bool)` 设置瓦片图片是否背景透明。
`boolean`	`toConfigFile(String fileName)` 将对象的相关属性信息写到指定的文件中，文件的后缀名为 .sci3d，即瓦片数据的配置文件。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

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

- 构造器详细资料
  - MapCache3DBuilder
```
public MapCache3DBuilder()
```
    构造一个新的三维瓦片生成类对象。
  - MapCache3DBuilder
```
public MapCache3DBuilder(Map map,
                         String outputFolder)
```
    根据给定的参数，构造一个新的三维瓦片生成类对象。
    该构造函数生成的瓦片对象的名字与地图的名称相同，在执行该构造函数后会自动执行 computeLevel 的方法。
    
    参数:
    
    map - 指定的要生成瓦片的地图。
    
    outputFolder - 指定的生成瓦片的路径。
  - MapCache3DBuilder
```
public MapCache3DBuilder(Map map,
                         String outputFolder,
                         String name)
```
    根据给定的参数，构造一个新的三维瓦片生成类对象。
    
    参数:
    
    map - 要生成瓦片的地图。
    
    outputFolder - 生成瓦片的路径。
    
    name - 生成瓦片的名称。
- 方法详细资料
  - getMap
```
public Map getMap()
```
    返回用于创建瓦片的地图。
    
    返回:
    
    用于创建瓦片的地图。
    
    默认值:
    
    默认值为 null。
  - setMap
```
public void setMap(Map map)
```
    设置需要生成瓦片的地图。
    
    参数:
    
    map - 需要生成瓦片的地图。
  - getClipRegion
```
public GeoRegion getClipRegion()
```
    返回用于生成瓦片的多边形区域。
    
    返回:
    
    用于生成瓦片的多边形区域。
    
    默认值:
    
    默认值为 null。
  - setClipRegion
```
public void setClipRegion(GeoRegion value)
```
    设置用于生成瓦片的多边形区域。
    
    参数:
    
    value - 用于生成瓦片的多边形区域。
  - getBounds
```
public Rectangle2D getBounds()
```
    返回导出的地理范围。该方法进行必须设置。
    
    返回:
    
    导出的地理范围。
    
    默认值:
    
    默认值为(-180,-90,180,90)，即全球范围。
  - setBounds
```
public void setBounds(Rectangle2D bounds)
```
    设置导出的地理范围。该方法进行必须设置。
    
    参数:
    
    bounds - 导出的地理范围。
  - getCacheName
```
public String getCacheName()
```
    返回生成瓦片的配置文件的名称。
    
    返回:
    
    生成瓦片的配置文件的名称。
    
    默认值:
    
    默认值为 "UntitledCache"。
  - setCacheName
```
public void setCacheName(String value)
```
    设置生成瓦片的配置文件的名称。
    
    参数:
    
    value - 生成瓦片的配置文件的名称。
  - getImageSize
```
public CacheImageSize getImageSize()
```
    返回瓦片图片的大小，默认为 CacheImageSize.SIZE256。
    
    返回:
    
    瓦片图片的大小，默认为 CacheImageSize.SIZE256。
    
    默认值:
    
    默认值为 CacheImageSize.SIZE256。
  - setImageSize
```
public void setImageSize(CacheImageSize imageSize)
```
    设置瓦片图片的大小，默认为 CacheImageSize.SIZE256。
    
    参数:
    
    imageSize - 瓦片图片的大小，默认为 CacheImageSize.SIZE256。
  - getImageCompress
```
public int getImageCompress()
```
    返回瓦片图片的压缩率，默认为 75。
    
    返回:
    
    瓦片图片的压缩率，默认为 75。
    
    默认值:
    
    默认值为 75。
  - setImageCompress
```
public void setImageCompress(int imageCompress)
```
    设置瓦片图片的压缩率。
    
    参数:
    
    imageCompress - 瓦片图片的压缩率。
  - getOutputFolder
```
public String getOutputFolder()
```
    返回生成瓦片的路径。
    
    返回:
    
    生成瓦片的路径。
    
    默认值:
    
    默认值为一个空字符串。
  - setOutputFolder
```
public void setOutputFolder(String outputFolder)
```
    设置生成瓦片的路径。
    
    参数:
    
    outputFolder - 生成瓦片的路径。
  - isTransparent
```
public boolean isTransparent()
```
    返回瓦片图片是否背景透明。默认为 false。
    
    返回:
    
    瓦片图片是否背景透明。
    
    默认值:
    
    默认为 false。
  - setTransparent
```
public void setTransparent(boolean bool)
```
    设置瓦片图片是否背景透明。默认为 false。
    
    参数:
    
    bool - 瓦片图片是否背景透明。
  - getImageType
```
public CacheImageType getImageType()
```
    返回瓦片图片的类型。
    
    返回:
    
    瓦片图片的类型，默认为 CacheImageType.JPG。
    
    默认值:
    
    默认值为 CacheImageType.JPG。
  - isFillMargin
```
public boolean isFillMargin()
```
    返回瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
    
    返回:
    
    一个布尔值，用来指示瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
  - setFillMargin
```
public void setFillMargin(boolean bool)
```
    设置瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
    
    参数:
    
    bool - 一个布尔值，用来指示瓦片图片是否填充空白区域，true，表示填充空白区域；false，表示不填充。
  - setImageType
```
public void setImageType(CacheImageType cacheImageType)
```
    设置瓦片图片的类型。
    
    参数:
    
    cacheImageType - 瓦片图片的类型，默认为 CacheImageType.PNG。
  - getStorageType
```
public StorageType getStorageType()
```
    返回瓦片的存储方式。
    
    返回:
    
    瓦片的存储方式。
    
    默认值:
    
    默认值为 StorageType.Original ，即原始模式。
  - setStorageType
```
public void setStorageType(StorageType storageType)
```
    设置瓦片的存储方式
    
    参数:
    
    storageType - 瓦片的存储方式。
  - getBeginLevel
```
public int getBeginLevel()
```
    返回开始生成瓦片的层数。
    层是存放数据的根节点，每层存放了不同比例尺下的数据，开始的层数用来指定显示数据的最小分辨率。
    
    返回:
    
    开始生成瓦片的层数。
    
    默认值:
    
    默认值为 0。
  - setBeginLevel
```
public void setBeginLevel(int value)
```
    设置开始生成瓦片的层数。
    层是存放数据的根节点，每层存放了不同比例尺下的数据，开始的层数用来指定显示数据的最小分辨率。
    
    参数:
    
    value - 开始生成瓦片的层数。
  - getEndLevel
```
public int getEndLevel()
```
    返回结束生成瓦片的层数。
    层是存放数据的根节点，每层存放了不同比例尺下的数据，结束的层数用来指定显示数据的最高分辨率。
    
    返回:
    
    结束生成瓦片的层数。
    
    默认值:
    
    默认值为 4。
  - addSteppedListener
```
public void addSteppedListener(SteppedListener l)
```
    添加一个用于接收进度条事件（SteppedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收进度条事件的监听器。
  - setEndLevel
```
public void setEndLevel(int value)
```
    设置结束生成瓦片的层数。
    层是存放数据的根节点，每层存放了不同比例尺下的数据，结束的层数用来指定显示数据的最高分辨率。
    
    参数:
    
    value - 结束生成瓦片的层数。
  - getPassword
```
public String getPassword()
```
    返回用于创建瓦片时对数据进行加密的密码。在添加图层时，需要使用该密码才能成功添加。如果使用默认值，便可不指定密码便能打开。
    该密码不会写到瓦片数据的配置文件中，同时，fromConfigFile() 方法也不会还原该密码。
    
    返回:
    
    用于创建瓦片时对数据进行加密的密码。
    
    默认值:
    
    默认值为一个空的字符串。
  - setPassword
```
public void setPassword(String passwd)
```
    设置用于创建瓦片时对数据进行加密的密码。在添加图层时，需要使用该密码才能成功添加。如果使用默认值，便可不指定密码便能打开。
    注意：当 StorageType.Original 时，该方法是无效的；当 StorageType.Compact 时，该方法才有效。
    
    参数:
    
    passwd - 用于创建瓦片时对数据进行加密的密码。
  - computeLevel
```
public boolean computeLevel()
```
    计算生成瓦片的数据集所适合的瓦片层数。
    在有参构造函数中会自动调用该方法。但用户在调用 setMap() 方法时，将不会自动执行该方法。
    
    返回:
    
    一个布尔值，计算成功返回 true，否则返回 false。
  - build
```
public boolean build()
```
    创建地图瓦片。
    
    返回:
    
    一个布尔值，创建瓦片成功返回 true，否则返回 false。
  - buildWithoutConfigFile
```
public boolean buildWithoutConfigFile()
```
    为地图对象创建三维地图瓦片。使用该方法创建瓦片不会生成三维地图瓦片的配置文件。
    
    返回:
    
    一个布尔值，若创建瓦片成功，返回 true，否则返回 false。
  - toConfigFile
```
public boolean toConfigFile(String fileName)
```
    将对象的相关属性信息写到指定的文件中，文件的后缀名为 .sci3d，即瓦片数据的配置文件。
    setMap() 方法的设置值不会写到文件中。
    
    参数:
    
    fileName - 指定文件的路径。
    
    返回:
    
    一个布尔值，若保存瓦片配置文件成功返回 true，否则返回 false。
  - fromConfigFile
```
public boolean fromConfigFile(String fileName)
```
    导入瓦片文件，根据瓦片数据的配置文件中的内容来指定相关设置的值。
    该方法不会对 setMap() 方法的设置值进行修改。
    
    参数:
    
    fileName - 瓦片配置文件的路径。
    
    返回:
    
    一个布尔值，若导入瓦片配置文件成功返回 true，否则返回 false。
  - getProcessThreadsCount
```
public int getProcessThreadsCount()
```
    获取生成瓦片线程数
    
    返回:
  - setProcessThreadsCount
```
public void setProcessThreadsCount(int threadCount)
```
    设置生成瓦片线程数
  - computeImageFileName
```
public String[] computeImageFileName()
```
    返回计算得到的各个层上的瓦片图片名称列表。
    
    返回:
    
    计算得到的各个层上的瓦片图片名称列表。
  - computeImageFileName
```
public String[] computeImageFileName(int specialLevel)
```
    根据参数指定的瓦片层数计算该层下的瓦片图片名称列表。
    
    参数:
    
    specialLevel - 指定的层数。
    
    返回:
    
    计算得到的各个层上的瓦片图片名称列表。
  - removeSteppedListener
```
public void removeSteppedListener(SteppedListener l)
```
    移除一个用于接收进度条事件（SteppedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收进度条事件的监听器。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - getTilingMode
```
public MapTilingMode getTilingMode()
```
    获取地图生成瓦片的剖分方式。
    
    返回:
    
    剖分方式
  - setTilingMode
```
public void setTilingMode(MapTilingMode mode)
```
    设置地图生成瓦片的剖分方式。
    
    参数:
    
    mode - 剖分方式
  - getBuildFromOriginalResolution
```
public boolean getBuildFromOriginalResolution()
```
    获取是否由精细层瓦片往上合并
  - setBuildFromOriginalResolution
```
public void setBuildFromOriginalResolution(boolean buildFromOriginalResolution)
```
    设置是否由精细层瓦片往上合并
  - setIsDisposable
```
public static void setIsDisposable(com.supermap.data.InternalHandleDisposable obj,
                                   boolean disposable)
```

跳过导航链接

所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

类 MapCache3DBuilder

构造器概要

方法概要

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

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

构造器详细资料

MapCache3DBuilder

MapCache3DBuilder

MapCache3DBuilder

方法详细资料

getMap

setMap

getClipRegion

setClipRegion

getBounds

setBounds

getCacheName

setCacheName

getImageSize

setImageSize

getImageCompress

setImageCompress

getOutputFolder

setOutputFolder

isTransparent

setTransparent

getImageType

isFillMargin

setFillMargin

setImageType

getStorageType

setStorageType

getBeginLevel

setBeginLevel

getEndLevel

addSteppedListener

setEndLevel

getPassword

setPassword

computeLevel

build

buildWithoutConfigFile

toConfigFile

fromConfigFile

getProcessThreadsCount

setProcessThreadsCount

computeImageFileName

computeImageFileName

removeSteppedListener

dispose

getTilingMode

setTilingMode

getBuildFromOriginalResolution

setBuildFromOriginalResolution

setIsDisposable