@realsee/five 6.8.0-alpha.9 → 6.8.1

package/docs/documents/api.html

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

package/docs/documents/features_3dtile.html

@@ -210,7 +210,7 @@
 <li><a href="features_work.html">Work</a>: 了解 Work 数据结构。</li>
 </ul>
 <hr>
-<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">3dtile</span><span class="hl-1">, </span><span class="hl-2">viewLayer</span><span class="hl-1">, </span><span class="hl-2">performance</span><span class="hl-1">, </span><span class="hl-2">lod</span><span class="hl-1">, </span><span class="hl-2">optimization</span><span class="hl-1">]</span>
+<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">大场景</span><span class="hl-1">, </span><span class="hl-2">瓦片</span><span class="hl-1">, </span><span class="hl-2">显存</span><span class="hl-1">, </span><span class="hl-2">画质</span><span class="hl-1">, </span><span class="hl-2">性能优化</span><span class="hl-1">, </span><span class="hl-2">流式加载</span><span class="hl-1">, </span><span class="hl-2">3dtile</span><span class="hl-1">, </span><span class="hl-2">viewLayer</span><span class="hl-1">, </span><span class="hl-2">performance</span><span class="hl-1">, </span><span class="hl-2">lod</span><span class="hl-1">, </span><span class="hl-2">optimization</span><span class="hl-1">, </span><span class="hl-2">tile-loading</span><span class="hl-1">, </span><span class="hl-2">memory</span><span class="hl-1">, </span><span class="hl-2">sse</span><span class="hl-1">, </span><span class="hl-2">screen-space-error</span><span class="hl-1">]</span>
 </code><button type="button">Copy</button></pre>
 
 </div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#3dtile-3d-瓦片"><span>3<wbr/>D<wbr/>Tile (3<wbr/>D 瓦片)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><a href="#concepts"><span>Concepts</span></a></li><li><ul><li><a href="#1-lod-screen-space-error-sse"><span>1. <wbr/>LOD &amp; <wbr/>Screen <wbr/>Space <wbr/>Error (<wbr/>SSE)</span></a></li><li><a href="#2-显存管理-cache-management"><span>2. 显存管理 (<wbr/>Cache <wbr/>Management)</span></a></li><li><a href="#3-viewlayer-与-3dtile"><span>3. <wbr/>View<wbr/>Layer 与 3<wbr/>D<wbr/>Tile</span></a></li></ul></li><li><a href="#configuration"><span>Configuration</span></a></li><li><ul><li><a href="#core-quality-performance-核心画质与性能"><span>Core <wbr/>Quality &amp; <wbr/>Performance (核心画质与性能)</span></a></li><li><a href="#geometric-error-control-几何误差控制"><span>Geometric <wbr/>Error <wbr/>Control (几何误差控制)</span></a></li><li><a href="#network-loading-网络与加载"><span>Network &amp; <wbr/>Loading (网络与加载)</span></a></li><li><a href="#legacy-lod-control-不推荐"><span>Legacy <wbr/>LOD <wbr/>Control (不推荐)</span></a></li></ul></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#1-adjusting-quality-memory-调整画质与内存平衡"><span>1. <wbr/>Adjusting <wbr/>Quality &amp; <wbr/>Memory (调整画质与内存平衡)</span></a></li><li><a href="#2-multi-viewlayer-optimization-多-viewlayer-优化"><span>2. <wbr/>Multi-<wbr/>View<wbr/>Layer <wbr/>Optimization (多 <wbr/>View<wbr/>Layer 优化)</span></a></li></ul></li><li><a href="#debugging"><span>Debugging</span></a></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/docs/documents/features_camera-animation.html

@@ -45,6 +45,20 @@
 <pre><code class="typescript"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">changeMode</span><span class="hl-1">(</span><span class="hl-6">mode</span><span class="hl-1">: </span><span class="hl-6">Mode</span><span class="hl-1">, </span><span class="hl-6">options</span><span class="hl-1">?, </span><span class="hl-6">animationOptions</span><span class="hl-1">?): </span><span class="hl-7">Promise</span><span class="hl-1">&lt;</span><span class="hl-3">void</span><span class="hl-1">&gt;</span>
 </code><button type="button">Copy</button></pre>
 
