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

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 (715) hide show
  1. package/AGENTS_READ_ME.md +4 -0
  2. package/AI_CONTEXT.md +4 -0
  3. package/README.md +9 -6
  4. package/{guides → ai_guides}/README.md +12 -2
  5. package/ai_guides/ai-doc-guidelines.md +102 -0
  6. package/{guides → ai_guides}/api.md +24 -1
  7. package/ai_guides/features/3dtile.md +172 -0
  8. package/{guides → ai_guides}/features/camera-animation.md +24 -3
  9. package/{guides → ai_guides}/features/clipper.md +2 -0
  10. package/{guides/features/coordnate-system.md → ai_guides/features/coordinate-system.md} +2 -0
  11. package/{guides → ai_guides}/features/event.md +2 -0
  12. package/{guides → ai_guides}/features/five.md +4 -0
  13. package/ai_guides/features/flowing-light-2d-pass.md +438 -0
  14. package/ai_guides/features/flowing-light-3d-pass.md +420 -0
  15. package/ai_guides/features/gaussian-blur-pass.md +202 -0
  16. package/{guides → ai_guides}/features/gesture.md +3 -0
  17. package/{guides → ai_guides}/features/get-screen-pixels.md +2 -0
  18. package/{guides → ai_guides}/features/image-options.md +3 -0
  19. package/{guides → ai_guides}/features/load-external-model.md +21 -0
  20. package/ai_guides/features/load-progress.md +140 -0
  21. package/ai_guides/features/material.md +153 -0
  22. package/{guides → ai_guides}/features/mode.md +4 -0
  23. package/{guides → ai_guides}/features/model.md +4 -1
  24. package/{guides → ai_guides}/features/move-pano-effect.md +2 -0
  25. package/{guides → ai_guides}/features/multi-work.md +2 -0
  26. package/ai_guides/features/pano-filter.md +148 -0
  27. package/{guides → ai_guides}/features/pano-tile.md +7 -14
  28. package/ai_guides/features/pano-uv.md +131 -0
  29. package/ai_guides/features/parameter.md +153 -0
  30. package/ai_guides/features/plugin.md +210 -0
  31. package/{guides → ai_guides}/features/postprocessing.md +39 -4
  32. package/{guides → ai_guides}/features/raycast.md +11 -0
  33. package/{guides → ai_guides}/features/request-proxy.md +2 -0
  34. package/{guides → ai_guides}/features/screen-project.md +2 -0
  35. package/{guides → ai_guides}/features/state.md +2 -0
  36. package/ai_guides/features/view-layer.md +187 -0
  37. package/{guides → ai_guides}/features/work.md +63 -2
  38. package/{guides → ai_guides}/glossary.md +26 -5
  39. package/{guides → ai_guides}/intro.md +1 -1
  40. package/{guides → ai_guides}/quick-start.md +1 -0
  41. package/ai_guides/release_notes/6.8.md +208 -0
  42. package/{guides → ai_guides}/template.md +17 -3
  43. package/docs/00_FOR_AI_AGENTS.md +11 -0
  44. package/docs/README.md +4 -7
  45. package/docs/assets/hierarchy.js +1 -1
  46. package/docs/assets/navigation.js +1 -1
  47. package/docs/assets/search.js +1 -1
  48. package/docs/classes/five.AdaptiveLuminancePass.html +7 -6
  49. package/docs/classes/five.BoundingMesh.html +2 -2
  50. package/docs/classes/five.Camera.html +1 -1
  51. package/docs/classes/five.EyeDomeLightingPass.html +1 -1
  52. package/docs/classes/five.Five.html +73 -72
  53. package/docs/classes/five.FivePass.html +1 -1
  54. package/docs/classes/five.Histogram.html +19 -0
  55. package/docs/classes/five.InternalWebGLRenderer.html +1 -1
  56. package/docs/classes/five.Model.html +31 -31
  57. package/docs/classes/five.ModelScene.html +1 -1
  58. package/docs/classes/five.NetworkSubscribe.html +1 -1
  59. package/docs/classes/five.PBMContainer.html +1 -1
  60. package/docs/classes/five.PBMCustomShader.html +42 -3
  61. package/docs/classes/five.PBMGSObject.html +5 -3
  62. package/docs/classes/five.PBMGroup.html +1 -1
  63. package/docs/classes/five.PBMMesh.html +1 -1
  64. package/docs/classes/five.PBMMeshMaterial.html +16 -7
  65. package/docs/classes/five.PBMPanoFilter.html +61 -0
  66. package/docs/classes/five.PBMPointCloud.html +1 -1
  67. package/docs/classes/five.PBMPointCloudMaterial.html +5 -6
  68. package/docs/classes/five.PBMSkinnedMesh.html +1 -1
  69. package/docs/classes/five.PBMUpdateable.html +41 -0
  70. package/docs/classes/five.PanoCircleMesh.html +1 -1
  71. package/docs/classes/five.PanoCircleMeshCustom.html +1 -1
  72. package/docs/classes/five.PanoCircleMeshSolid.html +1 -1
  73. package/docs/classes/five.Parameter.html +57 -53
  74. package/docs/classes/five.Scene.html +1 -1
  75. package/docs/classes/five.Subscribe.html +1 -1
  76. package/docs/classes/five.Tile.html +1 -1
  77. package/docs/classes/five.Tile3D.html +30 -26
  78. package/docs/classes/five.TileNode.html +1 -1
  79. package/docs/classes/five.Trajectory.html +1 -1
  80. package/docs/classes/five.TrajectoryNode.html +1 -1
  81. package/docs/classes/five.Work.html +16 -16
  82. package/docs/classes/five.WorkResolvedObserver.html +27 -2
  83. package/docs/classes/gltf-loader.DDSLoader.html +1 -1
  84. package/docs/classes/gltf-loader.DRACOLoader.html +1 -1
  85. package/docs/classes/gltf-loader.GLTFLoader.html +1 -1
  86. package/docs/classes/gltf-loader.GLTFObject.html +1 -1
  87. package/docs/classes/gltf-loader.GLTFParser.html +1 -1
  88. package/docs/classes/gltf-loader.THREEGLTFLoader.html +1 -1
  89. package/docs/classes/line.Line.html +1 -1
  90. package/docs/classes/line.LineGeometry.html +1 -1
  91. package/docs/classes/line.LineMaterial.html +1 -1
  92. package/docs/classes/line.LineSegmentsGeometry.html +1 -1
  93. package/docs/classes/line.THREE_Line2.html +1 -1
  94. package/docs/classes/line.THREE_LineSegments2.html +1 -1
  95. package/docs/classes/plugins.BasePlugin.Controller.html +1 -1
  96. package/docs/classes/plugins.RoundedBoxGeometry.html +1 -1
  97. package/docs/classes/sticker.Sticker.html +1 -1
  98. package/docs/classes/vfx.Airflow.html +1 -1
  99. package/docs/classes/vfx.Flame.html +1 -1
  100. package/docs/classes/vfx.Particle.html +1 -1
  101. package/docs/classes/vfx.ParticleGPU.html +1 -1
  102. package/docs/classes/vfx.SpotLight.html +1 -1
  103. package/docs/documents/README.html +11 -2
  104. package/docs/documents/ai-doc-guidelines.html +60 -15
  105. package/docs/documents/api.html +40 -15
  106. package/docs/documents/features_3dtile.html +142 -45
  107. package/docs/documents/features_camera-animation.html +62 -5
  108. package/docs/documents/features_clipper.html +3 -0
  109. package/docs/documents/{features_coordnate-system.html → features_coordinate-system.html} +4 -1
  110. package/docs/documents/features_event.html +3 -0
  111. package/docs/documents/features_five.html +4 -0
  112. package/docs/documents/features_flowing-light-2d-pass.html +356 -0
  113. package/docs/documents/features_flowing-light-3d-pass.html +351 -0
  114. package/docs/documents/features_gaussian-blur-pass.html +182 -0
  115. package/docs/documents/features_gesture.html +4 -0
  116. package/docs/documents/features_get-screen-pixels.html +3 -0
  117. package/docs/documents/features_image-options.html +3 -0
  118. package/docs/documents/features_load-external-model.html +25 -2
  119. package/docs/documents/features_load-progress.html +110 -0
  120. package/docs/documents/features_material.html +341 -0
  121. package/docs/documents/features_mode.html +5 -0
  122. package/docs/documents/features_model.html +5 -1
  123. package/docs/documents/features_move-pano-effect.html +3 -0
  124. package/docs/documents/features_multi-work.html +3 -0
  125. package/docs/documents/features_pano-filter.html +122 -0
  126. package/docs/documents/features_pano-tile.html +34 -19
  127. package/docs/documents/features_pano-uv.html +82 -0
  128. package/docs/documents/features_parameter.html +76 -56
  129. package/docs/documents/features_plugin.html +105 -0
  130. package/docs/documents/features_postprocessing.html +22 -5
  131. package/docs/documents/features_raycast.html +4 -1
  132. package/docs/documents/features_request-proxy.html +3 -0
  133. package/docs/documents/features_screen-project.html +3 -0
  134. package/docs/documents/features_state.html +3 -0
  135. package/docs/documents/features_view-layer.html +158 -0
  136. package/docs/documents/features_work.html +63 -2
  137. package/docs/documents/glossary.html +31 -6
  138. package/docs/documents/intro.html +1 -1
  139. package/docs/documents/quick-start.html +1 -0
  140. package/docs/documents/release_notes_6.8.html +189 -0
  141. package/docs/documents/template.html +45 -4
  142. package/docs/functions/five.loadAt3d.html +1 -1
  143. package/docs/functions/five.loadB3dm.html +1 -1
  144. package/docs/functions/five.loadDome.html +1 -1
  145. package/docs/functions/five.loadDomez.html +1 -1
  146. package/docs/functions/five.loadFbx.html +1 -1
  147. package/docs/functions/five.loadGltf.html +1 -1
  148. package/docs/functions/five.loadPbm.html +1 -1
  149. package/docs/functions/five.loadPly.html +1 -1
  150. package/docs/functions/five.loadPnts.html +1 -1
  151. package/docs/functions/five.loadSplat.html +1 -1
  152. package/docs/functions/five.loadSpz.html +1 -1
  153. package/docs/functions/five.loadX3p.html +1 -1
  154. package/docs/functions/five.parseWork.html +1 -1
  155. package/docs/functions/vue.useFiveWorks.html +2 -2
  156. package/docs/hierarchy.html +1 -1
  157. package/docs/index.html +11 -2
  158. package/docs/interfaces/five.AddableObject.html +1 -1
  159. package/docs/interfaces/five.AjaxOptions.html +1 -1
  160. package/docs/interfaces/five.BaseEvent.html +2 -2
  161. package/docs/interfaces/five.EventCallback.html +53 -47
  162. package/docs/interfaces/five.FloorplanControllerCustomInitArgs.html +9 -9
  163. package/docs/interfaces/five.GestureEvent.html +2 -2
  164. package/docs/interfaces/five.ImageOptions.html +1 -1
  165. package/docs/interfaces/five.IntersectEvent.html +2 -2
  166. package/docs/interfaces/five.IntersectMesh.html +1 -1
  167. package/docs/interfaces/five.IntersectMeshInterface.html +1 -1
  168. package/docs/interfaces/five.Intersection.html +4 -3
  169. package/docs/interfaces/five.LooseWorkWithExtrinsics.html +6 -6
  170. package/docs/interfaces/five.MapviewControllerCustomInitArgs.html +9 -9
  171. package/docs/interfaces/five.ModeChangeEvent.html +2 -2
  172. package/docs/interfaces/five.ModelControllerCustomInitArgs.html +1 -1
  173. package/docs/interfaces/five.ModelEvent.html +2 -2
  174. package/docs/interfaces/five.ModelSceneEvent.html +2 -2
  175. package/docs/interfaces/five.ModelTileEvent.html +8 -0
  176. package/docs/interfaces/five.MovePanoOptions.html +7 -7
  177. package/docs/interfaces/five.NetworkAbortError.html +1 -1
  178. package/docs/interfaces/five.NetworkFirbiddenError.html +1 -1
  179. package/docs/interfaces/five.NetworkOptions.html +1 -1
  180. package/docs/interfaces/five.NetworkProxyError.html +1 -1
  181. package/docs/interfaces/five.NetworkResourceEvent.html +2 -2
  182. package/docs/interfaces/five.NetworkResponseError.html +1 -1
  183. package/docs/interfaces/five.NetworkTimeoutError.html +1 -1
  184. package/docs/interfaces/five.ObjectEvent.html +2 -2
  185. package/docs/interfaces/five.PBMClipperParameter.html +2 -2
  186. package/docs/interfaces/five.PBMCustomShaderInitArgs.html +2 -2
  187. package/docs/interfaces/five.PBMCustomShaderSlots.html +2 -2
  188. package/docs/interfaces/five.PBMMaterial.html +1 -1
  189. package/docs/interfaces/five.PBMMeshMaterialParameters.html +5 -3
  190. package/docs/interfaces/five.PBMPanoDepth.html +5 -5
  191. package/docs/interfaces/five.PBMPanoFilterValue.html +6 -0
  192. package/docs/interfaces/five.PBMPanoPicture.html +8 -6
  193. package/docs/interfaces/five.PBMPointCloudMaterialParameters.html +2 -3
  194. package/docs/interfaces/five.PBMRefinedScreen.html +2 -2
  195. package/docs/interfaces/five.PanoCircleMeshInterface.html +1 -1
  196. package/docs/interfaces/five.PanoEvent.html +2 -2
  197. package/docs/interfaces/five.PanoTextureEvent.html +2 -2
  198. package/docs/interfaces/five.PanoramaControllerCustomInitArgs.html +1 -1
  199. package/docs/interfaces/five.PanoramaLikeControllerCustomInitArgs.html +1 -1
  200. package/docs/interfaces/five.ParameterMaterialValue.html +42 -38
  201. package/docs/interfaces/five.ParameterTilesetValue.html +15 -15
  202. package/docs/interfaces/five.ParameterValue.html +56 -52
  203. package/docs/interfaces/five.Pose.html +1 -1
  204. package/docs/interfaces/five.RenderEvent.html +2 -2
  205. package/docs/interfaces/five.ResolvedParameterValue.html +56 -52
  206. package/docs/interfaces/five.RgbaData.html +7 -0
  207. package/docs/interfaces/five.SplatData.html +2 -2
  208. package/docs/interfaces/five.State.html +1 -1
  209. package/docs/interfaces/five.StateEvent.html +2 -2
  210. package/docs/interfaces/five.TextureOptions.html +1 -1
  211. package/docs/interfaces/five.Tile3DOptions.html +2 -2
  212. package/docs/interfaces/five.TopviewControllerCustomInitArgs.html +7 -7
  213. package/docs/interfaces/five.VRPanoramaControllerCustomInitArgs.html +1 -1
  214. package/docs/interfaces/five.ViewLayer.html +30 -26
  215. package/docs/interfaces/five.WorkCubeImage.html +1 -1
  216. package/docs/interfaces/five.WorkImage.html +1 -1
  217. package/docs/interfaces/five.WorkModel.html +8 -8
  218. package/docs/interfaces/five.WorkModelLayer.html +6 -6
  219. package/docs/interfaces/five.WorkObserver.html +27 -2
  220. package/docs/interfaces/five.WorkTile.html +1 -1
  221. package/docs/interfaces/five.WorksEvent.html +2 -2
  222. package/docs/interfaces/five.XRControllerEvent.html +2 -2
  223. package/docs/interfaces/five.XRGestureEvent.html +2 -2
  224. package/docs/interfaces/five.XRPanoramaControllerCustomInitArgs.html +1 -1
  225. package/docs/interfaces/five.XRSessionEvent.html +2 -2
  226. package/docs/interfaces/plugins.BackgroundPluginController.html +1 -1
  227. package/docs/interfaces/plugins.BackgroundPluginType.EventMap.html +1 -1
  228. package/docs/interfaces/plugins.BasePlugin.State.html +1 -1
  229. package/docs/interfaces/plugins.DynamicPathLinePluginController.html +1 -1
  230. package/docs/interfaces/plugins.DynamicPathLinePluginType.EventMap.html +1 -1
  231. package/docs/interfaces/plugins.DynamicPathLinePluginType.State.html +1 -1
  232. package/docs/interfaces/plugins.ItemMaskController.html +1 -1
  233. package/docs/interfaces/plugins.ItemMaskPluginType.EventMap.html +1 -1
  234. package/docs/interfaces/plugins.ItemMaskPluginType.State.html +1 -1
  235. package/docs/interfaces/plugins.OrientationPluginController.html +1 -1
  236. package/docs/interfaces/plugins.OrientationPluginType.EventMap.html +1 -1
  237. package/docs/interfaces/plugins.OrientationPluginType.State.html +1 -1
  238. package/docs/interfaces/plugins.PanoAnimeController.html +1 -1
  239. package/docs/interfaces/plugins.PanoAnimePluginType.EventMap.html +1 -1
  240. package/docs/interfaces/plugins.PanoAnimePluginType.State.html +1 -1
  241. package/docs/interfaces/plugins.PluginTemplateType.EventMap.html +1 -1
  242. package/docs/interfaces/plugins.PluginTemplateType.State.html +1 -1
  243. package/docs/interfaces/plugins.TrajectoryController.html +1 -1
  244. package/docs/interfaces/react.FiveInjectionTypes.html +13 -13
  245. package/docs/modules/five.html +1 -1
  246. package/docs/modules.html +1 -1
  247. package/docs/types/five.ControllerEventTypes.html +27 -25
  248. package/docs/types/five.EasingFunction.html +1 -0
  249. package/docs/types/five.EventTypes.html +27 -25
  250. package/docs/types/five.FivePlugin.html +1 -1
  251. package/docs/types/five.FivePluginInit.html +1 -1
  252. package/docs/types/five.FivePluginInstance.html +1 -1
  253. package/docs/types/five.NetworkProgressCallback.html +1 -1
  254. package/docs/types/five.PBMAlphaMode.html +1 -1
  255. package/docs/types/five.PBMColorStyle.html +1 -1
  256. package/docs/types/five.PBMFloorStyle.html +1 -1
  257. package/docs/types/five.PBMMeshShaderType.html +1 -1
  258. package/docs/types/five.PBMPointBack.html +1 -1
  259. package/docs/types/five.PBMPointCloudShaderType.html +1 -1
  260. package/docs/types/five.PBMPointShape.html +1 -1
  261. package/docs/types/five.PBMPointSize.html +1 -1
  262. package/docs/types/five.PBMTransition.html +1 -1
  263. package/docs/types/five.ParseOptions.html +6 -6
  264. package/docs/types/plugins.BasePlugin.EventMap.html +1 -1
  265. package/docs/variables/five.PROXY_CONTROLLER_EVENT_NAMES.html +1 -1
  266. package/five/application/analysis.d.ts +40 -0
  267. package/five/application/controllers.d.ts +41 -0
  268. package/five/application/events-legacy.d.ts +454 -0
  269. package/five/application/events.d.ts +69 -0
  270. package/five/application/five.d.ts +519 -0
  271. package/five/application/fiveInitArgs.d.ts +176 -0
  272. package/five/application/fiveLoadOptions.d.ts +21 -0
  273. package/five/application/generateDefaultVideoElement.d.ts +2 -0
  274. package/five/application/getViewportScale.d.ts +2 -0
  275. package/five/application/initLights.d.ts +3 -0
  276. package/five/application/mode.d.ts +28 -0
  277. package/five/application/renderPoweredByRealsee.d.ts +3 -0
  278. package/five/assets/cardboard-png-data-url.d.ts +2 -0
  279. package/five/assets/gradient-png-data-url.d.ts +2 -0
  280. package/five/assets/loading-png-data-url.d.ts +2 -0
  281. package/five/assets/phone-png-data-url.d.ts +2 -0
  282. package/five/assets/realsee-png-data-url.d.ts +2 -0
  283. package/five/bvh/bvhMath.d.ts +33 -0
  284. package/five/bvh/bvhMesh.d.ts +7 -0
  285. package/five/bvh/bvhNode.d.ts +29 -0
  286. package/five/bvh/bvhObject.d.ts +18 -0
  287. package/five/bvh/bvhPoints.d.ts +6 -0
  288. package/five/bvh/index.d.ts +10 -0
  289. package/five/bvh/worker.d.ts +35 -0
  290. package/five/cardboard/helper.d.ts +2 -0
  291. package/five/cardboard/index.d.ts +13 -0
  292. package/five/cardboard/sensor.d.ts +158 -0
  293. package/five/certificates/hardware.d.ts +1 -0
  294. package/five/controllers/base.d.ts +167 -0
  295. package/five/controllers/events.d.ts +71 -0
  296. package/five/controllers/floorplan.d.ts +119 -0
  297. package/five/controllers/mapview.d.ts +139 -0
  298. package/five/controllers/model.d.ts +57 -0
  299. package/five/controllers/panorama.d.ts +143 -0
  300. package/five/controllers/panoramaLike.d.ts +87 -0
  301. package/five/controllers/topview.d.ts +42 -0
  302. package/five/controllers/vrPanorama.d.ts +56 -0
  303. package/five/controllers/xrPanorama.d.ts +81 -0
  304. package/five/core/camera.d.ts +65 -0
  305. package/five/core/internalWebGLRenderer.d.ts +14 -0
  306. package/five/core/panoVideo.d.ts +18 -0
  307. package/five/core/scene.d.ts +10 -0
  308. package/five/core/tiling.d.ts +43 -0
  309. package/five/declare.d.ts +2 -1
  310. package/five/gaussian-splatting/util/renderData.d.ts +52 -0
  311. package/five/gaussian-splatting/wasm/data.d.ts +20 -0
  312. package/five/gaussian-splatting/wasm/sort.d.ts +18 -0
  313. package/five/gaussian-splatting/worker/dataWorker.d.ts +1 -0
  314. package/five/gaussian-splatting/worker/sortWorker.d.ts +1 -0
  315. package/five/index.d.ts +60 -4637
  316. package/five/index.js +193 -341
  317. package/five/index.mjs +26455 -31011
  318. package/five/meshes/boundingMesh.d.ts +12 -0
  319. package/five/meshes/intersectMesh.d.ts +8 -0
  320. package/five/meshes/panoCircleMesh.d.ts +35 -0
  321. package/five/meshes/panoCircleMeshCustom.d.ts +40 -0
  322. package/five/meshes/panoCircleMeshSolid.d.ts +34 -0
  323. package/five/meshes/panoSphereMesh.d.ts +27 -0
  324. package/five/model/helpers/coordinate-transform.d.ts +3 -0
  325. package/five/model/helpers/ellipsoid-coordinates.d.ts +14 -0
  326. package/five/model/helpers/get-edges-by-sphere.d.ts +8 -0
  327. package/five/model/helpers/get-recommend-tile3d-parameters.d.ts +8 -0
  328. package/five/model/index.d.ts +70 -0
  329. package/five/model/intersection.d.ts +18 -0
  330. package/five/model/loaders/at3d.d.ts +12 -0
  331. package/five/model/loaders/b3dm.d.ts +9 -0
  332. package/five/model/loaders/dome.d.ts +22 -0
  333. package/five/model/loaders/domez.d.ts +11 -0
  334. package/five/model/loaders/fbx.d.ts +8 -0
  335. package/five/model/loaders/glTF-helpers/extensions/CESIUM_RTC.d.ts +9 -0
  336. package/five/model/loaders/glTF-helpers/extensions/EXT_meshopt_compression.d.ts +8 -0
  337. package/five/model/loaders/glTF-helpers/extensions/EXT_texture_webp.d.ts +11 -0
  338. package/five/model/loaders/glTF-helpers/extensions/KHR_animation_pointer.d.ts +6 -0
  339. package/five/model/loaders/glTF-helpers/extensions/KHR_binary_glTF.d.ts +25 -0
  340. package/five/model/loaders/glTF-helpers/extensions/KHR_draco_mesh_compression.d.ts +11 -0
  341. package/five/model/loaders/glTF-helpers/extensions/KHR_gaussian_splatting_compression_spz.d.ts +9 -0
  342. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_clearcoat.d.ts +10 -0
  343. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_emissive_strength.d.ts +10 -0
  344. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_sheen.d.ts +10 -0
  345. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_transmission.d.ts +10 -0
  346. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_unlit.d.ts +10 -0
  347. package/five/model/loaders/glTF-helpers/extensions/KHR_mesh_quantization.d.ts +6 -0
  348. package/five/model/loaders/glTF-helpers/extensions/KHR_node_visibility.d.ts +10 -0
  349. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_basisu.d.ts +9 -0
  350. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_transform.d.ts +10 -0
  351. package/five/model/loaders/glTF-helpers/extensions/REALSEE_materials_lightmap.d.ts +7 -0
  352. package/five/model/loaders/glTF-helpers/extensions/base.d.ts +24 -0
  353. package/five/model/loaders/glTF-helpers/glTF.d.ts +713 -0
  354. package/five/model/loaders/glTF-helpers/index.d.ts +47 -0
  355. package/five/model/loaders/glTF-helpers/parser.d.ts +114 -0
  356. package/five/model/loaders/glTF-helpers/type.d.ts +14 -0
  357. package/five/model/loaders/gltf.d.ts +10 -0
  358. package/five/model/loaders/obj.d.ts +9 -0
  359. package/five/model/loaders/pbm.d.ts +26 -0
  360. package/five/model/loaders/ply.d.ts +24 -0
  361. package/five/model/loaders/pnts.d.ts +8 -0
  362. package/five/model/loaders/protobuf/dome.d.ts +540 -0
  363. package/five/model/loaders/protobuf/pbm.d.ts +203 -0
  364. package/five/model/loaders/shared.d.ts +16 -0
  365. package/five/model/loaders/splat.d.ts +8 -0
  366. package/five/model/loaders/spz.d.ts +14 -0
  367. package/five/model/loaders/tile3d-helpers/feature-table.d.ts +15 -0
  368. package/five/model/loaders/tile3d-helpers/gl-type.d.ts +20 -0
  369. package/five/model/loaders/tile3d-helpers/parse-gltf-array-buffer.d.ts +2 -0
  370. package/five/model/loaders/tile3d-helpers/parse-header.d.ts +2 -0
  371. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.d.ts +2 -0
  372. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.worker.d.ts +6 -0
  373. package/five/model/loaders/tile3d-helpers/parse-table.d.ts +3 -0
  374. package/five/model/loaders/tile3d-helpers/tile3d-type.d.ts +35 -0
  375. package/five/model/loaders/x3p.d.ts +22 -0
  376. package/five/model/materials/pbmMaterial.d.ts +137 -0
  377. package/five/model/materials/pbmMeshMaterial.d.ts +126 -0
  378. package/five/model/materials/pbmPointCloudMaterial.d.ts +70 -0
  379. package/five/model/model-scene.d.ts +172 -0
  380. package/five/model/model.d.ts +209 -0
  381. package/five/model/objects/pbmContainer.d.ts +28 -0
  382. package/five/model/objects/pbmGaussianSplattingObject.d.ts +43 -0
  383. package/five/model/objects/pbmGaussianSplattingRenderMesh.d.ts +55 -0
  384. package/five/model/objects/pbmGaussianSplattingTestMesh.d.ts +7 -0
  385. package/five/model/objects/pbmGroup.d.ts +8 -0
  386. package/five/model/objects/pbmMesh.d.ts +10 -0
  387. package/five/model/objects/pbmPointCloud.d.ts +7 -0
  388. package/five/model/parameter.d.ts +140 -0
  389. package/five/model/shaders/pbm_gaussian_splatting/fragment.d.ts +2 -0
  390. package/five/model/shaders/pbm_gaussian_splatting/vertex.d.ts +2 -0
  391. package/five/model/shaders/pbm_mesh_basic/fragment.d.ts +2 -0
  392. package/five/model/shaders/pbm_mesh_basic/vertex.d.ts +2 -0
  393. package/five/model/shaders/pbm_mesh_none/fragment.d.ts +2 -0
  394. package/five/model/shaders/pbm_mesh_none/vertex.d.ts +2 -0
  395. package/five/model/shaders/pbm_mesh_phong/fragment.d.ts +2 -0
  396. package/five/model/shaders/pbm_mesh_phong/vertex.d.ts +2 -0
  397. package/five/model/shaders/pbm_mesh_standard/fragment.d.ts +2 -0
  398. package/five/model/shaders/pbm_mesh_standard/vertex.d.ts +2 -0
  399. package/five/model/shaders/pbm_pointcloud/fragment.d.ts +2 -0
  400. package/five/model/shaders/pbm_pointcloud/vertex.d.ts +2 -0
  401. package/five/model/tile3d/header.d.ts +88 -0
  402. package/five/model/tile3d/index.d.ts +214 -0
  403. package/five/model/tile3d/tile-cache.d.ts +18 -0
  404. package/five/model/tile3d/tile-content.d.ts +10 -0
  405. package/five/model/tile3d/tile-node.d.ts +24 -0
  406. package/five/model/tile3d/tile-request-scheduler.d.ts +17 -0
  407. package/five/model/tile3d/tile.d.ts +79 -0
  408. package/five/model/tile3d/tileset-base-traverser.d.ts +59 -0
  409. package/five/model/tile3d/tileset-most-detail-traverser.d.ts +14 -0
  410. package/five/model/tile3d/tileset-normal-traverser.d.ts +15 -0
  411. package/five/model/tile3d/tileset-skip-traverser.d.ts +60 -0
  412. package/five/model/tile3d/tileset.d.ts +69 -0
  413. package/five/model/tile3d/trajectory-content.d.ts +9 -0
  414. package/five/model/tile3d/trajectory-node.d.ts +15 -0
  415. package/five/model/tile3d/trajectory.d.ts +30 -0
  416. package/five/model/tile3d/types.d.ts +33 -0
  417. package/five/model/view-layer.d.ts +20 -0
  418. package/five/renderer/five-renderer.d.ts +17 -0
  419. package/five/renderer/index.d.ts +3 -0
  420. package/five/renderer/postprocessing/composer.d.ts +37 -0
  421. package/five/renderer/postprocessing/index.d.ts +7 -0
  422. package/five/renderer/postprocessing/passes/adaptive-luminance-pass.d.ts +17 -0
  423. package/five/renderer/postprocessing/passes/eye-dome-lighting-pass.d.ts +14 -0
  424. package/five/renderer/postprocessing/passes/flowing-light-2d-pass.d.ts +36 -0
  425. package/five/renderer/postprocessing/passes/flowing-light-3d-pass.d.ts +36 -0
  426. package/five/renderer/postprocessing/passes/gaussian-blur-pass.d.ts +12 -0
  427. package/five/renderer/postprocessing/passes/pass.d.ts +38 -0
  428. package/five/renderer/scene-renderers/point-cloud-high-quality-scene-renderer.d.ts +11 -0
  429. package/five/renderer/scene-renderers/scene-renderer.d.ts +9 -0
  430. package/five/renderer/scene-renderers/ssaa-scene-renderer.d.ts +15 -0
  431. package/five/renderer/tools/full-screen-quad.d.ts +15 -0
  432. package/five/renderer/tools/render-cube-to-equirectangular.d.ts +7 -0
  433. package/five/renderer/tools/render-full-screen-depth.d.ts +2 -0
  434. package/five/renderer/tools/render-full-screen.d.ts +2 -0
  435. package/five/texture/histogram.d.ts +54 -0
  436. package/five/texture/imageBitmap.d.ts +13 -0
  437. package/five/texture/initTexture.d.ts +3 -0
  438. package/five/texture/loader.d.ts +39 -0
  439. package/five/texture/textureData.d.ts +11 -0
  440. package/five/thirdparty/fflate.d.ts +1407 -0
  441. package/five/thirdparty/hammer.d.ts +375 -0
  442. package/five/thirdparty/jsrsasign.d.ts +753 -0
  443. package/five/thirdparty/meshopt_decoder.d.ts +15 -0
  444. package/five/three-version-check.d.ts +1 -0
  445. package/five/types/addableObject.d.ts +12 -0
  446. package/five/types/cube.d.ts +1 -0
  447. package/five/types/gestureInput.d.ts +24 -0
  448. package/five/types/imageOptions.d.ts +20 -0
  449. package/five/types/intersectMeshInterface.d.ts +8 -0
  450. package/five/types/movePanoEffect.d.ts +13 -0
  451. package/five/types/movePanoOptions.d.ts +36 -0
  452. package/five/types/panoCircleMeshInterface.d.ts +34 -0
  453. package/five/types/plugin.d.ts +25 -0
  454. package/five/types/pose.d.ts +17 -0
  455. package/five/types/state.d.ts +20 -0
  456. package/five/types/viewport.d.ts +22 -0
  457. package/five/utils/ajax.d.ts +66 -0
  458. package/five/utils/animationFrameLoop.d.ts +45 -0
  459. package/five/utils/array.d.ts +31 -0
  460. package/five/utils/asyncTaskQueue.d.ts +8 -0
  461. package/five/utils/bufferGeometry.d.ts +33 -0
  462. package/five/utils/calculateProgress.d.ts +39 -0
  463. package/five/utils/calculateThreeMouse.d.ts +13 -0
  464. package/five/utils/canplayVideo.d.ts +2 -0
  465. package/five/utils/clamp.d.ts +2 -0
  466. package/five/utils/clock.d.ts +17 -0
  467. package/five/utils/createSymbol.d.ts +5 -0
  468. package/five/utils/decodeText.d.ts +2 -0
  469. package/five/utils/deepEqual.d.ts +2 -0
  470. package/five/utils/deepFreeze.d.ts +2 -0
  471. package/five/utils/defineProperty.d.ts +9 -0
  472. package/five/utils/detector.d.ts +14 -0
  473. package/five/utils/distance.d.ts +10 -0
  474. package/five/utils/draco.d.ts +26 -0
  475. package/five/utils/easing.d.ts +63 -0
  476. package/five/utils/event.d.ts +159 -0
  477. package/five/utils/formatRad.d.ts +7 -0
  478. package/five/utils/imageSupport.d.ts +6 -0
  479. package/five/utils/imageURL.d.ts +42 -0
  480. package/five/utils/isEmptyObject.d.ts +2 -0
  481. package/five/utils/isNil.d.ts +6 -0
  482. package/five/utils/isNumber.d.ts +2 -0
  483. package/five/utils/isPowerOfTwo.d.ts +2 -0
  484. package/five/utils/isPromise.d.ts +2 -0
  485. package/five/utils/isSimilar.d.ts +6 -0
  486. package/five/utils/json.d.ts +7 -0
  487. package/five/utils/ktx2.d.ts +30 -0
  488. package/five/utils/lzma/index.d.ts +2 -0
  489. package/five/utils/lzma/lzma.d.ts +3 -0
  490. package/five/utils/lzma/lzmaWASM.d.ts +2 -0
  491. package/five/utils/lzma/lzmaWorker.d.ts +14 -0
  492. package/five/utils/memoryUsage.d.ts +29 -0
  493. package/five/utils/motion.d.ts +38 -0
  494. package/five/utils/noop.d.ts +6 -0
  495. package/five/utils/now.d.ts +7 -0
  496. package/five/utils/pano.d.ts +9 -0
  497. package/five/utils/pick.d.ts +3 -0
  498. package/five/utils/poseUtils.d.ts +5 -0
  499. package/five/utils/renderCubeTextureToCubeRenderTarget.d.ts +3 -0
  500. package/five/utils/renderDepth.d.ts +2 -0
  501. package/five/utils/renderTexturesToCubeRenderTarget.d.ts +10 -0
  502. package/five/utils/requestPermission.d.ts +3 -0
  503. package/five/utils/shaderContentFix.d.ts +7 -0
  504. package/five/utils/shaderMaterial.d.ts +20 -0
  505. package/five/utils/stateUtils.d.ts +5 -0
  506. package/five/utils/string-pattern.d.ts +8 -0
  507. package/five/utils/subscribe.d.ts +67 -0
  508. package/five/utils/tileCube.d.ts +19 -0
  509. package/five/utils/toFastProperties.d.ts +1 -0
  510. package/five/utils/typedCache.d.ts +10 -0
  511. package/five/utils/uniform.d.ts +15 -0
  512. package/five/utils/url.d.ts +35 -0
  513. package/five/utils/uuid.d.ts +5 -0
  514. package/five/utils/values.d.ts +2 -0
  515. package/five/utils/vectorCoordinates.d.ts +29 -0
  516. package/five/utils/volume.d.ts +111 -0
  517. package/five/utils/webglError.d.ts +7 -0
  518. package/five/utils/worker.d.ts +26 -0
  519. package/five/webxr/XRControllerModelFactory.d.ts +28 -0
  520. package/five/webxr/motionHelper.d.ts +68 -0
  521. package/five/webxr/xrButton.d.ts +4 -0
  522. package/five/webxr/xrController.d.ts +24 -0
  523. package/five/webxr/xrManager.d.ts +84 -0
  524. package/five/work/_ALLOW_HOST.d.ts +2 -0
  525. package/five/work/index.d.ts +6 -0
  526. package/five/work/keychain.d.ts +5 -0
  527. package/five/work/looseWorkType.d.ts +121 -0
  528. package/five/work/verify.d.ts +7 -0
  529. package/five/work/work.d.ts +236 -0
  530. package/five/work/workFetcher.d.ts +4 -0
  531. package/five/work/workJson.d.ts +3 -0
  532. package/five/work/workJsonType.d.ts +73 -0
  533. package/five/work/workObserverUtils.d.ts +36 -0
  534. package/five/work/workParser.d.ts +6 -0
  535. package/five/work/workResolvedObserver.d.ts +12 -0
  536. package/five/work/workVerify.d.ts +2 -0
  537. package/five/work/works.d.ts +10 -0
  538. package/gltf-loader/gltf-object.d.ts +17 -0
  539. package/gltf-loader/index.d.ts +60 -160
  540. package/gltf-loader/index.js +9 -9
  541. package/gltf-loader/index.mjs +1351 -1451
  542. package/gltf-loader/thirdparty/DDSLoader.d.ts +23 -0
  543. package/gltf-loader/thirdparty/DRACOLoader.d.ts +18 -0
  544. package/gltf-loader/thirdparty/GLTFLoader.d.ts +59 -0
  545. package/line/circle_png.d.ts +1 -0
  546. package/line/index.d.ts +19 -69
  547. package/line/index.js +4 -4
  548. package/line/index.mjs +334 -513
  549. package/line/utils/Line2.d.ts +7 -0
  550. package/line/utils/LineGeometry.d.ts +10 -0
  551. package/line/utils/LineMaterial.d.ts +20 -0
  552. package/line/utils/LineSegments2.d.ts +11 -0
  553. package/line/utils/LineSegmentsGeometry.d.ts +15 -0
  554. package/llms.txt +43 -31
  555. package/package.json +11 -2
  556. package/plugins/BackgroundPlugin/Controller.d.ts +20 -0
  557. package/plugins/BackgroundPlugin/index.d.ts +5 -0
  558. package/plugins/BackgroundPlugin/typings.d.ts +44 -0
  559. package/plugins/BasePlugin/index.d.ts +119 -0
  560. package/plugins/DynamicPathLinePlugin/Controller.d.ts +167 -0
  561. package/plugins/DynamicPathLinePlugin/index.d.ts +5 -0
  562. package/plugins/DynamicPathLinePlugin/line2/Line2.d.ts +7 -0
  563. package/plugins/DynamicPathLinePlugin/line2/LineGeometry.d.ts +10 -0
  564. package/plugins/DynamicPathLinePlugin/line2/LineMaterial.d.ts +17 -0
  565. package/plugins/DynamicPathLinePlugin/line2/LineSegments2.d.ts +11 -0
  566. package/plugins/DynamicPathLinePlugin/line2/LineSegmentsGeometry.d.ts +15 -0
  567. package/plugins/DynamicPathLinePlugin/typing.d.ts +129 -0
  568. package/plugins/DynamicPathLinePlugin/typings.d.ts +72 -0
  569. package/plugins/ItemMaskPlugin/Controller.d.ts +48 -0
  570. package/plugins/ItemMaskPlugin/index.d.ts +5 -0
  571. package/plugins/ItemMaskPlugin/typing.d.ts +58 -0
  572. package/plugins/OrientationPlugin/Controller.d.ts +82 -0
  573. package/plugins/OrientationPlugin/RoundedBoxGeometry.d.ts +11 -0
  574. package/plugins/OrientationPlugin/index.d.ts +6 -0
  575. package/plugins/OrientationPlugin/typing.d.ts +25 -0
  576. package/plugins/PanoAnimePlugin/Controller.d.ts +46 -0
  577. package/plugins/PanoAnimePlugin/index.d.ts +5 -0
  578. package/plugins/PanoAnimePlugin/typing.d.ts +37 -0
  579. package/plugins/PluginTemplate/Controller.d.ts +27 -0
  580. package/plugins/PluginTemplate/index.d.ts +5 -0
  581. package/plugins/PluginTemplate/typing.d.ts +21 -0
  582. package/plugins/TrajectoryPlugin/Controller.d.ts +85 -0
  583. package/plugins/TrajectoryPlugin/index.d.ts +6 -0
  584. package/plugins/TrajectoryPlugin/typing.d.ts +25 -0
  585. package/plugins/index.d.ts +9 -1102
  586. package/plugins/index.js +17 -21
  587. package/plugins/index.mjs +3342 -4245
  588. package/plugins/thirdParty/CSS3DRenderer.d.ts +32 -0
  589. package/plugins/thirdParty/OrbitControls.d.ts +78 -0
  590. package/plugins/utils/absoluteUrl.d.ts +5 -0
  591. package/plugins/utils/clamp.d.ts +2 -0
  592. package/plugins/utils/loadImage.d.ts +1 -0
  593. package/plugins/utils/motion.d.ts +38 -0
  594. package/plugins/utils/now.d.ts +6 -0
  595. package/plugins/utils/uuid.d.ts +5 -0
  596. package/react/canvas.d.ts +19 -0
  597. package/react/context.d.ts +11 -0
  598. package/react/createProvider.d.ts +95 -0
  599. package/react/createStore.d.ts +144 -0
  600. package/react/hooks/unsafe__useFiveInstance.d.ts +9 -0
  601. package/react/hooks/useFiveAction.d.ts +147 -0
  602. package/react/hooks/useFiveCameraDirection.d.ts +7 -0
  603. package/react/hooks/useFiveCameraRaycaster.d.ts +7 -0
  604. package/react/hooks/useFiveCurrentObserver.d.ts +11 -0
  605. package/react/hooks/useFiveCurrentState.d.ts +15 -0
  606. package/react/hooks/useFiveEventCallback.d.ts +12 -0
  607. package/react/hooks/useFiveFloor.d.ts +15 -0
  608. package/react/hooks/useFiveHelper.d.ts +14 -0
  609. package/react/hooks/useFiveModelBounding.d.ts +5 -0
  610. package/react/hooks/useFiveModelEffect.d.ts +14 -0
  611. package/react/hooks/useFiveModelIntersectRaycaster.d.ts +22 -0
  612. package/react/hooks/useFiveModelReadyState.d.ts +8 -0
  613. package/react/hooks/useFiveProject2d.d.ts +20 -0
  614. package/react/hooks/useFiveSceneEffect.d.ts +21 -0
  615. package/react/hooks/useFiveState.d.ts +6 -0
  616. package/react/hooks/useFiveWork.d.ts +29 -0
  617. package/react/index.d.ts +24 -830
  618. package/react/index.js +3 -3
  619. package/react/index.mjs +572 -783
  620. package/react/rendererPool.d.ts +7 -0
  621. package/react/withFive.d.ts +213 -0
  622. package/shader-lib/EvenessPlane/index.d.ts +10 -0
  623. package/shader-lib/PointCloudExpand/index.d.ts +59 -0
  624. package/shader-lib/PolygonCuter/index.d.ts +52 -0
  625. package/shader-lib/PolygonCuter/worker.d.ts +14 -0
  626. package/shader-lib/ShineModel/index.d.ts +7 -0
  627. package/shader-lib/SweepModel/index.d.ts +7 -0
  628. package/shader-lib/index.d.ts +5 -86
  629. package/shader-lib/index.js +13 -14
  630. package/shader-lib/index.mjs +424 -824
  631. package/sticker/geometry.d.ts +3 -0
  632. package/sticker/index.d.ts +68 -71
  633. package/sticker/index.js +3 -3
  634. package/sticker/index.mjs +102 -142
  635. package/umd/five-gltf-loader.js +9 -9
  636. package/umd/five-line.js +4 -4
  637. package/umd/five-plugins.js +17 -21
  638. package/umd/five-react.js +3 -3
  639. package/umd/five-shader-lib.js +13 -14
  640. package/umd/five-sticker.js +3 -3
  641. package/umd/five-vfx.js +21 -21
  642. package/umd/five-vue.js +3 -3
  643. package/umd/five.js +188 -336
  644. package/vfx/airflow/airflow.d.ts +18 -0
  645. package/vfx/airflow/fragment-shader.d.ts +2 -0
  646. package/vfx/airflow/vertex-shader.d.ts +2 -0
  647. package/vfx/common/scale-shader.d.ts +2 -0
  648. package/vfx/common/simplex-noise-shader.d.ts +2 -0
  649. package/vfx/frame/fragment-shader.d.ts +2 -0
  650. package/vfx/frame/frame.d.ts +22 -0
  651. package/vfx/frame/vertex-shader.d.ts +2 -0
  652. package/vfx/index.d.ts +7 -363
  653. package/vfx/index.js +21 -21
  654. package/vfx/index.mjs +454 -910
  655. package/vfx/particle/fragment-shader.d.ts +2 -0
  656. package/vfx/particle/instance.d.ts +36 -0
  657. package/vfx/particle/particle.d.ts +205 -0
  658. package/vfx/particle/utils.d.ts +11 -0
  659. package/vfx/particle/vertex-shader.d.ts +2 -0
  660. package/vfx/particle-gpu/fragment-shader.d.ts +2 -0
  661. package/vfx/particle-gpu/instance.d.ts +36 -0
  662. package/vfx/particle-gpu/particle.d.ts +95 -0
  663. package/vfx/particle-gpu/utils.d.ts +11 -0
  664. package/vfx/particle-gpu/vertex-shader.d.ts +2 -0
  665. package/vfx/spotLight/fragment-shader.d.ts +2 -0
  666. package/vfx/spotLight/spotLight.d.ts +15 -0
  667. package/vfx/spotLight/vertex-shader.d.ts +2 -0
  668. package/vue/context.d.ts +7 -0
  669. package/vue/hooks/FiveCanvas.d.ts +36 -0
  670. package/vue/hooks/FiveProvider.d.ts +35 -0
  671. package/vue/hooks/unsafe__useFiveInject.d.ts +9 -0
  672. package/vue/hooks/useFiveAction.d.ts +178 -0
  673. package/vue/hooks/useFiveCameraDirection.d.ts +8 -0
  674. package/vue/hooks/useFiveCameraRaycaster.d.ts +8 -0
  675. package/vue/hooks/useFiveCurrentObserver.d.ts +12 -0
  676. package/vue/hooks/useFiveCurrentState.d.ts +16 -0
  677. package/vue/hooks/useFiveEventCallback.d.ts +11 -0
  678. package/vue/hooks/useFiveFloor.d.ts +16 -0
  679. package/vue/hooks/useFiveHelper.d.ts +15 -0
  680. package/vue/hooks/useFiveModel.d.ts +7 -0
  681. package/vue/hooks/useFiveModelBounding.d.ts +7 -0
  682. package/vue/hooks/useFiveModelIntersectRaycaster.d.ts +23 -0
  683. package/vue/hooks/useFiveModelReadyState.d.ts +9 -0
  684. package/vue/hooks/useFiveProject2d.d.ts +26 -0
  685. package/vue/hooks/useFiveScene.d.ts +6 -0
  686. package/vue/hooks/useFiveState.d.ts +16 -0
  687. package/vue/hooks/useFiveWork.d.ts +30 -0
  688. package/vue/index.d.ts +23 -467
  689. package/vue/index.js +3 -3
  690. package/vue/index.mjs +309 -301
  691. package/vue/rendererPool.d.ts +10 -0
  692. package/work-downloader/components/model-3d-tile.d.ts +2 -0
  693. package/work-downloader/components/model.d.ts +3 -0
  694. package/work-downloader/components/observer.d.ts +7 -0
  695. package/work-downloader/download.d.ts +16 -0
  696. package/work-downloader/index.d.ts +2 -33
  697. package/work-downloader/index.js +3 -3
  698. package/work-downloader/index.mjs +317 -556
  699. package/work-downloader/type.d.ts +28 -0
  700. package/work-downloader/utils/download-to-file.d.ts +1 -0
  701. package/work-downloader/utils/image-processing.d.ts +7 -0
  702. package/work-downloader/utils/join-url.d.ts +2 -0
  703. package/work-downloader/utils/log.d.ts +1 -0
  704. package/work-downloader/utils/relative-url.d.ts +1 -0
  705. package/docs/documents/five.FivePlugin.plugin.html +0 -60
  706. package/docs/documents/plugin.html +0 -60
  707. package/docs/media/five.ts +0 -2881
  708. package/docs/media/pass.ts +0 -64
  709. package/guides/ai-doc-guidelines.md +0 -72
  710. package/guides/features/3dtile.md +0 -264
  711. package/guides/features/parameter.md +0 -178
  712. package/guides/plugin.md +0 -206
  713. /package/{guides → ai_guides}/release_notes/6.6.md +0 -0
  714. /package/{guides → ai_guides}/release_notes/6.7.md +0 -0
  715. /package/{guides → ai_guides}/support.md +0 -0
