@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.10

package/{documention → documentation}/SceneView.html

@@ -83,44 +83,26 @@
     <div class="nameContainer">
         <h4 class="name" id="SceneView">
             
-            new SceneView<span class="signature">(options)</span>
+            new SceneView<span class="signature">(<span class="optional">options</span>)</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 43
+            view/SceneView.js, line 42
         </div>
         
     </div>
 
     
-    <p class="summary"><h5>支持如下方法：</h5>
-<a href='#flyTo'>[1、视点跳转]</a><br/>
-<a href='#toJSON'>[2、导出场景视图的配置文件]</a><br/>
-<a href='#fromJSON'>[3、通过一个配置生成一个场景视图对象]</a><br/>
-<a href='#toMap'>[4、屏幕像素坐标点转地理坐标点]</a><br/>
-<a href='#toScreen'>[5、地理坐标点转屏幕像素坐标点]</a><br/>
-<a href='#getSize'>[6、获取当前视图容器的宽高]</a><br/>
-<a href='#getCenter'>[7、获取当前视图中心点]</a><br/>
-<a href='#getExtent'>[8、获取当前视图的地理范围]</a><br/>
-<a href='#getZoom'>[9、获取当前层级]</a><br/>
-<a href='#getScale'>[10、获取当前比例尺]</a><br/>
-<code>11、注册事件</code><br/>
-<code>12、移除事件</code><br/>
-<a href='#getInnerLayer'>[15、获取实际的M3DSet对象]</a><br/>
-<a href='#setCenter'>[16、设置缩视野中心]</a><br/>
-<a href='#setExtent'>[17、设置视图的地理范围]</a><br/>
-<a href='#takeScreenshot'>[18、屏幕快照]</a><br/>
-<a href='#hitTest'>[19、图元检测]</a><br/>
-<a href='#destroy'>[20、销毁视图对象]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>场景视图类<br/>
-继承自<a href='http://10.10.130.72:8086/static/modules/common/api/common-mapgis/SceneView.html' target='_blank'>zondy.SceneView</a></p>
+        <p>Cesium 引擎下的三维场景视图。</p>
+<p>该类是 <code>@mapgis/webclient-common</code> 中 <code>SceneView</code> 的 Cesium 端具体实现，负责管理三维场景容器、
+视图定位、屏幕坐标与地理坐标转换、图元拾取、屏幕快照以及图层视图联动等能力。
+通常与 <code>Map</code>、各类三维图层和交互工具配合使用，是 Cesium 场景展示与交互的核心视图对象。</p>
     </div>
     
 
@@ -141,6 +123,8 @@
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -164,10 +148,23 @@
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>构造参数</p>
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>构造参数。</p>
                 
 
 <table class="params">
@@ -219,7 +216,7 @@
                         
                     
                 
-                <p>图层管理器</p></td>
+                <p>视图关联的地图对象，用于管理底图、业务图层和覆盖物图层。</p></td>
         </tr>
 	
 	
@@ -253,7 +250,7 @@
                         
                     
                 
-                <p>图层容器ID</p></td>
+                <p>场景容器的 DOM ID。未传入 <code>innerView</code> 时，会基于该容器创建 Cesium <code>Viewer</code>。</p></td>
         </tr>
 	
 	
@@ -287,7 +284,7 @@
                         
                     
                 
-                <p>实际三维引擎的场景 cesium对应viewer</p></td>
+                <p>外部传入的原生 Cesium <code>Viewer</code> 实例。传入后将复用已有引擎对象，不再由当前类创建。</p></td>
         </tr>
 	
 	
@@ -301,6 +298,12 @@
             
                 
 <span class="param-type">Point</span>
+|
+
+<span class="param-type">Object</span>
+|
+
+<span class="param-type">Array</span>
 
 
             
@@ -309,7 +312,7 @@
             
                 <td class="default">
                 
-                    new Point({coordinates:[105.1250000000032,24.427133220306196]})
+                    new Point({ coordinates: [105.1250000000032, 24.427133220306196] })
                 
                 </td>
             
@@ -323,7 +326,7 @@
                         
                     
                 
-                <p>地图视图中心点。如果中心点有高度，则优先使用中心点（经纬高）定位；如果中心点没有高度，看是否存在zoom/scale，使用center和zoom/scale定位（同时设置scale和zoom时，scale优先于zoom），否则默认zoom为到底3级。如果没有设置center，设置extent，则以extent定位。</p></td>
+                <p>视图初始中心点。若中心点包含高程，则优先按经纬高定位；若不包含高程，则结合 <code>scale</code> 或 <code>zoom</code> 计算相机高度。</p></td>
         </tr>
 	
 	
@@ -345,6 +348,8 @@
             
                 <td class="default">
                 
+                    36978669.4318207
+                
                 </td>
             
             
@@ -357,7 +362,7 @@
                         
                     
                 
-                <p>地图视图比例尺。如果scale、zoom、extent都未设置，那么初始化scale默认scale为36978669.4318207。</p></td>
+                <p>视图初始比例尺。仅在未显式传入高程中心点时参与定位计算；当同时传入 <code>scale</code> 和 <code>zoom</code> 时，<code>scale</code> 优先。</p></td>
         </tr>
 	
 	
@@ -391,7 +396,7 @@
                         
                     
                 
-                <p>地图视图层级。如果scale和zoom都未设置。</p></td>
+                <p>视图初始层级。仅在未传入 <code>scale</code> 且中心点不含高程时参与定位。</p></td>
         </tr>
 	
 	
@@ -405,6 +410,9 @@
             
                 
 <span class="param-type">Extent</span>
