接口变更列表

 

为了更好地方便用户从 SuperMap iClient3D 8C SP1 for Plugin升级到 SuperMap iClient3D 8C SP2 for Plugin ，本文档对两个版本之间一些接口变更情况进行了说明。接口变更的原则是为了用户开发出更高效，功能更强大的客户端。

SuperMap iClient3D 8C SP2 for Plugin升级到 SuperMap iClient3D 8C(2017) for Plugin 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

8C(2017)

 说明
新增 Model 类 新增三维几何模型对象集类
新增 GeoModel3D 类 新增三维模型几何对象类
Layer3D新增 isVisible 属性 新增设置地球可见性
SteroMode新增HTCVIVE_VR枚举项 新增支持HTC Vive虚拟现实头盔
FlyManager新增事件回调函数 新增停止飞行、继续飞行、暂停飞行事件
新增Layer3DOSGB类 新增OSGB缓存图层类
新增Layer3DVolumeFile类 新增三维栅格文件缓存数据图层类
新增HypsometricSetting类 新增分层设色类
新增HypsometricSettingDisplayMode枚举 新增分层设色的显示模式类型
Layer3DType新增VolumeFile、BingMaps、GoogleMaps、OpenStreetMaps枚举项 新增支持三维栅格体缓存、在线BingMap、谷歌地图及OpenStreetMaps图层
Layer3Ds新增addOnlineMap 方法 新增添加SuperMap Online图层

TerrainLayers新增addSTKTerrain方法

新增地形图层集合添加STK World Terrain图层
Scene新增cameraNearClipDistance、cameraFarClipDistance属性 新增设置相机到远/近裁剪面的距离
Scene新增computeSphericalDistance方法 新增计算两点间的球面距离
Scene废弃type属性

已被废弃，不推荐使用

SceneControl新增snapMode属性、新增SnapMode 枚举类

 量算时支持顶点捕捉模式
Scene新增cameraNearClipDistance、cameraFarClipDistance属性 新增设置相机到远/近裁剪面的距离

SuperMap iClient3D 8C SP1 for Plugin升级到 SuperMap iClient3D 8C SP2 for Plugin 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

SP2

 说明
Layer3Ds新增addLayerService方法 新增添加图层服务方法，可加载带有风格的三维图层
Layer3D新增swipeEnabled 属性 新增是否开启卷帘功能
Layer3D新增swipeRegion 属性 新增设置卷帘区域
GlobalImage新增swipeEnabled 属性 新增是否开启卷帘功能
GlobalImage新增swipeRegion 属性 新增设置卷帘区域
新增Splitter类 新增分隔条对象类

SuperMap iClient3D 8C for Plugin升级到 SuperMap iClient3D 8C SP1 for Plugin 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

SP1

 说明
新增MultiViewportMode 枚举 新增多视口模式枚举类
新增BoxClipPart 枚举 新增裁剪盒枚举类
Layer3D新增SelectionFiltrateByTransparency属性 新增透过半透明物体选中对象
Layer3D新增opaqueRate属性 新增WMTS图层透明度
Layer3D新增isExcavation属性 新增OSGB图层是否参与开挖
Layer3D新增getObjectsColor方法 新增获取对象颜色表
Layer3D新增setObjectsColor方法 新增设置对象颜色表
Layer3D新增getObjectsColorIDs方法 新增获取颜色表对应的ID值
Layer3D新增removeObjectsColor方法 新增移除指定IDs的颜色表
Layer3D新增ClearObjectsColor方法 新增清除对象颜色表
Layer3D新增setViewportVisible方法 新增设置图层在某视口的可见性
Layer3D新增getViewportVisible方法 新增获取图层在某视口的可见性
Layer3D新增clipByBox方法 新增剖切查看功能
TrackingLayer3D新增isEditable属性 新增跟踪图层是否可编辑
TrackingLayer3D新增isSeletable属性 新增跟踪图层是否可选择
Scene新增outputSceneToImg 方法 新增不需要完成数据下载输出场景为图片

