@realsee/five 6.8.0-alpha.0 → 6.8.0-alpha.10

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 (775) hide show
  1. package/AGENTS_READ_ME.md +4 -0
  2. package/AI_CONTEXT.md +4 -0
  3. package/README.md +50 -389
  4. package/ai_guides/README.md +122 -0
  5. package/ai_guides/ai-doc-guidelines.md +102 -0
  6. package/ai_guides/api.md +274 -0
  7. package/ai_guides/features/3dtile.md +172 -0
  8. package/ai_guides/features/camera-animation.md +205 -0
  9. package/ai_guides/features/clipper.md +135 -0
  10. package/ai_guides/features/coordinate-system.md +128 -0
  11. package/ai_guides/features/event.md +154 -0
  12. package/ai_guides/features/five.md +184 -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/ai_guides/features/gesture.md +180 -0
  17. package/ai_guides/features/get-screen-pixels.md +182 -0
  18. package/ai_guides/features/image-options.md +164 -0
  19. package/ai_guides/features/load-external-model.md +350 -0
  20. package/ai_guides/features/load-progress.md +140 -0
  21. package/ai_guides/features/material.md +151 -0
  22. package/ai_guides/features/mode.md +269 -0
  23. package/ai_guides/features/model.md +186 -0
  24. package/ai_guides/features/move-pano-effect.md +145 -0
  25. package/ai_guides/features/multi-work.md +146 -0
  26. package/ai_guides/features/pano-tile.md +132 -0
  27. package/ai_guides/features/pano-uv.md +131 -0
  28. package/ai_guides/features/parameter.md +153 -0
  29. package/ai_guides/features/plugin.md +210 -0
  30. package/ai_guides/features/postprocessing.md +259 -0
  31. package/ai_guides/features/raycast.md +175 -0
  32. package/ai_guides/features/request-proxy.md +112 -0
  33. package/ai_guides/features/screen-project.md +165 -0
  34. package/ai_guides/features/state.md +101 -0
  35. package/ai_guides/features/view-layer.md +187 -0
  36. package/ai_guides/features/work.md +303 -0
  37. package/ai_guides/glossary.md +93 -0
  38. package/ai_guides/intro.md +23 -0
  39. package/ai_guides/quick-start.md +69 -0
  40. package/ai_guides/release_notes/6.6.md +86 -0
  41. package/ai_guides/release_notes/6.7.md +401 -0
  42. package/ai_guides/release_notes/6.8.md +90 -0
  43. package/ai_guides/support.md +23 -0
  44. package/ai_guides/template.md +70 -0
  45. package/docs/00_FOR_AI_AGENTS.md +11 -0
  46. package/docs/README.md +11 -0
  47. package/docs/assets/hierarchy.js +1 -1
  48. package/docs/assets/highlight.css +29 -29
  49. package/docs/assets/icons.js +1 -1
  50. package/docs/assets/icons.svg +1 -1
  51. package/docs/assets/main.js +2 -2
  52. package/docs/assets/navigation.js +1 -1
  53. package/docs/assets/search.js +1 -1
  54. package/docs/assets/style.css +3 -3
  55. package/docs/classes/five.AdaptiveLuminancePass.html +2 -2
  56. package/docs/classes/five.AnimationFrameLoop.html +5 -5
  57. package/docs/classes/five.BoundingMesh.html +1 -1
  58. package/docs/classes/five.Camera.html +5 -5
  59. package/docs/classes/five.EffectComposer.html +1 -1
  60. package/docs/classes/five.EyeDomeLightingPass.html +2 -2
  61. package/docs/classes/five.Five.html +134 -134
  62. package/docs/classes/five.FivePass.html +2 -2
  63. package/docs/classes/five.FullScreenQuad.html +2 -2
  64. package/docs/classes/five.InternalWebGLRenderer.html +1 -1
  65. package/docs/classes/five.Model.html +36 -36
  66. package/docs/classes/five.ModelScene.html +12 -12
  67. package/docs/classes/five.Motion.html +1 -1
  68. package/docs/classes/five.NetworkSubscribe.html +23 -23
  69. package/docs/classes/five.PBMContainer.html +3 -3
  70. package/docs/classes/five.PBMGSObject.html +24 -0
  71. package/docs/classes/five.PBMGroup.html +1 -1
  72. package/docs/classes/five.PBMMesh.html +1 -1
  73. package/docs/classes/five.PBMMeshMaterial.html +15 -6
  74. package/docs/classes/five.PBMPointCloud.html +1 -1
  75. package/docs/classes/five.PBMPointCloudMaterial.html +3 -3
  76. package/docs/classes/five.PBMSkinnedMesh.html +1 -1
  77. package/docs/classes/five.PanoCircleMesh.html +4 -4
  78. package/docs/classes/five.PanoCircleMeshCustom.html +4 -4
  79. package/docs/classes/five.PanoCircleMeshSolid.html +4 -4
  80. package/docs/classes/five.Parameter.html +55 -51
  81. package/docs/classes/five.Scene.html +3 -3
  82. package/docs/classes/five.Subscribe.html +26 -25
  83. package/docs/classes/five.Tile.html +1 -1
  84. package/docs/classes/five.Tile3D.html +30 -26
  85. package/docs/classes/five.TileNode.html +2 -2
  86. package/docs/classes/five.Tileset.html +11 -11
  87. package/docs/classes/five.Trajectory.html +1 -1
  88. package/docs/classes/five.TrajectoryNode.html +1 -1
  89. package/docs/classes/five.Work.html +19 -19
  90. package/docs/classes/five.WorkResolvedObserver.html +41 -16
  91. package/docs/classes/gltf-loader.DDSLoader.html +1 -1
  92. package/docs/classes/gltf-loader.DRACOLoader.html +1 -1
  93. package/docs/classes/gltf-loader.GLTFLoader.html +6 -6
  94. package/docs/classes/gltf-loader.GLTFObject.html +1 -1
  95. package/docs/classes/gltf-loader.THREEGLTFLoader.html +1 -1
  96. package/docs/classes/line.Line.html +1 -1
  97. package/docs/classes/line.LineGeometry.html +4 -4
  98. package/docs/classes/line.LineMaterial.html +1 -1
  99. package/docs/classes/line.LineSegmentsGeometry.html +4 -4
  100. package/docs/classes/line.THREE_Line2.html +1 -1
  101. package/docs/classes/line.THREE_LineSegments2.html +1 -1
  102. package/docs/classes/plugins.BasePlugin.Controller.html +16 -16
  103. package/docs/classes/plugins.RoundedBoxGeometry.html +1 -1
  104. package/docs/classes/react.Store.html +12 -11
  105. package/docs/classes/sticker.Sticker.html +11 -11
  106. package/docs/classes/vfx.Airflow.html +1 -1
  107. package/docs/classes/vfx.Flame.html +1 -1
  108. package/docs/classes/vfx.Particle.html +31 -31
  109. package/docs/classes/vfx.ParticleGPU.html +7 -7
  110. package/docs/classes/vfx.SpotLight.html +1 -1
  111. package/docs/documents/README.html +138 -0
  112. package/docs/documents/ai-doc-guidelines.html +117 -0
  113. package/docs/documents/api.html +337 -0
  114. package/docs/documents/features_3dtile.html +216 -0
  115. package/docs/documents/features_camera-animation.html +157 -0
  116. package/docs/documents/features_clipper.html +80 -0
  117. package/docs/documents/features_coordinate-system.html +127 -0
  118. package/docs/documents/features_event.html +104 -0
  119. package/docs/documents/features_five.html +147 -0
  120. package/docs/documents/features_flowing-light-2d-pass.html +356 -0
  121. package/docs/documents/features_flowing-light-3d-pass.html +351 -0
  122. package/docs/documents/features_gaussian-blur-pass.html +182 -0
  123. package/docs/documents/features_gesture.html +120 -0
  124. package/docs/documents/features_get-screen-pixels.html +88 -0
  125. package/docs/documents/features_image-options.html +108 -0
  126. package/docs/documents/features_load-external-model.html +600 -0
  127. package/docs/documents/features_load-progress.html +110 -0
  128. package/docs/documents/features_material.html +334 -0
  129. package/docs/documents/features_mode.html +114 -0
  130. package/docs/documents/features_model.html +141 -0
  131. package/docs/documents/features_move-pano-effect.html +110 -0
  132. package/docs/documents/features_multi-work.html +97 -0
  133. package/docs/documents/features_pano-tile.html +100 -0
  134. package/docs/documents/features_pano-uv.html +82 -0
  135. package/docs/documents/features_parameter.html +101 -0
  136. package/docs/documents/features_plugin.html +105 -0
  137. package/docs/documents/features_postprocessing.html +109 -0
  138. package/docs/documents/features_raycast.html +98 -0
  139. package/docs/documents/features_request-proxy.html +78 -0
  140. package/docs/documents/features_screen-project.html +112 -0
  141. package/docs/documents/features_state.html +71 -0
  142. package/docs/documents/features_view-layer.html +158 -0
  143. package/docs/documents/features_work.html +129 -0
  144. package/docs/documents/glossary.html +94 -0
  145. package/docs/documents/intro.html +24 -0
  146. package/docs/documents/quick-start.html +32 -0
  147. package/docs/documents/release_notes_6.6.html +79 -0
  148. package/docs/documents/release_notes_6.7.html +209 -0
  149. package/docs/documents/release_notes_6.8.html +103 -0
  150. package/docs/documents/support.html +49 -0
  151. package/docs/documents/template.html +80 -0
  152. package/docs/functions/five.coordinatesToVector.html +1 -1
  153. package/docs/functions/five.defaultImageURLTransform.html +3 -3
  154. package/docs/functions/five.headingToLongitude.html +1 -1
  155. package/docs/functions/five.loadAt3d.html +1 -1
  156. package/docs/functions/five.loadB3dm.html +1 -1
  157. package/docs/functions/five.loadDome.html +1 -1
  158. package/docs/functions/five.loadDomez.html +1 -1
  159. package/docs/functions/five.loadFbx.html +1 -1
  160. package/docs/functions/five.loadGltf.html +1 -1
  161. package/docs/functions/five.loadPbm.html +1 -1
  162. package/docs/functions/five.loadPly.html +1 -1
  163. package/docs/functions/five.loadPnts.html +1 -1
  164. package/docs/functions/five.loadSplat.html +1 -0
  165. package/docs/functions/five.loadSpz.html +1 -0
  166. package/docs/functions/five.loadX3p.html +1 -1
  167. package/docs/functions/five.longitudeToHeading.html +1 -1
  168. package/docs/functions/five.parseWork.html +3 -3
  169. package/docs/functions/five.vectorToCoordinates.html +1 -1
  170. package/docs/functions/react.createFiveProvider.html +2 -2
  171. package/docs/functions/react.createStore.html +8 -8
  172. package/docs/functions/react.useFiveAction.html +6 -6
  173. package/docs/functions/react.useFiveCameraDirection.html +1 -1
  174. package/docs/functions/react.useFiveCameraRaycaster.html +1 -1
  175. package/docs/functions/react.useFiveCurrentObserver.html +1 -1
  176. package/docs/functions/react.useFiveCurrentState.html +1 -1
  177. package/docs/functions/react.useFiveEventCallback.html +1 -1
  178. package/docs/functions/react.useFiveFloor.html +1 -1
  179. package/docs/functions/react.useFiveHelper.html +1 -1
  180. package/docs/functions/react.useFiveModelIntersectRaycaster.html +2 -2
  181. package/docs/functions/react.useFiveModelReadyState.html +1 -1
  182. package/docs/functions/react.useFiveProject2d.html +2 -2
  183. package/docs/functions/react.useFiveSceneEffect.html +1 -1
  184. package/docs/functions/react.useFiveWork.html +2 -2
  185. package/docs/functions/vue.useFiveAction.html +8 -8
  186. package/docs/functions/vue.useFiveCameraDirection.html +1 -1
  187. package/docs/functions/vue.useFiveCameraRaycaster.html +1 -1
  188. package/docs/functions/vue.useFiveCurrentObserver.html +1 -1
  189. package/docs/functions/vue.useFiveCurrentState.html +1 -1
  190. package/docs/functions/vue.useFiveEventCallback.html +1 -1
  191. package/docs/functions/vue.useFiveFloor.html +1 -1
  192. package/docs/functions/vue.useFiveHelper.html +1 -1
  193. package/docs/functions/vue.useFiveModel.html +1 -1
  194. package/docs/functions/vue.useFiveModelBounding.html +1 -1
  195. package/docs/functions/vue.useFiveModelIntersectRaycaster.html +2 -2
  196. package/docs/functions/vue.useFiveModelReadyState.html +1 -1
  197. package/docs/functions/vue.useFiveProject2d.html +2 -2
  198. package/docs/functions/vue.useFiveScene.html +1 -1
  199. package/docs/functions/vue.useFiveState.html +1 -1
  200. package/docs/functions/vue.useFiveWorks.html +4 -4
  201. package/docs/hierarchy.html +1 -1
  202. package/docs/index.html +115 -187
  203. package/docs/interfaces/five.AddableObject.html +5 -5
  204. package/docs/interfaces/five.AjaxOptions.html +5 -5
  205. package/docs/interfaces/five.BaseEvent.html +2 -2
  206. package/docs/interfaces/five.EventCallback.html +198 -194
  207. package/docs/interfaces/five.FiveInitArgs.html +18 -18
  208. package/docs/interfaces/five.FiveLoadOptions.html +3 -3
  209. package/docs/interfaces/five.FloorplanControllerCustomInitArgs.html +8 -8
  210. package/docs/interfaces/five.GestureEvent.html +2 -2
  211. package/docs/interfaces/five.ImageOptions.html +11 -11
  212. package/docs/interfaces/five.ImageURLOptions.html +8 -8
  213. package/docs/interfaces/five.IntersectEvent.html +2 -2
  214. package/docs/interfaces/five.IntersectMesh.html +1 -1
  215. package/docs/interfaces/five.IntersectMeshInterface.html +1 -1
  216. package/docs/interfaces/five.Intersection.html +4 -3
  217. package/docs/interfaces/five.LooseWorkWithExtrinsics.html +7 -7
  218. package/docs/interfaces/five.MapviewControllerCustomInitArgs.html +8 -8
  219. package/docs/interfaces/five.ModeChangeEvent.html +2 -2
  220. package/docs/interfaces/five.ModelControllerCustomInitArgs.html +9 -9
  221. package/docs/interfaces/five.ModelEvent.html +2 -2
  222. package/docs/interfaces/five.ModelOptions.html +3 -3
  223. package/docs/interfaces/five.ModelSceneEvent.html +2 -2
  224. package/docs/interfaces/five.ModelTileEvent.html +8 -0
  225. package/docs/interfaces/five.MovePanoOptions.html +10 -10
  226. package/docs/interfaces/five.NetworkAbortError.html +1 -1
  227. package/docs/interfaces/five.NetworkFirbiddenError.html +1 -1
  228. package/docs/interfaces/five.NetworkOptions.html +4 -4
  229. package/docs/interfaces/five.NetworkProxyError.html +1 -1
  230. package/docs/interfaces/five.NetworkResourceEvent.html +2 -2
  231. package/docs/interfaces/five.NetworkResponseError.html +1 -1
  232. package/docs/interfaces/five.NetworkTimeoutError.html +1 -1
  233. package/docs/interfaces/five.ObjectEvent.html +2 -2
  234. package/docs/interfaces/five.PBMMaterial.html +1 -1
  235. package/docs/interfaces/five.PBMMeshMaterialParameters.html +1 -1
  236. package/docs/interfaces/five.PBMPanoDepth.html +4 -4
  237. package/docs/interfaces/five.PBMPanoPicture.html +5 -5
  238. package/docs/interfaces/five.PBMPointCloudMaterialParameters.html +1 -1
  239. package/docs/interfaces/five.PanoCircleMeshInterface.html +4 -4
  240. package/docs/interfaces/five.PanoEvent.html +2 -2
  241. package/docs/interfaces/five.PanoTextureEvent.html +2 -2
  242. package/docs/interfaces/five.PanoramaControllerCustomInitArgs.html +15 -15
  243. package/docs/interfaces/five.PanoramaLikeControllerCustomInitArgs.html +9 -9
  244. package/docs/interfaces/five.ParameterMaterialValue.html +40 -36
  245. package/docs/interfaces/five.ParameterTilesetValue.html +15 -15
  246. package/docs/interfaces/five.ParameterValue.html +54 -50
  247. package/docs/interfaces/five.Pass.html +1 -1
  248. package/docs/interfaces/five.Pose.html +6 -7
  249. package/docs/interfaces/five.RenderEvent.html +2 -2
  250. package/docs/interfaces/five.ResolvedParameterValue.html +54 -50
  251. package/docs/interfaces/five.SplatData.html +10 -0
  252. package/docs/interfaces/five.State.html +9 -9
  253. package/docs/interfaces/five.StateEvent.html +2 -2
  254. package/docs/interfaces/five.TextureOptions.html +12 -12
  255. package/docs/interfaces/five.Tile3DOptions.html +2 -2
  256. package/docs/interfaces/five.TileCoordinateSystem.html +2 -2
  257. package/docs/interfaces/five.TilesetHeader.html +12 -12
  258. package/docs/interfaces/five.TopviewControllerCustomInitArgs.html +7 -7
  259. package/docs/interfaces/five.VRPanoramaControllerCustomInitArgs.html +13 -13
  260. package/docs/interfaces/five.ViewLayer.html +30 -26
  261. package/docs/interfaces/five.Viewport.html +4 -4
  262. package/docs/interfaces/five.WorkCubeImage.html +1 -1
  263. package/docs/interfaces/five.WorkImage.html +4 -4
  264. package/docs/interfaces/five.WorkInitial.html +8 -8
  265. package/docs/interfaces/five.WorkModel.html +8 -8
  266. package/docs/interfaces/five.WorkModelLayer.html +6 -6
  267. package/docs/interfaces/five.WorkObserver.html +41 -16
  268. package/docs/interfaces/five.WorkTile.html +4 -4
  269. package/docs/interfaces/five.WorkVideo.html +4 -4
  270. package/docs/interfaces/five.WorksEvent.html +2 -2
  271. package/docs/interfaces/five.XRControllerEvent.html +2 -2
  272. package/docs/interfaces/five.XRGestureEvent.html +2 -2
  273. package/docs/interfaces/five.XRPanoramaControllerCustomInitArgs.html +13 -13
  274. package/docs/interfaces/five.XRSessionEvent.html +2 -2
  275. package/docs/interfaces/plugins.BackgroundPluginController.html +11 -11
  276. package/docs/interfaces/plugins.BackgroundPluginType.EventMap.html +8 -8
  277. package/docs/interfaces/plugins.BasePlugin.BaseOptions.html +1 -1
  278. package/docs/interfaces/plugins.BasePlugin.Config.html +2 -2
  279. package/docs/interfaces/plugins.BasePlugin.State.html +4 -4
  280. package/docs/interfaces/plugins.BasePlugin.StateChangeParams.html +3 -3
  281. package/docs/interfaces/plugins.DynamicPathLinePluginController.html +45 -45
  282. package/docs/interfaces/plugins.DynamicPathLinePluginType.Config.html +18 -18
  283. package/docs/interfaces/plugins.DynamicPathLinePluginType.EventMap.html +13 -13
  284. package/docs/interfaces/plugins.DynamicPathLinePluginType.Params.html +2 -2
  285. package/docs/interfaces/plugins.DynamicPathLinePluginType.PathConfig.html +14 -14
  286. package/docs/interfaces/plugins.DynamicPathLinePluginType.State.html +5 -5
  287. package/docs/interfaces/plugins.ItemMaskController.html +12 -12
  288. package/docs/interfaces/plugins.ItemMaskPluginType.Config.html +1 -1
  289. package/docs/interfaces/plugins.ItemMaskPluginType.EventMap.html +5 -5
  290. package/docs/interfaces/plugins.ItemMaskPluginType.Params.html +1 -1
  291. package/docs/interfaces/plugins.ItemMaskPluginType.State.html +7 -7
  292. package/docs/interfaces/plugins.OrientationPluginController.html +12 -12
  293. package/docs/interfaces/plugins.OrientationPluginType.Config.html +1 -1
  294. package/docs/interfaces/plugins.OrientationPluginType.EventMap.html +5 -5
  295. package/docs/interfaces/plugins.OrientationPluginType.Params.html +1 -1
  296. package/docs/interfaces/plugins.OrientationPluginType.State.html +5 -5
  297. package/docs/interfaces/plugins.PanoAnimeController.html +14 -14
  298. package/docs/interfaces/plugins.PanoAnimePluginType.Config.html +1 -1
  299. package/docs/interfaces/plugins.PanoAnimePluginType.ConfigChangeEvent.html +3 -3
  300. package/docs/interfaces/plugins.PanoAnimePluginType.EventMap.html +6 -6
  301. package/docs/interfaces/plugins.PanoAnimePluginType.Params.html +1 -1
  302. package/docs/interfaces/plugins.PanoAnimePluginType.State.html +4 -4
  303. package/docs/interfaces/plugins.PluginTemplateType.Config.html +1 -1
  304. package/docs/interfaces/plugins.PluginTemplateType.EventMap.html +5 -5
  305. package/docs/interfaces/plugins.PluginTemplateType.Params.html +1 -1
  306. package/docs/interfaces/plugins.PluginTemplateType.State.html +4 -4
  307. package/docs/interfaces/plugins.TrajectoryController.html +30 -15
  308. package/docs/interfaces/react.FiveActionReactCallbacks.html +23 -23
  309. package/docs/interfaces/react.FiveCanvasProps.html +2 -2
  310. package/docs/interfaces/react.FiveInjectionTypes.html +76 -76
  311. package/docs/interfaces/sticker.IntersectionLike.html +2 -2
  312. package/docs/interfaces/vfx.ParticleArgs.html +26 -26
  313. package/docs/interfaces/vfx.ParticleGPUArgs.html +30 -30
  314. package/docs/interfaces/vue.FiveActionVueCallbacks.html +23 -23
  315. package/docs/modules/five.html +1 -1
  316. package/docs/modules.html +1 -1
  317. package/docs/types/five.ControllerEventTypes.html +32 -32
  318. package/docs/types/five.EventTypes.html +26 -24
  319. package/docs/types/five.FivePlugin.html +2 -2
  320. package/docs/types/five.FivePluginInit.html +1 -1
  321. package/docs/types/five.FivePluginInstance.html +1 -1
  322. package/docs/types/five.LegacyEventType.html +142 -142
  323. package/docs/types/five.LoadResultType.html +2 -2
  324. package/docs/types/five.Mode.html +1 -1
  325. package/docs/types/five.MotionCircle.html +1 -1
  326. package/docs/types/five.NetworkProgressCallback.html +1 -1
  327. package/docs/types/five.ParseOptions.html +6 -6
  328. package/docs/types/plugins.BasePlugin.EventMap.html +5 -5
  329. package/docs/types/plugins.DynamicPathLinePluginType.PluginData.html +1 -1
  330. package/docs/types/plugins.DynamicPathLinePluginType.ServerData.html +1 -1
  331. package/docs/variables/react.FiveCanvas.html +1 -1
  332. package/docs/variables/react.useFiveScene.html +1 -1
  333. package/docs/variables/vue.FiveCanvas.html +1 -1
  334. package/docs/variables/vue.FiveProvider.html +1 -1
  335. package/five/application/analysis.d.ts +40 -0
  336. package/five/application/controllers.d.ts +41 -0
  337. package/five/application/events-legacy.d.ts +454 -0
  338. package/five/application/events.d.ts +69 -0
  339. package/five/application/five.d.ts +518 -0
  340. package/five/application/fiveInitArgs.d.ts +176 -0
  341. package/five/application/fiveLoadOptions.d.ts +21 -0
  342. package/five/application/generateDefaultVideoElement.d.ts +2 -0
  343. package/five/application/getViewportScale.d.ts +2 -0
  344. package/five/application/initLights.d.ts +3 -0
  345. package/five/application/mode.d.ts +28 -0
  346. package/five/application/renderPoweredByRealsee.d.ts +3 -0
  347. package/five/assets/cardboard-png-data-url.d.ts +2 -0
  348. package/five/assets/gradient-png-data-url.d.ts +2 -0
  349. package/five/assets/loading-png-data-url.d.ts +2 -0
  350. package/five/assets/phone-png-data-url.d.ts +2 -0
  351. package/five/assets/realsee-pmg-data-url.d.ts +2 -0
  352. package/five/bvh/bvhMath.d.ts +33 -0
  353. package/five/bvh/bvhMesh.d.ts +7 -0
  354. package/five/bvh/bvhNode.d.ts +29 -0
  355. package/five/bvh/bvhObject.d.ts +18 -0
  356. package/five/bvh/bvhPoints.d.ts +6 -0
  357. package/five/bvh/index.d.ts +10 -0
  358. package/five/bvh/worker.d.ts +35 -0
  359. package/five/cardboard/helper.d.ts +2 -0
  360. package/five/cardboard/index.d.ts +13 -0
  361. package/five/cardboard/sensor.d.ts +158 -0
  362. package/five/certificates/hardware.d.ts +1 -0
  363. package/five/controllers/base.d.ts +166 -0
  364. package/five/controllers/events.d.ts +69 -0
  365. package/five/controllers/floorplan.d.ts +119 -0
  366. package/five/controllers/mapview.d.ts +138 -0
  367. package/five/controllers/model.d.ts +57 -0
  368. package/five/controllers/panorama.d.ts +143 -0
  369. package/five/controllers/panoramaLike.d.ts +87 -0
  370. package/five/controllers/topview.d.ts +42 -0
  371. package/five/controllers/vrPanorama.d.ts +56 -0
  372. package/five/controllers/xrPanorama.d.ts +81 -0
  373. package/five/core/camera.d.ts +65 -0
  374. package/five/core/internalWebGLRenderer.d.ts +14 -0
  375. package/five/core/panoVideo.d.ts +18 -0
  376. package/five/core/scene.d.ts +10 -0
  377. package/five/core/tiling.d.ts +43 -0
  378. package/five/declare.d.ts +2 -1
  379. package/five/gs/util/renderData.d.ts +32 -0
  380. package/five/gs/wasm/data.d.ts +20 -0
  381. package/five/gs/wasm/sort.d.ts +18 -0
  382. package/five/gs/worker/dataWorker.d.ts +1 -0
  383. package/five/gs/worker/sortWorker.d.ts +1 -0
  384. package/five/index.d.ts +57 -4582
  385. package/five/index.js +605 -92
  386. package/five/index.mjs +9661 -7537
  387. package/five/meshes/boundingMesh.d.ts +12 -0
  388. package/five/meshes/intersectMesh.d.ts +8 -0
  389. package/five/meshes/panoCircleMesh.d.ts +35 -0
  390. package/five/meshes/panoCircleMeshCustom.d.ts +40 -0
  391. package/five/meshes/panoCircleMeshSolid.d.ts +34 -0
  392. package/five/meshes/panoSphereMesh.d.ts +27 -0
  393. package/five/model/helpers/coordinate-transform.d.ts +3 -0
  394. package/five/model/helpers/ellipsoid-coordinates.d.ts +14 -0
  395. package/five/model/helpers/get-edges-by-sphere.d.ts +8 -0
  396. package/five/model/helpers/get-recommend-tile3d-parameters.d.ts +8 -0
  397. package/five/model/index.d.ts +70 -0
  398. package/five/model/intersection.d.ts +18 -0
  399. package/five/model/loaders/at3d.d.ts +12 -0
  400. package/five/model/loaders/b3dm.d.ts +9 -0
  401. package/five/model/loaders/dome.d.ts +22 -0
  402. package/five/model/loaders/domez.d.ts +11 -0
  403. package/five/model/loaders/fbx.d.ts +8 -0
  404. package/five/model/loaders/glTF-helpers/extensions/CESIUM_RTC.d.ts +9 -0
  405. package/five/model/loaders/glTF-helpers/extensions/EXT_meshopt_compression.d.ts +8 -0
  406. package/five/model/loaders/glTF-helpers/extensions/EXT_texture_webp.d.ts +11 -0
  407. package/five/model/loaders/glTF-helpers/extensions/KHR_animation_pointer.d.ts +6 -0
  408. package/five/model/loaders/glTF-helpers/extensions/KHR_binary_glTF.d.ts +25 -0
  409. package/five/model/loaders/glTF-helpers/extensions/KHR_draco_mesh_compression.d.ts +11 -0
  410. package/five/model/loaders/glTF-helpers/extensions/KHR_gaussian_splatting_compression_spz.d.ts +9 -0
  411. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_clearcoat.d.ts +10 -0
  412. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_emissive_strength.d.ts +10 -0
  413. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_sheen.d.ts +10 -0
  414. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_transmission.d.ts +10 -0
  415. package/five/model/loaders/glTF-helpers/extensions/KHR_materials_unlit.d.ts +10 -0
  416. package/five/model/loaders/glTF-helpers/extensions/KHR_mesh_quantization.d.ts +6 -0
  417. package/five/model/loaders/glTF-helpers/extensions/KHR_node_visibility.d.ts +10 -0
  418. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_basisu.d.ts +9 -0
  419. package/five/model/loaders/glTF-helpers/extensions/KHR_texture_transform.d.ts +10 -0
  420. package/five/model/loaders/glTF-helpers/extensions/REALSEE_materials_lightmap.d.ts +7 -0
  421. package/five/model/loaders/glTF-helpers/extensions/base.d.ts +24 -0
  422. package/five/model/loaders/glTF-helpers/glTF.d.ts +713 -0
  423. package/five/model/loaders/glTF-helpers/index.d.ts +47 -0
  424. package/five/model/loaders/glTF-helpers/parser.d.ts +114 -0
  425. package/five/model/loaders/glTF-helpers/type.d.ts +14 -0
  426. package/five/model/loaders/gltf.d.ts +10 -0
  427. package/five/model/loaders/obj.d.ts +9 -0
  428. package/five/model/loaders/pbm.d.ts +26 -0
  429. package/five/model/loaders/ply.d.ts +24 -0
  430. package/five/model/loaders/pnts.d.ts +8 -0
  431. package/five/model/loaders/protobuf/dome.d.ts +540 -0
  432. package/five/model/loaders/protobuf/pbm.d.ts +203 -0
  433. package/five/model/loaders/shared.d.ts +16 -0
  434. package/five/model/loaders/splat.d.ts +8 -0
  435. package/five/model/loaders/spz.d.ts +14 -0
  436. package/five/model/loaders/tile3d-helpers/feature-table.d.ts +15 -0
  437. package/five/model/loaders/tile3d-helpers/gl-type.d.ts +20 -0
  438. package/five/model/loaders/tile3d-helpers/parse-gltf-array-buffer.d.ts +2 -0
  439. package/five/model/loaders/tile3d-helpers/parse-header.d.ts +2 -0
  440. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.d.ts +2 -0
  441. package/five/model/loaders/tile3d-helpers/parse-point-cloud-attributes.worker.d.ts +6 -0
  442. package/five/model/loaders/tile3d-helpers/parse-table.d.ts +3 -0
  443. package/five/model/loaders/tile3d-helpers/tile3d-type.d.ts +35 -0
  444. package/five/model/loaders/x3p.d.ts +22 -0
  445. package/five/model/materials/pbmMaterial.d.ts +87 -0
  446. package/five/model/materials/pbmMeshMaterial.d.ts +124 -0
  447. package/five/model/materials/pbmPointCloudMaterial.d.ts +72 -0
  448. package/five/model/model-scene.d.ts +172 -0
  449. package/five/model/model.d.ts +209 -0
  450. package/five/model/objects/pbmContainer.d.ts +28 -0
  451. package/five/model/objects/pbmGSObject.d.ts +40 -0
  452. package/five/model/objects/pbmGSRenderMesh.d.ts +32 -0
  453. package/five/model/objects/pbmGroup.d.ts +8 -0
  454. package/five/model/objects/pbmMesh.d.ts +10 -0
  455. package/five/model/objects/pbmPointCloud.d.ts +7 -0
  456. package/five/model/parameter.d.ts +136 -0
  457. package/five/model/shaders/pbm_gaussian_splatting/fragment.d.ts +2 -0
  458. package/five/model/shaders/pbm_gaussian_splatting/vertex.d.ts +2 -0
  459. package/five/model/shaders/pbm_mesh_basic/fragment.d.ts +2 -0
  460. package/five/model/shaders/pbm_mesh_basic/vertex.d.ts +2 -0
  461. package/five/model/shaders/pbm_mesh_none/fragment.d.ts +2 -0
  462. package/five/model/shaders/pbm_mesh_none/vertex.d.ts +2 -0
  463. package/five/model/shaders/pbm_mesh_phong/fragment.d.ts +2 -0
  464. package/five/model/shaders/pbm_mesh_phong/vertex.d.ts +2 -0
  465. package/five/model/shaders/pbm_mesh_standard/fragment.d.ts +2 -0
  466. package/five/model/shaders/pbm_mesh_standard/vertex.d.ts +2 -0
  467. package/five/model/shaders/pbm_pointcloud/fragment.d.ts +2 -0
  468. package/five/model/shaders/pbm_pointcloud/vertex.d.ts +2 -0
  469. package/five/model/tile3d/header.d.ts +88 -0
  470. package/five/model/tile3d/index.d.ts +214 -0
  471. package/five/model/tile3d/tile-cache.d.ts +18 -0
  472. package/five/model/tile3d/tile-content.d.ts +10 -0
  473. package/five/model/tile3d/tile-node.d.ts +24 -0
  474. package/five/model/tile3d/tile-request-scheduler.d.ts +17 -0
  475. package/five/model/tile3d/tile.d.ts +79 -0
  476. package/five/model/tile3d/tileset-base-traverser.d.ts +59 -0
  477. package/five/model/tile3d/tileset-most-detail-traverser.d.ts +14 -0
  478. package/five/model/tile3d/tileset-normal-traverser.d.ts +15 -0
  479. package/five/model/tile3d/tileset-skip-traverser.d.ts +60 -0
  480. package/five/model/tile3d/tileset.d.ts +69 -0
  481. package/five/model/tile3d/trajectory-content.d.ts +9 -0
  482. package/five/model/tile3d/trajectory-node.d.ts +15 -0
  483. package/five/model/tile3d/trajectory.d.ts +30 -0
  484. package/five/model/tile3d/types.d.ts +33 -0
  485. package/five/model/view-layer.d.ts +20 -0
  486. package/five/renderer/five-renderer.d.ts +17 -0
  487. package/five/renderer/index.d.ts +3 -0
  488. package/five/renderer/postprocessing/composer.d.ts +37 -0
  489. package/five/renderer/postprocessing/index.d.ts +7 -0
  490. package/five/renderer/postprocessing/passes/adaptive-luminance-pass.d.ts +15 -0
  491. package/five/renderer/postprocessing/passes/eye-dome-lighting-pass.d.ts +14 -0
  492. package/five/renderer/postprocessing/passes/flowing-light-2d-pass.d.ts +36 -0
  493. package/five/renderer/postprocessing/passes/flowing-light-3d-pass.d.ts +36 -0
  494. package/five/renderer/postprocessing/passes/gaussian-blur-pass.d.ts +12 -0
  495. package/five/renderer/postprocessing/passes/pass.d.ts +38 -0
  496. package/five/renderer/scene-renderers/point-cloud-high-quality-scene-renderer.d.ts +11 -0
  497. package/five/renderer/scene-renderers/scene-renderer.d.ts +9 -0
  498. package/five/renderer/scene-renderers/ssaa-scene-renderer.d.ts +15 -0
  499. package/five/renderer/tools/full-screen-quad.d.ts +15 -0
  500. package/five/renderer/tools/render-full-screen-depth.d.ts +2 -0
  501. package/five/renderer/tools/render-full-screen.d.ts +2 -0
  502. package/five/texture/imageBitmap.d.ts +13 -0
  503. package/five/texture/initTexture.d.ts +3 -0
  504. package/five/texture/loader.d.ts +39 -0
  505. package/five/thirdparty/fflate.d.ts +1407 -0
  506. package/five/thirdparty/hammer.d.ts +259 -0
  507. package/five/thirdparty/jsrsasign.d.ts +768 -0
  508. package/five/thirdparty/meshopt_decoder.d.ts +15 -0
  509. package/five/three-version-check.d.ts +1 -0
  510. package/five/types/addableObject.d.ts +12 -0
  511. package/five/types/cube.d.ts +1 -0
  512. package/five/types/gestureInput.d.ts +24 -0
  513. package/five/types/imageOptions.d.ts +20 -0
  514. package/five/types/intersectMeshInterface.d.ts +8 -0
  515. package/five/types/movePanoEffect.d.ts +13 -0
  516. package/five/types/movePanoOptions.d.ts +35 -0
  517. package/five/types/panoCircleMeshInterface.d.ts +34 -0
  518. package/five/types/plugin.d.ts +25 -0
  519. package/five/types/pose.d.ts +17 -0
  520. package/five/types/state.d.ts +20 -0
  521. package/five/types/viewport.d.ts +22 -0
  522. package/five/utils/ajax.d.ts +66 -0
  523. package/five/utils/animationFrameLoop.d.ts +45 -0
  524. package/five/utils/array.d.ts +31 -0
  525. package/five/utils/asyncTaskQueue.d.ts +8 -0
  526. package/five/utils/bufferGeometry.d.ts +33 -0
  527. package/five/utils/calculateProgress.d.ts +39 -0
  528. package/five/utils/calculateThreeMouse.d.ts +13 -0
  529. package/five/utils/canplayVideo.d.ts +2 -0
  530. package/five/utils/clamp.d.ts +2 -0
  531. package/five/utils/clock.d.ts +17 -0
  532. package/five/utils/createSymbol.d.ts +5 -0
  533. package/five/utils/decodeText.d.ts +2 -0
  534. package/five/utils/deepEqual.d.ts +2 -0
  535. package/five/utils/deepFreeze.d.ts +2 -0
  536. package/five/utils/defineProperty.d.ts +9 -0
  537. package/five/utils/detector.d.ts +14 -0
  538. package/five/utils/distance.d.ts +10 -0
  539. package/five/utils/draco.d.ts +26 -0
  540. package/five/utils/easing.d.ts +63 -0
  541. package/five/utils/event.d.ts +149 -0
  542. package/five/utils/formatRad.d.ts +7 -0
  543. package/five/utils/imageSupport.d.ts +6 -0
  544. package/five/utils/imageURL.d.ts +42 -0
  545. package/five/utils/isEmptyObject.d.ts +2 -0
  546. package/five/utils/isNil.d.ts +6 -0
  547. package/five/utils/isNumber.d.ts +2 -0
  548. package/five/utils/isPowerOfTwo.d.ts +2 -0
  549. package/five/utils/isPromise.d.ts +2 -0
  550. package/five/utils/isSimilar.d.ts +6 -0
  551. package/five/utils/json.d.ts +7 -0
  552. package/five/utils/ktx2.d.ts +30 -0
  553. package/five/utils/lzma/index.d.ts +2 -0
  554. package/five/utils/lzma/lzma.d.ts +3 -0
  555. package/five/utils/lzma/lzmaWASM.d.ts +2 -0
  556. package/five/utils/lzma/lzmaWorker.d.ts +14 -0
  557. package/five/utils/memoryUsage.d.ts +29 -0
  558. package/five/utils/motion.d.ts +38 -0
  559. package/five/utils/noop.d.ts +6 -0
  560. package/five/utils/now.d.ts +7 -0
  561. package/five/utils/pano.d.ts +9 -0
  562. package/five/utils/pick.d.ts +3 -0
  563. package/five/utils/poseUtils.d.ts +5 -0
  564. package/five/utils/renderCubeTextureToCubeRenderTarget.d.ts +3 -0
  565. package/five/utils/renderDepth.d.ts +2 -0
  566. package/five/utils/renderTexturesToCubeRenderTarget.d.ts +10 -0
  567. package/five/utils/requestPermission.d.ts +3 -0
  568. package/five/utils/shaderContentFix.d.ts +7 -0
  569. package/five/utils/shaderMaterial.d.ts +20 -0
  570. package/five/utils/stateUtils.d.ts +5 -0
  571. package/five/utils/string-pattern.d.ts +8 -0
  572. package/five/utils/subscribe.d.ts +67 -0
  573. package/five/utils/tileCube.d.ts +19 -0
  574. package/five/utils/toFastProperties.d.ts +1 -0
  575. package/five/utils/typedCache.d.ts +10 -0
  576. package/five/utils/uniform.d.ts +15 -0
  577. package/five/utils/url.d.ts +35 -0
  578. package/five/utils/uuid.d.ts +5 -0
  579. package/five/utils/values.d.ts +2 -0
  580. package/five/utils/vectorCoordinates.d.ts +29 -0
  581. package/five/utils/volume.d.ts +111 -0
  582. package/five/utils/webglError.d.ts +7 -0
  583. package/five/utils/worker.d.ts +26 -0
  584. package/five/webxr/XRControllerModelFactory.d.ts +28 -0
  585. package/five/webxr/motionHelper.d.ts +68 -0
  586. package/five/webxr/xrButton.d.ts +4 -0
  587. package/five/webxr/xrController.d.ts +24 -0
  588. package/five/webxr/xrManager.d.ts +84 -0
  589. package/five/work/_ALLOW_HOST.d.ts +2 -0
  590. package/five/work/index.d.ts +6 -0
  591. package/five/work/keychain.d.ts +5 -0
  592. package/five/work/looseWorkType.d.ts +121 -0
  593. package/five/work/verify.d.ts +7 -0
  594. package/five/work/work.d.ts +236 -0
  595. package/five/work/workFetcher.d.ts +4 -0
  596. package/five/work/workJson.d.ts +3 -0
  597. package/five/work/workJsonType.d.ts +73 -0
  598. package/five/work/workObserverUtils.d.ts +36 -0
  599. package/five/work/workParser.d.ts +6 -0
  600. package/five/work/workResolvedObserver.d.ts +12 -0
  601. package/five/work/workVerify.d.ts +2 -0
  602. package/five/work/works.d.ts +10 -0
  603. package/gltf-loader/gltf-object.d.ts +17 -0
  604. package/gltf-loader/index.d.ts +60 -160
  605. package/gltf-loader/index.js +3 -3
  606. package/gltf-loader/index.mjs +3 -3
  607. package/gltf-loader/thirdparty/DDSLoader.d.ts +23 -0
  608. package/gltf-loader/thirdparty/DRACOLoader.d.ts +18 -0
  609. package/gltf-loader/thirdparty/GLTFLoader.d.ts +59 -0
  610. package/line/circle_png.d.ts +1 -0
  611. package/line/index.d.ts +19 -69
  612. package/line/index.js +3 -3
  613. package/line/index.mjs +3 -3
  614. package/line/utils/Line2.d.ts +7 -0
  615. package/line/utils/LineGeometry.d.ts +10 -0
  616. package/line/utils/LineMaterial.d.ts +20 -0
  617. package/line/utils/LineSegments2.d.ts +11 -0
  618. package/line/utils/LineSegmentsGeometry.d.ts +15 -0
  619. package/llms.txt +65 -0
  620. package/package.json +10 -1
  621. package/plugins/BackgroundPlugin/Controller.d.ts +20 -0
  622. package/plugins/BackgroundPlugin/index.d.ts +5 -0
  623. package/plugins/BackgroundPlugin/typings.d.ts +44 -0
  624. package/plugins/BasePlugin/index.d.ts +119 -0
  625. package/plugins/DynamicPathLinePlugin/Controller.d.ts +167 -0
  626. package/plugins/DynamicPathLinePlugin/index.d.ts +5 -0
  627. package/plugins/DynamicPathLinePlugin/line2/Line2.d.ts +7 -0
  628. package/plugins/DynamicPathLinePlugin/line2/LineGeometry.d.ts +10 -0
  629. package/plugins/DynamicPathLinePlugin/line2/LineMaterial.d.ts +17 -0
  630. package/plugins/DynamicPathLinePlugin/line2/LineSegments2.d.ts +11 -0
  631. package/plugins/DynamicPathLinePlugin/line2/LineSegmentsGeometry.d.ts +15 -0
  632. package/plugins/DynamicPathLinePlugin/typing.d.ts +129 -0
  633. package/plugins/DynamicPathLinePlugin/typings.d.ts +72 -0
  634. package/plugins/ItemMaskPlugin/Controller.d.ts +48 -0
  635. package/plugins/ItemMaskPlugin/index.d.ts +5 -0
  636. package/plugins/ItemMaskPlugin/typing.d.ts +58 -0
  637. package/plugins/OrientationPlugin/Controller.d.ts +82 -0
  638. package/plugins/OrientationPlugin/RoundedBoxGeometry.d.ts +11 -0
  639. package/plugins/OrientationPlugin/index.d.ts +6 -0
  640. package/plugins/OrientationPlugin/typing.d.ts +25 -0
  641. package/plugins/PanoAnimePlugin/Controller.d.ts +46 -0
  642. package/plugins/PanoAnimePlugin/index.d.ts +5 -0
  643. package/plugins/PanoAnimePlugin/typing.d.ts +37 -0
  644. package/plugins/PluginTemplate/Controller.d.ts +27 -0
  645. package/plugins/PluginTemplate/index.d.ts +5 -0
  646. package/plugins/PluginTemplate/typing.d.ts +21 -0
  647. package/plugins/TrajectoryPlugin/Controller.d.ts +85 -0
  648. package/plugins/TrajectoryPlugin/index.d.ts +6 -0
  649. package/plugins/TrajectoryPlugin/typing.d.ts +25 -0
  650. package/plugins/index.d.ts +9 -1078
  651. package/plugins/index.js +17 -17
  652. package/plugins/index.mjs +1518 -1370
  653. package/plugins/thirdParty/CSS3DRenderer.d.ts +32 -0
  654. package/plugins/thirdParty/OrbitControls.d.ts +78 -0
  655. package/plugins/utils/absoluteUrl.d.ts +5 -0
  656. package/plugins/utils/clamp.d.ts +2 -0
  657. package/plugins/utils/loadImage.d.ts +1 -0
  658. package/plugins/utils/motion.d.ts +38 -0
  659. package/plugins/utils/now.d.ts +6 -0
  660. package/plugins/utils/uuid.d.ts +5 -0
  661. package/react/canvas.d.ts +19 -0
  662. package/react/context.d.ts +11 -0
  663. package/react/createProvider.d.ts +95 -0
  664. package/react/createStore.d.ts +144 -0
  665. package/react/hooks/unsafe__useFiveInstance.d.ts +9 -0
  666. package/react/hooks/useFiveAction.d.ts +147 -0
  667. package/react/hooks/useFiveCameraDirection.d.ts +7 -0
  668. package/react/hooks/useFiveCameraRaycaster.d.ts +7 -0
  669. package/react/hooks/useFiveCurrentObserver.d.ts +11 -0
  670. package/react/hooks/useFiveCurrentState.d.ts +15 -0
  671. package/react/hooks/useFiveEventCallback.d.ts +12 -0
  672. package/react/hooks/useFiveFloor.d.ts +15 -0
  673. package/react/hooks/useFiveHelper.d.ts +14 -0
  674. package/react/hooks/useFiveModelBounding.d.ts +5 -0
  675. package/react/hooks/useFiveModelEffect.d.ts +14 -0
  676. package/react/hooks/useFiveModelIntersectRaycaster.d.ts +22 -0
  677. package/react/hooks/useFiveModelReadyState.d.ts +8 -0
  678. package/react/hooks/useFiveProject2d.d.ts +20 -0
  679. package/react/hooks/useFiveSceneEffect.d.ts +21 -0
  680. package/react/hooks/useFiveState.d.ts +6 -0
  681. package/react/hooks/useFiveWork.d.ts +29 -0
  682. package/react/index.d.ts +24 -830
  683. package/react/index.js +2 -2
  684. package/react/index.mjs +2 -2
  685. package/react/rendererPool.d.ts +7 -0
  686. package/react/withFive.d.ts +213 -0
  687. package/shader-lib/EvenessPlane/index.d.ts +10 -0
  688. package/shader-lib/PointCloudExpand/index.d.ts +59 -0
  689. package/shader-lib/PolygonCuter/index.d.ts +52 -0
  690. package/shader-lib/PolygonCuter/worker.d.ts +14 -0
  691. package/shader-lib/ShineModel/index.d.ts +7 -0
  692. package/shader-lib/SweepModel/index.d.ts +7 -0
  693. package/shader-lib/index.d.ts +5 -86
  694. package/shader-lib/index.js +2 -2
  695. package/shader-lib/index.mjs +2 -2
  696. package/sticker/geometry.d.ts +3 -0
  697. package/sticker/index.d.ts +68 -71
  698. package/sticker/index.js +3 -3
  699. package/sticker/index.mjs +3 -3
  700. package/umd/five-gltf-loader.js +3 -3
  701. package/umd/five-line.js +3 -3
  702. package/umd/five-plugins.js +16 -16
  703. package/umd/five-react.js +2 -2
  704. package/umd/five-shader-lib.js +2 -2
  705. package/umd/five-sticker.js +3 -3
  706. package/umd/five-vfx.js +2 -2
  707. package/umd/five-vue.js +2 -2
  708. package/umd/five.js +605 -92
  709. package/vfx/airflow/airflow.d.ts +18 -0
  710. package/vfx/airflow/fragment-shader.d.ts +2 -0
  711. package/vfx/airflow/vertex-shader.d.ts +2 -0
  712. package/vfx/common/scale-shader.d.ts +2 -0
  713. package/vfx/common/simplex-noise-shader.d.ts +2 -0
  714. package/vfx/frame/fragment-shader.d.ts +2 -0
  715. package/vfx/frame/frame.d.ts +22 -0
  716. package/vfx/frame/vertex-shader.d.ts +2 -0
  717. package/vfx/index.d.ts +7 -363
  718. package/vfx/index.js +2 -2
  719. package/vfx/index.mjs +2 -2
  720. package/vfx/particle/fragment-shader.d.ts +2 -0
  721. package/vfx/particle/instance.d.ts +36 -0
  722. package/vfx/particle/particle.d.ts +205 -0
  723. package/vfx/particle/utils.d.ts +11 -0
  724. package/vfx/particle/vertex-shader.d.ts +2 -0
  725. package/vfx/particle-gpu/fragment-shader.d.ts +2 -0
  726. package/vfx/particle-gpu/instance.d.ts +36 -0
  727. package/vfx/particle-gpu/particle.d.ts +95 -0
  728. package/vfx/particle-gpu/utils.d.ts +11 -0
  729. package/vfx/particle-gpu/vertex-shader.d.ts +2 -0
  730. package/vfx/spotLight/fragment-shader.d.ts +2 -0
  731. package/vfx/spotLight/spotLight.d.ts +15 -0
  732. package/vfx/spotLight/vertex-shader.d.ts +2 -0
  733. package/vue/context.d.ts +7 -0
  734. package/vue/hooks/FiveCanvas.d.ts +36 -0
  735. package/vue/hooks/FiveProvider.d.ts +35 -0
  736. package/vue/hooks/unsafe__useFiveInject.d.ts +9 -0
  737. package/vue/hooks/useFiveAction.d.ts +178 -0
  738. package/vue/hooks/useFiveCameraDirection.d.ts +8 -0
  739. package/vue/hooks/useFiveCameraRaycaster.d.ts +8 -0
  740. package/vue/hooks/useFiveCurrentObserver.d.ts +12 -0
  741. package/vue/hooks/useFiveCurrentState.d.ts +16 -0
  742. package/vue/hooks/useFiveEventCallback.d.ts +11 -0
  743. package/vue/hooks/useFiveFloor.d.ts +16 -0
  744. package/vue/hooks/useFiveHelper.d.ts +15 -0
  745. package/vue/hooks/useFiveModel.d.ts +7 -0
  746. package/vue/hooks/useFiveModelBounding.d.ts +7 -0
  747. package/vue/hooks/useFiveModelIntersectRaycaster.d.ts +23 -0
  748. package/vue/hooks/useFiveModelReadyState.d.ts +9 -0
  749. package/vue/hooks/useFiveProject2d.d.ts +26 -0
  750. package/vue/hooks/useFiveScene.d.ts +6 -0
  751. package/vue/hooks/useFiveState.d.ts +16 -0
  752. package/vue/hooks/useFiveWork.d.ts +30 -0
  753. package/vue/index.d.ts +23 -467
  754. package/vue/index.js +2 -2
  755. package/vue/index.mjs +2 -2
  756. package/vue/rendererPool.d.ts +10 -0
  757. package/work-downloader/components/model-3d-tile.d.ts +2 -0
  758. package/work-downloader/components/model.d.ts +3 -0
  759. package/work-downloader/components/observer.d.ts +7 -0
  760. package/work-downloader/download.d.ts +16 -0
  761. package/work-downloader/index.d.ts +2 -33
  762. package/work-downloader/index.js +2 -2
  763. package/work-downloader/index.mjs +2 -2
  764. package/work-downloader/type.d.ts +28 -0
  765. package/work-downloader/utils/download-to-file.d.ts +1 -0
  766. package/work-downloader/utils/image-processing.d.ts +7 -0
  767. package/work-downloader/utils/join-url.d.ts +2 -0
  768. package/work-downloader/utils/log.d.ts +1 -0
  769. package/work-downloader/utils/relative-url.d.ts +1 -0
  770. package/docs/documents/coordinate.html +0 -9
  771. package/docs/documents/five.FivePlugin.plugins.html +0 -77
  772. package/docs/documents/five.Pose.coordinate.html +0 -9
  773. package/docs/documents/plugins.html +0 -77
  774. package/docs/documents/react-component.html +0 -32
  775. package/docs/media/coordinate.jpg +0 -0
