@realsee/five 6.8.0-alpha.8 → 6.8.0

package/docs/documents/README.html

@@ -86,10 +86,11 @@ Before writing or updating any documentation, YOU MUST READ <a href="ai-doc-guid
 <li><a href="features_pano-tile.html">Pano Tile</a>: 全景瓦片渲染机制（高分辨率分片加载）。</li>
 <li><a href="features_model.html">Model</a>: 内置模型渲染 (Mesh/Geometry)。</li>
 <li><a href="features_postprocessing.html">Postprocessing</a>: 后处理效果 (Pass, EffectComposer)。</li>
-<li><a href="features_flowing-light-2d-pass.html">Flowing Light 2D Pass</a>: 屏幕空间流光特效。</li>
-<li><a href="features_flowing-light-3d-pass.html">Flowing Light 3D Pass</a>: 基于模型深度的流光特效。</li>
+<li><a href="features_flowing-light-2d-pass.html">Flowing Light 2D Pass</a>: 屏幕空间流光特效(InstancedMesh 优化)。</li>
+<li><a href="features_flowing-light-3d-pass.html">Flowing Light 3D Pass</a>: 3D 世界坐标流光特效(InstancedMesh 优化)。</li>
 <li><a href="features_gaussian-blur-pass.html">Gaussian Blur Pass</a>: 高斯模糊特效。</li>
 <li><a href="features_material.html">Material</a>: 材质参数配置 (透明度、点云大小、顶点标记)。</li>
+<li><a href="features_pano-filter.html">Pano Filter</a>: 全景图滤镜 (亮度、对比度、色温调节)。</li>
 <li><a href="features_get-screen-pixels.html">Get Screen Pixels</a>: 获取屏幕像素 (放大镜/截图)。</li>
 <li><a href="features_move-pano-effect.html">Move Pano Effect</a>: 全景点位切换的过渡效果。</li>
 <li><a href="features_clipper.html">Clipper</a>: 模型裁切功能 (房屋剖面)。</li>
@@ -123,6 +124,126 @@ Before writing or updating any documentation, YOU MUST READ <a href="ai-doc-guid
 </ul>
 </li>
 </ul>
