npm - @mapgis/webclient-cesium-plugin - Versions diffs - 17.8.1 → 17.10.10 - Mend

@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.10

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

@@ -83,7 +83,7 @@
     <div class="nameContainer">
         <h4 class="name" id="GraphicsLayer">
-            new GraphicsLayer<span class="signature">(viewer, options)</span>
+            new GraphicsLayer<span class="signature">(viewer, <span class="optional">options</span>)</span>
         </h4>
@@ -94,42 +94,15 @@
     </div>
-    <p class="summary"><h5>支持如下方法：</h5>
-<a href='#startDrawing'>[1、开始绘制图形]</a><br/>
-<a href='#addGraphic'>[2、添加绘制图形]</a><br/>
-<a href='#addGraphic'>[3、添加绘制图形]</a><br/>
-<a href='#stopDrawing'>[4、移除所有鼠标事件，停止绘制]</a><br/>
-<a href='#startEdit'>[5、开始编辑]</a><br/>
-<a href='#stopEdit'>[6、停止编辑]</a><br/>
-<a href='#getGraphicByID'>[7、根据ID获取标绘图形对象]</a><br/>
-<a href='#getGraphicByName'>[8、根据name获取标绘图形对象]</a><br/>
-<a href='#getGraphicByGroupName'>[9、根据GroupName获取标绘图形对象]</a><br/>
-<a href='#getGraphicByIndex'>[10、根据序号获取标绘图形对象]</a><br/>
-<a href='#getIndexByGraphic'>[11、根据对象获取index]</a><br/>
-<a href='#getAllGraphic'>[12、获取图层所有标绘图形]</a><br/>
-<a href='#getTransformEditor'>[13、获取标绘模型编辑器]</a><br/>
-<a href='#removeGraphicByID'>[14、根据ID移除标绘图形]</a><br/>
-<a href='#removeGraphicByGroupName'>[15、根据GroupName移除一组标绘图形]</a><br/>
-<a href='#removeGraphicByIndex'>[16、根据序号移除标绘图形]</a><br/>
-<a href='#removeLastGraphic'>[17、移除最后一个标绘图形]</a><br/>
-<a href='#removePickingGraphic'>[18、移除选中标绘图形]</a><br/>
-<a href='#removeAllGraphic'>[19、移除是否成功]</a><br/>
-<a href='#exportToJson'>[20、整个图层导出为json文件]</a><br/>
-<a href='#calculateBoundingSphere'>[21、计算当前标绘图层的外包围球]</a><br/>
-<a href='#flyTo'>[22、跳转到该图层]</a><br/>
-<a href='#loadJson'>[23、加载json文件]</a><br/>
-<a href='#destroy'>[24、移除整个图层]</a><br/></p>
 </dt>
 <dd>
     <div class="description">
-        <p>标绘图层<br>
-请参考以下示例:<br>
-<a href='#example1'>1、初始化标绘图层</a><br>
-<a href='#example2'>2、重写提示框对象</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#tdGraphBase' target='_blank'>3、更多示例</a></p>
+        <p>标绘图层。</p>
+<p>该类用于管理 Cesium 场景中的标绘对象集合，提供绘制、编辑、查询、序列化与销毁等
+完整生命周期能力。适用于业务标绘、交互编辑和图层级批量管理场景。
+调用方可通过回调参数接入绘制结果、撤销操作和点击事件，构建自定义标绘工作流。</p>
     </div>
@@ -150,6 +123,8 @@
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -173,10 +148,19 @@
             </td>
+                <td class="default">
+                </td>
             <td class="description last">
-                <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>
@@ -196,10 +180,23 @@
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
-                <p>图层初始化参数</p>
+                        <span class="optional"> 可选</span>
+                <p>图层初始化参数。</p>
 <table class="params">
@@ -598,8 +595,9 @@
     <pre class="prettyprint"><code>// ES5引入方式
 const { GraphicsLayer } = zondy.cesium
 // ES6引入方式
-import { GraphicsLayer } from "@mapgis/webclient-cesium-plugin"
+import { GraphicsLayer } from '@mapgis/webclient-cesium-plugin'
 //初始化标绘图层
 const graphicsLayer = new GraphicsLayer(viewer, {
@@ -623,9 +621,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
   },
   //是否显示提示框
   enableToolTip: true
-});
-//添加标绘图层到图层管理器中
-viewer.scene.layers.appendGraphicsLayer(graphicsLayer);</code></pre>
+})</code></pre>
         <p class="code-caption"><h7 id='example2'>重写提示框对象</h7></p>
