@realsee/five 6.8.0-alpha.6 → 6.8.0-alpha.7

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 (90) hide show
  1. package/ai_guides/features/load-external-model.md +15 -0
  2. package/ai_guides/features/work.md +17 -0
  3. package/ai_guides/release_notes/6.8.md +11 -1
  4. package/docs/assets/hierarchy.js +1 -1
  5. package/docs/assets/search.js +1 -1
  6. package/docs/classes/five.AdaptiveLuminancePass.html +1 -1
  7. package/docs/classes/five.EyeDomeLightingPass.html +1 -1
  8. package/docs/classes/five.FivePass.html +1 -1
  9. package/docs/classes/five.Work.html +16 -16
  10. package/docs/classes/five.WorkResolvedObserver.html +27 -2
  11. package/docs/classes/gltf-loader.DDSLoader.html +1 -1
  12. package/docs/classes/gltf-loader.DRACOLoader.html +1 -1
  13. package/docs/classes/gltf-loader.GLTFObject.html +1 -1
  14. package/docs/classes/gltf-loader.THREEGLTFLoader.html +1 -1
  15. package/docs/classes/line.LineGeometry.html +1 -1
  16. package/docs/classes/line.LineMaterial.html +1 -1
  17. package/docs/classes/line.LineSegmentsGeometry.html +1 -1
  18. package/docs/classes/line.THREE_Line2.html +1 -1
  19. package/docs/classes/line.THREE_LineSegments2.html +1 -1
  20. package/docs/classes/plugins.RoundedBoxGeometry.html +1 -1
  21. package/docs/classes/vfx.Airflow.html +1 -1
  22. package/docs/classes/vfx.Flame.html +1 -1
  23. package/docs/classes/vfx.Particle.html +1 -1
  24. package/docs/classes/vfx.ParticleGPU.html +1 -1
  25. package/docs/classes/vfx.SpotLight.html +1 -1
  26. package/docs/documents/features_load-external-model.html +18 -1
  27. package/docs/documents/features_work.html +1 -1
  28. package/docs/documents/release_notes_6.8.html +14 -2
  29. package/docs/functions/five.parseWork.html +1 -1
  30. package/docs/functions/vue.useFiveWorks.html +2 -2
  31. package/docs/hierarchy.html +1 -1
  32. package/docs/interfaces/five.LooseWorkWithExtrinsics.html +6 -6
  33. package/docs/interfaces/five.WorkModel.html +8 -8
  34. package/docs/interfaces/five.WorkModelLayer.html +6 -6
  35. package/docs/interfaces/five.WorkObserver.html +27 -2
  36. package/docs/interfaces/five.WorkTile.html +1 -1
  37. package/docs/interfaces/plugins.BackgroundPluginController.html +1 -1
  38. package/docs/interfaces/plugins.BackgroundPluginType.EventMap.html +1 -1
  39. package/docs/interfaces/plugins.DynamicPathLinePluginController.html +1 -1
  40. package/docs/interfaces/plugins.DynamicPathLinePluginType.EventMap.html +1 -1
  41. package/docs/interfaces/plugins.DynamicPathLinePluginType.State.html +1 -1
  42. package/docs/interfaces/plugins.ItemMaskController.html +1 -1
  43. package/docs/interfaces/plugins.ItemMaskPluginType.EventMap.html +1 -1
  44. package/docs/interfaces/plugins.ItemMaskPluginType.State.html +1 -1
  45. package/docs/interfaces/plugins.OrientationPluginController.html +1 -1
  46. package/docs/interfaces/plugins.OrientationPluginType.EventMap.html +1 -1
  47. package/docs/interfaces/plugins.OrientationPluginType.State.html +1 -1
  48. package/docs/interfaces/plugins.PanoAnimeController.html +1 -1
  49. package/docs/interfaces/plugins.PanoAnimePluginType.EventMap.html +1 -1
  50. package/docs/interfaces/plugins.PanoAnimePluginType.State.html +1 -1
  51. package/docs/interfaces/plugins.PluginTemplateType.EventMap.html +1 -1
  52. package/docs/interfaces/plugins.PluginTemplateType.State.html +1 -1
  53. package/docs/interfaces/plugins.TrajectoryController.html +1 -1
  54. package/docs/interfaces/react.FiveInjectionTypes.html +1 -1
  55. package/docs/types/five.ParseOptions.html +6 -6
  56. package/five/index.js +32 -32
  57. package/five/index.mjs +1661 -1314
  58. package/five/model/loaders/glTF-helpers/extensions/KHR_animation_pointer.d.ts +6 -0
  59. package/five/model/loaders/glTF-helpers/extensions/KHR_node_visibility.d.ts +6 -0
  60. package/five/model/loaders/glTF-helpers/index.d.ts +4 -0
  61. package/five/work/work.d.ts +35 -2
  62. package/five/work/workObserverUtils.d.ts +36 -0
  63. package/gltf-loader/index.js +3 -3
  64. package/gltf-loader/index.mjs +3 -3
  65. package/line/index.js +3 -3
  66. package/line/index.mjs +3 -3
  67. package/package.json +1 -1
  68. package/plugins/index.js +2 -2
  69. package/plugins/index.mjs +2 -2
  70. package/react/index.js +2 -2
  71. package/react/index.mjs +2 -2
  72. package/shader-lib/index.js +2 -2
  73. package/shader-lib/index.mjs +2 -2
  74. package/sticker/index.js +3 -3
  75. package/sticker/index.mjs +3 -3
  76. package/umd/five-gltf-loader.js +3 -3
  77. package/umd/five-line.js +3 -3
  78. package/umd/five-plugins.js +2 -2
  79. package/umd/five-react.js +2 -2
  80. package/umd/five-shader-lib.js +2 -2
  81. package/umd/five-sticker.js +3 -3
  82. package/umd/five-vfx.js +2 -2
  83. package/umd/five-vue.js +2 -2
  84. package/umd/five.js +32 -32
  85. package/vfx/index.js +2 -2
  86. package/vfx/index.mjs +2 -2
  87. package/vue/index.js +2 -2
  88. package/vue/index.mjs +2 -2
  89. package/work-downloader/index.js +2 -2
  90. package/work-downloader/index.mjs +2 -2