+<h2 id="common-scenarios-场景-→-文档速查" class="tsd-anchor-link">Common Scenarios (场景 → 文档速查)<a href="#common-scenarios-场景-→-文档速查" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<blockquote>
+<p><strong>Keyword Search Tip:</strong> Each doc in <code>features/</code> has a <code>tags</code> yaml block at the bottom with Chinese and English keywords. Use these for keyword matching when the scenario table below doesn't cover your need.</p>
+</blockquote>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Scenario</th>
+<th style="text-align:left">Docs</th>
+<th style="text-align:left">Tags</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left">点击拾取物体 / Object picking</td>
+<td style="text-align:left"><a href="features_raycast.html">Raycast</a></td>
+<td style="text-align:left">click, hit-test, floor-detection, 碰撞检测, 物体选择</td>
+</tr>
+<tr>
+<td style="text-align:left">3D 标签 / HTML overlay on 3D point</td>
+<td style="text-align:left"><a href="features_screen-project.html">Screen Project</a></td>
+<td style="text-align:left">label, HUD, tooltip, 坐标转换, 3D转2D</td>
+</tr>
+<tr>
+<td style="text-align:left">全景滤镜 / 色温调节 / Color correction</td>
+<td style="text-align:left"><a href="features_pano-filter.html">Pano Filter</a></td>
+<td style="text-align:left">warm, cool, brightness, contrast, saturation, 暖色, 冷色, 饱和度</td>
+</tr>
+<tr>
+<td style="text-align:left">加载外部 GLTF/OBJ/FBX 模型</td>
+<td style="text-align:left"><a href="features_load-external-model.html">Load External Model</a></td>
+<td style="text-align:left">gltf, glb, ply, splat, fbx, draco, point-cloud, dispose</td>
+</tr>
+<tr>
+<td style="text-align:left">相机巡航 / 自动导览 / Camera fly-through</td>
+<td style="text-align:left"><a href="features_camera-animation.html">Camera Animation</a></td>
+<td style="text-align:left">rotate, zoom, auto-tour, 运镜, 旋转, 缩放</td>
+</tr>
+<tr>
+<td style="text-align:left">截图 / 放大镜 / Screen capture</td>
+<td style="text-align:left"><a href="features_get-screen-pixels.html">Get Screen Pixels</a></td>
+<td style="text-align:left">magnifier, screenshot, color-picker, 取色器</td>
+</tr>
+<tr>
+<td style="text-align:left">模型裁切 / 房屋剖面</td>
+<td style="text-align:left"><a href="features_clipper.html">Clipper</a></td>
+<td style="text-align:left">clipping-box, section-view, discard, 开盖, 剖面</td>
+</tr>
+<tr>
+<td style="text-align:left">流光特效 / Flowing light effect</td>
+<td style="text-align:left"><a href="features_flowing-light-2d-pass.html">Flowing Light 2D</a>, <a href="features_flowing-light-3d-pass.html">Flowing Light 3D</a></td>
+<td style="text-align:left">光带, 导航路径, 动态路径, instanced</td>
+</tr>
+<tr>
+<td style="text-align:left">模糊特效 / Blur effect</td>
+<td style="text-align:left"><a href="features_gaussian-blur-pass.html">Gaussian Blur Pass</a></td>
+<td style="text-align:left">毛玻璃, 背景虚化, gaussian</td>
+</tr>
+<tr>
+<td style="text-align:left">保存/恢复场景状态</td>
+<td style="text-align:left"><a href="features_state.html">State</a></td>
+<td style="text-align:left">snapshot, save, restore, 快照, 场景还原</td>
+</tr>
+<tr>
+<td style="text-align:left">多场景切换 / 沙盘</td>
+<td style="text-align:left"><a href="features_multi-work.html">Multi-Work</a></td>
+<td style="text-align:left">sandbox, 多户型, 拼接, workCode</td>
+</tr>
+<tr>
+<td style="text-align:left">请求鉴权 / CDN 替换</td>
+<td style="text-align:left"><a href="features_request-proxy.html">Request Proxy</a></td>
+<td style="text-align:left">authentication, token, url-rewrite, cors, 私有化</td>
+</tr>
+<tr>
+<td style="text-align:left">插件开发</td>
+<td style="text-align:left"><a href="features_plugin.html">Plugin</a></td>
+<td style="text-align:left">lifecycle, extension, baseplugin, 状态管理</td>
+</tr>
+<tr>
+<td style="text-align:left">事件监听 / 拦截默认行为</td>
+<td style="text-align:left"><a href="features_event.html">Event</a></td>
+<td style="text-align:left">preventDefault, waitUntil, on, off, gesture, 回调</td>
+</tr>
+<tr>
+<td style="text-align:left">手势交互 / 自定义拖拽</td>
+<td style="text-align:left"><a href="features_gesture.html">Gesture</a></td>
+<td style="text-align:left">tap, pan, pinch, press, 触摸, 鼠标</td>
+</tr>
+<tr>
+<td style="text-align:left">后处理特效 / 自定义 Shader</td>
+<td style="text-align:left"><a href="features_postprocessing.html">Postprocessing</a></td>
+<td style="text-align:left">effect-composer, addPass, edl, 描边, 景深</td>
+</tr>
+<tr>
+<td style="text-align:left">材质 / 透明度 / 点云样式</td>
+<td style="text-align:left"><a href="features_material.html">Material</a></td>
+<td style="text-align:left">opacity, pointcloud, roof, ceiling, 天花板, 顶点标记</td>
+</tr>
+<tr>
+<td style="text-align:left">模式切换 / 全景↔模型↔户型图</td>
+<td style="text-align:left"><a href="features_mode.html">Mode</a></td>
+<td style="text-align:left">panorama, floorplan, mapview, topview, VR</td>
+</tr>
+<tr>
+<td style="text-align:left">全景高清瓦片 / 分片加载</td>
+<td style="text-align:left"><a href="features_pano-tile.html">Pano Tile</a></td>
+<td style="text-align:left">LOD, tile, 按需加载, 高清全景</td>
+</tr>
+<tr>
+<td style="text-align:left">图片 CDN / 私有化部署</td>
+<td style="text-align:left"><a href="features_image-options.html">Image Options</a></td>
+<td style="text-align:left">avif, webp, cdn, private-deployment</td>
+</tr>
+<tr>
+<td style="text-align:left">加载进度 / 首屏优化</td>
+<td style="text-align:left"><a href="features_load-progress.html">Load Progress</a></td>
+<td style="text-align:left">refined, loaded, loading-bar, 首屏</td>
+</tr>
+</tbody>
+</table>
 <h2 id="terminology-summary" class="tsd-anchor-link">Terminology Summary<a href="#terminology-summary" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <ul>
 <li><strong>Work</strong>: 包含全景图、模型、户型数据的 JSON 对象。</li>
