@mapgis/webclient-cesium-plugin 17.8.0 → 17.10.9

package/{documention → documentation}/Cesium3DTileset.html

@@ -94,25 +94,15 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、添加一个ArcGIS地图图片图层：原生接口开发</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/edit/modelEditor/m3d-model-editor' target='_blank'>2、模型编辑(M3D)</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>3、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#commonAnalyse' target='_blank'>4、三维分析</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#modelAnalyse' target='_blank'>5、模型分析</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#geologyAnalyse' target='_blank'>6、地质体分析</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#themeLayer' target='_blank'>7、专题图</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#commonVisualization' target='_blank'>8、场景美化</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#sceneLayer' target='_blank'>9、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过URL来构造一个CesiumTerrainProvider对象]</a><br></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>Cesium3DTileset对象，现已不支持通过构造函数(new Cesium3DTileset())的方式初始化图层，而是使用fromUrl方法构造图层</p>
+        <p>Cesium 原生 3D Tiles 集合封装类。</p>
+<p>该类用于统一 Cesium 3D Tiles 图层的创建方式。推荐通过 <code>fromUrl</code> 加载 tileset，
+当运行时 Cesium 版本缺少静态 <code>fromUrl</code> 时会自动回退到构造函数路径，以保持调用
+侧接入代码一致。</p>
     </div>
     
 
@@ -161,16 +151,17 @@
     
         <h5>Example</h5>
         
-        <p class="code-caption"><h7 id='example1'>添加一个Cesium3DTileset图层：原生接口开发</h7></p>
+        <p class="code-caption"><h7 id='example1'>添加一个 Cesium 3D Tiles 图层</h7></p>
     
 
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { Cesium3DTileset } = zondy.cesium
+
 // ES6引入方式
-import { Cesium3DTileset } from "@mapgis/webclient-cesium-plugin"
+import { Cesium3DTileset } from '@mapgis/webclient-cesium-plugin'
 
-const tileset = await Cesium3DTileset.fromUrl("http://10.10.130.72:8200/3DData/ModelCache/3DTileset/1.0/dayantaresult/tileset.json")
+const tileset = await Cesium3DTileset.fromUrl('http://10.10.130.72:8200/3DData/ModelCache/3DTileset/1.0/dayantaresult/tileset.json')
 viewer.scene.primitives.add(tileset)</code></pre>
     
 
@@ -203,12 +194,12 @@ viewer.scene.primitives.add(tileset)</code></pre>
     <div class="nameContainer">
         <h4 class="name" id=".fromUrl">
             
-            Cesium3DTileset.fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Cesium3DTileset.html">Cesium3DTileset</a>}</span>
+            Cesium3DTileset.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.Cesium3DTileset>|Cesium.Cesium3DTileset}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/Cesium3DTileset.js, line 37
+            engineExtensions/core/Cesium3DTileset.js, line 21
         </div>
         
     </div>
@@ -219,7 +210,7 @@ viewer.scene.primitives.add(tileset)</code></pre>
     
     
     <div class="description">
-        <p>通过URL来构造一个Cesium3DTileset对象</p>
+        <p>通过服务地址创建原生 Cesium 3D Tiles 集合对象。</p>
     </div>
     
 
@@ -240,6 +231,8 @@ viewer.scene.primitives.add(tileset)</code></pre>
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -263,10 +256,19 @@ viewer.scene.primitives.add(tileset)</code></pre>
             </td>
             
             
+                <td class="default">
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>Cesium 3DTile模型服务的基地址</p></td>
+                    
+                    
+                        
+                    
+                
+                <p>Cesium 3D Tiles 服务地址，通常指向 <code>tileset.json</code>。</p></td>
         </tr>
 	
 	
@@ -286,10 +288,23 @@ viewer.scene.primitives.add(tileset)</code></pre>
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>额外的构造参数，参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/Cesium3DTileset.html' target='_blank'>MapGISM3DSet</a>的初始化参数</p></td>
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>透传给原生 <code>Cesium.Cesium3DTileset</code> 的附加构造参数。</p></td>
         </tr>
 	
 	
@@ -350,11 +365,14 @@ viewer.scene.primitives.add(tileset)</code></pre>
             
             <td class="type">
             