@@ -634,8 +630,9 @@ viewer.scene.layers.appendGraphicsLayer(graphicsLayer);</code></pre>
     <pre class="prettyprint"><code>// ES5引入方式
 const { GraphicsLayer } = zondy.cesium
 // ES6引入方式
-import { GraphicsLayer } from "@mapgis/webclient-cesium-plugin"
+import { GraphicsLayer } from '@mapgis/webclient-cesium-plugin'
 const graphicsLayer = new GraphicsLayer(viewer, {
   //重写鼠标移动提示事件，当toolTipDom存在时，只有两个回调参数
@@ -643,7 +640,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
      //你的提示事件
   },
   toolTipDom: "你的toolTipDom的DOM对象"
-});</code></pre>
+})</code></pre>
@@ -769,12 +766,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="addGraphic">
-            addGraphic<span class="signature">(graphic, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Graphic.html">Graphic</a>}</span>
+            addGraphic<span class="signature">(graphic, <span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Graphic.html">Graphic</a>}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 349
+            engineExtensions/graphic/GraphicsLayer.js, line 331
         </div>
     </div>
@@ -785,7 +782,9 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>添加绘制图形<a id='addGraphic'/></p>
+        <p>将一个已有图元加入当前图层。</p>
+<p>该方法会初始化图元与场景的绑定关系，并根据图元类型把 primitive、
+label、billboard 或 DIV 节点挂入场景。</p>
     </div>
@@ -806,6 +805,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -822,17 +823,26 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-<span class="param-type">Object</span>
+<span class="param-type"><a href="Graphic.html">Graphic</a></span>
             </td>
+                <td class="default">
+                </td>
             <td class="description last">
-                <p>不同类型实体参考：参见<a href="Graphic.html#.graphicType"><code>Graphic.graphicType</code></a></p></td>
+                <p>待加入图层的图元对象。</p></td>
         </tr>
@@ -852,10 +862,83 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
-                <p>额外参数</p></td>
+                        <span class="optional"> 可选</span>
+                <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>enablePointerEvents</code></td>
+            <td class="type">
+<span class="param-type">Boolean</span>
+            </td>
+                <td class="default">
+                    true
+                </td>
+            <td class="description last">
+                        <span class="optional"> 可选</span>
+                <p>对 DIV 图元是否启用鼠标事件穿透控制。</p></td>
+        </tr>
+	</tbody>
+</table>
+            </td>
         </tr>
@@ -920,7 +1003,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
-            <td class="description last">反回添加的图形</td>
+            <td class="description last">已加入图层的图元对象。</td>
         </tr>
     </tbody>
@@ -942,7 +1025,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1601
+            engineExtensions/graphic/GraphicsLayer.js, line 1521
         </div>
     </div>
@@ -953,7 +1036,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>计算当前标绘图层的外包围球<a id='calculateBoundingSphere'/></p>
+        <p>计算当前图层全部图元的外包围球。</p>
+<p>结果可用于视角跳转或整体范围评估。</p>
     </div>
@@ -1020,7 +1104,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
-            <td class="description last">外包围球。</td>
+            <td class="description last">图层当前内容的外包围球。</td>
         </tr>
     </tbody>
@@ -1042,7 +1126,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1699
+            engineExtensions/graphic/GraphicsLayer.js, line 1621
         </div>
     </div>
@@ -1053,7 +1137,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>移除整个图层<a id='destroy'/></p>
+        <p>销毁图层及其关联交互资源。</p>
+<p>该方法会清空图元、停止编辑，并注销图层级事件处理器。</p>
     </div>
@@ -1113,7 +1198,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1585
+            engineExtensions/graphic/GraphicsLayer.js, line 1502
         </div>
     </div>
@@ -1124,7 +1209,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>整个图层导出为json文件<a id='exportToJson'/></p>
+        <p>将整个图层序列化为 JSON 字符串。</p>
+<p>导出结果采用 <code>FeatureCollection</code> 结构，便于后续通过 <code>loadJson</code> 重新恢复。</p>
     </div>
@@ -1191,7 +1277,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
-            <td class="description last">json格式的字符串。</td>
+            <td class="description last">图层内容的 JSON 字符串。</td>
         </tr>
     </tbody>
@@ -1213,7 +1299,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1624
+            engineExtensions/graphic/GraphicsLayer.js, line 1545
         </div>
     </div>
@@ -1224,7 +1310,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>跳转到该图层<a id='flyTo'/></p>
+        <p>将相机飞行到当前图层范围。</p>
     </div>
@@ -1271,7 +1357,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>跳转参数，参见<code>Camera#flyToBoundingSphere</code></p></td>
+                <p>相机飞行参数，参见 <code>Camera#flyToBoundingSphere</code>。</p></td>
         </tr>
@@ -1324,12 +1410,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getAllGraphic">
-            getAllGraphic<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>}</span>
+            getAllGraphic<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;<a href="Graphic.html">Graphic</a>>}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1461
+            engineExtensions/graphic/GraphicsLayer.js, line 1363
         </div>
     </div>
