@realsee/five 6.8.0-alpha.3 → 6.8.0-alpha.31

package/docs/documents/glossary.html

@@ -7,12 +7,17 @@
 <h3 id="five" class="tsd-anchor-link">Five<a href="#five" 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>SDK 的核心入口类。一个 <code>Five</code> 实例对应一个 <code>&lt;canvas&gt;</code> 渲染上下文，负责管理场景生命周期、渲染循环、用户交互和状态更新。</p>
 <h3 id="work" class="tsd-anchor-link">Work<a href="#work" 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>VR 看房的<strong>原始数据载体</strong>。通常是一个 JSON 对象，包含了重建三维空间所需的所有信息，包括：</p>
+<p>VR 看房的<strong>运行时实体</strong>。通常指经过 <code>parseWork</code> 解析后生成的标准化数据对象。</p>
 <ul>
-<li><strong>Observers</strong>: 全景拍摄点位信息。</li>
-<li><strong>Panorama</strong>: 全景图资源地址。</li>
-<li><strong>Model</strong>: 三维模型数据 (Mesh, Material)。</li>
-<li><strong>Plan</strong>: 户型图数据 (SVG, 标尺)。</li>
+<li><strong>LooseWork</strong>: 服务端下发的原始 JSON 数据，结构较宽松。</li>
+<li><strong>WorkJson</strong>: <code>workToJson</code> 生成的标准序列化数据，用于存储。</li>
+<li><strong>包含内容</strong>: Observers, Panorama, Model, Plan 等。</li>
+</ul>
+<h3 id="vertex-marks-顶点标记" class="tsd-anchor-link">Vertex Marks (顶点标记)<a href="#vertex-marks-顶点标记" 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>在模型顶点上通过 <code>_feature_id_rsmask</code> 属性进行的标记。</p>
+<ul>
+<li>用于在特定视角（如俯视）下控制 Mesh 的显隐（例如隐藏天花板）。</li>
+<li>属于材质配置的一部分。</li>
 </ul>
 <h3 id="observer" class="tsd-anchor-link">Observer<a href="#observer" 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><strong>观察点</strong>。对应现实空间中拍摄全景图的一个物理位置。</p>
@@ -47,10 +52,30 @@
 <h2 id="rendering-渲染" class="tsd-anchor-link">Rendering (渲染)<a href="#rendering-渲染" 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="pano-tile-全景瓦片" class="tsd-anchor-link">Pano Tile (全景瓦片)<a href="#pano-tile-全景瓦片" 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>为了在移动端快速加载高分辨率全景图（如 8K/16K），将全景图切分为多个小块（瓦片）。Five 会根据当前视角按需加载可见区域的瓦片。</p>
-<h3 id="quasi-mesh" class="tsd-anchor-link">Quasi / Mesh<a href="#quasi-mesh" 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="mesh-三维网格" class="tsd-anchor-link">Mesh (三维网格)<a href="#mesh-三维网格" 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><strong>三维模型</strong>。通过激光扫描或视觉算法重建的空间几何结构。在 Five 中，全景图贴在几何模型上，从而实现“从全景中看出立体感”的效果。</p>
 <h3 id="g-buffer-geometry-buffer" class="tsd-anchor-link">G-Buffer / Geometry Buffer<a href="#g-buffer-geometry-buffer" 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>用于后处理的几何缓冲区，包含深度 (Depth)、法线 (Normal)、ID 等信息，用于实现高级特效（如轮廓线、SSAO）。</p>
+<h3 id="viewlayer" class="tsd-anchor-link">ViewLayer<a href="#viewlayer" 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>管理 <code>Model</code> 内部特定 3D 资源（如 Mesh、PointCloud、Gaussian Splatting）的图层。</p>
+<ul>
+<li>继承自 <code>Tile3D</code>。</li>
+<li>拥有独立的 <code>Parameter</code> 配置（覆盖上层配置）。</li>
+<li>支持可见性控制 (<code>visible</code>) 和优先级加载。</li>
+</ul>
+<h3 id="gaussian-splatting" class="tsd-anchor-link">Gaussian Splatting<a href="#gaussian-splatting" 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>一种基于点的 3D 渲染技术，通过各向异性高斯球（Splat）来表示场景。</p>
+<ul>
+<li>相比传统 Mesh，能更真实地还原复杂光照和细节。</li>
+<li>Five 支持 <code>.spz</code> 和 <code>.splat</code> 格式的 Gaussian Splatting 渲染。</li>
+</ul>
+<h3 id="3d-tiles-refinement-细化" class="tsd-anchor-link">3D Tiles Refinement (细化)<a href="#3d-tiles-refinement-细化" 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>3D Tiles 加载过程中的状态概念：</p>
+<ul>
+<li><strong>Loaded (已加载)</strong>: 瓦片的基本数据已下载并解析，满足最低显示要求 (<code>minLevelOfDetail</code>)。</li>
+<li><strong>Refined (已细化)</strong>: 瓦片已加载最高质量数据，满足当前视角的屏幕空间误差要求 (<code>maxScreenSpaceError</code>)。</li>
+<li><code>five.model.refineProgress</code> 可用于监控当前视角的细化进度。</li>
+</ul>
 <h2 id="interaction-交互" class="tsd-anchor-link">Interaction (交互)<a href="#interaction-交互" 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="raycast-射线检测" class="tsd-anchor-link">Raycast (射线检测)<a href="#raycast-射线检测" 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>将屏幕上的 2D 点击坐标转换为 3D 空间中的射线，用于检测用户点击了哪个物体（如点击地面移动、点击标签）。</p>