+|
+
+<span class="param-type">Object</span>
 
 
             
@@ -425,7 +433,7 @@
                         
                     
                 
-                <p>场景视图初始所在的范围。如果没有设置center，但设置extent了，则地图视图定位到extent范围内。</p></td>
+                <p>视图初始范围。当未传入 <code>center</code> 时，可通过范围进行初始定位。</p></td>
         </tr>
 	
 	
@@ -459,7 +467,7 @@
                         
                     
                 
-                <p>地图视图的最大比例尺（比例尺的分母，该值越小，比例尺越大）。视图的当前比列尺不会大于地图视图的最大比例尺。默认值为undefined，undefined表示用户未设置，地图视图会根据当前加载的图层，自动计算maxScale、minScale的值。如果用户设置了该值，则地图视图将直接采用用户设置的值。maxScale的值应该始终小于minScale的值。</p></td>
+                <p>视图允许达到的最大比例尺分母。数值越小表示放得越近；若设置该值，会优先转换为对应的最大层级限制。</p></td>
         </tr>
 	
 	
@@ -493,7 +501,7 @@
                         
                     
                 
-                <p>地图视图的最小比例尺（比例尺的分母，该值越大，比例尺越小）。视图的当前比列尺不会小于地图视图的最小比例尺。默认值为undefined，undefined表示用户未设置，地图视图会根据当前加载的图层，自动计算maxScale、minScale的值。如果用户设置了该值，则地图视图将直接采用用户设置的值。minScale的值应该始终大于maxScale的值。</p></td>
+                <p>视图允许达到的最小比例尺分母。数值越大表示看得越远；若设置该值，会优先转换为对应的最小层级限制。</p></td>
         </tr>
 	
 	
@@ -527,7 +535,7 @@
                         
                     
                 
-                <p>最大缩放级数 。优先级低于maxScale</p></td>
+                <p>最大缩放级数。优先级低于 <code>maxScale</code>。</p></td>
         </tr>
 	
 	
@@ -561,7 +569,7 @@
                         
                     
                 
-                <p>最小缩放级数。优先级低于minScale</p></td>
+                <p>最小缩放级数。优先级低于 <code>minScale</code>。</p></td>
         </tr>
 	
 	
@@ -595,7 +603,7 @@
                         
                     
                 
-                <p>地图弹框</p></td>
+                <p>视图弹窗配置或弹窗实例。</p></td>
         </tr>
 	
 	
@@ -631,7 +639,7 @@
                         
                     
                 
-                <p>初始化视图的额外参数，可以通过该参数传入引擎原生的构造参数</p></td>
+                <p>透传给原生 Cesium <code>Viewer</code> 的附加构造参数。</p></td>
         </tr>
 	
 	
@@ -667,7 +675,7 @@
                         
                     
                 
-                <p>商标缩放系数。默认为1倍，图标大小为宽98px、高28px。</p></td>
+                <p>引擎商标缩放系数。默认按 1 倍显示，对应宽 98px、高 28px。</p></td>
         </tr>
 	
 	
@@ -703,7 +711,7 @@
                         
                     
                 
-                <p>是否在视图构造时根据视图的center、scale、zoom、extent属性进行视图范围的设置</p></td>
+                <p>是否在构造完成后根据 <code>center</code>、<code>scale</code>、<code>zoom</code>、<code>extent</code> 自动执行一次初始定位。</p></td>
         </tr>
 	
 	
@@ -746,19 +754,19 @@
     
     <h5>Fires</h5>
     <ul>
-        <li>BaseView#event:鼠标点击事件</li>
+        <li>BaseView#event:click</li>
     
-        <li>BaseView#event:鼠标双击事件</li>
+        <li>BaseView#event:immediate-click</li>
     
-        <li>BaseView#event:鼠标按下事件</li>
+        <li>BaseView#event:double-click</li>
     
-        <li>BaseView#event:鼠标抬起事件</li>
+        <li>BaseView#event:mouse-down</li>
     
-        <li>BaseView#event:鼠标右键点击事件</li>
+        <li>BaseView#event:mouse-up</li>
     
-        <li>BaseView#event:鼠标移动事件</li>
+        <li>BaseView#event:mouse-move</li>
     
-        <li>BaseView#event:地图视图改变事件</li>
+        <li>BaseView#event:view-change</li>
     </ul>
     
 
@@ -773,49 +781,40 @@
     
         <h5>Examples</h5>
         
-        <p class="code-caption"><h7>初始化三维视图对象</h7></p>
-    
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map } from "@mapgis/webclient-common"
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+
+// ES6 引入方式
+import { Map } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-3d-viewer",
-  // 图层管理容器
-  map: map
-});</code></pre>
+  viewId: 'mapgis-3d-viewer',
+  map
+})</code></pre>
     
 
-        <p class="code-caption"><h7>外部初始化三维视图对象</h7></p>
-    
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map } from "@mapgis/webclient-common"
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-const map = new Map();
-let innerView = new Cesium.Viewer(viewId);
-// 初始化地图视图对象
+
+// ES6 引入方式
+import { Map } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
+const innerView = new Cesium.Viewer('mapgis-3d-viewer')
 const sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-3d-viewer",
-  // 图层管理容器
-  map: map,
-  // 外部创建的三方cesium对象
-  innerView: innerView
-});</code></pre>
+  viewId: 'mapgis-3d-viewer',
+  map,
+  innerView
+})</code></pre>
     
 
     
@@ -860,7 +859,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图中心点</p>
+        <p>当前场景视图中心点。</p>
+<p>该值来源于初始化参数或运行时相机位置换算结果；读取时会根据当前相机位置动态更新。</p>
     </div>
     
     