SuperMap.Web.UI.Controls 名称空间

SP1 说明
SceneControl类新增 isDynamicSelection  属性 新增OSGB缓存是否动态高亮。

SuperMap iClient 7C (2015) SP2 for 3D 升级到 SuperMap iClient3D 8C for Plugin 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

8C

 说明
新增Layer3DCustom 类 新增自定义扩展服务类接口
新增CacheConfigue 类 自定义服务下载图片设置配置文件参数类
新增DownloadRequest 类 新增服务下载请求类
scene新增collisionDetection属性 新增碰撞检测功能
scene新增walkingMode属性 新增行走模式
scene新增collisionDistanceThreshold属性 新增碰撞检测距离设置

SuperMap.Web.UI.Controls 名称空间

8C 说明
SceneControl类新增 isAlwaysActive 属性 新增场景是否始终处于激活状态

SuperMap iClient 7C (2015) SP1 for 3D 升级到 SuperMap iClient 7C (2015) SP2 for 3D 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

SP2 说明
新增Layer3DTianditu 类 新增添加天地图图层到三维场景接口
新增Layer3DDynamicRESTMap 类 新增添加二维临时图层到三维场景接口
新增nodeAnimationState 类 新增节点动画接口
FlyingOperator新增flyCircle 方法 新增绕点旋转
FlyingOperator废弃play 方法 废弃

SuperMap.Web.Core 名称空间

SP2 说明
Geometry3D类新增volume属性 获取三维地物的体积，只对于GeoModel有效。
GeoModel 类新增nodeAnimationState 属性 获取节点动画

SuperMap iClient 7C (2015) for 3D 升级到 SuperMap iClient 7C (2015) for 3D SP1主要变更情况如下：

SuperMap.Web.Realspace 名称空间

7.1 说明
新增LookAt类 相机lookat接口

SuperMap.Web.Realspace 名称空间

7.1 说明
Scene 类新增get_looat方法 获取场景的相机lookat参数
Layer3D 类新增set_looat方法 设置场景的相机lookat参数

SuperMap iClient 7C SP1 for 3D 升级到 SuperMap iClient 7C(2015) for 3D 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

7C(2015) 说明
新增Profile类 剖面线分析
新增Sightline类 视线分析
新增Skyline类 天际线分析
新增SlopeMap类 坡度坡向分析
新增ViewShed3D类 可视域分析
新增ContourMap类 等高线分析
新增Theme3D类 三维专题图
新增Theme3DGraph类 三维统计专题图
新增Theme3DGraphItem类 三维统计专题图子项
新增Theme3DLabel类 三维标签专题图
新增Theme3DRange类 三维分段专题图
新增Theme3DRaneItem类 三维分段专题图子项
新增Theme3DUnique类 三维单值专题图
新增Theme3DUniqueItem类 三维单值专题图子项
新增ShadowQuery类 阴影查询

SuperMap.Web.Core名称空间接口变更

7C SP1 7C(2015) 说明
Feature3D   接口变更
visibleDistance 属性   删除

SuperMap.Web.Realspace 名称空间

7C(2015) 说明
Layer3D 类新增get_isShadowEnable方法 获取三维图层的阴影是否可见
Layer3D 类新增set_isShadowEnable方法 设置三维图层的阴影是否可见

从SuperMap iClient 6R(2012) for Realspace SP3 升级到 SuperMap iClient 7C for 3D 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

7C 说明
Layer3D 类新增 fromXML方法 通过XML数据创建三维图层对象。
Layer3D 类新增 toXML方法 返回三维图层的XML形式的描述
Layer3D 类新增updateAttributeCacheFile 方法 更新本地数据属性缓存
Scene 类新增outputSceneToFile 方法 场景输出为图片

从SuperMap iClient 6R(2012) for Realspace SP2 升级到 SuperMap iClient 6R(2012) for Realspace SP3 主要变更情况如下：

SuperMap.Web.Realspace 名称空间