@@ -63,7 +88,7 @@
 <li><strong>Pinch</strong>: 双指缩放。</li>
 </ul>
 <hr>
-<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">glossary</span><span class="hl-1">, </span><span class="hl-2">terminology</span><span class="hl-1">, </span><span class="hl-2">definitions</span><span class="hl-1">]</span>
+<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">术语</span><span class="hl-1">, </span><span class="hl-2">概念</span><span class="hl-1">, </span><span class="hl-2">glossary</span><span class="hl-1">, </span><span class="hl-2">terminology</span><span class="hl-1">, </span><span class="hl-2">definitions</span><span class="hl-1">, </span><span class="hl-2">observer</span><span class="hl-1">, </span><span class="hl-2">pose</span><span class="hl-1">, </span><span class="hl-2">mode</span><span class="hl-1">, </span><span class="hl-2">work</span><span class="hl-1">, </span><span class="hl-2">panoindex</span><span class="hl-1">, </span><span class="hl-2">fov</span><span class="hl-1">, </span><span class="hl-2">viewlayer</span><span class="hl-1">, </span><span class="hl-2">gaussian-splatting</span><span class="hl-1">, </span><span class="hl-2">3dtile</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="#glossary-术语表"><span>Glossary (术语表)</span></a><ul><li><a href="#core-entities-核心实体"><span>Core <wbr/>Entities (核心实体)</span></a></li><li><ul><li><a href="#five"><span>Five</span></a></li><li><a href="#work"><span>Work</span></a></li><li><a href="#observer"><span>Observer</span></a></li></ul></li><li><a href="#state-coordinates-状态与坐标"><span>State &amp; <wbr/>Coordinates (状态与坐标)</span></a></li><li><ul><li><a href="#mode-模式"><span>Mode (模式)</span></a></li><li><a href="#pose-位姿"><span>Pose (位姿)</span></a></li><li><a href="#panoindex"><span>Pano<wbr/>Index</span></a></li><li><a href="#fov-field-of-view"><span>Fov (<wbr/>Field of <wbr/>View)</span></a></li></ul></li><li><a href="#rendering-渲染"><span>Rendering (渲染)</span></a></li><li><ul><li><a href="#pano-tile-全景瓦片"><span>Pano <wbr/>Tile (全景瓦片)</span></a></li><li><a href="#quasi-mesh"><span>Quasi / <wbr/>Mesh</span></a></li><li><a href="#g-buffer-geometry-buffer"><span>G-<wbr/>Buffer / <wbr/>Geometry <wbr/>Buffer</span></a></li></ul></li><li><a href="#interaction-交互"><span>Interaction (交互)</span></a></li><li><ul><li><a href="#raycast-射线检测"><span>Raycast (射线检测)</span></a></li><li><a href="#tap-press--pan--pinch"><span>Tap / <wbr/>Press / <wbr/>Pan / <wbr/>Pinch</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="#glossary-术语表"><span>Glossary (术语表)</span></a><ul><li><a href="#core-entities-核心实体"><span>Core <wbr/>Entities (核心实体)</span></a></li><li><ul><li><a href="#five"><span>Five</span></a></li><li><a href="#work"><span>Work</span></a></li><li><a href="#vertex-marks-顶点标记"><span>Vertex <wbr/>Marks (顶点标记)</span></a></li><li><a href="#observer"><span>Observer</span></a></li></ul></li><li><a href="#state-coordinates-状态与坐标"><span>State &amp; <wbr/>Coordinates (状态与坐标)</span></a></li><li><ul><li><a href="#mode-模式"><span>Mode (模式)</span></a></li><li><a href="#pose-位姿"><span>Pose (位姿)</span></a></li><li><a href="#panoindex"><span>Pano<wbr/>Index</span></a></li><li><a href="#fov-field-of-view"><span>Fov (<wbr/>Field of <wbr/>View)</span></a></li></ul></li><li><a href="#rendering-渲染"><span>Rendering (渲染)</span></a></li><li><ul><li><a href="#pano-tile-全景瓦片"><span>Pano <wbr/>Tile (全景瓦片)</span></a></li><li><a href="#mesh-三维网格"><span>Mesh (三维网格)</span></a></li><li><a href="#g-buffer-geometry-buffer"><span>G-<wbr/>Buffer / <wbr/>Geometry <wbr/>Buffer</span></a></li><li><a href="#viewlayer"><span>View<wbr/>Layer</span></a></li><li><a href="#gaussian-splatting"><span>Gaussian <wbr/>Splatting</span></a></li><li><a href="#3d-tiles-refinement-细化"><span>3<wbr/>D <wbr/>Tiles <wbr/>Refinement (细化)</span></a></li></ul></li><li><a href="#interaction-交互"><span>Interaction (交互)</span></a></li><li><ul><li><a href="#raycast-射线检测"><span>Raycast (射线检测)</span></a></li><li><a href="#tap-press--pan--pinch"><span>Tap / <wbr/>Press / <wbr/>Pan / <wbr/>Pinch</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>

package/docs/documents/intro.html

