@realsee/five 6.8.0-alpha.21 → 6.8.0-alpha.23

package/docs/documents/release_notes_6.8.html

@@ -28,7 +28,7 @@
 </code><button type="button">Copy</button></pre>
 
 <h3 id="配置球谐光照阶数-sh-degree" class="tsd-anchor-link">配置球谐光照阶数 (SH Degree)<a href="#配置球谐光照阶数-sh-degree" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>可以通过 five.parameter.gSHDegree 设置球谐光照阶数，支持 0, 1, 2 阶，默认为 0 阶。</p>
+<p>可以通过 <code>five.parameter.gaussianSplattingSHDegree</code> 设置球谐光照阶数，支持 0, 1, 2 阶，默认为 0 阶。</p>
 <pre><code><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1">    </span><span class="hl-6">parameters:</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-6">gaussianSplattingSHDegree:</span><span class="hl-1"> </span><span class="hl-11">1</span><span class="hl-1"> </span><span class="hl-8">// 设置为 1 阶 SH</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">});</span>
 </code><button>Copy</button></pre>
 
@@ -85,7 +85,10 @@
 正确解析 KHR_materials_unlit。是否感光作用到对应的 material 上，而不是 gltf 中的所有元素。</p>
 </blockquote>
 <h3 id="动画优化" class="tsd-anchor-link">动画优化<a href="#动画优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>处理额外动画骨骼未绑定导致的错误, 出现的抖动。</p>
+<ul>
+<li>处理额外动画骨骼未绑定导致的错误，出现的抖动。</li>
+<li>修复 glTF 骨骼 weight 为整型时，导致 boneTransform 计算出错进而引发射线检测错误的问题。gltf parser 在加载非 float 数据时，现已自动转换为 float 使用。</li>
+</ul>
 <h2 id="模型-viewlayer-加载策略优化" class="tsd-anchor-link">模型 ViewLayer 加载策略优化<a href="#模型-viewlayer-加载策略优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <blockquote>
 <p>优化了 ViewLayer 的加载和显隐逻辑，以减少内存占用并提高性能。</p>
@@ -110,7 +113,7 @@
 <li>射线交点 Intersection 对象新增了 tile, model, viewLayer 字段，便于在射线检测时获取更详细的上下文信息。</li>
 <li>raycaster.hitFilter 回调函数的参数类型定义已更新，包含 model, viewLayer, tile 等上下文信息。</li>
 </ul>
-<h2 id="work-增强" class="tsd-anchor-link">Work 增强<a href="#work-增强" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<h2 id="work-结构改变" class="tsd-anchor-link">Work 结构改变<a href="#work-结构改变" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="observer-支持-uv-计算工具函数" class="tsd-anchor-link">Observer 支持 uv 计算工具函数<a href="#observer-支持-uv-计算工具函数" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>为 WorkObserver 提供了更多实用的工具函数，便于进行坐标和 UV 转换。
 UV 转换工具函数</p>
@@ -120,6 +123,10 @@ UV 转换工具函数</p>
 <li>observer.vectorToCubemapUv: 将方向向量转化为立方体贴图 uv。</li>
 <li>observer.cubemapUvToVector: 将立方体贴图 uv 转化为方向向量。</li>
 </ul>
+<h3 id="fivepanoid" class="tsd-anchor-link">five.panoId<a href="#fivepanoid" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>新增 <code>five.panoId</code> 属性，使其与 <code>work.observer</code> 保持一致。</p>
+<h3 id="derived_id-类型变更" class="tsd-anchor-link">derived_id 类型变更<a href="#derived_id-类型变更" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>derived_id 的类型从 <code>number</code> 改为 <code>number | string</code>。</p>
 <h2 id="全景图滤镜" class="tsd-anchor-link">全景图滤镜<a href="#全景图滤镜" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>新增了全景图滤镜功能，支持实时调整全景图的亮度、对比度、饱和度、色温和色调等参数。</p>
 <p>通过 <code>five.modelScene.parameter.set('panoFilter', filter)</code> 绑定。
@@ -177,8 +184,12 @@ UV 转换工具函数</p>
 <li>优化 mapview 下滚动缩放。避免滚落所发有时会退回的问题。</li>
 <li>优化 floorplan 从下向上看时的交互的屏幕上下滑动反人类下意识的问题。</li>
 <li>优化 camera.autoNearFar 的计算结果。优化对于小物品的 near 过远以及 出现 z-fighting 的问题。</li>
