@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.10

package/{documention → documentation}/TriangulationTool.html

@@ -88,7 +88,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/tools/TriangulationTool.js, line 3
+            engineExtensions/tools/TriangulationTool.js, line 8
         </div>
         
     </div>
@@ -99,7 +99,9 @@
     
     
     <div class="description">
-        <p>三角测量工具</p>
+        <p>三角测量工具。</p>
+<p>该工具负责在 Cesium 场景中管理三角高程量算流程，并封装连续绘制、
+标注提示与结果清理控制。</p>
     </div>
     
 
@@ -146,7 +148,7 @@
             
             <td class="description last">
                 
-                <p>视图</p></td>
+                <p>Cesium 视图对象。</p></td>
         </tr>
 	
 	
@@ -169,7 +171,7 @@
             
             <td class="description last">
                 
-                <p>包含以下属性的对象</p>
+                <p>三角测量配置项。</p>
                 
 
 <table class="params">
@@ -223,7 +225,7 @@
                         
                     
                 
-                <p>回调函数</p></td>
+                <p>量算结束回调。</p></td>
         </tr>
 	
 	
@@ -259,7 +261,7 @@
                         
                     
                 
-                <p>测量完毕后提示框的回调函数，可以覆盖提示内容</p></td>
+                <p>标注内容回调，用于覆盖默认提示文字。</p></td>
         </tr>
 	
 	
@@ -295,7 +297,7 @@
                         
                     
                 
-                <p>只要小于这个距离深度检测就会失效，就会一直显示在最前面 不会被遮挡</p></td>
+                <p>小于该距离时禁用深度检测，使标注保持前置显示。</p></td>
         </tr>
 	
 	
@@ -329,7 +331,7 @@
                         
                     
                 
-                <p>线颜色</p></td>
+                <p>线颜色。</p></td>
         </tr>
 	
 	
@@ -363,7 +365,7 @@
                         
                     
                 
-                <p>点颜色</p></td>
+                <p>点颜色。</p></td>
         </tr>
 	
 	
@@ -397,7 +399,7 @@
                         
                     
                 
-                <p>线材质</p></td>
+                <p>线材质。</p></td>
         </tr>
 	
 	
@@ -433,7 +435,7 @@
                         
                     
                 
-                <p>label 文字的样式，支持填充、线框。填充和线框， FILL, OUTLINE, FILL_AND_OUTLINE</p></td>
+                <p>label 文字样式，支持 <code>FILL</code>、<code>OUTLINE</code>、<code>FILL_AND_OUTLINE</code>。</p></td>
         </tr>
 	
 	
@@ -469,7 +471,7 @@
                         
                     
                 
-                <p>label 的字体以及大小 @see <a href="https://html.spec.whatwg.org/multipage/canvas.html#text-styles">https://html.spec.whatwg.org/multipage/canvas.html#text-styles</a></p></td>
+                <p>label 字体与字号。</p></td>
         </tr>
 	
 	
@@ -505,7 +507,7 @@
                         
                     
                 
-                <p>label 的字体颜色</p></td>
+                <p>label 文字颜色。</p></td>
         </tr>
 	
 	
@@ -541,7 +543,7 @@
                         
                     
                 
-                <p>label 文字线框的颜色</p></td>
+                <p>label 描边颜色。</p></td>
         </tr>
 	
 	
@@ -577,7 +579,7 @@
                         
                     
                 
-                <p>label 的外轮廓边线</p></td>
+                <p>label 外轮廓宽度。</p></td>
         </tr>
 	
 	
@@ -613,7 +615,7 @@
                         
                     
                 
-                <p>label 的摆放位置</p></td>
+                <p>label 摆放位置。</p></td>
         </tr>
 	
 	
@@ -649,7 +651,7 @@
                         
                     
                 
-                <p>是否显示 label 的背景</p></td>
+                <p>是否显示 label 背景。</p></td>
         </tr>
 	
 	
@@ -685,7 +687,7 @@
                         
                     
                 
-                <p>lable 背景的颜色</p></td>
+                <p>label 背景色。</p></td>
         </tr>
 	
 	
@@ -721,7 +723,7 @@
                         
                     
                 
-                <p>label 相对于设定点的偏移位置</p></td>
+                <p>label 相对锚点的屏幕偏移。</p></td>
         </tr>
 	
 	
@@ -757,7 +759,7 @@
                         
                     
                 