@@ -7,7 +7,7 @@
 <ul>
 <li><strong>全景浏览</strong>: 支持高分辨率全景图的高效加载与平滑浏览。详见 <a href="features_pano-tile.html">Pano Tile</a>。</li>
 <li><strong>空间漫游</strong>: 支持在三维模型中自由行走、跳转。详见 <a href="features_mode.html">Mode</a>。</li>
-<li><strong>模型渲染</strong>: 内置高效的模型加载策略 (3DTile)。详见 <a href="features_model.html">Model</a>。</li>
+<li><strong>模型渲染</strong>: 内置高效的模型加载策略 (3DTile) 与灵活的材质配置。详见 <a href="features_model.html">Model</a> 与 <a href="features_material.html">Material</a>。</li>
 <li><strong>交互事件</strong>: 完善的事件系统，支持手势、射线检测等。详见 <a href="features_event.html">Event</a> 与 <a href="features_raycast.html">Raycast</a>。</li>
 <li><strong>状态管理</strong>: 统一的 State 设计，便于状态保存与还原。详见 <a href="features_state.html">State</a>。</li>
 </ul>

package/docs/documents/quick-start.html

@@ -21,6 +21,7 @@
 <li><strong>控制视角与移动</strong>: 了解如何通过代码控制相机。 -&gt; <a href="features_five.html">Five.updateCamera</a> / <a href="features_state.html">State</a></li>
 <li><strong>切换模态</strong>: 在全景、模型、平面图之间切换。 -&gt; <a href="features_mode.html">Mode</a></li>
 <li><strong>监听事件</strong>: 响应用户的点击和交互。 -&gt; <a href="features_event.html">Event</a></li>
+<li><strong>视觉调整</strong>: 修改材质参数或开启后处理效果。 -&gt; <a href="features_material.html">Material</a> / <a href="features_postprocessing.html">Postprocessing</a></li>
 <li><strong>自定义配置</strong>: 修改图片加载参数或渲染效果。 -&gt; <a href="features_image-options.html">ImageOptions</a></li>
 </ul>
 <h2 id="related" class="tsd-anchor-link">Related<a href="#related" 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>

package/docs/documents/release_notes_6.8.html