@@ -1340,7 +1426,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>获取图层所有标绘图形<a id='getAllGraphic'/></p>
+        <p>返回图层中的全部标绘对象。</p>
     </div>
@@ -1403,11 +1489,11 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-                        Array.&lt;Object>
+                        Array.&lt;<a href="Graphic.html">Graphic</a>>
             </td>
-            <td class="description last">返回所有图形对象</td>
+            <td class="description last">当前图层维护的全部图元。</td>
         </tr>
     </tbody>
@@ -1424,12 +1510,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getGraphicByGroupName">
-            getGraphicByGroupName<span class="signature">(name)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>|Undefined}</span>
+            getGraphicByGroupName<span class="signature">(name)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;<a href="Graphic.html">Graphic</a>>|undefined}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1418
+            engineExtensions/graphic/GraphicsLayer.js, line 1316
         </div>
     </div>
@@ -1440,7 +1526,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>根据GroupName获取标绘图形对象<a id='getGraphicByGroupName'/></p>
+        <p>根据组名查询一组标绘对象。</p>
+<p>适用于模型组或业务分组场景下的批量检索。</p>
     </div>
@@ -1487,7 +1574,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>图形ID</p></td>
+                <p>图元组名。</p></td>
         </tr>
@@ -1548,14 +1635,14 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-                        Array.&lt;Object>
+                        Array.&lt;<a href="Graphic.html">Graphic</a>>
                          |
-                        Undefined
+                        undefined
             </td>
-            <td class="description last">返回对象组</td>
+            <td class="description last">命中的图元数组；无结果时返回 <code>undefined</code>。</td>
         </tr>
     </tbody>
@@ -1572,12 +1659,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getGraphicByID">
-            getGraphicByID<span class="signature">(id)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object|Undefined}</span>
+            getGraphicByID<span class="signature">(id)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Graphic.html">Graphic</a>|undefined}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1359
+            engineExtensions/graphic/GraphicsLayer.js, line 1255
         </div>
     </div>
@@ -1588,7 +1675,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>根据ID获取标绘图形对象<a id='getGraphicByID'/></p>
+        <p>根据图元 ID 查询图层中的标绘对象。</p>
+<p>对 <code>marker</code> 类型会同时匹配其主图元、文字和广告牌子对象的 ID。</p>
     </div>
@@ -1635,7 +1723,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>图形ID</p></td>
+                <p>图元 ID。</p></td>
         </tr>
@@ -1696,14 +1784,14 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-                        Object
+                        <a href="Graphic.html">Graphic</a>
                          |
-                        Undefined
+                        undefined
             </td>
-            <td class="description last">返回图层对象或者返回false查询失败</td>
+            <td class="description last">命中的图元对象；未找到时返回 <code>undefined</code>。</td>
         </tr>
     </tbody>
@@ -1720,12 +1808,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getGraphicByIndex">
-            getGraphicByIndex<span class="signature">(index)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object}</span>
+            getGraphicByIndex<span class="signature">(index)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Graphic.html">Graphic</a>|undefined}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1436
+            engineExtensions/graphic/GraphicsLayer.js, line 1335
         </div>
     </div>
@@ -1736,7 +1824,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>根据序号获取标绘图形对象<a id='getGraphicByIndex'/></p>
+        <p>根据图层内部索引获取图元。</p>
     </div>
