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

@@ -83,7 +83,7 @@
     <div class="nameContainer">
         <h4 class="name" id="RoamParticle">
-            new RoamParticle<span class="signature">(viewer, options, <span class="optional">positionStart</span>, <span class="optional">positionEnd</span>)</span>
+            new RoamParticle<span class="signature">(viewer, options)</span>
         </h4>
@@ -99,7 +99,7 @@
     <div class="description">
-        <p>跟随模型移动粒子特效</p>
+        <p>跟随模型沿路径运动的粒子特效，可在实体移动过程中同步渲染拖尾、烟雾等粒子效果。</p>
     </div>
@@ -136,7 +136,7 @@
             <td class="type">
-<span class="param-type">Object</span>
+<span class="param-type"><a href="Cesium.Viewer.html">Cesium.Viewer</a></span>
@@ -146,12 +146,7 @@
             <td class="description last">
-                <p>视图</p></td>
+                <p>Cesium 场景视图对象</p></td>
         </tr>
@@ -174,11 +169,6 @@
             <td class="description last">
                 <p>附加粒子特效参数</p>
@@ -223,7 +213,7 @@
-                <p>粒子url</p></td>
+                <p>粒子纹理地址</p></td>
         </tr>
@@ -251,7 +241,7 @@
-                <p>模型url</p></td>
+                <p>漫游模型地址</p></td>
         </tr>
@@ -281,13 +271,7 @@
-                <p>最小像素尺寸</p></td>
-        </tr>
-	</tbody>
-</table>
-            </td>
+                <p>模型最小像素尺寸</p></td>
         </tr>
@@ -354,7 +338,7 @@
         <tr>
-                <td class="name"><code>options.viewFrom</code></td>
+                <td class="name"><code>viewFrom</code></td>
             <td class="type">
@@ -377,14 +361,14 @@
-                <p>观察点</p></td>
+                <p>跟踪实体时的观察偏移量</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.startTime</code></td>
+                <td class="name"><code>startTime</code></td>
             <td class="type">
@@ -407,14 +391,14 @@
-                <p>开始时间</p></td>
+                <p>漫游开始时间</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.duration</code></td>
+                <td class="name"><code>duration</code></td>
             <td class="type">
@@ -437,14 +421,14 @@
-                <p>持续周期</p></td>
+                <p>从起点运动到终点的持续时间，单位秒</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.startColor</code></td>
+                <td class="name"><code>startColor</code></td>
             <td class="type">
@@ -467,14 +451,14 @@
-                <p>开始的颜色</p></td>
+                <p>粒子起始颜色</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.endColor</code></td>
+                <td class="name"><code>endColor</code></td>
             <td class="type">
@@ -497,14 +481,14 @@
-                <p>结束的颜色</p></td>
+                <p>粒子结束颜色</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.startScale</code></td>
+                <td class="name"><code>startScale</code></td>
             <td class="type">
@@ -527,14 +511,14 @@
-                <p>开始的尺寸</p></td>
+                <p>粒子起始尺寸缩放</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.endScale</code></td>
+                <td class="name"><code>endScale</code></td>
             <td class="type">
@@ -557,14 +541,14 @@
-                <p>结束的尺寸</p></td>
+                <p>粒子结束尺寸缩放</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.minimumParticleLife</code></td>
+                <td class="name"><code>minimumParticleLife</code></td>
             <td class="type">
@@ -587,14 +571,14 @@
-                <p>最小粒子周期</p></td>
+                <p>粒子最短生命周期</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.maximumParticleLife</code></td>
+                <td class="name"><code>maximumParticleLife</code></td>
             <td class="type">
@@ -617,14 +601,14 @@
-                <p>最大粒子周期</p></td>
+                <p>粒子最长生命周期</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.minimumSpeed</code></td>
+                <td class="name"><code>minimumSpeed</code></td>
             <td class="type">
@@ -647,14 +631,14 @@
-                <p>最小速率</p></td>
+                <p>粒子最小速度</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.maximumSpeed</code></td>
+                <td class="name"><code>maximumSpeed</code></td>
             <td class="type">
@@ -677,14 +661,14 @@
-                <p>最大速率</p></td>
+                <p>粒子最大速度</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.particleSize</code></td>
+                <td class="name"><code>particleSize</code></td>
             <td class="type">
@@ -714,7 +698,7 @@
         <tr>
-                <td class="name"><code>options.emissionRate</code></td>
+                <td class="name"><code>emissionRate</code></td>
             <td class="type">
@@ -744,13 +728,13 @@
         <tr>
-                <td class="name"><code>options.bursts</code></td>
+                <td class="name"><code>bursts</code></td>
             <td class="type">
-<span class="param-type">Array</span>
+<span class="param-type">Array.&lt;Cesium.ParticleBurst></span>
@@ -767,14 +751,14 @@
-                <p>爆发形状</p></td>
+                <p>粒子爆发配置</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.lifetime</code></td>
+                <td class="name"><code>lifetime</code></td>
             <td class="type">
@@ -804,13 +788,13 @@
         <tr>
-                <td class="name"><code>options.emitter</code></td>
+                <td class="name"><code>emitter</code></td>
             <td class="type">
-<span class="param-type">object</span>
+<span class="param-type">Object</span>
@@ -827,20 +811,20 @@
-                <p>粒子发射器类型</p></td>
+                <p>粒子发射器对象</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.minimumImageSize</code></td>
+                <td class="name"><code>minimumImageSize</code></td>
             <td class="type">
