com.supermap.data.processing

类 MapCache3DBuilder

  • java.lang.Object
    • com.supermap.data.InternalHandle
      • com.supermap.data.InternalHandleDisposable
        • com.supermap.data.processing.MapCache3DBuilder
  • 所有已实现的接口:
    IDisposable

    已过时。 
    该类已经过时,使用 MapCacheBuilder 替代。三维地图缓存生成类,该类主要用于为地图生成供三维场景发布使用的三维地图缓存,其配置文件为 *.sci3d 格式。三维地图缓存的金字塔文件目录结构与影像缓存一致。

    三维缓存是一种用于改善三维场景浏览用户体验的优化策略。服务器端创建了三维缓存之后,客户端用户的每一次地图浏览,比如平移、放大、缩小地图,都会向服务器端发送一个 URL 请求,此时,服务器端按照匹配的条件,将已缓存的数据返回到客户端。

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

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


    public class MapCache3DBuilder
    extends com.supermap.data.InternalHandleDisposable
    • 构造器详细资料

      • 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 - 生成缓存的配置文件的名称。
      • 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 - 缓存图片是否背景透明。
      • 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)

Copyright © 2021–2024 SuperMap. All rights reserved.