-                <p>是否显示详细信息。默认显示。</p></td>
+                <p>是否显示详细量算信息。</p></td>
         </tr>
 	
 	
@@ -793,7 +795,7 @@
                         
                     
                 
-                <p>展示信息时是否使用绝对值。默认不使用。</p></td>
+                <p>展示信息时是否使用绝对值。</p></td>
         </tr>
 	
 	
@@ -829,7 +831,7 @@
                         
                     
                 
-                <p>是否启用标签随视角高度缩放功能</p></td>
+                <p>是否启用标签随视角高度缩放。</p></td>
         </tr>
 	
 	
@@ -865,7 +867,7 @@
                         
                     
                 
-                <p>标签大小随视角高度缩放函数，用户可自定义，不传则使用默认函数,会传入一个当前的相机视角高度,返回一个NearFarScale函数对象，详见下方示例</p></td>
+                <p>标签随视角高度缩放的自定义函数。</p></td>
         </tr>
 	
 	
@@ -901,7 +903,7 @@
                         
                     
                 
-                <p>是否连续绘制，true：是，false：否</p></td>
+                <p>是否连续绘制。</p></td>
         </tr>
 	
 	
@@ -937,7 +939,43 @@
                         
                     
                 
-                <p>是否显示多个测量结果，true：是，false：否</p></td>
+                <p>是否显示多个量算结果。</p></td>
+        </tr>
+	
+	
+	
+        <tr>
+            
+                <td class="name"><code>enableAvoidance</code></td>
+            
+            
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+            
+            </td>
+            
+            
+                <td class="default">
+                
+                    false
+                
+                </td>
+            
+            
+            <td class="description last">
+                
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>是否开启量算结果标签避让。</p></td>
         </tr>
 	
 	
@@ -1001,61 +1039,62 @@
     
     <pre class="prettyprint"><code>// ES5引入方式
 const { TriangulationTool } = zondy.cesium
+
 // ES6引入方式
 import { TriangulationTool } from "@mapgis/webclient-cesium-plugin"
 
