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

@@ -94,18 +94,14 @@
     </div>
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/terrainAnalyse/terrain-excavation' target='_blank'>1、地形开挖</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#terrain' target='_blank'>2、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过URL来构造一个CesiumTerrainProvider对象]</a><br></p>
 </dt>
 <dd>
     <div class="description">
-        <p>Cesium地形图层</p>
+        <p>Cesium 原生地形提供器封装类。</p>
+<p>该类用于统一不同 Cesium 版本下原生地形服务的接入方式。调用方可始终通过
+<code>fromUrl</code> 创建地形提供器，而无需关心当前运行时是否支持静态工厂方法。</p>
     </div>
@@ -152,6 +148,21 @@
+        <h5>Example</h5>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { CesiumTerrainProvider } = zondy.cesium
+// ES6引入方式
+import { CesiumTerrainProvider } from '@mapgis/webclient-cesium-plugin'
+const provider = await CesiumTerrainProvider.fromUrl(url)
+viewer.terrainProvider = provider</code></pre>
 </dd>
@@ -180,12 +191,12 @@
     <div class="nameContainer">
         <h4 class="name" id=".fromUrl">
-            CesiumTerrainProvider.fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="CesiumTerrainProvider.html">CesiumTerrainProvider</a>}</span>
+            CesiumTerrainProvider.fromUrl<span class="signature">(url, <span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>.&lt;Cesium.CesiumTerrainProvider>|Cesium.CesiumTerrainProvider}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/core/CesiumTerrainProvider.js, line 21
+            engineExtensions/core/CesiumTerrainProvider.js, line 20
         </div>
     </div>
@@ -196,7 +207,9 @@
     <div class="description">
-        <p>通过URL来构造一个CesiumTerrainProvider对象<a id='fromUrl'/></p>
+        <p>通过服务地址创建原生 Cesium 地形提供器。</p>
+<p>在高版本 Cesium 中会直接调用原生 <code>Cesium.CesiumTerrainProvider.fromUrl</code>；
+低版本则回退到构造函数并等待 <code>readyPromise</code> 完成后返回。</p>
     </div>
@@ -217,6 +230,8 @@
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -240,10 +255,19 @@
             </td>
+                <td class="default">
+                </td>
             <td class="description last">
-                <p>Cesium地形服务的基地址</p></td>
+                <p>Cesium 地形服务地址，通常指向 terrain 服务根路径或 <code>layer.json</code> 所在路径。</p></td>
         </tr>
@@ -263,10 +287,23 @@
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
-                <p>额外的构造参数，参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/CesiumTerrainProvider.html' target='_blank'>CesiumTerrainProvider</a>的初始化参数</p></td>
+                        <span class="optional"> 可选</span>
+                <p>透传给原生 <code>Cesium.CesiumTerrainProvider</code> 的附加构造参数。</p></td>
         </tr>
@@ -327,11 +364,14 @@
             <td class="type">
-                        <a href="CesiumTerrainProvider.html">CesiumTerrainProvider</a>
+                        <a href="Promise.html">Promise</a>.&lt;Cesium.CesiumTerrainProvider>
+                         |
+                        Cesium.CesiumTerrainProvider
             </td>
-            <td class="description last">新的CesiumTerrainProvider对象</td>
+            <td class="description last">已初始化的地形提供器；具体返回形态取决于运行时 Cesium 版本。</td>
         </tr>
     </tbody>
@@ -356,7 +396,7 @@
         <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/OpenWeatherImageryProvider.html → documentation/CircleWaveMaterialProperty.html} RENAMED Viewed

@@ -58,7 +58,7 @@
     <div class="navigationDiv">
     </div>
     <div class="main content-wrapper examples-container">
-        <h1 class="page-title" data-filename="OpenWeatherImageryProvider.html">Class: OpenWeatherImageryProvider</h1>
+        <h1 class="page-title" data-filename="CircleWaveMaterialProperty.html">Class: CircleWaveMaterialProperty</h1>
@@ -66,7 +66,7 @@
 <section>
 <header>
-    <h2></span>OpenWeatherImageryProvider
+    <h2></span>CircleWaveMaterialProperty
     </h2>