@@ -905,7 +905,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>引擎类型，为'cesium'</p>
+        <p>当前视图使用的底层引擎类型。</p>
     </div>
     
     
@@ -950,7 +950,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>初始化视图的额外参数，可以通过该参数传入引擎原生的构造参数</p>
+        <p>原生 Cesium Viewer 的附加构造参数。</p>
     </div>
     
     
@@ -995,7 +995,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图范围</p>
+        <p>当前场景视图地理范围。</p>
+<p>该值会在相机移动结束后根据当前可视区域动态更新。</p>
     </div>
     
     
@@ -1040,7 +1041,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图高度</p>
+        <p>当前视图容器高度，单位像素。</p>
     </div>
     
     
@@ -1085,7 +1086,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>商标缩放系数</p>
+        <p>Cesium 商标缩放系数。</p>
     </div>
     
     
@@ -1122,7 +1123,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="maxZoom">maxZoom<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="maxScale">maxScale<span class="type-signature type number">Number</span> </h4>
     </div>
     
     
@@ -1130,7 +1131,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图最大层级</p>
+        <p>当前场景视图允许达到的最大比例尺分母。</p>
+<p>数值越小表示放得越近。未设置时由视图结合当前图层状态自动计算；若显式传入，则优先使用该值并换算为对应的最大层级限制。</p>
     </div>
     
     
@@ -1167,7 +1169,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="minZoom">minZoom<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="maxZoom">maxZoom<span class="type-signature type number">Number</span> </h4>
     </div>
     
     
@@ -1175,7 +1177,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图最小层级</p>
+        <p>允许缩放到的最大层级。</p>
     </div>
     
     
@@ -1212,7 +1214,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="popup">popup<span class="type-signature type popup"><a href="Popup.html">Popup</a></span> </h4>
+        <h4 class="name" id="minScale">minScale<span class="type-signature type number">Number</span> </h4>
     </div>
     
     
@@ -1220,7 +1222,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图弹框popup</p>
+        <p>当前场景视图允许达到的最小比例尺分母。</p>
+<p>数值越大表示看得越远。未设置时由视图结合当前图层状态自动计算；若显式传入，则优先使用该值并换算为对应的最小层级限制。</p>
     </div>
     
     
@@ -1257,7 +1260,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="scale">scale<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="minZoom">minZoom<span class="type-signature type number">Number</span> </h4>
     </div>
     
     
@@ -1265,7 +1268,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图比例尺</p>
+        <p>允许缩放到的最小层级。</p>
     </div>
     
     
@@ -1302,7 +1305,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="spatialReference">spatialReference<span class="type-signature type spatialreference">SpatialReference</span> </h4>
+        <h4 class="name" id="popup">popup<span class="type-signature type popup"><a href="Popup.html">Popup</a></span> </h4>
     </div>
     
     
@@ -1310,7 +1313,7 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>视图空间参考系</p>
+        <p>当前视图绑定的弹窗对象。</p>
     </div>
     
     
@@ -1347,7 +1350,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="stationary">stationary<span class="type-signature type boolean">Boolean</span> </h4>
+        <h4 class="name" id="scale">scale<span class="type-signature type number">Number</span> </h4>
     </div>
     
     
@@ -1355,7 +1358,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图是否静止</p>
+        <p>当前场景视图比例尺。</p>
+<p>比例尺会根据当前层级动态计算；写入时会触发视图重定位。</p>
     </div>
     
     
@@ -1392,7 +1396,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="width">width<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="spatialReference">spatialReference<span class="type-signature type spatialreference">SpatialReference</span> </h4>
     </div>
     
     
@@ -1400,7 +1404,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图宽度</p>
+        <p>视图空间参考系。</p>
+<p>Cesium 三维场景内部统一使用 EPSG:4326 作为经纬度空间参考系，对外只读。</p>
     </div>
     
     