6R SP3 说明
新增 Layer3DWMTS 类 网络地图瓦片服务 WMTS 图层类
新增 Layer3DWMTSServiceInfo 类 三维 WMTS 图层服务信息类
新增 Layer3DWMTSServicesList 类 三维WMTS图层服务信息集合类
新增 Layer3DType 类新增 WMTS 枚举 WMTS 图层，对应值为12
新增 Bubble 类新增 frameWidth 属性 获取或设置气泡边框的宽度，默认值为15
新增 Bubble 类新增 isAutoHide 属性 获取或设置当气泡指向点从场景窗口移除时气泡是否自动隐蔽
新增 Bubble 类新增 roundQuality 属性 获取或设置气泡四个圆角的精细程度，默认值为10
新增 Bubble 类新增 title 属性 获取或设置气泡的标题
新增 Bubble 类新增 titleTextStyle3D 属性 获取或设置气泡标题的文本风格。可设置的文本风格包括标题的字体、字体的前景色和标题的对齐方式（居左、居中和居右）

SuperMap.Web.UI.Controls 名称空间

6R SP3 说明
SceneControl类新增 isFPSVisible 属性 获取或设置场景控件的帧率信息是否可见。

从SuperMap iClient 6R(2012) for Realspace SP1 升级到 SuperMap iClient 6R(2012) for Realspace SP2主要变更情况如下：

SuperMap.Web.Realspace 名称空间

6R SP2 说明
新增 Environment 类 系统环境设置类
新增 Layer3DWMS 类 WMS（网络地图服务）图层类

  SuperMap.Web.Core 名称空间

6R SP2 说明
GeoModel类新增 id 属性 获取或设置模型几何对象的ID

SuperMap.Web.UI.Controls 名称空间

6R SP2 说明
SceneControl类新增 isAlwaysUpdate 属性 获取或设置场景窗口在失去焦点时，是否更新数据。

从SuperMap iClient 6R(2012) for Realspace升级到 SuperMap iClient 6R(2012) for Realspace SP1 主要变更情况如下：

  新增 SuperMap.Web.iServerJava6R.Data3D 名称空间

2012 6.1 SP1 说明
  新增 Data3D.GetFeature3DsByBoundsParameters 类 要素查询参数对象类
  新增 Data3D.GetFeature3DsByBoundsService 类 要素查询服务类
  新增 Data3D.GetFeature3DsBySQLParameters 类 SQL查询参数对象类
  新增 Data3D.GetFeature3DsBySQLService 类 SQL 查询服务类
  新增 Data3D.GetFeature3DsEventArgs 类 查询事件参数
  新增 Data3D.GetFeature3DsParametersBase 类 要素查询参数基类
  新增 Data3D.GetFeature3DsResult 类 要素查询参数基类

  SuperMap.Web.Realspace 名称空间

2012 6.1 SP1 说明
  新增 Bubble 类 查询气泡信息框对象
  新增 Bubbles 类 气泡框集合对象

  SuperMap.Web.UI.Controls 名称空间

2012 6.1 SP1 说明
SceneControl 类    
  新增 bubbles 属性 获取当前场景中的气泡对象集合

从SuperMap iClient 6R for Realspace SP1 升级到 SuperMap iClient 6R(2012) for Realspace 主要变更情况如下：

  SuperMap.Web.Core 命名空间接口变更

SP1 2012 说明
  新增 GeoBox 类 用于在三维图层上绘制长方体几何对象。
  新增 GeoCone 类 用于在三维图层上绘制圆锥体几何对象。
  新增 GeoCircle3D 类 用于在三维图层上绘制三维圆面几何对象。
  新增 GeoCylinder 类 用于在三维图层上绘制圆台几何对象。如果设置底面圆的半径和顶面圆的半径相等，就是圆柱几何对象。
  新增 GeoEllipsoid 类 用于在三维图层上绘制椭球体几何对象。
  新增 GeoHemiSphere 类 用于在三维图层上绘制半球体几何对象。半球体能够旋转，旋转0度时对应球体的上半球。
  新增 GeoPie3D 类 用于在三维图层上绘制三维扇面几何对象。
  新增 GeoPyramid 类 用于在三维图层上绘制四棱锥几何对象。
  新增 GeoSphere 类 用于在三维图层上绘制球体几何对象。
  新增 GeoPieCylinder 类 用于在三维图层上绘制饼台几何对象。