-                        <a href="Cesium3DTileset.html">Cesium3DTileset</a>
+                        <a href="Promise.html">Promise</a>.&lt;Cesium.Cesium3DTileset>
+                         | 
+                    
+                        Cesium.Cesium3DTileset
                         
                     
             </td>
-            <td class="description last">新的Cesium3DTileset对象</td>
+            <td class="description last">已初始化的 tileset；具体返回形态取决于运行时 Cesium 版本。</td>
         </tr>
     
     </tbody>
@@ -379,7 +397,7 @@ viewer.scene.primitives.add(tileset)</code></pre>
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/CesiumHeatmap.html

@@ -94,15 +94,14 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、热力图</a><br></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
         <p>热力图</p>
+<p>该对象提供 Cesium 场景热力图能力，支持根据经纬度点数据生成热力渲染图层。
+适用于热点分布展示、密度分析可视化等场景。</p>
     </div>
     
 
@@ -160,6 +159,7 @@ http://10.10.130.72:8086/#/modules/cesium/visualization/themeLayer/heat-map
 
 // ES5引入方式
 const { CesiumHeatmap } = zondy.cesium
+
 // ES6引入方式
 import { CesiumHeatmap } from "@mapgis/webclient-cesium-plugin"
 
@@ -265,7 +265,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
     
     
     <div class="description">
-        <p>创建并返回一个热力图对象</p>
+        <p>创建并返回一个热力图实例。</p>
     </div>
     
 
@@ -327,7 +327,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <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>
 	
 	
@@ -341,6 +341,9 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
             
                 
 <span class="param-type">Cesium.Rectangle</span>
+|
+
+<span class="param-type">Object</span>
 
 
             
@@ -363,7 +366,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>热力图范围，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Rectangle' target='_blank'>详见Cesium.Rectangle</a></p></td>
+                <p>热力图覆盖范围，可传入 Cesium 矩形或包含 <code>north/east/south/west</code> 的范围对象。</p></td>
         </tr>
 	
 	
@@ -399,7 +402,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>可选参数</p>
+                <p>可选参数。</p>
                 
 
 <table class="params">
@@ -453,7 +456,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>热力图画布最小尺寸</p></td>
+                <p>热力图画布最小尺寸。</p></td>
         </tr>
 	
 	
@@ -489,7 +492,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>热力图画布最大尺寸</p></td>
+                <p>热力图画布最大尺寸。</p></td>
         </tr>
 	
 	
@@ -525,7 +528,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>如果没有给出半径，则使用数据点大小因子（高度和宽度中的较大者除以这个数字产生使用的半径）</p></td>
+                <p>未显式指定半径时使用的数据点大小因子。</p></td>
         </tr>
 	
 	
@@ -561,7 +564,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>边界周围的额外空间（点半径乘以这个数字产生间距）</p></td>
+                <p>边界额外留白系数。</p></td>
         </tr>
 	
 	
@@ -597,7 +600,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>如果未在热力图选项对象中给出，则使用的最大不透明度</p></td>
+                <p>热力图最大不透明度。</p></td>
         </tr>
 	
 	
@@ -633,7 +636,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>如果未在热图选项对象中给出，则使用的最小不透明度</p></td>
+                <p>热力图最小不透明度。</p></td>
         </tr>
 	
 	
@@ -669,7 +672,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>如果未在热力图选项对象中给出，则使用的模糊值为0.85。模糊值越高，渐变越平滑。</p></td>
+                <p>模糊值，数值越大渐变越平滑。</p></td>
         </tr>
 	
 	
@@ -705,7 +708,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>热力图颜色梯度</p></td>
+                <p>热力图颜色梯度。</p></td>
         </tr>
 	
 	
@@ -741,7 +744,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
                 
-                <p>默认自动重算热力半径</p></td>
+                <p>是否允许在视图变化时自动重算热力半径。</p></td>
         </tr>
 	
 	
@@ -812,7 +815,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
                         
                     
             </td>
-            <td class="description last">热力图对象</td>
+            <td class="description last">热力图实例对象。</td>
         </tr>
     
     </tbody>
@@ -834,7 +837,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
     
         
         <div class="tag-source">
-            engineExtensions/analysis/CesiumHeatmap.js, line 208
+            engineExtensions/analysis/CesiumHeatmap.js, line 198
         </div>
         
     </div>
