@mapgis/webclient-cesium-plugin 17.8.0 → 17.10.9

package/{documention → documentation}/ArcGISMapServerSingleImageryProvider.html

@@ -88,7 +88,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISMapServerSingleImageryProvider.js, line 13
+            engineExtensions/scene/imageryProvider/ArcGISMapServerSingleImageryProvider.js, line 14
         </div>
         
     </div>
@@ -99,7 +99,9 @@
     
     
     <div class="description">
-        <p>ArcGIS地图服务一张图出图接入类</p>
+        <p>ArcGIS MapServer 一张图出图提供器。</p>
+<p>该类用于把 ArcGIS <code>MapServer</code> 或 IGS 转发的 ArcGIS 服务封装为 Cesium
+可直接加载的单图出图 imagery provider，适合按视口范围动态请求整张地图图片。</p>
     </div>
     
 
@@ -146,7 +148,7 @@
             
             <td class="description last">
                 
-                <p>初始化时的构造参数</p>
+                <p>初始化参数。</p>
                 
 
 <table class="params">
@@ -196,7 +198,7 @@
                         
                     
                 
-                <p>cesium视图对象</p></td>
+                <p>Cesium 视图对象。</p></td>
         </tr>
 	
 	
@@ -235,10 +237,14 @@
                         
                     
                 
-                <p>服务的基地址，支持url字符串和Cesium.Resource两种类型，当类型为Cesium.Resource时，支持传入额外请求参数、请求头参数等，具体请参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/Resource.html' target='_blank'>Cesium.Resource</a><br>
-格式如下：<br>
-IGS发布的ArcGIS服务: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/arcgis/MapServer<br>
-ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td>
+                <p>服务基地址。
+格式如下：</p>
+<ol>
+<li>IGS 发布的 ArcGIS 服务：
+<code>http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/arcgis/MapServer</code></li>
+<li>原生 ArcGIS 服务：
+<code>https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</code></li>
+</ol></td>
         </tr>
 	
 	
@@ -274,7 +280,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>要显示的子图层id，多个子图层以逗号分隔，'layer1,layer2,...'，如果要显示所有层，则请传一个空字符串</p></td>
+                <p>需要显示的子图层 ID 字符串。</p></td>
         </tr>
 	
 	
@@ -313,7 +319,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>瓦片的平铺方案，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=TilingScheme' target='_blank'>详见Cesium.TilingScheme</a></p></td>
+                <p>请求结果使用的平铺方案。</p></td>
         </tr>
 	
 	
@@ -349,7 +355,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <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>图层显示范围。</p></td>
         </tr>
 	
 	
@@ -385,7 +391,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>图层空间参考系</p></td>
+                <p>图层空间参考。</p></td>
         </tr>
 	
 	
@@ -421,7 +427,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>HTTP请求方式，&quot;GET&quot;、&quot;POST&quot;，默认为GET请求</p></td>
+                <p>HTTP 请求方式。</p></td>
         </tr>
 	
 	
@@ -457,7 +463,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>图层最小请求瓦片级别，小于该级别不再请求瓦片</p></td>
+                <p>最小请求级别。</p></td>
         </tr>
 	
 	
@@ -491,7 +497,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>图层最大请求瓦片级别，大于该级别不再请求瓦片</p></td>
+                <p>最大请求级别。</p></td>
         </tr>
 	
 	
@@ -527,7 +533,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>用户指定的图层过滤条件，它由多个键值对组成，值为过滤条件</p></td>
+                <p>图层过滤条件。</p></td>
         </tr>
 	
 	
@@ -563,7 +569,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>转发代理</p></td>
+                <p>转发代理。</p></td>
         </tr>
 	
 	
@@ -599,7 +605,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>重载build2DImageResource方法，来重载瓦片的请求逻辑</p></td>
+                <p>自定义图片请求资源构造函数。</p></td>
         </tr>
 	
 	
@@ -635,7 +641,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>动态投影坐标系字符串</p></td>
+                <p>返回图片坐标系。</p></td>
         </tr>
 	
 	