@@ -0,0 +1,203 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>release_notes/6.8 | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="" aria-current="page">release_notes/6.8</a></li></ul></div><div class="tsd-panel tsd-typography"><h1 id="release-note-68x" class="tsd-anchor-link">Release Note 6.8.x<a href="#release-note-68x" 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></h1>
+<blockquote>
+<p>6.8.x 版本发布日志</p>
+</blockquote>
+<pre><code class="shell"><span class="hl-5">npm</span><span class="hl-1"> </span><span class="hl-9">install</span><span class="hl-1"> </span><span class="hl-9">@realsee/five@6.8</span>
+</code><button type="button">Copy</button></pre>
+
+<h2 id="gaussian-splatting-3dgs-支持" class="tsd-anchor-link">Gaussian Splatting (3DGS) 支持<a href="#gaussian-splatting-3dgs-支持" 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>Five 现已支持 Gaussian Splatting (3DGS) 渲染管线。这是一种基于点的渲染技术，能够提供高质量的实时渲染效果。
+仅在 WebGL2 环境下可用。</p>
+</blockquote>
+<h3 id="文件格式支持" class="tsd-anchor-link">文件格式支持<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>
+<ol>
+<li><code>.splat</code> 文档及工具 <a href="https://github.com/antimatter15/splat">GitHub - antimatter15/splat: WebGL 3D Gaussian Splat Viewer</a></li>
+<li><code>.spz</code> 文档及工具 GitHub - <a href="https://github.com/nianticlabs/spz">nianticlabs/spz: File format for 3D Gaussian splats. About 10x smaller than the PLY equival</a></li>
+<li><code>.glb</code> <code>.gltf</code> 对应的 KHR_gaussian_splatting, KHR_gaussian_splatting_compression_spz, KHR_gaussian_splatting_compression_spz_2 扩展。</li>
+</ol>
+<h3 id="支持-3d-tile" class="tsd-anchor-link">支持 3d-tile<a href="#支持-3d-tile" 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>通过 3d-tile 标准，使用 glb 作为模型格式。</p>
+</blockquote>
+<pre><code class="json"><span class="hl-1">{</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;asset&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;version&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;1.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;geometricError&quot;</span><span class="hl-1">: </span><span class="hl-11">265.4529731527354</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;root&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;boundingVolume&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">       </span><span class="hl-14">&quot;box&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">         </span><span class="hl-11">0.9499778747558594</span><span class="hl-1">,  </span><span class="hl-11">3.5037269592285156</span><span class="hl-1">,    </span><span class="hl-11">17.48550033569336</span><span class="hl-1">,</span><br/><span class="hl-1">         </span><span class="hl-11">97.01779174804688</span><span class="hl-1">,   </span><span class="hl-11">0.0</span><span class="hl-1">,                   </span><span class="hl-11">0.0</span><span class="hl-1">,</span><br/><span class="hl-1">         </span><span class="hl-11">0.0</span><span class="hl-1">,                 </span><span class="hl-11">88.27268981933594</span><span class="hl-1">,     </span><span class="hl-11">0.0</span><span class="hl-1">,</span><br/><span class="hl-1">         </span><span class="hl-11">0.0</span><span class="hl-1">,                 </span><span class="hl-11">0.0</span><span class="hl-1">,                   </span><span class="hl-11">20.292869567871094</span><br/><span class="hl-1">       ]</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;content&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;uri&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;splat.glb&quot;</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;geometricError&quot;</span><span class="hl-1">: </span><span class="hl-11">66.36324328818385</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;refine&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;ADD&quot;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;transform&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">     </span><span class="hl-11">1.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,</span><br/><span class="hl-1">     </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">1.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,</span><br/><span class="hl-1">     </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">1.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,</span><br/><span class="hl-1">     </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">0.0</span><span class="hl-1">,      </span><span class="hl-11">1.0</span><br/><span class="hl-1">   ]</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+
+<h3 id="通过-work-加载" class="tsd-anchor-link">通过 Work 加载<a href="#通过-work-加载" 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>
+<pre><code class="json"><span class="hl-1">{</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;work_code&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;model&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;layers&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">       </span><span class="hl-14">&quot;tileset_url&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;tileset.json&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">       </span><span class="hl-14">&quot;name&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;poincare_3dgs&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">       </span><span class="hl-14">&quot;type&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;gaussian_splatting&quot;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+
+<h3 id="配置球谐光照阶数-sh-degree" class="tsd-anchor-link">配置球谐光照阶数 (SH Degree)<a href="#配置球谐光照阶数-sh-degree" 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>可以通过 <code>five.parameter.gaussianSplattingSHDegree</code> 设置球谐光照阶数，支持 0, 1, 2 阶，默认为 0 阶。</p>
+<pre><code><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1">    </span><span class="hl-6">parameters:</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-6">gaussianSplattingSHDegree:</span><span class="hl-1"> </span><span class="hl-11">1</span><span class="hl-1"> </span><span class="hl-8">// 设置为 1 阶 SH</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">});</span>
+</code><button>Copy</button></pre>
+
+<h3 id="模型的射线检测" class="tsd-anchor-link">模型的射线检测<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>gaussian_splatting 的模型同时也支持 rayscast 射线检测。同点云的处理保持一致。但是因为 gaussian_splatting 的射线交点对应的法线方向是一个估算值，精度并不高。请酌情使用。</p>
+<h2 id="gltf-模型支持增强" class="tsd-anchor-link">glTF 模型支持增强<a href="#gltf-模型支持增强" 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>新增了对更多 glTF 扩展的支持，提升了模型的表现力和动画能力。</p>
+</blockquote>
+<h3 id="扩展新增及优化" class="tsd-anchor-link">扩展新增及优化<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>
+<h4 id="khr_animation_pointer" class="tsd-anchor-link">KHR_animation_pointer<a href="#khr_animation_pointer" 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>
+<blockquote>
+<p>KHR_animation_pointer 允许动画通道指向 glTF 资产中任何对象的任何属性。</p>
+</blockquote>
+<p>默认的 animtion 只能修改 node 的 transform 实现节点的平移、旋转和缩放</p>
+<p>这个能力可以实现材质动画。比如：</p>
+<ul>
+<li>通过 uv transform 实现 texture 的移动，变化贴图位置。</li>
+<li>通过修改 material 上的材质属性，可以动态修改金属粗糙，透明度，自发光程度。</li>
+<li>通过修改 node 的 KHR_node_visibility 的扩展值，显隐某个节点。</li>
+<li>等等</li>
+</ul>
+<h4 id="khr_node_visibility" class="tsd-anchor-link">KHR_node_visibility<a href="#khr_node_visibility" 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>
+<blockquote>
+<p>允许设置节点的可见性属性。
+用于 配合 KHR_animation_pointer 实现显隐效果。</p>
+</blockquote>
+<h4 id="khr_materials_clearcoat" class="tsd-anchor-link">KHR_materials_clearcoat<a href="#khr_materials_clearcoat" 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>
+<blockquote>
+<p>用于在材质上添加一层透明涂层，模拟车漆、碳纤维、清漆木材等真实世界中的表面效果。</p>
+</blockquote>
+<p>这个能力可以实现材质动画。比如</p>
+<ul>
+<li>漆面等光滑的表面</li>
+<li>塑料薄膜</li>
+<li>等等</li>
+</ul>
+<h4 id="khr_materials_transmission" class="tsd-anchor-link">KHR_materials_transmission<a href="#khr_materials_transmission" 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>
+<blockquote>
+<p>物理透光材质扩展，用于实现光线真正穿过物体的透明 / 半透明效果。</p>
+</blockquote>
+<p>这个能力可以实现材质动画。比如</p>
+<ul>
+<li>玻璃等即透光也反射的表面</li>
+<li>等等</li>
+</ul>
+<h4 id="khr_materials_emissive_strength" class="tsd-anchor-link">KHR_materials_emissive_strength<a href="#khr_materials_emissive_strength" 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>
+<blockquote>
+<p>调整自发光强度</p>
+</blockquote>
+<h4 id="khr_materials_unlit" class="tsd-anchor-link">KHR_materials_unlit<a href="#khr_materials_unlit" 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>
+<blockquote>
+<p>不感光材质
+正确解析 KHR_materials_unlit。是否感光作用到对应的 material 上，而不是 gltf 中的所有元素。</p>
+</blockquote>
+<h3 id="动画优化" class="tsd-anchor-link">动画优化<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>
+<ul>
+<li>处理额外动画骨骼未绑定导致的错误，出现的抖动。</li>
+<li>修复 glTF 骨骼 weight 为整型时，导致 boneTransform 计算出错进而引发射线检测错误的问题。gltf parser 在加载非 float 数据时，现已自动转换为 float 使用。</li>
+</ul>
+<h2 id="模型-viewlayer-加载策略优化" class="tsd-anchor-link">模型 ViewLayer 加载策略优化<a href="#模型-viewlayer-加载策略优化" 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>优化了 ViewLayer 的加载和显隐逻辑，以减少内存占用并提高性能。</p>
+</blockquote>
+<h4 id="默认加载策略变更" class="tsd-anchor-link">默认加载策略变更<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></h4>
+<p>默认情况下，Five 不再加载所有图层，而是根据优先级仅加载一个图层。
+优先级顺序：mesh &gt; point_cloud &gt; gaussian_splatting &gt; 其他类型。</p>
+<h4 id="显隐与内存管理" class="tsd-anchor-link">显隐与内存管理<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></h4>
+<ul>
+<li>显示: 当 viewLayer.visible = true 时，开始加载资源。</li>
+<li>隐藏: 当 viewLayer.visible = false 时，释放该图层占用的所有内存资源。</li>
+</ul>
+<h4 id="加载进度" class="tsd-anchor-link">加载进度<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></h4>
+<ul>
+<li>新增 tile.content.loadProgress 属性，用于查看每个瓦片的加载进度 (0-1)。</li>
+<li>新增 tile.content.byteLength 属性，可在加载过程中获取瓦片内容的字节长度。</li>
+<li>同时，model.tileLoad 和 model.tileUnload 事件被添加，用于监控瓦片的生命周期。</li>
+<li>加载函数（loadGltf, loadPly 等）现在支持 onDownloadProgress 回调，用于监控文件下载进度。</li>
+</ul>
+<h4 id="射线检测增强" class="tsd-anchor-link">射线检测增强<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></h4>
+<ul>
+<li>射线交点 Intersection 对象新增了 tile, model, viewLayer 字段，便于在射线检测时获取更详细的上下文信息。</li>
+<li>raycaster.hitFilter 回调函数的参数类型定义已更新，包含 model, viewLayer, tile 等上下文信息。</li>
+</ul>
+<h2 id="work-结构改变" class="tsd-anchor-link">Work 结构改变<a href="#work-结构改变" 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="observer-支持-uv-计算工具函数" class="tsd-anchor-link">Observer 支持 uv 计算工具函数<a href="#observer-支持-uv-计算工具函数" 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>为 WorkObserver 提供了更多实用的工具函数，便于进行坐标和 UV 转换。
+UV 转换工具函数</p>
+<ul>
+<li>observer.vectorToEquirectangularUv: 将方向向量转化为全景图 uv。</li>
+<li>observer.equirectangularUvToVector: 将全景图 uv 转化为方向向量。</li>
+<li>observer.vectorToCubemapUv: 将方向向量转化为立方体贴图 uv。</li>
+<li>observer.cubemapUvToVector: 将立方体贴图 uv 转化为方向向量。</li>
+</ul>
+<h3 id="fivepanoid" class="tsd-anchor-link">five.panoId<a href="#fivepanoid" 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>新增 <code>five.panoId</code> 属性，使其与 <code>work.observer</code> 保持一致。</p>
+<h3 id="derived_id-类型变更" class="tsd-anchor-link">derived_id 类型变更<a href="#derived_id-类型变更" 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>derived_id 的类型从 <code>number</code> 改为 <code>number | string</code>。</p>
+<h2 id="全景图滤镜" class="tsd-anchor-link">全景图滤镜<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></h2>
+<p>新增了全景图滤镜功能，支持实时调整全景图的亮度、对比度、饱和度、色温和色调等参数。</p>
+<p>通过 <code>five.modelScene.parameter.set('panoFilter', filter)</code> 绑定。
+支持的参数如下：</p>
+<ul>
+<li>color: 颜色调整，包含色温 (Temperature) 和色调 (Tint)。</li>
+<li>highlightShadow: 高光和阴影的独立调节。包括高光 (Highlight) 和阴影 (Shadow) 全局（Global）。</li>
+<li>contrast: 对比度调整。</li>
+<li>saturation: 饱和度调整。</li>
+</ul>
+<h2 id="新增后处理效果-post-processing-passes" class="tsd-anchor-link">新增后处理效果 (Post-Processing Passes)<a href="#新增后处理效果-post-processing-passes" 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>新增了三个可选的内置后处理 Pass，用于增强视觉效果。</p>
+<ul>
+<li>FlowingLight2DPass: 2D 流光效果，通常用于在屏幕空间绘制流动的光线（如道路流光）。</li>
+<li>FlowingLight3DPass: 3D 流光效果，基于深度缓冲区在三维模型表面绘制流光。</li>
+<li>GaussianBlurPass: 高斯模糊效果，可用于实现毛玻璃等视觉特效。</li>
+</ul>
+<h2 id="工具优化" class="tsd-anchor-link">工具优化<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></h2>
+<h3 id="work-viewer" class="tsd-anchor-link">Work Viewer<a href="#work-viewer" 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="https://vradmin.lianjia.com/project/">https://vradmin.lianjia.com/project/</a></p>
+</blockquote>
+<ul>
+<li>支持 debug -&gt; stateSync。可以打开两个页面，均开启 stateSync。两边同步相机状态。</li>
+<li>支持 work.json 拖拽加载加载。</li>
+</ul>
+<h3 id="model-viewer" class="tsd-anchor-link">Model Viewer<a href="#model-viewer" 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="https://vradmin.lianjia.com/poincare/">https://vradmin.lianjia.com/poincare/</a></p>
+</blockquote>
+<ul>
+<li>支持 debug -&gt; stateSync。可以打开两个页面，均开启 stateSync。两边同步相机状态。</li>
+<li>支持 模型文件拖拽加载加载。</li>
+</ul>
+<h3 id="gltf-viewer" class="tsd-anchor-link">glTF Viewer<a href="#gltf-viewer" 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="https://vradmin.lianjia.com/gltf/">https://vradmin.lianjia.com/gltf/</a></p>
+</blockquote>
+<ul>
+<li>支持 debug -&gt; stateSync。可以打开两个页面，均开启 stateSync。两边同步相机状态。</li>
+<li>支持 模型文件拖拽加载加载。</li>
+<li>支持 额外绑定动画文件（仅读取 gltf 的 animations 的部分，并绑定到当前的模型上）。</li>
+<li>支持 额外绑定动画的单独播放和暂停。</li>
+</ul>
+<h2 id="友好文档" class="tsd-anchor-link">友好文档<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></h2>
+<p>全面重构了文档结构，使其更适合 AI 辅助编程工具 (如 Cursor, Copilot) 阅读和索引。</p>
+<ul>
+<li>文档目录迁移至 ai_guides/，并在 package.json 中新增 ai 字段指向该目录。</li>
+<li>文档内容包含源码链接 (source 字段)，直接指向对应的 .ts 定义文件。</li>
+<li>提供了更清晰的 API 定义和概念说明，例如新增了 ViewLayer 的详细文档。</li>
+<li>TypeScript 支持: 优化了 .d.ts 打包方式，声明文件现在与源码文件一一对应，提升了 IDE 的跳转体验。</li>
+</ul>
+<h2 id="其他" class="tsd-anchor-link">其他<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></h2>
+<ol>
+<li>优化 mapview 下滚动缩放。避免滚落所发有时会退回的问题。</li>
+<li>优化 floorplan 从下向上看时的交互的屏幕上下滑动反人类下意识的问题。</li>
+<li>优化 camera.autoNearFar 的计算结果。优化对于小物品的 near 过远以及 出现 z-fighting 的问题。</li>
+<li>添加了 gesture.fire 事件，发生在任意事件被触发。</li>
+<li>gestureEvent.center gestureEvent.pointers 中加入了 buttons button shiftKey ctrlKey metaKey altKey 字段。</li>
+<li>修复 gesture.momentum 前没有触发 gesture.create 的问题。</li>
+<li>修复 gesture.pan 中 preventDefault 无法阻止触发 gesture.momentum 的问题。</li>
+<li>修复 gesture.pan 中第一次并没有 event.isFirst = true 的问题。</li>
+<li>添加自定义着色器 mainPanoColor 插入点，可以修改 pano0Color、pano1Color。</li>
+<li>新增 <code>parameter.resolveValue('xxx')</code> 快速获取单个参数的最终值，无需创建完整的 <code>ResolvedParameterValue</code> 对象。</li>
+<li>新增 <code>pano.prepare</code> 事件（ExtendableEvent），支持通过 <code>waitUntil(promise)</code> 在点位切换前插入异步操作。<code>PanoEvent</code> 和 <code>PanoPrepareEvent</code> 新增 <code>pano</code> 字段，包含目标点位信息。</li>
+</ol>
+<h2 id="内部机制改动" class="tsd-anchor-link">内部机制改动<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></h2>
+<ol>
+<li>glTF 加载 mesh / points 都将直接使用 PBM 材质，而不是作为 PBM_Mesh 扩展形式去替换覆盖使用three内置材质的方式。</li>
+<li>应用 animation pointer 以及 动画优化的原因。目前会重写 hack THREE.PropertyBinding.findNode。</li>
+<li>打包不再合并 .d.ts 文件。便于文档可以更便于找到对应的类型声明。</li>
+<li>Parameter 性能优化：新增 <code>resolveValueTo</code> 支持对象复用以减少 GC，版本标识改用整数哈希（<code>versionNumber: number</code>）替代字符串拼接。</li>
+</ol>
+</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="#release-note-68x"><span>Release <wbr/>Note 6.8.x</span></a><ul><li><a href="#gaussian-splatting-3dgs-支持"><span>Gaussian <wbr/>Splatting (3<wbr/>DGS) 支持</span></a></li><li><ul><li><a href="#文件格式支持"><span>文件格式支持</span></a></li><li><a href="#支持-3d-tile"><span>支持 3d-<wbr/>tile</span></a></li><li><a href="#通过-work-加载"><span>通过 <wbr/>Work 加载</span></a></li><li><a href="#配置球谐光照阶数-sh-degree"><span>配置球谐光照阶数 (<wbr/>SH <wbr/>Degree)</span></a></li><li><a href="#模型的射线检测"><span>模型的射线检测</span></a></li></ul></li><li><a href="#gltf-模型支持增强"><span>gl<wbr/>TF 模型支持增强</span></a></li><li><ul><li><a href="#扩展新增及优化"><span>扩展新增及优化</span></a></li><li><ul><li><a href="#khr_animation_pointer"><span>KHR_<wbr/>animation_<wbr/>pointer</span></a></li><li><a href="#khr_node_visibility"><span>KHR_<wbr/>node_<wbr/>visibility</span></a></li><li><a href="#khr_materials_clearcoat"><span>KHR_<wbr/>materials_<wbr/>clearcoat</span></a></li><li><a href="#khr_materials_transmission"><span>KHR_<wbr/>materials_<wbr/>transmission</span></a></li><li><a href="#khr_materials_emissive_strength"><span>KHR_<wbr/>materials_<wbr/>emissive_<wbr/>strength</span></a></li><li><a href="#khr_materials_unlit"><span>KHR_<wbr/>materials_<wbr/>unlit</span></a></li></ul></li><li><a href="#动画优化"><span>动画优化</span></a></li></ul></li><li><a href="#模型-viewlayer-加载策略优化"><span>模型 <wbr/>View<wbr/>Layer 加载策略优化</span></a></li><li><ul><li><ul><li><a href="#默认加载策略变更"><span>默认加载策略变更</span></a></li><li><a href="#显隐与内存管理"><span>显隐与内存管理</span></a></li><li><a href="#加载进度"><span>加载进度</span></a></li><li><a href="#射线检测增强"><span>射线检测增强</span></a></li></ul></li></ul></li><li><a href="#work-结构改变"><span>Work 结构改变</span></a></li><li><ul><li><a href="#observer-支持-uv-计算工具函数"><span>Observer 支持 uv 计算工具函数</span></a></li><li><a href="#fivepanoid"><span>five.pano<wbr/>Id</span></a></li><li><a href="#derived_id-类型变更"><span>derived_<wbr/>id 类型变更</span></a></li></ul></li><li><a href="#全景图滤镜"><span>全景图滤镜</span></a></li><li><a href="#新增后处理效果-post-processing-passes"><span>新增后处理效果 (<wbr/>Post-<wbr/>Processing <wbr/>Passes)</span></a></li><li><a href="#工具优化"><span>工具优化</span></a></li><li><ul><li><a href="#work-viewer"><span>Work <wbr/>Viewer</span></a></li><li><a href="#model-viewer"><span>Model <wbr/>Viewer</span></a></li><li><a href="#gltf-viewer"><span>gl<wbr/>TF <wbr/>Viewer</span></a></li></ul></li><li><a href="#友好文档"><span>友好文档</span></a></li><li><a href="#其他"><span>其他</span></a></li><li><a href="#内部机制改动"><span>内部机制改动</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/template.html

@@ -7,11 +7,57 @@
 <li><strong>Examples</strong>: 简述提供的示例类型。</li>
 </ul>
 <h2 id="schema" class="tsd-anchor-link">Schema<a href="#schema" 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>(这里放置 Interface 定义、TS 类型或参数表)</p>
+<!--
+  ⚠️ AI 注意：以下 Definition 链接使用了反引号包裹（代码块格式），这是模板的占位符写法，
+  目的是避免构建时因路径不存在而报错。
+  在编写正式文档时，必须将其还原为标准 Markdown 链接（去掉反引号），并确保路径指向真实存在的 .ts 文件。
+-->
+<blockquote>
+<p><strong>Definition</strong>: <code>[InterfaceName](../../five/path/to/source.d.ts)</code> 或多个 <code>[Main](../../lib/...)</code>, <code>[Options](../../lib/...)</code></p>
+</blockquote>
+<p>(这里放置 Interface 定义、TS 类型或参数表。务必包含 Definition 源码链接。)</p>
 <h2 id="concepts" class="tsd-anchor-link">Concepts<a href="#concepts" 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>(这里解释核心概念、术语定义及业务逻辑)</p>
 <h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#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>(可选：初始化参数、配置项说明，建议使用表格形式)</p>
+<p>(可选：初始化参数、配置项说明。若参数较多，请按以下分类展示)</p>
+<h3 id="common-configuration-常用配置" class="tsd-anchor-link">Common Configuration (常用配置)<a href="#common-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></h3>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Parameter</th>
+<th style="text-align:left">Type</th>
+<th style="text-align:left">Default</th>
+<th style="text-align:left">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>key</code></td>
+<td style="text-align:left"><code>type</code></td>
+<td style="text-align:left"><code>default</code></td>
+<td style="text-align:left">Description.</td>
+</tr>
+</tbody>
+</table>
+<h3 id="advanced-configuration-进阶配置" class="tsd-anchor-link">Advanced Configuration (进阶配置)<a href="#advanced-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></h3>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Parameter</th>
+<th style="text-align:left">Type</th>
+<th style="text-align:left">Default</th>
+<th style="text-align:left">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>key</code></td>
+<td style="text-align:left"><code>type</code></td>
+<td style="text-align:left"><code>default</code></td>
+<td style="text-align:left">Description.</td>
+</tr>
+</tbody>
+</table>
 <h2 id="instance-properties" class="tsd-anchor-link">Instance Properties<a href="#instance-properties" 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>(可选：类文档专用，列出关键属性及类型)</p>
 <h2 id="instance-methods" class="tsd-anchor-link">Instance Methods<a href="#instance-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>
@@ -29,11 +75,15 @@
 <li><strong>坑点2</strong>: ...</li>
 </ol>
 <h2 id="related" class="tsd-anchor-link">Related<a href="#related" 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>
+<!--
+  ⚠️ AI 注意：以下链接同样使用了反引号包裹（占位符写法）。
+  在编写正式文档时，必须还原为可点击的标准 Markdown 链接，并确保路径指向真实存在的文件。
+-->
 <ul>
-<li><a href="">template.md</a>: 描述。</li>
+<li><code>[RelatedConcept](./related-concept.md)</code>: 简述关联关系。</li>
 </ul>
 <hr>
 <pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">keywords</span><span class="hl-1">, </span><span class="hl-2">tags</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="#功能名称-中文名称"><span>功能名称 (中文名称)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><a href="#concepts"><span>Concepts</span></a></li><li><a href="#configuration"><span>Configuration</span></a></li><li><a href="#instance-properties"><span>Instance <wbr/>Properties</span></a></li><li><a href="#instance-methods"><span>Instance <wbr/>Methods</span></a></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#快速上手-quick-example"><span>快速上手 (<wbr/>Quick <wbr/>Example)</span></a></li><li><a href="#进阶用法-advanced-usage"><span>进阶用法 (<wbr/>Advanced <wbr/>Usage)</span></a></li></ul></li><li><a href="#debugging"><span>Debugging</span></a></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</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="#功能名称-中文名称"><span>功能名称 (中文名称)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><a href="#concepts"><span>Concepts</span></a></li><li><a href="#configuration"><span>Configuration</span></a></li><li><ul><li><a href="#common-configuration-常用配置"><span>Common <wbr/>Configuration (常用配置)</span></a></li><li><a href="#advanced-configuration-进阶配置"><span>Advanced <wbr/>Configuration (进阶配置)</span></a></li></ul></li><li><a href="#instance-properties"><span>Instance <wbr/>Properties</span></a></li><li><a href="#instance-methods"><span>Instance <wbr/>Methods</span></a></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#快速上手-quick-example"><span>快速上手 (<wbr/>Quick <wbr/>Example)</span></a></li><li><a href="#进阶用法-advanced-usage"><span>进阶用法 (<wbr/>Advanced <wbr/>Usage)</span></a></li></ul></li><li><a href="#debugging"><span>Debugging</span></a></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</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/functions/five.createDebugBoundingMesh.html

@@ -1 +1 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>createDebugBoundingMesh | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/five.html">five</a></li><li><a href="" aria-current="page">createDebugBoundingMesh</a></li></ul><h1>Function createDebugBoundingMesh</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="createdebugboundingmesh"><span class="tsd-kind-call-signature">createDebugBoundingMesh</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">boundingVolume</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/five.BoundingVolume.html" class="tsd-signature-type tsd-kind-interface">BoundingVolume</a><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">level</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">LineSegments</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">BufferGeometry</span><span class="tsd-signature-symbol">,</span> <span class="tsd-signature-type">LineBasicMaterial</span><span class="tsd-signature-symbol">&gt;</span><a href="#createdebugboundingmesh" 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></div><div class="tsd-description"><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">boundingVolume</span>: <a href="../interfaces/five.BoundingVolume.html" class="tsd-signature-type tsd-kind-interface">BoundingVolume</a></span></li><li><span><span class="tsd-kind-parameter">level</span>: <span class="tsd-signature-type">number</span><span class="tsd-signature-symbol"> = 0</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">LineSegments</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">BufferGeometry</span><span class="tsd-signature-symbol">,</span> <span class="tsd-signature-type">LineBasicMaterial</span><span class="tsd-signature-symbol">&gt;</span></h4><aside class="tsd-sources"><ul><li>Defined in lib/five/utils/volume.ts:795</li></ul></aside></div></li></ul></section></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></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>
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>createDebugBoundingMesh | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/five.html">five</a></li><li><a href="" aria-current="page">createDebugBoundingMesh</a></li></ul><h1>Function createDebugBoundingMesh</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="createdebugboundingmesh"><span class="tsd-kind-call-signature">createDebugBoundingMesh</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">boundingVolume</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/five.BoundingVolume.html" class="tsd-signature-type tsd-kind-interface">BoundingVolume</a><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">level</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">LineSegments</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">BufferGeometry</span><span class="tsd-signature-symbol">,</span> <span class="tsd-signature-type">LineBasicMaterial</span><span class="tsd-signature-symbol">&gt;</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span><a href="#createdebugboundingmesh" 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></div><div class="tsd-description"><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">boundingVolume</span>: <a href="../interfaces/five.BoundingVolume.html" class="tsd-signature-type tsd-kind-interface">BoundingVolume</a></span></li><li><span><span class="tsd-kind-parameter">level</span>: <span class="tsd-signature-type">number</span><span class="tsd-signature-symbol"> = 0</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">LineSegments</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">BufferGeometry</span><span class="tsd-signature-symbol">,</span> <span class="tsd-signature-type">LineBasicMaterial</span><span class="tsd-signature-symbol">&gt;</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span></h4><aside class="tsd-sources"><ul><li>Defined in lib/five/utils/volume.ts:795</li></ul></aside></div></li></ul></section></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></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>