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}/RouteAnimationControl.html RENAMED Viewed

@@ -99,7 +99,7 @@
     <div class="description">
-        <p>路径漫游控制对象</p>
+        <p>路径漫游控制参数对象，用于约束漫游循环方式、速度倍率和姿态跟随策略。</p>
     </div>
@@ -153,7 +153,7 @@
-                <p>可选参数</p>
+                <p>初始化参数。</p>
 <table class="params">
@@ -207,7 +207,7 @@
-                <p>是否循环播放</p></td>
+                <p>是否在到达终点后重新从起点循环播放。</p></td>
         </tr>
@@ -243,7 +243,7 @@
-                <p>加速因子(速度倍数) 默认为1</p></td>
+                <p>漫游速度倍数，值越大播放越快。</p></td>
         </tr>
@@ -279,7 +279,7 @@
-                <p>高程模式</p></td>
+                <p>路径点高程参考模式，通常使用 <code>Cesium.HeightReference</code> 常量值。</p></td>
         </tr>
@@ -315,7 +315,7 @@
-                <p>附加高度</p></td>
+                <p>在相对地形模式下附加到采样高程上的抬升值。</p></td>
         </tr>
@@ -351,7 +351,7 @@
-                <p>是否朝向运动方向</p></td>
+                <p>是否让模型或视角自动朝向运动方向。</p></td>
         </tr>
@@ -402,6 +402,28 @@
+        <h5>Example</h5>
+        <p class="code-caption"><h7>配置路径漫游控制参数</h7></p>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { RouteAnimationControl } = zondy.cesium
+// ES6引入方式
+import { RouteAnimationControl } from '@mapgis/webclient-cesium-plugin'
+const control = new RouteAnimationControl({
+  loop: false,
+  speedupFactor: 2,
+  heightReference: Cesium.HeightReference.RELATIVE_TO_GROUND,
+  exHeight: 10,
+  orientToMovement: true
+})</code></pre>
 </dd>
@@ -424,7 +446,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="animationStatus">animationStatus<span class="type-signature type boolean">Boolean</span> </h4>
+        <h4 class="name" id="animationStatus">animationStatus<span class="type-signature type string">String</span> </h4>
     </div>
@@ -432,7 +454,7 @@
 <dd>
     <div class="description">
-        <p>漫游状态，开始，暂停，停止</p>
+        <p>当前漫游状态，例如 <code>start</code>、<code>pause</code> 或 <code>stop</code>。</p>
     </div>
@@ -477,7 +499,7 @@
 <dd>
     <div class="description">
-        <p>附加高度</p>
+        <p>相对地形模式下的附加高度。</p>
     </div>
@@ -522,7 +544,7 @@
 <dd>
     <div class="description">
-        <p>高程模式</p>
+        <p>路径点高程参考模式。</p>
     </div>
@@ -567,7 +589,7 @@
 <dd>
     <div class="description">
-        <p>是否显示标牌信息</p>
+        <p>是否在漫游结束后重新开始播放。</p>
     </div>
@@ -612,7 +634,7 @@
 <dd>
     <div class="description">
-        <p>是否朝向运动方向</p>
+        <p>是否自动朝向当前运动方向。</p>
     </div>
@@ -657,7 +679,7 @@
 <dd>
     <div class="description">
-        <p>加速因子(速度倍数) 默认为1</p>
+        <p>漫游速度倍数。</p>
     </div>
@@ -708,7 +730,7 @@
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:55 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}/RouteAnimationLabel.html RENAMED Viewed

@@ -99,7 +99,9 @@
     <div class="description">
-        <p>路径漫游标牌对象。LabelGraphics</p>
+        <p>路径漫游标牌配置对象。</p>
+<p>该对象用于补充路径漫游过程中标牌的显示样式，兼容 <code>Cesium.LabelGraphics</code>
+的常用配置项。</p>
     </div>
@@ -120,6 +122,8 @@
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -143,6 +147,12 @@
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
@@ -153,7 +163,7 @@
-                <p>可选参数。支持 Cesium.LabelGraphics 所有构造参数和属性，在此省略部分与 Cesium.LabelGraphics 相同的构造参数和属性。</p>
+                <p>标牌配置参数。支持 <code>Cesium.LabelGraphics</code> 的常用构造参数和属性。</p>
 <table class="params">
@@ -207,7 +217,7 @@
-                <p>是否显示标牌</p></td>
+                <p>是否显示标牌。</p></td>
         </tr>
@@ -220,7 +230,7 @@
             <td class="type">
-<span class="param-type">Boolean</span>
+<span class="param-type">String</span>
@@ -243,7 +253,7 @@
-                <p>标牌文字</p></td>
+                <p>标牌文字。</p></td>
         </tr>