@@ -0,0 +1,236 @@
1
+ import * as THREE from "three";
2
+ import type { Mode } from "../application/mode";
3
+ import type { TilesetHeader } from "../model/tile3d/header";
4
+ import type { LooseWork, LoosePanoWork } from "./looseWorkType";
5
+ import { CubeFace } from "../types/cube";
6
+ import type { PanoId } from "../utils/pano";
7
+ /** 全景视频贴片 */
8
+ export interface WorkVideo {
9
+ work: Work;
10
+ /** 视频源 url */
11
+ source: string;
12
+ /** 视频源变化矩阵 */
13
+ matrix: THREE.Matrix4;
14
+ /** 视频源长宽尺寸 */
15
+ size: THREE.Vector2;
16
+ }
17
+ export interface WorkCubeImage extends Record<CubeFace, string> {
18
+ work: Work;
19
+ }
20
+ export interface WorkTile extends WorkCubeImage {
21
+ /** 层级 */
22
+ level: number;
23
+ /** 尺寸 */
24
+ size: number;
25
+ /** 缩放比例 */
26
+ scale: number;
27
+ }
28
+ /** 全景图 */
29
+ export interface WorkImage extends WorkCubeImage {
30
+ /** 分辨率表 */
31
+ sizeList: readonly number[];
32
+ /** 瓦片信息 */
33
+ tiles: readonly WorkTile[];
34
+ /** 点位视频 */
35
+ video?: WorkVideo;
36
+ }
37
+ /** 初始化位姿参数 */
38
+ export interface WorkInitial {
39
+ work: Work;
40
+ /** 模态 */
41
+ mode?: Mode;
42
+ /** 点位序号 */
43
+ panoIndex?: number;
44
+ /** 相机水平角 */
45
+ longitude?: number;
46
+ /** 相机俯仰角 */
47
+ latitude?: number;
48
+ /** 相机可视角度(垂直)*/
49
+ fov?: number;
50
+ /** 相机观察点位置 [x, y, z] */
51
+ offset?: THREE.Vector3;
52
+ /** 相机距离观察点距离 */
53
+ distance?: number;
54
+ }
55
+ /** 每个点位的数据 */
56
+ export interface WorkObserver {
57
+ /** work */
58
+ work: Work;
59
+ /** 序号 */
60
+ index: number;
61
+ /** 序号 */
62
+ panoIndex: number;
63
+ /**
64
+ * 序号
65
+ * @example
66
+ * `${workCode}[${panoIndex}]`
67
+ */
68
+ panoId: PanoId;
69
+ /** 点位所在楼层 */
70
+ floorIndex: number;
71
+ /** 点位 derived_id */
72
+ derivedId: number;
73
+ /** 点位 derived_id_str */
74
+ derivedIdStr: string;
75
+ /** 点位是否激活可用 */
76
+ active: boolean;
77
+ /** 点位是否可加载 */
78
+ loadable: boolean;
79
+ /** 点位全景图 */
80
+ images: WorkImage;
81
+ /**
82
+ * @deprecated
83
+ * 可以看到的相关点位序号
84
+ * 数据和 accessibleNodes 一致,使用 accessibleNodes
85
+ */
86
+ visibleNodes: readonly number[];
87
+ /** 可以连通的相关点位序号 */
88
+ accessibleNodes: readonly number[];
89
+ /** 点位和模型的地面坐标 */
90
+ standingPosition: THREE.Vector3;
91
+ /** 点位和模型的观察点坐标 */
92
+ position: THREE.Vector3;
93
+ /** 点位和模型的旋转对齐关系四元数 */
94
+ quaternion: THREE.Quaternion;
95
+ /** 点位和模型的旋转对齐关系矩阵 */
96
+ matrix: THREE.Matrix4;
97
+ /**
98
+ * 将方向向量转化为全景图 uv。
99
+ * @param vector - 全局的方向向量。单位向量。
100
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
101
+ * @returns uv坐标 取值范围 [0,1]。
102
+ */
103
+ vectorToEquirectangularUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector2;
104
+ /**
105
+ * 将全景图 uv 转化为方向向量。
106
+ * @param uv - uv坐标 取值范围 [0,1]。
107
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
108
+ * @returns 全局的方向向量。单位向量。
109
+ */
110
+ equirectangularUvToVector(this: WorkObserver, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
111
+ /**
112
+ * 将方向向量转化为获六视图 uv
113
+ * @param vector - 全局的方向向量。单位向量。
114
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
115
+ * @returns uv 坐标,取值范围 [0,1]
116
+ */
117
+ vectorToCubemapUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): [cubeFace: CubeFace, cubemapUv: THREE.Vector2];
118
+ /**
119
+ * 将六视图 uv 转化为方向向量
120
+ * @param cubeFace - 六视图的某一面。
121
+ * @param uv - uv坐标 取值范围 [0,1]。
122
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
123
+ * @returns 全局的方向向量。单位向量。
124
+ */
125
+ cubemapUvToVector(this: WorkObserver, cubeFace: CubeFace, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
126
+ /** 获取点位的全局坐标 */
127
+ getWorldPosition(this: WorkObserver): THREE.Vector3;
128
+ /** 获取点位的全局地面坐标 */
129
+ getWorldStandingPosition(this: WorkObserver): THREE.Vector3;
130
+ }
131
+ export interface WorkModelLayer {
132
+ /** work */
133
+ work: Work;
134
+ /** 模型类型 point_cloud | mesh | gaussian_splatting */
135
+ type: 'point_cloud' | 'mesh' | 'gaussian_splatting';
136
+ /** 模型名称 */
137
+ name: string;
138
+ /** 指定上方向 */
139
+ upAxis: string;
140
+ /** 如果 tileset.json 地址 */
141
+ tileset: string;
142
+ }
143
+ /** 模型数据 */
144
+ export interface WorkModel {
145
+ /** work */
146
+ work: Work;
147
+ /** 模型文件地址 at3d / domez */
148
+ file?: string;
149
+ /** 模型贴图文件地址 */
150
+ textures?: readonly string[];
151
+ /** 模型贴图文件地址的父目录 */
152
+ textureBase?: string;
153
+ /** 指定上方向,对于 obj, ply 等定义不明确的需要指定上方向 */
154
+ upAxis?: string;
155
+ /** 模型的地理坐标数据 */
156
+ coordinate?: NonNullable<TilesetHeader['rootMeta']>['coordinate'];
157
+ /** 3d tile */
158
+ layers: readonly WorkModelLayer[];
159
+ }
160
+ export interface Work {
161
+ /** 数据签发人 */
162
+ issuer: string;
163
+ /** 编号 */
164
+ workCode: string;
165
+ /** 内部项目 id */
166
+ projectId?: string;
167
+ /** 允许访问的安全域名 */
168
+ allowHosts: readonly string[];
169
+ /** 过期时间 */
170
+ expire: Date;
171
+ /** 名称 */
172
+ name: string;
173
+ /** 根地址 */
174
+ baseURL: string;
175
+ /** 初始化参数 */
176
+ initial: WorkInitial;
177
+ /** 相对位姿 */
178
+ transform: THREE.Matrix4;
179
+ /** 模型参数 */
180
+ model?: WorkModel;
181
+ /** 全景点位信息 */
182
+ observers: readonly WorkObserver[];
183
+ }
184
+ export declare class Work {
185
+ jsonp: boolean;
186
+ shortPath: boolean;
187
+ observerBox: THREE.Box3;
188
+ /**
189
+ * 控制参数
190
+ * @deprecated 通过 work.transform 替换
191
+ */
192
+ options: {
193
+ /**
194
+ * 位姿修正
195
+ * @deprecated 通过 work.transform 替换
196
+ */
197
+ transform: THREE.Matrix4;
198
+ };
199
+ /**
200
+ * 原始数据
201
+ * @deprecated 通过 work.toJSON 替换
202
+ */
203
+ raw: {
204
+ works: string[];
205
+ };
206
+ /**
207
+ * 解析 Work 数据
208
+ * @param obj - work 数据,从如数开发者平台获取
209
+ * @param options - 配置参数, 可以在此二次设置 baseURL 等参数
210
+ * @returns - 签署过的 Work 数据结构
211
+ */
212
+ static parse: typeof parseWork;
213
+ constructor(obj: Work | LoosePanoWork | LooseWork | (Work | LooseWork)[] | any, options: ParseOptions);
214
+ getURL(source: string): string;
215
+ verifyURL(source: string): boolean;
216
+ toJSON(): any;
217
+ }
218
+ export type ParseOptions = {
219
+ /** 位姿 */
220
+ transform?: THREE.Matrix4 | number[];
221
+ /** 重置 WorkCode */
222
+ workCode?: string | ((input: any) => string);
223
+ /** 重写资源前缀 */
224
+ baseURL?: string;
225
+ /** 资源地址使用短地址 */
226
+ shortPath?: boolean;
227
+ /** 资源使用 jsonp 方式发布 */
228
+ jsonp?: boolean;
229
+ };
230
+ /**
231
+ * 解析 Work 数据
232
+ * @param obj - work 数据,从如数开发者平台获取
233
+ * @param options - 配置参数, 可以在此二次设置 baseURL 等参数
234
+ * @returns - 签署过的 Work 数据结构
235
+ */
236
+ export declare function parseWork(obj: Work | LoosePanoWork | LooseWork | string | any, options?: ParseOptions): Work;
@@ -0,0 +1,4 @@
1
+ import type { Work } from './work';
2
+ import type { Fetcher } from '../utils/ajax';
3
+ export declare function getFetcher(fiveId: string, work: Work): Fetcher;
4
+ export declare function registerFetcher(fiveId: string, work: Work, fetcher: Fetcher): void;
@@ -0,0 +1,3 @@
1
+ import type { Work } from './work';
2
+ import type { WorkJson } from './workJsonType';
3
+ export declare function workToJson(work: Work): WorkJson;
@@ -0,0 +1,73 @@
1
+ export interface WorkJson {
2
+ allow_hosts: string[];
3
+ expire_at: string;
4
+ code: string;
5
+ name?: string;
6
+ project_id?: string;
7
+ base_url: string;
8
+ initial?: WorkInitialJson;
9
+ model?: WorkModelJson;
10
+ observers?: WorkObserverJson[];
11
+ panorama?: WorkPanoramasJson;
12
+ }
13
+ export interface WorkInitialJson {
14
+ mode?: string;
15
+ pano_index?: number;
16
+ longitude?: number;
17
+ latitude?: number;
18
+ fov?: number;
19
+ offset?: number[];
20
+ distance?: number;
21
+ }
22
+ export interface WorkModelJson {
23
+ file_url?: string;
24
+ material_textures?: string[];
25
+ material_base_url?: string;
26
+ up_axis?: string;
27
+ layers?: WorkModelLayerJson[];
28
+ }
29
+ export interface WorkModelLayerJson {
30
+ name?: string;
31
+ type?: string;
32
+ up_axis: string;
33
+ tileset_url: string;
34
+ }
35
+ export interface WorkObserverJson {
36
+ index: number;
37
+ floor_index: number;
38
+ derived_id: number;
39
+ derived_id_str: string;
40
+ position: number[];
41
+ standing_position: number[];
42
+ quaternion: {
43
+ x: number;
44
+ y: number;
45
+ z: number;
46
+ w: number;
47
+ };
48
+ visible_nodes: number[];
49
+ accessible_nodes: number[];
50
+ }
51
+ export interface WorkPanoramasJson {
52
+ count: number;
53
+ list: WorkPanoramaJson[];
54
+ }
55
+ export interface WorkPanoramaJson {
56
+ index: number;
57
+ active?: boolean;
58
+ loadable?: boolean;
59
+ derived_id?: number;
60
+ derived_id_str?: string;
61
+ size_list: number[];
62
+ up: string;
63
+ down: string;
64
+ right: string;
65
+ left: string;
66
+ front: string;
67
+ back: string;
68
+ video?: {
69
+ source: string;
70
+ matrix: number[];
71
+ size: number[];
72
+ };
73
+ }
@@ -0,0 +1,36 @@
1
+ import * as THREE from 'three';
2
+ import { type WorkObserver } from './work';
3
+ import { type CubeFace } from '../types/cube';
4
+ /**
5
+ * 将方向向量转化为全景图 uv。
6
+ * @param vector - 全局的方向向量。单位向量。
7
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
8
+ * @returns uv坐标 取值范围 [0,1]。
9
+ */
10
+ export declare function vectorToEquirectangularUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector2;
11
+ /**
12
+ * 将全景图 uv 转化为方向向量。
13
+ * @param uv - uv坐标 取值范围 [0,1]。
14
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
15
+ * @returns 全局的方向向量。单位向量。
16
+ */
17
+ export declare function equirectangularUvToVector(this: WorkObserver, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
18
+ /**
19
+ * 将方向向量转化为获六视图 uv
20
+ * @param vector - 全局的方向向量。单位向量。
21
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
22
+ * @returns uv 坐标,取值范围 [0,1]
23
+ */
24
+ export declare function vectorToCubemapUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): [cubeFace: CubeFace, cubemapUv: THREE.Vector2];
25
+ /**
26
+ * 将六视图 uv 转化为方向向量
27
+ * @param cubeFace - 六视图的某一面。
28
+ * @param uv - uv坐标 取值范围 [0,1]。
29
+ * @param uvOrigin - top-left 原点在左上角,x轴向右,y轴向下[默认]。bottom-left 原点左下角,x轴向右,y轴向上。
30
+ * @returns 全局的方向向量。单位向量。
31
+ */
32
+ export declare function cubemapUvToVector(this: WorkObserver, cubeFace: CubeFace, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
33
+ /** 获取点位的全局坐标 */
34
+ export declare function getWorldPosition(this: WorkObserver): THREE.Vector3;
35
+ /** 获取点位的全局地面坐标 */
36
+ export declare function getWorldStandingPosition(this: WorkObserver): THREE.Vector3;
@@ -0,0 +1,6 @@
1
+ import type { Work } from "./work";
2
+ import type { LooseWork, LoosePanoWork } from "./looseWorkType";
3
+ import type { WorkJson } from "./workJsonType";
4
+ export declare function parse(inputs: Work | LooseWork | WorkJson | (Work | LooseWork | WorkJson)[] | any, work: Work): Work | Error;
5
+ export declare function parseNull(input: null, work: Work): Work | Error;
6
+ export declare function parsePano(input: LoosePanoWork, work: Work): Work | Error;
@@ -0,0 +1,12 @@
1
+ import { Pano, PanoId } from '../utils/pano';
2
+ import type { WorkObserver } from './work';
3
+ export interface WorkResolvedObserver extends WorkObserver {
4
+ isResolved: true;
5
+ panoId: PanoId;
6
+ pano: Pano;
7
+ accessibleIds: readonly PanoId[];
8
+ visibleIds: readonly PanoId[];
9
+ }
10
+ export declare class WorkResolvedObserver {
11
+ constructor(observer: WorkObserver);
12
+ }
@@ -0,0 +1,2 @@
1
+ import type { Work } from './work';
2
+ export declare const workVerifySet: WeakSet<Work>;
@@ -0,0 +1,10 @@
1
+ import { Work, WorkInitial, WorkObserver } from "./work";
2
+ import { WorkResolvedObserver } from "./workResolvedObserver";
3
+ import { Pano, PanoId } from '../utils/pano';
4
+ export type Works = ReadonlyArray<Work> & {
5
+ initial: WorkInitial;
6
+ getWork(workCode: string): Work | undefined;
7
+ getObserver(pano: PanoId | Pano | number): WorkObserver | undefined;
8
+ getResolvedObserver(pano: PanoId | Pano | number): WorkResolvedObserver | undefined;
9
+ };
10
+ export declare function createWorks(workArray: Work[]): Works;
@@ -0,0 +1,17 @@
1
+ import * as THREE from "three";
2
+ /**
3
+ * GLTF 对象
4
+ */
5
+ declare class GLTFObject extends THREE.Group {
6
+ needsRender: boolean;
7
+ /**
8
+ * mixer 为对应当前对象的动画混合器
9
+ * @description
10
+ * 通过 `gltf.animations` 可以获取动画帧。
11
+ * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
12
+ */
13
+ mixer: THREE.AnimationMixer;
14
+ constructor(rootObject?: THREE.Object3D);
15
+ clone(): this;
16
+ }
17
+ export { GLTFObject };
@@ -1,160 +1,60 @@
1
- import { AnimationClip } from 'three';
2
- import { BufferGeometry } from 'three';
3
- import { Camera } from 'three';
4
- import { CompressedPixelFormat } from 'three';
5
- import { CompressedTextureLoader } from 'three';
6
- import { Group } from 'three';
7
- import { Loader } from 'three';
8
- import { LoadingManager } from 'three';
9
- import { Material } from 'three';
10
- import { Object3D } from 'three';
11
- import { PixelFormat } from 'three';
12
- import { Texture } from 'three';
13
- import * as THREE_2 from 'three';
14
-
15
- export declare interface DDS {
16
- mipmaps: object[];
17
- width: number;
18
- height: number;
19
- format: PixelFormat | CompressedPixelFormat;
20
- mipmapCount: number;
21
- isCubemap: boolean;
22
- }
23
-
24
- export declare class DDSLoader extends CompressedTextureLoader {
25
-
26
- constructor( manager?: LoadingManager );
27
-
28
- parse( buffer: ArrayBuffer, loadMipmaps: boolean ) : DDS;
29
-
30
- }
31
-
32
- export declare class DRACOLoader extends Loader {
33
-
34
- constructor( manager?: LoadingManager );
35
-
36
- load( url: string, onLoad: ( geometry: BufferGeometry ) => void, onProgress?: ( event: ProgressEvent ) => void, onError?: ( event: ErrorEvent ) => void ): void;
37
- setDecoderPath( path: string ): DRACOLoader;
38
- setDecoderConfig( config: object ): DRACOLoader;
39
- setWorkerLimit( workerLimit: number ): DRACOLoader;
40
- preload(): DRACOLoader;
41
- dispose(): DRACOLoader;
42
-
43
- }
44
-
45
- /**
46
- * GLTFLoader 返回数据
47
- * @description
48
- * 一般情况下,gltf.scene 为模型对象,直接通过 `five.scene.add(gltf.scene)` 即可添加到场景
49
- * Five 的模型单位 1 为 1米,载入的模型单位标准不一,请自行 scale。
50
- * 如果涉及模型内置动画,GLTF 已经帮你封装了,通过 `gltf.animations` 可以获取动画帧。gltf.scene.mixer 为对应的 动画混合器。
51
- * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
52
- */
53
- export declare interface GLTF {
54
- animations: THREE_2.AnimationClip[];
55
- scene: GLTFObject;
56
- scenes: GLTFObject[];
57
- cameras: THREE_2.Camera[];
58
- asset: {
59
- copyright?: string;
60
- generator?: string;
61
- version?: string;
62
- minVersion?: string;
63
- extensions?: any;
64
- extras?: any;
65
- };
66
- parser: GLTFParser;
67
- userData: any;
68
- }
69
-
70
- /**
71
- * GLTF 模型加载器
72
- */
73
- export declare class GLTFLoader extends THREEGLTFLoader {
74
- static get version(): string;
75
- /**
76
- * GLTF 模型加载器
77
- *
78
- * @example
79
- * ```
80
- * const gltfLoader = new GLTFLoader();
81
- * gltfLoader.load("https://vr-public.realsee-cdn.cn/release/static/image/release/five/demo/gltf/plants/scene.gltf", ({ scene }) => {
82
- * five.scene.add(scene);
83
- * });
84
- * ```
85
- */
86
- constructor(manager?: THREE_2.LoadingManager);
87
- /**
88
- * 加载模型
89
- * @param url - 模型 URL
90
- * @param onLoad - 加载完成回调
91
- * @param onProgress - 加载进度回调
92
- * @param onError - 加载错误回调
93
- */
94
- load(url: string, onLoad: (gltf: GLTF) => void, onProgress?: (event: ProgressEvent) => void, onError?: (event: ErrorEvent) => void): void;
95
- parse(data: ArrayBuffer | string, path: string, onLoad: (gltf: GLTF) => void, onError?: (event: ErrorEvent) => void): void;
96
- }
97
-
98
- /**
99
- * GLTF 对象
100
- */
101
- export declare class GLTFObject extends THREE_2.Group {
102
- needsRender: boolean;
103
- /**
104
- * mixer 为对应当前对象的动画混合器
105
- * @description
106
- * 通过 `gltf.animations` 可以获取动画帧。
107
- * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
108
- */
109
- mixer: THREE_2.AnimationMixer;
110
- constructor(rootObject?: THREE_2.Object3D);
111
- clone(): this;
112
- }
113
-
114
- export declare class GLTFParser {
115
-
116
- json: any;
117
-
118
- associations: Map<Object3D|Material|Texture, GLTFReference>;
119
-
120
- getDependency: ( type: string, index: number ) => Promise<any>;
121
- getDependencies: ( type: string ) => Promise<any[]>;
122
-
123
- }
124
-
125
- export declare interface GLTFReference {
126
- type: 'materials'|'nodes'|'textures';
127
- index: number;
128
- }
129
-
130
- export declare interface THREEGLTF {
131
- animations: AnimationClip[];
132
- scene: Group;
133
- scenes: Group[];
134
- cameras: Camera[];
135
- asset: {
136
- copyright?: string;
137
- generator?: string;
138
- version?: string;
139
- minVersion?: string;
140
- extensions?: any;
141
- extras?: any;
142
- };
143
- parser: GLTFParser;
144
- userData: any;
145
- }
146
-
147
- export declare class THREEGLTFLoader extends Loader {
148
-
149
- constructor( manager?: LoadingManager );
150
- dracoLoader: DRACOLoader | null;
151
- ddsLoader: DDSLoader | null;
152
-
153
- load( url: string, onLoad: ( gltf: THREEGLTF ) => void, onProgress?: ( event: ProgressEvent ) => void, onError?: ( event: ErrorEvent ) => void ) : void;
154
- setDRACOLoader( dracoLoader: DRACOLoader ): THREEGLTFLoader;
155
- setDDSLoader( ddsLoader: DDSLoader ): THREEGLTFLoader;
156
- parse( data: ArrayBuffer | string, path: string, onLoad: ( gltf: THREEGLTF ) => void, onError?: ( event: ErrorEvent ) => void ) : void;
157
-
158
- }
159
-
160
- export { }
1
+ import * as THREE from "three";
2
+ import { GLTFLoader as THREEGLTFLoader } from "./thirdparty/GLTFLoader";
3
+ import type { GLTF as THREEGLTF } from "./thirdparty/GLTFLoader";
4
+ import type { GLTFParser, GLTFReference } from "./thirdparty/GLTFLoader";
5
+ import { DRACOLoader } from './thirdparty/DRACOLoader';
6
+ import { DDSLoader } from './thirdparty/DDSLoader';
7
+ import type { DDS } from './thirdparty/DDSLoader';
8
+ import { GLTFObject } from "./gltf-object";
9
+ /**
10
+ * GLTFLoader 返回数据
11
+ * @description
12
+ * 一般情况下,gltf.scene 为模型对象,直接通过 `five.scene.add(gltf.scene)` 即可添加到场景
13
+ * Five 的模型单位 1 为 1米,载入的模型单位标准不一,请自行 scale。
14
+ * 如果涉及模型内置动画,GLTF 已经帮你封装了,通过 `gltf.animations` 可以获取动画帧。gltf.scene.mixer 为对应的 动画混合器。
15
+ * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
16
+ */
17
+ interface GLTF {
18
+ animations: THREE.AnimationClip[];
19
+ scene: GLTFObject;
20
+ scenes: GLTFObject[];
21
+ cameras: THREE.Camera[];
22
+ asset: {
23
+ copyright?: string;
24
+ generator?: string;
25
+ version?: string;
26
+ minVersion?: string;
27
+ extensions?: any;
28
+ extras?: any;
29
+ };
30
+ parser: GLTFParser;
31
+ userData: any;
32
+ }
33
+ /**
34
+ * GLTF 模型加载器
35
+ */
36
+ declare class GLTFLoader extends THREEGLTFLoader {
37
+ static get version(): string;
38
+ /**
39
+ * GLTF 模型加载器
40
+ *
41
+ * @example
42
+ * ```
43
+ * const gltfLoader = new GLTFLoader();
44
+ * gltfLoader.load("https://vr-public.realsee-cdn.cn/release/static/image/release/five/demo/gltf/plants/scene.gltf", ({ scene }) => {
45
+ * five.scene.add(scene);
46
+ * });
47
+ * ```
48
+ */
49
+ constructor(manager?: THREE.LoadingManager);
50
+ /**
51
+ * 加载模型
52
+ * @param url - 模型 URL
53
+ * @param onLoad - 加载完成回调
54
+ * @param onProgress - 加载进度回调
55
+ * @param onError - 加载错误回调
56
+ */
57
+ load(url: string, onLoad: (gltf: GLTF) => void, onProgress?: (event: ProgressEvent) => void, onError?: (event: ErrorEvent) => void): void;
58
+ parse(data: ArrayBuffer | string, path: string, onLoad: (gltf: GLTF) => void, onError?: (event: ErrorEvent) => void): void;
59
+ }
60
+ export { GLTFObject, GLTFLoader, GLTFParser, GLTFReference, GLTF, DRACOLoader, DDSLoader, DDS, THREEGLTFLoader, THREEGLTF };