@realsee/five 6.8.0-alpha.3 → 6.8.0-alpha.31

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 (764) hide show
  1. package/AGENTS_READ_ME.md +6 -1
  2. package/AI_CONTEXT.md +6 -1
  3. package/README.md +10 -6
  4. package/ai_guides/README.md +40 -2
  5. package/ai_guides/ai-doc-guidelines.md +31 -1
  6. package/ai_guides/api.md +107 -13
  7. package/ai_guides/features/3dtile.md +49 -141
  8. package/ai_guides/features/camera-animation.md +42 -4
  9. package/ai_guides/features/clipper.md +4 -2
  10. package/ai_guides/features/{coordnate-system.md → coordinate-system.md} +22 -2
  11. package/ai_guides/features/event.md +108 -10
  12. package/ai_guides/features/five.md +20 -16
  13. package/ai_guides/features/flowing-light-2d-pass.md +442 -0
  14. package/ai_guides/features/flowing-light-3d-pass.md +425 -0
  15. package/ai_guides/features/gaussian-blur-pass.md +202 -0
  16. package/ai_guides/features/gesture.md +4 -1
  17. package/ai_guides/features/get-screen-pixels.md +4 -2
  18. package/ai_guides/features/image-options.md +5 -2
  19. package/ai_guides/features/load-external-model.md +27 -2
  20. package/ai_guides/features/load-progress.md +140 -0
  21. package/ai_guides/features/material.md +159 -0
  22. package/ai_guides/features/mode.md +5 -1
  23. package/ai_guides/features/model.md +5 -2
  24. package/ai_guides/features/move-pano-effect.md +3 -1
  25. package/ai_guides/features/multi-work.md +3 -1
  26. package/ai_guides/features/pano-filter.md +149 -0
  27. package/ai_guides/features/pano-tile.md +8 -15
  28. package/ai_guides/features/pano-uv.md +131 -0
  29. package/ai_guides/features/parameter.md +117 -118
  30. package/ai_guides/features/plugin.md +210 -0
  31. package/ai_guides/features/postprocessing.md +40 -5
  32. package/ai_guides/features/raycast.md +16 -2
  33. package/ai_guides/features/request-proxy.md +3 -1
  34. package/ai_guides/features/screen-project.md +4 -1
  35. package/ai_guides/features/state.md +25 -3
  36. package/ai_guides/features/view-layer.md +187 -0
  37. package/ai_guides/features/work.md +64 -3
  38. package/ai_guides/glossary.md +28 -7
  39. package/ai_guides/intro.md +1 -1
  40. package/ai_guides/quick-start.md +1 -0
  41. package/ai_guides/release_notes/6.8.md +222 -0
  42. package/ai_guides/template.md +28 -3
  43. package/docs/00_FOR_AI_AGENTS.md +3 -2
  44. package/docs/README.md +3 -2
  45. package/docs/assets/hierarchy.js +1 -1
  46. package/docs/assets/main.js +1 -1
  47. package/docs/assets/navigation.js +1 -1
  48. package/docs/assets/search.js +1 -1
  49. package/docs/classes/five.AdaptiveLuminancePass.html +7 -6
  50. package/docs/classes/five.AnimationFrameLoop.html +1 -1
  51. package/docs/classes/five.BoundingMesh.html +2 -2
  52. package/docs/classes/five.Camera.html +3 -3
  53. package/docs/classes/five.EyeDomeLightingPass.html +1 -1
  54. package/docs/classes/five.Five.html +77 -76
  55. package/docs/classes/five.FivePass.html +1 -1
  56. package/docs/classes/five.Histogram.html +19 -0
  57. package/docs/classes/five.InternalWebGLRenderer.html +1 -1
  58. package/docs/classes/five.Model.html +32 -32
  59. package/docs/classes/five.ModelScene.html +1 -1
  60. package/docs/classes/five.NetworkSubscribe.html +5 -5
  61. package/docs/classes/five.PBMContainer.html +1 -1
  62. package/docs/classes/five.PBMCustomShader.html +42 -3
  63. package/docs/classes/five.PBMGSObject.html +5 -3
  64. package/docs/classes/five.PBMGroup.html +1 -1
  65. package/docs/classes/five.PBMMesh.html +1 -1
  66. package/docs/classes/five.PBMMeshMaterial.html +16 -7
  67. package/docs/classes/five.PBMPanoFilter.html +61 -0
  68. package/docs/classes/five.PBMPointCloud.html +1 -1
  69. package/docs/classes/five.PBMPointCloudMaterial.html +5 -6
  70. package/docs/classes/five.PBMSkinnedMesh.html +1 -1
  71. package/docs/classes/five.PBMUpdateable.html +41 -0
  72. package/docs/classes/five.PanoCircleMesh.html +1 -1
  73. package/docs/classes/five.PanoCircleMeshCustom.html +1 -1
  74. package/docs/classes/five.PanoCircleMeshSolid.html +1 -1
  75. package/docs/classes/five.Parameter.html +59 -55
  76. package/docs/classes/five.Scene.html +1 -1
  77. package/docs/classes/five.Subscribe.html +5 -5
  78. package/docs/classes/five.Tile.html +1 -1
  79. package/docs/classes/five.Tile3D.html +30 -26
  80. package/docs/classes/five.TileNode.html +1 -1
  81. package/docs/classes/five.Tileset.html +3 -2
  82. package/docs/classes/five.Trajectory.html +1 -1
  83. package/docs/classes/five.TrajectoryNode.html +1 -1
  84. package/docs/classes/five.Work.html +16 -16
  85. package/docs/classes/five.WorkResolvedObserver.html +41 -16
  86. package/docs/classes/gltf-loader.DDSLoader.html +1 -1
  87. package/docs/classes/gltf-loader.DRACOLoader.html +1 -1
  88. package/docs/classes/gltf-loader.GLTFLoader.html +2 -2
  89. package/docs/classes/gltf-loader.GLTFObject.html +1 -1
  90. package/docs/classes/gltf-loader.GLTFParser.html +1 -1
  91. package/docs/classes/gltf-loader.THREEGLTFLoader.html +2 -2
  92. package/docs/classes/line.Line.html +1 -1
  93. package/docs/classes/line.LineGeometry.html +1 -1
  94. package/docs/classes/line.LineMaterial.html +1 -1
  95. package/docs/classes/line.LineSegmentsGeometry.html +1 -1
  96. package/docs/classes/line.THREE_Line2.html +1 -1
  97. package/docs/classes/line.THREE_LineSegments2.html +1 -1
  98. package/docs/classes/plugins.BasePlugin.Controller.html +1 -1
  99. package/docs/classes/plugins.CSS3DObject.html +9 -0
  100. package/docs/classes/plugins.CSS3DRenderer.html +4 -2
  101. package/docs/classes/plugins.CSS3DSprite.html +11 -0
  102. package/docs/classes/plugins.RoundedBoxGeometry.html +1 -1
  103. package/docs/classes/sticker.Sticker.html +1 -1
  104. package/docs/classes/vfx.Airflow.html +1 -1
  105. package/docs/classes/vfx.Flame.html +1 -1
  106. package/docs/classes/vfx.Particle.html +6 -6
  107. package/docs/classes/vfx.ParticleGPU.html +3 -3
  108. package/docs/classes/vfx.SpotLight.html +1 -1
  109. package/docs/documents/README.html +132 -3
  110. package/docs/documents/ai-doc-guidelines.html +48 -3
  111. package/docs/documents/api.html +179 -26
  112. package/docs/documents/features_3dtile.html +143 -46
  113. package/docs/documents/features_camera-animation.html +79 -6
  114. package/docs/documents/features_clipper.html +5 -2
  115. package/docs/documents/{features_coordnate-system.html → features_coordinate-system.html} +56 -4
  116. package/docs/documents/features_event.html +47 -8
  117. package/docs/documents/features_five.html +20 -16
  118. package/docs/documents/features_flowing-light-2d-pass.html +259 -0
  119. package/docs/documents/features_flowing-light-3d-pass.html +249 -0
  120. package/docs/documents/features_gaussian-blur-pass.html +182 -0
  121. package/docs/documents/features_gesture.html +5 -1
  122. package/docs/documents/features_get-screen-pixels.html +5 -2
  123. package/docs/documents/features_image-options.html +5 -2
  124. package/docs/documents/features_load-external-model.html +31 -4
  125. package/docs/documents/features_load-progress.html +110 -0
  126. package/docs/documents/features_material.html +341 -0
  127. package/docs/documents/features_mode.html +6 -1
  128. package/docs/documents/features_model.html +6 -2
  129. package/docs/documents/features_move-pano-effect.html +4 -1
  130. package/docs/documents/features_multi-work.html +4 -1
  131. package/docs/documents/features_pano-filter.html +123 -0
  132. package/docs/documents/features_pano-tile.html +35 -20
  133. package/docs/documents/features_pano-uv.html +82 -0
  134. package/docs/documents/features_parameter.html +84 -56
  135. package/docs/documents/features_plugin.html +105 -0
  136. package/docs/documents/features_postprocessing.html +23 -6
  137. package/docs/documents/features_raycast.html +9 -3
  138. package/docs/documents/features_request-proxy.html +4 -1
  139. package/docs/documents/features_screen-project.html +5 -1
  140. package/docs/documents/features_state.html +12 -2
  141. package/docs/documents/features_view-layer.html +158 -0
  142. package/docs/documents/features_work.html +64 -3
  143. package/docs/documents/glossary.html +33 -8
  144. package/docs/documents/intro.html +1 -1
  145. package/docs/documents/quick-start.html +1 -0
  146. package/docs/documents/release_notes_6.8.html +203 -0
  147. package/docs/documents/template.html +54 -4
  148. package/docs/functions/five.createDebugBoundingMesh.html +1 -1
  149. package/docs/functions/five.loadAt3d.html +1 -1
  150. package/docs/functions/five.loadB3dm.html +1 -1
  151. package/docs/functions/five.loadDome.html +1 -1
  152. package/docs/functions/five.loadDomez.html +1 -1
  153. package/docs/functions/five.loadFbx.html +1 -1
  154. package/docs/functions/five.loadGltf.html +1 -1
  155. package/docs/functions/five.loadPbm.html +1 -1
  156. package/docs/functions/five.loadPly.html +1 -1
  157. package/docs/functions/five.loadPnts.html +1 -1
  158. package/docs/functions/five.loadSplat.html +1 -1
  159. package/docs/functions/five.loadSpz.html +1 -1
  160. package/docs/functions/five.loadX3p.html +1 -1
  161. package/docs/functions/five.parseWork.html +1 -1
  162. package/docs/functions/plugins.CSS3DPlugin.html +1 -0
  163. package/docs/functions/plugins.GaussianSplattingEntranceAnimationPlugin.html +1 -0
  164. package/docs/functions/react.useFiveCurrentObserver.html +2 -2
  165. package/docs/functions/react.useFiveFloor.html +2 -2
  166. package/docs/functions/react.useFiveProject2d.html +2 -2
  167. package/docs/functions/vue.useFiveCurrentObserver.html +2 -2
  168. package/docs/functions/vue.useFiveFloor.html +2 -2
  169. package/docs/functions/vue.useFiveWorks.html +2 -2
  170. package/docs/hierarchy.html +1 -1
  171. package/docs/index.html +132 -3
  172. package/docs/interfaces/five.AddableObject.html +1 -1
  173. package/docs/interfaces/five.AjaxOptions.html +1 -1
  174. package/docs/interfaces/five.BaseEvent.html +7 -2
  175. package/docs/interfaces/five.BaseExtendableEvent.html +11 -0
  176. package/docs/interfaces/five.EventCallback.html +60 -52
  177. package/docs/interfaces/five.FiveInitArgs.html +2 -2
  178. package/docs/interfaces/five.FloorplanControllerCustomInitArgs.html +9 -9
  179. package/docs/interfaces/five.GestureEvent.html +21 -2
  180. package/docs/interfaces/five.GesturePointer.html +20 -0
  181. package/docs/interfaces/five.ImageOptions.html +1 -1
  182. package/docs/interfaces/five.IntersectEvent.html +10 -2
  183. package/docs/interfaces/five.IntersectMesh.html +1 -1
  184. package/docs/interfaces/five.IntersectMeshInterface.html +1 -1
  185. package/docs/interfaces/five.Intersection.html +4 -3
  186. package/docs/interfaces/five.LooseWorkObserver.html +2 -2
  187. package/docs/interfaces/five.LooseWorkPanorama.html +2 -2
  188. package/docs/interfaces/five.LooseWorkWithExtrinsics.html +6 -6
  189. package/docs/interfaces/five.MapviewControllerCustomInitArgs.html +10 -10
  190. package/docs/interfaces/five.ModeChangeEvent.html +9 -2
  191. package/docs/interfaces/five.ModelControllerCustomInitArgs.html +1 -1
  192. package/docs/interfaces/five.ModelEvent.html +7 -2
  193. package/docs/interfaces/five.ModelSceneEvent.html +7 -2
  194. package/docs/interfaces/five.ModelTileEvent.html +13 -0
  195. package/docs/interfaces/five.MovePanoOptions.html +8 -8
  196. package/docs/interfaces/five.NetworkAbortError.html +1 -1
  197. package/docs/interfaces/five.NetworkFirbiddenError.html +1 -1
  198. package/docs/interfaces/five.NetworkOptions.html +1 -1
  199. package/docs/interfaces/five.NetworkProxyError.html +1 -1
  200. package/docs/interfaces/five.NetworkResourceEvent.html +7 -2
  201. package/docs/interfaces/five.NetworkResponseError.html +1 -1
  202. package/docs/interfaces/five.NetworkTimeoutError.html +1 -1
  203. package/docs/interfaces/five.ObjectEvent.html +7 -2
  204. package/docs/interfaces/five.PBMClipperParameter.html +2 -2
  205. package/docs/interfaces/five.PBMCustomShaderInitArgs.html +2 -2
  206. package/docs/interfaces/five.PBMCustomShaderSlots.html +2 -2
  207. package/docs/interfaces/five.PBMMaterial.html +1 -1
  208. package/docs/interfaces/five.PBMMeshMaterialParameters.html +5 -3
  209. package/docs/interfaces/five.PBMPanoDepth.html +5 -5
  210. package/docs/interfaces/five.PBMPanoFilterValue.html +6 -0
  211. package/docs/interfaces/five.PBMPanoPicture.html +8 -6
  212. package/docs/interfaces/five.PBMPointCloudMaterialParameters.html +2 -3
  213. package/docs/interfaces/five.PBMRefinedScreen.html +2 -2
  214. package/docs/interfaces/five.PanoCircleMeshInterface.html +2 -2
  215. package/docs/interfaces/five.PanoEvent.html +15 -2
  216. package/docs/interfaces/five.PanoPrepareEvent.html +15 -0
  217. package/docs/interfaces/five.PanoTextureEvent.html +11 -2
  218. package/docs/interfaces/five.PanoramaControllerCustomInitArgs.html +1 -1
  219. package/docs/interfaces/five.PanoramaLikeControllerCustomInitArgs.html +1 -1
  220. package/docs/interfaces/five.ParameterMaterialValue.html +42 -38
  221. package/docs/interfaces/five.ParameterTilesetValue.html +15 -15
  222. package/docs/interfaces/five.ParameterValue.html +56 -52
  223. package/docs/interfaces/five.Pose.html +1 -1
  224. package/docs/interfaces/five.RenderEvent.html +7 -2
  225. package/docs/interfaces/five.ResolvedParameterValue.html +57 -54
  226. package/docs/interfaces/five.RgbaData.html +7 -0
  227. package/docs/interfaces/five.SplatData.html +2 -2
  228. package/docs/interfaces/five.State.html +1 -1
  229. package/docs/interfaces/five.StateEvent.html +9 -2
  230. package/docs/interfaces/five.TextureOptions.html +1 -1
  231. package/docs/interfaces/five.Tile3DOptions.html +2 -2
  232. package/docs/interfaces/five.TopviewControllerCustomInitArgs.html +7 -7
  233. package/docs/interfaces/five.VRPanoramaControllerCustomInitArgs.html +1 -1
  234. package/docs/interfaces/five.ViewLayer.html +30 -26
  235. package/docs/interfaces/five.WorkCubeImage.html +3 -2
  236. package/docs/interfaces/five.WorkImage.html +6 -5
  237. package/docs/interfaces/five.WorkInitial.html +8 -8
  238. package/docs/interfaces/five.WorkModel.html +8 -8
  239. package/docs/interfaces/five.WorkModelLayer.html +6 -6
  240. package/docs/interfaces/five.WorkObserver.html +42 -17
  241. package/docs/interfaces/five.WorkObserverJson.html +2 -2
  242. package/docs/interfaces/five.WorkObserverProto.html +26 -0
  243. package/docs/interfaces/five.WorkPanoramaJson.html +2 -2
  244. package/docs/interfaces/five.WorkTile.html +6 -5
  245. package/docs/interfaces/five.WorkVideo.html +4 -4
  246. package/docs/interfaces/five.WorksEvent.html +7 -2
  247. package/docs/interfaces/five.XRControllerEvent.html +10 -2
  248. package/docs/interfaces/five.XRControllerState.html +8 -0
  249. package/docs/interfaces/five.XRGestureEvent.html +13 -2
  250. package/docs/interfaces/five.XRPanoramaControllerCustomInitArgs.html +1 -1
  251. package/docs/interfaces/five.XRSessionEvent.html +9 -2
  252. package/docs/interfaces/plugins.BackgroundPluginController.html +1 -1
  253. package/docs/interfaces/plugins.BackgroundPluginType.EventMap.html +1 -1
  254. package/docs/interfaces/plugins.BasePlugin.State.html +1 -1
  255. package/docs/interfaces/plugins.CSS3DPluginController.html +52 -0
  256. package/docs/interfaces/plugins.CSS3DPluginType.Config.html +2 -0
  257. package/docs/interfaces/plugins.CSS3DPluginType.CreateCSS3DObjectType.html +10 -0
  258. package/docs/interfaces/plugins.CSS3DPluginType.EventMap.html +10 -0
  259. package/docs/interfaces/plugins.CSS3DPluginType.Params.html +4 -0
  260. package/docs/interfaces/plugins.CSS3DPluginType.State.html +8 -0
  261. package/docs/interfaces/plugins.CSS3DRendererParameters.html +2 -0
  262. package/docs/interfaces/plugins.DynamicPathLinePluginController.html +3 -3
  263. package/docs/interfaces/plugins.DynamicPathLinePluginType.EventMap.html +1 -1
  264. package/docs/interfaces/plugins.DynamicPathLinePluginType.State.html +1 -1
  265. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationController.html +44 -0
  266. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationPluginType.BoundingAABB2D.html +3 -0
  267. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationPluginType.Config.html +8 -0
  268. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationPluginType.EventMap.html +10 -0
  269. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationPluginType.Keyframe.html +3 -0
  270. package/docs/interfaces/plugins.GaussianSplattingEntranceAnimationPluginType.State.html +8 -0
  271. package/docs/interfaces/plugins.ItemMaskController.html +1 -1
  272. package/docs/interfaces/plugins.ItemMaskPluginType.EventMap.html +1 -1
  273. package/docs/interfaces/plugins.ItemMaskPluginType.State.html +2 -2
  274. package/docs/interfaces/plugins.OrientationPluginController.html +6 -6
  275. package/docs/interfaces/plugins.OrientationPluginType.EventMap.html +1 -1
  276. package/docs/interfaces/plugins.OrientationPluginType.State.html +1 -1
  277. package/docs/interfaces/plugins.PanoAnimeController.html +1 -1
  278. package/docs/interfaces/plugins.PanoAnimePluginType.EventMap.html +1 -1
  279. package/docs/interfaces/plugins.PanoAnimePluginType.State.html +1 -1
  280. package/docs/interfaces/plugins.PlayingState.html +2 -2
  281. package/docs/interfaces/plugins.PluginTemplateType.EventMap.html +1 -1
  282. package/docs/interfaces/plugins.PluginTemplateType.State.html +1 -1
  283. package/docs/interfaces/plugins.TrajectoryController.html +8 -8
  284. package/docs/interfaces/react.FiveInjectionTypes.html +21 -21
  285. package/docs/interfaces/sticker.IntersectionLike.html +2 -2
  286. package/docs/interfaces/vfx.ParticleArgs.html +4 -4
  287. package/docs/interfaces/vue.FiveActionVueCallbacks.html +3 -3
  288. package/docs/modules/five.html +1 -1
  289. package/docs/modules/plugins.CSS3DPluginType.html +1 -0
  290. package/docs/modules/plugins.GaussianSplattingEntranceAnimationPluginType.html +1 -0
  291. package/docs/modules/plugins.html +1 -1
  292. package/docs/modules.html +1 -1
  293. package/docs/types/five.ControllerEventTypes.html +30 -26
  294. package/docs/types/five.EasingFunction.html +1 -0
  295. package/docs/types/five.EventTypes.html +27 -25
  296. package/docs/types/five.LegacyEventType.html +7 -7
  297. package/docs/types/five.NetworkProgressCallback.html +1 -1
  298. package/docs/types/five.PBMAlphaMode.html +1 -1
  299. package/docs/types/five.PBMColorStyle.html +1 -1
  300. package/docs/types/five.PBMFloorStyle.html +1 -1
  301. package/docs/types/five.PBMMeshShaderType.html +1 -1
  302. package/docs/types/five.PBMPointBack.html +1 -1
  303. package/docs/types/five.PBMPointCloudShaderType.html +1 -1
  304. package/docs/types/five.PBMPointShape.html +1 -1
  305. package/docs/types/five.PBMPointSize.html +1 -1
  306. package/docs/types/five.PBMTransition.html +1 -1
  307. package/docs/types/five.ParseOptions.html +6 -6
  308. package/docs/types/five.Works.html +1 -1
  309. package/docs/types/plugins.BasePlugin.EventMap.html +1 -1
  310. package/docs/types/plugins.CSS3DPluginType.PluginData.html +1 -0
  311. package/docs/types/plugins.CSS3DPluginType.ServerData.html +1 -0
  312. package/docs/variables/five.PROXY_CONTROLLER_EVENT_NAMES.html +1 -1
  313. package/five/application/analysis.d.ts +40 -0
  314. package/five/application/controllers.d.ts +41 -0
  315. package/five/application/events-legacy.d.ts +454 -0
  316. package/five/application/events.d.ts +69 -0
  317. package/five/application/five.d.ts +519 -0
  318. package/five/application/fiveInitArgs.d.ts +176 -0
  319. package/five/application/fiveLoadOptions.d.ts +21 -0
  320. package/five/application/generateDefaultVideoElement.d.ts +2 -0
  321. package/five/application/getViewportScale.d.ts +2 -0
  322. package/five/application/initLights.d.ts +3 -0
  323. package/five/application/mode.d.ts +28 -0
  324. package/five/application/renderPoweredByRealsee.d.ts +3 -0
  325. package/five/assets/cardboard-png-data-url.d.ts +2 -0
  326. package/five/assets/gradient-png-data-url.d.ts +2 -0
  327. package/five/assets/loading-png-data-url.d.ts +2 -0
  328. package/five/assets/phone-png-data-url.d.ts +2 -0
  329. package/five/assets/realsee-png-data-url.d.ts +2 -0
  330. package/five/bvh/bvhMath.d.ts +33 -0
  331. package/five/bvh/bvhMesh.d.ts +7 -0
  332. package/five/bvh/bvhNode.d.ts +29 -0
  333. package/five/bvh/bvhObject.d.ts +18 -0
  334. package/five/bvh/bvhPoints.d.ts +6 -0
  335. package/five/bvh/index.d.ts +10 -0
  336. package/five/bvh/worker.d.ts +35 -0
  337. package/five/cardboard/helper.d.ts +2 -0
  338. package/five/cardboard/index.d.ts +13 -0
  339. package/five/cardboard/sensor.d.ts +158 -0
  340. package/five/certificates/hardware.d.ts +1 -0
  341. package/five/controllers/base.d.ts +167 -0
  342. package/five/controllers/events.d.ts +73 -0
  343. package/five/controllers/floorplan.d.ts +119 -0
  344. package/five/controllers/mapview.d.ts +139 -0
  345. package/five/controllers/model.d.ts +57 -0
  346. package/five/controllers/panorama.d.ts +144 -0
  347. package/five/controllers/panoramaLike.d.ts +87 -0
  348. package/five/controllers/topview.d.ts +42 -0
  349. package/five/controllers/vrPanorama.d.ts +56 -0
  350. package/five/controllers/xrPanorama.d.ts +81 -0
  351. package/five/core/camera.d.ts +65 -0
  352. package/five/core/internalWebGLRenderer.d.ts +14 -0
  353. package/five/core/panoVideo.d.ts +18 -0
  354. package/five/core/scene.d.ts +10 -0
  355. package/five/core/tiling.d.ts +43 -0
  356. package/five/declare.d.ts +2 -1
  357. package/five/gaussian-splatting/util/renderData.d.ts +66 -0
  358. package/five/gaussian-splatting/wasm/data.d.ts +20 -0
  359. package/five/gaussian-splatting/wasm/sort.d.ts +18 -0
  360. package/five/gaussian-splatting/worker/dataWorker.d.ts +1 -0
  361. package/five/gaussian-splatting/worker/sortWorker.d.ts +1 -0
  362. package/five/index.d.ts +60 -4636
  363. package/five/index.js +272 -392
  364. package/five/index.mjs +26894 -31013
  365. package/five/meshes/boundingMesh.d.ts +13 -0
  366. package/five/meshes/intersectMesh.d.ts +8 -0
  367. package/five/meshes/panoCircleMesh.d.ts +35 -0
  368. package/five/meshes/panoCircleMeshCustom.d.ts +40 -0
  369. package/five/meshes/panoCircleMeshSolid.d.ts +34 -0
  370. package/five/meshes/panoSphereMesh.d.ts +27 -0
  371. package/five/model/helpers/coordinate-transform.d.ts +3 -0
  372. package/five/model/helpers/ellipsoid-coordinates.d.ts +14 -0
  373. package/five/model/helpers/get-edges-by-sphere.d.ts +8 -0
  374. package/five/model/helpers/get-recommend-tile3d-parameters.d.ts +8 -0
  375. package/five/model/index.d.ts +70 -0
  376. package/five/model/intersection.d.ts +18 -0
  377. package/five/model/loaders/at3d.d.ts +12 -0
  378. package/five/model/loaders/b3dm.d.ts +9 -0
  379. package/five/model/loaders/dome.d.ts +22 -0
  380. package/five/model/loaders/domez.d.ts +11 -0
  381. package/five/model/loaders/fbx.d.ts +8 -0
  382. package/five/model/loaders/glTF-helpers/extensions/CESIUM_RTC.d.ts +9 -0
  383. package/five/model/loaders/glTF-helpers/extensions/EXT_meshopt_compression.d.ts +8 -0
  384. package/five/model/loaders/glTF-helpers/extensions/EXT_texture_webp.d.ts +11 -0
  385. package/five/model/loaders/glTF-helpers/extensions/KHR_animation_pointer.d.ts +6 -0
  386. package/five/model/loaders/glTF-helpers/extensions/KHR_binary_glTF.d.ts +25 -0
  387. package/five/model/loaders/glTF-helpers/extensions/KHR_draco_mesh_compression.d.ts +11 -0
  388. package/five/model/loaders/glTF-helpers/extensions/KHR_gaussian_splatting.d.ts +26 -0
  389. package/five/model/loaders/glTF-helpers/extensions/KHR_gaussian_splatting_compression_spz.d.ts +11 -0
  390. package/five/model/loaders/glTF-helpers/extensions/KHR_gaussian_splatting_compression_spz_2.d.ts +13 -0
  391. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_clearcoat.d.ts +10 -0
  392. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_emissive_strength.d.ts +10 -0
  393. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_sheen.d.ts +10 -0
  394. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_transmission.d.ts +10 -0
  395. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_unlit.d.ts +10 -0
  396. package/five/model/loaders/glTF-helpers/extensions/KHR_mesh_quantization.d.ts +6 -0
  397. package/five/model/loaders/glTF-helpers/extensions/KHR_node_visibility.d.ts +10 -0
  398. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_basisu.d.ts +9 -0
  399. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_transform.d.ts +10 -0
  400. package/five/model/loaders/glTF-helpers/extensions/REALSEE_materials_lightmap.d.ts +7 -0
  401. package/five/model/loaders/glTF-helpers/extensions/base.d.ts +25 -0
  402. package/five/model/loaders/glTF-helpers/glTF.d.ts +713 -0
  403. package/five/model/loaders/glTF-helpers/index.d.ts +51 -0
  404. package/five/model/loaders/glTF-helpers/parser.d.ts +115 -0
  405. package/five/model/loaders/glTF-helpers/type.d.ts +14 -0
  406. package/five/model/loaders/gltf.d.ts +10 -0
  407. package/five/model/loaders/obj.d.ts +9 -0
  408. package/five/model/loaders/pbm.d.ts +26 -0
  409. package/five/model/loaders/ply.d.ts +24 -0
  410. package/five/model/loaders/pnts.d.ts +8 -0
  411. package/five/model/loaders/protobuf/dome.d.ts +540 -0
  412. package/five/model/loaders/protobuf/pbm.d.ts +203 -0
  413. package/five/model/loaders/shared.d.ts +16 -0
  414. package/five/model/loaders/splat.d.ts +8 -0
  415. package/five/model/loaders/spz.d.ts +14 -0
  416. package/five/model/loaders/tile3d-helpers/feature-table.d.ts +15 -0
  417. package/five/model/loaders/tile3d-helpers/gl-type.d.ts +20 -0
  418. package/five/model/loaders/tile3d-helpers/parse-gltf-array-buffer.d.ts +2 -0
  419. package/five/model/loaders/tile3d-helpers/parse-header.d.ts +2 -0
  420. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.d.ts +2 -0
  421. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.worker.d.ts +6 -0
  422. package/five/model/loaders/tile3d-helpers/parse-table.d.ts +3 -0
  423. package/five/model/loaders/tile3d-helpers/tile3d-type.d.ts +35 -0
  424. package/five/model/loaders/x3p.d.ts +22 -0
  425. package/five/model/materials/pbmMaterial.d.ts +137 -0
  426. package/five/model/materials/pbmMeshMaterial.d.ts +126 -0
  427. package/five/model/materials/pbmPointCloudMaterial.d.ts +70 -0
  428. package/five/model/model-scene.d.ts +172 -0
  429. package/five/model/model.d.ts +209 -0
  430. package/five/model/objects/pbmContainer.d.ts +28 -0
  431. package/five/model/objects/pbmGaussianSplattingObject.d.ts +43 -0
  432. package/five/model/objects/pbmGaussianSplattingRenderMesh.d.ts +59 -0
  433. package/five/model/objects/pbmGaussianSplattingTestMesh.d.ts +7 -0
  434. package/five/model/objects/pbmGroup.d.ts +8 -0
  435. package/five/model/objects/pbmMesh.d.ts +10 -0
  436. package/five/model/objects/pbmPointCloud.d.ts +7 -0
  437. package/five/model/parameter.d.ts +141 -0
  438. package/five/model/shaders/pbm_gaussian_splatting/fragment.d.ts +2 -0
  439. package/five/model/shaders/pbm_gaussian_splatting/vertex.d.ts +2 -0
  440. package/five/model/shaders/pbm_mesh_basic/fragment.d.ts +2 -0
  441. package/five/model/shaders/pbm_mesh_basic/vertex.d.ts +2 -0
  442. package/five/model/shaders/pbm_mesh_none/fragment.d.ts +2 -0
  443. package/five/model/shaders/pbm_mesh_none/vertex.d.ts +2 -0
  444. package/five/model/shaders/pbm_mesh_phong/fragment.d.ts +2 -0
  445. package/five/model/shaders/pbm_mesh_phong/vertex.d.ts +2 -0
  446. package/five/model/shaders/pbm_mesh_standard/fragment.d.ts +2 -0
  447. package/five/model/shaders/pbm_mesh_standard/vertex.d.ts +2 -0
  448. package/five/model/shaders/pbm_pointcloud/fragment.d.ts +2 -0
  449. package/five/model/shaders/pbm_pointcloud/vertex.d.ts +2 -0
  450. package/five/model/tile3d/header.d.ts +88 -0
  451. package/five/model/tile3d/index.d.ts +216 -0
  452. package/five/model/tile3d/tile-cache.d.ts +18 -0
  453. package/five/model/tile3d/tile-content.d.ts +10 -0
  454. package/five/model/tile3d/tile-node.d.ts +24 -0
  455. package/five/model/tile3d/tile-request-scheduler.d.ts +17 -0
  456. package/five/model/tile3d/tile.d.ts +79 -0
  457. package/five/model/tile3d/tileset-base-traverser.d.ts +59 -0
  458. package/five/model/tile3d/tileset-most-detail-traverser.d.ts +14 -0
  459. package/five/model/tile3d/tileset-normal-traverser.d.ts +15 -0
  460. package/five/model/tile3d/tileset-skip-traverser.d.ts +60 -0
  461. package/five/model/tile3d/tileset.d.ts +70 -0
  462. package/five/model/tile3d/trajectory-content.d.ts +9 -0
  463. package/five/model/tile3d/trajectory-node.d.ts +15 -0
  464. package/five/model/tile3d/trajectory.d.ts +30 -0
  465. package/five/model/tile3d/types.d.ts +33 -0
  466. package/five/model/view-layer.d.ts +20 -0
  467. package/five/renderer/five-renderer.d.ts +17 -0
  468. package/five/renderer/index.d.ts +3 -0
  469. package/five/renderer/postprocessing/composer.d.ts +37 -0
  470. package/five/renderer/postprocessing/index.d.ts +7 -0
  471. package/five/renderer/postprocessing/passes/adaptive-luminance-pass.d.ts +17 -0
  472. package/five/renderer/postprocessing/passes/eye-dome-lighting-pass.d.ts +14 -0
  473. package/five/renderer/postprocessing/passes/flowing-light-2d-pass.d.ts +36 -0
  474. package/five/renderer/postprocessing/passes/flowing-light-3d-pass.d.ts +36 -0
  475. package/five/renderer/postprocessing/passes/gaussian-blur-pass.d.ts +12 -0
  476. package/five/renderer/postprocessing/passes/pass.d.ts +38 -0
  477. package/five/renderer/scene-renderers/point-cloud-high-quality-scene-renderer.d.ts +11 -0
  478. package/five/renderer/scene-renderers/scene-renderer.d.ts +9 -0
  479. package/five/renderer/scene-renderers/ssaa-scene-renderer.d.ts +15 -0
  480. package/five/renderer/tools/full-screen-quad.d.ts +15 -0
  481. package/five/renderer/tools/render-cube-to-equirectangular.d.ts +7 -0
  482. package/five/renderer/tools/render-full-screen-depth.d.ts +2 -0
  483. package/five/renderer/tools/render-full-screen.d.ts +2 -0
  484. package/five/texture/histogram.d.ts +54 -0
  485. package/five/texture/imageBitmap.d.ts +13 -0
  486. package/five/texture/initTexture.d.ts +3 -0
  487. package/five/texture/loader.d.ts +39 -0
  488. package/five/texture/textureData.d.ts +11 -0
  489. package/five/thirdparty/fflate.d.ts +1407 -0
  490. package/five/thirdparty/hammer.d.ts +375 -0
  491. package/five/thirdparty/jsrsasign.d.ts +753 -0
  492. package/five/thirdparty/meshopt_decoder.d.ts +15 -0
  493. package/five/three-version-check.d.ts +1 -0
  494. package/five/types/addableObject.d.ts +12 -0
  495. package/five/types/cube.d.ts +1 -0
  496. package/five/types/gestureInput.d.ts +24 -0
  497. package/five/types/imageOptions.d.ts +20 -0
  498. package/five/types/intersectMeshInterface.d.ts +8 -0
  499. package/five/types/movePanoEffect.d.ts +13 -0
  500. package/five/types/movePanoOptions.d.ts +36 -0
  501. package/five/types/panoCircleMeshInterface.d.ts +34 -0
  502. package/five/types/plugin.d.ts +25 -0
  503. package/five/types/pose.d.ts +17 -0
  504. package/five/types/state.d.ts +20 -0
  505. package/five/types/viewport.d.ts +22 -0
  506. package/five/utils/ajax.d.ts +66 -0
  507. package/five/utils/animationFrameLoop.d.ts +45 -0
  508. package/five/utils/array.d.ts +31 -0
  509. package/five/utils/asyncTaskQueue.d.ts +8 -0
  510. package/five/utils/bufferGeometry.d.ts +33 -0
  511. package/five/utils/calculateProgress.d.ts +39 -0
  512. package/five/utils/calculateThreeMouse.d.ts +13 -0
  513. package/five/utils/canplayVideo.d.ts +2 -0
  514. package/five/utils/clamp.d.ts +2 -0
  515. package/five/utils/clock.d.ts +17 -0
  516. package/five/utils/createSymbol.d.ts +5 -0
  517. package/five/utils/decodeText.d.ts +2 -0
  518. package/five/utils/deepEqual.d.ts +2 -0
  519. package/five/utils/deepFreeze.d.ts +2 -0
  520. package/five/utils/defineProperty.d.ts +9 -0
  521. package/five/utils/detector.d.ts +14 -0
  522. package/five/utils/distance.d.ts +10 -0
  523. package/five/utils/draco.d.ts +26 -0
  524. package/five/utils/easing.d.ts +63 -0
  525. package/five/utils/error.d.ts +1 -0
  526. package/five/utils/event.d.ts +210 -0
  527. package/five/utils/formatRad.d.ts +7 -0
  528. package/five/utils/imageSupport.d.ts +6 -0
  529. package/five/utils/imageURL.d.ts +42 -0
  530. package/five/utils/isEmptyObject.d.ts +2 -0
  531. package/five/utils/isNil.d.ts +6 -0
  532. package/five/utils/isNumber.d.ts +2 -0
  533. package/five/utils/isPowerOfTwo.d.ts +2 -0
  534. package/five/utils/isPromise.d.ts +2 -0
  535. package/five/utils/isSimilar.d.ts +6 -0
  536. package/five/utils/json.d.ts +7 -0
  537. package/five/utils/ktx2.d.ts +30 -0
  538. package/five/utils/lzma/index.d.ts +2 -0
  539. package/five/utils/lzma/lzma.d.ts +3 -0
  540. package/five/utils/lzma/lzmaWASM.d.ts +2 -0
  541. package/five/utils/lzma/lzmaWorker.d.ts +14 -0
  542. package/five/utils/memoryUsage.d.ts +29 -0
  543. package/five/utils/motion.d.ts +38 -0
  544. package/five/utils/noop.d.ts +6 -0
  545. package/five/utils/now.d.ts +7 -0
  546. package/five/utils/pano.d.ts +9 -0
  547. package/five/utils/pick.d.ts +3 -0
  548. package/five/utils/poseUtils.d.ts +5 -0
  549. package/five/utils/renderCubeTextureToCubeRenderTarget.d.ts +3 -0
  550. package/five/utils/renderDepth.d.ts +2 -0
  551. package/five/utils/renderTexturesToCubeRenderTarget.d.ts +10 -0
  552. package/five/utils/requestPermission.d.ts +3 -0
  553. package/five/utils/shaderContentFix.d.ts +7 -0
  554. package/five/utils/shaderMaterial.d.ts +20 -0
  555. package/five/utils/stateUtils.d.ts +5 -0
  556. package/five/utils/string-pattern.d.ts +8 -0
  557. package/five/utils/subscribe.d.ts +67 -0
  558. package/five/utils/tileCube.d.ts +19 -0
  559. package/five/utils/toFastProperties.d.ts +1 -0
  560. package/five/utils/typedCache.d.ts +10 -0
  561. package/five/utils/uniform.d.ts +15 -0
  562. package/five/utils/url.d.ts +35 -0
  563. package/five/utils/uuid.d.ts +5 -0
  564. package/five/utils/values.d.ts +2 -0
  565. package/five/utils/vectorCoordinates.d.ts +29 -0
  566. package/five/utils/volume.d.ts +111 -0
  567. package/five/utils/webglError.d.ts +7 -0
  568. package/five/utils/worker.d.ts +26 -0
  569. package/five/webxr/XRControllerModelFactory.d.ts +28 -0
  570. package/five/webxr/motionHelper.d.ts +68 -0
  571. package/five/webxr/xrButton.d.ts +4 -0
  572. package/five/webxr/xrController.d.ts +24 -0
  573. package/five/webxr/xrManager.d.ts +84 -0
  574. package/five/work/_ALLOW_HOST.d.ts +2 -0
  575. package/five/work/index.d.ts +7 -0
  576. package/five/work/keychain.d.ts +5 -0
  577. package/five/work/looseWorkType.d.ts +121 -0
  578. package/five/work/verify.d.ts +7 -0
  579. package/five/work/work.d.ts +206 -0
  580. package/five/work/workFetcher.d.ts +4 -0
  581. package/five/work/workJson.d.ts +3 -0
  582. package/five/work/workJsonType.d.ts +73 -0
  583. package/five/work/workObserverProto.d.ts +39 -0
  584. package/five/work/workParser.d.ts +6 -0
  585. package/five/work/workResolvedObserver.d.ts +12 -0
  586. package/five/work/workVerify.d.ts +2 -0
  587. package/five/work/works.d.ts +10 -0
  588. package/gltf-loader/gltf-object.d.ts +17 -0
  589. package/gltf-loader/index.d.ts +60 -160
  590. package/gltf-loader/index.js +9 -9
  591. package/gltf-loader/index.mjs +1351 -1451
  592. package/gltf-loader/thirdparty/DDSLoader.d.ts +23 -0
  593. package/gltf-loader/thirdparty/DRACOLoader.d.ts +18 -0
  594. package/gltf-loader/thirdparty/GLTFLoader.d.ts +59 -0
  595. package/line/circle_png.d.ts +1 -0
  596. package/line/index.d.ts +19 -69
  597. package/line/index.js +4 -4
  598. package/line/index.mjs +334 -513
  599. package/line/utils/Line2.d.ts +7 -0
  600. package/line/utils/LineGeometry.d.ts +10 -0
  601. package/line/utils/LineMaterial.d.ts +20 -0
  602. package/line/utils/LineSegments2.d.ts +11 -0
  603. package/line/utils/LineSegmentsGeometry.d.ts +15 -0
  604. package/llms.txt +48 -3
  605. package/package.json +4 -4
  606. package/plugins/BackgroundPlugin/Controller.d.ts +20 -0
  607. package/plugins/BackgroundPlugin/index.d.ts +5 -0
  608. package/plugins/BackgroundPlugin/typings.d.ts +44 -0
  609. package/plugins/BasePlugin/index.d.ts +119 -0
  610. package/plugins/CSS3DPlugin/Controller.d.ts +64 -0
  611. package/plugins/CSS3DPlugin/index.d.ts +5 -0
  612. package/plugins/CSS3DPlugin/typing.d.ts +32 -0
  613. package/plugins/DynamicPathLinePlugin/Controller.d.ts +167 -0
  614. package/plugins/DynamicPathLinePlugin/index.d.ts +5 -0
  615. package/plugins/DynamicPathLinePlugin/line2/Line2.d.ts +7 -0
  616. package/plugins/DynamicPathLinePlugin/line2/LineGeometry.d.ts +10 -0
  617. package/plugins/DynamicPathLinePlugin/line2/LineMaterial.d.ts +17 -0
  618. package/plugins/DynamicPathLinePlugin/line2/LineSegments2.d.ts +11 -0
  619. package/plugins/DynamicPathLinePlugin/line2/LineSegmentsGeometry.d.ts +15 -0
  620. package/plugins/DynamicPathLinePlugin/typing.d.ts +129 -0
  621. package/plugins/DynamicPathLinePlugin/typings.d.ts +72 -0
  622. package/plugins/GaussianSplattingEntranceAnimationPlugin/Controller.d.ts +30 -0
  623. package/plugins/GaussianSplattingEntranceAnimationPlugin/index.d.ts +5 -0
  624. package/plugins/GaussianSplattingEntranceAnimationPlugin/typing.d.ts +28 -0
  625. package/plugins/ItemMaskPlugin/Controller.d.ts +48 -0
  626. package/plugins/ItemMaskPlugin/index.d.ts +5 -0
  627. package/plugins/ItemMaskPlugin/typing.d.ts +58 -0
  628. package/plugins/OrientationPlugin/Controller.d.ts +82 -0
  629. package/plugins/OrientationPlugin/RoundedBoxGeometry.d.ts +11 -0
  630. package/plugins/OrientationPlugin/index.d.ts +6 -0
  631. package/plugins/OrientationPlugin/typing.d.ts +25 -0
  632. package/plugins/PanoAnimePlugin/Controller.d.ts +46 -0
  633. package/plugins/PanoAnimePlugin/index.d.ts +5 -0
  634. package/plugins/PanoAnimePlugin/typing.d.ts +37 -0
  635. package/plugins/PluginTemplate/Controller.d.ts +27 -0
  636. package/plugins/PluginTemplate/index.d.ts +5 -0
  637. package/plugins/PluginTemplate/typing.d.ts +21 -0
  638. package/plugins/TrajectoryPlugin/Controller.d.ts +85 -0
  639. package/plugins/TrajectoryPlugin/index.d.ts +6 -0
  640. package/plugins/TrajectoryPlugin/typing.d.ts +25 -0
  641. package/plugins/index.d.ts +11 -1102
  642. package/plugins/index.js +35 -21
  643. package/plugins/index.mjs +3668 -4247
  644. package/plugins/thirdParty/CSS3DRenderer.d.ts +45 -0
  645. package/plugins/thirdParty/OrbitControls.d.ts +78 -0
  646. package/plugins/utils/absoluteUrl.d.ts +5 -0
  647. package/plugins/utils/clamp.d.ts +2 -0
  648. package/plugins/utils/loadImage.d.ts +1 -0
  649. package/plugins/utils/motion.d.ts +38 -0
  650. package/plugins/utils/now.d.ts +6 -0
  651. package/plugins/utils/uuid.d.ts +2 -0
  652. package/react/canvas.d.ts +19 -0
  653. package/react/context.d.ts +12 -0
  654. package/react/createProvider.d.ts +95 -0
  655. package/react/createStore.d.ts +144 -0
  656. package/react/hooks/unsafe__useFiveInstance.d.ts +9 -0
  657. package/react/hooks/useFiveAction.d.ts +147 -0
  658. package/react/hooks/useFiveCameraDirection.d.ts +7 -0
  659. package/react/hooks/useFiveCameraRaycaster.d.ts +7 -0
  660. package/react/hooks/useFiveCurrentObserver.d.ts +11 -0
  661. package/react/hooks/useFiveCurrentState.d.ts +15 -0
  662. package/react/hooks/useFiveEventCallback.d.ts +12 -0
  663. package/react/hooks/useFiveFloor.d.ts +15 -0
  664. package/react/hooks/useFiveHelper.d.ts +14 -0
  665. package/react/hooks/useFiveModelBounding.d.ts +5 -0
  666. package/react/hooks/useFiveModelEffect.d.ts +14 -0
  667. package/react/hooks/useFiveModelIntersectRaycaster.d.ts +22 -0
  668. package/react/hooks/useFiveModelReadyState.d.ts +8 -0
  669. package/react/hooks/useFiveProject2d.d.ts +20 -0
  670. package/react/hooks/useFiveSceneEffect.d.ts +21 -0
  671. package/react/hooks/useFiveState.d.ts +6 -0
  672. package/react/hooks/useFiveWork.d.ts +29 -0
  673. package/react/index.d.ts +24 -830
  674. package/react/index.js +3 -3
  675. package/react/index.mjs +572 -783
  676. package/react/rendererPool.d.ts +7 -0
  677. package/react/withFive.d.ts +213 -0
  678. package/shader-lib/EvenessPlane/index.d.ts +10 -0
  679. package/shader-lib/PointCloudExpand/index.d.ts +59 -0
  680. package/shader-lib/PolygonCuter/index.d.ts +52 -0
  681. package/shader-lib/PolygonCuter/worker.d.ts +14 -0
  682. package/shader-lib/ShineModel/index.d.ts +7 -0
  683. package/shader-lib/SweepModel/index.d.ts +7 -0
  684. package/shader-lib/index.d.ts +5 -86
  685. package/shader-lib/index.js +13 -14
  686. package/shader-lib/index.mjs +424 -824
  687. package/sticker/geometry.d.ts +3 -0
  688. package/sticker/index.d.ts +68 -71
  689. package/sticker/index.js +3 -3
  690. package/sticker/index.mjs +102 -142
  691. package/umd/five-gltf-loader.js +9 -9
  692. package/umd/five-line.js +4 -4
  693. package/umd/five-plugins.js +35 -21
  694. package/umd/five-react.js +3 -3
  695. package/umd/five-shader-lib.js +13 -14
  696. package/umd/five-sticker.js +3 -3
  697. package/umd/five-vfx.js +21 -21
  698. package/umd/five-vue.js +3 -3
  699. package/umd/five.js +267 -387
  700. package/vfx/airflow/airflow.d.ts +18 -0
  701. package/vfx/airflow/fragment-shader.d.ts +2 -0
  702. package/vfx/airflow/vertex-shader.d.ts +2 -0
  703. package/vfx/common/scale-shader.d.ts +2 -0
  704. package/vfx/common/simplex-noise-shader.d.ts +2 -0
  705. package/vfx/frame/fragment-shader.d.ts +2 -0
  706. package/vfx/frame/frame.d.ts +22 -0
  707. package/vfx/frame/vertex-shader.d.ts +2 -0
  708. package/vfx/index.d.ts +7 -363
  709. package/vfx/index.js +21 -21
  710. package/vfx/index.mjs +454 -910
  711. package/vfx/particle/fragment-shader.d.ts +2 -0
  712. package/vfx/particle/instance.d.ts +36 -0
  713. package/vfx/particle/particle.d.ts +205 -0
  714. package/vfx/particle/utils.d.ts +11 -0
  715. package/vfx/particle/vertex-shader.d.ts +2 -0
  716. package/vfx/particle-gpu/fragment-shader.d.ts +2 -0
  717. package/vfx/particle-gpu/instance.d.ts +36 -0
  718. package/vfx/particle-gpu/particle.d.ts +95 -0
  719. package/vfx/particle-gpu/utils.d.ts +11 -0
  720. package/vfx/particle-gpu/vertex-shader.d.ts +2 -0
  721. package/vfx/spotLight/fragment-shader.d.ts +2 -0
  722. package/vfx/spotLight/spotLight.d.ts +15 -0
  723. package/vfx/spotLight/vertex-shader.d.ts +2 -0
  724. package/vue/context.d.ts +7 -0
  725. package/vue/hooks/FiveCanvas.d.ts +36 -0
  726. package/vue/hooks/FiveProvider.d.ts +35 -0
  727. package/vue/hooks/unsafe__useFiveInject.d.ts +9 -0
  728. package/vue/hooks/useFiveAction.d.ts +178 -0
  729. package/vue/hooks/useFiveCameraDirection.d.ts +8 -0
  730. package/vue/hooks/useFiveCameraRaycaster.d.ts +8 -0
  731. package/vue/hooks/useFiveCurrentObserver.d.ts +12 -0
  732. package/vue/hooks/useFiveCurrentState.d.ts +16 -0
  733. package/vue/hooks/useFiveEventCallback.d.ts +11 -0
  734. package/vue/hooks/useFiveFloor.d.ts +16 -0
  735. package/vue/hooks/useFiveHelper.d.ts +15 -0
  736. package/vue/hooks/useFiveModel.d.ts +7 -0
  737. package/vue/hooks/useFiveModelBounding.d.ts +7 -0
  738. package/vue/hooks/useFiveModelIntersectRaycaster.d.ts +23 -0
  739. package/vue/hooks/useFiveModelReadyState.d.ts +9 -0
  740. package/vue/hooks/useFiveProject2d.d.ts +26 -0
  741. package/vue/hooks/useFiveScene.d.ts +6 -0
  742. package/vue/hooks/useFiveState.d.ts +16 -0
  743. package/vue/hooks/useFiveWork.d.ts +30 -0
  744. package/vue/index.d.ts +23 -467
  745. package/vue/index.js +3 -3
  746. package/vue/index.mjs +309 -301
  747. package/vue/rendererPool.d.ts +10 -0
  748. package/work-downloader/components/model-3d-tile.d.ts +2 -0
  749. package/work-downloader/components/model.d.ts +3 -0
  750. package/work-downloader/components/observer.d.ts +7 -0
  751. package/work-downloader/download.d.ts +16 -0
  752. package/work-downloader/index.d.ts +2 -33
  753. package/work-downloader/index.js +3 -3
  754. package/work-downloader/index.mjs +339 -556
  755. package/work-downloader/type.d.ts +28 -0
  756. package/work-downloader/utils/download-to-file.d.ts +1 -0
  757. package/work-downloader/utils/image-processing.d.ts +7 -0
  758. package/work-downloader/utils/join-url.d.ts +2 -0
  759. package/work-downloader/utils/log.d.ts +1 -0
  760. package/work-downloader/utils/relative-url.d.ts +1 -0
  761. package/ai_guides/plugin.md +0 -206
  762. package/docs/documents/plugin.html +0 -60
  763. package/docs/media/five.ts +0 -2881
  764. package/docs/media/pass.ts +0 -64