+<h3 id="4-updatecamera" class="tsd-anchor-link">4. updateCamera<a href="#4-updatecamera" 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>在不切换全景点位的情况下，将相机平滑动画到目标位姿。适用于&quot;定点环顾&quot;或&quot;聚焦某个方向&quot;等场景。</p>
+<pre><code class="typescript"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">updateCamera</span><span class="hl-1">(</span><span class="hl-6">pose</span><span class="hl-1">: </span><span class="hl-6">Partial</span><span class="hl-1">&lt;</span><span class="hl-6">Pose</span><span class="hl-1">&gt;, </span><span class="hl-6">duration</span><span class="hl-1">: </span><span class="hl-6">number</span><span class="hl-1">, </span><span class="hl-6">userAction</span><span class="hl-1">?: </span><span class="hl-6">boolean</span><span class="hl-1">): </span><span class="hl-7">Promise</span><span class="hl-1">&lt;</span><span class="hl-3">void</span><span class="hl-1">&gt;</span>
+</code><button type="button">Copy</button></pre>
+
+<ul>
+<li><code>pose</code>: 目标位姿 (longitude, latitude, fov, offset, distance 等)。</li>
+<li><code>duration</code>: 动画时长 (ms)。</li>
+<li><code>userAction</code>: 是否标记为用户触发。</li>
+<li><strong>返回</strong>: <code>Promise&lt;void&gt;</code>，动画完成时 resolve，被打断时 reject。</li>
+</ul>
+<blockquote>
+<p>与 <code>setState</code> 的区别：<code>updateCamera</code> 返回 Promise，可以精确等待动画结束；<code>setState</code> 是 fire-and-forget 风格。</p>
+</blockquote>
 <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>
 <h3 id="pose-位姿" class="tsd-anchor-link">Pose (位姿)<a href="#pose-位姿" 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>
@@ -149,9 +163,11 @@
 <li><a href="features_five.html">Five</a>: Five 核心类及 <code>setState</code> 方法。</li>
 <li><a href="features_mode.html">Mode</a>: 各种交互模式说明。</li>
 <li><a href="features_state.html">State</a>: 状态对象的完整定义。</li>
+<li><a href="features_move-pano-effect.html">Move Pano Effect</a>: 全景点位切换的过渡效果配置。</li>
+<li><a href="features_coordinate-system.html">Coordinate System</a>: 坐标系定义，理解 longitude/latitude 的含义。</li>
 </ul>
 <hr>
-<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">camera-animation</span><span class="hl-1">, </span><span class="hl-2">pose</span><span class="hl-1">, </span><span class="hl-2">state</span><span class="hl-1">]</span>
+<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">巡航</span><span class="hl-1">, </span><span class="hl-2">动画</span><span class="hl-1">, </span><span class="hl-2">旋转</span><span class="hl-1">, </span><span class="hl-2">缩放</span><span class="hl-1">, </span><span class="hl-2">运镜</span><span class="hl-1">, </span><span class="hl-2">导览</span><span class="hl-1">, </span><span class="hl-2">camera-animation</span><span class="hl-1">, </span><span class="hl-2">pose</span><span class="hl-1">, </span><span class="hl-2">state</span><span class="hl-1">, </span><span class="hl-2">auto-tour</span><span class="hl-1">, </span><span class="hl-2">fly-through</span><span class="hl-1">, </span><span class="hl-2">rotate</span><span class="hl-1">, </span><span class="hl-2">zoom</span><span class="hl-1">, </span><span class="hl-2">transition</span><span class="hl-1">]</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#相机动画-camera-animation"><span>相机动画 (<wbr/>Camera <wbr/>Animation)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><ul><li><a href="#movepanooptions"><span>Move<wbr/>Pano<wbr/>Options</span></a></li><li><a href="#movepanoeffect"><span>Move<wbr/>Pano<wbr/>Effect</span></a></li></ul></li><li><a href="#core-methods-核心方法"><span>Core <wbr/>Methods (核心方法)</span></a></li><li><ul><li><a href="#1-setstate"><span>1. set<wbr/>State</span></a></li><li><a href="#2-movetopano"><span>2. move<wbr/>To<wbr/>Pano</span></a></li><li><a href="#3-changemode"><span>3. change<wbr/>Mode</span></a></li></ul></li><li><a href="#concepts"><span>Concepts</span></a></li><li><ul><li><a href="#pose-位姿"><span>Pose (位姿)</span></a></li><li><a href="#animation-effects-动画效果"><span>Animation <wbr/>Effects (动画效果)</span></a></li></ul></li><li><a href="#configuration"><span>Configuration</span></a></li><li><ul><li><a href="#global-configuration-全局配置"><span>Global <wbr/>Configuration (全局配置)</span></a></li><li><a href="#movepanooptions-configuration-移动参数"><span>Move<wbr/>Pano<wbr/>Options <wbr/>Configuration (移动参数)</span></a></li></ul></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#1-旋转视角-rotate-camera"><span>1. 旋转视角 (<wbr/>Rotate <wbr/>Camera)</span></a></li><li><a href="#2-切换全景点-change-pano"><span>2. 切换全景点 (<wbr/>Change <wbr/>Pano)</span></a></li><li><a href="#3-模态切换-change-mode"><span>3. 模态切换 (<wbr/>Change <wbr/>Mode)</span></a></li><li><a href="#4-自动巡更-auto-tour"><span>4. 自动巡更 (<wbr/>Auto <wbr/>Tour)</span></a></li></ul></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#相机动画-camera-animation"><span>相机动画 (<wbr/>Camera <wbr/>Animation)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><ul><li><a href="#movepanooptions"><span>Move<wbr/>Pano<wbr/>Options</span></a></li><li><a href="#movepanoeffect"><span>Move<wbr/>Pano<wbr/>Effect</span></a></li></ul></li><li><a href="#core-methods-核心方法"><span>Core <wbr/>Methods (核心方法)</span></a></li><li><ul><li><a href="#1-setstate"><span>1. set<wbr/>State</span></a></li><li><a href="#2-movetopano"><span>2. move<wbr/>To<wbr/>Pano</span></a></li><li><a href="#3-changemode"><span>3. change<wbr/>Mode</span></a></li><li><a href="#4-updatecamera"><span>4. update<wbr/>Camera</span></a></li></ul></li><li><a href="#concepts"><span>Concepts</span></a></li><li><ul><li><a href="#pose-位姿"><span>Pose (位姿)</span></a></li><li><a href="#animation-effects-动画效果"><span>Animation <wbr/>Effects (动画效果)</span></a></li></ul></li><li><a href="#configuration"><span>Configuration</span></a></li><li><ul><li><a href="#global-configuration-全局配置"><span>Global <wbr/>Configuration (全局配置)</span></a></li><li><a href="#movepanooptions-configuration-移动参数"><span>Move<wbr/>Pano<wbr/>Options <wbr/>Configuration (移动参数)</span></a></li></ul></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#1-旋转视角-rotate-camera"><span>1. 旋转视角 (<wbr/>Rotate <wbr/>Camera)</span></a></li><li><a href="#2-切换全景点-change-pano"><span>2. 切换全景点 (<wbr/>Change <wbr/>Pano)</span></a></li><li><a href="#3-模态切换-change-mode"><span>3. 模态切换 (<wbr/>Change <wbr/>Mode)</span></a></li><li><a href="#4-自动巡更-auto-tour"><span>4. 自动巡更 (<wbr/>Auto <wbr/>Tour)</span></a></li></ul></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/docs/documents/features_clipper.html

