npm - @realsee/five - Versions diffs - 6.8.9 → 6.9.0-alpha.1 - Mend

@realsee/five 6.8.9 → 6.9.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (281) hide show

package/docs/documents/features_pano-filter.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/model/materials/pbmMaterial.d.ts">PBMPanoFilter</a></p>
 </blockquote>
 <p><code>PBMPanoFilter</code> 类定义了全景图的滤镜参数。所有属性均为对象引用，直接修改其内部属性即可生效。</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">PBMUpdateable</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">class</span><span class="hl-1"> </span><span class="hl-7">PBMPanoFilter</span><span class="hl-1"> </span><span class="hl-3">extends</span><span class="hl-1"> </span><span class="hl-7">PBMUpdateable</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 对比度控制 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-6">contrast</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-8">/** 对比度偏移 [-1, 1] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">contrastBias</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><span class="hl-8">/** 饱和度控制 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-6">saturation</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-8">/** 饱和度偏移 [-1, 1] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">saturationBias</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><span class="hl-8">/** 颜色控制 (色温与色调) */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-6">color</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-8">/** 色温偏移 [-100, 100] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">temperatureBias</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-8">/** 色调偏移 [-100, 100] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">tintBias</span><span class="hl-1">: </span><span class="hl-7">number</span><br/><span class="hl-1">  };</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 高光与阴影控制 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-6">highlightShadow</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-8">/** 全局亮度偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">globalBias</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-8">/** 高光偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">highlightBias</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-8">/** 阴影偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-6">shadowBias</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  };</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">PBMUpdateable</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">class</span><span class="hl-1"> </span><span class="hl-9">PBMPanoFilter</span><span class="hl-1"> </span><span class="hl-8">extends</span><span class="hl-1"> </span><span class="hl-9">PBMUpdateable</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 对比度控制 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-5">contrast</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-7">/** 对比度偏移 [-1, 1] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">contrastBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  };</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 饱和度控制 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-5">saturation</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-7">/** 饱和度偏移 [-1, 1] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">saturationBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  };</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 颜色控制 (色温与色调) */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-5">color</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-7">/** 色温偏移 [-100, 100] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">temperatureBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">    </span><span class="hl-7">/** 色调偏移 [-100, 100] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">tintBias</span><span class="hl-1">: </span><span class="hl-9">number</span><br/><span class="hl-1">  };</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 高光与阴影控制 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-5">highlightShadow</span><span class="hl-1">: {</span><br/><span class="hl-1">    </span><span class="hl-7">/** 全局亮度偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">globalBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">    </span><span class="hl-7">/** 高光偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">highlightBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">    </span><span class="hl-7">/** 阴影偏移 [-255, 255] (默认 0) */</span><br/><span class="hl-1">    </span><span class="hl-5">shadowBias</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  };</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <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>