GeoModel 类   接口变更
  新增 meshes 属性 获取网格面对象
Style3D 类   接口变更
  新增 isMarkerSizeFixed 属性 三维模型对象是否固定大小

  SuperMap.Web.Realspace 命名空间接口变更

SP1 2012 说明
  新增 Sun 类 太阳对象类。
  新增 Mesh 类 新增网格面类
  新增 Meshes 类 新增网格面集合类
  新增 Material 类 新增材质类
  新增 Stereo 类 新增立体显示模式类
  ParallaxMode 枚举 立体显示视差模式类型枚举
  新增 StereoMode 枚举 立体显示模式枚举
  新增 SceneType 枚举 场景类型枚举。
  新增 RouteStop 类 路线站点对象。
  新增 RouteStops 枚举 站点集合类。该类提供了对站点对象的添加、移除、导入、导出等管理功能。
Scene 类   接口变更
  新增 get_stereo 属性 获取当前场景立体显示类对象
  新增 autoLockTarget 属性 设置被锁定对象。
  新增 autoLockOffset 属性 获取或设置相机相对于锁定对象的偏移量。
  新增 sun 属性 获取太阳对象。通过设置场景中的 Sun 对象来实现对三维地图效果的渲染。
  新增 bounds 属性 获取或设置平面模式下场景的操作浏览范围。单位为经纬度。
  新增 type 属性 获取或设置三维场景的类型。可以选择球体模式（Globe）和平面模式（Flat）两种。
Layer3D   接口变更
visibleDistance 属性   删除
  新增 maxObjectVisibleDistance 属性 获取或设置当前图层对象的最大可见距离
  新增 minObjectVisibleDistance 属性 获取或设置当前图层对象的最小可见距离

  SuperMap.Web.Action3Ds 命名空间接口变更

SP1 2012 说明
  MeasureTerrainDistance 类 新增依地形量算类

从SuperMap iClient 6R for Realspace 升级到 SuperMap iClient 6R for Realspace SP1 版本主要变更情况如下：

  SuperMap.Web.Core 命名空间接口变更


正式版 SP1 说明
  新增 GeoParticle 类 新增三维粒子几何对象类
  ParticleType 枚举类型 新增粒子类型枚举
GeoModel 类 接口变更  
  新增 animationState 属性 获取或设置模型的动画

  SuperMap.Web.Realspace 命名空间接口变更


新增 iconAnchorPoint 属性 获取地标图片的锚点位置

正式版 SP1 说明
  FlyManager 类 新增飞行管理类
  Animation 类 新增模型动画类
  FlyRoutes 类 新增路线集合类
  FlyRoute 类 新增路线对象类
  GlobalImage 类 新增全球底图类
  ParticleSystem 类 新增粒子系统对象类
  Underground 类 新增地下类
Scene 类   接口变更
  新增 flyManager 属性 获取当前场景飞行管理对象
  新增 globalImage 属性 获取当前场景的全球底图类对象
  新增 underground 属性 获取当前场景的地下类对象
Style3D 类   接口变更
ScreenLayer3D 类   接口变更
  新增 createBubble 方法 创建气泡
  新增 deleteBubble 方法 删除气泡
  新增 refreshBubble 方法 刷新气泡

  SuperMap.Web.Action3Ds 命名空间接口变更


正式版 SP1 说明
  ExcavationRegion 类 新增获取绘制区域事件
  SelectEx 类 新增鼠标漫游选择操作类，支持栅格地图的高亮选择

  SuperMap.Web.Controls 命名空间接口变更


正式版 SP1 说明
SceneControl 类   接口变更
  新增 globeToPixe 方法 将地理坐标下的三维点 Point3D 转换成屏幕二维点 Point

