@realsee/five 6.8.0-alpha.1 → 6.8.0-alpha.10

package/docs/documents/release_notes_6.7.html

@@ -2,7 +2,7 @@
 <blockquote>
 <p>6.7.x 版本发布日志</p>
 </blockquote>
-<pre><code class="shell"><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">install</span><span class="hl-1"> </span><span class="hl-2">@realsee/five@6.7</span>
+<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.7</span>
 </code><button type="button">Copy</button></pre>
 
 <h2 id="fivelaod-的多-work-的非阻塞性加载" class="tsd-anchor-link">five.laod 的多 Work 的非阻塞性加载<a href="#fivelaod-的多-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>
@@ -12,7 +12,7 @@
 这方面的改动只要适用于多项目下，项目追加，分批次加载的情况。</p>
 </blockquote>
 <h3 id="使用-在控制-替换--追加项目" class="tsd-anchor-link">使用 <code>FiveLoadOptions.mode</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>
-<pre><code class="ts"><span class="hl-8">// 替换项目</span><br/><span class="hl-8">// mode: &#39;replace&#39; 默认</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-0">load</span><span class="hl-1">([</span><span class="hl-0">parseWork</span><span class="hl-1">(</span><span class="hl-4">json1</span><span class="hl-1">), </span><span class="hl-0">parseWork</span><span class="hl-1">(</span><span class="hl-4">json2</span><span class="hl-1">)], </span><span class="hl-2">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-4">mode:</span><span class="hl-1"> </span><span class="hl-2">&#39;replace&#39;</span><span class="hl-1"> });</span><br/><br/><span class="hl-8">// 追加项目</span><br/><span class="hl-8">// mode: &#39;add&#39;</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-0">load</span><span class="hl-1">(</span><span class="hl-0">parseWork</span><span class="hl-1">(</span><span class="hl-4">json2</span><span class="hl-1">), </span><span class="hl-2">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-4">mode:</span><span class="hl-1"> </span><span class="hl-2">&#39;add&#39;</span><span class="hl-1"> });</span>
+<pre><code class="ts"><span class="hl-8">// 替换项目</span><br/><span class="hl-8">// mode: &#39;replace&#39; 默认</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">([</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json1</span><span class="hl-1">), </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json2</span><span class="hl-1">)], </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;replace&#39;</span><span class="hl-1"> });</span><br/><br/><span class="hl-8">// 追加项目</span><br/><span class="hl-8">// mode: &#39;add&#39;</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json2</span><span class="hl-1">), </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;add&#39;</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
 
 <p>注意事项：</p>
@@ -21,7 +21,7 @@
 <li>如果通过 <code>replace</code> 替换的 Work 的 <code>workCode</code> 和当前场景中有一样的（相当于替换一个一样的 Work），则会保留之前的 Work 的模型，直接挂在到新 Work 上，而不是重新加载。</li>
 </ul>
 <h3 id="重新定义-的行为" class="tsd-anchor-link">重新定义 <code>state=inherit</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>
-<pre><code class="ts"><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-0">load</span><span class="hl-1">(</span><span class="hl-0">parseWork</span><span class="hl-1">(</span><span class="hl-4">json</span><span class="hl-1">), </span><span class="hl-2">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-4">mode:</span><span class="hl-1"> </span><span class="hl-2">&#39;add&#39;</span><span class="hl-1"> });</span>
+<pre><code class="ts"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1">), </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;add&#39;</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
 
 <p>当 <code>state=inherit</code> 时，在切换过程中，可以不再发生切换/锁定视角等妨碍用户持续操作的行为。</p>
@@ -39,11 +39,11 @@
 panoram 中的 hash，index 等参数的重复度很高，对一样的内容可以通过这种方式减少文件长度。</p>
 </blockquote>
 <p>Before:</p>