@@ -101,12 +101,12 @@
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" 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="basic-usage-基础用法" class="tsd-anchor-link">Basic Usage (基础用法)<a href="#basic-usage-基础用法" 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 场景中。</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">PBMPanoFilter</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><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-8">// ... 初始化 five ...</span><br/><br/><span class="hl-8">// 1. 创建滤镜实例</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">panoFilter</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PBMPanoFilter</span><span class="hl-1">();</span><br/><br/><span class="hl-8">// 2. 配置参数 (例如：增加一点暖色调和亮度)</span><br/><span class="hl-6">panoFilter</span><span class="hl-1">.</span><span class="hl-6">color</span><span class="hl-1">.</span><span class="hl-6">temperatureBias</span><span class="hl-1"> = </span><span class="hl-11">10</span><span class="hl-1">; </span><span class="hl-8">// 暖色</span><br/><span class="hl-6">panoFilter</span><span class="hl-1">.</span><span class="hl-6">highlightShadow</span><span class="hl-1">.</span><span class="hl-6">globalBias</span><span class="hl-1"> = </span><span class="hl-11">20</span><span class="hl-1">; </span><span class="hl-8">// 提亮</span><br/><br/><span class="hl-8">// 3. 启用滤镜</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;panoFilter&#39;</span><span class="hl-1">, </span><span class="hl-6">panoFilter</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 4. (可选) 停用滤镜</span><br/><span class="hl-8">// five.modelScene.parameter.reset(&#39;panoFilter&#39;);</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">PBMPanoFilter</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">();</span><br/><span class="hl-7">// ... 初始化 five ...</span><br/><br/><span class="hl-7">// 1. 创建滤镜实例</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">panoFilter</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">PBMPanoFilter</span><span class="hl-1">();</span><br/><br/><span class="hl-7">// 2. 配置参数 (例如：增加一点暖色调和亮度)</span><br/><span class="hl-5">panoFilter</span><span class="hl-1">.</span><span class="hl-5">color</span><span class="hl-1">.</span><span class="hl-5">temperatureBias</span><span class="hl-1"> = </span><span class="hl-3">10</span><span class="hl-1">; </span><span class="hl-7">// 暖色</span><br/><span class="hl-5">panoFilter</span><span class="hl-1">.</span><span class="hl-5">highlightShadow</span><span class="hl-1">.</span><span class="hl-5">globalBias</span><span class="hl-1"> = </span><span class="hl-3">20</span><span class="hl-1">; </span><span class="hl-7">// 提亮</span><br/><br/><span class="hl-7">// 3. 启用滤镜</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;panoFilter&#39;</span><span class="hl-1">, </span><span class="hl-5">panoFilter</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 4. (可选) 停用滤镜</span><br/><span class="hl-7">// five.modelScene.parameter.reset(&#39;panoFilter&#39;);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="interactive-adjustment-动态调整" class="tsd-anchor-link">Interactive Adjustment (动态调整)<a href="#interactive-adjustment-动态调整" 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="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">PBMPanoFilter</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 假设已经有 five 实例</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">panoFilter</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PBMPanoFilter</span><span class="hl-1">();</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;panoFilter&#39;</span><span class="hl-1">, </span><span class="hl-6">panoFilter</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 模拟 UI 绑定的数据对象</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">filterSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-6">brightness:</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">contrast:</span><span class="hl-1"> </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-8">// 监听 UI 变化 (示例伪代码)</span><br/><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">onBrightnessChange</span><span class="hl-1">(</span><span class="hl-6">value</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-8">// value range: [-255, 255]</span><br/><span class="hl-1">  </span><span class="hl-6">panoFilter</span><span class="hl-1">.</span><span class="hl-6">highlightShadow</span><span class="hl-1">.</span><span class="hl-6">globalBias</span><span class="hl-1"> = </span><span class="hl-6">value</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">// 如果 five 没有开启自动渲染 (play: false)，需要手动触发重绘</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">needsRender</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">onContrastChange</span><span class="hl-1">(</span><span class="hl-6">value</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-8">// value range: [-1, 1]</span><br/><span class="hl-1">  </span><span class="hl-6">panoFilter</span><span class="hl-1">.</span><span class="hl-6">contrast</span><span class="hl-1">.</span><span class="hl-6">contrastBias</span><span class="hl-1"> = </span><span class="hl-6">value</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">needsRender</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">PBMPanoFilter</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 假设已经有 five 实例</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">panoFilter</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">PBMPanoFilter</span><span class="hl-1">();</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;panoFilter&#39;</span><span class="hl-1">, </span><span class="hl-5">panoFilter</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 模拟 UI 绑定的数据对象</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">filterSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">brightness:</span><span class="hl-1"> </span><span class="hl-3">0</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">contrast:</span><span class="hl-1"> </span><span class="hl-3">0</span><span class="hl-1">,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-7">// 监听 UI 变化 (示例伪代码)</span><br/><span class="hl-8">function</span><span class="hl-1"> </span><span class="hl-4">onBrightnessChange</span><span class="hl-1">(</span><span class="hl-5">value</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-7">// value range: [-255, 255]</span><br/><span class="hl-1">  </span><span class="hl-5">panoFilter</span><span class="hl-1">.</span><span class="hl-5">highlightShadow</span><span class="hl-1">.</span><span class="hl-5">globalBias</span><span class="hl-1"> = </span><span class="hl-5">value</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">// 如果 five 没有开启自动渲染 (play: false)，需要手动触发重绘</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">needsRender</span><span class="hl-1"> = </span><span class="hl-8">true</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">function</span><span class="hl-1"> </span><span class="hl-4">onContrastChange</span><span class="hl-1">(</span><span class="hl-5">value</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-7">// value range: [-1, 1]</span><br/><span class="hl-1">  </span><span class="hl-5">panoFilter</span><span class="hl-1">.</span><span class="hl-5">contrast</span><span class="hl-1">.</span><span class="hl-5">contrastBias</span><span class="hl-1"> = </span><span class="hl-5">value</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">needsRender</span><span class="hl-1"> = </span><span class="hl-8">true</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <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/features_pano-tile.html CHANGED Viewed

