接口变更

产品变更信息

当前版本：11i(2024)
上次版本：11i(2023)SP1_WebGL

1. 接口变更：

类名称	废弃接口	接口说明
PBRMaterialType	NONE	不使用pbr材质，枚举值0
	EMISSION	使用第二重纹理作为自发光纹理，枚举值4
	ROUGHNESS	使用纹理的透明通道作为pbr材质的粗糙度，枚举值8
S3MTilesLayer	clearMemoryImmediately	是否及时释放内存
	PBRMaterialType	获取或设置PBR材质类型
	setPBRMaterial	设置PBR材质
	setTextureEmissive()	设置自发光单元
	getPointCloudClassificationInfos()	获取点云分类信息数组
	setObjsExtendHeight(ids, height)	根据IDS列表，设置对象的拉伸高度
	bReleaseColor	释放顶点颜色内存，还原顶点颜色
	horizontalline	获取或设置水平线高度
	horizontalColor	获取或者设置水平线颜色
	layerBounds	获取或设置图层范围（废弃set方法，保留get方法）

类名称	新增接口	接口说明
SunlightAnalysis	startTime	获取或设置日照分析开始时间
	endTime	获取或设置日照分析结束时间


	visualizationColor	设置或获取阴影区域的显示颜色，Alpha值用于调节颜色混合系数。默认色值(0.0, 0.0, 1.0, 0.7)
	displayMode	设置或获取分析结果的显示模式，日照率或阴影率
	enabled	获取是否已经开启分析
	run	开始分析
	clear	清除分析结果
	setColorTable	设置颜色表，类型：ColorTable
	getDurationAsync	异步获取当前位置处于日照或者阴影的总时长，以秒为单位
TiandituTerrainProvider	url	天地图影像服务地址，类型：String
TiandituTerrainProvider	subdomains	天地图的多子域，类型为Array\|String 当subdomains传入参数为Array时候支持多个子域加载，当传入参数为String时候仅支持单个子域
ImageryLayerCollection	getImageryLayerByName	根据图层名称获取集合中对应的影像图层，类型：String
	removeImageryLayerByName	根据图层名称移除集合中对应的影像图层，类型：String
	removeImageryLayerById	根据图层ID移除集合中对应的影像图层，类型：Number
ImageryLayer	name	获取影像图层中provider的名称，类型：String
LightSource	sunLightCameraTrackingEnabled	获取或设置自动更新当前时区，使模型在同一时区保持相同的明暗效果，类型：Boolean，默认值：true
CloudBox	speed	获取或者设置云层速度，类型：Number，默认值：1.0
SkyBox	horizontalRotationAngle	天空盒支持水平旋转角度（取值为弧度），类型：Number，默认值：0度
SkyBox	imageUrl	使用一张JPG或HDR格式图片实现天空盒的效果，类型：String
Scene	sunlightAnalysis	获取日照分析，类型：SunlightAnalysis
Scene	subdomains	MVT的多子域，类型为Array\|String 当subdomains传入参数为Array时候支持多个子域加载，当传入参数为String时候仅支持单个子域
WebMercatorTilingScheme	origin	设置瓦片的原点位置（WMTS服务），类型 : Cartesian3
GeographicTilingScheme	origin	设置瓦片的原点位置（WMTS服务），类型：Cartographic
SuperMapImageryProvider	prjCoordSys	动态出图时，可使用iServer动态出图服务提供的指定投影坐标系
HypsometricSetting	colorModulation	获取或设置点云数据的颜色值信息，类型：ColorModulationInfo
VectorTilesMap	localIdeographFontFamily	将MVT文字注记的字体设置为浏览器默认字体，类型：Boolean，默认值：false
	subdomains	MVT的多子域，类型为Array\|String 当subdomains传入参数为Array时候支持多个子域加载，当传入参数为String时候仅支持单个子域
	setCRS	对接第三方MVT数据，目前支持加载的坐标系有EPSG:4490，EPSG:3857，默认值EPSG:4490
S3MTilesLayer	setCurrentCategoryField	设置点云数据的特征值字段，类型：String
	getValidCategoryFields	获取点云数据有效特征值字段的数组，类型：Array
	waterParameter	获取水面效果参数，类型：WaterParameter
	coveredMap	获取或者设置（用于贴到倾斜摄影三维模型表面的）覆盖矢量瓦片图层