-<pre><code class="json"><span class="hl-2">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-11">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-10">465</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-11">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-10">2048</span><span class="hl-1">, </span><span class="hl-10">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-10">1</span><span class="hl-1">, </span><span class="hl-10">2</span><span class="hl-1">, </span><span class="hl-10">3</span><span class="hl-1"> ],</span><br/><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">1</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-10">2048</span><span class="hl-1">, </span><span class="hl-10">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-10">1</span><span class="hl-1">, </span><span class="hl-10">2</span><span class="hl-1">, </span><span class="hl-10">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">2</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-10">2048</span><span class="hl-1">, </span><span class="hl-10">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-10">1</span><span class="hl-1">, </span><span class="hl-10">2</span><span class="hl-1">, </span><span class="hl-10">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">3</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-10">2048</span><span class="hl-1">, </span><span class="hl-10">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-10">1</span><span class="hl-1">, </span><span class="hl-10">2</span><span class="hl-1">, </span><span class="hl-10">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-12">...</span><br/><span class="hl-1">  ]</span><br/><span class="hl-1">}</span>
+<pre><code class="json"><span class="hl-9">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-11">465</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">1</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">2</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">3</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-15">...</span><br/><span class="hl-1">  ]</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 
 <p>After:</p>
-<pre><code class="json"><span class="hl-2">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-11">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-10">465</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-11">&quot;pattern&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;images/cube_2048/{index}/{hash}/{index}_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-10">2048</span><span class="hl-1">, </span><span class="hl-10">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">    </span><span class="hl-11">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-10">1</span><span class="hl-1">, </span><span class="hl-10">2</span><span class="hl-1">, </span><span class="hl-10">3</span><span class="hl-1">]</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-11">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;0fd265355dbb94cb22fb930e52dd3c19&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;a6ca1991fc6bdb2dbd1a1003d9f62394&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">1</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;567f94406885bf06f5586d7972da2b5e&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">2</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;fa70f0f26594d3023a3824c9a92033da&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-10">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-2">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-11">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-10">3</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-12">...</span><br/><span class="hl-1">  ]</span><br/><span class="hl-1">}</span>
+<pre><code class="json"><span class="hl-9">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-11">465</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;pattern&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1">    </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1">]</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-14">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;0fd265355dbb94cb22fb930e52dd3c19&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;a6ca1991fc6bdb2dbd1a1003d9f62394&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">1</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;567f94406885bf06f5586d7972da2b5e&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">2</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    {</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;fa70f0f26594d3023a3824c9a92033da&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">3</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-15">...</span><br/><span class="hl-1">  ]</span><br/><span class="hl-1">}</span>
 </code><button type="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>
@@ -53,7 +53,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <ul>
 <li>
 <p>可以通过 <code>work.getURL</code> 获取到完整地址。</p>
-<pre><code class="ts"><span class="hl-8">// 获取图片地址</span><br/><span class="hl-4">work</span><span class="hl-1">.</span><span class="hl-0">getURL</span><span class="hl-1">(</span><span class="hl-4">work</span><span class="hl-1">.</span><span class="hl-4">observers</span><span class="hl-1">[</span><span class="hl-10">0</span><span class="hl-1">].</span><span class="hl-4">image</span><span class="hl-1">.</span><span class="hl-4">left</span><span class="hl-1">);</span>
+<pre><code class="ts"><span class="hl-8">// 获取图片地址</span><br/><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-5">getURL</span><span class="hl-1">(</span><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-6">observers</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">].</span><span class="hl-6">image</span><span class="hl-1">.</span><span class="hl-6">left</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 
 </li>
@@ -106,7 +106,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 </ul>
 <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>扩展 threejs 的 Raycaster。 支持多个自定义参数。</p>