@@ -256,7 +266,7 @@
             <td class="type">
-<span class="param-type">Boolean</span>
+<span class="param-type">String</span>
@@ -279,7 +289,7 @@
-                <p>标牌字体</p></td>
+                <p>标牌字体。</p></td>
         </tr>
@@ -292,7 +302,7 @@
             <td class="type">
-<span class="param-type">Boolean</span>
+<span class="param-type">Cesium.Color</span>
@@ -315,7 +325,7 @@
-                <p>标牌背景色</p></td>
+                <p>标牌背景色。</p></td>
         </tr>
@@ -328,7 +338,7 @@
             <td class="type">
-<span class="param-type">Boolean</span>
+<span class="param-type">Cesium.Cartesian2</span>
@@ -351,7 +361,7 @@
-                <p>标牌像素偏移量</p></td>
+                <p>标牌像素偏移量。</p></td>
         </tr>
@@ -402,6 +412,23 @@
+        <h5>Example</h5>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { RouteAnimationLabel } = zondy.cesium
+// ES6引入方式
+import { RouteAnimationLabel } from "@mapgis/webclient-cesium-plugin"
+const label = new RouteAnimationLabel({
+  text: '巡检车辆',
+  showBackground: true
+})</code></pre>
 </dd>
@@ -434,7 +461,7 @@
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:55 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}/RouteAnimationModel.html RENAMED Viewed

@@ -99,7 +99,9 @@
     <div class="description">
-        <p>路径漫游模型对象</p>
+        <p>路径漫游模型配置对象。</p>
+<p>该对象用于描述路径漫游过程中挂载模型的显示样式、姿态与偏移量，
+兼容 <code>Cesium.ModelGraphics</code> 的常用配置项。</p>
     </div>
@@ -120,6 +122,8 @@
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -143,6 +147,12 @@
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
@@ -153,7 +163,7 @@
-                <p>可选参数。支持 Cesium.ModelGraphics 所有构造参数和属性，在此省略部分与 Cesium.ModelGraphics 相同的构造参数和属性。</p>
+                <p>模型配置参数。支持 <code>Cesium.ModelGraphics</code> 的常用构造参数和属性。</p>
 <table class="params">
@@ -207,7 +217,7 @@
-                <p>是否显示模型</p></td>
+                <p>是否显示模型。</p></td>
         </tr>
@@ -220,10 +230,10 @@
             <td class="type">
-<span class="param-type">string</span>
+<span class="param-type">String</span>
 |
-<span class="param-type">Resource</span>
+<span class="param-type">Cesium.Resource</span>
@@ -244,7 +254,7 @@
-                <p>模型URL</p></td>
+                <p>模型资源地址。</p></td>
         </tr>
@@ -280,7 +290,7 @@
-                <p>模型最小像素大小</p></td>
+                <p>模型最小像素大小。</p></td>
         </tr>
@@ -316,7 +326,7 @@
-                <p>模型航向角（绕Z轴旋转）</p></td>
+                <p>模型航向角（绕 Z 轴旋转）。</p></td>
         </tr>
@@ -352,7 +362,7 @@
-                <p>模型俯仰角（绕Y轴旋转）</p></td>
+                <p>模型俯仰角（绕 Y 轴旋转）。</p></td>
         </tr>
@@ -388,7 +398,7 @@
-                <p>模型翻滚角（绕X轴旋转）</p></td>
+                <p>模型翻滚角（绕 X 轴旋转）。</p></td>
         </tr>
@@ -424,7 +434,7 @@
-                <p>模型缩放比例</p></td>
+                <p>模型缩放比例。</p></td>
         </tr>
@@ -460,7 +470,7 @@
-                <p>模型偏移量</p>
+                <p>模型偏移量。</p>
 <table class="params">
@@ -514,7 +524,7 @@
-                <p>X轴偏移量（向前）</p></td>
+                <p>X 轴偏移量（向前）。</p></td>
         </tr>
@@ -550,7 +560,7 @@
-                <p>Y轴偏移量（向左）</p></td>
+                <p>Y 轴偏移量（向左）。</p></td>
         </tr>
@@ -586,7 +596,7 @@
-                <p>Z轴偏移量（向上）</p></td>
+                <p>Z 轴偏移量（向上）。</p></td>
         </tr>
@@ -643,6 +653,23 @@
+        <h5>Example</h5>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { RouteAnimationModel } = zondy.cesium
+// ES6引入方式
+import { RouteAnimationModel } from "@mapgis/webclient-cesium-plugin"
+const model = new RouteAnimationModel({
+  uri: 'http://example.com/model.glb',
+  scale: 2
+})</code></pre>
 </dd>
@@ -994,7 +1021,7 @@
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:55 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>