WaterParameter	color	获取或设置水面颜色，类型：Color
	waveDirection	获取或设置水流方向，以正北方向为正，顺时针转动，取值范围（0-360）度类型：Number，默认值：180度
	waterbodySize	获取或设置水域范围，类型：Number，默认值：WaterbodySize.MEDIUM
	waveStrength	获取或设置水流波纹强度，类型：Number，默认值：WaveStrength.MILD

2. 新增类接口说明：

类名称	类中文说明	接口名称	接口中文说明
SunLightAnalysisMode	日照分析模式类	SunlightDuration	日照时长表达模式，枚举值0
SunLightAnalysisMode	日照分析模式类	ShadowDuration	阴影时长表达模式，枚举值1
WaterbodySize	水域范围类	SMALL	适用于较小水域范围，50*50，单位米，枚举值0
		MEDIUM	适用于中等水域范围，100*100，单位米，枚举值1
		LARGE	适用于较广水域范围，1000*1000，单位米，枚举值2
WaveStrength	水流波纹强度类	CLAM	平静水面，枚举值0
		SLIGHT	轻微波纹，枚举值1
		MILD	中等波纹，枚举值2
		MODERATE	较大波纹，枚举值3
ColorModulationInfo	颜色值调整类	maxValue	使用点云强度特征值设置颜色表时，根据点云强度的最大值设置颜色表中的最大值，最大值默认255
ColorModulationInfo	颜色值调整类	minValue	使用点云强度特征值设置颜色表时，根据点云强度的最小值设置颜色表中的最小值，最小值默认0
CategoryFieldName	特征值字段类	ClassCode	点云数据特征值：点云类别，枚举值ClassCode
		Elevation	点云数据特征值：海拔高度，枚举值VertexWeight
		Intensity	点云数据特征值：强度，枚举值PointCloudlntensity

3. 优化及问题修复：

效果优化：
（1）新增设置云层运动速度。
（2）新增设置水面颜色、水流方向、水域范围、水流强度参数，可调出湖面、河流、海洋等多种水面效果。
（3）简化天空盒使用步骤，通过一张JPG或HDR格式图片实现天空盒效果。
（4）新增设置天空盒水平旋转角度。
（5）新增使用点云强度特征值设置颜色表时，根据点云强度的最大最小值设置颜色表中的最大最小值。最大值默认255，最小值默认0。
（6）新增对包含特征值的点云数据设置颜色表（特征值如类别、强度值、海拔高度）。
（7）优化模型光照效果、PBR效果，使模型更有立体感、更真实。
（8）新增支持水场模型的粒子效果表达，可动态展示水流的流速、流向。
（9）多时序S3M瓦片新增支持多属性切换表达，基于一份S3M数据可切换表达水温、水深等属性随时间动态变化的效果。
浏览器兼容性：
（10）增强WebGPU客户端对Chrome浏览器兼容性，支持113及以后版本。
MVT：
（11）新增设置文字注记字体为浏览器默认字体，解决mapbox无法识别字体导致文字不显示的问题。
（12）新增MVT贴合倾斜摄影三维模型数据时，文字可以依模型、地形高度显示。
在线服务：
（13）新增WMTS服务支持设置瓦片原点位置，兼容iServer新版本影像范围左上角与切片原点不一致的情况。
（14）新增支持在平面场景加载通过ArcGIS动态地图服务和瓦片地图服务发布的，采用地方坐标系的地图数据。

4. 新增范例：

图层_矢量瓦片：
（1）MVT(GeoJson)
场景：
（2）图层目录树
分析_三维空间分析：
（3）日照分析
KML和模型_模型编辑：
（4）实例化图层编辑
在线绘制_几何体对象：
（5）几何对象
（6）点图标
（7）面样式
可视化_MapV:
（8）蜂巢图
（9）迁徙图
（10）方格图
（11）流向图
（12）强边界图
可视化_聚合：
（13）聚合
可视化_特效：
（14）闪电
（15）电子围栏
（16）区域渐变
（17）雷达扫描
（18）广西壮族自治区影像地形图
（19）湖北省PBR材质球面场景
（20）四川省地形渲染图
（21）四川省晕渲图
（22）云南省地形渲染图
（23）重庆市影像地形图
可视化_水流模拟：
（24）多时序多要素水场
（25）水场

本文档完成日期为2024年07月08日，如果此前的任何文档(包括电子文档和印刷文档)中的某些内容与本文档不相符合，请以本文档为准。若本文档更新，则以更新后的文档为准。