-<pre><code class="ts"><span class="hl-6">declare</span><span class="hl-1"> </span><span class="hl-6">module</span><span class="hl-1"> </span><span class="hl-2">&#39;three&#39;</span><span class="hl-1"> {</span><br/><br/><span class="hl-1">  </span><span class="hl-3">export</span><span class="hl-1"> </span><span class="hl-6">interface</span><span class="hl-1"> </span><span class="hl-7">Raycaster</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">/**</span><br/><span class="hl-8">     * 只捕获第一个交点</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-4">firstHitOnly</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">/**</span><br/><span class="hl-8">     * 对交点进行筛选</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-0">hitFilter</span><span class="hl-1">?: (</span><span class="hl-4">intersect</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Intersection</span><span class="hl-1">) </span><span class="hl-6">=&gt;</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">/**</span><br/><span class="hl-8">     * 作用楼层</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-4">floorIndex</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">}</span>
+<pre><code class="ts"><span class="hl-3">declare</span><span class="hl-1"> </span><span class="hl-3">module</span><span class="hl-1"> </span><span class="hl-9">&#39;three&#39;</span><span class="hl-1"> {</span><br/><br/><span class="hl-1">  </span><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Raycaster</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">/**</span><br/><span class="hl-8">     * 只捕获第一个交点</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-6">firstHitOnly</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">/**</span><br/><span class="hl-8">     * 对交点进行筛选</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-5">hitFilter</span><span class="hl-1">?: (</span><span class="hl-6">intersect</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Intersection</span><span class="hl-1">) </span><span class="hl-3">=&gt;</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">/**</span><br/><span class="hl-8">     * 作用楼层</span><br/><span class="hl-8">     */</span><br/><span class="hl-1">    </span><span class="hl-6">floorIndex</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 
 <ul>
@@ -123,7 +123,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <blockquote>
 <p>目的是通过有限的内存，获取到最清晰的模型效果。</p>
 </blockquote>
-<pre><code class="ts"><span class="hl-8">// 设置内存最高缓存到 512 MB</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">modelScene</span><span class="hl-1">.</span><span class="hl-4">parameter</span><span class="hl-1">.</span><span class="hl-0">set</span><span class="hl-1">(</span><span class="hl-2">&#39;maxMemoryUsage&#39;</span><span class="hl-1">, </span><span class="hl-10">512</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置 maxScreenSpaceError 到 32</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">modelScene</span><span class="hl-1">.</span><span class="hl-4">parameter</span><span class="hl-1">.</span><span class="hl-0">set</span><span class="hl-1">(</span><span class="hl-2">&#39;maxScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-10">32</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置通过内存上限动态调整 maxScreenSpaceError</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">modelScene</span><span class="hl-1">.</span><span class="hl-4">parameter</span><span class="hl-1">.</span><span class="hl-0">set</span><span class="hl-1">(</span><span class="hl-2">&#39;memoryAdjustedScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-6">true</span><span class="hl-1">);</span>
+<pre><code class="ts"><span class="hl-8">// 设置内存最高缓存到 512 MB</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;maxMemoryUsage&#39;</span><span class="hl-1">, </span><span class="hl-11">512</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置 maxScreenSpaceError 到 32</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;maxScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-11">32</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置通过内存上限动态调整 maxScreenSpaceError</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;memoryAdjustedScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-3">true</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 
 <p>当设置的 <code>maxScreenSpaceError</code> 已经全部加载完毕后，发现内存空间仍有剩余。则会尝试降低 <code>maxScreenSpaceError</code> 知道内存大体到达 <code>maxMemoryUsage</code> 设置的水平。</p>
@@ -135,7 +135,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <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="movetopano-新增-effectmodel-模型过渡效果" class="tsd-anchor-link">moveToPano 新增 effect=model 模型过渡效果<a href="#movetopano-新增-effectmodel-模型过渡效果" 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>通过过渡到模型实现点位游走效果</p>
-<pre><code class="ts"><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-0">moveToPano</span><span class="hl-1">(</span><span class="hl-10">0</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-4">effect:</span><span class="hl-1"> </span><span class="hl-2">&#39;model&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">0</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;model&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 
 <p>目前支持:</p>