@@ -1437,7 +1442,7 @@ const sceneView = new SceneView({
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="zoom">zoom<span class="type-signature type number">Number</span> </h4>
+        <h4 class="name" id="stationary">stationary<span class="type-signature type boolean">Boolean</span> </h4>
     </div>
     
     
@@ -1445,7 +1450,8 @@ const sceneView = new SceneView({
 <dd>
     
     <div class="description">
-        <p>地图视图层级</p>
+        <p>标识当前视图是否处于静止状态。</p>
+<p>当相机开始移动时为 <code>false</code>，移动结束后恢复为 <code>true</code>。</p>
     </div>
     
     
@@ -1478,91 +1484,21 @@ const sceneView = new SceneView({
     
 </dd>
 
-        </dl>
-    
-
-    
-
-    
-        <h3 class="subsection-title">Methods</h3>
         
-        <dl>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id=".fromJSON">
-            
-            SceneView.fromJSON<span class="signature">(json)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="SceneView.html">SceneView</a>}</span>
-        </h4>
-    
-        
-        <div class="tag-source">
-            view/SceneView.js, line 2315
-        </div>
-        
+        <h4 class="name" id="width">width<span class="type-signature type number">Number</span> </h4>
     </div>
-
+    
     
 </dt>
 <dd>
     
-    
     <div class="description">
-        <p><a id='fromJSON'></a>
-通过一个配置生成一个场景视图对象</p>
+        <p>当前视图容器宽度，单位像素。</p>
     </div>
     
-
-    
-    
-    
-    
-    
-        
-
-<table class="params">
-    <thead>
-	<tr>
-		
-		<th>Name</th>
-		
-		
-		<th>Type</th>
-		
-		
-		
-		<th class="last">Description</th>
-	</tr>
-	</thead>
-	
-	<tbody>
-	
-	
-        <tr>
-            
-                <td class="name"><code>json</code></td>
-            
-            
-            <td class="type">
-            
-                
-<span class="param-type">Object</span>
-
-
-            
-            </td>
-            
-            
-            
-            <td class="description last">
-                
-                <p>场景视图配置</p></td>
-        </tr>
-	
-	
-	</tbody>
-</table>
-    
     
     
 <dl class="details">
@@ -1591,59 +1527,74 @@ const sceneView = new SceneView({
 
     
     
+</dd>
 
+        
+            
+<dt>
+    <div class="nameContainer">
+        <h4 class="name" id="zoom">zoom<span class="type-signature type number">Number</span> </h4>
+    </div>
     
-
     
+</dt>
+<dd>
     
+    <div class="description">
+        <p>当前场景视图层级。</p>
+<p>层级由相机高度换算得到，写入后会同步更新相机高度并触发视图跳转。</p>
+    </div>
     
     
     
-    <h5>Returns:</h5>
+<dl class="details">
     
-
-
-<table class="params">
-    <thead>
-    <tr>
         
-        <th>Type</th>
-        <th class="last">Description</th>
-    </tr>
-    </thead>
-    <tbody>
     
-        <tr>
-            
-            <td class="type">
-            
-                        <a href="SceneView.html">SceneView</a>
-                        
-                    
-            </td>
-            <td class="description last"></td>
-        </tr>
     
-    </tbody>
-</table>
+    
 
     
     
     
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+</dl>
+
+    
+    
 </dd>
 
+        </dl>
+    
+
+    
+
+    
+        <h3 class="subsection-title">Methods</h3>
         
+        <dl>
             
 <dt>
     <div class="nameContainer">
         <h4 class="name" id="destroy">
             
-            destroy<span class="signature">()</span>
+            destroy<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>.&lt;void>}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 2017
+            view/SceneView.js, line 1897
         </div>
         
     </div>
@@ -1654,7 +1605,9 @@ const sceneView = new SceneView({
     
     
     <div class="description">
-        <p>销毁视图对象<a id='destroy'></a></p>
+        <p><a id='destroy'></a>
+销毁当前视图对象。</p>
+<p>调用后会释放父类视图资源并销毁底层 Cesium <code>Viewer</code>，不应继续使用当前实例。</p>
     </div>
     
 
@@ -1699,6 +1652,35 @@ const sceneView = new SceneView({
     
     
     
+    <h5>Returns:</h5>
+    
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        <a href="Promise.html">Promise</a>.&lt;void>
+                        
+                    
+            </td>
+            <td class="description last">视图销毁完成后的 Promise。</td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
     
     
 </dd>
@@ -1714,7 +1696,7 @@ const sceneView = new SceneView({
     
         
         <div class="tag-source">
-            view/SceneView.js, line 718
+            view/SceneView.js, line 654
         </div>
         
     </div>
@@ -1725,7 +1707,8 @@ const sceneView = new SceneView({
     
     
     <div class="description">
-        <p>视点跳转</p>
+        <p><a id='flyTo'></a>
+视点跳转</p>
     </div>
     
 
@@ -2218,33 +2201,33 @@ const sceneView = new SceneView({
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
 const { IGSMapImageLayer } = zondy.layer
 const { LayerEventType } = zondy.Enum
 const { Extent } = zondy.geometry
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map, SceneView, IGSMapImageLayer, LayerEventType, Extent } from "@mapgis/webclient-common"
-import { SceneView} from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+
+// ES6 引入方式
+import {
+  Map,
+  IGSMapImageLayer,
+  LayerEventType,
+  Extent
+} from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-3d-viewer",
-  // 图层管理容器
-  map: map
-});
-// 添加一个地图图层
-const igsMapImageLayer = new IGSMapImageLayer({
+  viewId: 'mapgis-3d-viewer',
+  map
+})
+const layer = new IGSMapImageLayer({
   url: 'http://192.168.82.89:8089/igs/rest/services/Map/Hubei4326/MapServer'
-});
-map.add(igsMapImageLayer);
-// 图层加载完毕
-igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
-  console.log("加载完毕:", result.layer)
-  // 视点跳转
+})
+
+map.add(layer)
+layer.on(LayerEventType.layerViewCreated, () => {
   sceneView.flyTo({
     extent: new Extent({
       xmin: 108.34341,
@@ -2256,39 +2239,26 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
 })</code></pre>
     
 
-        <p class="code-caption"><h7>跳转中心点</h7></p>
+        <p class="code-caption"><h7>按中心点跳转</h7></p>
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
-const { IGSMapImageLayer } = zondy.layer
-const { LayerEventType } = zondy.Enum
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map, IGSMapImageLayer, LayerEventType } from "@mapgis/webclient-common"
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+
+// ES6 引入方式
+import { Map } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-3d-viewer",
-  // 图层管理容器
-  map: map
-});
-// 添加一个地图图层
-const igsMapImageLayer = new IGSMapImageLayer({
-  url: 'http://192.168.82.89:8089/igs/rest/services/Map/Hubei4326/MapServer'
-});
-map.add(igsMapImageLayer);
-// 图层加载完毕
-igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
-  console.log("加载完毕:", result.layer)
-  // 视点跳转
-  sceneView.flyTo({
-    center: [113, 30, 1000000]
-  })
+  viewId: 'mapgis-3d-viewer',
+  map
+})
+
+sceneView.flyTo({
+  center: [113, 30, 1000000]
 })</code></pre>
     
 
@@ -2301,12 +2271,12 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     <div class="nameContainer">
         <h4 class="name" id="getCenter">
             
-            getCenter<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Object}</span>
+            getCenter<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Point|undefined}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1273
+            view/SceneView.js, line 1163
         </div>
         
     </div>
@@ -2318,7 +2288,8 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
     <div class="description">
         <p><a id='getCenter'></a>
-获取当前视图中心点</p>
+获取当前视图中心点。</p>
+<p>返回值来源于当前相机位置换算结果，包含经度、纬度和相机高度信息。</p>
     </div>
     
 
@@ -2381,11 +2352,14 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
             
             <td class="type">
             
-                        Object
+                        Point
+                         | 
+                    
+                        undefined
                         
                     
             </td>
-            <td class="description last">当前视图容器的宽高对象</td>
+            <td class="description last">当前视图中心点；视图尚未初始化完成时返回 <code>undefined</code>。</td>
         </tr>
     
     </tbody>
@@ -2402,12 +2376,12 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     <div class="nameContainer">
         <h4 class="name" id="getExtent">
             
-            getExtent<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Extent}</span>
+            getExtent<span class="signature">()</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Extent|undefined}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1321
+            view/SceneView.js, line 1215
         </div>
         
     </div>
@@ -2419,7 +2393,8 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
     <div class="description">
         <p><a id='getExtent'></a>
-获取当前视图的地理范围<a id='getExtent'></a></p>
+获取当前视图范围。</p>
+<p>范围由当前相机可视区域动态计算得到，返回结果的空间参考系与视图保持一致。</p>
     </div>
     
 
@@ -2483,10 +2458,13 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
             <td class="type">
             
                         Extent
+                         | 
+                    
+                        undefined
                         
                     
             </td>
-            <td class="description last">获取当前视图的地理范围</td>
+            <td class="description last">当前视图范围；视图尚未初始化完成时返回 <code>undefined</code>。</td>
         </tr>
     
     </tbody>
@@ -2508,7 +2486,7 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1909
+            view/SceneView.js, line 1786
         </div>
         
     </div>
@@ -2519,7 +2497,8 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
     
     <div class="description">
-        <p>获取当前比例尺</p>
+        <p><a id='getScale'></a>
+获取当前比例尺</p>
     </div>
     
 
@@ -2608,7 +2587,7 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1261
+            view/SceneView.js, line 1147
         </div>
         
     </div>
@@ -2620,7 +2599,8 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
     <div class="description">
         <p><a id='getSize'></a>
-获取当前视图容器的宽高，单位像素<a id='getSize'></a></p>
+获取当前视图容器的宽高。</p>
+<p>返回值单位为像素，可用于计算视图布局、截图范围或自定义屏幕坐标换算逻辑。</p>
     </div>
     
 
@@ -2687,7 +2667,7 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
                         
                     
             </td>
-            <td class="description last">当前视图容器的宽高对象</td>
+            <td class="description last">视图容器尺寸对象，包含 <code>x</code> 和 <code>y</code> 两个属性。</td>
         </tr>
     
     </tbody>
@@ -2709,7 +2689,7 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1851
+            view/SceneView.js, line 1729
         </div>
         
     </div>
@@ -2720,7 +2700,8 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
     
     <div class="description">
-        <p>获取当前层级</p>
+        <p><a id='getZoom'></a>
+获取当前层级</p>
     </div>
     
 
@@ -2809,7 +2790,7 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
         
         <div class="tag-source">
-            view/SceneView.js, line 862
+            view/SceneView.js, line 781
         </div>
         
     </div>
@@ -3299,50 +3280,44 @@ igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map } from "@mapgis/webclient-common"
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-map = new .Map();
-// 初始化地图视图对象
-sceneView = new SceneView({
-  // 视图id
-  viewId: "view-id",
-  // 图层管理容器
-  map: map
-});
-// 视点跳转
+
+// ES6 引入方式
+import { Map } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
+const sceneView = new SceneView({
+  viewId: 'view-id',
+  map
+})
+
 sceneView.goTo({
-  // 跳转中心点
   center: [115.47643872463577, 30.980700423496124],
-  // 地图层级
   zoom: 8
-});</code></pre>
+})</code></pre>
     
 
         <p class="code-caption"><h7>按范围跳转示例</h7></p>
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
 const { Extent, Circle } = zondy.geometry
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { Map, Extent, Circle } from "@mapgis/webclient-common"
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-// 初始化图层管理容器
-map = new Map();
-// 初始化地图视图对象
-sceneView = new SceneView({
-  // 视图id
-  viewId: "view-id",
-  // 图层管理容器
-  map: map
-});
+
+// ES6 引入方式
+import { Map, Extent, Circle } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
+const sceneView = new SceneView({
+  viewId: 'view-id',
+  map
+})
 const extent1 = new Extent({
   xmin: 111.88463529230717,
   ymin: 28.646934514163803,
@@ -3352,14 +3327,14 @@ const extent1 = new Extent({
 const geometry2 = new Circle({
   center: [111, 29],
   radius: 100,
-  radiusUnit: "kilometers",
+  radiusUnit: 'kilometers'
 })
 sceneView
   .goTo({
-    target: [extent1, geometry2],
+    target: [extent1, geometry2]
   })
   .then(() => {
-    console.log("gotoExtent callback")
+    console.log('gotoExtent callback')
   })</code></pre>
     
 
@@ -3372,12 +3347,12 @@ sceneView
     <div class="nameContainer">
         <h4 class="name" id="hitTest">
             
-            hitTest<span class="signature">(screenPoint)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array}</span>
+            hitTest<span class="signature">(screenPoint)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1432
+            view/SceneView.js, line 1291
         </div>
         
     </div>
@@ -3388,7 +3363,10 @@ sceneView
     
     
     <div class="description">
-        <p>穿透检测，图元拾取。目前支持graphic类型拾取结果，支持图层类型GraphicLayer，FeatureLayer。</p>
+        <p><a id='hitTest'></a>
+根据屏幕像素坐标执行图元拾取。支持拾取的图层类型有GraphicLayer，IGSFeatureLayer,GeoJSONLayer, WFSLayer，M3DModelCacheLayer, Cesium3DTilesCacheLayer, IGSSceneLayer,ISSceneLayer。</p>
+<p>适用于点击查询、悬停高亮等交互场景。当前支持几何图层、要素图层以及模型缓存/场景图层的拾取结果解析。
+对于 10.7.4.10 及以后版本中的外置属性模型缓存数据，结果里的 <code>graphic</code> 可能为 <code>Promise</code>。</p>
     </div>
     
 
@@ -3435,7 +3413,7 @@ sceneView
             
             <td class="description last">
                 
-                <p>屏幕像素坐标点，例如{ x: 900, y: 500 }</p></td>
+                <p>屏幕像素坐标点，例如 <code>{ x: 900, y: 500 }</code>。</p></td>
         </tr>
 	
 	
@@ -3496,11 +3474,11 @@ sceneView
             
             <td class="type">
             
-                        Array
+                        Array.&lt;Object>
                         
                     
             </td>
-            <td class="description last">图元检测结果。备注：10.7.4.10及以后中，对于外置属性的模型缓存数据，拾取结果中的graphic为Promise对象，其他均为Feature对象。</td>
+            <td class="description last">图元检测结果数组，结果项中通常包含 <code>graphic</code>、<code>layer</code>、<code>mapPoint</code>、<code>type</code> 等信息。</td>
         </tr>
     
     </tbody>
@@ -3511,48 +3489,41 @@ sceneView
     
         <h5>Example</h5>
         
-        <p class="code-caption"><h7>根据基础图层对象或者图层id查询并返回实际图层</h7></p>
+        <p class="code-caption"><h7>屏幕位置拾取图元</h7></p>
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map, Feature } = zondy
-const { Point, Polygon, MultiPolygon ,Extent } = zondy.geometry
-const { GraphicsLayer, IGSFeatureLayer, IGSTileLayer } = zondy.layer
+const { Point } = zondy.geometry
+const { GraphicsLayer } = zondy.layer
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { SceneView } from "@mapgis/webclient-leaflet-plugin";
-import { Map, Point, Polygon, MultiPolygon ,Extent, GraphicsLayer, Feature, Circle, IGSFeatureLayer, IGSTileLayer } from "@mapgis/webclient-common";
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
-this.sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-3d-viewer",
-  // 图层管理容器
-  map: map,
+
+// ES6 引入方式
+import { Map, Point, GraphicsLayer, Feature } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
+const sceneView = new SceneView({
+  viewId: 'mapgis-3d-viewer',
+  map
 })
-// 创建一个要素
-const feature = [
-  new Feature({
-    id: '11111',
-    geometry: new Point({ coordinates: [113, 30] }),
-  }),
-  new Feature({
-    id: '11112',
-    geometry: new Point({ coordinates: [113, 30.15] }),
-  }),
-  new Feature({
-    id: '11112',
-    geometry: new Point({ coordinates: [113, 35] }),
-  }),
-]
-// 初始化几何图层
 const graphicsLayer = new GraphicsLayer({
-  graphics:feature
+  graphics: [
+    new Feature({
+      id: '11111',
+      geometry: new Point({ coordinates: [113, 30] })
+    }),
+    new Feature({
+      id: '11112',
+      geometry: new Point({ coordinates: [113, 30.15] })
+    })
+  ]
 })
-map.add(this.graphicsLayer)
-const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
+
+map.add(graphicsLayer)
+const result = sceneView.hitTest({ x: 1000, y: 600 })
+console.log(result)</code></pre>
     
 
     
@@ -3564,12 +3535,12 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     <div class="nameContainer">
         <h4 class="name" id="setCenter">
             
-            setCenter<span class="signature">(value)</span>
+            setCenter<span class="signature">(value)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{void}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1293
+            view/SceneView.js, line 1185
         </div>
         
     </div>
@@ -3581,7 +3552,8 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
     <div class="description">
         <p><a id='setCenter'></a>
-设置缩视野中心<a id='setCenter'></a></p>
+设置当前视图中心点。</p>
+<p>设置后会保留已有高程或使用传入高程，并立即触发一次视图跳转。</p>
     </div>
     
 
@@ -3619,6 +3591,9 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
             
                 
 <span class="param-type">Point</span>
+|
+
+<span class="param-type">Array.&lt;Number></span>
 
 
             
@@ -3628,7 +3603,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
             
             <td class="description last">
                 
-                <p>视图中心</p></td>
+                <p>视图中心点，支持传入 <code>Point</code> 实例或 <code>[x, y]</code> / <code>[x, y, z]</code> 数组。</p></td>
         </tr>
 	
 	
@@ -3671,6 +3646,35 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
     
     
+    <h5>Returns:</h5>
+    
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        void
+                        
+                    
+            </td>
+            <td class="description last"></td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
     
     
 </dd>
@@ -3681,12 +3685,12 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     <div class="nameContainer">
         <h4 class="name" id="setExtent">
             
-            setExtent<span class="signature">(value)</span>
+            setExtent<span class="signature">(value)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{void}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1350
+            view/SceneView.js, line 1247
         </div>
         
     </div>
@@ -3698,7 +3702,8 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
     <div class="description">
         <p><a id='setExtent'></a>
-设置视图的地理范围，设置后会跳转到该范围</p>
+设置视图范围并跳转到该范围。</p>
+<p>适用于按业务范围快速重定位视图，调用后会同步更新内部缓存的范围状态。</p>
     </div>
     
 
@@ -3745,7 +3750,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
             
             <td class="description last">
                 
-                <p>视图的地理范围</p></td>
+                <p>目标范围。</p></td>
         </tr>
 	
 	
@@ -3788,6 +3793,35 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
     
     
+    <h5>Returns:</h5>
+    
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        void
+                        
+                    
+            </td>
+            <td class="description last"></td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
     
     
 </dd>
@@ -3798,12 +3832,12 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     <div class="nameContainer">
         <h4 class="name" id="takeScreenshot">
             
-            takeScreenshot<span class="signature">(<span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>}</span>
+            takeScreenshot<span class="signature">(<span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>.&lt;Object>}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 2002
+            view/SceneView.js, line 1844
         </div>
         
     </div>
@@ -3814,7 +3848,9 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
     
     <div class="description">
-        <p>屏幕快照</p>
+        <p><a id='takeScreenshot'></a>
+对当前场景执行屏幕快照。</p>
+<p>可用于导出当前视图画面，支持指定图片格式、截图范围和是否自动下载。</p>
     </div>
     
 
@@ -3876,7 +3912,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>屏幕快照配置配置</p>
+                <p>屏幕快照配置。</p>
                 
 
 <table class="params">
@@ -3930,7 +3966,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>图片格式，支持png，jpeg格式</p></td>
+                <p>图片格式，支持 <code>png</code> 和 <code>jpeg</code>。</p></td>
         </tr>
 	
 	
@@ -3966,7 +4002,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>下载文件名</p></td>
+                <p>下载文件名。</p></td>
         </tr>
 	
 	
@@ -4000,7 +4036,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>图片宽度</p></td>
+                <p>输出图片宽度。</p></td>
         </tr>
 	
 	
@@ -4034,7 +4070,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>图片高度</p></td>
+                <p>输出图片高度。</p></td>
         </tr>
 	
 	
@@ -4068,7 +4104,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>图片原点x</p></td>
+                <p>截图原点的横向像素坐标。</p></td>
         </tr>
 	
 	
@@ -4102,7 +4138,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>图片原点y</p></td>
+                <p>截图原点的纵向像素坐标。</p></td>
         </tr>
 	
 	
@@ -4138,7 +4174,7 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
                         
                     
                 
-                <p>是否下载图片</p></td>
+                <p>是否在生成快照后自动下载图片。</p></td>
         </tr>
 	
 	
@@ -4205,11 +4241,11 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
             
             <td class="type">
             
-                        <a href="Promise.html">Promise</a>
+                        <a href="Promise.html">Promise</a>.&lt;Object>
                         
                     
             </td>
-            <td class="description last">屏幕快照 {dataUrl String }，且浏览器会下载图片</td>
+            <td class="description last">屏幕快照结果，通常包含 <code>dataUrl</code> 等数据。</td>
         </tr>
     
     </tbody>
@@ -4224,29 +4260,28 @@ const result = this.sceneView.hitTest({x:1000,y:600})</code></pre>
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
-var { Map, SceneView } = zondy
-var { PictureFormat } = zondy.Enum
-// ES6引入方式
-import { Map, SceneView } from "@mapgis/webclient-cesium-plugin"
-import { PictureFormat } from "@mapgis/webclient-common"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+    <pre class="prettyprint"><code>// ES5 引入方式
+const { Map } = zondy
+const { SceneView } = zondy.cesium
+const { PictureFormat } = zondy.Enum
+
+// ES6 引入方式
+import { Map, PictureFormat } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
-  // 二维场景视图的容器(html的div标签)ID
-  viewId: "二维场景视图的容器的id",
-  // 图层管理容器
-  map: map
+  viewId: 'mapgis-3d-viewer',
+  map
 })
-// 设置屏幕快照参数
-const screenshotOptions: {
-   format: PictureFormat.PNG
+
+const screenshotOptions = {
+  format: PictureFormat.PNG,
+  isDownload: false
 }
-// 开始屏幕快照
+
 sceneView.takeScreenshot(screenshotOptions).then((result) => {
-  // 获取base64格式的url字符串
-  console.log("dataUrl:", result.dataUrl)
+  console.log('dataUrl:', result.dataUrl)
 })</code></pre>
     
 
@@ -4264,7 +4299,7 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1162
+            view/SceneView.js, line 1040
         </div>
         
     </div>
@@ -4275,8 +4310,8 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
     
     
     <div class="description">
-        <p><a id='toJSON'></a>
-导出场景视图的配置文件</p>
+        <p>导出当前场景视图的 JSON 配置。</p>
+<p>适用于保存视图初始化参数或与 <code>SceneView.fromJSON</code> 配套实现视图状态恢复。</p>
     </div>
     
 
@@ -4343,7 +4378,7 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
                         
                     
             </td>
-            <td class="description last">导出的配置文件</td>
+            <td class="description last">可用于恢复 <code>SceneView</code> 实例的配置对象。</td>
         </tr>
     
     </tbody>
@@ -4360,12 +4395,12 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
     <div class="nameContainer">
         <h4 class="name" id="toMap">
             
-            toMap<span class="signature">(screenPoint)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Point}</span>
+            toMap<span class="signature">(screenPoint)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Point|null}</span>
         </h4>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1191
+            view/SceneView.js, line 1052
         </div>
         
     </div>
@@ -4377,7 +4412,8 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
     
     <div class="description">
         <p><a id='toMap'></a>
-屏幕像素坐标点转地理坐标点</p>
+将屏幕像素坐标转换为地理坐标点。</p>
+<p>通常用于鼠标点击、悬停等交互场景下，将屏幕位置换算为场景中的经纬高坐标。</p>
     </div>
     
 
@@ -4424,7 +4460,7 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
             
             <td class="description last">
                 
-                <p>屏幕像素坐标点，传入的 x范围为[0,canvas.width - 1]，传入的 x范围为[0,canvas.height - 1]，例如{ x: 900, y: 500 }</p></td>
+                <p>屏幕像素坐标点，<code>x</code> 范围为 <code>[0, canvas.width - 1]</code>，<code>y</code> 范围为 <code>[0, canvas.height - 1]</code>，例如 <code>{ x: 900, y: 500 }</code>。</p></td>
         </tr>
 	
 	
@@ -4486,10 +4522,13 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
             <td class="type">
             
                         Point
+                         | 
+                    
+                        null
                         
                     
             </td>
-            <td class="description last">地理坐标点</td>
+            <td class="description last">转换得到的地理坐标点；当屏幕位置未拾取到有效场景位置时返回 <code>null</code>。</td>
         </tr>
     
     </tbody>
@@ -4504,21 +4543,18 @@ sceneView.takeScreenshot(screenshotOptions).then((result) => {
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
-const { Point } = zondy.geometry
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-import { Map, Point } from "@mapgis/webclient-common"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+
+// ES6 引入方式
+import { Map } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
- // 视图id
- viewId: "mapgis-3d-viewer",
- // 图层管理容器
- map: map,
+  viewId: 'mapgis-3d-viewer',
+  map
 })
 const screenPoint = { x: 900, y: 500 }
 sceneView.toMap(screenPoint)</code></pre>
@@ -4538,7 +4574,7 @@ sceneView.toMap(screenPoint)</code></pre>
     
         
         <div class="tag-source">
-            view/SceneView.js, line 1241
+            view/SceneView.js, line 1113
         </div>
         
     </div>
@@ -4550,7 +4586,8 @@ sceneView.toMap(screenPoint)</code></pre>
     
     <div class="description">
         <p><a id='toScreen'></a>
-地理坐标点转屏幕像素坐标点</p>
+将地理坐标点转换为当前视图中的屏幕像素坐标。</p>
+<p>适用于弹窗定位、覆盖物对齐和自定义交互提示等需要将地理位置映射到屏幕位置的场景。</p>
     </div>
     
 
@@ -4597,7 +4634,7 @@ sceneView.toMap(screenPoint)</code></pre>
             
             <td class="description last">
                 
-                <p>地理坐标点</p></td>
+                <p>地理坐标点。</p></td>
         </tr>
 	
 	
@@ -4662,7 +4699,7 @@ sceneView.toMap(screenPoint)</code></pre>
                         
                     
             </td>
-            <td class="description last">屏幕像素坐标点</td>
+            <td class="description last">屏幕像素坐标点对象。</td>
         </tr>
     
     </tbody>
@@ -4677,27 +4714,186 @@ sceneView.toMap(screenPoint)</code></pre>
     
 
     
-    <pre class="prettyprint"><code>// ES5引入方式
+    <pre class="prettyprint"><code>// ES5 引入方式
 const { Map } = zondy
-const { Point, Extent } = zondy.geometry
+const { Point } = zondy.geometry
 const { SceneView } = zondy.cesium
-// ES6引入方式
-import { SceneView } from "@mapgis/webclient-cesium-plugin"
-import { Map, Point, Extent } from "@mapgis/webclient-common"
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
+
+// ES6 引入方式
+import { Map, Point } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
+
+const map = new Map()
 const sceneView = new SceneView({
-  // 视图id
-  viewId: "mapgis-2d-viewer",
-  // 图层管理容器
-  map: map
-});
+  viewId: 'mapgis-3d-viewer',
+  map
+})
 const geoPoint = new Point({ coordinates: [123, 23, 0] })
 sceneView.toScreen(geoPoint)</code></pre>
     
 
     