@@ -135,4 +256,4 @@ Before writing or updating any documentation, YOU MUST READ <a href="ai-doc-guid
 <pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">index</span><span class="hl-1">, </span><span class="hl-2">readme</span><span class="hl-1">, </span><span class="hl-2">guide</span><span class="hl-1">, </span><span class="hl-2">map</span><span class="hl-1">]</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#five-sdk-documentation"><span>Five <wbr/>SDK <wbr/>Documentation</span></a><ul><li><a href="#context-for-ai-agents"><span>Context for <wbr/>AI <wbr/>Agents</span></a></li><li><ul><li><a href="#1-documentation-maintenance-文档维护"><span>1. <wbr/>Documentation <wbr/>Maintenance (文档维护)</span></a></li><li><a href="#2-application-development-strategy-应用开发建议"><span>2. <wbr/>Application <wbr/>Development <wbr/>Strategy (应用开发建议)</span></a></li><li><a href="#3-general-retrieval-通用检索"><span>3. <wbr/>General <wbr/>Retrieval (通用检索)</span></a></li></ul></li><li><a href="#documentation-map"><span>Documentation <wbr/>Map</span></a></li><li><ul><li><a href="#1-essential-reference-必读速查"><span>1. <wbr/>Essential <wbr/>Reference (必读/速查)</span></a></li><li><a href="#2-core-concepts-核心概念"><span>2. <wbr/>Core <wbr/>Concepts (核心概念)</span></a></li><li><a href="#3-data-resource-数据与资源"><span>3. <wbr/>Data &amp; <wbr/>Resource (数据与资源)</span></a></li><li><a href="#4-rendering-visuals-渲染与视觉"><span>4. <wbr/>Rendering &amp; <wbr/>Visuals (渲染与视觉)</span></a></li><li><a href="#5-interaction-control-交互与控制"><span>5. <wbr/>Interaction &amp; <wbr/>Control (交互与控制)</span></a></li><li><a href="#6-advanced-extensions-进阶与扩展"><span>6. <wbr/>Advanced &amp; <wbr/>Extensions (进阶与扩展)</span></a></li><li><a href="#7-meta-support-其他"><span>7. <wbr/>Meta &amp; <wbr/>Support (其他)</span></a></li></ul></li><li><a href="#terminology-summary"><span>Terminology <wbr/>Summary</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#five-sdk-documentation"><span>Five <wbr/>SDK <wbr/>Documentation</span></a><ul><li><a href="#context-for-ai-agents"><span>Context for <wbr/>AI <wbr/>Agents</span></a></li><li><ul><li><a href="#1-documentation-maintenance-文档维护"><span>1. <wbr/>Documentation <wbr/>Maintenance (文档维护)</span></a></li><li><a href="#2-application-development-strategy-应用开发建议"><span>2. <wbr/>Application <wbr/>Development <wbr/>Strategy (应用开发建议)</span></a></li><li><a href="#3-general-retrieval-通用检索"><span>3. <wbr/>General <wbr/>Retrieval (通用检索)</span></a></li></ul></li><li><a href="#documentation-map"><span>Documentation <wbr/>Map</span></a></li><li><ul><li><a href="#1-essential-reference-必读速查"><span>1. <wbr/>Essential <wbr/>Reference (必读/速查)</span></a></li><li><a href="#2-core-concepts-核心概念"><span>2. <wbr/>Core <wbr/>Concepts (核心概念)</span></a></li><li><a href="#3-data-resource-数据与资源"><span>3. <wbr/>Data &amp; <wbr/>Resource (数据与资源)</span></a></li><li><a href="#4-rendering-visuals-渲染与视觉"><span>4. <wbr/>Rendering &amp; <wbr/>Visuals (渲染与视觉)</span></a></li><li><a href="#5-interaction-control-交互与控制"><span>5. <wbr/>Interaction &amp; <wbr/>Control (交互与控制)</span></a></li><li><a href="#6-advanced-extensions-进阶与扩展"><span>6. <wbr/>Advanced &amp; <wbr/>Extensions (进阶与扩展)</span></a></li><li><a href="#7-meta-support-其他"><span>7. <wbr/>Meta &amp; <wbr/>Support (其他)</span></a></li></ul></li><li><a href="#common-scenarios-场景-→-文档速查"><span>Common <wbr/>Scenarios (场景 → 文档速查)</span></a></li><li><a href="#terminology-summary"><span>Terminology <wbr/>Summary</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/docs/documents/api.html