-<li>添加了 gesture.create 事件，发生在所有事件创建时。</li>
+<li>添加了 gesture.fire 事件，发生在任意事件被触发。</li>
 <li>gestureEvent.center gestureEvent.pointers 中加入了 buttons button shiftKey ctrlKey metaKey altKey 字段。</li>
+<li>修复 gesture.momentum 前没有触发 gesture.create 的问题。</li>
+<li>修复 gesture.pan 中 preventDefault 无法阻止触发 gesture.momentum 的问题。</li>
+<li>修复 gesture.pan 中第一次并没有 event.isFirst = true 的问题。</li>
+<li>添加自定义着色器 mainPanoColor 插入点，可以修改 pano0Color、pano1Color。</li>
 </ol>
 <h2 id="内部机制改动" class="tsd-anchor-link">内部机制改动<a href="#内部机制改动" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <ol>
@@ -186,4 +197,4 @@ UV 转换工具函数</p>
 <li>应用 animation pointer 以及 动画优化的原因。目前会重写 hack THREE.PropertyBinding.findNode。</li>
 <li>打包不再合并 .d.ts 文件。便于文档可以更便于找到对应的类型声明。</li>
 </ol>
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#release-note-68x"><span>Release <wbr/>Note 6.8.x</span></a><ul><li><a href="#gaussian-splatting-3dgs-支持"><span>Gaussian <wbr/>Splatting (3<wbr/>DGS) 支持</span></a></li><li><ul><li><a href="#文件格式支持"><span>文件格式支持</span></a></li><li><a href="#支持-3d-tile"><span>支持 3d-<wbr/>tile</span></a></li><li><a href="#通过-work-加载"><span>通过 <wbr/>Work 加载</span></a></li><li><a href="#配置球谐光照阶数-sh-degree"><span>配置球谐光照阶数 (<wbr/>SH <wbr/>Degree)</span></a></li><li><a href="#模型的射线检测"><span>模型的射线检测</span></a></li></ul></li><li><a href="#gltf-模型支持增强"><span>gl<wbr/>TF 模型支持增强</span></a></li><li><ul><li><a href="#扩展新增及优化"><span>扩展新增及优化</span></a></li><li><ul><li><a href="#khr_animation_pointer"><span>KHR_<wbr/>animation_<wbr/>pointer</span></a></li><li><a href="#khr_node_visibility"><span>KHR_<wbr/>node_<wbr/>visibility</span></a></li><li><a href="#khr_materials_clearcoat"><span>KHR_<wbr/>materials_<wbr/>clearcoat</span></a></li><li><a href="#khr_materials_transmission"><span>KHR_<wbr/>materials_<wbr/>transmission</span></a></li><li><a href="#khr_materials_emissive_strength"><span>KHR_<wbr/>materials_<wbr/>emissive_<wbr/>strength</span></a></li><li><a href="#khr_materials_unlit"><span>KHR_<wbr/>materials_<wbr/>unlit</span></a></li></ul></li><li><a href="#动画优化"><span>动画优化</span></a></li></ul></li><li><a href="#模型-viewlayer-加载策略优化"><span>模型 <wbr/>View<wbr/>Layer 加载策略优化</span></a></li><li><ul><li><ul><li><a href="#默认加载策略变更"><span>默认加载策略变更</span></a></li><li><a href="#显隐与内存管理"><span>显隐与内存管理</span></a></li><li><a href="#加载进度"><span>加载进度</span></a></li><li><a href="#射线检测增强"><span>射线检测增强</span></a></li></ul></li></ul></li><li><a href="#work-增强"><span>Work 增强</span></a></li><li><ul><li><a href="#observer-支持-uv-计算工具函数"><span>Observer 支持 uv 计算工具函数</span></a></li></ul></li><li><a href="#全景图滤镜"><span>全景图滤镜</span></a></li><li><a href="#新增后处理效果-post-processing-passes"><span>新增后处理效果 (<wbr/>Post-<wbr/>Processing <wbr/>Passes)</span></a></li><li><a href="#工具优化"><span>工具优化</span></a></li><li><ul><li><a href="#work-viewer"><span>Work <wbr/>Viewer</span></a></li><li><a href="#model-viewer"><span>Model <wbr/>Viewer</span></a></li><li><a href="#gltf-viewer"><span>gl<wbr/>TF <wbr/>Viewer</span></a></li></ul></li><li><a href="#友好文档"><span>友好文档</span></a></li><li><a href="#其他"><span>其他</span></a></li><li><a href="#内部机制改动"><span>内部机制改动</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#release-note-68x"><span>Release <wbr/>Note 6.8.x</span></a><ul><li><a href="#gaussian-splatting-3dgs-支持"><span>Gaussian <wbr/>Splatting (3<wbr/>DGS) 支持</span></a></li><li><ul><li><a href="#文件格式支持"><span>文件格式支持</span></a></li><li><a href="#支持-3d-tile"><span>支持 3d-<wbr/>tile</span></a></li><li><a href="#通过-work-加载"><span>通过 <wbr/>Work 加载</span></a></li><li><a href="#配置球谐光照阶数-sh-degree"><span>配置球谐光照阶数 (<wbr/>SH <wbr/>Degree)</span></a></li><li><a href="#模型的射线检测"><span>模型的射线检测</span></a></li></ul></li><li><a href="#gltf-模型支持增强"><span>gl<wbr/>TF 模型支持增强</span></a></li><li><ul><li><a href="#扩展新增及优化"><span>扩展新增及优化</span></a></li><li><ul><li><a href="#khr_animation_pointer"><span>KHR_<wbr/>animation_<wbr/>pointer</span></a></li><li><a href="#khr_node_visibility"><span>KHR_<wbr/>node_<wbr/>visibility</span></a></li><li><a href="#khr_materials_clearcoat"><span>KHR_<wbr/>materials_<wbr/>clearcoat</span></a></li><li><a href="#khr_materials_transmission"><span>KHR_<wbr/>materials_<wbr/>transmission</span></a></li><li><a href="#khr_materials_emissive_strength"><span>KHR_<wbr/>materials_<wbr/>emissive_<wbr/>strength</span></a></li><li><a href="#khr_materials_unlit"><span>KHR_<wbr/>materials_<wbr/>unlit</span></a></li></ul></li><li><a href="#动画优化"><span>动画优化</span></a></li></ul></li><li><a href="#模型-viewlayer-加载策略优化"><span>模型 <wbr/>View<wbr/>Layer 加载策略优化</span></a></li><li><ul><li><ul><li><a href="#默认加载策略变更"><span>默认加载策略变更</span></a></li><li><a href="#显隐与内存管理"><span>显隐与内存管理</span></a></li><li><a href="#加载进度"><span>加载进度</span></a></li><li><a href="#射线检测增强"><span>射线检测增强</span></a></li></ul></li></ul></li><li><a href="#work-结构改变"><span>Work 结构改变</span></a></li><li><ul><li><a href="#observer-支持-uv-计算工具函数"><span>Observer 支持 uv 计算工具函数</span></a></li><li><a href="#fivepanoid"><span>five.pano<wbr/>Id</span></a></li><li><a href="#derived_id-类型变更"><span>derived_<wbr/>id 类型变更</span></a></li></ul></li><li><a href="#全景图滤镜"><span>全景图滤镜</span></a></li><li><a href="#新增后处理效果-post-processing-passes"><span>新增后处理效果 (<wbr/>Post-<wbr/>Processing <wbr/>Passes)</span></a></li><li><a href="#工具优化"><span>工具优化</span></a></li><li><ul><li><a href="#work-viewer"><span>Work <wbr/>Viewer</span></a></li><li><a href="#model-viewer"><span>Model <wbr/>Viewer</span></a></li><li><a href="#gltf-viewer"><span>gl<wbr/>TF <wbr/>Viewer</span></a></li></ul></li><li><a href="#友好文档"><span>友好文档</span></a></li><li><a href="#其他"><span>其他</span></a></li><li><a href="#内部机制改动"><span>内部机制改动</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/docs/functions/five.parseWork.html

@@ -4,4 +4,4 @@
 </div></li></ul></div><h4 class="tsd-returns-title">Returns <a href="../classes/five.Work.html" class="tsd-signature-type tsd-kind-class">Work</a></h4><ul>
 <li>签署过的 Work 数据结构</li>
 </ul>
-<aside class="tsd-sources"><ul><li>Defined in lib/five/work/work.ts:389</li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+<aside class="tsd-sources"><ul><li>Defined in lib/five/work/work.ts:353</li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>