@@ -12,12 +12,12 @@
 </blockquote>
 <h3 id="workobserverimages" class="tsd-anchor-link">WorkObserver.images<a href="#workobserverimages" 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="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkImage</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 分辨率列表 */</span><br/><span class="hl-1">  </span><span class="hl-6">sizeList</span><span class="hl-1">: </span><span class="hl-3">readonly</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-8">/** 瓦片信息列表，按 level 排序 */</span><br/><span class="hl-1">  </span><span class="hl-6">tiles</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">WorkTile</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 其他基础图片 URL</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkImage</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 分辨率列表 */</span><br/><span class="hl-1">  </span><span class="hl-5">sizeList</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-7">/** 瓦片信息列表，按 level 排序 */</span><br/><span class="hl-1">  </span><span class="hl-5">tiles</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">WorkTile</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 其他基础图片 URL</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="imageoptions" class="tsd-anchor-link">ImageOptions<a href="#imageoptions" 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="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">ImageOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 图片尺寸参数 (例如 512, 1024...) */</span><br/><span class="hl-1">  </span><span class="hl-6">size</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-8">/** 图片质量参数 (0-100) */</span><br/><span class="hl-1">  </span><span class="hl-6">quality</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-8">/** 图片格式参数 */</span><br/><span class="hl-1">  </span><span class="hl-6">format</span><span class="hl-1">?: </span><span class="hl-9">&quot;jpg&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;jpeg&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;png&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;heif&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;heic&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;webp&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;avif&quot;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** URL 转换函数 */</span><br/><span class="hl-1">  </span><span class="hl-5">transform</span><span class="hl-1">?: (</span><span class="hl-6">url</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">, </span><span class="hl-6">options</span><span class="hl-1">: </span><span class="hl-7">ImageURLOptions</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">ImageOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 图片尺寸参数 (例如 512, 1024...) */</span><br/><span class="hl-1">  </span><span class="hl-5">size</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 图片质量参数 (0-100) */</span><br/><span class="hl-1">  </span><span class="hl-5">quality</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 图片格式参数 */</span><br/><span class="hl-1">  </span><span class="hl-5">format</span><span class="hl-1">?: </span><span class="hl-10">&quot;jpg&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;jpeg&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;png&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;heif&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;heic&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;webp&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;avif&quot;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** URL 转换函数 */</span><br/><span class="hl-1">  </span><span class="hl-4">transform</span><span class="hl-1">?: (</span><span class="hl-5">url</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">, </span><span class="hl-5">options</span><span class="hl-1">: </span><span class="hl-9">ImageURLOptions</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <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>
