npm - @mapgis/webclient-cesium-plugin - Versions diffs - 17.8.1 → 17.10.10 - Mend

@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (227) hide show

package/{documention → documentation}/AngulationTool.html RENAMED Viewed

@@ -88,7 +88,7 @@
         <div class="tag-source">
-            engineExtensions/tools/AngulationTool.js, line 3
+            engineExtensions/tools/AngulationTool.js, line 8
         </div>
     </div>
@@ -99,7 +99,9 @@
     <div class="description">
-        <p>角度测量工具</p>
+        <p>角度测量工具。</p>
+<p>该工具负责在 Cesium 场景中管理方位角或夹角量算流程，并封装连续绘制、
+罗盘显示与结果清理控制。</p>
     </div>
@@ -146,7 +148,7 @@
             <td class="description last">
-                <p>视图</p></td>
+                <p>Cesium 视图对象。</p></td>
         </tr>
@@ -169,7 +171,7 @@
             <td class="description last">
-                <p>包含以下属性的对象</p>
+                <p>角度量算配置项。</p>
 <table class="params">
@@ -223,7 +225,7 @@
-                <p>测量完毕后的回调函数</p></td>
+                <p>量算结束回调。</p></td>
         </tr>
@@ -259,7 +261,7 @@
-                <p>测量完毕后提示框的回调函数，可以覆盖提示内容</p></td>
+                <p>标注内容回调，用于覆盖默认提示文字。</p></td>
         </tr>
@@ -295,7 +297,7 @@
-                <p>只要小于这个距离深度检测就会失效，就会一直显示在最前面 不会被遮挡</p></td>
+                <p>小于该距离时禁用深度检测，使标注保持前置显示。</p></td>
         </tr>
@@ -331,7 +333,7 @@
-                <p>是否点击右键结束</p></td>
+                <p>是否允许右键结束当前量算。</p></td>
         </tr>
@@ -367,7 +369,7 @@
-                <p>labelStyle 提示框样式，参考<code>LabelGraphics</code></p></td>
+                <p>量算标签样式。</p></td>
         </tr>
@@ -403,7 +405,7 @@
-                <p>lineStyle 测量线式，参考<code>PolylineGraphics</code></p></td>
+                <p>量算线样式。</p></td>
         </tr>
@@ -439,7 +441,7 @@
-                <p>lineStyle 测量点样式，参考<code>PointGraphics</code></p></td>
+                <p>节点样式。</p></td>
         </tr>
@@ -475,7 +477,7 @@
-                <p>lineStyle 删除测量结果图标样式，参考<code>PointGraphics</code></p></td>
+                <p>结果删除点样式。</p></td>
         </tr>
@@ -511,7 +513,7 @@
-                <p>compassStyle 罗盘样式，参考<code>EllipseGraphics</code></p></td>
+                <p>罗盘样式。</p></td>
         </tr>
@@ -547,7 +549,7 @@
-                <p>showCompass 是否显示罗盘</p></td>
+                <p>是否显示罗盘。</p></td>
         </tr>
@@ -583,7 +585,7 @@
-                <p>isFixAxis 是指南针模式还是测量夹角模式，true：指南针，false：夹角</p></td>
+                <p>是否按固定方位角模式量算；<code>false</code> 时按夹角模式量算。</p></td>
         </tr>
@@ -619,7 +621,7 @@
-                <p>isSemiCircle 当处于测量夹角模式时，是否支持钝角测量，true：否，false：是</p></td>
+                <p>夹角模式下是否限制为半圆角度范围。</p></td>
         </tr>
@@ -655,7 +657,7 @@
-                <p>是否连续绘制，true：是，false：否</p></td>
+                <p>是否连续绘制。</p></td>
         </tr>
@@ -691,7 +693,43 @@
-                <p>是否显示多个测量结果，true：是，false：否</p></td>
+                <p>是否显示多个量算结果。</p></td>
+        </tr>
+        <tr>
+                <td class="name"><code>enableAvoidance</code></td>
+            <td class="type">
+<span class="param-type">Boolean</span>
+            </td>
+                <td class="default">
+                    false
+                </td>
+            <td class="description last">
+                        <span class="optional"> 可选</span>
+                <p>是否开启量算结果标签避让。</p></td>
         </tr>
