npm - @mapgis/webclient-cesium-plugin - Versions diffs - 17.8.0 → 17.10.9 - Mend

@mapgis/webclient-cesium-plugin 17.8.0 → 17.10.9

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

@@ -99,7 +99,9 @@
     <div class="description">
-        <p>绘制工具</p>
+        <p>标绘绘制工具。</p>
+<p>该工具负责在图形图层中通过折线或面域批量布设模型实例，并统一管理鼠标交互、
+实时提示与绘制完成回调。</p>
     </div>
@@ -146,7 +148,7 @@
             <td class="description last">
-                </td>
+                <p>Cesium 视图对象。</p></td>
         </tr>
@@ -169,7 +171,7 @@
             <td class="description last">
-                <p>编辑的图层对象</p></td>
+                <p>承载绘制结果的图形图层对象。</p></td>
         </tr>
@@ -192,7 +194,7 @@
             <td class="description last">
+                <p>绘制工具配置项。</p>
 <table class="params">
@@ -246,7 +248,41 @@
-                <p>是否连续绘制</p></td>
+                <p>是否在一次绘制结束后继续保持激活状态。</p></td>
+        </tr>
+        <tr>
+                <td class="name"><code>finishDraw</code></td>
+            <td class="type">
+<span class="param-type">function</span>
+            </td>
+                <td class="default">
+                </td>
+            <td class="description last">
+                        <span class="optional"> 可选</span>
+                <p>单次绘制完成后的回调函数。</p></td>
         </tr>
@@ -297,6 +333,20 @@
+        <h5>Example</h5>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { DrawTool } = zondy.cesium
+// ES6引入方式
+import { DrawTool } from '@mapgis/webclient-cesium-plugin'
+const tool = new DrawTool(viewer, graphicsLayer)</code></pre>
 </dd>
@@ -330,7 +380,7 @@
         <div class="tag-source">
-            engineExtensions/tools/graphciTool/DrawTool.js, line 193
+            engineExtensions/tools/graphciTool/DrawTool.js, line 184
         </div>
     </div>
@@ -341,7 +391,8 @@
     <div class="description">
-        <p>通过画区批量绘制模型</p>
+        <p>在面域范围内批量布设模型实例。</p>
+<p>该方法会先交互式绘制一个面域，再按指定间距在面内插值，并生成模型实例集合。</p>
     </div>
@@ -388,7 +439,7 @@
             <td class="description last">
+                <p>绘制与模型布设配置项。</p>
 <table class="params">
@@ -440,7 +491,7 @@
-                <p>绘制模型间距，单位米。</p></td>
+                <p>模型布设间距，单位米。</p></td>
         </tr>
@@ -474,7 +525,7 @@
-                <p>绘制类型，线、面。</p></td>
+                <p>绘制类型。</p></td>
         </tr>
@@ -508,7 +559,7 @@
-                <p>模型样式信息 详情参见<a href="Style.html#.ModelStyle"><code>Style.ModelStyle</code></a></p></td>
+                <p>模型样式信息，详见 <code>Style.ModelStyle</code>。</p></td>
         </tr>
@@ -542,7 +593,7 @@
-                <p>图元属性</p></td>
+                <p>图元属性。</p></td>
         </tr>
@@ -576,7 +627,7 @@
-                <p>图元名称</p></td>
+                <p>图元名称。</p></td>
         </tr>
@@ -612,7 +663,7 @@
-                <p>图元是否显示</p></td>
+                <p>图元是否显示。</p></td>
         </tr>
@@ -648,7 +699,7 @@
-                <p>默认为阻塞式更新，true为异步更新，false为阻塞式更新。</p></td>
+                <p>是否异步更新图元。</p></td>
         </tr>
@@ -739,7 +790,7 @@
     <pre class="prettyprint"><code>var url = '../../SampleData/models/CesiumMilkTruck/CesiumMilkTruck.glb';
 var tool = new zondy.cesium.DrawTool(viewer,graphicsLayer);
-tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10, url: url }});</code></pre>
+tool.DrawModelsByArea({type:'polygon',intervalDistance:100,style: { scale: 10, url: url }});</code></pre>
@@ -756,7 +807,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
         <div class="tag-source">
-            engineExtensions/tools/graphciTool/DrawTool.js, line 49
+            engineExtensions/tools/graphciTool/DrawTool.js, line 60
         </div>
     </div>
@@ -767,7 +818,8 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
     <div class="description">
-        <p>通过画线批量绘制模型</p>
+        <p>沿折线批量布设模型实例。</p>
+<p>该方法会先交互式绘制一条折线，再按指定间距在线上插值，并生成模型实例集合。</p>
     </div>
@@ -814,7 +866,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
             <td class="description last">
+                <p>绘制与模型布设配置项。</p>
 <table class="params">
@@ -866,7 +918,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>绘制模型间距，单位米。</p></td>
+                <p>模型布设间距，单位米。</p></td>
         </tr>
@@ -900,7 +952,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>绘制类型，线、面。</p></td>
+                <p>绘制类型。</p></td>
         </tr>
@@ -934,7 +986,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>模型样式信息 详情参见<a href="Style.html#.ModelStyle"><code>Style.ModelStyle</code></a></p></td>
+                <p>模型样式信息，详见 <code>Style.ModelStyle</code>。</p></td>
         </tr>
@@ -968,7 +1020,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>图元属性</p></td>
+                <p>图元属性。</p></td>
         </tr>
@@ -1002,7 +1054,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>图元名称</p></td>
+                <p>图元名称。</p></td>
         </tr>
@@ -1038,7 +1090,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>图元是否显示</p></td>
+                <p>图元是否显示。</p></td>
         </tr>
@@ -1074,7 +1126,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
-                <p>默认为阻塞式更新，true为异步更新，false为阻塞式更新。</p></td>
+                <p>是否异步更新图元。</p></td>
         </tr>
@@ -1182,7 +1234,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
         <div class="tag-source">
-            engineExtensions/tools/graphciTool/DrawTool.js, line 323
+            engineExtensions/tools/graphciTool/DrawTool.js, line 293
         </div>
     </div>
@@ -1193,7 +1245,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
     <div class="description">
-        <p>移除所有鼠标事件，停止绘制</p>
+        <p>移除当前绘制交互监听并关闭绘制状态。</p>
     </div>
@@ -1256,7 +1308,7 @@ tool.DrawModelsByLine({type:'polyline',intervalDistance:100,style: { scale: 10,
         <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>