+</dd>
+
+        
+            
+<dt>
+    <div class="nameContainer">
+        <h4 class="name" id=".fromJSON">
+            
+            SceneView.fromJSON<span class="signature">(<span class="optional">json</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="SceneView.html">SceneView</a>}</span>
+        </h4>
+    
+        
+        <div class="tag-source">
+            view/SceneView.js, line 2322
+        </div>
+        
+    </div>
+
+    
+</dt>
+<dd>
+    
+    
+    <div class="description">
+        <p>通过 JSON 配置创建一个新的场景视图实例。</p>
+<p>适用于从持久化配置恢复 <code>SceneView</code>，通常与 <code>toJSON</code> 配套使用。</p>
+    </div>
+    
+
+    
+    
+    
+    
+    
+        
+
+<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>json</code></td>
+            
+            
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+            
+            </td>
+            
+            
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
+            
+            <td class="description last">
+                
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>场景视图配置对象。</p></td>
+        </tr>
+	
+	
+	</tbody>
+</table>
+    
+    
+    
+<dl class="details">
+    
+        
+    
+    
+    
+
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+</dl>
+
+    
+    
+
+    
+
+    
+    
+    
+    
+    
+    <h5>Returns:</h5>
+    
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        <a href="SceneView.html">SceneView</a>
+                        
+                    
+            </td>
+            <td class="description last">新创建的场景视图实例。</td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
+    
+    
 </dd>
 
         </dl>
@@ -4714,7 +4910,7 @@ sceneView.toScreen(geoPoint)</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:30 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>