@@ -748,35 +786,31 @@
     <pre class="prettyprint"><code>// ES5引入方式
 const { AngulationTool } = zondy.cesium
 // ES6引入方式
 import { AngulationTool } from "@mapgis/webclient-cesium-plugin"
 let options = {
- //是指南针模式还是测量夹角模式，true：指南针，false：夹角
- isFixAxis: true,
- //提示框样式
- labelStyle: {
-   font: 'bolder 12pt 楷体',
-   fillColor: new Cesium.Color(1.0, 1.0, 1.0, 1.0),
-   outlineColor: new Cesium.Color(1.0, 1.0, 0.0, 0.5),
-   outlineWidth: 4.0,
-   verticalOrigin: Cesium.VerticalOrigin.BOTTOM,
-   showBackground: true,
-   backgroundColor: new Cesium.Color(0, 0.6, 0.1, 0.4),
-   pixelOffset: new Cesium.Cartesian2(0, -4)
- },
- //测量线式
- lineStyle: {
-   width: 10
- },
- //删除测量结果图标样式
- closePointStyle: {
-   scale: 1.4
- },
- //测量点样式
- pointStyle: {
-   pixelSize: 10
- },
+  isFixAxis: true,
+  labelStyle: {
+    font: 'bolder 12pt 楷体',
+    fillColor: new Cesium.Color(1.0, 1.0, 1.0, 1.0),
+    outlineColor: new Cesium.Color(1.0, 1.0, 0.0, 0.5),
+    outlineWidth: 4.0,
+    verticalOrigin: Cesium.VerticalOrigin.BOTTOM,
+    showBackground: true,
+    backgroundColor: new Cesium.Color(0, 0.6, 0.1, 0.4),
+    pixelOffset: new Cesium.Cartesian2(0, -4)
+  },
+  lineStyle: {
+    width: 10
+  },
+  closePointStyle: {
+    scale: 1.4
+  },
+  pointStyle: {
+    pixelSize: 10
+  }
 }
 const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre>
@@ -815,7 +849,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
         <div class="tag-source">
-            engineExtensions/tools/AngulationTool.js, line 199
+            engineExtensions/tools/AngulationTool.js, line 203
         </div>
     </div>
@@ -826,7 +860,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
     <div class="description">
-        <p>清除所有测量结果，仍可绘制（绘制事件仍然是激活状态）</p>
+        <p>清除全部角度量算结果，并在允许连续绘制时重新进入激活状态。</p>
     </div>
@@ -886,7 +920,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
         <div class="tag-source">
-            engineExtensions/tools/AngulationTool.js, line 81
+            engineExtensions/tools/AngulationTool.js, line 85
         </div>
     </div>
@@ -897,7 +931,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
     <div class="description">
-        <p>开始测量</p>
+        <p>激活角度量算流程并创建当前绘制工具。</p>
     </div>
@@ -957,7 +991,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
         <div class="tag-source">
-            engineExtensions/tools/AngulationTool.js, line 180
+            engineExtensions/tools/AngulationTool.js, line 184
         </div>
     </div>
@@ -968,7 +1002,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
     <div class="description">
-        <p>结束测量，测量工具处于不能绘制(不激活状态)</p>
+        <p>停止角度量算。</p>
     </div>
@@ -1030,7 +1064,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
-                <p>是否保留测量结果。默认为false不保留测量结果</p></td>
+                <p>是否保留当前量算结果；默认 <code>false</code>，会同时清理结果与交互状态。</p></td>
         </tr>
@@ -1091,7 +1125,7 @@ const measureAngulationToolMul = new AngulationTool(viewer, options)</code></pre
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:54 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Sep 18 2026 14:59:30 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/AnimationTool.html RENAMED Viewed

@@ -94,20 +94,14 @@
     </div>