@@ -150,7 +150,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <li>model - 通过过度到模型</li>
 </ul>
 <h3 id="movetopano-新增参数-effecteasing-控制前后全景图的切换进度" class="tsd-anchor-link">moveToPano 新增参数 effectEasing 控制前后全景图的切换进度<a href="#movetopano-新增参数-effecteasing-控制前后全景图的切换进度" 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="ts"><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">easeInQuad</span><span class="hl-1">(</span><span class="hl-4">x</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">number</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-4">x</span><span class="hl-1"> * </span><span class="hl-4">x</span><span class="hl-1">;</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-0">moveToPano</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">workCode:</span><span class="hl-1"> </span><span class="hl-2">&quot;axv2ZQMaKZcMl5Bc6x&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">panoIndex:</span><span class="hl-1"> </span><span class="hl-10">51</span><span class="hl-1">,</span><br/><span class="hl-1">}, {</span><br/><span class="hl-1">  </span><span class="hl-4">latitude:</span><span class="hl-1"> </span><span class="hl-10">0.5314685806864204</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">longitude:</span><span class="hl-1"> </span><span class="hl-10">4.324187623631265</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">fov:</span><span class="hl-1"> </span><span class="hl-10">90</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">effectEasing:</span><span class="hl-1"> </span><span class="hl-4">easeInQuad</span><br/><span class="hl-1">})</span>
+<pre><code class="ts"><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">easeInQuad</span><span class="hl-1">(</span><span class="hl-6">x</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">number</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-6">x</span><span class="hl-1"> * </span><span class="hl-6">x</span><span class="hl-1">;</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</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-9">&quot;axv2ZQMaKZcMl5Bc6x&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">panoIndex:</span><span class="hl-1"> </span><span class="hl-11">51</span><span class="hl-1">,</span><br/><span class="hl-1">}, {</span><br/><span class="hl-1">  </span><span class="hl-6">latitude:</span><span class="hl-1"> </span><span class="hl-11">0.5314685806864204</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">longitude:</span><span class="hl-1"> </span><span class="hl-11">4.324187623631265</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">fov:</span><span class="hl-1"> </span><span class="hl-11">90</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">effectEasing:</span><span class="hl-1"> </span><span class="hl-6">easeInQuad</span><br/><span class="hl-1">})</span>
 </code><button type="button">Copy</button></pre>
 
 <ul>
@@ -160,7 +160,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 </ul>
 <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>默认逻辑为:</p>
-<pre><code class="ts"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-5">five</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">aerialObserverMinHeight:</span><span class="hl-1"> </span><span class="hl-10">5</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-0">panoCircleMeshCreator</span><span class="hl-4">:</span><span class="hl-1"> (</span><span class="hl-4">observer</span><span class="hl-1">, </span><span class="hl-4">options</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-5">distance</span><span class="hl-1"> = </span><span class="hl-4">observer</span><span class="hl-1">.</span><span class="hl-4">position</span><span class="hl-1">.</span><span class="hl-0">distanceTo</span><span class="hl-1">(</span><span class="hl-4">observer</span><span class="hl-1">.</span><span class="hl-4">standingPosition</span><span class="hl-1">);</span><br/><span class="hl-1">      </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">distance</span><span class="hl-1"> &gt; </span><span class="hl-4">options</span><span class="hl-1">.</span><span class="hl-4">aerialObserverMinHeight</span><span class="hl-1">) {</span><br/><span class="hl-1">        </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">PanoCircleMeshSolid</span><span class="hl-1">();</span><br/><span class="hl-1">      } </span><span class="hl-3">else</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">PanoCircleMesh</span><span class="hl-1">();</span><br/><span class="hl-1">      }</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+<pre><code class="ts"><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">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">aerialObserverMinHeight:</span><span class="hl-1"> </span><span class="hl-11">5</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">panoCircleMeshCreator</span><span class="hl-6">:</span><span class="hl-1"> (</span><span class="hl-6">observer</span><span class="hl-1">, </span><span class="hl-6">options</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-3">const</span><span class="hl-1"> </span><span class="hl-4">distance</span><span class="hl-1"> = </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">position</span><span class="hl-1">.</span><span class="hl-5">distanceTo</span><span class="hl-1">(</span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">standingPosition</span><span class="hl-1">);</span><br/><span class="hl-1">      </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">distance</span><span class="hl-1"> &gt; </span><span class="hl-6">options</span><span class="hl-1">.</span><span class="hl-6">aerialObserverMinHeight</span><span class="hl-1">) {</span><br/><span class="hl-1">        </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PanoCircleMeshSolid</span><span class="hl-1">();</span><br/><span class="hl-1">      } </span><span class="hl-10">else</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PanoCircleMesh</span><span class="hl-1">();</span><br/><span class="hl-1">      }</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>
 
 <ul>
