@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.9

package/{documention → documentation}/MapGISFeatureGridCollection.html

@@ -88,7 +88,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/MapGISFeatureGridCollection.js, line 203
+            engineExtensions/scene/MapGISFeatureGridCollection.js, line 200
         </div>
         
     </div>
@@ -99,7 +99,7 @@
     
     
     <div class="description">
-        <p>网格要素容器</p>
+        <p>网格要素容器，用于按瓦片网格请求、缓存和渲染要素，适合按视口动态加载的大规模矢量数据场景。</p>
     </div>
     
 
@@ -198,7 +198,7 @@
                         
                     
                 
-                <p>查询网格内要素,返回一个Promise要素数组。</p></td>
+                <p>查询网格内要素的方法，需返回 <code>Promise&lt;Array&lt;Feature&gt;&gt;</code></p></td>
         </tr>
 	
 	
@@ -234,7 +234,7 @@
                         
                     
                 
-                <p>开启debug网格</p></td>
+                <p>是否开启调试网格</p></td>
         </tr>
 	
 	
@@ -270,7 +270,7 @@
                         
                     
                 
-                <p>要素更新间隔。设置值过大时也会影响性能</p></td>
+                <p>要素更新间隔，单位毫秒</p></td>
         </tr>
 	
 	
@@ -306,7 +306,7 @@
                         
                     
                 
-                <p>最大的瓦片缓存数量</p></td>
+                <p>最大瓦片缓存数量</p></td>
         </tr>
 	
 	
@@ -342,7 +342,7 @@
                         
                     
                 
-                <p>支持请求的最小级别，小于这个级别不会发送查询要素的请求</p></td>
+                <p>支持请求的最小级别</p></td>
         </tr>
 	
 	
@@ -378,7 +378,7 @@
                         
                     
                 
-                <p>支持请求的最大级别，大于这个级别不会发送查询要素的请求</p></td>
+                <p>支持请求的最大级别</p></td>
         </tr>
 	
 	
@@ -412,7 +412,7 @@
                         
                     
                 
-                <p>请求数据的范围，不在这个范围不会发送查询请求</p></td>
+                <p>请求数据的空间范围</p></td>
         </tr>
 	
 	
@@ -446,7 +446,7 @@
                         
                     
                 
-                <p>用于唯一标识要素的属性字段。多个网格会请求同样一个面要素，为了避免重复添加，增加要素属性字段用于标识唯一要素</p></td>
+                <p>用于唯一标识要素的属性字段</p></td>
         </tr>
 	
 	
@@ -459,7 +459,7 @@
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Number</span>
 
 
             
@@ -482,7 +482,7 @@
                         
                     
                 
-                <p>设置图层透明度，只支持部分符号样式。</p></td>
+                <p>图层透明度，只支持部分符号样式</p></td>
         </tr>
 	
 	
@@ -593,7 +593,7 @@
                         
                     
                 
-                <p>lod策略，'add'模式会一直添加要素，'replace'模式则是在瓦片更新时销毁上一级瓦片要素，添加下一级瓦片的要素。</p></td>
+                <p>LOD 策略；<code>add</code> 模式持续追加要素，<code>replace</code> 模式在瓦片更新时用下一级结果替换上一级结果</p></td>
         </tr>
 	
 	
@@ -635,7 +635,7 @@
                         
                     
                 
-                <p>瓦片网格划分方式，默认使用cesium的四叉树网格。</p></td>
+                <p>瓦片网格划分方式</p></td>
         </tr>
 	
 	
@@ -671,7 +671,7 @@
                         
                     
                 
-                <p>时间范围，仅显示在此时间范围内的要素，需要配合TimeInfo使用。</p></td>
+                <p>时间范围，仅显示处于该时间范围内的要素</p></td>
         </tr>
 	
 	
@@ -707,7 +707,7 @@
                         
                     
                 
-                <p>时间维度信息的描述</p></td>
+                <p>时间维度描述</p></td>
         </tr>
 	
 	
@@ -760,43 +760,50 @@
     
         <h5>Example</h5>
         
