@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.9

package/{documention → documentation}/CompatibleFunc.html

@@ -94,17 +94,12 @@
     </div>
 
     
-    <p class="summary"><h5>支持如下方法：</h5>
-<a href='#worldToWindowCoordinates'>[1、适配Cesium不同版本的worldToWindowCoordinates方法，将世界坐标中的位置转换为窗口坐标]</a><br/>
-<a href='#fromGltfAsync'>[2、适配Cesium不同版本的fromGltfAsync方法，异步创建GLTF模型]</a><br/>
-<a href='#fromBoundingSphere'>[3、适配Cesium不同版本的fromBoundingSphere方法]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>适配不同版本Cesium接口方法类</p>
+        <p>适配不同 Cesium 版本差异接口的工具类。</p>
     </div>
     
 
@@ -153,12 +148,16 @@
     
         <h5>Example</h5>
         
+        <p class="code-caption"><h7>调用 Cesium 兼容适配方法</h7></p>
+    
 
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { CompatibleFunc } = zondy.cesium
+
 // ES6引入方式
 import { CompatibleFunc } from "@mapgis/webclient-cesium-plugin"
+
 const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
   scene,
   Cesium.Cartesian3.fromDegrees(0, 0, 0)
@@ -199,7 +198,7 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
     
         
         <div class="tag-source">
-            engineExtensions/util/CompatibleFunc.js, line 67
+            engineExtensions/util/CompatibleFunc.js, line 70
         </div>
         
     </div>
@@ -210,7 +209,8 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
     
     
     <div class="description">
-        <p>适配Cesium不同版本的fromBoundingSphere方法。Create a rectangle from a bounding sphere, ignoring height.</p>
+        <p>适配不同 Cesium 版本的 <code>fromBoundingSphere</code> 方法。
+该方法会在忽略高度的前提下，根据包围球计算矩形范围。</p>
     </div>
     
 
@@ -268,7 +268,7 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
                         
                     
                 
-                <p>The bounding sphere.</p></td>
+                <p>包围球对象。</p></td>
         </tr>
 	
 	
@@ -304,7 +304,7 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
                         
                     
                 
-                <p>The ellipsoid.</p></td>
+                <p>椭球对象。</p></td>
         </tr>
 	
 	
@@ -338,7 +338,7 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
                         
                     
                 
-                <p>The object onto which to store the result, or undefined if a new instance should be created.</p></td>
+                <p>用于接收结果的矩形对象；未提供时返回新对象。</p></td>
         </tr>
 	
 	
@@ -388,33 +388,22 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
 <table class="params">
     <thead>
     <tr>
-        <th>Name</th>
+        
         <th>Type</th>
         <th class="last">Description</th>
     </tr>
     </thead>
     <tbody>
     
-        <tr>
-            <td class="name"><code>The</code></td>
-            <td class="type">
-            
-                        Cesium.Rectangle
-                        
-                    
-            </td>
-            <td class="description last">modified result parameter or a new Rectangle instance if none was provided.</td>
-        </tr>
-    
         <tr>
             
             <td class="type">
             
-                        *
+                        Cesium.Rectangle
                         
                     
             </td>
-            <td class="description last"></td>
+            <td class="description last">计算得到的矩形范围。</td>
         </tr>
     
     </tbody>
@@ -436,7 +425,7 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
     
         
         <div class="tag-source">
-            engineExtensions/util/CompatibleFunc.js, line 46
+            engineExtensions/util/CompatibleFunc.js, line 48
         </div>
         
     </div>