@@ -671,7 +677,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
                         
                     
                 
-                <p>bbox范围值的坐标系字符串</p></td>
+                <p>请求 bbox 使用的坐标系。</p></td>
         </tr>
 	
 	
@@ -722,6 +728,24 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
     
     
     
+        <h5>Example</h5>
+        
+
+    
+    <pre class="prettyprint"><code>// ES5引入方式
+const { ArcGISMapServerSingleImageryProvider } = zondy.cesium
+
+// ES6引入方式
+import { ArcGISMapServerSingleImageryProvider } from '@mapgis/webclient-cesium-plugin'
+
+const imageryProvider = new ArcGISMapServerSingleImageryProvider({
+  viewer,
+  url: 'https://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetWarm/MapServer'
+})
+viewer.imageryLayers.addImageryProvider(imageryProvider)</code></pre>
+    
+
+    
 </dd>
 
     
@@ -750,12 +774,12 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
     <div class="nameContainer">
         <h4 class="name" id="fromUrl">
             
-            fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{zondy.cesium.ArcGISMapServerSingleImageryProvider}</span>
+            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;<a href="ArcGISMapServerSingleImageryProvider.html">ArcGISMapServerSingleImageryProvider</a>>}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISMapServerSingleImageryProvider.js, line 110
+            engineExtensions/scene/imageryProvider/ArcGISMapServerSingleImageryProvider.js, line 128
         </div>
         
     </div>
@@ -765,6 +789,11 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
 <dd>
     
     
+    <div class="description">
+        <p>根据服务地址解析图层元信息并返回新的 provider 实例。</p>
+<p>该方法会先加载 ArcGIS 服务元信息，再把解析结果与调用方传入的配置合并。</p>
+    </div>
+    
 
     
     
@@ -783,6 +812,8 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -809,10 +840,19 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
             </td>
             
             
+                <td class="default">
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>服务的基地址，支持url字符串和Cesium.Resource两种类型，当类型为Cesium.Resource时，支持传入额外请求参数、请求头参数等，具体请参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/Resource.html' target='_blank'>Cesium.Resource</a></p></td>
+                    
+                    
+                        
+                    
+                
+                <p>服务基地址。</p></td>
         </tr>
 	
 	
@@ -832,10 +872,23 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>实例化对象时提供的额外配置参数，若该对象中包含构造参数则会覆盖对应的构造参数</p></td>
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>附加配置。若与服务元信息存在同名项，优先使用传入值。</p></td>
         </tr>
 	
 	
@@ -896,11 +949,11 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
             
             <td class="type">
             
-                        zondy.cesium.ArcGISMapServerSingleImageryProvider
+                        <a href="Promise.html">Promise</a>.&lt;<a href="ArcGISMapServerSingleImageryProvider.html">ArcGISMapServerSingleImageryProvider</a>>
                         
                     
             </td>
-            <td class="description last">初始化完毕的ArcGISMapServerSingleImageryProvider对象</td>
+            <td class="description last">已初始化的 provider 实例。</td>
         </tr>
     
     </tbody>
@@ -911,11 +964,18 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
     
         <h5>Example</h5>
         
-        <p class="code-caption"><h7 id='fromUrl'>通过ArcGIS地图服务的url获取ArcGISMapServerSingleImageryProvider对象</h7></p>
-    
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
  const imageryProvider = await ArcGISMapServerSingleImageryProvider.fromUrl(url)
  viewer.imageryLayers.addImageryProvider(imageryProvider)
+    <pre class="prettyprint"><code>// ES5引入方式
+const { ArcGISMapServerSingleImageryProvider } = zondy.cesium
+
+// ES6引入方式
+import { ArcGISMapServerSingleImageryProvider } from '@mapgis/webclient-cesium-plugin'
+
+const provider = await new ArcGISMapServerSingleImageryProvider({ viewer }).fromUrl(
+  'https://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetWarm/MapServer'
+)
+viewer.imageryLayers.addImageryProvider(provider)</code></pre>
     
 
     