package/ai_guides/features/load-external-model.md CHANGED
@@ -61,6 +61,21 @@ Five 使用 **Z-up** (Z 轴向上) 的右手坐标系。
61
61
 
62
62
  ### loadGltf
63
63
  加载 `.gltf` 或 `.glb` 文件。支持 Draco 压缩。
64
+ 支持扩展：
65
+ * `KHR_binary_glTF`
66
+ * `KHR_draco_mesh_compression`
67
+ * `KHR_texture_basisu`
68
+ * `KHR_texture_transform`
69
+ * `KHR_mesh_quantization`
70
+ * `KHR_materials_unlit`
71
+ * `KHR_node_visibility`
72
+ * `KHR_animation_pointer`
73
+ * `EXT_meshopt_compression`
74
+ * `EXT_texture_webp`
75
+ * `CESIUM_RTC`
76
+ * `REALSEE_materials_lightmap`
77
+ * `PBM_mesh`
78
+ * `KHR_gaussian_splatting_compression_spz`
64
79
 
65
80
  | 参数 | 类型 | 默认值 | 说明 |
66
81
  | --- | --- | --- | --- |
package/ai_guides/features/work.md CHANGED
@@ -15,6 +15,8 @@
15
15
  import * as THREE from "three";
16
16
  import type { Mode } from "@realsee/five";
17
17
 
18
+ type CubeFace = 'up' | 'down' | 'left' | 'right' | 'front' | 'back';
19
+
18
20
  /** Work 实体：VR 项目的根对象 */
19
21
  export interface Work {
20
22
  /** 唯一标识 (Work ID) */
@@ -74,6 +76,21 @@ export interface WorkObserver {
74
76
 
75
77
  /** 点位全景图资源信息 */
76
78
  images: WorkImage;
79
+
80
+ /** 获取点位的全局坐标 */
81
+ getWorldPosition(this: WorkObserver): THREE.Vector3;
82
+
83
+ /** 获取点位的全局地面坐标 */
84
+ getWorldStandingPosition(this: WorkObserver): THREE.Vector3;
85
+
86
+ /** 将方向向量转化为全景图 uv */
87
+ vectorToEquirectangularUv(vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector2;
88
+ /** 将全景图 uv 转化为方向向量 */
89
+ equirectangularUvToVector(uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
90
+ /** 将方向向量转化为获六视图 uv */
91
+ vectorToCubemapUv(vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): [cubeFace: CubeFace, cubemapUv: THREE.Vector2];
92
+ /** 将六视图 uv 转化为方向向量 */
93
+ cubemapUvToVector(cubeFace: CubeFace, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
77
94
  }
78
95
 
79
96
  /** 初始化位姿参数 */
package/ai_guides/release_notes/6.8.md CHANGED
@@ -57,7 +57,7 @@ const five = new Five({
57
57
 
58
58
  * 文档目录迁移至 `ai_guides/`，并在 `package.json` 中新增 `ai` 字段指向该目录。
59
59
  * 文档内容包含源码链接 (`source` 字段)，直接指向对应的 `.ts` 定义文件。
60
- * 提供了更清晰的 API 定义和概念说明，例如新增了 [ViewLayer](../views/view-layer.md) 的详细文档。
60
+ * 提供了更清晰的 API 定义和概念说明，例如新增了 [ViewLayer](../features/view-layer.md) 的详细文档。
61
61
 
62
62
  ## 新增后处理效果 (Post-Processing Passes)
63
63
  > 新增了三个可选的内置后处理 Pass，用于增强视觉效果。
@@ -69,3 +69,13 @@ const five = new Five({
69
69
  ## 其他优化
70
70
  * **点云渲染**: 计算点位透明度时，现在会排除不活跃的点，提升渲染正确性。
71
71
  * **TypeScript 支持**: 优化了 `.d.ts` 打包方式，声明文件现在与源码文件一一对应，提升了 IDE 的跳转体验。
72
+
73
+ ## glTF 支持**: 新增 `KHR_animation_pointer` 和 `KHR_node_visibility` 扩展支持
74
+ * `KHR_animation_pointer` 扩展 允许动画通道指向 glTF 资产中任何对象的任何属性，而不仅仅是节点的平移、旋转和缩放。
75
+ * `KHR_node_visibility` 扩展 允许设置节点的可见性属性。
76
+
77
+ ## work 提供 uv 转化函数。
78
+ * `vectorToEquirectangularUv` 方法将方向向量转化为全景图 uv。
79
+ * `equirectangularUvToVector` 方法将全景图 uv 转化为方向向量。
80
+ * `vectorToCubemapUv` 方法将方向向量转化为立方体贴图 uv。
81
+ * `cubemapUvToVector` 方法将立方体贴图 uv 转化为方向向量。
package/docs/assets/hierarchy.js CHANGED
@@ -1 +1 @@
1
- window.hierarchyData = "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"
1
+ window.hierarchyData = "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"