@@ -447,8 +436,9 @@ const windowCoordinates = CompatibleFunc.worldToWindowCoordinates(
     
     
     <div class="description">
-        <p>适配Cesium不同版本的fromGltfAsync方法，异步创建GLTF模型。
-Cesium1.122中该方法为Cesium.Model.fromGltfAsync。Cesium1.84中该方法为Cesium.Model.fromGltf。<a id='fromGltfAsync'></a></p>
+        <p>适配不同 Cesium 版本的 <code>fromGltfAsync</code> 方法。
+Cesium 1.122 中对应 <code>Cesium.Model.fromGltfAsync</code>；
+Cesium 1.84 中对应 <code>Cesium.Model.fromGltf</code>。</p>
     </div>
     
 
@@ -515,7 +505,7 @@ Cesium1.122中该方法为Cesium.Model.fromGltfAsync。Cesium1.84中该方法为
                         
                     
             </td>
-            <td class="description last">fromGltfAsync方法</td>
+            <td class="description last">兼容后的 GLTF 模型创建方法。</td>
         </tr>
     
     </tbody>
@@ -548,8 +538,9 @@ Cesium1.122中该方法为Cesium.Model.fromGltfAsync。Cesium1.84中该方法为
     
     
     <div class="description">
-        <p>适配Cesium不同版本的worldToWindowCoordinates方法，将世界坐标中的位置转换为窗口坐标。
-Cesium1.122中该方法为Cesium.SceneTransforms.worldToWindowCoordinates。Cesium1.84中该方法为Cesium.SceneTransforms.wgs84ToWindowCoordinates。<a id='worldToWindowCoordinates'></a></p>
+        <p>适配不同 Cesium 版本的 <code>worldToWindowCoordinates</code> 方法。
+Cesium 1.122 中对应 <code>Cesium.SceneTransforms.worldToWindowCoordinates</code>；
+Cesium 1.84 中对应 <code>Cesium.SceneTransforms.wgs84ToWindowCoordinates</code>。</p>
     </div>
     
 
@@ -616,7 +607,7 @@ Cesium1.122中该方法为Cesium.SceneTransforms.worldToWindowCoordinates。Cesi
                         
                     
             </td>
-            <td class="description last">worldToWindowCoordinates方法</td>
+            <td class="description last">兼容后的窗口坐标转换方法。</td>
         </tr>
     
     </tbody>
@@ -641,7 +632,7 @@ Cesium1.122中该方法为Cesium.SceneTransforms.worldToWindowCoordinates。Cesi
 
 
         <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 Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/CustomPrimitive.html

@@ -71,6 +71,8 @@
     
     </h2>
     
+        <div class="class-description"><p>自定义DC</p></div>
+    
 </header>  
 
 <article>
@@ -98,10 +100,6 @@
 <dd>
     
     
-    <div class="description">
-        <p>自定义DC</p>
-    </div>
-    
 
     
     
@@ -178,7 +176,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 Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/CustomProjection.html

@@ -477,7 +477,7 @@ const projection = new CustomProjection({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomProjection.js, line 55
+            engineExtensions/core/CustomProjection.js, line 53
         </div>
         
     </div>
@@ -657,7 +657,7 @@ const projection = new CustomProjection({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomProjection.js, line 107
+            engineExtensions/core/CustomProjection.js, line 102
         </div>
         
     </div>
@@ -840,7 +840,7 @@ const projection = new CustomProjection({
 
 
         <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 Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/CustomTilingScheme.html

@@ -94,29 +94,18 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>[1、创建自定义瓦片切分规则]</a><br/>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/internetLayer/baidu' target='_blank'>[2、百度地图]</a><br/>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/internetLayer/custom' target='_blank'>[3、自定义裁图方式地图]</a><br/>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#layer' target='_blank'>[4、更多示例请参考数据图层示例]</a><br/>
-<h5>支持如下方法：</h5>
-<a href='#getNumberOfXTilesAtLevel'>[1、获取指定详细级别X方向上的瓦片总数]</a><br/>
-<a href='#getNumberOfYTilesAtLevel'>[2、获取指定详细级别Y方向上的瓦片总数]</a><br/>
-<a href='#positionToTileXY'>[3、计算一个坐标点在某一详细级别中位于某一瓦片的X、Y坐标]</a><br/>
-<a href='#rectangleToNativeRectangle'>[4、将以地理坐标经纬度弧度指定的矩形转换到此瓦片平铺方案的投影坐标系]</a><br/>
-<a href='#tileXYToNativeRectangle'>[5、将瓦片平铺的X、Y坐标和详细级别转换为以此瓦片平铺方案的投影坐标系表示的矩形]</a><br/>
-<a href='#tileXYToRectangle'>[6、将瓦片平铺的X、Y坐标和高度转换为以弧度表示的矩形范围]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>自定义瓦片平铺方案，在使用时有如下限制：</p>
-<ol>
-<li>裁图原点必须在地图范围的左上角区域；</li>
-<li>仅支持如同谷歌地图的瓦片组织方式，即Y轴编号从上到下递增，X轴编号从左到右递增；</li>
-</ol>
+        <p>自定义瓦片平铺方案。</p>
+<p>该类用于描述非标准切片服务的瓦片编号、数据范围和投影换算规则，负责在地理坐标、
+投影坐标与瓦片行列号之间进行双向转换。适用于 WMTS、自定义互联网底图或服务端
+直接返回 <code>tileInfo</code> 的切片服务接入场景。</p>
+<p>当前实现要求裁图原点位于地图范围左上区域，且瓦片组织方式与常见 Web 地图一致：
+X 方向从左向右递增，Y 方向从上向下递增。若服务采用其他编号方向，需要通过
+<code>axisDirection</code> 和 <code>tileInfo</code> 先完成兼容配置。</p>
     </div>
     
 
@@ -137,6 +126,8 @@
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -160,6 +151,12 @@
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
@@ -170,7 +167,7 @@
                         
                     
                 
-                <p>构造函数的参数对象，包含的属性如下：</p>
+                <p>构造参数。</p>
                 
 
 <table class="params">
@@ -224,7 +221,7 @@
                         
                     
                 
-                <p>表面被瓦片平铺的参考椭球体，默认为WGS84椭球体</p></td>
+                <p>参与瓦片范围计算的参考椭球体。未传入时使用 WGS84。</p></td>
         </tr>
 	
 	
@@ -258,7 +255,7 @@
                         
                     
                 
-                <p>投影坐标系的通识文本（Well Known Text）</p></td>
+                <p>投影坐标系的 WKT 定义。适用于按投影文本恢复平铺方案。</p></td>
         </tr>
 	
 	
@@ -292,7 +289,7 @@
                         
                     
                 
-                <p>投影坐标系的通识编码（Well Known ID）</p></td>
+                <p>投影坐标系编码。适用于按已知 WKID 恢复平铺方案。</p></td>
         </tr>
 	
 	
@@ -306,6 +303,9 @@
             
                 
 <span class="param-type">Object</span>
+|
+
+<span class="param-type">TileInfo</span>
 
 
             
@@ -320,13 +320,11 @@
             <td class="description last">
                 
                     
-                        <span class="optional"> 可选</span>
-                    
                     
                         
                     
                 
-                <p>必传。瓦片的属性信息，地图服务可以不提供该参数，该参数有固定的格式要求，详见下方示例</p></td>
+                <p>瓦片元信息。用于定义原点、LOD、分辨率和瓦片尺寸，是切片计算的基础输入。</p></td>
         </tr>
 	
 	
@@ -360,7 +358,7 @@
                         
                     
                 
-                <p>瓦片组织方向(裁图方向)。axisDirection.x=1代表x轴由左往右为正，axisDirection.x=-1代表x轴由右往左为正；axisDirection.y=1代表x轴由下往上为正，axisDirection.y=-1代表x轴由上往下为正。例如wmts的axisDirection为{x:1,y:-1}。</p></td>
+                <p>瓦片编号方向。<code>x=1/-1</code> 分别表示 X 轴正向为左到右/右到左，<code>y=1/-1</code> 分别表示 Y 轴正向为下到上/上到下。</p></td>
         </tr>
 	
 	
@@ -394,7 +392,7 @@
                         
                     
                 
-                <p>地图数据范围的西南角</p></td>
+                <p>数据范围的西南角投影坐标。通常在无法直接从 <code>tileInfo</code> 推断范围时传入。</p></td>
         </tr>
 	
 	
@@ -428,7 +426,7 @@
                         
                     
                 
-                <p>地图数据范围的东北角</p></td>
+                <p>数据范围的东北角投影坐标。通常与 <code>rectangleSouthwest</code> 配合使用。</p></td>
         </tr>
 	
 	
@@ -487,8 +485,9 @@
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { CustomTilingScheme } = zondy
+
 // ES6引入方式
-import { CustomTilingScheme } from "@mapgis/webclient-cesium-plugin"
+import { CustomTilingScheme } from '@mapgis/webclient-cesium-plugin'
 
 // 瓦片的属性信息
 const tileInfo = {
@@ -815,7 +814,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 523
+            engineExtensions/core/CustomTilingScheme.js, line 432
         </div>
         
     </div>
@@ -960,7 +959,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 540
+            engineExtensions/core/CustomTilingScheme.js, line 448
         </div>
         
     </div>
@@ -1105,7 +1104,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 712
+            engineExtensions/core/CustomTilingScheme.js, line 596
         </div>
         
     </div>
@@ -1313,7 +1312,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 558
+            engineExtensions/core/CustomTilingScheme.js, line 465
         </div>
         
     </div>
@@ -1493,7 +1492,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 589
+            engineExtensions/core/CustomTilingScheme.js, line 491
         </div>
         
     </div>
@@ -1729,7 +1728,7 @@ const tilingScheme = new CustomTilingScheme({
     
         
         <div class="tag-source">
-            engineExtensions/core/CustomTilingScheme.js, line 649
+            engineExtensions/core/CustomTilingScheme.js, line 537
         </div>
         
     </div>
@@ -1968,7 +1967,7 @@ const tilingScheme = new CustomTilingScheme({
 
 
         <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 Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/CutFillAnalysis.html

@@ -94,17 +94,14 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、填挖方分析</a>
-<h5>支持如下方法：</h5>
-<a href='#start'>[1、开始分析]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>填挖方分析</p>
+        <p>填挖方分析工具。</p>
+<p><code>CutFillAnalysis</code> 会在指定区域内生成采样格网，并基于地形、模型或场景高度结果计算填方体积、挖方体积和表面积。
+适用于土方量估算、场地平整评估和施工前地形测算等场景。</p>
     </div>
     
 
@@ -143,7 +140,7 @@
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type"><a href="Cesium.Viewer.html">Cesium.Viewer</a></span>
 
 
             
@@ -162,7 +159,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>
 	
 	
@@ -198,7 +195,7 @@
                         
                     
                 
-                <p>附加参数</p>
+                <p>填挖方分析初始化参数。</p>
                 
 
 <table class="params">
@@ -229,7 +226,7 @@
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">*</span>
 
 
             
@@ -252,7 +249,7 @@
                         
                     
                 
-                <p>地形图层</p></td>
+                <p>采样数据源，默认使用当前地形图层。</p></td>
         </tr>
 	
 	
@@ -288,7 +285,7 @@
                         
                     
                 
-                <p>X坐标方向采样点的个数，数值越大采样点越多，采样耗时越久</p></td>
+                <p>X 方向采样点个数，数值越大采样越密集。</p></td>
         </tr>
 	
 	
@@ -324,7 +321,7 @@
                         
                     
                 
-                <p>Y坐标方向采样点的个数，数值越大采样点越多，采样耗时越久</p></td>
+                <p>Y 方向采样点个数，数值越大采样越密集。</p></td>
         </tr>
 	
 	
@@ -360,7 +357,7 @@
                         
                     
                 
-                <p>设定格子X方向距离,默认为负值的情况下，使用直接设定paneNumber的采样点个数</p></td>
+                <p>X 方向格网边长，单位为米；小于等于 0 时按采样点个数划分。</p></td>
         </tr>
 	
 	
@@ -396,7 +393,7 @@
                         
                     
                 
-                <p>设定格子Y方向距离</p></td>
+                <p>Y 方向格网边长，单位为米；小于等于 0 时按采样点个数划分。</p></td>
         </tr>
 	
 	
@@ -432,7 +429,7 @@
                         
                     
                 
-                <p>填挖方平整高程，低于该高度会计算填方体积，高于该高度会计算挖方体积</p></td>
+                <p>基准平整高程。低于该高度的区域计为填方，高于该高度的区域计为挖方。</p></td>
         </tr>
 	
 	
@@ -468,7 +465,7 @@
                         
                     
                 
-                <p>要采样的数据类型,0.0：地形，1.0：模型，2.0：场景(地形加模型)，请注意当采样类型选择，模型或场景是，采样速度会变慢</p></td>
+                <p>采样类型。<code>0</code> 表示地形，<code>1</code> 表示模型，<code>2</code> 表示地形与模型混合场景。</p></td>
         </tr>
 	
 	
@@ -490,8 +487,6 @@
             
                 <td class="default">
                 
-                    null
-                
                 </td>
             
             
@@ -504,7 +499,7 @@
                         
                     
                 
-                <p>结果回调函数</p></td>
+                <p>分析完成后的结果回调函数。</p></td>
         </tr>
 	
 	
@@ -540,7 +535,7 @@
                         
                     
                 
-                <p>地形取高程时使用的地形层级，默认使用最精细级</p></td>
+                <p>地形取高时使用的地形层级，默认使用最精细级。</p></td>
         </tr>
 	
 	
@@ -599,6 +594,7 @@
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { CutFillAnalysis } = zondy.cesium
+
 // ES6引入方式
 import { CutFillAnalysis } from "@mapgis/webclient-cesium-plugin"
 
@@ -1247,12 +1243,12 @@ cutFill.start(minMax)</code></pre>
     <div class="nameContainer">
         <h4 class="name" id="start">
             
-            start<span class="signature">(params)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Boolean}</span>
+            start<span class="signature">(params, <span class="optional">terrainData</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Boolean}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/analysis/CutFillAnalysis.js, line 678
+            engineExtensions/analysis/CutFillAnalysis.js, line 664
         </div>
         
     </div>
@@ -1263,7 +1259,8 @@ cutFill.start(minMax)</code></pre>
     
     
     <div class="description">
-        <p>开始分析<a id='start'/></p>
+        <p>启动一次填挖方分析。</p>
+<p>该方法会根据输入范围和当前采样配置生成格网点，并按 <code>dataType</code> 选择地形、模型或场景高程采样流程。</p>
     </div>
     
 
@@ -1310,7 +1307,42 @@ cutFill.start(minMax)</code></pre>
             
             <td class="description last">
                 
-                <p>最小最大经纬度值</p></td>
+                    
+                    
+                        
+                    
+                
+                <p>由 <code>getMinAndMaxCartesian</code> 返回的最小外接经纬度范围。</p></td>
+        </tr>
+	
+	
+	
+        <tr>
+            
+                <td class="name"><code>terrainData</code></td>
+            
+            
+            <td class="type">
+            
+                
+<span class="param-type">*</span>
+
+
+            
+            </td>
+            
+            
+            
+            <td class="description last">
+                
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>可选的地形或场景数据源；传入后会覆盖实例当前的数据源。</p></td>
         </tr>
 	
 	
@@ -1375,7 +1407,7 @@ cutFill.start(minMax)</code></pre>
                         
                     
             </td>
-            <td class="description last">成功返回 true</td>
+            <td class="description last">是否已成功启动分析流程。</td>
         </tr>
     
     </tbody>
@@ -1400,7 +1432,7 @@ cutFill.start(minMax)</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 Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>