@@ -935,7 +995,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
 
 
         <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}/ArcGISTileServerImageryProvider.html

@@ -94,22 +94,15 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、添加一个ArcGIS瓦片图层：原生接口开发</a><br>
-<a href='#example2'>2、添加一个ArcGIS瓦片图层：混合接口开发</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/layerControl/image-layer-elevation-mode-setting' target='_blank'>3、影像图层高程模式设置</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>4、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/sceneControl/scene/globe-independent-translucency' target='_blank'>5、地表透明度独立控制</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#tileLayer' target='_blank'>6、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过ArcGIS地图服务的url获取ArcGISMapServerImageryProvider对象]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
         <p>ArcGIS瓦片服务接入类，现已不支持通过构造函数(new ArcGISTileServerImageryProvider())的方式初始化图层，而是使用fromUrl方法构造图层</p>
+<p>该类用于加载 ArcGIS MapServer 的瓦片能力，统一返回 Cesium 可直接添加的影像提供器对象。
+当前推荐仅通过 <code>fromUrl</code> 构造实例，避免直接 <code>new</code> 导致参数不完整。
+在大比例尺场景中可通过 <code>isStretchImage</code> 控制超层级拉伸行为。</p>
     </div>
     
 
@@ -561,6 +554,7 @@ ArcGIS: https://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer</p></td
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISTileServerImageryProvider } = zondy.cesium
+
 // ES6引入方式
 import { ArcGISTileServerImageryProvider } from "@mapgis/webclient-cesium-plugin"
 
@@ -576,13 +570,14 @@ async function addArcGISMapImageLayer(url) {
 addArcGISMapImageLayer(url)</code></pre>
     
 
-        <p class="code-caption"><h7 id='example1'>添加一个ArcGIS瓦片图层：混合接口开发</h7></p>
+        <p class="code-caption"><h7 id='example2'>添加一个ArcGIS瓦片图层：混合接口开发</h7></p>
     
 
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISTileLayer } = zondy.layer
 const { initializeOptions } = zondy.cesium.util
+
 // ES6引入方式
 import { ArcGISTileLayer } from "@mapgis/webclient-common"
 import { initializeOptions } from "@mapgis/webclient-cesium-plugin"
@@ -594,7 +589,7 @@ const url = 'https://services.arcgisonline.com/arcgis/rest/services/World_Terrai
 const arcgisTileLayer = new ArcGISTileLayer({ url })
 
 // 获取瓦片图层服务的元信息