从SuperMap iClient 6R for Realspace RC 升级到正式版本 SuperMap iClient 6R for Realspace主要变更情况如下：


  SuperMap.Web.Core 命名空间接口变更


RC 正式版 说明
GeoPoint3D 类   接口变更
  新增 convertToGeoPoint 方法 将三维点对象转换为二维点对象
GeoLine3D 类   接口变更
  新增 convertToGeoLine 方法 将三维线对象转换为二维几何线对象
GeoRegion3D 类   接口变更
  新增 convertToGeoRegion 方法 将三维面对象转换为二维面对象

  SuperMap.Web.Realspace 命名空间接口变更


RC 正式版 说明
ObjectFactory 类 AsyncHelper 类 类名称变更
Scene 类   接口变更
  新增 getDataStreamingProgress 方法 获取场景数据下载进度值
Layer3D 类   接口变更
  新增 getDataStreamingProgress 方法 获取三维图层数据下载进度值
  新增 refresh 方法 刷新当前三维图层
TerrainLayer 类   接口变更
  新增 getDataStreamingProgress 方法 获取地形图层数据下载进度值
TrackingLayer3D 类   接口变更
  新增 refresh 方法 刷新跟踪图层
ScreenLayer3D 类   接口变更
  新增 refresh 方法 刷新屏幕图层

  SuperMap.Web.UI.Controls 命名空间接口变更


RC 正式版 说明
SceneControl 类   接口变更
  新增 asyncHelper 属性 获取异步助手
objectFactory 属性   删除

SuperMap iClient 6R for Realspace 从 Beta1 升级到 RC 版本主要变更情况如下：


  SuperMap.Web.Realspace 命名空间接口变更

Beta1 RC 说明
Layer3DServiceInfo 类   接口变更
  新增 dataName 属性 获取或设置图层对应的数据名称
Scene 类   接口变更
  新增 updateCacheFile 方法 更新场景的缓存
Layer3D 类   接口变更
layer3D 构造函数   接口变更，新增strDataName参数
  新增 releaseSelection 方法 清除三维图层选择集中的内容，并且同时清除被选中元素的高亮效果
  新增 updateSelection 方法 更新三维图层选择集中的内容
  新增 getFieldValue 方法 根据属性字段的id或者名称得到属性字段的值
  新增 updateCacheFile 属性 更新图层缓存数据
  新增 fieldInfos 属性 获取矢量图层选择集中最后一个元素的属性字段信息集合
  新增 dataType 属性 获取图层的数据类型
  新增 dataName 属性 获取图层对应的数据名称
Layer3Ds 类   接口变更
add 方法   接口变更，新增strDataName参数
TerrainLayers 类   接口变更
add 方法   接口变更，新增strDataName参数
  新增 moveTo 属性 将地形图层集合中指定索引号的图层移动到指定索引位置
  新增 moveUp 属性 将地形图层集合中指定索引号的图层向上移动一层
  新增 moveDown 属性 将地形图层集合中指定索引号的图层向下移动一层
  新增 moveToTop 属性 将地形图层集合中指定索引号的图层移动到顶层
  新增 moveToButtom 属性 将地形图层集合中指定索引号的图层移动到底层
TerrainLayer 类   接口变更
TerrainLayer 构造函数   接口变更，新增strDataName参数
FieldInfos 类   新增类
  新增 count 属性 获取矢量图层属性字段的个数
  新增 item 属性 获取属性字段信息集合中指定序号或者指定字段名称的属性字段对象
FieldInfo 类   新增类
  新增 name 属性 获取属性字段的名称
Layer3DType 枚举类型    
GEImage 枚举   删除

SuperMap iClient 6R for Realspace 从 Alpha4 升级到本 Beta1 版本主要变更情况如下：

  SuperMap.Web.Realspace 命名空间接口变更