@@ -181,7 +181,7 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <li>point-cloud-high-quality-scene-renderer - 点云融合渲染</li>
 <li>ssaa-scene-renderer - SSAA算法的抗锯齿渲染</li>
 </ul>
-<pre><code class="ts"><span class="hl-8">// 通过 renderMode 切换</span><br/><br/><span class="hl-8">// 直接渲染</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">renderMode</span><span class="hl-1"> = </span><span class="hl-2">&#39;default&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 点云融合渲染</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">renderMode</span><span class="hl-1"> = </span><span class="hl-2">&#39;point-cloud-high-quality&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// SSAA算法的抗锯齿渲染</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">renderMode</span><span class="hl-1"> = </span><span class="hl-2">&#39;ssaa&#39;</span><span class="hl-1">;</span>
+<pre><code class="ts"><span class="hl-8">// 通过 renderMode 切换</span><br/><br/><span class="hl-8">// 直接渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;default&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 点云融合渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;point-cloud-high-quality&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// SSAA算法的抗锯齿渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;ssaa&#39;</span><span class="hl-1">;</span>
 </code><button type="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>
@@ -189,13 +189,13 @@ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可
 <li>adaptive-luminance-pass - 屏幕空间动态亮度</li>
 <li>eye-dome-lighting-pass - 轮廓增强</li>
 </ul>
-<pre><code class="ts"><span class="hl-8">// 开启 eye-dome-lighting-pass</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">enableEDL</span><span class="hl-1"> = </span><span class="hl-6">true</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 开启 adaptive-luminance-pass</span><br/><span class="hl-4">five</span><span class="hl-1">.</span><span class="hl-4">enableAdaptiveLuminance</span><span class="hl-1"> = </span><span class="hl-6">true</span><span class="hl-1">;</span>
+<pre><code class="ts"><span class="hl-8">// 开启 eye-dome-lighting-pass</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">enableEDL</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 开启 adaptive-luminance-pass</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">enableAdaptiveLuminance</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span>
 </code><button type="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>后处理支持 THREE 对于 后处理 Pass 的定义。可以自定义追加。</p>
 <p>注意：目前不支持 mask 模版剔除部分的逻辑。</p>