-arcgisMapImageLayer.load().then((layer) => {
+arcgisTileLayer.load().then((layer) => {
   // 获取provider的初始化参数
   const options = initializeOptions(layer, viewer)
   // 构造provider对象
@@ -633,12 +628,12 @@ arcgisMapImageLayer.load().then((layer) => {
     <div class="nameContainer">
         <h4 class="name" id=".fromUrl">
             
-            ArcGISTileServerImageryProvider.fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Cesium.ArcGISTileServerImageryProvider}</span>
+            ArcGISTileServerImageryProvider.fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Cesium.UrlTemplateImageryProvider}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISTileServerImageryProvider.js, line 96
+            engineExtensions/scene/imageryProvider/ArcGISTileServerImageryProvider.js, line 94
         </div>
         
     </div>
@@ -648,6 +643,10 @@ arcgisMapImageLayer.load().then((layer) => {
 <dd>
     
     
+    <div class="description">
+        <p>通过 ArcGIS 瓦片服务地址创建影像提供器。</p>
+    </div>
+    
 
     
     
@@ -779,11 +778,11 @@ arcgisMapImageLayer.load().then((layer) => {
             
             <td class="type">
             
-                        Cesium.ArcGISTileServerImageryProvider
+                        Cesium.UrlTemplateImageryProvider
                         
                     
             </td>
-            <td class="description last">初始化完毕的ArcGISTileServerImageryProvider对象</td>
+            <td class="description last">初始化完毕的影像提供器对象</td>
         </tr>
     
     </tbody>
@@ -800,6 +799,7 @@ arcgisMapImageLayer.load().then((layer) => {
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { ArcGISTileServerImageryProvider } = zondy.cesium
+
 // ES6引入方式
 import { ArcGISTileServerImageryProvider } from "@mapgis/webclient-cesium-plugin"
 
@@ -828,7 +828,7 @@ addImageryProvider(url)</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}/ArcGISVectorTileImageryProvider.html

@@ -94,18 +94,14 @@
     </div>
 
     
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>1、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#vectorTile' target='_blank'>2、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过ArcGIS矢量瓦片服务的url获取VectorTileImageryProvider对象]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
         <p>ArcGIS矢量瓦片服务接入类，现已不支持通过构造函数(new ArcGISVectorTileImageryProvider())的方式初始化图层，而是使用fromUrl方法构造图层</p>
+<p>该类用于将 ArcGIS VectorTileServer 服务转换为 Cesium 可加载的矢量瓦片影像提供器。
+推荐通过 <code>fromUrl</code> 自动解析服务元信息并生成初始化参数。</p>
     </div>
     
 
@@ -152,6 +148,23 @@
     
     
     
+        <h5>Example</h5>
+        
+        <p class="code-caption"><h7>添加 ArcGIS 矢量瓦片图层</h7></p>
+    
+
+    
+    <pre class="prettyprint"><code>// ES5引入方式
+const { ArcGISVectorTileImageryProvider } = zondy.cesium
+
+// ES6引入方式
+import { ArcGISVectorTileImageryProvider } from '@mapgis/webclient-cesium-plugin'
+
+const imageryProvider = await ArcGISVectorTileImageryProvider.fromUrl(url)
+viewer.imageryLayers.addImageryProvider(imageryProvider)</code></pre>
+    
+
+    
 </dd>
 
     
@@ -185,7 +198,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/ArcGISVectorTileImageryProvider.js, line 62
+            engineExtensions/scene/imageryProvider/ArcGISVectorTileImageryProvider.js, line 66
         </div>
         
     </div>
@@ -1047,7 +1060,7 @@ addImageryProvider(url)</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}/BaseImageryProvider.html

@@ -1033,7 +1033,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/BaseImageryProvider.js, line 81
+            engineExtensions/scene/imageryProvider/BaseImageryProvider.js, line 73
         </div>
         
     </div>
@@ -1276,7 +1276,7 @@ undefined if there are too many active requests to the server, and the request s
 
 
         <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}/Cesium.Material.html

@@ -88,7 +88,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/material/Material.js, line 12
+            engineExtensions/material/Material.js, line 13
         </div>
         
     </div>
@@ -296,7 +296,7 @@ const material = new Material({
 
 
         <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}/Cesium.Viewer.html

@@ -179,7 +179,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/Viewer.js, line 268
+            engineExtensions/scene/Viewer.js, line 233
         </div>
         
     </div>
@@ -336,7 +336,7 @@ options.enableCompassOuterRing= true;</p></td>
     
         
         <div class="tag-source">
-            engineExtensions/scene/Viewer.js, line 20
+            engineExtensions/scene/Viewer.js, line 21
         </div>
         
     </div>
@@ -518,7 +518,7 @@ options.enableCompassOuterRing= true;</p></td>
     
         
         <div class="tag-source">
-            engineExtensions/scene/Viewer.js, line 237
+            engineExtensions/scene/Viewer.js, line 203
         </div>
         
     </div>
@@ -589,7 +589,7 @@ options.enableCompassOuterRing= true;</p></td>
     
         
         <div class="tag-source">
-            engineExtensions/scene/Viewer.js, line 43
+            engineExtensions/scene/Viewer.js, line 41
         </div>
         
     </div>
@@ -907,7 +907,7 @@ options.enableCompassOuterRing= true;</p></td>
 
 
         <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>