Alpha4 Beta1 说明
Layer3D 类   接口变更
  新增 findFeature3DByID 方法 获取图层中指定ID的Feature3D对象
  新增 selectStyle 属性 获取或设置图层的选中状态时的风格
  新增 style3D 属性 获取或设置矢量类型图层内数据的显示风格
dataName 属性   删除
Layer3DServiceInfo类   接口变更
  新增 style3D 属性 获取或设置矢量类型图层内数据的显示风格
  新增 caption 属性 获取或设置图层服务的标题
  新增 description 属性 获取或设置图层服务的描述信息
  新增 isAlwaysRender 属性 获取或设置图层服务是否始终进行渲染
  新增 isEditable 属性 获取或设置图层服务是否可编辑
  新增 isSelectable 属性 获取或设置图层对象的可选状态
  新增 isVisible 属性 获取或设置图层服务的可见状态
  新增 maxVisibleAltitude 属性 获取或设置图层中的最大可见高程值
  新增 minVisibleAltitude 属性 获取或设置图层中的最小可见高程值
  新增 visibleDistance 属性 获取或设置图层服务中对象的可见距离
dataName 属性   删除
Layer3DServicesList 类   接口变更
serverAddress serverRootAddress 接口变更
SceneServiceInfo 类   接口变更
serverAddress serverRootAddress 接口变更
SceneServicesList 类   接口变更
serverAddress serverRootAddress 接口变更
Layer3D 枚举类型    
  新增 VECTOR 枚举类型 新增对矢量图层的支持
TerrainLayers类    
moveUp方法   删除
moveDown方法   删除
moveToButtom方法   删除
moveToTop方法   删除
moveTo方法   删除

SuperMap iClient 6R for Realspace 从 Alpha3 升级到本 Alpha4 版本主要变更情况如下：

  SuperMap.Web.Realspace 命名空间接口变更

Alpha3 Alpha4 说明
FlyingOperator 类   接口变更
wait 方法   删除
  新增 flyToGeometry 方法 在指定的时间内，以指定的方式从当前场景飞行至指定的几何对象
  新增 play 方法 按照指定路线飞行
Scene 类   接口变更
  新增 CurrentScale 属性 获取当前场景的比例尺
TerrainLayer 类   接口变更
  新增 bounds 属性 获取地形图层的地理范围
EventObject 类   接口变更
cameraAltitude 属性 Camera 属性 改变接口名称

  SuperMap.Web.Core 命名空间接口变更

Alpha3 Alpha4 说明
Vector3D 类   接口变更
  新增 equals 方法 判断当前向量对象与指定的向量对象是否相等
Feature3Ds 类   接口变更
indexOf 方法   删除
  新增 findFeature3D 方法 根据指定查找方式查找指定要素的要素对象
isEmpty 属性 isEmpty 方法 接口变更
Geometry3D 类   接口变更
  新增 setEmpty 方法 清空三维几何对象中的空间数据
isEmpty 属性 isEmpty 方法 接口变更
isValid 属性 isValid 方法 接口变更
Feature3DSearchOption 枚举类型    
  新增 Feature3DSearchOption 枚举 查询要素方式枚举常量

SuperMap iClient 6R for Realspace 从 Alpha2 升级到 Alpha3 版本主要变更情况如下：

  SuperMap.Web.Core 命名空间接口变更

Alpha2 Alpha3 说明
  Feature3DSearchOption 新增类
  GeometryType 新增类
  TextAlignment 新增类
  BoundingBox 新增类
Geometry   接口变更
type 属性   删除
  Feature3D 新增类
  Feature3Ds 新增类
  GeoPlacemarker 新增类
  GeoPicture3D 新增类
  Vector3D 新增类

  SuperMap.Web.Realspace 命名空间接口变更

Alpha2 Alpha3 说明
  新增 ScreenLayer3D 类 屏幕图层
  新增 TrackingLayer3D 类 跟踪图层

  更名 SuperMap.Web.UI.Actions 为 SuperMap.Web.Action3Ds 命名空间：

Alpha2 Alpha3 说明
PanAction Pan 接口变更
SelectAction Select 接口变更