-
-    
-    <pre class="prettyprint"><code>const igsFeatureLayer = new IGSFeatureLayer({
-     url: 'http://10.10.130.72:8089/igs/rest/services/Map/%E6%B9%96%E5%8C%97%E7%9C%814326/FeatureServer'
-   })
-  featureGridCollection = viewer.scene.primitives.add(new MapGISFeatureGridCollection({
-      debugGrid: true,
-      maxTileCacheCount: 300,
-      minimumLevel: 6,
-      idField: "FID",
-      queryFeaturesByGrid: (grid) => {
-          return igsFeatureLayer.queryFeatures({
-              sublayerId: '0',
-              spatialRel: 'Intersects',
-              geometry: grid.extent,
-              resultRecordCount: 400
-          }).then((res) => {
-              res.features.forEach((feature) => {
-                  feature.symbol = new PolygonSymbol3D({
-                      symbolLayers: [
-                          // 创建一个三维拉伸区符号突出
-                          new ExtrudeSymbol3DLayer({
-                              // 覆盖物颜色
-                              material: new ColorMaterial({
-                                  color: new Color(255, 0, 0, 0.3)
-                              }),
-                              // 拉伸高度
-                              size: Math.random() * 1000 + 200
-                          })
-                      ]
-                  })
+        <p class="code-caption"><h7>创建网格要素容器</h7></p>
+    
+
+    
+    <pre class="prettyprint"><code>// ES5引入方式
+const { MapGISFeatureGridCollection } = zondy.cesium
+
+// ES6引入方式
+import { MapGISFeatureGridCollection } from "@mapgis/webclient-cesium-plugin"
+
+const igsFeatureLayer = new IGSFeatureLayer({
+  url: "http://10.10.130.72:8089/igs/rest/services/Map/%E6%B9%96%E5%8C%97%E7%9C%814326/FeatureServer"
+})
+
+const featureGridCollection = viewer.scene.primitives.add(
+  new MapGISFeatureGridCollection({
+    debugGrid: true,
+    maxTileCacheCount: 300,
+    minimumLevel: 6,
+    idField: "FID",
+    queryFeaturesByGrid: grid => {
+      return igsFeatureLayer.queryFeatures({
+        sublayerId: "0",
+        spatialRel: "Intersects",
+        geometry: grid.extent,
+        resultRecordCount: 400
+      }).then(res => {
+        res.features.forEach(feature => {
+          feature.symbol = new PolygonSymbol3D({
+            symbolLayers: [
+              new ExtrudeSymbol3DLayer({
+                material: new ColorMaterial({
+                  color: new Color(255, 0, 0, 0.3)
+                }),
+                size: Math.random() * 1000 + 200
               })
-              return Promise.resolve(res.features)
+            ]
           })
-
-      }
-  }))</code></pre>
+        })
+        return Promise.resolve(res.features)
+      })
+    }
+  })
+)</code></pre>
     
 
     
@@ -830,7 +837,7 @@
 <dd>
     
     <div class="description">
-        <p>是否开启debug网格</p>
+        <p>是否开启调试网格。</p>
     </div>
     
     
@@ -878,7 +885,7 @@
 <dd>
     
     <div class="description">
-        <p>设置渲染器</p>
+        <p>当前渲染器。</p>
     </div>
     
     
@@ -923,7 +930,7 @@
 <dd>
     
     <div class="description">
-        <p>显隐设置</p>
+        <p>图层显隐状态。</p>
     </div>
     
     
@@ -971,7 +978,7 @@
 <dd>
     
     <div class="description">
-        <p>设置时间范围</p>
+        <p>当前时间范围。</p>
     </div>
     
     
@@ -1016,7 +1023,52 @@
 <dd>
     
     <div class="description">
-        <p>设置时间信息</p>
+        <p>时间维度信息。</p>
+    </div>
+    
+    
+    
+<dl class="details">
+    
+        
+    
+    
+    
+
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+</dl>
+
+    
+    
+</dd>
+
+        
+            
+<dt>
+    <div class="nameContainer">
+        <h4 class="name" id="translucency">translucency<span class="type-signature type number">Number</span> </h4>
+    </div>
+    
+    
+</dt>
+<dd>
+    
+    <div class="description">
+        <p>图层透明度。</p>
     </div>
     
     
@@ -1037,6 +1089,9 @@
     
     
     
+    <dt class="tag-default">Default Value:</dt>
+    1</li></ul></dd>
+    
     
     
     
@@ -1063,12 +1118,12 @@
     <div class="nameContainer">
         <h4 class="name" id="destroy">
             
-            destroy<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{*}</span>
+            destroy<span class="signature">()</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/scene/MapGISFeatureGridCollection.js, line 616
+            engineExtensions/scene/MapGISFeatureGridCollection.js, line 597
         </div>
         
     </div>
@@ -1078,6 +1133,10 @@
 <dd>
     
     
+    <div class="description">
+        <p>销毁网格要素容器，释放 primitive、调试网格和要素缓存。</p>
+    </div>
+    
 
     
     
@@ -1120,35 +1179,6 @@
     
     
     
-    <h5>Returns:</h5>
-    
-
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Type</th>
-        <th class="last">Description</th>
-    </tr>
-    </thead>
-    <tbody>
-    
-        <tr>
-            
-            <td class="type">
-            
-                        *
-                        
-                    
-            </td>
-            <td class="description last"></td>
-        </tr>
-    
-    </tbody>
-</table>
-
-    
     
     
 </dd>
@@ -1164,7 +1194,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/scene/MapGISFeatureGridCollection.js, line 637
+            engineExtensions/scene/MapGISFeatureGridCollection.js, line 619
         </div>
         
     </div>
@@ -1174,6 +1204,10 @@
 <dd>
     
     
+    <div class="description">
+        <p>判断容器是否已销毁。</p>
+    </div>
+    
 
     
     
@@ -1263,7 +1297,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>