@@ -909,7 +912,7 @@ heatMap.setWGS84Data(30, 150, heatMapData)</code></pre>
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention/S3MTileset.html → documentation/CesiumNavigation.html}

@@ -58,7 +58,7 @@
     <div class="navigationDiv">
     </div>
     <div class="main content-wrapper examples-container">
-        <h1 class="page-title" data-filename="S3MTileset.html">Class: S3MTileset</h1>
+        <h1 class="page-title" data-filename="CesiumNavigation.html">Class: CesiumNavigation</h1>
         
 
 
@@ -66,7 +66,7 @@
 <section>
     
 <header>
-    <h2></span>S3MTileset
+    <h2></span>CesiumNavigation
     
     
     </h2>
@@ -81,14 +81,14 @@
         
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="S3MTileset">
+        <h4 class="name" id="CesiumNavigation">
             
-            new S3MTileset<span class="signature">(options)</span>
+            new CesiumNavigation<span class="signature">(viewerCesiumWidget, <span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/scene/S3M/S3MTileset.js, line 4
+            engineExtensions/widgets/navigation/CesiumNavigation.js, line 5
         </div>
         
     </div>
@@ -99,7 +99,7 @@
     
     
     <div class="description">
-        <p>S3MTileset类</p>
+        <p>Cesium 导航控件容器对象。</p>
     </div>
     
 
@@ -130,80 +130,31 @@
 	
         <tr>
             
-                <td class="name"><code>options</code></td>
+                <td class="name"><code>viewerCesiumWidget</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">Object</span>
-
-
-            
-            </td>
-            
-            
-            
-            <td class="description last">
-                
-                <p>构造参数</p>
-                
-
-<table class="params">
-    <thead>
-	<tr>
-		
-		<th>Name</th>
-		
-		
-		<th>Type</th>
-		
-		
-		<th>Default</th>
-		
-		
-		<th class="last">Description</th>
-	</tr>
-	</thead>
-	
-	<tbody>
-	
-	
-        <tr>
-            
-                <td class="name"><code>url</code></td>
-            
-            
-            <td class="type">
-            
-                
-<span class="param-type">Cesium.Resource</span>
+<span class="param-type">Viewer</span>
 |
 
-<span class="param-type">String</span>
+<span class="param-type">Cesium.Widget</span>
 
 
             
             </td>
             
             
-                <td class="default">
-                
-                    ''
-                
-                </td>
-            
             
             <td class="description last">
                 
                     
-                        <span class="optional"> 可选</span>
-                    
                     
                         
                     
                 
-                <p>服务链接，必填</p></td>
+                <p>Cesium <code>Viewer</code> 或 <code>CesiumWidget</code> 实例。</p></td>
         </tr>
 	
 	
@@ -216,19 +167,13 @@
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
             
             </td>
             
             
-                <td class="default">
-                
-                    {}
-                
-                </td>
-            
             
             <td class="description last">
                 
@@ -239,13 +184,7 @@
                         
                     
                 
-                <p>其他参数，选填</p></td>
-        </tr>
-	
-	
-	</tbody>
-</table>
-            </td>
+                <p>导航控件配置参数。</p></td>
         </tr>
 	
 	
@@ -288,26 +227,54 @@
     
     
     
+    <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 { S3MTileset } = zondy.cesium
+const { NavigationTool } = zondy.cesium
+
 // ES6引入方式
-import { S3MTileset } from "@mapgis/webclient-cesium-plugin"
+import { NavigationTool } from "@mapgis/webclient-cesium-plugin"
 
-// 服务基地址
-const url = "//www.supermapol.com/realspace/services/3D-BIMBaoZha-2/rest/realspace"
-// 添加S3MTileSet
-const s3mTileSet = await S3MTileset.fromUrl(url, {
-   // 是否显示s3m模型
-   isVisible: true,
-   context: viewer.scene._context
- })
-viewer.scene.primitives.add(s3mTileSet)</code></pre>
+const viewer = new Cesium.Viewer('cesiumContainer')
+viewer.extend(NavigationTool, {
+  enableCompass: true,
+  enableZoomControls: true
+})</code></pre>
     
 
     
@@ -343,7 +310,7 @@ viewer.scene.primitives.add(s3mTileSet)</code></pre>
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>