package/docs/documents/release_notes_6.6.html ADDED
@@ -0,0 +1,79 @@
1
+ <!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>release_notes/6.6 | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="" aria-current="page">release_notes/6.6</a></li></ul></div><div class="tsd-panel tsd-typography"><h1 id="release-note-66x" class="tsd-anchor-link">Release Note 6.6.x<a href="#release-note-66x" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h1>
2
+ <blockquote>
3
+ <p>6.6.x 版本发布日志</p>
4
+ </blockquote>
5
+ <pre><code class="shell"><span class="hl-5">npm</span><span class="hl-1"> </span><span class="hl-9">install</span><span class="hl-1"> </span><span class="hl-9">@realsee/five@6.6</span>
6
+ </code><button type="button">Copy</button></pre>
7
+
8
+ <h2 id="依赖升级" class="tsd-anchor-link">依赖升级<a href="#依赖升级" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
9
+ <blockquote>
10
+ <p>6.6.0 版本对开发环境依赖进行了较大幅度的升级，以支持更新的特性和更好的开发体验。</p>
11
+ </blockquote>
12
+ <ul>
13
+ <li><strong>Node.js</strong>: 升级至 v20。</li>
14
+ <li><strong>TypeScript</strong>: 升级至 v5.9.2 (tslib -&gt; 2.8.1)。</li>
15
+ <li><strong>Vite</strong>: 升级至 v7.1.2。</li>
16
+ <li><strong>Protobufjs</strong>: 升级至 v7.5.3。</li>
17
+ </ul>
18
+ <h2 id="核心性能优化" class="tsd-anchor-link">核心性能优化<a href="#核心性能优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
19
+ <h3 id="内存泄漏修复" class="tsd-anchor-link">内存泄漏修复<a href="#内存泄漏修复" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
20
+ <p>针对大模型加载和销毁过程中的内存占用进行了多轮优化：</p>
21
+ <ul>
22
+ <li><strong>实例销毁</strong>: 修复了 <code>five.dispose()</code> 时，部分 WebGL 资源（纹理、几何体）及事件监听器未被完全释放的问题。</li>
23
+ <li><strong>加载过程</strong>: 优化了模型下载和解析过程中临时对象的生命周期管理，解决了材质解析可能导致的内存驻留。</li>
24
+ <li><strong>瓦片加载</strong>: 修复了全景图瓦片在特定网络环境下取消请求时可能导致的内存泄漏。</li>
25
+ </ul>
26
+ <h3 id="射线检测-raycaster-性能提升" class="tsd-anchor-link">射线检测 (Raycaster) 性能提升<a href="#射线检测-raycaster-性能提升" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
27
+ <p>优化了 BVH (Bounding Volume Hierarchy) 射线碰撞检测逻辑，引入了“首个命中即停止”的机制，显著提升了点击交互性能。</p>
28
+ <ul>
29
+ <li><strong>firstHitOnly</strong>: 在 <code>THREE.Raycaster</code> 上扩展了 <code>firstHitOnly</code> 属性。当设置为 <code>true</code> 时，BVH 遍历算法会在找到第一个满足条件的交点后，利用该交点的距离对后续搜索进行剪枝（Pruning），避免遍历所有可能的交点。这对于点击拾取（Picking）操作有极大的性能提升。</li>
30
+ </ul>
31
+ <pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">raycaster</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Raycaster</span><span class="hl-1">();</span><br/><span class="hl-8">// 开启首个命中优化</span><br/><span class="hl-6">raycaster</span><span class="hl-1">.</span><span class="hl-6">firstHitOnly</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">intersects</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-5">intersectRaycaster</span><span class="hl-1">(</span><span class="hl-6">raycaster</span><span class="hl-1">);</span>
32
+ </code><button type="button">Copy</button></pre>
33
+
34
+ <ul>
35
+ <li><strong>floorIndex</strong>: 支持在射线检测时通过 filter 机制快速筛选楼层（需配合上层逻辑）。</li>
36
+ </ul>
37
+ <h3 id="work-数据结构优化" class="tsd-anchor-link">Work 数据结构优化<a href="#work-数据结构优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
38
+ <ul>
39
+ <li><strong>静态化存储</strong>: 重构了 <code>Work</code> 数据解析逻辑 (<code>workParser</code>)。使用 <code>Object.defineProperty</code> 和 <code>Object.freeze</code> 将解析后的 Work 数据及其子对象（如 <code>Observer</code>, <code>Model</code>）定义为不可变对象。这有助于 V8 引擎进行 Hidden Class 优化，减少内存占用并提升属性访问速度。</li>
40
+ <li><strong>解析优化</strong>: 增强了 <code>work.parse</code> 的容错能力，优化了对异常数据的处理逻辑。</li>
41
+ <li><strong>字段补充</strong>: <code>work.observers</code> 中补充了 <code>panoId</code> 字段，修复了 <code>derivedIdStr</code> 的生成逻辑。</li>
42
+ </ul>
43
+ <h2 id="新增特性" class="tsd-anchor-link">新增特性<a href="#新增特性" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
44
+ <h3 id="imagebitmap-支持" class="tsd-anchor-link">ImageBitmap 支持<a href="#imagebitmap-支持" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
45
+ <p>支持使用浏览器原生的 <code>ImageBitmap</code> API 替代传统的 <code>HTMLImageElement</code> 进行纹理加载。<code>ImageBitmap</code> 的解码过程可以在后台线程进行，避免了解码大图时阻塞主线程导致的掉帧现象。</p>
46
+ <pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 开启 Native ImageBitmap 支持 (全局配置)</span><br/><span class="hl-6">Five</span><span class="hl-1">.</span><span class="hl-6">useNativeImageBitmap</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 之后创建的 Five 实例将自动应用此配置</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({ ... });</span>
47
+ </code><button type="button">Copy</button></pre>
48
+
49
+ <h3 id="图片-exif-旋转支持" class="tsd-anchor-link">图片 Exif 旋转支持<a href="#图片-exif-旋转支持" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
50
+ <p><code>imageOptions</code> 新增 <code>forceUseExifOrientation</code> 参数。针对部分未在服务端处理旋转的图片，该参数可强制读取并应用图片 Exif 中的 Orientation 信息，确保渲染方向正确。</p>
51
+ <pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1"> </span><span class="hl-6">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-6">forceUseExifOrientation:</span><span class="hl-1"> </span><span class="hl-3">true</span><br/><span class="hl-1"> }</span><br/><span class="hl-1">});</span>
52
+ </code><button type="button">Copy</button></pre>
53
+
54
+ <h3 id="航拍全景图优化" class="tsd-anchor-link">航拍全景图优化<a href="#航拍全景图优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
55
+ <p>优化了航拍全景图（Aerial Panorama）的交互体验，改进了视角限制和过渡效果，使其浏览更加自然顺畅。</p>
56
+ <h2 id="修复与改进" class="tsd-anchor-link">修复与改进<a href="#修复与改进" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
57
+ <h3 id="兼容性修复" class="tsd-anchor-link">兼容性修复<a href="#兼容性修复" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
58
+ <ul>
59
+ <li><strong>Safari</strong>:
60
+ <ul>
61
+ <li>修复了 BVH 碰撞检测在 Safari 下可能出现的精度不一致问题。</li>
62
+ <li>禁用 Safari 下的 <code>image.decode</code> 调用，修复了由此导致的 WebGL <code>updateTexture</code> 失败问题。</li>
63
+ </ul>
64
+ </li>
65
+ <li><strong>微信</strong>: 修复了点云（PointCloud）在微信查看器中因 Shader 兼容性问题导致的显示错误。</li>
66
+ <li><strong>High-DPI</strong>: 修复了当屏幕分辨率导致计算出的瓦片尺寸超过 WebGL 材质尺寸上限（<code>MAX_TEXTURE_SIZE</code>）时，瓦片渲染黑屏的问题。</li>
67
+ </ul>
68
+ <h3 id="逻辑修复" class="tsd-anchor-link">逻辑修复<a href="#逻辑修复" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
69
+ <ul>
70
+ <li><strong>moveToPano</strong>: 修复了当目标点位即为当前点位时，<code>moveToPano</code> 命令可能被忽略的问题。</li>
71
+ <li><strong>交互逻辑</strong>:
72
+ <ul>
73
+ <li>修复了 <code>panorama</code> 模式下点击走点可能出现回退的问题。</li>
74
+ <li>修复了 <code>model</code> 模式下 <code>onTapGesture</code> 回调中获取的 raycaster 状态不正确的问题。</li>
75
+ </ul>
76
+ </li>
77
+ <li><strong>渲染显示</strong>: 修复了全景图瓦片在正交相机（OrthographicCamera）下的显示错误。</li>
78
+ </ul>
79
+ </div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#release-note-66x"><span>Release <wbr/>Note 6.6.x</span></a><ul><li><a href="#依赖升级"><span>依赖升级</span></a></li><li><a href="#核心性能优化"><span>核心性能优化</span></a></li><li><ul><li><a href="#内存泄漏修复"><span>内存泄漏修复</span></a></li><li><a href="#射线检测-raycaster-性能提升"><span>射线检测 (<wbr/>Raycaster) 性能提升</span></a></li><li><a href="#work-数据结构优化"><span>Work 数据结构优化</span></a></li></ul></li><li><a href="#新增特性"><span>新增特性</span></a></li><li><ul><li><a href="#imagebitmap-支持"><span>Image<wbr/>Bitmap 支持</span></a></li><li><a href="#图片-exif-旋转支持"><span>图片 <wbr/>Exif 旋转支持</span></a></li><li><a href="#航拍全景图优化"><span>航拍全景图优化</span></a></li></ul></li><li><a href="#修复与改进"><span>修复与改进</span></a></li><li><ul><li><a href="#兼容性修复"><span>兼容性修复</span></a></li><li><a href="#逻辑修复"><span>逻辑修复</span></a></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
package/docs/documents/release_notes_6.7.html ADDED
@@ -0,0 +1,209 @@
1
+ <!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>release_notes/6.7 | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="" aria-current="page">release_notes/6.7</a></li></ul></div><div class="tsd-panel tsd-typography"><h1 id="release-note-67x" class="tsd-anchor-link">Release Note 6.7.x<a href="#release-note-67x" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h1>
2
+ <blockquote>
3
+ <p>6.7.x 版本发布日志</p>
4
+ </blockquote>
5
+ <pre><code class="shell"><span class="hl-5">npm</span><span class="hl-1"> </span><span class="hl-9">install</span><span class="hl-1"> </span><span class="hl-9">@realsee/five@6.7</span>
6
+ </code><button type="button">Copy</button></pre>
7
+
8
+ <h2 id="fivelaod-的多-work-的非阻塞性加载" class="tsd-anchor-link">five.laod 的多 Work 的非阻塞性加载<a href="#fivelaod-的多-work-的非阻塞性加载" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
9
+ <blockquote>
10
+ <p><code>five.load</code> 时，现在可选择追加或者替换。
11
+ 并且在切换过程中，可以不再发生切换/锁定视角等妨碍用户持续操作的行为。
12
+ 这方面的改动只要适用于多项目下，项目追加，分批次加载的情况。</p>
13
+ </blockquote>
14
+ <h3 id="使用-在控制-替换--追加项目" class="tsd-anchor-link">使用 <code>FiveLoadOptions.mode</code> 在控制 替换 / 追加项目<a href="#使用-在控制-替换--追加项目" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
15
+ <pre><code class="ts"><span class="hl-8">// 替换项目</span><br/><span class="hl-8">// mode: &#39;replace&#39; 默认</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">([</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json1</span><span class="hl-1">), </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json2</span><span class="hl-1">)], </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;replace&#39;</span><span class="hl-1"> });</span><br/><br/><span class="hl-8">// 追加项目</span><br/><span class="hl-8">// mode: &#39;add&#39;</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json2</span><span class="hl-1">), </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;add&#39;</span><span class="hl-1"> });</span>
16
+ </code><button type="button">Copy</button></pre>
17
+
18
+ <p>注意事项：</p>
19
+ <ul>
20
+ <li>Work 的唯一标识依旧是 <code>workCode</code>。 同一场景下，不允许出现两个相同的 <code>workCode</code> 的 Work。如果出现会报错处理。</li>
21
+ <li>如果通过 <code>replace</code> 替换的 Work 的 <code>workCode</code> 和当前场景中有一样的（相当于替换一个一样的 Work），则会保留之前的 Work 的模型，直接挂在到新 Work 上，而不是重新加载。</li>
22
+ </ul>
23
+ <h3 id="重新定义-的行为" class="tsd-anchor-link">重新定义 <code>state=inherit</code> 的行为<a href="#重新定义-的行为" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
24
+ <pre><code class="ts"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1">), </span><span class="hl-9">&#39;inherit&#39;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;add&#39;</span><span class="hl-1"> });</span>
25
+ </code><button type="button">Copy</button></pre>
26
+
27
+ <p>当 <code>state=inherit</code> 时，在切换过程中，可以不再发生切换/锁定视角等妨碍用户持续操作的行为。</p>
28
+ <ul>
29
+ <li>在模型态：保持当前视角状态</li>
30
+ <li>在全景态：如果当前 work 存在则不改变。不存在切换到一个可用的全景点。</li>
31
+ </ul>
32
+ <h2 id="work-更加精简和灵活" class="tsd-anchor-link">work 更加精简和灵活<a href="#work-更加精简和灵活" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
33
+ <blockquote>
34
+ <p>针对大项目，对 work 的 json。做精简优化，减少网络传输时间。并且增加灵活性。</p>
35
+ </blockquote>
36
+ <h3 id="panoramapattern-模版" class="tsd-anchor-link">panorama.pattern 模版<a href="#panoramapattern-模版" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
37
+ <blockquote>
38
+ <p>通过模版的模式匹配减少重复内容。
39
+ panoram 中的 hash，index 等参数的重复度很高，对一样的内容可以通过这种方式减少文件长度。</p>
40
+ </blockquote>
41
+ <p>Before:</p>
42
+ <pre><code class="json"><span class="hl-9">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-11">465</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/0/0fd265355dbb94cb22fb930e52dd3c19/0_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">1</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/1/a6ca1991fc6bdb2dbd1a1003d9f62394/1_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">2</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/2/567f94406885bf06f5586d7972da2b5e/2_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">3</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/3/fa70f0f26594d3023a3824c9a92033da/3_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1"> ],</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> </span><span class="hl-15">...</span><br/><span class="hl-1"> ]</span><br/><span class="hl-1">}</span>
43
+ </code><button type="button">Copy</button></pre>
44
+
45
+ <p>After:</p>
46
+ <pre><code class="json"><span class="hl-9">&quot;panorama&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;count&quot;</span><span class="hl-1">: </span><span class="hl-11">465</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;pattern&quot;</span><span class="hl-1">: {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;up&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_u.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;down&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_d.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;left&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_l.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;right&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_r.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;front&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_f.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;back&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;images/cube_2048/{index}/{hash}/{index}_b.jpg&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;size_list&quot;</span><span class="hl-1">: [ </span><span class="hl-11">2048</span><span class="hl-1">, </span><span class="hl-11">4096</span><span class="hl-1"> ],</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;tiles&quot;</span><span class="hl-1">: [ </span><span class="hl-11">1</span><span class="hl-1">, </span><span class="hl-11">2</span><span class="hl-1">, </span><span class="hl-11">3</span><span class="hl-1">]</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;list&quot;</span><span class="hl-1">: [</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;0fd265355dbb94cb22fb930e52dd3c19&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117678&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;a6ca1991fc6bdb2dbd1a1003d9f62394&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117799&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">1</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;567f94406885bf06f5586d7972da2b5e&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735117912&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">2</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;hash&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;fa70f0f26594d3023a3824c9a92033da&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id&quot;</span><span class="hl-1">: </span><span class="hl-11">0</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;derived_id_str&quot;</span><span class="hl-1">: </span><span class="hl-9">&quot;auto3d-light-vEY8Zp4lPlkZ7R9K_1735118067&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-14">&quot;index&quot;</span><span class="hl-1">: </span><span class="hl-11">3</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> </span><span class="hl-15">...</span><br/><span class="hl-1"> ]</span><br/><span class="hl-1">}</span>
47
+ </code><button type="button">Copy</button></pre>
48
+
49
+ <h3 id="相对路径" class="tsd-anchor-link">相对路径<a href="#相对路径" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
50
+ <blockquote>
51
+ <p>在序列话 Work Json 时。资源的地址，均尝试存储为 <code>base_url</code> 的相对地址，减少存储的开销。</p>
52
+ </blockquote>
53
+ <ul>
54
+ <li>
55
+ <p>可以通过 <code>work.getURL</code> 获取到完整地址。</p>
56
+ <pre><code class="ts"><span class="hl-8">// 获取图片地址</span><br/><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-5">getURL</span><span class="hl-1">(</span><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-6">observers</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">].</span><span class="hl-6">image</span><span class="hl-1">.</span><span class="hl-6">left</span><span class="hl-1">);</span>
57
+ </code><button type="button">Copy</button></pre>
58
+
59
+ </li>
60
+ <li>
61
+ <p>可以通过修改 <code>work.baseURL=</code> 修改前缀。</p>
62
+ </li>
63
+ </ul>
64
+ <h3 id="一些字段的新增、废弃与兼容" class="tsd-anchor-link">一些字段的新增、废弃与兼容<a href="#一些字段的新增、废弃与兼容" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
65
+ <ul>
66
+ <li>现在 accessable_nodes 与 visible_nodes 不再有行为差异。visible_nodes 将废弃。</li>
67
+ <li>observers[].derived_id 的缺损值不再是 undefiend. 而是 0。</li>
68
+ <li>observers[].derived_id_str 的缺损值不再是 undefiend. 而是 空字符串。</li>
69
+ <li>优化 at3d / pbm 的 material_textures 的参数的各种兼容问题 以及 错误的警告信息。</li>
70
+ </ul>
71
+ <h3 id="model-支持-coordinate-以及-up_axis" class="tsd-anchor-link">model 支持 coordinate 以及 up_axis<a href="#model-支持-coordinate-以及-up_axis" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
72
+ <ul>
73
+ <li>model.coordinate 同 <code>tileeset.rootMeta.coordinate</code>。声明 <code>file_url</code> 的世界坐标。</li>
74
+ <li>model.up_axis 设置 <code>file_url</code> 模型的上方向, 仅针对 obj / ply 等自身没有上方向定义的模型格式。</li>
75
+ </ul>
76
+ <h3 id="tojson-方法" class="tsd-anchor-link">toJSON 方法<a href="#tojson-方法" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
77
+ <ul>
78
+ <li>通过 <code>work.toJSON()</code> 可以获取到当前序列化后的标准 Work Json。类型为 <code>WorkJson</code></li>
79
+ <li>该方法并不是返回当时 <code>parseWork</code> 时的 Json。 而是从 work 数据中序列化后的结果。</li>
80
+ <li>并不包含 <code>_signature</code> <code>certificate</code> 等字段。</li>
81
+ </ul>
82
+ <h3 id="work-downloader-的速度优化" class="tsd-anchor-link">work-downloader 的速度优化<a href="#work-downloader-的速度优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
83
+ <ul>
84
+ <li>优化 对于 avif 格式的 cube 图的处理的效率。</li>
85
+ <li>优化 全景图片瓦片的切割参数，该有尽有。</li>
86
+ <li>优化 图片的清晰度参数，目前均使用 95 最为图片质量。</li>
87
+ </ul>
88
+ <h2 id="模型优化材质展示-3d-tile，以及碰撞计算" class="tsd-anchor-link">模型优化材质展示, 3d-tile，以及碰撞计算<a href="#模型优化材质展示-3d-tile，以及碰撞计算" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
89
+ <h3 id="gltf-模型材质-与-动画" class="tsd-anchor-link">glTF 模型材质 与 动画<a href="#gltf-模型材质-与-动画" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
90
+ <blockquote>
91
+ <p>优化 Gltf PBR 材质渲染。
92
+ 对技术美术输出的模型，更准确的还原。</p>
93
+ </blockquote>
94
+ <ul>
95
+ <li>解决混合底色是白色的问题 从修改 CustomBlending 改为在着色器中处理，所以只有使用 PBM 的材质支持。three 默认材质不处理这个改动。</li>
96
+ <li>优化 gltf 骨骼绑定，对于骨骼关联大于 4 的情况，使用前 4 个权重大的骨骼，并归一化。并且考虑通过整形数组 normalize 的情况。</li>
97
+ <li>修改 gltf 中对 uv2 copy 的逻辑，添加当检测到有 occlusionTexture 材质时，如果没有 uv2 自动拷贝 uv -&gt; uv2。</li>
98
+ </ul>
99
+ <h3 id="gltf-预览工具" class="tsd-anchor-link">glTF 预览工具<a href="#gltf-预览工具" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
100
+ <p>地址： <a href="https://vradmin.lianjia.com/gltf/">https://vradmin.lianjia.com/gltf/</a></p>
101
+ <ul>
102
+ <li>支持加载 线上 / 本地文件。gltf / glb。</li>
103
+ <li>支持链接 单独的 gltf / glb 动画文件。</li>
104
+ <li>内置了 gltf 官方测试集。<a href="https://github.com/KhronosGroup/glTF-Sample-Assets/">https://github.com/KhronosGroup/glTF-Sample-Assets/</a></li>
105
+ <li>内置多个环境光照，以及上传自定义环境光照 (.exr)。</li>
106
+ </ul>
107
+ <h3 id="优化模型碰撞" class="tsd-anchor-link">优化模型碰撞<a href="#优化模型碰撞" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
108
+ <p>扩展 threejs 的 Raycaster。 支持多个自定义参数。</p>
109
+ <pre><code class="ts"><span class="hl-3">declare</span><span class="hl-1"> </span><span class="hl-3">module</span><span class="hl-1"> </span><span class="hl-9">&#39;three&#39;</span><span class="hl-1"> {</span><br/><br/><span class="hl-1"> </span><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Raycaster</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-8">/**</span><br/><span class="hl-8"> * 只捕获第一个交点</span><br/><span class="hl-8"> */</span><br/><span class="hl-1"> </span><span class="hl-6">firstHitOnly</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1"> </span><span class="hl-8">/**</span><br/><span class="hl-8"> * 对交点进行筛选</span><br/><span class="hl-8"> */</span><br/><span class="hl-1"> </span><span class="hl-5">hitFilter</span><span class="hl-1">?: (</span><span class="hl-6">intersect</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Intersection</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1"> </span><span class="hl-8">/**</span><br/><span class="hl-8"> * 作用楼层</span><br/><span class="hl-8"> */</span><br/><span class="hl-1"> </span><span class="hl-6">floorIndex</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1"> }</span><br/><br/><span class="hl-1">}</span>
110
+ </code><button type="button">Copy</button></pre>
111
+
112
+ <ul>
113
+ <li>firstHitOnly - 只捕获第一个交点。比获取全部取第一个更快获取到结果。</li>
114
+ <li>hitFilter - 过滤函数，可以根据逻辑否绝一些交点。配合 firstHitOnly 可以更加匹配业务需求。</li>
115
+ <li>floorIndex - 过滤楼层。默认为当前显示楼层，-1 为所有楼层。其他数字则定向对应的楼层。</li>
116
+ </ul>
117
+ <p>同时一些内部逻辑变化</p>
118
+ <ul>
119
+ <li>内置事件生成的 Raycaster。均设置 firstHitOnly = true。</li>
120
+ <li>交点获取，内置过滤掉了 模型裁剪 clippers 中的内容。</li>
121
+ </ul>
122
+ <h3 id="3d-tile-支持通过内存上限动态调整-maxscreenspaceerror。" class="tsd-anchor-link">3d-tile 支持通过内存上限动态调整 maxScreenSpaceError。<a href="#3d-tile-支持通过内存上限动态调整-maxscreenspaceerror。" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
123
+ <blockquote>
124
+ <p>目的是通过有限的内存，获取到最清晰的模型效果。</p>
125
+ </blockquote>
126
+ <pre><code class="ts"><span class="hl-8">// 设置内存最高缓存到 512 MB</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;maxMemoryUsage&#39;</span><span class="hl-1">, </span><span class="hl-11">512</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置 maxScreenSpaceError 到 32</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;maxScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-11">32</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置通过内存上限动态调整 maxScreenSpaceError</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">&#39;memoryAdjustedScreenSpaceError&#39;</span><span class="hl-1">, </span><span class="hl-3">true</span><span class="hl-1">);</span>
127
+ </code><button type="button">Copy</button></pre>
128
+
129
+ <p>当设置的 <code>maxScreenSpaceError</code> 已经全部加载完毕后，发现内存空间仍有剩余。则会尝试降低 <code>maxScreenSpaceError</code> 知道内存大体到达 <code>maxMemoryUsage</code> 设置的水平。</p>
130
+ <ul>
131
+ <li>如果设置的 <code>maxScreenSpaceError</code> 已经全部加载完毕后，内存已经大于 <code>maxMemoryUsage</code> 设置的水平则不会变化。</li>
132
+ <li>因为是动态尝试， 所以悲观情况下会出现在 <code>maxMemoryUsage</code> 附近摆动的情况。导致模型反复加载/销毁。</li>
133
+ <li>只针对 layer 生效。多个 layer 是单独计算，并不是综合计算。</li>
134
+ </ul>
135
+ <h2 id="全景浏览" class="tsd-anchor-link">全景浏览<a href="#全景浏览" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
136
+ <h3 id="movetopano-新增-effectmodel-模型过渡效果" class="tsd-anchor-link">moveToPano 新增 effect=model 模型过渡效果<a href="#movetopano-新增-effectmodel-模型过渡效果" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
137
+ <p>通过过渡到模型实现点位游走效果</p>
138
+ <pre><code class="ts"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">0</span><span class="hl-1">, {</span><br/><span class="hl-1"> </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;model&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
139
+ </code><button type="button">Copy</button></pre>
140
+
141
+ <p>目前支持:</p>
142
+ <ul>
143
+ <li>fly - 通过相机移动方式变化</li>
144
+ <li>instant - 直接变化</li>
145
+ <li>fade - 通过渐变方式变化</li>
146
+ <li>montage - 通过渐变穿插到黑屏方式变化</li>
147
+ <li>spread - 通过扩散方式变化</li>
148
+ <li>zoomin - 通过放大变化</li>
149
+ <li>zoomout - 通过缩小变化</li>
150
+ <li>model - 通过过度到模型</li>
151
+ </ul>
152
+ <h3 id="movetopano-新增参数-effecteasing-控制前后全景图的切换进度" class="tsd-anchor-link">moveToPano 新增参数 effectEasing 控制前后全景图的切换进度<a href="#movetopano-新增参数-effecteasing-控制前后全景图的切换进度" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
153
+ <pre><code class="ts"><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">easeInQuad</span><span class="hl-1">(</span><span class="hl-6">x</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">number</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-6">x</span><span class="hl-1"> * </span><span class="hl-6">x</span><span class="hl-1">;</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">({</span><br/><span class="hl-1"> </span><span class="hl-6">workCode:</span><span class="hl-1"> </span><span class="hl-9">&quot;axv2ZQMaKZcMl5Bc6x&quot;</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">panoIndex:</span><span class="hl-1"> </span><span class="hl-11">51</span><span class="hl-1">,</span><br/><span class="hl-1">}, {</span><br/><span class="hl-1"> </span><span class="hl-6">latitude:</span><span class="hl-1"> </span><span class="hl-11">0.5314685806864204</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">longitude:</span><span class="hl-1"> </span><span class="hl-11">4.324187623631265</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">fov:</span><span class="hl-1"> </span><span class="hl-11">90</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">effectEasing:</span><span class="hl-1"> </span><span class="hl-6">easeInQuad</span><br/><span class="hl-1">})</span>
154
+ </code><button type="button">Copy</button></pre>
155
+
156
+ <ul>
157
+ <li>effectEasing 生命一个函数，接受一个 0 到 1 的数字， 返回一个 0 到 1 的数字。</li>
158
+ <li>当值为 0 时显示前一个全景图。 为 1 时显示后一个全景图。 中间数值为两个全景图的混合， 数值表示混合比例。</li>
159
+ <li>用于 地面-天空 等切换切换占比差异较大的情况下单独设置。</li>
160
+ </ul>
161
+ <h3 id="全景图支持航拍点的差异显示" class="tsd-anchor-link">全景图支持航拍点的差异显示<a href="#全景图支持航拍点的差异显示" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
162
+ <p>默认逻辑为:</p>
163
+ <pre><code class="ts"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1"> </span><span class="hl-6">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-6">aerialObserverMinHeight:</span><span class="hl-1"> </span><span class="hl-11">5</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-5">panoCircleMeshCreator</span><span class="hl-6">:</span><span class="hl-1"> (</span><span class="hl-6">observer</span><span class="hl-1">, </span><span class="hl-6">options</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">distance</span><span class="hl-1"> = </span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">position</span><span class="hl-1">.</span><span class="hl-5">distanceTo</span><span class="hl-1">(</span><span class="hl-6">observer</span><span class="hl-1">.</span><span class="hl-6">standingPosition</span><span class="hl-1">);</span><br/><span class="hl-1"> </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">distance</span><span class="hl-1"> &gt; </span><span class="hl-6">options</span><span class="hl-1">.</span><span class="hl-6">aerialObserverMinHeight</span><span class="hl-1">) {</span><br/><span class="hl-1"> </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PanoCircleMeshSolid</span><span class="hl-1">();</span><br/><span class="hl-1"> } </span><span class="hl-10">else</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PanoCircleMesh</span><span class="hl-1">();</span><br/><span class="hl-1"> }</span><br/><span class="hl-1"> },</span><br/><span class="hl-1"> }</span><br/><span class="hl-1">}</span>
164
+ </code><button type="button">Copy</button></pre>
165
+
166
+ <ul>
167
+ <li>如果距地大于 5 米的点位为航拍点。</li>
168
+ <li>如果是航拍点，则使用 PanoCircleMeshSolid， 否则使用 PanoCircleMesh。</li>
169
+ <li>内部逻辑。航拍点会面向相机展示。</li>
170
+ </ul>
171
+ <p>业务可以修改或介入这个逻辑。</p>
172
+ <h2 id="渲染以及后处理" class="tsd-anchor-link">渲染以及后处理<a href="#渲染以及后处理" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
173
+ <p>重写了渲染相关的逻辑。将 scene-renderer 和 postprocessing 分开</p>
174
+ <ul>
175
+ <li>scene-renderer 场景的渲染相关，需要多次渲染场景采样比如抗锯齿（aa），或者对场景内容改变，必须点云的点融合等。</li>
176
+ <li>postprocessing 后处理，将 scene-renderer 的结果通过多次处理，比如轮廓增强，调整亮度等，将最终处理后的结果显示到画布上。</li>
177
+ </ul>
178
+ <h3 id="提供的-scene-renderer" class="tsd-anchor-link">提供的 scene-renderer<a href="#提供的-scene-renderer" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
179
+ <ul>
180
+ <li>scene-renderer - 直接渲染</li>
181
+ <li>point-cloud-high-quality-scene-renderer - 点云融合渲染</li>
182
+ <li>ssaa-scene-renderer - SSAA算法的抗锯齿渲染</li>
183
+ </ul>
184
+ <pre><code class="ts"><span class="hl-8">// 通过 renderMode 切换</span><br/><br/><span class="hl-8">// 直接渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;default&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 点云融合渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;point-cloud-high-quality&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// SSAA算法的抗锯齿渲染</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">renderMode</span><span class="hl-1"> = </span><span class="hl-9">&#39;ssaa&#39;</span><span class="hl-1">;</span>
185
+ </code><button type="button">Copy</button></pre>
186
+
187
+ <h3 id="内置后处理" class="tsd-anchor-link">内置后处理<a href="#内置后处理" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
188
+ <ul>
189
+ <li>adaptive-luminance-pass - 屏幕空间动态亮度</li>
190
+ <li>eye-dome-lighting-pass - 轮廓增强</li>
191
+ </ul>
192
+ <pre><code class="ts"><span class="hl-8">// 开启 eye-dome-lighting-pass</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">enableEDL</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 开启 adaptive-luminance-pass</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">enableAdaptiveLuminance</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span>
193
+ </code><button type="button">Copy</button></pre>
194
+
195
+ <h3 id="自定义后处理" class="tsd-anchor-link">自定义后处理<a href="#自定义后处理" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
196
+ <p>后处理支持 THREE 对于 后处理 Pass 的定义。可以自定义追加。</p>
197
+ <p>注意：目前不支持 mask 模版剔除部分的逻辑。</p>
198
+ <pre><code class="ts"><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Pass</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-6">enabled</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-6">needsSwap</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-6">clear</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-6">renderToScreen</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-5">setSize</span><span class="hl-1">(</span><span class="hl-6">width</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-6">height</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-5">render</span><span class="hl-1">(</span><br/><span class="hl-1"> </span><span class="hl-6">renderer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderer</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">writeBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">readBuffer</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">WebGLRenderTarget</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">deltaTime</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">,</span><br/><span class="hl-1"> </span><span class="hl-6">maskActive</span><span class="hl-1">?: </span><span class="hl-7">boolean</span><br/><span class="hl-1"> ): </span><span class="hl-7">void</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">myPass</span><span class="hl-1">: </span><span class="hl-7">Pass</span><span class="hl-1"> = ...;</span><br/><br/><span class="hl-3">this</span><span class="hl-1">.</span><span class="hl-6">fiveRenderer</span><span class="hl-1">.</span><span class="hl-6">composer</span><span class="hl-1">.</span><span class="hl-5">addPass</span><span class="hl-1">(</span><span class="hl-6">myPass</span><span class="hl-1">)</span>
199
+ </code><button type="button">Copy</button></pre>
200
+
201
+ <h2 id="其他" class="tsd-anchor-link">其他<a href="#其他" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
202
+ <ul>
203
+ <li>不再使用分层渲染。enableLayeringRendering 参数废弃。</li>
204
+ <li>修复 涉嫌计算 intersectRaycaster, 如果 origin 离得太近会出现取不到的问题，优化 bvhbox 的距离判断逻辑。</li>
205
+ <li>优化近处点云碰撞时，规避掉角度大 distanceToRay / distance &gt; 0.07 的点云。</li>
206
+ <li>修复多个 five 实例间，共用同一个 work 时 proxy 指向错误 five 实例的问题。</li>
207
+ <li>修复 mesh 模型 material.vertexMarks 没有同步 parameterValue.vertexMarks 的问题</li>
208
+ </ul>
209
+ </div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#release-note-67x"><span>Release <wbr/>Note 6.7.x</span></a><ul><li><a href="#fivelaod-的多-work-的非阻塞性加载"><span>five.laod 的多 <wbr/>Work 的非阻塞性加载</span></a></li><li><ul><li><a href="#使用-在控制-替换--追加项目"><span>使用 在控制 替换 / 追加项目</span></a></li><li><a href="#重新定义-的行为"><span>重新定义 的行为</span></a></li></ul></li><li><a href="#work-更加精简和灵活"><span>work 更加精简和灵活</span></a></li><li><ul><li><a href="#panoramapattern-模版"><span>panorama.pattern 模版</span></a></li><li><a href="#相对路径"><span>相对路径</span></a></li><li><a href="#一些字段的新增、废弃与兼容"><span>一些字段的新增、废弃与兼容</span></a></li><li><a href="#model-支持-coordinate-以及-up_axis"><span>model 支持 coordinate 以及 up_<wbr/>axis</span></a></li><li><a href="#tojson-方法"><span>to<wbr/>JSON 方法</span></a></li><li><a href="#work-downloader-的速度优化"><span>work-<wbr/>downloader 的速度优化</span></a></li></ul></li><li><a href="#模型优化材质展示-3d-tile，以及碰撞计算"><span>模型优化材质展示, 3d-<wbr/>tile，以及碰撞计算</span></a></li><li><ul><li><a href="#gltf-模型材质-与-动画"><span>gl<wbr/>TF 模型材质 与 动画</span></a></li><li><a href="#gltf-预览工具"><span>gl<wbr/>TF 预览工具</span></a></li><li><a href="#优化模型碰撞"><span>优化模型碰撞</span></a></li><li><a href="#3d-tile-支持通过内存上限动态调整-maxscreenspaceerror。"><span>3d-<wbr/>tile 支持通过内存上限动态调整 max<wbr/>Screen<wbr/>Space<wbr/>Error。</span></a></li></ul></li><li><a href="#全景浏览"><span>全景浏览</span></a></li><li><ul><li><a href="#movetopano-新增-effectmodel-模型过渡效果"><span>move<wbr/>To<wbr/>Pano 新增 effect=model 模型过渡效果</span></a></li><li><a href="#movetopano-新增参数-effecteasing-控制前后全景图的切换进度"><span>move<wbr/>To<wbr/>Pano 新增参数 effect<wbr/>Easing 控制前后全景图的切换进度</span></a></li><li><a href="#全景图支持航拍点的差异显示"><span>全景图支持航拍点的差异显示</span></a></li></ul></li><li><a href="#渲染以及后处理"><span>渲染以及后处理</span></a></li><li><ul><li><a href="#提供的-scene-renderer"><span>提供的 scene-<wbr/>renderer</span></a></li><li><a href="#内置后处理"><span>内置后处理</span></a></li><li><a href="#自定义后处理"><span>自定义后处理</span></a></li></ul></li><li><a href="#其他"><span>其他</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>