-    <p class="summary"><p>请参考以下示例:<br>
-<a href='#example1'>1、路径漫游</a><br>
-<a href='#example2'>2、绕点旋转</a><br>
-<a href='#example3'>3、飞行漫游</a><br>
-<a href='#example4'>4、实时漫游</a><br>
-<a href='#example5'>5、室内漫游</a><br>
-<a href='#example6'>6、模型沿地形漫游</a><br></p></p>
 </dt>
 <dd>
     <div class="description">
-        <p>场景漫游工具</p>
+        <p>场景漫游工具。</p>
+<p>该工具封装了路径漫游、绕点旋转、飞行漫游、室内漫游与实时漫游等场景动画能力，
+并统一管理路径、相机、模型和回调状态。</p>
     </div>
@@ -169,7 +163,7 @@
-                <p>场景视图，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html' target='_blank'>详见Cesium.Viewer</a></p></td>
+                <p>场景视图对象。</p></td>
         </tr>
@@ -205,7 +199,7 @@
-                <p>额外初始化参数</p>
+                <p>额外初始化参数。</p>
 <table class="params">
@@ -1550,7 +1544,7 @@
-                <p>实时位置，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Cartesian3' target='_blank'>详见Cesium.Cartesian3</a></p></td>
+                <p>实时位置。</p></td>
         </tr>
@@ -1580,7 +1574,7 @@
-                <p>运动开始时间，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=JulianDate' target='_blank'>详见Cesium.JulianDate</a></p></td>
+                <p>运动开始时间。</p></td>
         </tr>
@@ -1610,7 +1604,7 @@
-                <p>当前时间，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=JulianDate' target='_blank'>详见Cesium.JulianDate</a></p></td>
+                <p>当前时间。</p></td>
         </tr>
@@ -1640,7 +1634,7 @@
-                <p>运动结束时间，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=JulianDate' target='_blank'>详见Cesium.JulianDate</a></p></td>
+                <p>运动结束时间。</p></td>
         </tr>
@@ -2126,6 +2120,7 @@ http://10.10.130.72:8086/#/modules/cesium/analyse/commonAnalyse/path-roaming
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
@@ -2133,7 +2128,7 @@ import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 const pathPositions = [...]
 // 2 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为routes
   toolType: 'routes',
   // 漫游路径(笛卡尔3数组)
@@ -2145,7 +2140,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 4 暂停漫游
-animationTool.pause
+animationTool.pause()
 // 5 结束漫游
 animationTool.stop()</code></pre>
@@ -2160,11 +2155,12 @@ http://10.10.130.72:8086/#/modules/cesium/sceneControl/camera/point-rotate
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 // 1 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为point
   toolType: 'point',
   //旋转中心点
@@ -2176,7 +2172,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 3 暂停旋转
-animationTool.pause
+animationTool.pause()
 // 4 结束旋转
 animationTool.stop()</code></pre>
@@ -2191,6 +2187,7 @@ http://10.10.130.72:8086/#/modules/cesium/analyse/commonAnalyse/fly-roaming
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
@@ -2198,7 +2195,7 @@ import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 const pathPositions = [...]
 // 2 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为routes
   toolType: 'routes',
   // 漫游路径(笛卡尔3数组)
@@ -2221,7 +2218,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 4 暂停漫游
-animationTool.pause
+animationTool.pause()
 // 5 结束漫游
 animationTool.stop()</code></pre>
@@ -2236,6 +2233,7 @@ http://10.10.130.72:8086/#/modules/cesium/analyse/commonAnalyse/real-time-roamin
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
@@ -2243,7 +2241,7 @@ import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 const pathPositions = [...]
 // 2 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为routes
   toolType: 'routes',
   // 漫游路径(笛卡尔3数组)
@@ -2257,7 +2255,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 4 暂停漫游
-animationTool.pause
+animationTool.pause()
 // 5 结束漫游
 animationTool.stop()</code></pre>
@@ -2272,6 +2270,7 @@ http://10.10.130.72:8086/#/modules/cesium/analyse/commonAnalyse/indoor-roaming
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
@@ -2279,7 +2278,7 @@ import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 const pathPositions = [...]
 // 2 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为routes
   toolType: 'routes',
   // 漫游路径(笛卡尔3数组)
@@ -2293,7 +2292,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 4 暂停漫游
-animationTool.pause
+animationTool.pause()
 // 5 结束漫游
 animationTool.stop()</code></pre>