@@ -1774,6 +1862,9 @@ const graphicsLayer = new GraphicsLayer(viewer, {
 <span class="param-type">String</span>
+|
+<span class="param-type">Number</span>
@@ -1783,7 +1874,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>图形序号</p></td>
+                <p>图层内部维护的图元索引。</p></td>
         </tr>
@@ -1844,11 +1935,14 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-                        Object
+                        <a href="Graphic.html">Graphic</a>
+                         |
+                        undefined
             </td>
-            <td class="description last">返回图形对象</td>
+            <td class="description last">对应的图元对象。</td>
         </tr>
     </tbody>
@@ -1865,12 +1959,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getGraphicByName">
-            getGraphicByName<span class="signature">(name, type)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>|Undefined}</span>
+            getGraphicByName<span class="signature">(name, <span class="optional">type</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;<a href="Graphic.html">Graphic</a>>|undefined}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1385
+            engineExtensions/graphic/GraphicsLayer.js, line 1280
         </div>
     </div>
@@ -1881,7 +1975,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>根据name获取标绘图形对象<a id='getGraphicByName'/></p>
+        <p>按名称查询图层中的标绘对象。</p>
+<p>支持精确匹配和模糊匹配两种模式，返回所有命中的图元。</p>
     </div>
@@ -1902,6 +1997,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -1925,10 +2022,19 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
+                <td class="default">
+                </td>
             <td class="description last">
-                <p>图形ID</p></td>
+                <p>图元名称。</p></td>
         </tr>
@@ -1948,10 +2054,23 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             </td>
+                <td class="default">
+                    'equal'
+                </td>
             <td class="description last">
-                <p>类型，equal、like</p></td>
+                        <span class="optional"> 可选</span>
+                <p>匹配模式，可选 <code>equal</code> 或 <code>like</code>。</p></td>
         </tr>
@@ -2012,14 +2131,14 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-                        Array.&lt;Object>
+                        Array.&lt;<a href="Graphic.html">Graphic</a>>
                          |
-                        Undefined
+                        undefined
             </td>
-            <td class="description last">返回对象组</td>
+            <td class="description last">命中的图元数组；无结果时返回 <code>undefined</code>。</td>
         </tr>
     </tbody>
@@ -2036,12 +2155,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getIndexByGraphic">
-            getIndexByGraphic<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Boolean}</span>
+            getIndexByGraphic<span class="signature">(value)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Number|Boolean}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1445
+            engineExtensions/graphic/GraphicsLayer.js, line 1346
         </div>
     </div>
@@ -2052,7 +2171,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>根据对象获取index<a id='getIndexByGraphic'/></p>
+        <p>反查图元在图层中的内部索引。</p>
     </div>