@@ -81,11 +81,11 @@
 </table>
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="查看瓦片数据结构" class="tsd-anchor-link">查看瓦片数据结构<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="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><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/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">on</span><span class="hl-1">(</span><span class="hl-9">&quot;loaded&quot;</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">observer</span><span class="hl-1"> = </span><span class="hl-6">five</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><br/><span class="hl-1">  </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">observer</span><span class="hl-1"> &amp;&amp; </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">images</span><span class="hl-1"> &amp;&amp; </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">images</span><span class="hl-1">.</span><span class="hl-6">tiles</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;Available Tiles:&quot;</span><span class="hl-1">, </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">images</span><span class="hl-1">.</span><span class="hl-6">tiles</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">images</span><span class="hl-1">.</span><span class="hl-6">tiles</span><span class="hl-1">.</span><span class="hl-5">forEach</span><span class="hl-1">(</span><span class="hl-6">tile</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`Level: </span><span class="hl-3">${</span><span class="hl-6">tile</span><span class="hl-12">.</span><span class="hl-6">level</span><span class="hl-3">}</span><span class="hl-9">, Size: </span><span class="hl-3">${</span><span class="hl-6">tile</span><span class="hl-12">.</span><span class="hl-6">size</span><span class="hl-3">}</span><span class="hl-9">, Scale: </span><span class="hl-3">${</span><span class="hl-6">tile</span><span class="hl-12">.</span><span class="hl-6">scale</span><span class="hl-3">}</span><span class="hl-9">`</span><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="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">();</span><br/><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">on</span><span class="hl-1">(</span><span class="hl-10">&quot;loaded&quot;</span><span class="hl-1">, () </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">observer</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">observers</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-1">  </span><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">observer</span><span class="hl-1"> &amp;&amp; </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-5">images</span><span class="hl-1"> &amp;&amp; </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-5">images</span><span class="hl-1">.</span><span class="hl-5">tiles</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;Available Tiles:&quot;</span><span class="hl-1">, </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-5">images</span><span class="hl-1">.</span><span class="hl-5">tiles</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-5">images</span><span class="hl-1">.</span><span class="hl-5">tiles</span><span class="hl-1">.</span><span class="hl-4">forEach</span><span class="hl-1">(</span><span class="hl-5">tile</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">`Level: </span><span class="hl-8">${</span><span class="hl-5">tile</span><span class="hl-12">.</span><span class="hl-5">level</span><span class="hl-8">}</span><span class="hl-10">, Size: </span><span class="hl-8">${</span><span class="hl-5">tile</span><span class="hl-12">.</span><span class="hl-5">size</span><span class="hl-8">}</span><span class="hl-10">, Scale: </span><span class="hl-8">${</span><span class="hl-5">tile</span><span class="hl-12">.</span><span class="hl-5">scale</span><span class="hl-8">}</span><span class="hl-10">`</span><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>
 <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>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><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-8">// 自定义瓦片层级选择策略</span><br/><span class="hl-1">  </span><span class="hl-5">tileLevelForFov</span><span class="hl-6">:</span><span class="hl-1"> (</span><span class="hl-6">fov</span><span class="hl-1">, </span><span class="hl-6">viewSize</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-8">// 简单示例：FOV 小于 60 度时强制使用 Level 2，否则使用 Level 1</span><br/><span class="hl-1">    </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">fov</span><span class="hl-1"> &lt; </span><span class="hl-11">60</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-11">2</span><span class="hl-1">;</span><br/><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-11">1</span><span class="hl-1">;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-8">// 限制并发请求数</span><br/><span class="hl-1">  </span><span class="hl-6">tileMaxRequest:</span><span class="hl-1"> </span><span class="hl-11">6</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-8">// 图片加载配置</span><br/><span class="hl-1">  </span><span class="hl-6">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 强制请求 WebP 格式的图片</span><br/><span class="hl-1">    </span><span class="hl-6">format:</span><span class="hl-1"> </span><span class="hl-9">&quot;webp&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-8">// 图片质量设置为 80%</span><br/><span class="hl-1">    </span><span class="hl-6">quality:</span><span class="hl-1"> </span><span class="hl-11">80</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-8">// (可选) 自定义 URL 转换逻辑</span><br/><span class="hl-1">    </span><span class="hl-8">// transform: (url, options) =&gt; {</span><br/><span class="hl-1">    </span><span class="hl-8">//   return url + `?x-oss-process=image/format,webp/quality,q_80`;</span><br/><span class="hl-1">    </span><span class="hl-8">// }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-7">// 自定义瓦片层级选择策略</span><br/><span class="hl-1">  </span><span class="hl-4">tileLevelForFov</span><span class="hl-5">:</span><span class="hl-1"> (</span><span class="hl-5">fov</span><span class="hl-1">, </span><span class="hl-5">viewSize</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 简单示例：FOV 小于 60 度时强制使用 Level 2，否则使用 Level 1</span><br/><span class="hl-1">    </span><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">fov</span><span class="hl-1"> &lt; </span><span class="hl-3">60</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-3">2</span><span class="hl-1">;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">    </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-3">1</span><span class="hl-1">;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-7">// 限制并发请求数</span><br/><span class="hl-1">  </span><span class="hl-5">tileMaxRequest:</span><span class="hl-1"> </span><span class="hl-3">6</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-7">// 图片加载配置</span><br/><span class="hl-1">  </span><span class="hl-5">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 强制请求 WebP 格式的图片</span><br/><span class="hl-1">    </span><span class="hl-5">format:</span><span class="hl-1"> </span><span class="hl-10">&quot;webp&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-7">// 图片质量设置为 80%</span><br/><span class="hl-1">    </span><span class="hl-5">quality:</span><span class="hl-1"> </span><span class="hl-3">80</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-7">// (可选) 自定义 URL 转换逻辑</span><br/><span class="hl-1">    </span><span class="hl-7">// transform: (url, options) =&gt; {</span><br/><span class="hl-1">    </span><span class="hl-7">//   return url + `?x-oss-process=image/format,webp/quality,q_80`;</span><br/><span class="hl-1">    </span><span class="hl-7">// }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <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/features_pano-uv.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/work/work.d.ts">WorkObserver</a></p>
 </blockquote>
 <p>这些方法挂载在 <code>WorkObserver</code> 实例上，依赖当前观察点 (Observer) 的位姿信息 (Position &amp; Quaternion) 以及 <code>work.transform</code> 进行计算。</p>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkObserver</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 将方向向量转化为全景图 uv</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">vector</span><span class="hl-8"> - 全局方向向量 (World Space)</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uvOrigin</span><span class="hl-8"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-6">vector</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 将全景图 uv 转化为方向向量</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uv</span><span class="hl-8"> - 全景图 UV 坐标 [0, 1]</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uvOrigin</span><span class="hl-8"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-6">uv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 将方向向量转化为六视图 uv</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">vector</span><span class="hl-8"> - 全局方向向量 (World Space)</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uvOrigin</span><span class="hl-8"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-6">vector</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): [</span><span class="hl-13">cubeFace</span><span class="hl-1">: </span><span class="hl-7">CubeFace</span><span class="hl-1">, </span><span class="hl-13">cubemapUv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 将六视图 uv 转化为方向向量</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">cubeFace</span><span class="hl-8"> - 立方体面 (&#39;up&#39; | &#39;down&#39; | &#39;left&#39; | &#39;right&#39; | &#39;front&#39; | &#39;back&#39;)</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uv</span><span class="hl-8"> - 该面上的 UV 坐标 [0, 1]</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">uvOrigin</span><span class="hl-8"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">cubemapUvToVector</span><span class="hl-1">(</span><span class="hl-6">cubeFace</span><span class="hl-1">: </span><span class="hl-7">CubeFace</span><span class="hl-1">, </span><span class="hl-6">uv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">CubeFace</span><span class="hl-1"> = </span><span class="hl-9">&#39;up&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;down&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;right&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;front&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;back&#39;</span><span class="hl-1">;</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkObserver</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 将方向向量转化为全景图 uv</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">vector</span><span class="hl-7"> - 全局方向向量 (World Space)</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uvOrigin</span><span class="hl-7"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-5">vector</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 将全景图 uv 转化为方向向量</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uv</span><span class="hl-7"> - 全景图 UV 坐标 [0, 1]</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uvOrigin</span><span class="hl-7"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-5">uv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 将方向向量转化为六视图 uv</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">vector</span><span class="hl-7"> - 全局方向向量 (World Space)</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uvOrigin</span><span class="hl-7"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-5">vector</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): [</span><span class="hl-13">cubeFace</span><span class="hl-1">: </span><span class="hl-9">CubeFace</span><span class="hl-1">, </span><span class="hl-13">cubemapUv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">];</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 将六视图 uv 转化为方向向量</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">cubeFace</span><span class="hl-7"> - 立方体面 (&#39;up&#39; | &#39;down&#39; | &#39;left&#39; | &#39;right&#39; | &#39;front&#39; | &#39;back&#39;)</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uv</span><span class="hl-7"> - 该面上的 UV 坐标 [0, 1]</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">uvOrigin</span><span class="hl-7"> - UV 原点位置，默认为 &#39;top-left&#39;</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">cubemapUvToVector</span><span class="hl-1">(</span><span class="hl-5">cubeFace</span><span class="hl-1">: </span><span class="hl-9">CubeFace</span><span class="hl-1">, </span><span class="hl-5">uv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">CubeFace</span><span class="hl-1"> = </span><span class="hl-10">&#39;up&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;down&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;right&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;front&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;back&#39;</span><span class="hl-1">;</span>
 </code><button type="button">Copy</button></pre>
 <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>
@@ -57,17 +57,17 @@
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" 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="1-点击全景图获取空间方向-click-to-vector" class="tsd-anchor-link">1. 点击全景图获取空间方向 (Click to Vector)<a href="#1-点击全景图获取空间方向-click-to-vector" 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>假设你有一个全景图的点击事件，获取到了点击位置的 UV：</p>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">observer</span><span class="hl-1"> = </span><span class="hl-6">five</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><br/><span class="hl-8">// 假设这是用户点击全景图后归一化得到的 UV (0~1)</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">clickUv</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Vector2</span><span class="hl-1">(</span><span class="hl-11">0.5</span><span class="hl-1">, </span><span class="hl-11">0.5</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 转换为世界空间的方向向量</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">direction</span><span class="hl-1"> = </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-5">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-6">clickUv</span><span class="hl-1">);</span><br/><br/><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&#39;点击方向:&#39;</span><span class="hl-1">, </span><span class="hl-6">direction</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">observer</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">observers</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-7">// 假设这是用户点击全景图后归一化得到的 UV (0~1)</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">clickUv</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1">.</span><span class="hl-4">Vector2</span><span class="hl-1">(</span><span class="hl-3">0.5</span><span class="hl-1">, </span><span class="hl-3">0.5</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 转换为世界空间的方向向量</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">direction</span><span class="hl-1"> = </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-4">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-5">clickUv</span><span class="hl-1">);</span><br/><br/><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&#39;点击方向:&#39;</span><span class="hl-1">, </span><span class="hl-5">direction</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-将空间点映射到全景图上-world-point-to-uv" class="tsd-anchor-link">2. 将空间点映射到全景图上 (World Point to UV)<a href="#2-将空间点映射到全景图上-world-point-to-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>假设场景中有一个 3D 物体，你想知道它在当前全景图上的位置（例如打标签）：</p>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">observer</span><span class="hl-1"> = </span><span class="hl-6">five</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><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">objectPosition</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Vector3</span><span class="hl-1">(</span><span class="hl-11">10</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">5</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 计算物体相对于观察点的方向向量</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">direction</span><span class="hl-1"> = </span><span class="hl-6">objectPosition</span><span class="hl-1">.</span><span class="hl-5">clone</span><span class="hl-1">().</span><span class="hl-5">sub</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">normalize</span><span class="hl-1">();</span><br/><br/><span class="hl-8">// 获取全景图 UV</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">uv</span><span class="hl-1"> = </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-5">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-6">direction</span><span class="hl-1">);</span><br/><br/><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`物体在全景图上的位置: u=</span><span class="hl-3">${</span><span class="hl-6">uv</span><span class="hl-12">.</span><span class="hl-6">x</span><span class="hl-3">}</span><span class="hl-9">, v=</span><span class="hl-3">${</span><span class="hl-6">uv</span><span class="hl-12">.</span><span class="hl-6">y</span><span class="hl-3">}</span><span class="hl-9">`</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">observer</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">observers</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">objectPosition</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1">.</span><span class="hl-4">Vector3</span><span class="hl-1">(</span><span class="hl-3">10</span><span class="hl-1">, </span><span class="hl-3">2</span><span class="hl-1">, </span><span class="hl-3">5</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 计算物体相对于观察点的方向向量</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">direction</span><span class="hl-1"> = </span><span class="hl-5">objectPosition</span><span class="hl-1">.</span><span class="hl-4">clone</span><span class="hl-1">().</span><span class="hl-4">sub</span><span class="hl-1">(</span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-5">position</span><span class="hl-1">).</span><span class="hl-4">normalize</span><span class="hl-1">();</span><br/><br/><span class="hl-7">// 获取全景图 UV</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">uv</span><span class="hl-1"> = </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-4">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-5">direction</span><span class="hl-1">);</span><br/><br/><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">`物体在全景图上的位置: u=</span><span class="hl-8">${</span><span class="hl-5">uv</span><span class="hl-12">.</span><span class="hl-5">x</span><span class="hl-8">}</span><span class="hl-10">, v=</span><span class="hl-8">${</span><span class="hl-5">uv</span><span class="hl-12">.</span><span class="hl-5">y</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="3-处理-cubemap-坐标-cubemap-conversion" class="tsd-anchor-link">3. 处理 Cubemap 坐标 (Cubemap Conversion)<a href="#3-处理-cubemap-坐标-cubemap-conversion" 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="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">observer</span><span class="hl-1"> = </span><span class="hl-6">five</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><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">direction</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Vector3</span><span class="hl-1">(</span><span class="hl-11">0</span><span class="hl-1">, </span><span class="hl-11">0</span><span class="hl-1">, -</span><span class="hl-11">1</span><span class="hl-1">); </span><span class="hl-8">// 正前方</span><br/><br/><span class="hl-8">// 获取对应的面和 UV</span><br/><span class="hl-3">const</span><span class="hl-1"> [</span><span class="hl-4">face</span><span class="hl-1">, </span><span class="hl-4">uv</span><span class="hl-1">] = </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-5">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-6">direction</span><span class="hl-1">);</span><br/><br/><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`正前方对应 Cubemap 的 </span><span class="hl-3">${</span><span class="hl-6">face</span><span class="hl-3">}</span><span class="hl-9"> 面，UV 为`</span><span class="hl-1">, </span><span class="hl-6">uv</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">observer</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">observers</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">direction</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1">.</span><span class="hl-4">Vector3</span><span class="hl-1">(</span><span class="hl-3">0</span><span class="hl-1">, </span><span class="hl-3">0</span><span class="hl-1">, -</span><span class="hl-3">1</span><span class="hl-1">); </span><span class="hl-7">// 正前方</span><br/><br/><span class="hl-7">// 获取对应的面和 UV</span><br/><span class="hl-8">const</span><span class="hl-1"> [</span><span class="hl-6">face</span><span class="hl-1">, </span><span class="hl-6">uv</span><span class="hl-1">] = </span><span class="hl-5">observer</span><span class="hl-1">.</span><span class="hl-4">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-5">direction</span><span class="hl-1">);</span><br/><br/><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">`正前方对应 Cubemap 的 </span><span class="hl-8">${</span><span class="hl-5">face</span><span class="hl-8">}</span><span class="hl-10"> 面，UV 为`</span><span class="hl-1">, </span><span class="hl-5">uv</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <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/features_parameter.html CHANGED Viewed

@@ -45,12 +45,12 @@
 </ul>
 </li>
 </ul>
-<pre><code class="typescript"><span class="hl-8">// 方式 A: 直接访问 (获取当前层级配置)</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">currentVal</span><span class="hl-1"> = </span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-6">maxMemoryUsage</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 方式 B: 计算最终值 (包含继承逻辑)</span><br/><br/><span class="hl-8">// 1. 基础用法：仅继承默认值</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">finalVal</span><span class="hl-1"> = </span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">resolveValue</span><span class="hl-1">().</span><span class="hl-6">maxMemoryUsage</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 2. 进阶用法：指定继承源 (例如 ViewLayer 继承自 Model)</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">inheritedVal</span><span class="hl-1"> = </span><span class="hl-6">viewLayerParam</span><span class="hl-1">.</span><span class="hl-5">resolveValue</span><span class="hl-1">(</span><span class="hl-6">parentParameter</span><span class="hl-1">).</span><span class="hl-6">maxMemoryUsage</span><span class="hl-1">;</span>
+<pre><code class="typescript"><span class="hl-7">// 方式 A: 直接访问 (获取当前层级配置)</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">currentVal</span><span class="hl-1"> = </span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-5">maxMemoryUsage</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 方式 B: 计算最终值 (包含继承逻辑)</span><br/><br/><span class="hl-7">// 1. 基础用法：仅继承默认值</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">finalVal</span><span class="hl-1"> = </span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">resolveValue</span><span class="hl-1">().</span><span class="hl-5">maxMemoryUsage</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 2. 进阶用法：指定继承源 (例如 ViewLayer 继承自 Model)</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">inheritedVal</span><span class="hl-1"> = </span><span class="hl-5">viewLayerParam</span><span class="hl-1">.</span><span class="hl-4">resolveValue</span><span class="hl-1">(</span><span class="hl-5">parentParameter</span><span class="hl-1">).</span><span class="hl-5">maxMemoryUsage</span><span class="hl-1">;</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="2-methods-方法" class="tsd-anchor-link">2. Methods (方法)<a href="#2-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></h4>
 <p><code>Parameter</code> 实例提供了以下核心方法来管理配置：</p>
-<pre><code class="typescript"><span class="hl-3">class</span><span class="hl-1"> </span><span class="hl-7">Parameter</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><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">key</span><span class="hl-8"> 参数名 (如 &#39;opacity&#39;, &#39;maxMemoryUsage&#39;)</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">value</span><span class="hl-8"> 参数值</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-6">key</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">, </span><span class="hl-6">value</span><span class="hl-1">: </span><span class="hl-7">any</span><span class="hl-1">): </span><span class="hl-7">void</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><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">keys</span><span class="hl-8"> 要重置的参数名列表</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">reset</span><span class="hl-1">(...</span><span class="hl-6">keys</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">[]): </span><span class="hl-7">void</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><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">upstream</span><span class="hl-8"> 上游 Parameter 对象列表（通常由引擎自动传入）</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">resolveValue</span><span class="hl-1">(...</span><span class="hl-6">upstream</span><span class="hl-1">: </span><span class="hl-7">Parameter</span><span class="hl-1">[]): </span><span class="hl-7">ResolvedParameterValue</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 获取经过继承计算后的最终值（复用 target 对象，避免重复创建）</span><br/><span class="hl-8">   * 适用于高频调用场景（如逐帧更新），可显著减少 GC 压力。</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">target</span><span class="hl-8"> 用于写入结果的已有对象，其属性会被重置为默认值后重新赋值</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">upstream</span><span class="hl-8"> 上游 Parameter 对象列表</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-3">static</span><span class="hl-1"> </span><span class="hl-5">resolveValueTo</span><span class="hl-1">(</span><br/><span class="hl-1">    </span><span class="hl-6">target</span><span class="hl-1">: </span><span class="hl-7">Partial</span><span class="hl-1">&lt;</span><span class="hl-7">ResolvedParameterValue</span><span class="hl-1">&gt;,</span><br/><span class="hl-1">    ...</span><span class="hl-6">upstream</span><span class="hl-1">: </span><span class="hl-7">Partial</span><span class="hl-1">&lt;</span><span class="hl-7">ParameterValue</span><span class="hl-1">&gt;[]</span><br/><span class="hl-1">  ): </span><span class="hl-7">ResolvedParameterValue</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">class</span><span class="hl-1"> </span><span class="hl-9">Parameter</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 设置配置项</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">key</span><span class="hl-7"> 参数名 (如 &#39;opacity&#39;, &#39;maxMemoryUsage&#39;)</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">value</span><span class="hl-7"> 参数值</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-5">key</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">, </span><span class="hl-5">value</span><span class="hl-1">: </span><span class="hl-9">any</span><span class="hl-1">): </span><span class="hl-9">void</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 重置配置项（移除当前层级的设置，恢复继承上游的值）</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">keys</span><span class="hl-7"> 要重置的参数名列表</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">reset</span><span class="hl-1">(...</span><span class="hl-5">keys</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">[]): </span><span class="hl-9">void</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 获取经过继承计算后的最终值（每次调用创建新对象）</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">upstream</span><span class="hl-7"> 上游 Parameter 对象列表（通常由引擎自动传入）</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">resolveValue</span><span class="hl-1">(...</span><span class="hl-5">upstream</span><span class="hl-1">: </span><span class="hl-9">Parameter</span><span class="hl-1">[]): </span><span class="hl-9">ResolvedParameterValue</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 获取经过继承计算后的最终值（复用 target 对象，避免重复创建）</span><br/><span class="hl-7">   * 适用于高频调用场景（如逐帧更新），可显著减少 GC 压力。</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">target</span><span class="hl-7"> 用于写入结果的已有对象，其属性会被重置为默认值后重新赋值</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">upstream</span><span class="hl-7"> 上游 Parameter 对象列表</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-8">static</span><span class="hl-1"> </span><span class="hl-4">resolveValueTo</span><span class="hl-1">(</span><br/><span class="hl-1">    </span><span class="hl-5">target</span><span class="hl-1">: </span><span class="hl-9">Partial</span><span class="hl-1">&lt;</span><span class="hl-9">ResolvedParameterValue</span><span class="hl-1">&gt;,</span><br/><span class="hl-1">    ...</span><span class="hl-5">upstream</span><span class="hl-1">: </span><span class="hl-9">Partial</span><span class="hl-1">&lt;</span><span class="hl-9">ParameterValue</span><span class="hl-1">&gt;[]</span><br/><span class="hl-1">  ): </span><span class="hl-9">ResolvedParameterValue</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <blockquote>
@@ -58,7 +58,7 @@
 </blockquote>
 <h4 id="3-version-版本标识" class="tsd-anchor-link">3. Version (版本标识)<a href="#3-version-版本标识" 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><code>ResolvedParameterValue</code> 通过 <code>versionNumber: number</code> 标识当前配置的版本。引擎内部使用整数哈希（而非字符串拼接）计算版本号，用于高效的脏检查。</p>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">ResolvedParameterValue</span><span class="hl-1"> </span><span class="hl-3">extends</span><span class="hl-1"> </span><span class="hl-7">ParameterValue</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 整数哈希，输入参数变化时值会改变，用于脏检查 */</span><br/><span class="hl-1">  </span><span class="hl-6">versionNumber</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">ResolvedParameterValue</span><span class="hl-1"> </span><span class="hl-8">extends</span><span class="hl-1"> </span><span class="hl-9">ParameterValue</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 整数哈希，输入参数变化时值会改变，用于脏检查 */</span><br/><span class="hl-1">  </span><span class="hl-5">versionNumber</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <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>
@@ -81,19 +81,19 @@
 </blockquote>
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" 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="1-基础配置-basic-usage" class="tsd-anchor-link">1. 基础配置 (Basic Usage)<a href="#1-基础配置-basic-usage" 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="typescript"><span class="hl-8">// 1. 设置全局最大显存 (影响所有模型)</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">// 2. 设置全局半透明</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;opacity&#39;</span><span class="hl-1">, </span><span class="hl-11">0.5</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-7">// 1. 设置全局最大显存 (影响所有模型)</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;maxMemoryUsage&#39;</span><span class="hl-1">, </span><span class="hl-3">512</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 2. 设置全局半透明</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;opacity&#39;</span><span class="hl-1">, </span><span class="hl-3">0.5</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-局部覆盖-override" class="tsd-anchor-link">2. 局部覆盖 (Override)<a href="#2-局部覆盖-override" 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="typescript"><span class="hl-8">// 场景中大部分模型不产生阴影</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;castShadow&#39;</span><span class="hl-1">, </span><span class="hl-3">false</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 但让特定的“主角”模型产生阴影</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">heroModel</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">models</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">];</span><br/><span class="hl-6">heroModel</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;castShadow&#39;</span><span class="hl-1">, </span><span class="hl-3">true</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-7">// 场景中大部分模型不产生阴影</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;castShadow&#39;</span><span class="hl-1">, </span><span class="hl-8">false</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 但让特定的“主角”模型产生阴影</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">heroModel</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">models</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-5">heroModel</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;castShadow&#39;</span><span class="hl-1">, </span><span class="hl-8">true</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="3-重置配置-reset" class="tsd-anchor-link">3. 重置配置 (Reset)<a href="#3-重置配置-reset" 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="typescript"><span class="hl-8">// 假设之前设置了 opacity</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;opacity&#39;</span><span class="hl-1">, </span><span class="hl-11">0.5</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// ... 一段时间后 ...</span><br/><br/><span class="hl-8">// 移除该设置，恢复默认值 (或继承值)</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">reset</span><span class="hl-1">(</span><span class="hl-9">&#39;opacity&#39;</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-7">// 假设之前设置了 opacity</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-10">&#39;opacity&#39;</span><span class="hl-1">, </span><span class="hl-3">0.5</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// ... 一段时间后 ...</span><br/><br/><span class="hl-7">// 移除该设置，恢复默认值 (或继承值)</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">reset</span><span class="hl-1">(</span><span class="hl-10">&#39;opacity&#39;</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="4-获取配置-get-value" class="tsd-anchor-link">4. 获取配置 (Get Value)<a href="#4-获取配置-get-value" 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="typescript"><span class="hl-8">// 获取当前对象上的配置（如果未设置，则为 undefined）</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">ownOpacity</span><span class="hl-1"> = </span><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-6">opacity</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 获取最终生效的配置（计算继承链后的值）</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">finalOpacity</span><span class="hl-1"> = </span><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">resolveValue</span><span class="hl-1">().</span><span class="hl-6">opacity</span><span class="hl-1">;</span>
+<pre><code class="typescript"><span class="hl-7">// 获取当前对象上的配置（如果未设置，则为 undefined）</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">ownOpacity</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-5">opacity</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 获取最终生效的配置（计算继承链后的值）</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">finalOpacity</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">modelScene</span><span class="hl-1">.</span><span class="hl-5">parameter</span><span class="hl-1">.</span><span class="hl-4">resolveValue</span><span class="hl-1">().</span><span class="hl-5">opacity</span><span class="hl-1">;</span>
 </code><button type="button">Copy</button></pre>
 <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>