@@ -2308,6 +2307,7 @@ http://10.10.130.72:8086/#/modules/cesium/analyse/commonAnalyse/model-terrain-ro
 // ES5引入方式
 const { AnimationTool } = zondy.cesium
 // ES6引入方式
 import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
@@ -2315,7 +2315,7 @@ import { AnimationTool } from "@mapgis/webclient-cesium-plugin"
 const pathPositions = [...]
 // 2 定义漫游工具对象
-animationTool = new AnimationTool(viewer, {
+const animationTool = new AnimationTool(viewer, {
   //类型指定为routes
   toolType: 'routes',
   // 漫游路径(笛卡尔3数组)
@@ -2342,7 +2342,7 @@ animationTool = new AnimationTool(viewer, {
 animationTool.start()
 // 4 暂停漫游
-animationTool.pause
+animationTool.pause()
 // 5 结束漫游
 animationTool.stop()</code></pre>
@@ -4123,7 +4123,7 @@ animationTool.stop()</code></pre>
         <div class="tag-source">
-            engineExtensions/tools/AnimationTool.js, line 1824
+            engineExtensions/tools/AnimationTool.js, line 1714
         </div>
     </div>
@@ -4194,7 +4194,7 @@ animationTool.stop()</code></pre>
         <div class="tag-source">
-            engineExtensions/tools/AnimationTool.js, line 2428
+            engineExtensions/tools/AnimationTool.js, line 2236
         </div>
     </div>
@@ -4268,7 +4268,7 @@ animationTool.stop()</code></pre>
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:54 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Sep 18 2026 14:59:30 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/ArcGISMapServerImageryProvider.html RENAMED Viewed

@@ -88,28 +88,21 @@
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISMapServerImageryProvider.js, line 12
+            engineExtensions/scene/imageryProvider/ArcGISMapServerImageryProvider.js, line 6
         </div>
     </div>
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、添加一个ArcGIS地图图片图层：原生接口开发</a><br>
-<a href='#example2'>2、添加一个ArcGIS地图图片图层：混合接口开发</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/layerControl/image-layer-elevation-mode-setting' target='_blank'>3、影像图层高程模式设置</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>4、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/sceneControl/scene/globe-independent-translucency' target='_blank'>5、地表透明度独立控制</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#mapPictureLayer' target='_blank'>6、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过ArcGIS地图服务的url获取ArcGISMapServerImageryProvider对象]</a><br/></p>
 </dt>
 <dd>
     <div class="description">
         <p>ArcGIS地图服务接入类</p>
+<p>该类用于将 ArcGIS MapServer 服务封装为 Cesium 可加载的影像图层提供器。
+支持 IGS 发布的 ArcGIS 服务与标准 ArcGIS 服务两类地址格式，并提供请求参数扩展与动态投影控制能力。
+建议优先通过 <code>fromUrl</code> 根据服务元信息自动组装初始化参数。</p>
     </div>
@@ -778,6 +771,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISMapServerImageryProvider } = zondy.cesium
 // ES6引入方式
 import { ArcGISMapServerImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -800,6 +794,7 @@ addArcGISMapImageLayer(url)</code></pre>
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISMapImageLayer } = zondy.layer
 const { initializeOptions } = zondy.cesium.util
 // ES6引入方式
 import { ArcGISMapImageLayer } from "@mapgis/webclient-common"
 import { initializeOptions } from "@mapgis/webclient-cesium-plugin"
@@ -858,7 +853,7 @@ arcgisMapImageLayer.load().then((layer) => {
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISMapServerImageryProvider.js, line 172
+            engineExtensions/scene/imageryProvider/ArcGISMapServerImageryProvider.js, line 157
         </div>
     </div>
@@ -1020,6 +1015,7 @@ arcgisMapImageLayer.load().then((layer) => {
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISMapServerImageryProvider } = zondy.cesium
 // ES6引入方式
 import { ArcGISMapServerImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -1048,7 +1044,7 @@ addImageryProvider(url)</code></pre>
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:54 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Sep 18 2026 14:59:30 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>