-<span class="param-type">Number</span>
+<span class="param-type">Cesium.Cartesian2</span>
@@ -857,20 +841,20 @@
-                <p>最小Image尺寸</p></td>
+                <p>粒子纹理最小尺寸</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.maximumImageSize</code></td>
+                <td class="name"><code>maximumImageSize</code></td>
             <td class="type">
-<span class="param-type">Number</span>
+<span class="param-type">Cesium.Cartesian2</span>
@@ -887,14 +871,14 @@
-                <p>最大Image尺寸</p></td>
+                <p>粒子纹理最大尺寸</p></td>
         </tr>
         <tr>
-                <td class="name"><code>options.gravity</code></td>
+                <td class="name"><code>gravity</code></td>
             <td class="type">
@@ -923,6 +907,12 @@
 	</tbody>
 </table>
+            </td>
+        </tr>
+	</tbody>
+</table>
@@ -971,9 +961,26 @@
         <h5>Example</h5>
+        <p class="code-caption"><h7>创建路径漫游粒子特效</h7></p>
-    <pre class="prettyprint"><code>var options = {
              modelUrl: '../CesiumMilkTruck/CesiumMilkTruck.glb',
             startTime: Cesium.JulianDate.fromDate(new Date(2015, 2, 25, 16)),
             duration: 120,
             positionStart: Cesium.Cartesian3.fromDegrees(-75.15787310614596,39.97862668312678),
             positionEnd: Cesium.Cartesian3.fromDegrees(-75.1633691390455,39.95355089912078)
         };
+    <pre class="prettyprint"><code>// ES5引入方式
+const { RoamParticle } = zondy.cesium
+// ES6引入方式
+import { RoamParticle } from "@mapgis/webclient-cesium-plugin"
+const roamParticle = new RoamParticle(viewer, {
+  imageUrl: "../Data/Images/smoke.png",
+  modelUrl: "../CesiumMilkTruck/CesiumMilkTruck.glb",
+  startTime: new Date(2015, 2, 25, 16),
+  duration: 120,
+  positionStart: Cesium.Cartesian3.fromDegrees(-75.15787310614596, 39.97862668312678),
+  positionEnd: Cesium.Cartesian3.fromDegrees(-75.1633691390455, 39.95355089912078)
+})
+roamParticle.start()
+roamParticle.remove()</code></pre>
@@ -1224,7 +1231,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="maximumImageSize">maximumImageSize<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="maximumImageSize">maximumImageSize<span class="type-signature type cesium.cartesian2">Cesium.Cartesian2</span> </h4>
     </div>
@@ -1232,7 +1239,7 @@
 <dd>
     <div class="description">
-        <p>最大Image尺寸</p>
+        <p>粒子纹理最大尺寸</p>
     </div>
@@ -1359,7 +1366,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="minimumImageSize">minimumImageSize<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="minimumImageSize">minimumImageSize<span class="type-signature type cesium.cartesian2">Cesium.Cartesian2</span> </h4>
     </div>
@@ -1367,7 +1374,7 @@
 <dd>
     <div class="description">
-        <p>最小Image尺寸</p>
+        <p>粒子纹理最小尺寸</p>
     </div>
@@ -1629,7 +1636,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="particleSystemObject">particleSystemObject<span class="type-signature type object">Object</span> </h4>
+        <h4 class="name" id="particleSystemObject">particleSystemObject<span class="type-signature type cesium.particlesystem">Cesium.ParticleSystem</span> </h4>
     </div>
@@ -1637,7 +1644,7 @@
 <dd>
     <div class="description">
-        <p>粒子系统ParticleSystem对象</p>
+        <p>粒子系统对象</p>
     </div>
@@ -1854,7 +1861,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="startTime">startTime<span class="type-signature type object">Object</span> </h4>
+        <h4 class="name" id="startTime">startTime<span class="type-signature type cesium.juliandate">Cesium.JulianDate</span> </h4>
     </div>
@@ -1862,7 +1869,7 @@
 <dd>
     <div class="description">
-        <p>起始时间</p>
+        <p>漫游起始时间</p>
     </div>
@@ -1899,7 +1906,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="stopTime">stopTime<span class="type-signature type object">Object</span> </h4>
+        <h4 class="name" id="stopTime">stopTime<span class="type-signature type cesium.juliandate">Cesium.JulianDate</span> </h4>
     </div>
@@ -1907,7 +1914,7 @@
 <dd>
     <div class="description">
-        <p>结束时间</p>
+        <p>漫游结束时间</p>
     </div>
@@ -1944,7 +1951,7 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="viewer">viewer<span class="type-signature type object">Object</span> </h4>
+        <h4 class="name" id="viewer">viewer<span class="type-signature type cesium.viewer"><a href="Cesium.Viewer.html">Cesium.Viewer</a></span> </h4>
     </div>
@@ -1952,7 +1959,7 @@
 <dd>
     <div class="description">
-        <p>视图</p>
+        <p>场景视图对象</p>
     </div>
@@ -2004,7 +2011,7 @@
         <div class="tag-source">
-            engineExtensions/effects/RoamParticle.js, line 226
+            engineExtensions/effects/RoamParticle.js, line 203
         </div>
     </div>
@@ -2015,7 +2022,7 @@
     <div class="description">
-        <p>移除</p>
+        <p>移除已创建的漫游实体和粒子系统。</p>
     </div>
@@ -2075,7 +2082,7 @@
         <div class="tag-source">
-            engineExtensions/effects/RoamParticle.js, line 158
+            engineExtensions/effects/RoamParticle.js, line 138
         </div>
     </div>
@@ -2086,7 +2093,7 @@
     <div class="description">
-        <p>开始</p>
+        <p>创建路径实体并启动粒子系统。</p>
     </div>
@@ -2149,7 +2156,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>