-function callBack(arg){
+function callBack(arg) {
 }
-var triangulationToolMul = new TriangulationTool(viewer,{
-    callBack:callBack,
-    scaleByDistance: function(height) {
-        if (height < 30) {
-            return new NearFarScalar(30, 3, 180, 0);
-        } else if (height < 60) {
-            return new NearFarScalar(60, 3, 360, 0);
-        } else if (height < 120) {
-            return new NearFarScalar(120, 3, 720, 0);
-        } else if (height < 240) {
-            return new NearFarScalar(240, 2, 1200, 0);
-        } else if (height < 480) {
-            return new NearFarScalar(480, 2, 2400, 0);
-        } else if (height < 960) {
-            return new NearFarScalar(960, 2, 4800, 0);
-        } else if (height < 1920) {
-            return new NearFarScalar(1920, 2, 9600, 0);
-        } else if (height < 3840) {
-            return new NearFarScalar(3840, 2, 19200, 0);
-        } else if (height < 7680) {
-            return new NearFarScalar(7680, 2, 38400, 0);
-        } else if (height < 15360) {
-            return new NearFarScalar(15360, 2, 76800, 0);
-        } else if (height < 30720) {
-            return new NearFarScalar(30720, 2, 153600, 0);
-        } else if (height < 61440) {
-            return new NearFarScalar(61440, 2, 307200, 0);
-        } else if (height < 122880) {
-            return new NearFarScalar(122880, 2, 614400, 0);
-        } else if (height < 245760) {
-            return new NearFarScalar(245760, 2, 1228800, 0);
-        } else if (height < 491520) {
-            return new NearFarScalar(491520, 2, 2457600, 0);
-        } else if (height < 983040) {
-            return new NearFarScalar(983040, 2, 4915200, 0);
-        } else if (height < 1966080) {
-            return new NearFarScalar(1966080, 2, 9830400, 0);
-        } else if (height < 3932160) {
-            return new NearFarScalar(3932160, 1, 19660800, 0);
-        } else if (height < 7864320) {
-            return new NearFarScalar(7864320, 1, 39321600, 0);
-        } else if (height < 15728640) {
-            return new NearFarScalar(15728640, 1, 78643200, 0);
-        }
-        return new NearFarScalar(15728640, 1, 78643200, 0);
+var triangulationToolMul = new TriangulationTool(viewer, {
+  callBack: callBack,
+  scaleByDistance: function(height) {
+    if (height < 30) {
+      return new NearFarScalar(30, 3, 180, 0)
+    } else if (height < 60) {
+      return new NearFarScalar(60, 3, 360, 0)
+    } else if (height < 120) {
+      return new NearFarScalar(120, 3, 720, 0)
+    } else if (height < 240) {
+      return new NearFarScalar(240, 2, 1200, 0)
+    } else if (height < 480) {
+      return new NearFarScalar(480, 2, 2400, 0)
+    } else if (height < 960) {
+      return new NearFarScalar(960, 2, 4800, 0)
+    } else if (height < 1920) {
+      return new NearFarScalar(1920, 2, 9600, 0)
+    } else if (height < 3840) {
+      return new NearFarScalar(3840, 2, 19200, 0)
+    } else if (height < 7680) {
+      return new NearFarScalar(7680, 2, 38400, 0)
+    } else if (height < 15360) {
+      return new NearFarScalar(15360, 2, 76800, 0)
+    } else if (height < 30720) {
+      return new NearFarScalar(30720, 2, 153600, 0)
+    } else if (height < 61440) {
+      return new NearFarScalar(61440, 2, 307200, 0)
+    } else if (height < 122880) {
+      return new NearFarScalar(122880, 2, 614400, 0)
+    } else if (height < 245760) {
+      return new NearFarScalar(245760, 2, 1228800, 0)
+    } else if (height < 491520) {
+      return new NearFarScalar(491520, 2, 2457600, 0)
+    } else if (height < 983040) {
+      return new NearFarScalar(983040, 2, 4915200, 0)
+    } else if (height < 1966080) {
+      return new NearFarScalar(1966080, 2, 9830400, 0)
+    } else if (height < 3932160) {
+      return new NearFarScalar(3932160, 1, 19660800, 0)
+    } else if (height < 7864320) {
+      return new NearFarScalar(7864320, 1, 39321600, 0)
+    } else if (height < 15728640) {
+      return new NearFarScalar(15728640, 1, 78643200, 0)
     }
-});
-triangulationToolMul.startTool();  //开始测量
-//triangulationToolMul.stopTool(); //结束测量
-scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
+    return new NearFarScalar(15728640, 1, 78643200, 0)
+  }
+})
+triangulationToolMul.startTool()
+// triangulationToolMul.stopTool()
+scene.camera.enableTerrainAdjustmentWhenLoading = false</code></pre>
     
 
     
@@ -1092,7 +1131,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
         
         <div class="tag-source">
-            engineExtensions/tools/TriangulationTool.js, line 223
+            engineExtensions/tools/TriangulationTool.js, line 234
         </div>
         
     </div>
@@ -1103,7 +1142,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
     
     <div class="description">
-        <p>清除所有测量结果，仍可绘制（绘制事件仍然是激活状态）</p>
+        <p>清除全部三角测量结果，并在允许连续绘制时重新进入激活状态。</p>
     </div>
     
 
@@ -1163,7 +1202,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
         
         <div class="tag-source">
-            engineExtensions/tools/TriangulationTool.js, line 113
+            engineExtensions/tools/TriangulationTool.js, line 123
         </div>
         
     </div>
@@ -1174,7 +1213,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
     
     <div class="description">
-        <p>开始测量</p>
+        <p>激活三角测量流程并创建当前绘制工具。</p>
     </div>
     
 
@@ -1234,7 +1273,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
         
         <div class="tag-source">
-            engineExtensions/tools/TriangulationTool.js, line 204
+            engineExtensions/tools/TriangulationTool.js, line 215
         </div>
         
     </div>
@@ -1245,7 +1284,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
     
     
     <div class="description">
-        <p>结束测量，测量工具处于不能绘制(不激活状态)</p>
+        <p>停止三角测量。</p>
     </div>
     
 
@@ -1307,7 +1346,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
                         
                     
                 
-                <p>是否保留测量结果。默认为false不保留测量结果</p></td>
+                <p>是否保留当前量算结果；默认 <code>false</code>，会同时清理结果与交互状态。</p></td>
         </tr>
 	
 	
@@ -1368,7 +1407,7 @@ scene.camera.enableTerrainAdjustmentWhenLoading = false;</code></pre>
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:55 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Sep 18 2026 14:59:31 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>