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_image-options.html CHANGED Viewed

@@ -12,12 +12,12 @@
 <p><strong>Definition</strong>: <a href="../../five/types/imageOptions.d.ts">ImageOptions</a></p>
 </blockquote>
 <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">/** 图片类型标识 (内部使用，如 &quot;pano.front&quot;) */</span><br/><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><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-8">   * 图片格式参数</span><br/><span class="hl-8">   * 自动降级逻辑：如果指定格式（如 avif/webp）当前浏览器不支持，会自动降级为 jpg</span><br/><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">/**</span><br/><span class="hl-8">   * 图片裁切 [x, y, width, height]</span><br/><span class="hl-8">   * 通常用于内部工具获取局部图片，初始化 Five 时一般不设置此项</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-6">cut</span><span class="hl-1">?: [</span><span class="hl-13">x</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-13">y</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-13">width</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-13">height</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">/** 锐化参数 (仅部分 CDN 支持) */</span><br/><span class="hl-1">  </span><span class="hl-6">sharpen</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">mappings</span><span class="hl-1">?: </span><span class="hl-7">ImageURLMappings</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">/** 图片类型标识 (内部使用，如 &quot;pano.front&quot;) */</span><br/><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><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-7">   * 图片格式参数</span><br/><span class="hl-7">   * 自动降级逻辑：如果指定格式（如 avif/webp）当前浏览器不支持，会自动降级为 jpg</span><br/><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">/**</span><br/><span class="hl-7">   * 图片裁切 [x, y, width, height]</span><br/><span class="hl-7">   * 通常用于内部工具获取局部图片，初始化 Five 时一般不设置此项</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-5">cut</span><span class="hl-1">?: [</span><span class="hl-13">x</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">, </span><span class="hl-13">y</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">, </span><span class="hl-13">width</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">, </span><span class="hl-13">height</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">/** 锐化参数 (仅部分 CDN 支持) */</span><br/><span class="hl-1">  </span><span class="hl-5">sharpen</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">mappings</span><span class="hl-1">?: </span><span class="hl-9">ImageURLMappings</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>
 <h3 id="imageurlmappings" class="tsd-anchor-link">ImageURLMappings<a href="#imageurlmappings" 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">ImageURLMappings</span><span class="hl-1"> {</span><br/><span class="hl-1">  [</span><span class="hl-6">publicDomain</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">]: {</span><br/><span class="hl-1">    </span><span class="hl-8">/** CDN 类型，目前支持 &#39;tencentCloud&#39; | &#39;aliyun&#39; 用于区分特定云厂商的图片处理参数 */</span><br/><span class="hl-1">    </span><span class="hl-9">&quot;type&quot;</span><span class="hl-1">?: </span><span class="hl-7">string</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-9">&quot;pano&quot;</span><span class="hl-1">: [</span><span class="hl-7">string</span><span class="hl-1">, </span><span class="hl-7">string</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-9">&quot;tile&quot;</span><span class="hl-1">: [</span><span class="hl-7">string</span><span class="hl-1">, </span><span class="hl-7">string</span><span class="hl-1">];</span><br/><span class="hl-1">    </span><span class="hl-8">/** 3D Tile 模型域名映射列表 */</span><br/><span class="hl-1">    </span><span class="hl-9">&quot;model&quot;</span><span class="hl-1">: [</span><span class="hl-7">string</span><span class="hl-1">, </span><span class="hl-7">string</span><span class="hl-1">];</span><br/><span class="hl-1">    </span><span class="hl-8">/** AT3D 材质域名映射列表 */</span><br/><span class="hl-1">    </span><span class="hl-9">&quot;texture&quot;</span><span class="hl-1">: [</span><span class="hl-7">string</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-9">&quot;default&quot;</span><span class="hl-1">: [</span><span class="hl-7">string</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-8">interface</span><span class="hl-1"> </span><span class="hl-9">ImageURLMappings</span><span class="hl-1"> {</span><br/><span class="hl-1">  [</span><span class="hl-5">publicDomain</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">]: {</span><br/><span class="hl-1">    </span><span class="hl-7">/** CDN 类型，目前支持 &#39;tencentCloud&#39; | &#39;aliyun&#39; 用于区分特定云厂商的图片处理参数 */</span><br/><span class="hl-1">    </span><span class="hl-10">&quot;type&quot;</span><span class="hl-1">?: </span><span class="hl-9">string</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-10">&quot;pano&quot;</span><span class="hl-1">: [</span><span class="hl-9">string</span><span class="hl-1">, </span><span class="hl-9">string</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-10">&quot;tile&quot;</span><span class="hl-1">: [</span><span class="hl-9">string</span><span class="hl-1">, </span><span class="hl-9">string</span><span class="hl-1">];</span><br/><span class="hl-1">    </span><span class="hl-7">/** 3D Tile 模型域名映射列表 */</span><br/><span class="hl-1">    </span><span class="hl-10">&quot;model&quot;</span><span class="hl-1">: [</span><span class="hl-9">string</span><span class="hl-1">, </span><span class="hl-9">string</span><span class="hl-1">];</span><br/><span class="hl-1">    </span><span class="hl-7">/** AT3D 材质域名映射列表 */</span><br/><span class="hl-1">    </span><span class="hl-10">&quot;texture&quot;</span><span class="hl-1">: [</span><span class="hl-9">string</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-10">&quot;default&quot;</span><span class="hl-1">: [</span><span class="hl-9">string</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>
@@ -84,17 +84,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="基础优化配置-推荐" 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>启用 AVIF 格式并设置初始尺寸为 <code>512</code>，适用于大多数场景。</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-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-6">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">format:</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-6">size:</span><span class="hl-1"> </span><span class="hl-11">512</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">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-5">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">format:</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-5">size:</span><span class="hl-1"> </span><span class="hl-3">512</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>
 <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>custom-oss-public.ljcdn.com</code> 域名映射到对应的资源专用 OSS 域名。</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-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-6">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">mappings:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-9">&quot;custom-oss-public.ljcdn.com&quot;</span><span class="hl-6">:</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-6">type:</span><span class="hl-1"> </span><span class="hl-9">&quot;tencentCloud&quot;</span><span class="hl-1">, </span><span class="hl-8">// 指定使用腾讯云图片处理协议</span><br/><span class="hl-1">        </span><span class="hl-6">pano:</span><span class="hl-1"> [</span><span class="hl-9">&quot;custom-oss-image-1.com&quot;</span><span class="hl-1">, </span><span class="hl-9">&quot;custom-oss-image-2.com&quot;</span><span class="hl-1">], </span><span class="hl-8">// 双域名负载均衡</span><br/><span class="hl-1">        </span><span class="hl-6">tile:</span><span class="hl-1"> [</span><span class="hl-9">&quot;custom-oss-tile-1.com&quot;</span><span class="hl-1">, </span><span class="hl-9">&quot;custom-oss-tile-2.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-6">model:</span><span class="hl-1"> [</span><span class="hl-9">&quot;custom-oss-model-1.com&quot;</span><span class="hl-1">, </span><span class="hl-9">&quot;custom-oss-model-2.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-6">texture:</span><span class="hl-1"> [</span><span class="hl-9">&quot;custom-oss-image-3.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-6">default:</span><span class="hl-1"> [</span><span class="hl-9">&quot;custom-oss-image-4.com&quot;</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="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-5">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">mappings:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-10">&quot;custom-oss-public.ljcdn.com&quot;</span><span class="hl-5">:</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-10">&quot;tencentCloud&quot;</span><span class="hl-1">, </span><span class="hl-7">// 指定使用腾讯云图片处理协议</span><br/><span class="hl-1">        </span><span class="hl-5">pano:</span><span class="hl-1"> [</span><span class="hl-10">&quot;custom-oss-image-1.com&quot;</span><span class="hl-1">, </span><span class="hl-10">&quot;custom-oss-image-2.com&quot;</span><span class="hl-1">], </span><span class="hl-7">// 双域名负载均衡</span><br/><span class="hl-1">        </span><span class="hl-5">tile:</span><span class="hl-1"> [</span><span class="hl-10">&quot;custom-oss-tile-1.com&quot;</span><span class="hl-1">, </span><span class="hl-10">&quot;custom-oss-tile-2.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-5">model:</span><span class="hl-1"> [</span><span class="hl-10">&quot;custom-oss-model-1.com&quot;</span><span class="hl-1">, </span><span class="hl-10">&quot;custom-oss-model-2.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-5">texture:</span><span class="hl-1"> [</span><span class="hl-10">&quot;custom-oss-image-3.com&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">        </span><span class="hl-5">default:</span><span class="hl-1"> [</span><span class="hl-10">&quot;custom-oss-image-4.com&quot;</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>
 <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>使用 SDK 提供的 <code>defaultImageURLTransform</code> 工具函数（通常导出为 <code>defaultImageURLTransform</code>，可重命名为 <code>imageURL</code>），结合 <code>cut</code> 参数获取全景图特定区域（例如获取前方图片的中心 512x512 区域）。</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">defaultImageURLTransform</span><span class="hl-1"> </span><span class="hl-10">as</span><span class="hl-1"> </span><span class="hl-6">imageURL</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">originalUrl</span><span class="hl-1"> = </span><span class="hl-9">&quot;https://vr-public.realsee-cdn.com/.../pano_f.jpg&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">cutUrl</span><span class="hl-1"> = </span><span class="hl-5">imageURL</span><span class="hl-1">(</span><span class="hl-6">originalUrl</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">cut:</span><span class="hl-1"> [</span><span class="hl-11">256</span><span class="hl-1">, </span><span class="hl-11">256</span><span class="hl-1">, </span><span class="hl-11">512</span><span class="hl-1">, </span><span class="hl-11">512</span><span class="hl-1">], </span><span class="hl-8">// x, y, width, height</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-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><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-6">cutUrl</span><span class="hl-1">);</span><br/><span class="hl-8">// 输出示例: https://vr-image-4.realsee-cdn.com/.../pano_f.jpg?imageMogr2/format/webp/cut/512x512x256x256/quality/80</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">defaultImageURLTransform</span><span class="hl-1"> </span><span class="hl-11">as</span><span class="hl-1"> </span><span class="hl-5">imageURL</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">originalUrl</span><span class="hl-1"> = </span><span class="hl-10">&quot;https://vr-public.realsee-cdn.com/.../pano_f.jpg&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">cutUrl</span><span class="hl-1"> = </span><span class="hl-4">imageURL</span><span class="hl-1">(</span><span class="hl-5">originalUrl</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">cut:</span><span class="hl-1"> [</span><span class="hl-3">256</span><span class="hl-1">, </span><span class="hl-3">256</span><span class="hl-1">, </span><span class="hl-3">512</span><span class="hl-1">, </span><span class="hl-3">512</span><span class="hl-1">], </span><span class="hl-7">// x, y, width, height</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-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><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-5">cutUrl</span><span class="hl-1">);</span><br/><span class="hl-7">// 输出示例: https://vr-image-4.realsee-cdn.com/.../pano_f.jpg?imageMogr2/format/webp/cut/512x512x256x256/quality/80</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_load-external-model.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/model/loaders/shared.d.ts">LoadResultType</a></p>
 </blockquote>
 <p>所有加载函数均返回 <code>Promise&lt;LoadResultType&gt;</code>。</p>
-<pre><code class="typescript"><span class="hl-8">// 通用返回类型</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">LoadResultType</span><span class="hl-1">&lt;</span><span class="hl-7">Scene</span><span class="hl-1"> = </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Object3D</span><span class="hl-1">&gt; = {</span><br/><span class="hl-1">  </span><span class="hl-6">type</span><span class="hl-1">: </span><span class="hl-9">&#39;gltf&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;obj&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;ply&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;fbx&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;pbm&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;splat&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;spz&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;b3dm&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;pnts&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;at3d&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;dome&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;domez&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;x3p&#39;</span><span class="hl-1">; </span><span class="hl-8">// 模型类型</span><br/><span class="hl-1">  </span><span class="hl-6">modelUpAxis</span><span class="hl-1">: </span><span class="hl-9">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">;     </span><span class="hl-8">// 原始模型的上轴</span><br/><span class="hl-1">  </span><span class="hl-6">upAxis</span><span class="hl-1">: </span><span class="hl-9">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">;          </span><span class="hl-8">// 输出模型的上轴 (通常为 Z)</span><br/><span class="hl-1">  </span><span class="hl-6">byteLength</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;         </span><span class="hl-8">// 文件字节大小</span><br/><span class="hl-1">  </span><span class="hl-6">memoryUsage</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;        </span><span class="hl-8">// 显存/内存占用估算</span><br/><span class="hl-1">  </span><span class="hl-6">uri</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;                </span><span class="hl-8">// 模型地址</span><br/><span class="hl-1">  </span><span class="hl-6">scene</span><span class="hl-1">: </span><span class="hl-7">Scene</span><span class="hl-1">;               </span><span class="hl-8">// Three.js 对象 (Group 或 Object3D)，可直接添加到场景</span><br/><span class="hl-1">  </span><span class="hl-6">textures</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Texture</span><span class="hl-1">[];  </span><span class="hl-8">// 加载的纹理列表</span><br/><span class="hl-1">  </span><span class="hl-6">animations</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">AnimationClip</span><span class="hl-1">[]; </span><span class="hl-8">// 动画剪辑列表</span><br/><span class="hl-1">  </span><span class="hl-6">rtcCenter</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-8">// 若存在 RTC (Relative To Center) 坐标偏移</span><br/><span class="hl-1">  </span><span class="hl-5">dispose</span><span class="hl-1">: () </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">void</span><span class="hl-1">;        </span><span class="hl-8">// 销毁资源函数</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">// 通用配置项接口</span><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">BaseLoaderOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">upAxis</span><span class="hl-1">?: </span><span class="hl-9">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">;         </span><span class="hl-8">// 期望输出的上轴，默认为 &#39;Z&#39; (Five 坐标系)</span><br/><span class="hl-1">  </span><span class="hl-6">modelUpAxis</span><span class="hl-1">?: </span><span class="hl-9">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">;    </span><span class="hl-8">// (部分加载器支持) 原始模型的上轴，用于自动旋转修正</span><br/><span class="hl-1">  </span><span class="hl-6">fetcher</span><span class="hl-1">?: </span><span class="hl-7">Fetcher</span><span class="hl-1">;          </span><span class="hl-8">// 自定义网络请求 Fetcher</span><br/><span class="hl-1">  </span><span class="hl-6">light</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;            </span><span class="hl-8">// 是否使用简化/无光照材质 (取决于加载器实现)</span><br/><span class="hl-1">  </span><span class="hl-5">onDownloadProgress</span><span class="hl-1">?: (</span><span class="hl-6">progress</span><span class="hl-1">: { </span><span class="hl-6">loaded</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-6">total</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1"> }) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">void</span><span class="hl-1">; </span><span class="hl-8">// 下载进度回调</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-7">// 通用返回类型</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">LoadResultType</span><span class="hl-1">&lt;</span><span class="hl-9">Scene</span><span class="hl-1"> = </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Object3D</span><span class="hl-1">&gt; = {</span><br/><span class="hl-1">  </span><span class="hl-5">type</span><span class="hl-1">: </span><span class="hl-10">&#39;gltf&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;obj&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;ply&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;fbx&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;pbm&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;splat&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;spz&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;b3dm&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;pnts&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;at3d&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;dome&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;domez&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;x3p&#39;</span><span class="hl-1">; </span><span class="hl-7">// 模型类型</span><br/><span class="hl-1">  </span><span class="hl-5">modelUpAxis</span><span class="hl-1">: </span><span class="hl-10">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">;     </span><span class="hl-7">// 原始模型的上轴</span><br/><span class="hl-1">  </span><span class="hl-5">upAxis</span><span class="hl-1">: </span><span class="hl-10">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">;          </span><span class="hl-7">// 输出模型的上轴 (通常为 Z)</span><br/><span class="hl-1">  </span><span class="hl-5">byteLength</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;         </span><span class="hl-7">// 文件字节大小</span><br/><span class="hl-1">  </span><span class="hl-5">memoryUsage</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;        </span><span class="hl-7">// 显存/内存占用估算</span><br/><span class="hl-1">  </span><span class="hl-5">uri</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;                </span><span class="hl-7">// 模型地址</span><br/><span class="hl-1">  </span><span class="hl-5">scene</span><span class="hl-1">: </span><span class="hl-9">Scene</span><span class="hl-1">;               </span><span class="hl-7">// Three.js 对象 (Group 或 Object3D)，可直接添加到场景</span><br/><span class="hl-1">  </span><span class="hl-5">textures</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Texture</span><span class="hl-1">[];  </span><span class="hl-7">// 加载的纹理列表</span><br/><span class="hl-1">  </span><span class="hl-5">animations</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">AnimationClip</span><span class="hl-1">[]; </span><span class="hl-7">// 动画剪辑列表</span><br/><span class="hl-1">  </span><span class="hl-5">rtcCenter</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-7">// 若存在 RTC (Relative To Center) 坐标偏移</span><br/><span class="hl-1">  </span><span class="hl-4">dispose</span><span class="hl-1">: () </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">void</span><span class="hl-1">;        </span><span class="hl-7">// 销毁资源函数</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">// 通用配置项接口</span><br/><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">BaseLoaderOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">upAxis</span><span class="hl-1">?: </span><span class="hl-10">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">;         </span><span class="hl-7">// 期望输出的上轴，默认为 &#39;Z&#39; (Five 坐标系)</span><br/><span class="hl-1">  </span><span class="hl-5">modelUpAxis</span><span class="hl-1">?: </span><span class="hl-10">&#39;Y&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">;    </span><span class="hl-7">// (部分加载器支持) 原始模型的上轴，用于自动旋转修正</span><br/><span class="hl-1">  </span><span class="hl-5">fetcher</span><span class="hl-1">?: </span><span class="hl-9">Fetcher</span><span class="hl-1">;          </span><span class="hl-7">// 自定义网络请求 Fetcher</span><br/><span class="hl-1">  </span><span class="hl-5">light</span><span class="hl-1">?: </span><span class="hl-9">boolean</span><span class="hl-1">;            </span><span class="hl-7">// 是否使用简化/无光照材质 (取决于加载器实现)</span><br/><span class="hl-1">  </span><span class="hl-4">onDownloadProgress</span><span class="hl-1">?: (</span><span class="hl-5">progress</span><span class="hl-1">: { </span><span class="hl-5">loaded</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">, </span><span class="hl-5">total</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1"> }) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">void</span><span class="hl-1">; </span><span class="hl-7">// 下载进度回调</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>
@@ -535,31 +535,31 @@
 </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="基础用法：加载-gltf-模型-basic-usage" class="tsd-anchor-link">基础用法：加载 GLTF 模型 (Basic Usage)<a href="#基础用法：加载-gltf-模型-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-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">FivePlugin</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">loadGltf</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><span class="hl-10">import</span><span class="hl-1"> </span><span class="hl-3">*</span><span class="hl-1"> </span><span class="hl-10">as</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1"> </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;three&#39;</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><span class="hl-8">/*...*/</span><span class="hl-1">});</span><br/><br/><span class="hl-8">// 加载 GLB 模型</span><br/><span class="hl-5">loadGltf</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/model.glb&#39;</span><span class="hl-1">).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">// 1. 获取模型对象</span><br/><span class="hl-1">  </span><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">model</span><span class="hl-1"> = </span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">// 2. 设置位置和大小</span><br/><span class="hl-1">  </span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">position</span><span class="hl-1">.</span><span class="hl-5">set</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">0</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">scale</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">1</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-8">// 3. 添加到 Five 场景</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">model</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-8">// 4. (可选) 渲染一帧以确保显示</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/><br/><span class="hl-1">  </span><span class="hl-8">// 保存 result 用于后续销毁</span><br/><span class="hl-1">  </span><span class="hl-8">// result.dispose();</span><br/><span class="hl-1">}).</span><span class="hl-5">catch</span><span class="hl-1">(</span><span class="hl-6">err</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">error</span><span class="hl-1">(</span><span class="hl-9">&#39;加载失败&#39;</span><span class="hl-1">, </span><span class="hl-6">err</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">FivePlugin</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">loadGltf</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><span class="hl-11">import</span><span class="hl-1"> </span><span class="hl-8">*</span><span class="hl-1"> </span><span class="hl-11">as</span><span class="hl-1"> </span><span class="hl-5">THREE</span><span class="hl-1"> </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;three&#39;</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><span class="hl-7">/*...*/</span><span class="hl-1">});</span><br/><br/><span class="hl-7">// 加载 GLB 模型</span><br/><span class="hl-4">loadGltf</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/model.glb&#39;</span><span class="hl-1">).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">// 1. 获取模型对象</span><br/><span class="hl-1">  </span><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">model</span><span class="hl-1"> = </span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">// 2. 设置位置和大小</span><br/><span class="hl-1">  </span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">position</span><span class="hl-1">.</span><span class="hl-4">set</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">0</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">scale</span><span class="hl-1">.</span><span class="hl-4">set</span><span class="hl-1">(</span><span class="hl-3">1</span><span class="hl-1">, </span><span class="hl-3">1</span><span class="hl-1">, </span><span class="hl-3">1</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-7">// 3. 添加到 Five 场景</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">model</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-7">// 4. (可选) 渲染一帧以确保显示</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/><br/><span class="hl-1">  </span><span class="hl-7">// 保存 result 用于后续销毁</span><br/><span class="hl-1">  </span><span class="hl-7">// result.dispose();</span><br/><span class="hl-1">}).</span><span class="hl-4">catch</span><span class="hl-1">(</span><span class="hl-5">err</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">error</span><span class="hl-1">(</span><span class="hl-10">&#39;加载失败&#39;</span><span class="hl-1">, </span><span class="hl-5">err</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="进阶用法：加载高斯泼溅-gaussian-splat" class="tsd-anchor-link">进阶用法：加载高斯泼溅 (Gaussian Splat)<a href="#进阶用法：加载高斯泼溅-gaussian-splat" 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">loadSplat</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">loadSplat</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/scene.splat&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">modelUpAxis:</span><span class="hl-1"> </span><span class="hl-9">&#39;Y&#39;</span><span class="hl-1">, </span><span class="hl-8">// 假设原始数据是 Y-up</span><br/><span class="hl-1">  </span><span class="hl-6">upAxis:</span><span class="hl-1"> </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">,      </span><span class="hl-8">// 转换到 Five 的 Z-up</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">splatMesh</span><span class="hl-1"> = </span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</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">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">splatMesh</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">loadSplat</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">loadSplat</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/scene.splat&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">modelUpAxis:</span><span class="hl-1"> </span><span class="hl-10">&#39;Y&#39;</span><span class="hl-1">, </span><span class="hl-7">// 假设原始数据是 Y-up</span><br/><span class="hl-1">  </span><span class="hl-5">upAxis:</span><span class="hl-1"> </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">,      </span><span class="hl-7">// 转换到 Five 的 Z-up</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">splatMesh</span><span class="hl-1"> = </span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</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">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">splatMesh</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>
 <h3 id="进阶用法：自定义-ply-属性映射-custom-ply-properties" class="tsd-anchor-link">进阶用法：自定义 PLY 属性映射 (Custom PLY Properties)<a href="#进阶用法：自定义-ply-属性映射-custom-ply-properties" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">loadPly</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">loadPly</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/data.ply&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">type:</span><span class="hl-1"> </span><span class="hl-9">&#39;pbmPointCloud&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">customPropertyMapping:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">intensity:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-6">itemType:</span><span class="hl-1"> </span><span class="hl-9">&#39;float32&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-6">itemNames:</span><span class="hl-1"> [</span><span class="hl-9">&#39;intensity&#39;</span><span class="hl-1">],</span><br/><span class="hl-1">      </span><span class="hl-6">normalized:</span><span class="hl-1"> </span><span class="hl-3">true</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">// result.scene 是一个 PBMPointCloud 对象</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</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">loadPly</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">loadPly</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/data.ply&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-10">&#39;pbmPointCloud&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">customPropertyMapping:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">intensity:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-5">itemType:</span><span class="hl-1"> </span><span class="hl-10">&#39;float32&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-5">itemNames:</span><span class="hl-1"> [</span><span class="hl-10">&#39;intensity&#39;</span><span class="hl-1">],</span><br/><span class="hl-1">      </span><span class="hl-5">normalized:</span><span class="hl-1"> </span><span class="hl-8">true</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">// result.scene 是一个 PBMPointCloud 对象</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="基础用法：加载-obj-模型-basic-usage-obj" class="tsd-anchor-link">基础用法：加载 OBJ 模型 (Basic Usage - OBJ)<a href="#基础用法：加载-obj-模型-basic-usage-obj" 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">loadObj</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">loadObj</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/model.obj&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">modelUpAxis:</span><span class="hl-1"> </span><span class="hl-9">&#39;Z&#39;</span><span class="hl-1">, </span><span class="hl-8">// OBJ 默认通常是 Z-up (或根据实际情况调整)</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">five</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-8">// OBJ 文件中定义的 .mtl 材质会自动加载</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">loadObj</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">loadObj</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/model.obj&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">modelUpAxis:</span><span class="hl-1"> </span><span class="hl-10">&#39;Z&#39;</span><span class="hl-1">, </span><span class="hl-7">// OBJ 默认通常是 Z-up (或根据实际情况调整)</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">five</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-7">// OBJ 文件中定义的 .mtl 材质会自动加载</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="基础用法：加载-fbx-模型" class="tsd-anchor-link">基础用法：加载 FBX 模型<a href="#基础用法：加载-fbx-模型" 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">loadFbx</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">loadFbx</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/model.fbx&#39;</span><span class="hl-1">).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">five</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-8">// 动画会自动解析到 result.animations</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">loadFbx</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">loadFbx</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/model.fbx&#39;</span><span class="hl-1">).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">five</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-7">// 动画会自动解析到 result.animations</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="进阶用法：加载-dome-全景-panorama" class="tsd-anchor-link">进阶用法：加载 Dome 全景 (Panorama)<a href="#进阶用法：加载-dome-全景-panorama" 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">loadDome</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 加载 .dome 或 .domez 格式</span><br/><span class="hl-5">loadDome</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/panorama.domez&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">light:</span><span class="hl-1"> </span><span class="hl-3">false</span><span class="hl-1">, </span><span class="hl-8">// 全景模型通常不需要光照计算</span><br/><span class="hl-1">  </span><span class="hl-6">textureOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">size:</span><span class="hl-1"> </span><span class="hl-11">4096</span><span class="hl-1">, </span><span class="hl-8">// 限制最大纹理尺寸</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">result</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-6">position</span><span class="hl-1">.</span><span class="hl-5">set</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">0</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">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</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">loadDome</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 加载 .dome 或 .domez 格式</span><br/><span class="hl-4">loadDome</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/panorama.domez&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">light:</span><span class="hl-1"> </span><span class="hl-8">false</span><span class="hl-1">, </span><span class="hl-7">// 全景模型通常不需要光照计算</span><br/><span class="hl-1">  </span><span class="hl-5">textureOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">size:</span><span class="hl-1"> </span><span class="hl-3">4096</span><span class="hl-1">, </span><span class="hl-7">// 限制最大纹理尺寸</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-5">position</span><span class="hl-1">.</span><span class="hl-4">set</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">0</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">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="进阶用法：加载压缩模型-at3d" class="tsd-anchor-link">进阶用法：加载压缩模型 (AT3D)<a href="#进阶用法：加载压缩模型-at3d" 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">loadAt3d</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">loadAt3d</span><span class="hl-1">(</span><span class="hl-9">&#39;https://example.com/model.at3d&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">light:</span><span class="hl-1"> </span><span class="hl-3">false</span><span class="hl-1">,</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">((</span><span class="hl-6">result</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">five</span><span class="hl-1">.</span><span class="hl-6">scene</span><span class="hl-1">.</span><span class="hl-5">add</span><span class="hl-1">(</span><span class="hl-6">result</span><span class="hl-1">.</span><span class="hl-6">scene</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">loadAt3d</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">loadAt3d</span><span class="hl-1">(</span><span class="hl-10">&#39;https://example.com/model.at3d&#39;</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">light:</span><span class="hl-1"> </span><span class="hl-8">false</span><span class="hl-1">,</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">((</span><span class="hl-5">result</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">five</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">.</span><span class="hl-4">add</span><span class="hl-1">(</span><span class="hl-5">result</span><span class="hl-1">.</span><span class="hl-5">scene</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="debugging" class="tsd-anchor-link">Debugging<a href="#debugging" 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_load-progress.html CHANGED Viewed

@@ -61,33 +61,33 @@
 <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-model-loading-模型加载" class="tsd-anchor-link">1. Model Loading (模型加载)<a href="#1-model-loading-模型加载" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <h4 id="检查当前状态-state-checking" class="tsd-anchor-link">检查当前状态 (State Checking)<a href="#检查当前状态-state-checking" 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>
-<pre><code class="ts"><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">loaded</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;Model is ready (basic data loaded)!&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">refined</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;Model is fully refined (high-res data loaded)!&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span>
+<pre><code class="ts"><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">loaded</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;Model is ready (basic data loaded)!&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">refined</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;Model is fully refined (high-res data loaded)!&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="监控细化进度-refine-progress" class="tsd-anchor-link">监控细化进度 (Refine Progress)<a href="#监控细化进度-refine-progress" 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>five.model.refineProgress</code> 提供了当前视图下模型细化的整体进度。</p>
-<pre><code class="ts"><span class="hl-3">const</span><span class="hl-1"> [</span><span class="hl-4">current</span><span class="hl-1">, </span><span class="hl-4">total</span><span class="hl-1">] = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">refineProgress</span><span class="hl-1">;</span><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">`Model Refine Progress: </span><span class="hl-3">${</span><span class="hl-6">current</span><span class="hl-3">}</span><span class="hl-9"> / </span><span class="hl-3">${</span><span class="hl-6">total</span><span class="hl-3">}</span><span class="hl-9">`</span><span class="hl-1">);</span><br/><br/><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">current</span><span class="hl-1"> === </span><span class="hl-6">total</span><span class="hl-1"> &amp;&amp; </span><span class="hl-6">total</span><span class="hl-1"> &gt; </span><span class="hl-11">0</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;Model is fully refined for current view.&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span>
+<pre><code class="ts"><span class="hl-8">const</span><span class="hl-1"> [</span><span class="hl-6">current</span><span class="hl-1">, </span><span class="hl-6">total</span><span class="hl-1">] = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">refineProgress</span><span class="hl-1">;</span><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">`Model Refine Progress: </span><span class="hl-8">${</span><span class="hl-5">current</span><span class="hl-8">}</span><span class="hl-10"> / </span><span class="hl-8">${</span><span class="hl-5">total</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><br/><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">current</span><span class="hl-1"> === </span><span class="hl-5">total</span><span class="hl-1"> &amp;&amp; </span><span class="hl-5">total</span><span class="hl-1"> &gt; </span><span class="hl-3">0</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;Model is fully refined for current view.&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="监听加载完成事件" class="tsd-anchor-link">监听加载完成事件<a href="#监听加载完成事件" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<pre><code class="ts"><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;modelLoaded&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-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;Model has been loaded.&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><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;modelLoaded&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-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;Model has been loaded.&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="advanced-tile-级别进度" class="tsd-anchor-link">(Advanced) Tile 级别进度<a href="#advanced-tile-级别进度" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
 <p>对于 <code>3dtiles</code> 类型的模型，你可以访问具体的 Tile 对象来查看进度。</p>
-<pre><code class="ts"><span class="hl-8">// 仅示例，通常在调试或特定渲染逻辑中使用</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">progress</span><span class="hl-1"> = </span><span class="hl-6">tile</span><span class="hl-1">.</span><span class="hl-6">content</span><span class="hl-1">.</span><span class="hl-6">loadProgress</span><span class="hl-1">; </span><span class="hl-8">// [0, 1]</span>
+<pre><code class="ts"><span class="hl-7">// 仅示例，通常在调试或特定渲染逻辑中使用</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">progress</span><span class="hl-1"> = </span><span class="hl-5">tile</span><span class="hl-1">.</span><span class="hl-5">content</span><span class="hl-1">.</span><span class="hl-5">loadProgress</span><span class="hl-1">; </span><span class="hl-7">// [0, 1]</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="tile-lifecycle-monitoring-tile-生命周期监控" class="tsd-anchor-link">Tile Lifecycle Monitoring (Tile 生命周期监控)<a href="#tile-lifecycle-monitoring-tile-生命周期监控" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
 <p>监控单个 Tile 的加载与卸载事件，用于更精细的调试或资源统计。</p>
-<pre><code class="ts"><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;model.tileLoad&quot;</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">`Tile loaded: </span><span class="hl-3">${</span><span class="hl-6">tile</span><span class="hl-12">.</span><span class="hl-6">debugLabel</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">content</span><span class="hl-12">.</span><span class="hl-6">byteLength</span><span class="hl-3">}</span><span class="hl-9">`</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">on</span><span class="hl-1">(</span><span class="hl-9">&quot;model.tileUnload&quot;</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">`Tile unloaded: </span><span class="hl-3">${</span><span class="hl-6">tile</span><span class="hl-12">.</span><span class="hl-6">debugLabel</span><span class="hl-3">}</span><span class="hl-9">`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><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;model.tileLoad&quot;</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">`Tile loaded: </span><span class="hl-8">${</span><span class="hl-5">tile</span><span class="hl-12">.</span><span class="hl-5">debugLabel</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">content</span><span class="hl-12">.</span><span class="hl-5">byteLength</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><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;model.tileUnload&quot;</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">`Tile unloaded: </span><span class="hl-8">${</span><span class="hl-5">tile</span><span class="hl-12">.</span><span class="hl-5">debugLabel</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-panorama-loading-全景图加载" class="tsd-anchor-link">2. Panorama Loading (全景图加载)<a href="#2-panorama-loading-全景图加载" 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>
 <h4 id="监听加载进度" class="tsd-anchor-link">监听加载进度<a href="#监听加载进度" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
 <p>使用 <code>pano.texture.progress</code> 事件获取当前全景图的加载进度。</p>
-<pre><code class="ts"><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;pano.texture.progress&quot;</span><span class="hl-1">, (</span><span class="hl-6">event</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-3">const</span><span class="hl-1"> { </span><span class="hl-4">progress</span><span class="hl-1">, </span><span class="hl-4">pano</span><span class="hl-1"> } = </span><span class="hl-6">event</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">`Pano </span><span class="hl-3">${</span><span class="hl-6">pano</span><span class="hl-12">.</span><span class="hl-6">panoIndex</span><span class="hl-3">}</span><span class="hl-9"> loading: </span><span class="hl-3">${</span><span class="hl-12">(</span><span class="hl-6">progress</span><span class="hl-12"> </span><span class="hl-1">*</span><span class="hl-12"> </span><span class="hl-11">100</span><span class="hl-12">).</span><span class="hl-5">toFixed</span><span class="hl-12">(</span><span class="hl-11">1</span><span class="hl-12">)</span><span class="hl-3">}</span><span class="hl-9">%`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><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;pano.texture.progress&quot;</span><span class="hl-1">, (</span><span class="hl-5">event</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">progress</span><span class="hl-1">, </span><span class="hl-6">pano</span><span class="hl-1"> } = </span><span class="hl-5">event</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">`Pano </span><span class="hl-8">${</span><span class="hl-5">pano</span><span class="hl-12">.</span><span class="hl-5">panoIndex</span><span class="hl-8">}</span><span class="hl-10"> loading: </span><span class="hl-8">${</span><span class="hl-12">(</span><span class="hl-5">progress</span><span class="hl-12"> </span><span class="hl-1">*</span><span class="hl-12"> </span><span class="hl-3">100</span><span class="hl-12">).</span><span class="hl-4">toFixed</span><span class="hl-12">(</span><span class="hl-3">1</span><span class="hl-12">)</span><span class="hl-8">}</span><span class="hl-10">%`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h4 id="生命周期事件" class="tsd-anchor-link">生命周期事件<a href="#生命周期事件" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4>
@@ -96,7 +96,7 @@
 <li><strong><code>pano.texture.success</code></strong>: 加载完成。</li>
 <li><strong><code>pano.texture.error</code></strong>: 加载失败。</li>
 </ul>
-<pre><code class="ts"><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;pano.texture.load&quot;</span><span class="hl-1">, (</span><span class="hl-6">event</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`Started loading pano </span><span class="hl-3">${</span><span class="hl-6">event</span><span class="hl-12">.</span><span class="hl-6">pano</span><span class="hl-12">.</span><span class="hl-6">panoIndex</span><span class="hl-3">}</span><span class="hl-9">`</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">on</span><span class="hl-1">(</span><span class="hl-9">&quot;pano.texture.success&quot;</span><span class="hl-1">, (</span><span class="hl-6">event</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`Finished loading pano </span><span class="hl-3">${</span><span class="hl-6">event</span><span class="hl-12">.</span><span class="hl-6">pano</span><span class="hl-12">.</span><span class="hl-6">panoIndex</span><span class="hl-3">}</span><span class="hl-9">`</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">on</span><span class="hl-1">(</span><span class="hl-9">&quot;pano.texture.error&quot;</span><span class="hl-1">, (</span><span class="hl-6">event</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">error</span><span class="hl-1">(</span><span class="hl-9">`Failed to load pano </span><span class="hl-3">${</span><span class="hl-6">event</span><span class="hl-12">.</span><span class="hl-6">pano</span><span class="hl-12">.</span><span class="hl-6">panoIndex</span><span class="hl-3">}</span><span class="hl-9">`</span><span class="hl-1">, </span><span class="hl-6">event</span><span class="hl-1">.</span><span class="hl-6">error</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><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;pano.texture.load&quot;</span><span class="hl-1">, (</span><span class="hl-5">event</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">`Started loading pano </span><span class="hl-8">${</span><span class="hl-5">event</span><span class="hl-12">.</span><span class="hl-5">pano</span><span class="hl-12">.</span><span class="hl-5">panoIndex</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><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;pano.texture.success&quot;</span><span class="hl-1">, (</span><span class="hl-5">event</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">`Finished loading pano </span><span class="hl-8">${</span><span class="hl-5">event</span><span class="hl-12">.</span><span class="hl-5">pano</span><span class="hl-12">.</span><span class="hl-5">panoIndex</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><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;pano.texture.error&quot;</span><span class="hl-1">, (</span><span class="hl-5">event</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">error</span><span class="hl-1">(</span><span class="hl-10">`Failed to load pano </span><span class="hl-8">${</span><span class="hl-5">event</span><span class="hl-12">.</span><span class="hl-5">pano</span><span class="hl-12">.</span><span class="hl-5">panoIndex</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">, </span><span class="hl-5">event</span><span class="hl-1">.</span><span class="hl-5">error</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_material.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/model/parameter.d.ts">ParameterMaterialValue</a></p>
 </blockquote>
 <p>以下是 <code>ParameterMaterialValue</code> 的 TypeScript 定义摘要：</p>
-<pre><code class="typescript"><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">ParameterMaterialValue</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型整体透明度 [0, 1] */</span><br/><span class="hl-1">  </span><span class="hl-6">opacity</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">pointScale</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">/** 点云大小绘制方式 (&#39;ATTENUATION&#39; | &#39;FIXED&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-6">pointSize</span><span class="hl-1">: </span><span class="hl-7">PBMPointSize</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 楼层显示样式 (&#39;OPACITY&#39; | &#39;VISIBILITY&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-6">floorStyle</span><span class="hl-1">: </span><span class="hl-7">PBMFloorStyle</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 更多字段见下方配置表</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">ParameterMaterialValue</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型整体透明度 [0, 1] */</span><br/><span class="hl-1">  </span><span class="hl-5">opacity</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">pointScale</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">/** 点云大小绘制方式 (&#39;ATTENUATION&#39; | &#39;FIXED&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-5">pointSize</span><span class="hl-1">: </span><span class="hl-9">PBMPointSize</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 楼层显示样式 (&#39;OPACITY&#39; | &#39;VISIBILITY&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-5">floorStyle</span><span class="hl-1">: </span><span class="hl-9">PBMFloorStyle</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 更多字段见下方配置表</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>
@@ -321,11 +321,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="1-adjusting-model-transparency-and-style-调整模型透明度与样式" class="tsd-anchor-link">1. Adjusting Model Transparency and Style (调整模型透明度与样式)<a href="#1-adjusting-model-transparency-and-style-调整模型透明度与样式" 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;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">// 仅显示原始 UV 贴图</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;modelAlpha&#39;</span><span class="hl-1">, </span><span class="hl-11">0.0</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">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;floorStyle&#39;</span><span class="hl-1">, </span><span class="hl-9">&#39;wireframe&#39;</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;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">// 仅显示原始 UV 贴图</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;modelAlpha&#39;</span><span class="hl-1">, </span><span class="hl-3">0.0</span><span class="hl-1">);</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">set</span><span class="hl-1">(</span><span class="hl-10">&#39;floorStyle&#39;</span><span class="hl-1">, </span><span class="hl-10">&#39;wireframe&#39;</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-configuring-point-cloud-appearance-配置点云外观" class="tsd-anchor-link">2. Configuring Point Cloud Appearance (配置点云外观)<a href="#2-configuring-point-cloud-appearance-配置点云外观" 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;pointSize&#39;</span><span class="hl-1">, </span><span class="hl-9">&#39;ATTENUATION&#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">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;pointScale&#39;</span><span class="hl-1">, </span><span class="hl-11">0.05</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">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;pointMaxPixel&#39;</span><span class="hl-1">, </span><span class="hl-11">20</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;pointSize&#39;</span><span class="hl-1">, </span><span class="hl-10">&#39;ATTENUATION&#39;</span><span class="hl-1">);</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">set</span><span class="hl-1">(</span><span class="hl-10">&#39;pointScale&#39;</span><span class="hl-1">, </span><span class="hl-3">0.05</span><span class="hl-1">);</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">set</span><span class="hl-1">(</span><span class="hl-10">&#39;pointMaxPixel&#39;</span><span class="hl-1">, </span><span class="hl-3">20</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>