@@ -81,14 +81,14 @@
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="OpenWeatherImageryProvider">
+        <h4 class="name" id="CircleWaveMaterialProperty">
-            new OpenWeatherImageryProvider<span class="signature">(options)</span>
+            new CircleWaveMaterialProperty<span class="signature">(options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/OpenWeatherImageryProvider.js, line 26
+            engineExtensions/material/CircleWaveMaterialProperty.js, line 2
         </div>
     </div>
@@ -99,7 +99,7 @@
     <div class="description">
-        <p>OpenWeatherMap服务服务接入类</p>
+        <p>动态圆波纹材质属性。</p>
     </div>
@@ -146,7 +146,7 @@
             <td class="description last">
-                <p>可选参数</p>
+                <p>创建动态圆波纹材质属性的参数。</p>
 <table class="params">
@@ -171,16 +171,13 @@
         <tr>
-                <td class="name"><code>url</code></td>
+                <td class="name"><code>viewer</code></td>
             <td class="type">
-<span class="param-type">Cesium.Resource</span>
-|
-<span class="param-type">String</span>
+<span class="param-type"><a href="Cesium.Viewer.html">Cesium.Viewer</a></span>
@@ -195,60 +192,26 @@
             <td class="description last">
-                <p>服务地址</p></td>
-        </tr>
-        <tr>
-                <td class="name"><code>tileWidth</code></td>
-            <td class="type">
-<span class="param-type">Number</span>
-            </td>
-                <td class="default">
-                    256
-                </td>
-            <td class="description last">
                         <span class="optional"> 可选</span>
-                <p>瓦片宽度</p></td>
+                <p>当前场景视图对象；用于按需注册 CircleWave 材质。</p></td>
         </tr>
         <tr>
-                <td class="name"><code>tileHeight</code></td>
+                <td class="name"><code>color</code></td>
             <td class="type">
-<span class="param-type">Number</span>
+<span class="param-type">Cesium.Color</span>
@@ -257,8 +220,6 @@
                 <td class="default">
-                    256
                 </td>
@@ -271,14 +232,14 @@
-                <p>瓦片高度</p></td>
+                <p>波纹颜色，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Color' target='_blank'>详见Cesium.Color</a>。</p></td>
         </tr>
         <tr>
-                <td class="name"><code>minimumLevel</code></td>
+                <td class="name"><code>duration</code></td>
             <td class="type">
@@ -293,7 +254,7 @@
                 <td class="default">
-                    0
+                    1000
                 </td>
@@ -307,14 +268,14 @@
-                <p>瓦片最小级别</p></td>
+                <p>波纹动画周期，单位为毫秒。</p></td>
         </tr>
         <tr>
-                <td class="name"><code>maximumLevel</code></td>
+                <td class="name"><code>count</code></td>
             <td class="type">
@@ -329,7 +290,7 @@
                 <td class="default">
-                    0
+                    2
                 </td>
@@ -343,20 +304,20 @@
-                <p>瓦片最大级别</p></td>
+                <p>同时显示的波纹圈数。</p></td>
         </tr>
         <tr>
-                <td class="name"><code>proxy</code></td>
+                <td class="name"><code>gradient</code></td>
             <td class="type">
-<span class="param-type">String</span>
+<span class="param-type">Number</span>
@@ -365,39 +326,7 @@
                 <td class="default">
-                </td>
-            <td class="description last">
-                        <span class="optional"> 可选</span>
-                <p>转发代理</p></td>
-        </tr>
-        <tr>
-                <td class="name"><code>tilingScheme</code></td>
-            <td class="type">
-<span class="param-type">Object</span>
-            </td>
-                <td class="default">
+                    0.1
                 </td>
@@ -411,7 +340,7 @@
-                <p>服务的平铺方案:经纬度 GeographicTilingScheme,web墨卡托 Cesium.WebMercatorTilingScheme</p></td>
+                <p>波纹渐变拖尾强度，取值范围为 <code>[0, 1]</code>。</p></td>
         </tr>
@@ -460,7 +389,58 @@
+    <h5>Returns:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td class="type">
+                        Object
+            </td>
+            <td class="description last">返回动态圆波纹材质属性实例。</td>
+        </tr>
+    </tbody>
+</table>
+        <h5>Example</h5>
+        <p class="code-caption"><h7>创建动态圆波纹材质属性</h7></p>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { CircleWaveMaterialProperty } = zondy.cesium
+// ES6引入方式
+import { CircleWaveMaterialProperty } from "@mapgis/webclient-cesium-plugin"
+const material = new CircleWaveMaterialProperty({
+  viewer,
+  color: Cesium.Color.CYAN,
+  duration: 1500,
+  count: 3,
+  gradient: 0.2
+})</code></pre>
 </dd>
@@ -494,7 +474,7 @@
         <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>