@@ -71,10 +71,10 @@
 </ol>
 <h2 id="related" class="tsd-anchor-link">Related<a href="#related" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <ul>
-<li><a href="features_model.html">model.md</a>: 模型模块概览。</li>
+<li><a href="features_model.html">Model</a>: 模型模块概览。</li>
 </ul>
 <hr>
-<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">clipper</span><span class="hl-1">, </span><span class="hl-2">model</span><span class="hl-1">, </span><span class="hl-2">cut</span><span class="hl-1">, </span><span class="hl-2">discard</span><span class="hl-1">, </span><span class="hl-2">geometry</span><span class="hl-1">]</span>
+<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">裁切</span><span class="hl-1">, </span><span class="hl-2">剖面</span><span class="hl-1">, </span><span class="hl-2">隐藏部分模型</span><span class="hl-1">, </span><span class="hl-2">开盖</span><span class="hl-1">, </span><span class="hl-2">房屋剖面</span><span class="hl-1">, </span><span class="hl-2">clipper</span><span class="hl-1">, </span><span class="hl-2">model</span><span class="hl-1">, </span><span class="hl-2">cut</span><span class="hl-1">, </span><span class="hl-2">discard</span><span class="hl-1">, </span><span class="hl-2">geometry</span><span class="hl-1">, </span><span class="hl-2">clipping-box</span><span class="hl-1">, </span><span class="hl-2">section-view</span><span class="hl-1">]</span>
 </code><button type="button">Copy</button></pre>
 
 </div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#模型裁切-model-clipper"><span>模型裁切 (<wbr/>Model <wbr/>Clipper)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><a href="#concepts"><span>Concepts</span></a></li><li><ul><li><a href="#clipping-box-裁切盒"><span>Clipping <wbr/>Box (裁切盒)</span></a></li><li><a href="#matrix-transformation-矩阵变换"><span>Matrix <wbr/>Transformation (矩阵变换)</span></a></li></ul></li><li><a href="#configuration"><span>Configuration</span></a></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#基础用法-basic-usage"><span>基础用法 (<wbr/>Basic <wbr/>Usage)</span></a></li><li><a href="#动态更新-dynamic-update"><span>动态更新 (<wbr/>Dynamic <wbr/>Update)</span></a></li></ul></li><li><a href="#debugging"><span>Debugging</span></a></li><li><a href="#common-pitfalls"><span>Common <wbr/>Pitfalls</span></a></li><li><a href="#related"><span>Related</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>