-<pre><code class="ts"><br/><span class="hl-6">interface</span><span class="hl-1"> </span><span class="hl-7">Pass</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-4">enabled</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-4">needsSwap</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-4">clear</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-4">renderToScreen</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-0">setSize</span><span class="hl-1">(</span><span class="hl-4">width</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-4">height</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-0">render</span><span class="hl-1">(</span><br/><span class="hl-1">    </span><span class="hl-4">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/><span class="hl-1">    </span><span class="hl-4">writeBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">readBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">deltaTime</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">maskActive</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><br/><span class="hl-1">  ): </span><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-5">myPass</span><span class="hl-1">: </span><span class="hl-7">Pass</span><span class="hl-1"> = ...;</span><br/><br/><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">fiveRenderer</span><span class="hl-1">.</span><span class="hl-4">composer</span><span class="hl-1">.</span><span class="hl-0">addPass</span><span class="hl-1">(</span><span class="hl-4">myPass</span><span class="hl-1">)</span>
+<pre><code class="ts"><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Pass</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">enabled</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">needsSwap</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">clear</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">renderToScreen</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">setSize</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><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">render</span><span class="hl-1">(</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/><span class="hl-1">    </span><span class="hl-6">writeBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">readBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">deltaTime</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">maskActive</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><br/><span class="hl-1">  ): </span><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">myPass</span><span class="hl-1">: </span><span class="hl-7">Pass</span><span class="hl-1"> = ...;</span><br/><br/><span class="hl-3">this</span><span class="hl-1">.</span><span class="hl-6">fiveRenderer</span><span class="hl-1">.</span><span class="hl-6">composer</span><span class="hl-1">.</span><span class="hl-5">addPass</span><span class="hl-1">(</span><span class="hl-6">myPass</span><span class="hl-1">)</span>
 </code><button type="button">Copy</button></pre>
 
 <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>

package/docs/documents/release_notes_6.8.html

@@ -0,0 +1,103 @@
+<!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) 渲染管线。这是一种基于点的渲染技术，能够提供高质量的实时渲染效果。</p>
+</blockquote>
+<ul>
+<li><strong>前提条件</strong>: 仅在 WebGL2 环境下可用。</li>
+<li><strong>数据支持</strong>:
+<ul>
+<li>支持 <code>3dtiles</code> 中包含 3DGS 数据。</li>
+<li>支持加载 <code>.spz</code> (version 2) 或 <code>.splat</code> 格式的数据。</li>
+<li>支持通过 glTF 扩展加载 content 为 <code>.spz</code> 的 glTF/glb 文件。</li>
+</ul>
+</li>
+<li><strong>功能特性</strong>:
+<ul>
+<li>支持透视相机与正交相机渲染。</li>
+<li>支持 BVH 构建，支持射线检测 (Raycast)。</li>
+<li><code>pbmGSObject</code> 继承自 <code>THREE.Points</code>。</li>
+</ul>
+</li>
+</ul>
+<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.gsSHDegree</code> 设置球谐光照阶数，支持 0, 1, 2 阶，默认为 0 阶。</p>
+<pre><code class="ts"><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">gsSHDegree:</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 type="button">Copy</button></pre>
+
+<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>
+<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>默认情况下，Five <strong>不再加载所有图层</strong>，而是根据优先级<strong>仅加载一个</strong>图层。
+优先级顺序：<code>mesh</code> &gt; <code>point_cloud</code> &gt; 其他类型。</p>
+<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><strong>显示</strong>: 当 <code>viewLayer.visible = true</code> 时，开始加载资源。</li>
+<li><strong>隐藏</strong>: 当 <code>viewLayer.visible = false</code> 时，<strong>释放该图层占用的所有内存资源</strong>。</li>
+</ul>
+<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>新增 <code>tile.content.loadProgress</code> 属性，用于查看每个瓦片的加载进度 (0-1)。
+新增 <code>tile.content.byteLength</code> 属性，可在加载过程中获取瓦片内容的字节长度。
+同时，<code>model.tileLoad</code> 和 <code>model.tileUnload</code> 事件被添加，用于监控瓦片的生命周期。</p>
+<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>外部模型加载函数（<code>loadGltf</code>, <code>loadPly</code> 等）现在支持 <code>onDownloadProgress</code> 回调，用于监控文件下载进度。</p>
+<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><code>Intersection</code> 对象新增了 <code>tile</code>, <code>model</code>, <code>viewLayer</code> 字段，便于在射线检测时获取更详细的上下文信息。</li>
+<li><code>raycaster.hitFilter</code> 回调函数的参数类型定义已更新，包含 <code>model</code>, <code>viewLayer</code>, <code>tile</code> 等上下文信息。</li>
+</ul>
+<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>
+<ul>
+<li><strong>KHR_animation_pointer</strong>: 允许动画通道指向 glTF 资产中任何对象的任何属性，而不仅仅是节点的平移、旋转和缩放。</li>
+<li><strong>KHR_node_visibility</strong>: 允许设置节点的可见性属性。</li>
+<li><strong>KHR_materials_clearcoat</strong> 用于在材质上添加一层透明涂层，模拟车漆、碳纤维、清漆木材等真实世界中的表面效果。</li>
+<li><strong>KHR_materials_sheen</strong> 绒面 / 绒毛类表面效果。</li>
+<li><strong>KHR_materials_transmission</strong> 物理透光材质扩展，用于实现光线真正穿过物体的透明 / 半透明效果。</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>
+<blockquote>
+<p>为 WorkObserver 提供了更多实用的工具函数，便于进行坐标和 UV 转换。</p>
+</blockquote>
+<h3 id="uv-转换工具函数" class="tsd-anchor-link">UV 转换工具函数<a href="#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>
+<ul>
+<li><code>vectorToEquirectangularUv</code>: 将方向向量转化为全景图 uv。</li>
+<li><code>equirectangularUvToVector</code>: 将全景图 uv 转化为方向向量。</li>
+<li><code>vectorToCubemapUv</code>: 将方向向量转化为立方体贴图 uv。</li>
+<li><code>cubemapUvToVector</code>: 将立方体贴图 uv 转化为方向向量。</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>
+<blockquote>
+<p>新增了三个可选的内置后处理 Pass，用于增强视觉效果。</p>
+</blockquote>
+<ul>
+<li><strong><a href="features_flowing-light-2d-pass.html">FlowingLight2DPass</a></strong>: 2D 流光效果，通常用于在屏幕空间绘制流动的光线（如道路流光）。</li>
+<li><strong><a href="features_flowing-light-3d-pass.html">FlowingLight3DPass</a></strong>: 3D 流光效果，基于深度缓冲区在三维模型表面绘制流光。</li>
+<li><strong><a href="features_gaussian-blur-pass.html">GaussianBlurPass</a></strong>: 高斯模糊效果，可用于实现毛玻璃等视觉特效。</li>
+</ul>
+<h2 id="ai-友好文档-ai-guides" class="tsd-anchor-link">AI 友好文档 (AI Guides)<a href="#ai-友好文档-ai-guides" 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>全面重构了文档结构，使其更适合 AI 辅助编程工具 (如 Cursor, Copilot) 阅读和索引。</p>
+</blockquote>
+<ul>
+<li>文档目录迁移至 <code>ai_guides/</code>，并在 <code>package.json</code> 中新增 <code>ai</code> 字段指向该目录。</li>
+<li>文档内容包含源码链接 (<code>source</code> 字段)，直接指向对应的 <code>.ts</code> 定义文件。</li>
+<li>提供了更清晰的 API 定义和概念说明，例如新增了 <a href="features_view-layer.html">ViewLayer</a> 的详细文档。</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>
+<ul>
+<li><strong>点云渲染</strong>: 计算点位透明度时，现在会排除不活跃的点，提升渲染正确性。</li>
+<li><strong>TypeScript 支持</strong>: 优化了 <code>.d.ts</code> 打包方式，声明文件现在与源码文件一一对应，提升了 IDE 的跳转体验。</li>
+</ul>
+</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="#配置球谐光照阶数-sh-degree"><span>配置球谐光照阶数 (<wbr/>SH <wbr/>Degree)</span></a></li></ul></li><li><a href="#viewlayer-加载策略优化"><span>View<wbr/>Layer 加载策略优化</span></a></li><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><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></ul></li><li><a href="#work-核心能力增强"><span>Work 核心能力增强</span></a></li><li><ul><li><a href="#uv-转换工具函数"><span>UV 转换工具函数</span></a></li></ul></li><li><a href="#新增后处理效果-post-processing-passes"><span>新增后处理效果 (<wbr/>Post-<wbr/>Processing <wbr/>Passes)</span></a></li><li><a href="#ai-友好文档-ai-guides"><span>AI 友好文档 (<wbr/>AI <wbr/>Guides)</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>