@mapgis/webclient-cesium-plugin 17.8.0 → 17.10.9

package/{documention → documentation}/GlobeIndependentTranslucency.html

@@ -152,7 +152,7 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
             <td class="type">
             
                 
-<span class="param-type">Viewer</span>
+<span class="param-type"><a href="Cesium.Viewer.html">Cesium.Viewer</a></span>
 
 
             
@@ -213,7 +213,71 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
     
 
     
-    <pre class="prettyprint"><code>// 参考示例：
    new Cesium.SingleTileImageryProvider({
        url: 'http://10.10.130.72:8089/igs/rest/services/Tile/湖北省_4326_custom_1-8/TileServer/tileImage/2/0/0?f=image',
        rectangle: Cesium.Rectangle.fromDegrees(108.34522, 25.48750, 116.13094, 33.27322)
    })
    position: Cesium.Cartesian3.fromDegrees(114.0, 30.5, -40000),
    box: {
        dimensions: new Cesium.Cartesian3(4.0e5, 4.0e5, 3.0e4),
        material: Cesium.Color.RED,
        outline: true,
        outlineColor: Cesium.Color.BLACK
    }
    position: Cesium.Cartesian3.fromDegrees(114.0, 30.5, 40000),,
    box: {
        dimensions: new Cesium.Cartesian3(2.0e5, 2.0e5, 3.0e4),
        material: Cesium.Color.GREEN.withAlpha(0.5),
        outline: true,
        outlineColor: Cesium.Color.BLACK
    }
+    <pre class="prettyprint"><code>// 参考示例：
+http://10.10.130.72:8086/#/modules/cesium/sceneControl/scene/globe-independent-translucency
+
+// ES5引入方式
+const { GlobeIndependentTranslucency } = zondy.cesium
+
+// ES6引入方式
+import { GlobeIndependentTranslucency } from "@mapgis/webclient-cesium-plugin"
+
+// 初始化视图对象，若不指定影像图层则会默认使用SingleTileImageryProvider加载一张地表影像图
+let viewer = new Cesium.Viewer("cesiumContainer");
+
+// 添加影像图层
+let hubei_4326 = viewer.imageryLayers.addImageryProvider(
+    new Cesium.SingleTileImageryProvider({
+        url: 'http://10.10.130.72:8089/igs/rest/services/Tile/湖北省_4326_custom_1-8/TileServer/tileImage/2/0/0?f=image',
+        rectangle: Cesium.Rectangle.fromDegrees(108.34522, 25.48750, 116.13094, 33.27322)
+    })
+);
+
+// 实例化地表透明对象
+let independentTranslucency = new GlobeIndependentTranslucency(viewer);
+// 以数组的形式添加需要单独控制透明度的影像图层
+independentTranslucency.imageryLayers = [hubei_4326];
+// 开启地表透明
+independentTranslucency.enabled = true;
+
+// 注意：以下内容非必需，在此仅用于在示例中展示开启地表透明后的影像图层地上地下效果
+// 开启地形深度测试
+viewer.scene.globe.depthTestAgainstTerrain = true;
+// 隐藏地表大气层
+viewer.scene.globe.showGroundAtmosphere = false;
+// 隐藏天空盒
+viewer.scene.skyBox.show = false;
+// 隐藏天空大气层
+viewer.scene.skyAtmosphere.show = false;
+// 隐藏太阳
+viewer.scene.sun.show = false;
+// 隐藏月亮
+viewer.scene.moon.show = false;
+
+// 加载地下实体
+viewer.entities.add({
+    position: Cesium.Cartesian3.fromDegrees(114.0, 30.5, -40000),
+    box: {
+        dimensions: new Cesium.Cartesian3(4.0e5, 4.0e5, 3.0e4),
+        material: Cesium.Color.RED,
+        outline: true,
+        outlineColor: Cesium.Color.BLACK
+    }
+});
+
+// 加载地上实体
+viewer.entities.add({
+    position: Cesium.Cartesian3.fromDegrees(114.0, 30.5, 40000),
+    box: {
+        dimensions: new Cesium.Cartesian3(2.0e5, 2.0e5, 3.0e4),
+        material: Cesium.Color.GREEN.withAlpha(0.5),
+        outline: true,
+        outlineColor: Cesium.Color.BLACK
+    }
+});
+
+// 关闭地表透明
+independentTranslucency.enabled = false;</code></pre>
     
 
     
@@ -553,7 +617,16 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
         
 
     
-    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+
+// 设置不受地表透明影响的影像图层
+independentTranslucency.imageryLayers = [layer1, layer2];
+
+// 设置地表透明度为0.5，layer1和layer2不受影响
+independentTranslucency.globeFaceAlpha = 0.5;
+
+// 当globeFaceAlpha不为undefined时，globeFaceAlphaByDistance将不再生效
+independentTranslucency.globeFaceAlphaByDistance = new Cesium.NearFarScalar(3.0e5, 0.0, 5.0e6, 1.0);</code></pre>
     
 
     
@@ -609,7 +682,11 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
         
 
     
-    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+
+// 使用globeFaceAlphaByDistance时要确保globeFaceAlpha的值为undefined
+independentTranslucency.globeFaceAlpha = undefined;
+independentTranslucency.globeFaceAlphaByDistance = new Cesium.NearFarScalar(3.0e5, 0.0, 5.0e6, 1.0);</code></pre>
     
 
     
@@ -665,7 +742,13 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
         
 
     
-    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+    <pre class="prettyprint"><code>let independentTranslucency = new Cesium.GlobeIndependentTranslucency(viewer);
+
+// 当imageryLayers数组不为空时，使用的是单独控制地表透明的方式，layer1和layer2将不受地表透明的影响
+independentTranslucency.imageryLayers = [layer1, layer2];
+
+// 当imageryLayers数组为空时，使用的是原生的控制地表透明的方式，所有的影像图层都会参与地表透明混合计算
+independentTranslucency.imageryLayers = [];</code></pre>
     
 
     
@@ -737,7 +820,7 @@ viewer.scene.globe.translucency依然能够使用，但两者同时使用时会
 
 
         <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}/GodPerspective.html

@@ -88,7 +88,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/tools/routeAnimationTool/RouteAnimationPerspective.js, line 97
+            engineExtensions/tools/routeAnimationTool/RouteAnimationPerspective.js, line 103
         </div>
         
     </div>
@@ -99,7 +99,7 @@
     
     
     <div class="description">
-        <p>上帝视角</p>
+        <p>上帝视角。</p>
     </div>
     
 
@@ -120,6 +120,8 @@
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -143,6 +145,12 @@
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
@@ -153,7 +161,7 @@
                         
                     
                 
-                <p>可选参数</p>
+                <p>视角初始化参数。</p>
                 
 
 <table class="params">
@@ -207,7 +215,7 @@
                         
                     
                 
-                <p>航向角</p></td>
+                <p>航向角。</p></td>
         </tr>
 	
 	
@@ -243,7 +251,7 @@
                         
                     
                 
-                <p>距离</p></td>
+                <p>相机距离。</p></td>
         </tr>
 	
 	
@@ -431,7 +439,7 @@
 
 
         <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>