@@ -2061,6 +2180,51 @@ const graphicsLayer = new GraphicsLayer(viewer, {
+<table class="params">
+    <thead>
+	<tr>
+		<th>Name</th>
+		<th>Type</th>
+		<th class="last">Description</th>
+	</tr>
+	</thead>
+	<tbody>
+        <tr>
+                <td class="name"><code>value</code></td>
+            <td class="type">
+<span class="param-type"><a href="Graphic.html">Graphic</a></span>
+            </td>
+            <td class="description last">
+                <p>待查询的图元对象。</p></td>
+        </tr>
+	</tbody>
+</table>
 <dl class="details">
@@ -2115,11 +2279,14 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
+                        Number
+                         |
                         Boolean
             </td>
-            <td class="description last"></td>
+            <td class="description last">命中的索引值；未找到时返回 <code>false</code>。</td>
         </tr>
     </tbody>
@@ -2136,12 +2303,12 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="nameContainer">
         <h4 class="name" id="getTransformEditor">
-            getTransformEditor<span class="signature">(Graphic, getViewModel)</span>
+            getTransformEditor<span class="signature">(Graphic, getViewModel)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1471
+            engineExtensions/graphic/GraphicsLayer.js, line 1376
         </div>
     </div>
@@ -2152,7 +2319,8 @@ const graphicsLayer = new GraphicsLayer(viewer, {
     <div class="description">
-        <p>获取标绘模型编辑器<a id='getTransformEditor'/></p>
+        <p>获取指定模型图元的变换编辑器。</p>
+<p>调用前通常需要先开启编辑模式，再把模型编辑器需要的 view model 回调传入。</p>
     </div>
@@ -2189,7 +2357,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="type">
-<span class="param-type">Object</span>
+<span class="param-type"><a href="Graphic.html">Graphic</a></span>
@@ -2199,7 +2367,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>模型对象</p></td>
+                <p>需要编辑的模型图元。</p></td>
         </tr>
@@ -2222,7 +2390,7 @@ const graphicsLayer = new GraphicsLayer(viewer, {
             <td class="description last">
-                <p>模型编辑器回调函数</p></td>
+                <p>用于接收或构建编辑器 view model 的回调函数。</p></td>
         </tr>
@@ -2269,9 +2437,29 @@ const graphicsLayer = new GraphicsLayer(viewer, {
-Object 返回标绘模型编辑器
+<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>
@@ -2284,12 +2472,12 @@ Object 返回标绘模型编辑器
     <div class="nameContainer">
         <h4 class="name" id="initGraphic">
-            initGraphic<span class="signature">(options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Graphi}</span>
+            initGraphic<span class="signature">(options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Graphic.html">Graphic</a>}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1719
+            engineExtensions/graphic/GraphicsLayer.js, line 1644
         </div>
     </div>
@@ -2300,7 +2488,8 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>初始化Graphic对象</p>
+        <p>根据配置创建并初始化一个 <code>Graphic</code> 对象。</p>
+<p>返回对象已与当前 viewer 建立绑定，可直接继续加入图层或参与绘制流程。</p>
     </div>
@@ -2347,7 +2536,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>初始化参数</p></td>
+                <p>图元初始化参数。</p></td>
         </tr>
@@ -2408,11 +2597,11 @@ Object 返回标绘模型编辑器
             <td class="type">
-                        Graphi
+                        <a href="Graphic.html">Graphic</a>
             </td>
-            <td class="description last">初始化的Graphi对象</td>
+            <td class="description last">已完成初始化的图元对象。</td>
         </tr>
     </tbody>
@@ -2434,7 +2623,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1636
+            engineExtensions/graphic/GraphicsLayer.js, line 1557
         </div>
     </div>
@@ -2445,7 +2634,9 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>加载json文件<a id='loadJson'/></p>
+        <p>从 JSON 字符串恢复图层内容。</p>
+<p>该方法支持恢复普通图元和模型组数据，输入格式需与 <code>exportToJson</code>
+的输出保持一致。</p>
     </div>
@@ -2492,7 +2683,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>json格式的字符串。</p></td>
+                <p>图层序列化得到的 JSON 字符串。</p></td>
         </tr>
@@ -2550,7 +2741,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1558
+            engineExtensions/graphic/GraphicsLayer.js, line 1472
         </div>
     </div>
@@ -2561,7 +2752,8 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>移除图层所有标绘图形<a id='removeAllGraphic'/></p>
+        <p>清空图层中的全部标绘对象。</p>
+<p>该方法会停止编辑状态、移除所有 primitive，并重置图层内部索引计数。</p>
     </div>
@@ -2628,7 +2820,7 @@ Object 返回标绘模型编辑器
             </td>
-            <td class="description last">移除是否成功</td>
+            <td class="description last">始终返回 <code>true</code>，表示清空流程已执行。</td>
         </tr>
     </tbody>
@@ -2650,7 +2842,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1496
+            engineExtensions/graphic/GraphicsLayer.js, line 1405
         </div>
     </div>
@@ -2661,7 +2853,8 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>根据GroupName移除一组标绘图形<a id='removeGraphicByGroupName'/></p>
+        <p>根据组名批量移除一组标绘对象。</p>
+<p>该方法会同时删除图层中同组名的 primitive 集合。</p>
     </div>
@@ -2708,7 +2901,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>组名</p></td>
+                <p>组名。</p></td>
         </tr>
@@ -2766,7 +2959,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1482
+            engineExtensions/graphic/GraphicsLayer.js, line 1388
         </div>
     </div>
@@ -2777,7 +2970,7 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>根据ID移除标绘图形<a id='removeGraphicByID'/></p>
+        <p>根据图元 ID 移除标绘对象。</p>
     </div>
@@ -2824,7 +3017,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>图形ID</p></td>
+                <p>图元 ID。</p></td>
         </tr>
@@ -2847,7 +3040,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>不使用自带的remove</p></td>
+                <p>是否跳过图元自身的 <code>remove</code> 流程。</p></td>
         </tr>
@@ -2905,7 +3098,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1523
+            engineExtensions/graphic/GraphicsLayer.js, line 1432
         </div>
     </div>
@@ -2916,7 +3109,8 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>根据序号移除标绘图形<a id='removeGraphicByIndex'/></p>
+        <p>根据内部索引移除图元。</p>
+<p>若目标图元正在编辑，会先终止编辑流程，再执行图元移除。</p>
     </div>
@@ -2954,6 +3148,9 @@ Object 返回标绘模型编辑器
 <span class="param-type">String</span>
+|
+<span class="param-type">Number</span>
@@ -2963,7 +3160,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
-                <p>图形序号</p></td>
+                <p>图层内部维护的图元索引。</p></td>
         </tr>
@@ -3021,7 +3218,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1542
+            engineExtensions/graphic/GraphicsLayer.js, line 1452
         </div>
     </div>
@@ -3032,7 +3229,7 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>移除最后一个标绘图形<a id='removeLastGraphic'/></p>
+        <p>移除最近一次加入图层的图元。</p>
     </div>
@@ -3092,7 +3289,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1549
+            engineExtensions/graphic/GraphicsLayer.js, line 1460
         </div>
     </div>
@@ -3103,7 +3300,7 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>移除选中标绘图形<a id='removePickingGraphic'/></p>
+        <p>移除当前编辑工具选中的图元。</p>
     </div>
@@ -3163,7 +3360,7 @@ Object 返回标绘模型编辑器
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 278
+            engineExtensions/graphic/GraphicsLayer.js, line 255
         </div>
     </div>
@@ -3174,7 +3371,10 @@ Object 返回标绘模型编辑器
     <div class="description">
-        <p>开始绘制图形 (注意：内部会开始地形深度检测功能)<a id='startDrawing'/></p>
+        <p>启动交互式标绘流程。</p>
+<p>该方法会切换鼠标交互状态、销毁图层级点击响应，并根据 <code>type</code>
+进入对应的点、线、面、模型或 DIV 绘制流程。绘制结束后可通过
+<code>getGraphic</code> 回调获取结果。</p>
     </div>
@@ -3221,7 +3421,7 @@ Object 返回标绘模型编辑器
             <td class="description last">
+                <p>绘制配置。</p>
 <table class="params">
@@ -3275,7 +3475,7 @@ Object 返回标绘模型编辑器
-                <p>绘制类型：参照<a href="Graphic.html#.graphicType"><code>Graphic.graphicType</code></a></p></td>
+                <p>绘制类型，参见 <a href="Graphic.html#.graphicType"><code>Graphic.graphicType</code></a>。</p></td>
         </tr>
@@ -3311,7 +3511,7 @@ Object 返回标绘模型编辑器
-                <p>是否连续绘制</p></td>
+                <p>是否在完成一个图元后继续保持绘制状态。</p></td>
         </tr>
@@ -3347,7 +3547,7 @@ Object 返回标绘模型编辑器
-                <p>是否绘制高度，当为true时使用鼠标绘制高度，当为false时使用参数设置的统一高度</p></td>
+                <p>是否通过鼠标交互采集高度；关闭时使用样式中的统一高度。</p></td>
         </tr>
@@ -3381,7 +3581,7 @@ Object 返回标绘模型编辑器
-                <p>图元样式信息 详情参见<a href="Style.html"><code>Style</code></a></p></td>
+                <p>新建图元的样式配置，详情参见 <a href="Style.html"><code>Style</code></a>。</p></td>
         </tr>
@@ -3415,7 +3615,7 @@ Object 返回标绘模型编辑器
-                <p>编辑点样式信息 详情参见<a href="Style.html#.EditPointStyle"><code>Style.EditPointStyle</code></a></p></td>
+                <p>控制点样式配置，详情参见 <a href="Style.html#.EditPointStyle"><code>Style.EditPointStyle</code></a>。</p></td>
         </tr>
@@ -3449,7 +3649,7 @@ Object 返回标绘模型编辑器
-                <p>图元属性</p></td>
+                <p>新建图元附带的业务属性。</p></td>
         </tr>
@@ -3483,7 +3683,7 @@ Object 返回标绘模型编辑器
-                <p>图元名称</p></td>
+                <p>新建图元名称。</p></td>
         </tr>
@@ -3519,7 +3719,7 @@ Object 返回标绘模型编辑器
-                <p>图元是否显示</p></td>
+                <p>新建图元是否默认显示。</p></td>
         </tr>
@@ -3555,7 +3755,7 @@ Object 返回标绘模型编辑器
-                <p>默认为阻塞式更新，true为异步更新，false为阻塞式更新。</p></td>
+                <p>是否使用异步 primitive 更新。</p></td>
         </tr>
@@ -3591,7 +3791,7 @@ Object 返回标绘模型编辑器
-                <p>偏航角，弧度。</p></td>
+                <p>偏航角，单位为弧度。</p></td>
         </tr>
@@ -3627,7 +3827,7 @@ Object 返回标绘模型编辑器
-                <p>俯仰角，弧度。</p></td>
+                <p>俯仰角，单位为弧度。</p></td>
         </tr>
@@ -3663,7 +3863,7 @@ Object 返回标绘模型编辑器
-                <p>翻滚角，弧度。</p></td>
+                <p>翻滚角，单位为弧度。</p></td>
         </tr>
@@ -3699,7 +3899,7 @@ Object 返回标绘模型编辑器
-                <p>局部坐标系X方向平移量，单位米，X方向为纬线方向</p></td>
+                <p>局部坐标系 X 方向平移量，单位米。</p></td>
         </tr>
@@ -3735,7 +3935,7 @@ Object 返回标绘模型编辑器
-                <p>局部坐标系Y方向平移量，单位米，Y方向为经线方向</p></td>
+                <p>局部坐标系 Y 方向平移量，单位米。</p></td>
         </tr>
@@ -3771,7 +3971,7 @@ Object 返回标绘模型编辑器
-                <p>局部坐标系Z方向平移量，单位米，Z方向为垂直地表方向</p></td>
+                <p>局部坐标系 Z 方向平移量，单位米。</p></td>
         </tr>
@@ -3828,7 +4028,6 @@ Object 返回标绘模型编辑器
     <pre class="prettyprint"><code>//初始化标绘图层
 var graphicsLayer = new zonndy.cesium.GraphicsLayer(viewer, {});
-viewer.scene.layers.appendGraphicsLayer(graphicsLayer);
 //开始绘制Marker
 graphicsLayer.startDrawing({
     type: 'marker',
@@ -3884,7 +4083,7 @@ graphicsLayer.startDrawing({
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1340
+            engineExtensions/graphic/GraphicsLayer.js, line 1230
         </div>
     </div>
@@ -3895,7 +4094,8 @@ graphicsLayer.startDrawing({
     <div class="description">
-        <p>开始编辑<a id='startEdit'/></p>
+        <p>激活图层的编辑工具。</p>
+<p>调用后可对已存在的图元执行选中、拖拽、控制点调整等编辑操作。</p>
     </div>
@@ -3955,7 +4155,7 @@ graphicsLayer.startDrawing({
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1273
+            engineExtensions/graphic/GraphicsLayer.js, line 1160
         </div>
     </div>
@@ -3966,7 +4166,9 @@ graphicsLayer.startDrawing({
     <div class="description">
-        <p>移除所有鼠标事件，停止绘制<a id='stopDrawing'/></p>
+        <p>停止当前绘制流程并恢复图层交互状态。</p>
+<p>该方法会移除绘制阶段注册的鼠标事件、销毁提示框，并清理尚未提交到图层的
+临时图元。</p>
     </div>
@@ -4026,7 +4228,7 @@ graphicsLayer.startDrawing({
         <div class="tag-source">
-            engineExtensions/graphic/GraphicsLayer.js, line 1347
+            engineExtensions/graphic/GraphicsLayer.js, line 1240
         </div>
     </div>
@@ -4037,7 +4239,8 @@ graphicsLayer.startDrawing({
     <div class="description">
-        <p>停止编辑<a id='stopEdit'/></p>
+        <p>停止当前编辑流程。</p>
+<p>若编辑工具已激活，会同步结束当前选中图元的编辑状态。</p>
     </div>
@@ -4100,7 +4303,7 @@ graphicsLayer.startDrawing({
         <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 Fri Sep 18 2026 14:59:30 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>