@@ -92,78 +92,122 @@
 </table>
 <h2 id="initialization-configuration-" class="tsd-anchor-link">Initialization Configuration (<code>FiveInitArgs</code>)<a href="#initialization-configuration-" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>Configuration object passed to the <code>Five</code> constructor.</p>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">FiveInitArgs</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** External WebGLRenderer. If provided, internal renderer creation is skipped. */</span><br/><span class="hl-1">  </span><span class="hl-6">renderer</span><span class="hl-1">?: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderer</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Width/Height of the viewport relative to container (0-1). */</span><br/><span class="hl-1">  </span><span class="hl-6">viewport</span><span class="hl-1">?: { </span><span class="hl-6">left</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">bottom</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">width</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">height</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1"> };</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Canvas background color. Default: 0x181A1C */</span><br/><span class="hl-1">  </span><span class="hl-6">backgroundColor</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Color</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Canvas background alpha (0-1). Default: 1 */</span><br/><span class="hl-1">  </span><span class="hl-6">backgroundAlpha</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Enable antialiasing. Default: false */</span><br/><span class="hl-1">  </span><span class="hl-6">antialias</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Auto-play rendering loop. Default: true */</span><br/><span class="hl-1">  </span><span class="hl-6">play</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Enable on-demand rendering to save battery. Default: true */</span><br/><span class="hl-1">  </span><span class="hl-6">onlyRenderIfNeeds</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Max FPS limit. false = unlimited. Default: false */</span><br/><span class="hl-1">  </span><span class="hl-6">maxFps</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | </span><span class="hl-7">false</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Mode transition duration in ms. Default: 800 */</span><br/><span class="hl-1">  </span><span class="hl-6">modeChangeDuration</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Initial plugins to load. */</span><br/><span class="hl-1">  </span><span class="hl-6">plugins</span><span class="hl-1">?: </span><span class="hl-7">FivePlugin</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Dynamic image configuration for optimization. */</span><br/><span class="hl-1">  </span><span class="hl-6">imageOptions</span><span class="hl-1">?: </span><span class="hl-7">ImageOptions</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Dynamic texture configuration for optimization. */</span><br/><span class="hl-1">  </span><span class="hl-6">textureOptions</span><span class="hl-1">?: </span><span class="hl-7">TextureOptions</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">FiveInitArgs</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** External WebGLRenderer. If provided, internal renderer creation is skipped. */</span><br/><span class="hl-1">  </span><span class="hl-6">renderer</span><span class="hl-1">?: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderer</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Width/Height of the viewport relative to container (0-1). */</span><br/><span class="hl-1">  </span><span class="hl-6">viewport</span><span class="hl-1">?: { </span><span class="hl-6">left</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">bottom</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">width</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">; </span><span class="hl-6">height</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1"> };</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Canvas background color. Default: 0x181A1C */</span><br/><span class="hl-1">  </span><span class="hl-6">backgroundColor</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Color</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Canvas background alpha (0-1). Default: 1 */</span><br/><span class="hl-1">  </span><span class="hl-6">backgroundAlpha</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Enable antialiasing. Default: false */</span><br/><span class="hl-1">  </span><span class="hl-6">antialias</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Auto-play rendering loop. Default: true */</span><br/><span class="hl-1">  </span><span class="hl-6">play</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Enable on-demand rendering to save battery. Default: true */</span><br/><span class="hl-1">  </span><span class="hl-6">onlyRenderIfNeeds</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Max FPS limit. false = unlimited. Default: false */</span><br/><span class="hl-1">  </span><span class="hl-6">maxFps</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | </span><span class="hl-7">false</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Mode transition duration in ms. Default: 1000 */</span><br/><span class="hl-1">  </span><span class="hl-6">modeChangeDuration</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Enable mouse wheel zoom. Default: true */</span><br/><span class="hl-1">  </span><span class="hl-6">enableWheel</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Initial plugins to load. */</span><br/><span class="hl-1">  </span><span class="hl-6">plugins</span><span class="hl-1">?: </span><span class="hl-7">FivePlugin</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Dynamic image configuration for optimization. */</span><br/><span class="hl-1">  </span><span class="hl-6">imageOptions</span><span class="hl-1">?: </span><span class="hl-7">ImageOptions</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Dynamic texture configuration for optimization. */</span><br/><span class="hl-1">  </span><span class="hl-6">textureOptions</span><span class="hl-1">?: </span><span class="hl-7">TextureOptions</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Request URL interceptor for auth/CDN. */</span><br/><span class="hl-1">  </span><span class="hl-5">requestProxy</span><span class="hl-1">?: (</span><span class="hl-6">url</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">string</span><span class="hl-1"> | </span><span class="hl-7">Promise</span><span class="hl-1">&lt;</span><span class="hl-7">string</span><span class="hl-1">&gt;;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** Per-mode configuration (panorama, mapview, floorplan, topview, model). */</span><br/><span class="hl-1">  </span><span class="hl-6">panorama</span><span class="hl-1">?: </span><span class="hl-7">PanoramaConfig</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">mapview</span><span class="hl-1">?: </span><span class="hl-7">MapviewConfig</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">floorplan</span><span class="hl-1">?: </span><span class="hl-7">FloorplanConfig</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">topview</span><span class="hl-1">?: </span><span class="hl-7">TopviewConfig</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">model</span><span class="hl-1">?: </span><span class="hl-7">ModelConfig</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 
+<blockquote>
+<p>详细的模式配置参数见 <a href="../../ai_guides/features/mode.md#configuration">Mode</a>。
+图片加载策略见 <a href="features_image-options.html">ImageOptions</a>。
+请求代理见 <a href="features_request-proxy.html">Request Proxy</a>。
+完整初始化参数见 <a href="features_five.html">Five</a> 和 <a href="features_parameter.html">Parameter</a>。</p>
+</blockquote>
 <h2 id="core-methods" class="tsd-anchor-link">Core Methods<a href="#core-methods" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<h3 id="" class="tsd-anchor-link"><code>load(work, state?, options?)</code></h3>
+<h3 id="_" class="tsd-anchor-link"><code>load(work, state?, options?)</code><a href="#_" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Loads a &quot;Work&quot; (dataset) into the Five instance.</p>
 <ul>
 <li><strong>work</strong>: The data object (<code>LooseWork</code> or <code>Work</code>) containing scene information.</li>
 <li><strong>state</strong>: Initial state overrides. <code>&quot;inherit&quot;</code>, <code>&quot;initial&quot;</code>, or a <code>State</code> object.</li>
-<li><strong>options</strong>: Loading options (e.g., transition duration).</li>
+<li><strong>options</strong>: Loading options (e.g., transition duration, <code>mode: &quot;add&quot; | &quot;replace&quot;</code>).</li>
 </ul>
-<h3 id="-1" class="tsd-anchor-link"><code>appendTo(element, size?)</code><a href="#-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_work.html">Work</a> 和 <a href="features_multi-work.html">Multi-Work</a>。</p>
+</blockquote>
+<h3 id="_-1" class="tsd-anchor-link"><code>appendTo(element, size?)</code><a href="#_-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Mounts the Five canvas to a DOM element.</p>
 <ul>
 <li><strong>element</strong>: HTMLElement to append to.</li>
 <li><strong>size</strong>: Optional <code>{ width, height }</code>. Defaults to element size.</li>
 </ul>
-<h3 id="-2" class="tsd-anchor-link"><code>setState(state, immediately?, userAction?)</code><a href="#-2" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<h3 id="_-2" class="tsd-anchor-link"><code>setState(state, immediately?, userAction?)</code><a href="#_-2" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Updates the current state (position, mode, etc.).</p>
 <ul>
 <li><strong>state</strong>: Partial <code>State</code> object to merge.</li>
 <li><strong>immediately</strong>: If <code>true</code>, skips animation.</li>
 <li><strong>userAction</strong>: Marks the change as triggered by user interaction.</li>
 </ul>
-<h3 id="-3" class="tsd-anchor-link"><code>changeMode(mode, state?, options?)</code><a href="#-3" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_state.html">State</a>。</p>
+</blockquote>
+<h3 id="_-3" class="tsd-anchor-link"><code>changeMode(mode, state?, options?)</code><a href="#_-3" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Switches the viewing mode (e.g., from <code>Panorama</code> to <code>Model</code>).</p>
 <ul>
 <li><strong>mode</strong>: Target <code>Five.Mode</code>.</li>
 <li><strong>state</strong>: Target state after mode change.</li>
 <li><strong>options</strong>: Animation duration and effect.</li>
 </ul>
-<h3 id="-4" class="tsd-anchor-link"><code>moveToPano(panoIndex, options?)</code><a href="#-4" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_mode.html">Mode</a>。</p>
+</blockquote>
+<h3 id="_-4" class="tsd-anchor-link"><code>moveToPano(panoIndex, options?)</code><a href="#_-4" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Moves to a specific panorama spot.</p>
 <ul>
 <li><strong>panoIndex</strong>: Index of the panorama.</li>
-<li><strong>options</strong>: <code>{ effect?: MovePanoEffect, duration?: number }</code>.</li>
+<li><strong>options</strong>: <code>{ effect?: MovePanoEffect, duration?: number, effectEasing?: Function }</code>.</li>
 </ul>
-<h3 id="-5" class="tsd-anchor-link"><code>refresh(size?)</code><a href="#-5" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_move-pano-effect.html">Move Pano Effect</a> 和 <a href="features_camera-animation.html">Camera Animation</a>。</p>
+</blockquote>
+<h3 id="_-5" class="tsd-anchor-link"><code>updateCamera(pose, duration, userAction?)</code><a href="#_-5" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>Animates the camera to a target pose without changing pano index.</p>
+<ul>
+<li><strong>pose</strong>: Partial <code>Pose</code> object (longitude, latitude, fov, etc.).</li>
+<li><strong>duration</strong>: Animation duration in ms.</li>
+<li><strong>returns</strong>: <code>Promise&lt;void&gt;</code> (rejects if interrupted).</li>
+</ul>
+<blockquote>
+<p>详见 <a href="features_camera-animation.html">Camera Animation</a>。</p>
+</blockquote>
+<h3 id="_-6" class="tsd-anchor-link"><code>ready(args?)</code><a href="#_-6" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>Returns a Promise that resolves when Five is stable (state synced, model loaded, optionally tiles loaded).</p>
+<ul>
+<li><strong>args</strong>: <code>{ tile?: boolean }</code> — if <code>tile: true</code> in Panorama mode, waits for tile loading.</li>
+</ul>
+<h3 id="_-7" class="tsd-anchor-link"><code>refresh(size?)</code><a href="#_-7" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Resizes the renderer to fit the container or specified size.</p>
-<h3 id="-6" class="tsd-anchor-link"><code>getElement()</code><a href="#-6" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<h3 id="_-8" class="tsd-anchor-link"><code>getElement()</code><a href="#_-8" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Returns the <code>&lt;canvas&gt;</code> element used by Five.</p>
-<h3 id="-7" class="tsd-anchor-link"><code>project2d(vector, testModel?)</code><a href="#-7" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<h3 id="_-9" class="tsd-anchor-link"><code>project2d(vector, testModel?)</code><a href="#_-9" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Projects a 3D point to 2D screen coordinates.</p>
 <ul>
 <li><strong>vector</strong>: <code>THREE.Vector3</code> (World Space).</li>
 <li><strong>testModel</strong>: <code>boolean</code> (default <code>false</code>). If <code>true</code>, checks for occlusion.</li>
 <li><strong>returns</strong>: <code>THREE.Vector2</code> (Screen Space, px) or <code>null</code>.</li>
 </ul>
-<h3 id="-8" class="tsd-anchor-link"><code>getPixels(x, y, width, height)</code><a href="#-8" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_screen-project.html">Screen &amp; Space Projection</a>。</p>
+</blockquote>
+<h3 id="_-10" class="tsd-anchor-link"><code>getPixels(options)</code><a href="#_-10" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Get pixel data from the renderer (e.g. for color picking or magnifier).</p>
 <ul>
-<li><strong>x, y</strong>: Coordinate of the lower-left corner (Screen Space).</li>
-<li><strong>width, height</strong>: Size of the rectangle.</li>
+<li><strong>options</strong>: <code>{ x, y, width, height, pixelRatio?, flipY?, buffer?, skipPanorama?, helperVisible? }</code></li>
 <li><strong>returns</strong>: <code>Uint8Array</code> (RGBA data).</li>
 </ul>
-<h3 id="-9" class="tsd-anchor-link"><code>intersectRaycaster(raycaster)</code><a href="#-9" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_get-screen-pixels.html">Get Screen Pixels</a>。</p>
+</blockquote>
+<h3 id="_-11" class="tsd-anchor-link"><code>intersectRaycaster(raycaster)</code><a href="#_-11" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>(On <code>five.model</code>) Performs raycasting against the scene models.</p>
 <ul>
-<li><strong>raycaster</strong>: <code>THREE.Raycaster</code>.</li>
-<li><strong>returns</strong>: <code>THREE.Intersection[]</code>.</li>
-</ul>
-<h3 id="-10" class="tsd-anchor-link"><code>addPass(pass)</code><a href="#-10" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>Add a post-processing pass to the rendering chain.</p>
-<ul>
-<li><strong>pass</strong>: <code>FivePass</code> instance (e.g. <code>Gaussian Blur Pass</code>).</li>
+<li><strong>raycaster</strong>: <code>THREE.Raycaster</code> (supports extended props: <code>firstHitOnly</code>, <code>hitFilter</code>, <code>sortByDistance</code>, <code>floorIndex</code>).</li>
+<li><strong>returns</strong>: <code>THREE.Intersection[]</code> (extended with <code>tile</code>, <code>viewLayer</code>, <code>model</code> fields).</li>
 </ul>
-<h3 id="-11" class="tsd-anchor-link"><code>removePass(pass)</code><a href="#-11" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>Remove a post-processing pass from the rendering chain.</p>
+<blockquote>
+<p>详见 <a href="features_raycast.html">Raycast</a>。</p>
+</blockquote>
+<h3 id="_-12" class="tsd-anchor-link"><code>addPass(pass)</code> / <code>removePass(pass)</code><a href="#_-12" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>Add or remove a post-processing pass to/from the rendering chain.</p>
 <ul>
-<li><strong>pass</strong>: <code>FivePass</code> instance to remove.</li>
+<li><strong>pass</strong>: <code>FivePass</code> instance (e.g. <code>GaussianBlurPass</code>, <code>FlowingLight2DPass</code>).</li>
 </ul>
-<h3 id="-12" class="tsd-anchor-link"><code>dispose()</code><a href="#-12" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>详见 <a href="features_postprocessing.html">Postprocessing</a>。</p>
+</blockquote>
+<h3 id="_-13" class="tsd-anchor-link"><code>updateConfiguration(config)</code><a href="#_-13" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>Dynamically update mode configurations after initialization (e.g., panorama, mapview settings).</p>
+<blockquote>
+<p>详见 <a href="../../ai_guides/features/mode.md#%E5%8A%A8%E6%80%81%E4%BF%AE%E6%94%B9%E9%85%8D%E7%BD%AE-update-configuration">Mode</a>。</p>
+</blockquote>
+<h3 id="_-14" class="tsd-anchor-link"><code>dispose()</code><a href="#_-14" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Destroys the Five instance and releases resources.</p>
 <h2 id="state-management" class="tsd-anchor-link">State Management<a href="#state-management" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>The <code>State</code> interface defines the complete status of the Five instance at any moment.</p>
@@ -171,7 +215,10 @@
 </code><button type="button">Copy</button></pre>
 
 <h2 id="data-structures" class="tsd-anchor-link">Data Structures<a href="#data-structures" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<h3 id="-13" class="tsd-anchor-link"><code>Work</code><a href="#-13" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<blockquote>
+<p>以下为核心数据结构摘要。完整定义见 <a href="features_work.html">Work</a>、<a href="features_state.html">State</a>、<a href="features_model.html">Model</a>。</p>
+</blockquote>
+<h3 id="_-15" class="tsd-anchor-link"><code>Work</code><a href="#_-15" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>The main data object containing the scene description.</p>
 <pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Work</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">workCode</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;          </span><span class="hl-8">// Unique identifier</span><br/><span class="hl-1">  </span><span class="hl-6">name</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;             </span><span class="hl-8">// Project name</span><br/><span class="hl-1">  </span><span class="hl-6">observers</span><span class="hl-1">: </span><span class="hl-7">WorkObserver</span><span class="hl-1">[]; </span><span class="hl-8">// List of panorama points</span><br/><span class="hl-1">  </span><span class="hl-6">model</span><span class="hl-1">: </span><span class="hl-7">WorkModel</span><span class="hl-1">;          </span><span class="hl-8">// 3D model data</span><br/><span class="hl-1">  </span><span class="hl-6">initial</span><span class="hl-1">: </span><span class="hl-7">WorkInitial</span><span class="hl-1">;      </span><span class="hl-8">// Initial view state</span><br/><span class="hl-1">  </span><span class="hl-6">transform</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Matrix4</span><span class="hl-1">;  </span><span class="hl-8">// World transform matrix</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
@@ -199,25 +246,53 @@
 <tr>
 <td style="text-align:left"><code>gesture.tap</code></td>
 <td style="text-align:left">Triggered on tap/click. Replaces <code>wantsTapGesture</code>.</td>
-<td style="text-align:left"><code>{ pointers, event, ... }</code></td>
+<td style="text-align:left"><code>GestureEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>gesture.dbltap</code></td>
+<td style="text-align:left">Triggered on double tap/click.</td>
+<td style="text-align:left"><code>GestureEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>gesture.pan</code></td>
 <td style="text-align:left">Triggered on pan/drag.</td>
-<td style="text-align:left"><code>{ pointers, ... }</code></td>
+<td style="text-align:left"><code>GestureEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>gesture.pinch</code></td>
 <td style="text-align:left">Triggered on pinch/zoom.</td>
-<td style="text-align:left"><code>{ scale, ... }</code></td>
+<td style="text-align:left"><code>GestureEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>gesture.press</code></td>
 <td style="text-align:left">Triggered on long press.</td>
-<td style="text-align:left"><code>{ pointers, ... }</code></td>
+<td style="text-align:left"><code>GestureEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>gesture.mousewheel</code></td>
+<td style="text-align:left">Triggered on mouse wheel scroll.</td>
+<td style="text-align:left"><code>GestureEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>gesture.mousemove</code></td>
+<td style="text-align:left">Triggered on mouse move.</td>
+<td style="text-align:left"><code>GestureEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>gesture.momentum</code></td>
+<td style="text-align:left">Triggered on inertia movement after pan.</td>
+<td style="text-align:left"><code>GestureEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>gesture.fire</code></td>
+<td style="text-align:left">Triggered when any gesture event fires.</td>
+<td style="text-align:left"><code>GestureEvent</code></td>
 </tr>
 </tbody>
 </table>
+<blockquote>
+<p>手势事件详解及不同 Mode 下的默认行为见 <a href="features_gesture.html">Gesture</a>。</p>
+</blockquote>
 <h4 id="state-mode" class="tsd-anchor-link">State &amp; Mode<a href="#state-mode" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
 <table>
 <thead>
@@ -245,6 +320,9 @@
 </tr>
 </tbody>
 </table>
+<blockquote>
+<p>状态管理详见 <a href="features_state.html">State</a>，模式切换详见 <a href="features_mode.html">Mode</a>。</p>
+</blockquote>
 <h4 id="lifecycle-resources" class="tsd-anchor-link">Lifecycle &amp; Resources<a href="#lifecycle-resources" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
 <table>
 <thead>
@@ -261,19 +339,49 @@
 <td style="text-align:left"><code>WorksEvent</code></td>
 </tr>
 <tr>
+<td style="text-align:left"><code>works.ready</code></td>
+<td style="text-align:left">Triggered when work data is loaded and controller is ready.</td>
+<td style="text-align:left"><code>WorksEvent</code></td>
+</tr>
+<tr>
 <td style="text-align:left"><code>models.load</code></td>
 <td style="text-align:left">Triggered when models are loaded.</td>
 <td style="text-align:left"><code>ModelSceneEvent</code></td>
 </tr>
 <tr>
+<td style="text-align:left"><code>models.refined</code></td>
+<td style="text-align:left">Triggered when all models finish texture refinement.</td>
+<td style="text-align:left"><code>ModelSceneEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>model.load</code></td>
+<td style="text-align:left">Triggered when a single model geometry is loaded.</td>
+<td style="text-align:left"><code>ModelEvent</code></td>
+</tr>
+<tr>
 <td style="text-align:left"><code>model.tileLoad</code></td>
 <td style="text-align:left">Triggered when a 3D tile is loaded.</td>
-<td style="text-align:left"><code>Tile</code></td>
+<td style="text-align:left"><code>ModelTileEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>model.tileUnload</code></td>
 <td style="text-align:left">Triggered when a 3D tile is unloaded.</td>
-<td style="text-align:left"><code>Tile</code></td>
+<td style="text-align:left"><code>ModelTileEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>model.changeShownFloor</code></td>
+<td style="text-align:left">Triggered when floor visibility changes.</td>
+<td style="text-align:left"><code>ModelEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>model.error</code></td>
+<td style="text-align:left">Triggered when model loading fails.</td>
+<td style="text-align:left"><code>ModelErrorEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>pano.prepare</code></td>
+<td style="text-align:left">Triggered before switching to a new pano. <code>ExtendableEvent</code>, supports <code>waitUntil</code>.</td>
+<td style="text-align:left"><code>PanoPrepareEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>pano.arrived</code></td>
@@ -281,9 +389,19 @@
 <td style="text-align:left"><code>PanoEvent</code></td>
 </tr>
 <tr>
+<td style="text-align:left"><code>pano.moving</code></td>
+<td style="text-align:left">Triggered during pano transition animation.</td>
+<td style="text-align:left"><code>PanoEvent</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>pano.error</code></td>
+<td style="text-align:left">Triggered when pano loading or movement fails.</td>
+<td style="text-align:left"><code>PanoEvent</code></td>
+</tr>
+<tr>
 <td style="text-align:left"><code>pano.texture.progress</code></td>
 <td style="text-align:left">Triggered when panorama texture loading progresses.</td>
-<td style="text-align:left"><code>{ progress, panoIndex }</code></td>
+<td style="text-align:left"><code>PanoTextureEvent</code></td>
 </tr>
 <tr>
 <td style="text-align:left"><code>render</code></td>
@@ -291,12 +409,22 @@
 <td style="text-align:left"><code>RenderEvent</code></td>
 </tr>
 <tr>
+<td style="text-align:left"><code>render.prepare</code></td>
+<td style="text-align:left">Triggered before each render frame.</td>
+<td style="text-align:left"><code>RenderEvent</code></td>
+</tr>
+<tr>
 <td style="text-align:left"><code>error</code></td>
 <td style="text-align:left">Triggered on internal errors.</td>
 <td style="text-align:left"><code>Error</code></td>
 </tr>
 </tbody>
 </table>
+<blockquote>
+<p>事件系统详解见 <a href="features_event.html">Event</a>。手势事件详解见 <a href="features_gesture.html">Gesture</a>。
+<code>pano.prepare</code> 的 <code>waitUntil</code> / <code>preventDefault</code> 用法见 <a href="../../ai_guides/features/event.md#event-%E5%AF%B9%E8%B1%A1">Event - Event 对象</a>。
+模型生命周期事件见 <a href="../../ai_guides/features/model.md#events">Model</a> 和 <a href="features_load-progress.html">Load Progress</a>。</p>
+</blockquote>
 <h3 id="legacy-events-deprecated" class="tsd-anchor-link">Legacy Events (Deprecated)<a href="#legacy-events-deprecated" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Older events are still supported for compatibility but should be avoided in new code.</p>
 <table>
@@ -334,4 +462,4 @@
 <pre><code class="typescript"><span class="hl-8">// Recommended: Use the new event system</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">on</span><span class="hl-1">(</span><span class="hl-9">&#39;gesture.tap&#39;</span><span class="hl-1">, (</span><span class="hl-6">event</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&#39;User tapped at:&#39;</span><span class="hl-1">, </span><span class="hl-6">event</span><span class="hl-1">);</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-8">// Legacy (Avoid):</span><br/><span class="hl-8">// five.on(&#39;wantsTapGesture&#39;, (raycaster) =&gt; { ... });</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#five-sdk-api-reference"><span>Five <wbr/>SDK <wbr/>API <wbr/>Reference</span></a><ul><li><a href="#core-class"><span>Core <wbr/>Class: </span></a></li><li><ul><li><a href="#constructor"><span>Constructor</span></a></li><li><a href="#properties"><span>Properties</span></a></li><li><a href="#static-properties"><span>Static <wbr/>Properties</span></a></li></ul></li><li><a href="#initialization-configuration-"><span>Initialization <wbr/>Configuration ()</span></a></li><li><a href="#core-methods"><span>Core <wbr/>Methods</span></a></li><li><ul><li><a href="#"><span></span></a></li><li><a href="#-1"><span></span></a></li><li><a href="#-2"><span></span></a></li><li><a href="#-3"><span></span></a></li><li><a href="#-4"><span></span></a></li><li><a href="#-5"><span></span></a></li><li><a href="#-6"><span></span></a></li><li><a href="#-7"><span></span></a></li><li><a href="#-8"><span></span></a></li><li><a href="#-9"><span></span></a></li><li><a href="#-10"><span></span></a></li><li><a href="#-11"><span></span></a></li><li><a href="#-12"><span></span></a></li></ul></li><li><a href="#state-management"><span>State <wbr/>Management</span></a></li><li><a href="#data-structures"><span>Data <wbr/>Structures</span></a></li><li><ul><li><a href="#-13"><span></span></a></li><li><a href="#panorama-point"><span> (<wbr/>Panorama <wbr/>Point)</span></a></li></ul></li><li><a href="#events"><span>Events</span></a></li><li><ul><li><a href="#recommended-events-modern"><span>Recommended <wbr/>Events (<wbr/>Modern)</span></a></li><li><ul><li><a href="#interaction-gestures"><span>Interaction &amp; <wbr/>Gestures</span></a></li><li><a href="#state-mode"><span>State &amp; <wbr/>Mode</span></a></li><li><a href="#lifecycle-resources"><span>Lifecycle &amp; <wbr/>Resources</span></a></li></ul></li><li><a href="#legacy-events-deprecated"><span>Legacy <wbr/>Events (<wbr/>Deprecated)</span></a></li><li><a href="#usage-example"><span>Usage <wbr/>Example</span></a></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#five-sdk-api-reference"><span>Five <wbr/>SDK <wbr/>API <wbr/>Reference</span></a><ul><li><a href="#core-class"><span>Core <wbr/>Class: </span></a></li><li><ul><li><a href="#constructor"><span>Constructor</span></a></li><li><a href="#properties"><span>Properties</span></a></li><li><a href="#static-properties"><span>Static <wbr/>Properties</span></a></li></ul></li><li><a href="#initialization-configuration-"><span>Initialization <wbr/>Configuration ()</span></a></li><li><a href="#core-methods"><span>Core <wbr/>Methods</span></a></li><li><ul><li><a href="#_"><span></span></a></li><li><a href="#_-1"><span></span></a></li><li><a href="#_-2"><span></span></a></li><li><a href="#_-3"><span></span></a></li><li><a href="#_-4"><span></span></a></li><li><a href="#_-5"><span></span></a></li><li><a href="#_-6"><span></span></a></li><li><a href="#_-7"><span></span></a></li><li><a href="#_-8"><span></span></a></li><li><a href="#_-9"><span></span></a></li><li><a href="#_-10"><span></span></a></li><li><a href="#_-11"><span></span></a></li><li><a href="#_-12"><span> / </span></a></li><li><a href="#_-13"><span></span></a></li><li><a href="#_-14"><span></span></a></li></ul></li><li><a href="#state-management"><span>State <wbr/>Management</span></a></li><li><a href="#data-structures"><span>Data <wbr/>Structures</span></a></li><li><ul><li><a href="#_-15"><span></span></a></li><li><a href="#panorama-point"><span> (<wbr/>Panorama <wbr/>Point)</span></a></li></ul></li><li><a href="#events"><span>Events</span></a></li><li><ul><li><a href="#recommended-events-modern"><span>Recommended <wbr/>Events (<wbr/>Modern)</span></a></li><li><ul><li><a href="#interaction-gestures"><span>Interaction &amp; <wbr/>Gestures</span></a></li><li><a href="#state-mode"><span>State &amp; <wbr/>Mode</span></a></li><li><a href="#lifecycle-resources"><span>Lifecycle &amp; <wbr/>Resources</span></a></li></ul></li><li><a href="#legacy-events-deprecated"><span>Legacy <wbr/>Events (<wbr/>Deprecated)</span></a></li><li><a href="#usage-example"><span>Usage <wbr/>Example</span></a></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>