@@ -0,0 +1,167 @@
1
+ import * as THREE from "three";
2
+ import { Camera, CameraPose } from "../core/camera";
3
+ import { Scene } from "../core/scene";
4
+ import { ModelScene } from "../model";
5
+ import { Mode } from "../application/mode";
6
+ import { Pano } from "../utils/pano";
7
+ import { GestureEvent } from '../utils/event';
8
+ import { Works } from "../work";
9
+ import { State } from "../types/state";
10
+ import { Pose } from "../types/pose";
11
+ import { Viewport } from "../types/viewport";
12
+ import { ImageOptions } from "../types/imageOptions";
13
+ import { MovePanoEffect } from "../types/movePanoEffect";
14
+ import { Subscribe } from "../utils/subscribe";
15
+ import { ControllerEventTypes } from "./events";
16
+ import { Motion } from "../utils/motion";
17
+ type CameraMotion = Motion<"longitude" | "latitude" | "fov">;
18
+ type PostProcessingType = 'edl' | 'hq' | 'luminance' | null;
19
+ interface BaseControllerInitArgs {
20
+ fiveId: string;
21
+ works: Works;
22
+ scene: Scene;
23
+ modelScene: ModelScene;
24
+ xrCustomObjectsScene: THREE.Scene;
25
+ helper: THREE.Group;
26
+ camera: Camera;
27
+ renderer: THREE.WebGLRenderer;
28
+ viewport: Viewport;
29
+ element: HTMLElement;
30
+ extraElements: HTMLElement[];
31
+ imageOptions: ImageOptions;
32
+ enableWheel: boolean;
33
+ videoTexture: THREE.VideoTexture;
34
+ initial: {
35
+ /** 初始化状态 */
36
+ state: Partial<State>;
37
+ currentState: State;
38
+ /** 状态切换动画时长 */
39
+ duration: number;
40
+ /** 动画模式 */
41
+ effect: MovePanoEffect;
42
+ /** 是否是用户触发的 */
43
+ userAction: boolean;
44
+ };
45
+ }
46
+ declare class BaseController extends Subscribe<ControllerEventTypes> implements BaseControllerInitArgs {
47
+ mode: Mode;
48
+ fiveId: string;
49
+ needsRender: boolean;
50
+ destroyed: boolean;
51
+ cameraMotion: CameraMotion;
52
+ userAction: boolean;
53
+ /** 资源等待中 */
54
+ pending: Set<string>;
55
+ scene: Scene;
56
+ modelScene: ModelScene;
57
+ xrCustomObjectsScene: THREE.Scene;
58
+ helper: THREE.Group;
59
+ camera: Camera;
60
+ renderer: THREE.WebGLRenderer;
61
+ viewport: Viewport;
62
+ element: HTMLElement;
63
+ works: Works;
64
+ imageOptions: ImageOptions;
65
+ videoTexture: THREE.VideoTexture;
66
+ extraElements: HTMLElement[];
67
+ enableWheel: boolean;
68
+ initial: {
69
+ state: Partial<State>;
70
+ currentState: State;
71
+ duration: number;
72
+ effect: MovePanoEffect;
73
+ userAction: boolean;
74
+ };
75
+ currentPano: Pano;
76
+ protected panState?: {
77
+ x: number;
78
+ y: number;
79
+ defaultPrevented: boolean;
80
+ pointerLength: number;
81
+ };
82
+ protected pressState?: {
83
+ event: GestureEvent;
84
+ timeStamp: number;
85
+ stop: () => void;
86
+ };
87
+ protected pinchState?: {
88
+ x: number;
89
+ y: number;
90
+ };
91
+ protected mouseWheelState?: {
92
+ timer: any;
93
+ };
94
+ protected mouseMoveState?: {
95
+ event: GestureEvent;
96
+ timeStamp: number;
97
+ };
98
+ /** 相机旋转是否在惯性运动 */
99
+ protected inMomentumMovement: {
100
+ uuid: string;
101
+ event?: GestureEvent;
102
+ } | null;
103
+ protected initAnimationReady: Promise<void>;
104
+ protected initAnimationIsReady: boolean;
105
+ private eventUnbinds;
106
+ static parseArgs(args: BaseControllerInitArgs): Required<BaseControllerInitArgs>;
107
+ static initAnimationEndState(args: BaseControllerInitArgs): State;
108
+ constructor(args: BaseControllerInitArgs);
109
+ /** 动态更新配置 */
110
+ updateConfiguration(args: {}): boolean;
111
+ /** 析构函数 */
112
+ destroy(): void;
113
+ /** 是否准备好,即不在用户操作中,并且不再动画中 */
114
+ isReady(): boolean;
115
+ bindExtraElement(element: HTMLElement): void;
116
+ unbindExtraElement(element: HTMLElement): void;
117
+ /** 生命周期: 更新模型 */
118
+ updateModel(modelScene: ModelScene): void;
119
+ /** 生命周期: 更新 Work */
120
+ updateWork(works: Works, state: Partial<State>, options: {
121
+ duration: number;
122
+ effect: MovePanoEffect;
123
+ }, userAction: boolean): boolean;
124
+ /** 生命周期: 更新当前时间 */
125
+ updateTime(time: number, deltaTime: number, ...args: any[]): void;
126
+ /** 生命周期: 更新渲染 */
127
+ render(): boolean;
128
+ /** 转动摄像头 */
129
+ updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
130
+ /** 通过帧动画转动摄像头 */
131
+ updateCameraWithKeyframes(keyframes: {
132
+ progress: number;
133
+ value: Pose;
134
+ key?: string;
135
+ }[], duration: number, userAction: boolean): Promise<void>;
136
+ /** 获取目标姿态 */
137
+ getTargetState(): State;
138
+ /** 初始化动画 */
139
+ protected initAnimation(): Promise<void>;
140
+ /** 改变相机 */
141
+ protected setCamera(cameraPose?: Partial<CameraPose>): void;
142
+ stopMomentumMovement(): void;
143
+ /** 用户 Pan 事件 */
144
+ protected onPanGesture(event: GestureEvent): void;
145
+ /** 用户 Tap 事件 */
146
+ protected onTapGesture(event: GestureEvent): void;
147
+ /** 用户 DblTap 事件 */
148
+ protected onDblTapGesture(event: GestureEvent): void;
149
+ /** 用户 Tap 事件 */
150
+ protected onPressGesture(event: GestureEvent): void;
151
+ /** 用户 Pinch 事件 */
152
+ protected onPinchGesture(event: GestureEvent): void;
153
+ /** 用户 MouseWheel 事件 */
154
+ protected onMouseWheel(event: GestureEvent): void;
155
+ /** 用户 MouseMove 事件 */
156
+ protected onMouseMove(event: GestureEvent): void;
157
+ /** 计算屏幕坐标位置到屏幕标准空间 x: [-1, 1], y: [-1, 1] */
158
+ protected relativeClientPosition(mouseXY: {
159
+ x: number;
160
+ y: number;
161
+ }): THREE.Vector2;
162
+ /** 从屏幕标准空间 得到 射线 */
163
+ protected createRaycasterFromCamera(coords: THREE.Vector2, camera: Camera): THREE.Raycaster;
164
+ /** 用户事件绑定 */
165
+ private bindEvents;
166
+ }
167
+ export { BaseController, CameraMotion, PostProcessingType, BaseControllerInitArgs };
@@ -0,0 +1,73 @@
1
+ import { GestureEvent, BaseEvent, StateEvent, IntersectEvent, PanoEvent, PanoPrepareEvent, PanoTextureEvent, XRSessionEvent, XRGestureEvent, XRControllerEvent } from "../utils/event";
2
+ type ControllerEventTypes = {
3
+ /** 手势 滑动屏幕 */
4
+ "gesture.pan"(event: GestureEvent): void;
5
+ /** 手势 点击屏幕 */
6
+ "gesture.tap"(event: GestureEvent): void;
7
+ /** 手势 双击屏幕 */
8
+ "gesture.dbltap"(event: GestureEvent): void;
9
+ /** 手势 长按屏幕 */
10
+ "gesture.press"(event: GestureEvent): void;
11
+ /** 手势 双指缩放 */
12
+ "gesture.pinch"(event: GestureEvent): void;
13
+ /** 手势 鼠标滚轮 */
14
+ "gesture.mousewheel"(event: GestureEvent): void;
15
+ /** 手势 鼠标移动 */
16
+ "gesture.mousemove"(event: GestureEvent): void;
17
+ /** 手势 惯性 */
18
+ "gesture.momentum"(event: GestureEvent): void;
19
+ /** 手势被触发 */
20
+ "gesture.fire"(event: GestureEvent): void;
21
+ /** 模态切换动画 开始 */
22
+ "initAnimation.start"(event: StateEvent): void;
23
+ /** 模态切换动画 结束 */
24
+ "initAnimation.end"(event: StateEvent): void;
25
+ /** 相机改变 */
26
+ "camera.update"(event: StateEvent): void;
27
+ "intersect.update"(event: IntersectEvent): void;
28
+ /** 选择 */
29
+ "pano.select"(event: PanoEvent): void;
30
+ /** 请求点位 */
31
+ "pano.request"(event: PanoEvent): void;
32
+ /** 准备点位 */
33
+ "pano.prepare"(event: PanoPrepareEvent): void;
34
+ /** 运动去点位 */
35
+ "pano.moveTo"(event: PanoEvent): void;
36
+ /** 运动点位过程 */
37
+ "pano.moving"(event: PanoEvent): void;
38
+ /** 运动到达点位 */
39
+ "pano.arrived"(event: PanoEvent): void;
40
+ /** 取消运动点位 */
41
+ "pano.cancel"(event: PanoEvent): void;
42
+ /** 运动点位出错 */
43
+ "pano.error"(event: PanoEvent): void;
44
+ /** 加载全景材质 */
45
+ "pano.texture.load"(event: PanoTextureEvent): void;
46
+ /** 加载全景材质进度 */
47
+ "pano.texture.progress"(event: PanoTextureEvent): void;
48
+ /** 加载全景材质成功 */
49
+ "pano.texture.success"(event: PanoTextureEvent): void;
50
+ /** 加载全景材质失败 */
51
+ "pano.texture.error"(event: PanoTextureEvent): void;
52
+ /** 加载全景材质中止 */
53
+ "pano.texture.abort"(event: PanoTextureEvent): void;
54
+ /** VRPanorama 请求退出 */
55
+ "vr.requestExit"(event: BaseEvent): void;
56
+ /** XR 退出 */
57
+ "xr.session.end"(event: XRSessionEvent): void;
58
+ /** XR 进入 */
59
+ "xr.session.start"(event: XRSessionEvent): void;
60
+ /** XR 手势(按钮) */
61
+ "xr.gesture.tap"(event: XRGestureEvent): void;
62
+ /** XR 手势(按钮) */
63
+ "xr.gesture.press"(event: XRGestureEvent): void;
64
+ /** XR 手势(按钮) */
65
+ "xr.gesture.buttonUp"(event: XRGestureEvent): void;
66
+ /** XR 手势(按钮) */
67
+ "xr.gesture.buttonDown"(event: XRGestureEvent): void;
68
+ /** XR手柄更新*/
69
+ "xr.controller.update"(event: XRControllerEvent): void;
70
+ /** 抛出错误 */
71
+ "error"(error: Error): void;
72
+ };
73
+ export { ControllerEventTypes };
@@ -0,0 +1,119 @@
1
+ import * as THREE from "three";
2
+ import { GestureEvent } from "../utils/event";
3
+ import { TextureLoader } from "../texture/loader";
4
+ import { BaseController, BaseControllerInitArgs } from "./base";
5
+ import { State } from "../types/state";
6
+ import { Pose } from "../types/pose";
7
+ import { MovePanoEffect } from "../types/movePanoEffect";
8
+ import { Works, WorkObserver } from "../work";
9
+ import { ModelScene } from "../model";
10
+ import { Motion } from "../utils/motion";
11
+ import { IntersectMeshInterface } from "../types/intersectMeshInterface";
12
+ type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
13
+ type ModelAlphaMotion = Motion<"modelAlpha">;
14
+ type PerspToOrthoMotion = Motion<"perspToOrtho">;
15
+ interface FloorplanControllerCustomInitArgs {
16
+ /** 默认水平角 */
17
+ defaultLongitude?: number;
18
+ /** 默认俯仰角 */
19
+ defaultLatitude?: number;
20
+ /** 最大俯仰角 */
21
+ maxLatitude?: number | ((fov: number) => number);
22
+ /** 最小俯仰角 */
23
+ minLatitude?: number | ((fov: number) => number);
24
+ /** 默认相机可视角度(垂直),可作为 `zoom` */
25
+ defaultFov?: number;
26
+ /** 最大相机可视角度 */
27
+ maxFov?: number;
28
+ /** 最小相机可视角度 */
29
+ minFov?: number;
30
+ /** 鼠标焦点环自定义创建器 */
31
+ intersectMeshCreator?: () => IntersectMeshInterface;
32
+ }
33
+ declare const defaultFloorplanControllerCustomInitArgs: Required<FloorplanControllerCustomInitArgs>;
34
+ type FloorplanControllerInitArgs = BaseControllerInitArgs & FloorplanControllerCustomInitArgs;
35
+ declare class FloorplanController extends BaseController implements Required<FloorplanControllerInitArgs> {
36
+ defaultLongitude: number;
37
+ defaultLatitude: number;
38
+ maxLatitude: number | ((fov: number) => number);
39
+ minLatitude: number | ((fov: number) => number);
40
+ defaultFov: number;
41
+ maxFov: number;
42
+ minFov: number;
43
+ intersectMeshCreator: () => IntersectMeshInterface;
44
+ locationMotion: LocationMotion;
45
+ modelAlphaMotion: ModelAlphaMotion;
46
+ perspToOrthoMotion: PerspToOrthoMotion;
47
+ protected pinchState?: {
48
+ x: number;
49
+ y: number;
50
+ fov: number;
51
+ };
52
+ protected pendingTextureId: string | null;
53
+ protected intersectMesh: IntersectMeshInterface;
54
+ protected textureLoader: TextureLoader;
55
+ static distanceFromModel(modelScene: ModelScene, fov: number, aspect: number): number;
56
+ static parseArgs(args: FloorplanControllerInitArgs): Required<FloorplanControllerInitArgs>;
57
+ static initAnimationEndState(args: FloorplanControllerInitArgs): State;
58
+ constructor(args: FloorplanControllerInitArgs);
59
+ updateConfiguration(args: FloorplanControllerCustomInitArgs): boolean;
60
+ /** 析构函数 */
61
+ destroy(): void;
62
+ /** 是否准备好,即不在用户操作中,并且不再动画中 */
63
+ isReady(): boolean;
64
+ /** 生命周期:更新 Work */
65
+ updateWork(works: Works, state: Partial<State>, options: {
66
+ duration: number;
67
+ effect: MovePanoEffect;
68
+ }, userAction: boolean): boolean;
69
+ /** 生命周期:更新模型 */
70
+ updateModel(modelScene: ModelScene): void;
71
+ /** 转动摄像头 */
72
+ updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
73
+ /** 通过帧动画转动摄像头 */
74
+ updateCameraWithKeyframes(keyframes: {
75
+ progress: number;
76
+ value: Pose;
77
+ key?: string;
78
+ }[], duration: number, userAction: boolean): Promise<void>;
79
+ /** 生命周期:时间迭代 */
80
+ updateTime(time: number, deltaTime: number, ...args: any[]): void;
81
+ /** 获取目标姿态 */
82
+ getTargetState(): State;
83
+ /** 初始化动画 */
84
+ protected initAnimation(): Promise<void>;
85
+ updateRenderSize(size: THREE.Vector2): void;
86
+ /**
87
+ * 方向射线上寻找下一个目标点位
88
+ * @param raycaster - 方向射线
89
+ * @returns 方向射线上寻找下一个目标点位
90
+ */
91
+ protected getForwardObserverOrNot(raycaster: THREE.Raycaster): WorkObserver | null;
92
+ protected coordinatesForOffset(offset: {
93
+ x: number;
94
+ y: number;
95
+ }): {
96
+ longitude: number;
97
+ latitude: number;
98
+ };
99
+ /** 惯性滚动 */
100
+ protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
101
+ longitude: number;
102
+ latitude: number;
103
+ }, duration: number): void;
104
+ /** 触摸 Pan 事件,相机转动 */
105
+ protected onPanGesture(event: GestureEvent): void;
106
+ /** 触摸 Pinch 事件, 相机缩放 */
107
+ protected onPinchGesture(event: GestureEvent): void;
108
+ /** 鼠标移动事件 展示交点环 */
109
+ protected onMouseMove(event: GestureEvent): void;
110
+ /** 鼠标滚轮事件 相机缩放 */
111
+ protected onMouseWheel(event: GestureEvent): void;
112
+ /** 触摸 点击屏幕 */
113
+ protected onTapGesture(event: GestureEvent): void;
114
+ /** 触摸 双点屏幕 */
115
+ protected onDblTapGesture(event: GestureEvent): void;
116
+ /** 隐藏焦点环 */
117
+ protected hideIntersectMesh(): void;
118
+ }
119
+ export { LocationMotion, ModelAlphaMotion, PerspToOrthoMotion, FloorplanController, FloorplanControllerInitArgs, FloorplanControllerCustomInitArgs, defaultFloorplanControllerCustomInitArgs, };
@@ -0,0 +1,139 @@
1
+ import * as THREE from "three";
2
+ import { TextureLoader } from "../texture/loader";
3
+ import { BaseController, BaseControllerInitArgs } from "./base";
4
+ import { Pose } from "../types/pose";
5
+ import { State } from "../types/state";
6
+ import { MovePanoEffect } from "../types/movePanoEffect";
7
+ import { GestureEvent } from "../utils/event";
8
+ import { Works, WorkObserver } from "../work";
9
+ import { ModelScene } from "../model";
10
+ import { Motion } from "../utils/motion";
11
+ import { IntersectMeshInterface } from "../types/intersectMeshInterface";
12
+ type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
13
+ type PerspToOrthoMotion = Motion<"perspToOrtho">;
14
+ type ModelAlphaMotion = Motion<"modelAlpha">;
15
+ interface MapviewControllerCustomInitArgs {
16
+ /** 默认水平角 */
17
+ defaultLongitude?: number;
18
+ /** 默认俯仰角 */
19
+ defaultLatitude?: number;
20
+ /** 默认相机距离 */
21
+ defaultDistance?: number;
22
+ /** 最大俯仰角 */
23
+ maxLatitude?: number | ((fov: number) => number);
24
+ /** 最小俯仰角 */
25
+ minLatitude?: number | ((fov: number) => number);
26
+ /**
27
+ * 相机类型
28
+ * perspective 透视相机
29
+ * orthographic 正交相机
30
+ * auto 在俯视为正交相机, 斜视为透视相机(默认)
31
+ */
32
+ cameraType?: "perspective" | "orthographic" | "auto";
33
+ /**
34
+ * 相机电子围栏
35
+ */
36
+ cameraFence?: THREE.Box3 | THREE.Sphere | null;
37
+ /** 鼠标焦点环自定义创建器 */
38
+ intersectMeshCreator?: () => IntersectMeshInterface;
39
+ }
40
+ declare const defaultMapviewControllerCustomInitArgs: Required<MapviewControllerCustomInitArgs>;
41
+ type MapviewControllerInitArgs = BaseControllerInitArgs & MapviewControllerCustomInitArgs;
42
+ declare class MapviewController extends BaseController implements Required<MapviewControllerInitArgs> {
43
+ defaultLongitude: number;
44
+ defaultLatitude: number;
45
+ defaultDistance: number;
46
+ maxLatitude: number | ((fov: number) => number);
47
+ minLatitude: number | ((fov: number) => number);
48
+ cameraType: "perspective" | "orthographic" | "auto";
49
+ cameraFence: THREE.Box3 | THREE.Sphere | null;
50
+ intersectMeshCreator: () => IntersectMeshInterface;
51
+ locationMotion: LocationMotion;
52
+ modelAlphaMotion: ModelAlphaMotion;
53
+ perspToOrthoMotion: PerspToOrthoMotion;
54
+ protected panState?: {
55
+ x: number;
56
+ y: number;
57
+ defaultPrevented: boolean;
58
+ buttons: number;
59
+ target: THREE.Vector3;
60
+ pointerLength: number;
61
+ };
62
+ protected pinchState?: {
63
+ x: number;
64
+ y: number;
65
+ scale: number;
66
+ distance: number;
67
+ };
68
+ protected intersectMesh: IntersectMeshInterface;
69
+ protected pendingTextureId: string | null;
70
+ protected textureLoader: TextureLoader;
71
+ static parseArgs(args: MapviewControllerInitArgs): Required<MapviewControllerInitArgs>;
72
+ static distanceFromModel(modelScene: ModelScene, fov: number, aspect: number): number;
73
+ static initAnimationEndState(args: MapviewControllerInitArgs): State;
74
+ constructor(args: MapviewControllerInitArgs);
75
+ updateConfiguration(args: MapviewControllerCustomInitArgs): boolean;
76
+ /** 析构函数 */
77
+ destroy(): void;
78
+ /** 是否准备好,即不在用户操作中,并且不再动画中 */
79
+ isReady(): boolean;
80
+ /** 生命周期:更新 Work */
81
+ updateWork(works: Works, state: Partial<State>, options: {
82
+ duration: number;
83
+ effect: MovePanoEffect;
84
+ }, userAction: boolean): boolean;
85
+ /** 生命周期:更新模型 */
86
+ updateModel(modelScene: ModelScene): void;
87
+ /** 转动摄像头 */
88
+ updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
89
+ /** 通过帧动画转动摄像头 */
90
+ updateCameraWithKeyframes(keyframes: {
91
+ progress: number;
92
+ value: Pose;
93
+ key?: string;
94
+ }[], duration: number, userAction: boolean): Promise<void>;
95
+ /** 生命周期:时间迭代 */
96
+ updateTime(time: number, deltaTime: number): void;
97
+ /** 获取目标姿态 */
98
+ getTargetState(): State;
99
+ /** 初始化动画 */
100
+ protected initAnimation(): Promise<void>;
101
+ /**
102
+ * 方向射线上寻找下一个目标点位
103
+ * @param raycaster - 方向射线
104
+ * @returns 方向射线上寻找下一个目标点位
105
+ */
106
+ protected getForwardObserverOrNot(raycaster: THREE.Raycaster): WorkObserver | null;
107
+ /** 计算 屏幕像素 offset 与 转动间的关系 */
108
+ protected coordinatesForOffset(offset: {
109
+ x: number;
110
+ y: number;
111
+ }): {
112
+ longitude: number;
113
+ latitude: number;
114
+ };
115
+ /** 惯性滚动 */
116
+ protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
117
+ longitude: number;
118
+ latitude: number;
119
+ x: number;
120
+ y: number;
121
+ z: number;
122
+ }, duration: number): void;
123
+ protected fixFinalState(state: State): void;
124
+ /** 触摸 Pan 事件,相机转动 */
125
+ protected onPanGesture(event: GestureEvent): void;
126
+ /** 触摸 Pinch 事件, 相机缩放 */
127
+ protected onPinchGesture(event: GestureEvent): void;
128
+ /** 鼠标移动事件 展示交点环 */
129
+ protected onMouseMove(event: GestureEvent): void;
130
+ /** 鼠标滚轮事件 相机缩放 */
131
+ protected onMouseWheel(event: GestureEvent): void;
132
+ /** 触摸 点击屏幕 */
133
+ protected onTapGesture(event: GestureEvent): void;
134
+ /** 触摸 双点屏幕 */
135
+ protected onDblTapGesture(event: GestureEvent): void;
136
+ /** 隐藏焦点环 */
137
+ protected hideIntersectMesh(): void;
138
+ }
139
+ export { MapviewController, MapviewControllerInitArgs, MapviewControllerCustomInitArgs, defaultMapviewControllerCustomInitArgs, };
@@ -0,0 +1,57 @@
1
+ import * as THREE from "three";
2
+ import { Pano } from "../utils/pano";
3
+ import { Works } from "../work";
4
+ import { MovePanoOptions } from "../types/movePanoOptions";
5
+ import { State } from "../types/state";
6
+ import { Pose } from "../types/pose";
7
+ import { MovePanoEffect } from "../types/movePanoEffect";
8
+ import { GestureEvent } from "../utils/event";
9
+ import { BaseControllerInitArgs } from "./base";
10
+ import { PanoramaLikeController, PanoramaLikeControllerCustomInitArgs } from "./panoramaLike";
11
+ import { Motion } from "../utils/motion";
12
+ type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
13
+ type ModelAlphaMotion = Motion<"modelAlpha">;
14
+ type PerspToOrthoMotion = Motion<"perspToOrtho">;
15
+ interface ModelControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
16
+ }
17
+ declare const defaultModelControllerCustomInitArgs: Required<ModelControllerCustomInitArgs>;
18
+ type ModelControllerInitArgs = BaseControllerInitArgs & ModelControllerCustomInitArgs;
19
+ declare class ModelController extends PanoramaLikeController implements Required<ModelControllerInitArgs> {
20
+ static parseArgs(args: ModelControllerInitArgs): Required<ModelControllerInitArgs>;
21
+ static initAnimationEndState(args: ModelControllerInitArgs): State;
22
+ locationMotion: LocationMotion;
23
+ modelAlphaMotion: ModelAlphaMotion;
24
+ perspToOrthoMotion: PerspToOrthoMotion;
25
+ constructor(args: ModelControllerInitArgs);
26
+ updateConfiguration(args: ModelControllerCustomInitArgs): boolean;
27
+ /** 析构函数 */
28
+ destroy(): void;
29
+ /** 是否准备好,即不在用户操作中,并且不再动画中 */
30
+ isReady(): boolean;
31
+ /** 生命周期:更新模型 */
32
+ updateWork(works: Works, state: Partial<State>, options: {
33
+ duration: number;
34
+ effect: MovePanoEffect;
35
+ }, userAction: boolean): boolean;
36
+ /** 转动摄像头 */
37
+ updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
38
+ /** 通过帧动画转动摄像头 */
39
+ updateCameraWithKeyframes(keyframes: {
40
+ progress: number;
41
+ value: Pose;
42
+ key?: string;
43
+ }[], duration: number, userAction: boolean): Promise<void>;
44
+ /** 生命周期:时间迭代 */
45
+ updateTime(time: number, deltaTime: number, ...args: any[]): void;
46
+ /** 初始化动画 */
47
+ protected initAnimation(): Promise<void>;
48
+ /** 获取目标姿态 */
49
+ getTargetState(): State;
50
+ /** 移动点位 */
51
+ moveToPano(pano: Pano, options: MovePanoOptions | undefined, userAction: boolean): void;
52
+ /** 移动相机位置 */
53
+ moveToPosition(position: THREE.Vector3, options: MovePanoOptions | undefined, userAction: boolean): void;
54
+ /** 触摸 点击屏幕 */
55
+ protected onTapGesture(event: GestureEvent): void;
56
+ }
57
+ export { ModelController, ModelControllerInitArgs, ModelControllerCustomInitArgs, defaultModelControllerCustomInitArgs, };