@needle-tools/engine 4.4.0-beta.3 → 4.4.0-beta.5

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 (1054) hide show
  1. package/CHANGELOG.md +3614 -3608
  2. package/LICENSE.md +10 -10
  3. package/README.md +64 -64
  4. package/components.needle.json +1 -1
  5. package/dist/needle-engine.bundle.js +2399 -2347
  6. package/dist/needle-engine.bundle.light.js +2395 -2343
  7. package/dist/needle-engine.bundle.light.min.js +89 -89
  8. package/dist/needle-engine.bundle.light.umd.cjs +84 -84
  9. package/dist/needle-engine.bundle.min.js +89 -89
  10. package/dist/needle-engine.bundle.umd.cjs +79 -79
  11. package/dist/needle-engine.d.ts +138 -130
  12. package/dist/needle-engine.light.d.ts +138 -130
  13. package/dist/postprocessing.js +1513 -1659
  14. package/dist/postprocessing.light.js +1513 -1659
  15. package/dist/postprocessing.light.min.js +66 -80
  16. package/dist/postprocessing.light.umd.cjs +69 -83
  17. package/dist/postprocessing.min.js +66 -80
  18. package/dist/postprocessing.umd.cjs +69 -83
  19. package/dist/vendor.js +1 -1
  20. package/dist/vendor.light.js +1 -1
  21. package/lib/asap/needle-asap.d.ts +1 -1
  22. package/lib/asap/needle-asap.js +95 -95
  23. package/lib/asap/sessiongranted.d.ts +3 -3
  24. package/lib/asap/sessiongranted.js +65 -65
  25. package/lib/asap/utils.d.ts +1 -1
  26. package/lib/asap/utils.js +3 -3
  27. package/lib/engine/analytics/index.d.ts +6 -6
  28. package/lib/engine/analytics/index.js +12 -12
  29. package/lib/engine/analytics/lcp.d.ts +3 -3
  30. package/lib/engine/analytics/lcp.js +34 -34
  31. package/lib/engine/api.d.ts +81 -81
  32. package/lib/engine/api.js +80 -80
  33. package/lib/engine/assets/index.d.ts +11 -11
  34. package/lib/engine/assets/index.js +47 -47
  35. package/lib/engine/assets/static.d.ts +1 -1
  36. package/lib/engine/assets/static.js +4 -4
  37. package/lib/engine/codegen/register_types.d.ts +1 -1
  38. package/lib/engine/codegen/register_types.js +300 -300
  39. package/lib/engine/debug/debug.d.ts +15 -15
  40. package/lib/engine/debug/debug.js +44 -44
  41. package/lib/engine/debug/debug_console.d.ts +2 -2
  42. package/lib/engine/debug/debug_console.js +307 -307
  43. package/lib/engine/debug/debug_overlay.d.ts +22 -22
  44. package/lib/engine/debug/debug_overlay.js +316 -316
  45. package/lib/engine/debug/debug_spatial_console.d.ts +2 -2
  46. package/lib/engine/debug/debug_spatial_console.js +390 -390
  47. package/lib/engine/debug/index.d.ts +2 -2
  48. package/lib/engine/debug/index.js +2 -2
  49. package/lib/engine/engine.d.ts +4 -0
  50. package/lib/engine/engine.js +12 -0
  51. package/lib/engine/engine.js.map +1 -0
  52. package/lib/engine/engine_addressables.d.ts +166 -166
  53. package/lib/engine/engine_addressables.js +608 -608
  54. package/lib/engine/engine_animation.d.ts +43 -43
  55. package/lib/engine/engine_animation.js +133 -133
  56. package/lib/engine/engine_application.d.ts +40 -40
  57. package/lib/engine/engine_application.js +104 -104
  58. package/lib/engine/engine_assetdatabase.d.ts +25 -25
  59. package/lib/engine/engine_assetdatabase.js +344 -344
  60. package/lib/engine/engine_audio.d.ts +4 -4
  61. package/lib/engine/engine_audio.js +23 -23
  62. package/lib/engine/engine_camera.d.ts +13 -13
  63. package/lib/engine/engine_camera.js +30 -30
  64. package/lib/engine/engine_components.d.ts +110 -110
  65. package/lib/engine/engine_components.js +382 -380
  66. package/lib/engine/engine_components.js.map +1 -1
  67. package/lib/engine/engine_components_internal.d.ts +9 -9
  68. package/lib/engine/engine_components_internal.js +36 -36
  69. package/lib/engine/engine_constants.d.ts +10 -10
  70. package/lib/engine/engine_constants.js +41 -41
  71. package/lib/engine/engine_context.d.ts +345 -345
  72. package/lib/engine/engine_context.js +1515 -1515
  73. package/lib/engine/engine_context_registry.d.ts +71 -71
  74. package/lib/engine/engine_context_registry.js +117 -117
  75. package/lib/engine/engine_coroutine.d.ts +35 -35
  76. package/lib/engine/engine_coroutine.js +52 -52
  77. package/lib/engine/engine_create_objects.d.ts +118 -118
  78. package/lib/engine/engine_create_objects.js +308 -308
  79. package/lib/engine/engine_default_parameters.d.ts +2 -2
  80. package/lib/engine/engine_default_parameters.js +3 -3
  81. package/lib/engine/engine_editor-sync.d.ts +21 -21
  82. package/lib/engine/engine_editor-sync.js +4 -4
  83. package/lib/engine/engine_element.d.ts +113 -113
  84. package/lib/engine/engine_element.js +829 -830
  85. package/lib/engine/engine_element.js.map +1 -1
  86. package/lib/engine/engine_element_attributes.d.ts +72 -72
  87. package/lib/engine/engine_element_attributes.js +1 -1
  88. package/lib/engine/engine_element_extras.d.ts +6 -6
  89. package/lib/engine/engine_element_extras.js +13 -13
  90. package/lib/engine/engine_element_loading.d.ts +44 -44
  91. package/lib/engine/engine_element_loading.js +349 -349
  92. package/lib/engine/engine_element_overlay.d.ts +21 -21
  93. package/lib/engine/engine_element_overlay.js +166 -166
  94. package/lib/engine/engine_fileloader.d.ts +2 -2
  95. package/lib/engine/engine_fileloader.js +8 -8
  96. package/lib/engine/engine_gameobject.d.ts +68 -68
  97. package/lib/engine/engine_gameobject.js +591 -591
  98. package/lib/engine/engine_generic_utils.d.ts +1 -1
  99. package/lib/engine/engine_generic_utils.js +13 -13
  100. package/lib/engine/engine_gizmos.d.ts +149 -149
  101. package/lib/engine/engine_gizmos.js +530 -530
  102. package/lib/engine/engine_gltf.d.ts +12 -12
  103. package/lib/engine/engine_gltf.js +15 -15
  104. package/lib/engine/engine_gltf_builtin_components.d.ts +7 -7
  105. package/lib/engine/engine_gltf_builtin_components.js +341 -341
  106. package/lib/engine/engine_hot_reload.d.ts +7 -7
  107. package/lib/engine/engine_hot_reload.js +184 -184
  108. package/lib/engine/engine_input.d.ts +352 -352
  109. package/lib/engine/engine_input.js +1265 -1265
  110. package/lib/engine/engine_input_utils.d.ts +2 -2
  111. package/lib/engine/engine_input_utils.js +22 -22
  112. package/lib/engine/engine_instancing.d.ts +19 -19
  113. package/lib/engine/engine_instancing.js +39 -39
  114. package/lib/engine/engine_license.d.ts +9 -9
  115. package/lib/engine/engine_license.js +320 -320
  116. package/lib/engine/engine_lifecycle_api.d.ts +76 -76
  117. package/lib/engine/engine_lifecycle_api.js +99 -99
  118. package/lib/engine/engine_lifecycle_functions_internal.d.ts +32 -32
  119. package/lib/engine/engine_lifecycle_functions_internal.js +146 -146
  120. package/lib/engine/engine_lightdata.d.ts +23 -23
  121. package/lib/engine/engine_lightdata.js +91 -91
  122. package/lib/engine/engine_loaders.d.ts +13 -13
  123. package/lib/engine/engine_loaders.js +62 -62
  124. package/lib/engine/engine_lods.d.ts +31 -31
  125. package/lib/engine/engine_lods.js +146 -146
  126. package/lib/engine/engine_mainloop_utils.d.ts +32 -32
  127. package/lib/engine/engine_mainloop_utils.js +466 -466
  128. package/lib/engine/engine_math.d.ts +114 -114
  129. package/lib/engine/engine_math.js +247 -247
  130. package/lib/engine/engine_modules.d.ts +36 -36
  131. package/lib/engine/engine_modules.js +85 -85
  132. package/lib/engine/engine_networking.d.ts +252 -252
  133. package/lib/engine/engine_networking.js +743 -743
  134. package/lib/engine/engine_networking_auto.d.ts +24 -24
  135. package/lib/engine/engine_networking_auto.js +310 -310
  136. package/lib/engine/engine_networking_blob.d.ts +48 -48
  137. package/lib/engine/engine_networking_blob.js +212 -212
  138. package/lib/engine/engine_networking_files.d.ts +35 -35
  139. package/lib/engine/engine_networking_files.js +172 -172
  140. package/lib/engine/engine_networking_files_default_components.d.ts +6 -6
  141. package/lib/engine/engine_networking_files_default_components.js +42 -42
  142. package/lib/engine/engine_networking_instantiate.d.ts +100 -100
  143. package/lib/engine/engine_networking_instantiate.js +345 -345
  144. package/lib/engine/engine_networking_peer.d.ts +15 -15
  145. package/lib/engine/engine_networking_peer.js +132 -132
  146. package/lib/engine/engine_networking_streams.d.ts +123 -123
  147. package/lib/engine/engine_networking_streams.js +645 -645
  148. package/lib/engine/engine_networking_types.d.ts +22 -22
  149. package/lib/engine/engine_networking_types.js +7 -7
  150. package/lib/engine/engine_networking_utils.d.ts +2 -2
  151. package/lib/engine/engine_networking_utils.js +20 -20
  152. package/lib/engine/engine_networking_websocket.d.ts +1 -1
  153. package/lib/engine/engine_networking_websocket.js +2 -2
  154. package/lib/engine/engine_patcher.d.ts +10 -10
  155. package/lib/engine/engine_patcher.js +142 -142
  156. package/lib/engine/engine_physics.d.ts +152 -152
  157. package/lib/engine/engine_physics.js +645 -645
  158. package/lib/engine/engine_physics.types.d.ts +40 -40
  159. package/lib/engine/engine_physics.types.js +33 -33
  160. package/lib/engine/engine_physics_rapier.d.ts +147 -147
  161. package/lib/engine/engine_physics_rapier.js +1432 -1432
  162. package/lib/engine/engine_playerview.d.ts +26 -26
  163. package/lib/engine/engine_playerview.js +64 -64
  164. package/lib/engine/engine_scenelighting.d.ts +71 -71
  165. package/lib/engine/engine_scenelighting.js +226 -226
  166. package/lib/engine/engine_scenetools.d.ts +50 -50
  167. package/lib/engine/engine_scenetools.js +321 -321
  168. package/lib/engine/engine_serialization.d.ts +3 -3
  169. package/lib/engine/engine_serialization.js +3 -3
  170. package/lib/engine/engine_serialization_builtin_serializer.d.ts +72 -72
  171. package/lib/engine/engine_serialization_builtin_serializer.js +403 -403
  172. package/lib/engine/engine_serialization_core.d.ts +85 -85
  173. package/lib/engine/engine_serialization_core.js +602 -602
  174. package/lib/engine/engine_serialization_decorator.d.ts +23 -23
  175. package/lib/engine/engine_serialization_decorator.js +66 -66
  176. package/lib/engine/engine_setup.d.ts +1 -1
  177. package/lib/engine/engine_setup.js +2 -2
  178. package/lib/engine/engine_shaders.d.ts +53 -53
  179. package/lib/engine/engine_shaders.js +252 -252
  180. package/lib/engine/engine_shims.d.ts +4 -4
  181. package/lib/engine/engine_shims.js +24 -24
  182. package/lib/engine/engine_test_utils.d.ts +39 -39
  183. package/lib/engine/engine_test_utils.js +83 -83
  184. package/lib/engine/engine_texture.d.ts +28 -28
  185. package/lib/engine/engine_texture.js +64 -64
  186. package/lib/engine/engine_three_utils.d.ts +201 -201
  187. package/lib/engine/engine_three_utils.js +731 -731
  188. package/lib/engine/engine_time.d.ts +51 -51
  189. package/lib/engine/engine_time.js +82 -82
  190. package/lib/engine/engine_time_utils.d.ts +88 -88
  191. package/lib/engine/engine_time_utils.js +215 -215
  192. package/lib/engine/engine_tonemapping.d.ts +2 -2
  193. package/lib/engine/engine_tonemapping.js +194 -194
  194. package/lib/engine/engine_types.d.ts +572 -572
  195. package/lib/engine/engine_types.js +88 -88
  196. package/lib/engine/engine_typestore.d.ts +28 -28
  197. package/lib/engine/engine_typestore.js +55 -55
  198. package/lib/engine/engine_util_decorator.d.ts +13 -13
  199. package/lib/engine/engine_util_decorator.js +116 -116
  200. package/lib/engine/engine_utils.d.ts +266 -266
  201. package/lib/engine/engine_utils.js +878 -878
  202. package/lib/engine/engine_utils_format.d.ts +21 -21
  203. package/lib/engine/engine_utils_format.js +193 -193
  204. package/lib/engine/engine_utils_screenshot.d.ts +159 -159
  205. package/lib/engine/engine_utils_screenshot.js +513 -513
  206. package/lib/engine/engine_utils_screenshot.js.map +1 -1
  207. package/lib/engine/engine_utils_screenshot.xr.d.ts +5 -5
  208. package/lib/engine/engine_utils_screenshot.xr.js +90 -90
  209. package/lib/engine/engine_web_api.d.ts +12 -0
  210. package/lib/engine/engine_web_api.js +113 -0
  211. package/lib/engine/engine_web_api.js.map +1 -0
  212. package/lib/engine/engine_xr.d.ts +1 -1
  213. package/lib/engine/engine_xr.js +1 -1
  214. package/lib/engine/export/gltf/Writers.d.ts +19 -19
  215. package/lib/engine/export/gltf/Writers.js +24 -24
  216. package/lib/engine/export/gltf/index.d.ts +11 -11
  217. package/lib/engine/export/gltf/index.js +123 -123
  218. package/lib/engine/export/index.d.ts +2 -2
  219. package/lib/engine/export/index.js +2 -2
  220. package/lib/engine/export/state.d.ts +7 -7
  221. package/lib/engine/export/state.js +17 -17
  222. package/lib/engine/export/utils.d.ts +2 -2
  223. package/lib/engine/export/utils.js +7 -7
  224. package/lib/engine/extensions/EXT_texture_exr.d.ts +8 -8
  225. package/lib/engine/extensions/EXT_texture_exr.js +32 -32
  226. package/lib/engine/extensions/NEEDLE_animator_controller_model.d.ts +122 -122
  227. package/lib/engine/extensions/NEEDLE_animator_controller_model.js +95 -95
  228. package/lib/engine/extensions/NEEDLE_components.d.ts +35 -35
  229. package/lib/engine/extensions/NEEDLE_components.js +220 -220
  230. package/lib/engine/extensions/NEEDLE_gameobject_data.d.ts +10 -10
  231. package/lib/engine/extensions/NEEDLE_gameobject_data.js +57 -57
  232. package/lib/engine/extensions/NEEDLE_lighting_settings.d.ts +37 -37
  233. package/lib/engine/extensions/NEEDLE_lighting_settings.js +157 -157
  234. package/lib/engine/extensions/NEEDLE_lightmaps.d.ts +18 -18
  235. package/lib/engine/extensions/NEEDLE_lightmaps.js +99 -99
  236. package/lib/engine/extensions/NEEDLE_persistent_assets.d.ts +11 -11
  237. package/lib/engine/extensions/NEEDLE_persistent_assets.js +63 -63
  238. package/lib/engine/extensions/NEEDLE_progressive.d.ts +1 -1
  239. package/lib/engine/extensions/NEEDLE_progressive.js +1 -1
  240. package/lib/engine/extensions/NEEDLE_render_objects.d.ts +13 -13
  241. package/lib/engine/extensions/NEEDLE_render_objects.js +159 -159
  242. package/lib/engine/extensions/NEEDLE_techniques_webgl.d.ts +38 -38
  243. package/lib/engine/extensions/NEEDLE_techniques_webgl.js +564 -564
  244. package/lib/engine/extensions/extension_resolver.d.ts +4 -4
  245. package/lib/engine/extensions/extension_resolver.js +1 -1
  246. package/lib/engine/extensions/extension_utils.d.ts +12 -12
  247. package/lib/engine/extensions/extension_utils.js +152 -152
  248. package/lib/engine/extensions/extensions.d.ts +31 -31
  249. package/lib/engine/extensions/extensions.js +103 -103
  250. package/lib/engine/extensions/index.d.ts +6 -6
  251. package/lib/engine/extensions/index.js +6 -6
  252. package/lib/engine/extensions/usage_tracker.d.ts +13 -13
  253. package/lib/engine/extensions/usage_tracker.js +65 -65
  254. package/lib/engine/js-extensions/Camera.d.ts +1 -1
  255. package/lib/engine/js-extensions/Camera.js +39 -39
  256. package/lib/engine/js-extensions/ExtensionUtils.d.ts +9 -9
  257. package/lib/engine/js-extensions/ExtensionUtils.js +67 -67
  258. package/lib/engine/js-extensions/Layers.d.ts +6 -6
  259. package/lib/engine/js-extensions/Layers.js +22 -22
  260. package/lib/engine/js-extensions/Object3D.d.ts +120 -120
  261. package/lib/engine/js-extensions/Object3D.js +136 -136
  262. package/lib/engine/js-extensions/RGBAColor.d.ts +23 -22
  263. package/lib/engine/js-extensions/RGBAColor.js +110 -62
  264. package/lib/engine/js-extensions/RGBAColor.js.map +1 -1
  265. package/lib/engine/js-extensions/Vector.d.ts +3 -3
  266. package/lib/engine/js-extensions/Vector.js +13 -13
  267. package/lib/engine/js-extensions/index.d.ts +5 -5
  268. package/lib/engine/js-extensions/index.js +5 -5
  269. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.d.ts +4 -4
  270. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +75 -75
  271. package/lib/engine/shaders/shaderData.d.ts +55 -55
  272. package/lib/engine/shaders/shaderData.js +58 -58
  273. package/lib/engine/tests/test_utils.d.ts +2 -2
  274. package/lib/engine/tests/test_utils.js +53 -53
  275. package/lib/engine/webcomponents/WebXRButtons.d.ts +56 -56
  276. package/lib/engine/webcomponents/WebXRButtons.js +230 -230
  277. package/lib/engine/webcomponents/api.d.ts +5 -5
  278. package/lib/engine/webcomponents/api.js +4 -4
  279. package/lib/engine/webcomponents/buttons.d.ts +39 -39
  280. package/lib/engine/webcomponents/buttons.js +237 -237
  281. package/lib/engine/webcomponents/fonts.d.ts +9 -9
  282. package/lib/engine/webcomponents/fonts.js +32 -32
  283. package/lib/engine/webcomponents/icons.d.ts +9 -9
  284. package/lib/engine/webcomponents/icons.js +52 -52
  285. package/lib/engine/webcomponents/index.d.ts +1 -1
  286. package/lib/engine/webcomponents/index.js +1 -1
  287. package/lib/engine/webcomponents/logo-element.d.ts +10 -10
  288. package/lib/engine/webcomponents/logo-element.js +67 -67
  289. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.d.ts +37 -37
  290. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.js +513 -513
  291. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +151 -151
  292. package/lib/engine/webcomponents/needle menu/needle-menu.js +1018 -1018
  293. package/lib/engine/webcomponents/needle-button.d.ts +34 -34
  294. package/lib/engine/webcomponents/needle-button.js +161 -161
  295. package/lib/engine/xr/NeedleXRController.d.ts +313 -313
  296. package/lib/engine/xr/NeedleXRController.js +1008 -1008
  297. package/lib/engine/xr/NeedleXRSession.d.ts +339 -339
  298. package/lib/engine/xr/NeedleXRSession.js +1427 -1427
  299. package/lib/engine/xr/NeedleXRSync.d.ts +22 -22
  300. package/lib/engine/xr/NeedleXRSync.js +188 -188
  301. package/lib/engine/xr/SceneTransition.d.ts +18 -18
  302. package/lib/engine/xr/SceneTransition.js +69 -69
  303. package/lib/engine/xr/TempXRContext.d.ts +34 -34
  304. package/lib/engine/xr/TempXRContext.js +187 -187
  305. package/lib/engine/xr/XRRig.d.ts +7 -7
  306. package/lib/engine/xr/XRRig.js +1 -1
  307. package/lib/engine/xr/api.d.ts +6 -6
  308. package/lib/engine/xr/api.js +6 -6
  309. package/lib/engine/xr/events.d.ts +66 -66
  310. package/lib/engine/xr/events.js +93 -93
  311. package/lib/engine/xr/internal.d.ts +12 -12
  312. package/lib/engine/xr/internal.js +25 -25
  313. package/lib/engine/xr/usdz.d.ts +12 -12
  314. package/lib/engine/xr/usdz.js +29 -29
  315. package/lib/engine/xr/utils.d.ts +11 -11
  316. package/lib/engine/xr/utils.js +34 -34
  317. package/lib/engine-components/AlignmentConstraint.d.ts +10 -10
  318. package/lib/engine-components/AlignmentConstraint.js +39 -39
  319. package/lib/engine-components/Animation.d.ts +156 -156
  320. package/lib/engine-components/Animation.js +508 -508
  321. package/lib/engine-components/AnimationCurve.d.ts +40 -40
  322. package/lib/engine-components/AnimationCurve.js +159 -159
  323. package/lib/engine-components/AnimationUtils.d.ts +8 -8
  324. package/lib/engine-components/AnimationUtils.js +27 -27
  325. package/lib/engine-components/AnimationUtilsAutoplay.d.ts +1 -1
  326. package/lib/engine-components/AnimationUtilsAutoplay.js +39 -39
  327. package/lib/engine-components/Animator.d.ts +217 -217
  328. package/lib/engine-components/Animator.js +354 -354
  329. package/lib/engine-components/AnimatorController.d.ts +227 -227
  330. package/lib/engine-components/AnimatorController.js +1152 -1152
  331. package/lib/engine-components/AudioListener.d.ts +33 -33
  332. package/lib/engine-components/AudioListener.js +86 -86
  333. package/lib/engine-components/AudioSource.d.ts +217 -217
  334. package/lib/engine-components/AudioSource.js +627 -627
  335. package/lib/engine-components/AvatarLoader.d.ts +80 -80
  336. package/lib/engine-components/AvatarLoader.js +231 -231
  337. package/lib/engine-components/AxesHelper.d.ts +32 -32
  338. package/lib/engine-components/AxesHelper.js +67 -67
  339. package/lib/engine-components/BasicIKConstraint.d.ts +9 -9
  340. package/lib/engine-components/BasicIKConstraint.js +43 -43
  341. package/lib/engine-components/BoxCollider.d.ts +2 -2
  342. package/lib/engine-components/BoxCollider.js +2 -2
  343. package/lib/engine-components/BoxHelperComponent.d.ts +47 -47
  344. package/lib/engine-components/BoxHelperComponent.js +102 -102
  345. package/lib/engine-components/Camera.d.ts +231 -231
  346. package/lib/engine-components/Camera.js +700 -694
  347. package/lib/engine-components/Camera.js.map +1 -1
  348. package/lib/engine-components/CameraUtils.d.ts +1 -1
  349. package/lib/engine-components/CameraUtils.js +118 -127
  350. package/lib/engine-components/CameraUtils.js.map +1 -1
  351. package/lib/engine-components/CharacterController.d.ts +55 -55
  352. package/lib/engine-components/CharacterController.js +236 -236
  353. package/lib/engine-components/Collider.d.ts +188 -188
  354. package/lib/engine-components/Collider.js +369 -369
  355. package/lib/engine-components/Component.d.ts +792 -792
  356. package/lib/engine-components/Component.js +915 -915
  357. package/lib/engine-components/ContactShadows.d.ts +82 -82
  358. package/lib/engine-components/ContactShadows.js +430 -430
  359. package/lib/engine-components/DeleteBox.d.ts +19 -19
  360. package/lib/engine-components/DeleteBox.js +58 -58
  361. package/lib/engine-components/DeviceFlag.d.ts +16 -16
  362. package/lib/engine-components/DeviceFlag.js +47 -47
  363. package/lib/engine-components/DragControls.d.ts +170 -170
  364. package/lib/engine-components/DragControls.js +1421 -1421
  365. package/lib/engine-components/DropListener.d.ts +215 -215
  366. package/lib/engine-components/DropListener.js +630 -630
  367. package/lib/engine-components/Duplicatable.d.ts +35 -35
  368. package/lib/engine-components/Duplicatable.js +202 -202
  369. package/lib/engine-components/EventList.d.ts +54 -54
  370. package/lib/engine-components/EventList.js +232 -232
  371. package/lib/engine-components/EventTrigger.d.ts +33 -33
  372. package/lib/engine-components/EventTrigger.js +75 -75
  373. package/lib/engine-components/EventType.d.ts +22 -22
  374. package/lib/engine-components/EventType.js +23 -23
  375. package/lib/engine-components/FlyControls.d.ts +10 -0
  376. package/lib/engine-components/FlyControls.js +29 -0
  377. package/lib/engine-components/FlyControls.js.map +1 -0
  378. package/lib/engine-components/Fog.d.ts +22 -22
  379. package/lib/engine-components/Fog.js +61 -61
  380. package/lib/engine-components/Gizmos.d.ts +17 -17
  381. package/lib/engine-components/Gizmos.js +64 -64
  382. package/lib/engine-components/GridHelper.d.ts +20 -20
  383. package/lib/engine-components/GridHelper.js +54 -54
  384. package/lib/engine-components/GroundProjection.d.ts +67 -67
  385. package/lib/engine-components/GroundProjection.js +343 -343
  386. package/lib/engine-components/Interactable.d.ts +12 -12
  387. package/lib/engine-components/Interactable.js +12 -12
  388. package/lib/engine-components/Joints.d.ts +19 -19
  389. package/lib/engine-components/Joints.js +51 -51
  390. package/lib/engine-components/LODGroup.d.ts +35 -35
  391. package/lib/engine-components/LODGroup.js +152 -152
  392. package/lib/engine-components/Light.d.ts +180 -180
  393. package/lib/engine-components/Light.js +535 -535
  394. package/lib/engine-components/LookAtConstraint.d.ts +19 -19
  395. package/lib/engine-components/LookAtConstraint.js +35 -35
  396. package/lib/engine-components/NeedleMenu.d.ts +50 -50
  397. package/lib/engine-components/NeedleMenu.js +92 -92
  398. package/lib/engine-components/NestedGltf.d.ts +25 -25
  399. package/lib/engine-components/NestedGltf.js +88 -88
  400. package/lib/engine-components/Networking.d.ts +54 -54
  401. package/lib/engine-components/Networking.js +112 -112
  402. package/lib/engine-components/OffsetConstraint.d.ts +14 -14
  403. package/lib/engine-components/OffsetConstraint.js +65 -65
  404. package/lib/engine-components/OrbitControls.d.ts +266 -266
  405. package/lib/engine-components/OrbitControls.js +1009 -1009
  406. package/lib/engine-components/PlayerColor.d.ts +19 -19
  407. package/lib/engine-components/PlayerColor.js +94 -94
  408. package/lib/engine-components/ReflectionProbe.d.ts +27 -26
  409. package/lib/engine-components/ReflectionProbe.js +201 -194
  410. package/lib/engine-components/ReflectionProbe.js.map +1 -1
  411. package/lib/engine-components/Renderer.d.ts +153 -153
  412. package/lib/engine-components/Renderer.js +830 -830
  413. package/lib/engine-components/RendererInstancing.d.ts +140 -140
  414. package/lib/engine-components/RendererInstancing.js +744 -744
  415. package/lib/engine-components/RendererLightmap.d.ts +24 -24
  416. package/lib/engine-components/RendererLightmap.js +182 -182
  417. package/lib/engine-components/RigidBody.d.ts +155 -155
  418. package/lib/engine-components/RigidBody.js +517 -517
  419. package/lib/engine-components/SceneSwitcher.d.ts +263 -263
  420. package/lib/engine-components/SceneSwitcher.js +951 -951
  421. package/lib/engine-components/ScreenCapture.d.ts +144 -144
  422. package/lib/engine-components/ScreenCapture.js +547 -547
  423. package/lib/engine-components/ShadowCatcher.d.ts +33 -33
  424. package/lib/engine-components/ShadowCatcher.js +166 -166
  425. package/lib/engine-components/Skybox.d.ts +82 -82
  426. package/lib/engine-components/Skybox.js +448 -448
  427. package/lib/engine-components/SmoothFollow.d.ts +34 -34
  428. package/lib/engine-components/SmoothFollow.js +82 -82
  429. package/lib/engine-components/SpatialTrigger.d.ts +102 -102
  430. package/lib/engine-components/SpatialTrigger.js +225 -225
  431. package/lib/engine-components/SpectatorCamera.d.ts +111 -111
  432. package/lib/engine-components/SpectatorCamera.js +715 -715
  433. package/lib/engine-components/SphereCollider.d.ts +2 -2
  434. package/lib/engine-components/SphereCollider.js +2 -2
  435. package/lib/engine-components/SpriteRenderer.d.ts +132 -132
  436. package/lib/engine-components/SpriteRenderer.js +472 -472
  437. package/lib/engine-components/SyncedCamera.d.ts +41 -41
  438. package/lib/engine-components/SyncedCamera.js +199 -199
  439. package/lib/engine-components/SyncedRoom.d.ts +106 -106
  440. package/lib/engine-components/SyncedRoom.js +371 -371
  441. package/lib/engine-components/SyncedTransform.d.ts +94 -88
  442. package/lib/engine-components/SyncedTransform.js +331 -326
  443. package/lib/engine-components/SyncedTransform.js.map +1 -1
  444. package/lib/engine-components/TestRunner.d.ts +16 -16
  445. package/lib/engine-components/TestRunner.js +102 -102
  446. package/lib/engine-components/TransformGizmo.d.ts +75 -75
  447. package/lib/engine-components/TransformGizmo.js +209 -209
  448. package/lib/engine-components/VideoPlayer.d.ts +184 -184
  449. package/lib/engine-components/VideoPlayer.js +978 -978
  450. package/lib/engine-components/Voip.d.ts +67 -67
  451. package/lib/engine-components/Voip.js +360 -360
  452. package/lib/engine-components/api.d.ts +51 -51
  453. package/lib/engine-components/api.js +50 -50
  454. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +11 -11
  455. package/lib/engine-components/avatar/AvatarBlink_Simple.js +76 -76
  456. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +14 -14
  457. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +68 -68
  458. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +29 -29
  459. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +121 -121
  460. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +15 -15
  461. package/lib/engine-components/avatar/Avatar_MouthShapes.js +79 -79
  462. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +9 -9
  463. package/lib/engine-components/avatar/Avatar_MustacheShake.js +29 -29
  464. package/lib/engine-components/codegen/components.d.ts +216 -216
  465. package/lib/engine-components/codegen/components.js +218 -218
  466. package/lib/engine-components/debug/LogStats.d.ts +5 -5
  467. package/lib/engine-components/debug/LogStats.js +18 -18
  468. package/lib/engine-components/export/gltf/GltfExport.d.ts +30 -30
  469. package/lib/engine-components/export/gltf/GltfExport.js +246 -246
  470. package/lib/engine-components/export/gltf/index.d.ts +1 -1
  471. package/lib/engine-components/export/gltf/index.js +1 -1
  472. package/lib/engine-components/export/index.d.ts +1 -1
  473. package/lib/engine-components/export/index.js +1 -1
  474. package/lib/engine-components/export/usdz/Extension.d.ts +22 -22
  475. package/lib/engine-components/export/usdz/Extension.js +1 -1
  476. package/lib/engine-components/export/usdz/ThreeUSDZExporter.d.ts +160 -160
  477. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1782 -1782
  478. package/lib/engine-components/export/usdz/USDZExporter.d.ts +130 -130
  479. package/lib/engine-components/export/usdz/USDZExporter.js +663 -663
  480. package/lib/engine-components/export/usdz/extensions/Animation.d.ts +106 -106
  481. package/lib/engine-components/export/usdz/extensions/Animation.js +1071 -1071
  482. package/lib/engine-components/export/usdz/extensions/DocumentExtension.d.ts +5 -5
  483. package/lib/engine-components/export/usdz/extensions/DocumentExtension.js +6 -6
  484. package/lib/engine-components/export/usdz/extensions/USDZText.d.ts +54 -54
  485. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  486. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  487. package/lib/engine-components/export/usdz/extensions/USDZUI.js +157 -157
  488. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  489. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  490. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  491. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  492. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  493. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  494. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  495. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  496. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  497. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  498. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  499. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  500. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  501. package/lib/engine-components/export/usdz/index.js +2 -2
  502. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  503. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  504. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  505. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  506. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  507. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  508. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  509. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  510. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  511. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  512. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  513. package/lib/engine-components/particlesystem/api.js +2 -2
  514. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  515. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +50 -50
  516. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  517. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  518. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  519. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  520. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +15 -15
  521. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +92 -92
  522. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  523. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  524. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  525. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  526. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  527. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  528. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  529. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  530. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  531. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +175 -175
  532. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +17 -17
  533. package/lib/engine-components/postprocessing/Effects/Sharpening.js +123 -123
  534. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  535. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  536. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +26 -26
  537. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +138 -138
  538. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  539. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  540. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +72 -72
  541. package/lib/engine-components/postprocessing/PostProcessingEffect.js +149 -149
  542. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +25 -25
  543. package/lib/engine-components/postprocessing/PostProcessingHandler.js +350 -350
  544. package/lib/engine-components/postprocessing/Volume.d.ts +89 -89
  545. package/lib/engine-components/postprocessing/Volume.js +367 -367
  546. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  547. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  548. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  549. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  550. package/lib/engine-components/postprocessing/index.d.ts +5 -5
  551. package/lib/engine-components/postprocessing/index.js +5 -5
  552. package/lib/engine-components/postprocessing/utils.d.ts +11 -11
  553. package/lib/engine-components/postprocessing/utils.js +37 -37
  554. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  555. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  556. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  557. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  558. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  559. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  560. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  561. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  562. package/lib/engine-components/timeline/index.d.ts +4 -4
  563. package/lib/engine-components/timeline/index.js +3 -3
  564. package/lib/engine-components/ui/BaseUIComponent.d.ts +49 -49
  565. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  566. package/lib/engine-components/ui/Button.d.ts +64 -64
  567. package/lib/engine-components/ui/Button.js +315 -315
  568. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  569. package/lib/engine-components/ui/Canvas.js +407 -407
  570. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  571. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  572. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  573. package/lib/engine-components/ui/EventSystem.js +764 -764
  574. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  575. package/lib/engine-components/ui/Graphic.js +254 -254
  576. package/lib/engine-components/ui/Image.d.ts +35 -35
  577. package/lib/engine-components/ui/Image.js +116 -116
  578. package/lib/engine-components/ui/InputField.d.ts +42 -42
  579. package/lib/engine-components/ui/InputField.js +268 -268
  580. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  581. package/lib/engine-components/ui/Interfaces.js +12 -12
  582. package/lib/engine-components/ui/Layout.d.ts +84 -84
  583. package/lib/engine-components/ui/Layout.js +330 -330
  584. package/lib/engine-components/ui/Outline.d.ts +7 -7
  585. package/lib/engine-components/ui/Outline.js +20 -20
  586. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  587. package/lib/engine-components/ui/PointerEvents.js +145 -145
  588. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  589. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  590. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  591. package/lib/engine-components/ui/Raycaster.js +95 -95
  592. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  593. package/lib/engine-components/ui/RectTransform.js +353 -353
  594. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  595. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  596. package/lib/engine-components/ui/Text.d.ts +78 -78
  597. package/lib/engine-components/ui/Text.js +539 -539
  598. package/lib/engine-components/ui/Utils.d.ts +24 -24
  599. package/lib/engine-components/ui/Utils.js +90 -90
  600. package/lib/engine-components/ui/index.d.ts +1 -1
  601. package/lib/engine-components/ui/index.js +1 -1
  602. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  603. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  604. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  605. package/lib/engine-components/utils/LookAt.js +82 -82
  606. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  607. package/lib/engine-components/utils/OpenURL.js +119 -119
  608. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  609. package/lib/engine-components/webxr/Avatar.js +255 -255
  610. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  611. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  612. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  613. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  614. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  615. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  616. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  617. package/lib/engine-components/webxr/WebXR.js +561 -561
  618. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  619. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  620. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  621. package/lib/engine-components/webxr/WebXRImageTracking.js +470 -470
  622. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  623. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  624. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  625. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  626. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  627. package/lib/engine-components/webxr/XRFlag.js +139 -139
  628. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  629. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  630. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  631. package/lib/engine-components/webxr/controllers/XRControllerModel.js +351 -351
  632. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  633. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  634. package/lib/engine-components/webxr/index.d.ts +3 -3
  635. package/lib/engine-components/webxr/index.js +3 -3
  636. package/lib/engine-components/webxr/types.d.ts +3 -3
  637. package/lib/engine-components/webxr/types.js +1 -1
  638. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  639. package/lib/engine-components-experimental/Presentation.js +9 -9
  640. package/lib/engine-components-experimental/api.d.ts +4 -4
  641. package/lib/engine-components-experimental/api.js +4 -4
  642. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  643. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  644. package/lib/engine-schemes/api.d.ts +12 -12
  645. package/lib/engine-schemes/api.js +12 -12
  646. package/lib/engine-schemes/schemes.d.ts +7 -7
  647. package/lib/engine-schemes/schemes.js +19 -19
  648. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  649. package/lib/engine-schemes/synced-camera-model.js +67 -67
  650. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  651. package/lib/engine-schemes/synced-transform-model.js +66 -66
  652. package/lib/engine-schemes/transform.d.ts +12 -12
  653. package/lib/engine-schemes/transform.js +39 -39
  654. package/lib/engine-schemes/vec2.d.ts +10 -10
  655. package/lib/engine-schemes/vec2.js +25 -25
  656. package/lib/engine-schemes/vec3.d.ts +11 -11
  657. package/lib/engine-schemes/vec3.js +29 -29
  658. package/lib/engine-schemes/vec4.d.ts +12 -12
  659. package/lib/engine-schemes/vec4.js +33 -33
  660. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  661. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  662. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  663. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  664. package/lib/needle-engine.d.ts +7 -7
  665. package/lib/needle-engine.js +64 -64
  666. package/package.json +1 -1
  667. package/plugins/common/buildinfo.js +64 -64
  668. package/plugins/common/cloud.js +1 -1
  669. package/plugins/common/config.cjs +31 -31
  670. package/plugins/common/config.js +35 -35
  671. package/plugins/common/files.js +31 -31
  672. package/plugins/common/generator.js +10 -10
  673. package/plugins/common/license.js +341 -330
  674. package/plugins/common/npm.js +15 -15
  675. package/plugins/common/timers.js +7 -7
  676. package/plugins/common/version.js +37 -37
  677. package/plugins/gltf-packer.mjs +1 -1
  678. package/plugins/next/alias.cjs +39 -39
  679. package/plugins/next/license.cjs +18 -18
  680. package/plugins/next/meshbvhworker.cjs +18 -18
  681. package/plugins/next/next.js +128 -128
  682. package/plugins/types/index.d.ts +2 -2
  683. package/plugins/types/license.d.ts +24 -24
  684. package/plugins/types/needleConfig.d.ts +27 -27
  685. package/plugins/types/userconfig.d.ts +105 -105
  686. package/plugins/types/webmanifest.d.ts +32 -32
  687. package/plugins/vite/alias.js +174 -174
  688. package/plugins/vite/asap.js +245 -245
  689. package/plugins/vite/build-pipeline.js +355 -355
  690. package/plugins/vite/build.js +19 -19
  691. package/plugins/vite/buildinfo.js +41 -41
  692. package/plugins/vite/config.js +106 -106
  693. package/plugins/vite/copyfiles.js +138 -138
  694. package/plugins/vite/defines.js +66 -66
  695. package/plugins/vite/dependencies.js +216 -216
  696. package/plugins/vite/dependency-watcher.js +231 -231
  697. package/plugins/vite/drop-client.js +76 -76
  698. package/plugins/vite/drop.js +87 -87
  699. package/plugins/vite/editor-connection.js +124 -124
  700. package/plugins/vite/facebook-instant-games.js +99 -99
  701. package/plugins/vite/gzip.js +5 -5
  702. package/plugins/vite/imports-logger.js +143 -143
  703. package/plugins/vite/index.js +139 -139
  704. package/plugins/vite/license.js +55 -55
  705. package/plugins/vite/meta.js +163 -163
  706. package/plugins/vite/npm.js +7 -7
  707. package/plugins/vite/peer.js +29 -29
  708. package/plugins/vite/poster-client.js +73 -73
  709. package/plugins/vite/poster.js +79 -79
  710. package/plugins/vite/pwa.js +604 -604
  711. package/plugins/vite/reload-client.js +15 -15
  712. package/plugins/vite/reload.js +363 -363
  713. package/plugins/vite/server.js +66 -66
  714. package/plugins/vite/transform-codegen.js +55 -55
  715. package/plugins/vite/transform.js +31 -31
  716. package/plugins/vite/vite-4.4-hack.js +31 -31
  717. package/src/asap/needle-asap.ts +111 -111
  718. package/src/asap/sessiongranted.ts +75 -75
  719. package/src/asap/utils.ts +4 -4
  720. package/src/engine/analytics/index.ts +10 -10
  721. package/src/engine/analytics/lcp.ts +35 -35
  722. package/src/engine/api.ts +81 -81
  723. package/src/engine/assets/index.ts +59 -59
  724. package/src/engine/assets/static.js +5 -5
  725. package/src/engine/codegen/register_types.ts +300 -300
  726. package/src/engine/debug/debug.ts +51 -51
  727. package/src/engine/debug/debug_console.ts +333 -333
  728. package/src/engine/debug/debug_overlay.ts +332 -332
  729. package/src/engine/debug/debug_spatial_console.ts +429 -429
  730. package/src/engine/debug/index.ts +1 -1
  731. package/src/engine/engine_addressables.ts +679 -679
  732. package/src/engine/engine_animation.ts +145 -145
  733. package/src/engine/engine_application.ts +113 -113
  734. package/src/engine/engine_assetdatabase.ts +387 -387
  735. package/src/engine/engine_audio.ts +24 -24
  736. package/src/engine/engine_camera.ts +39 -39
  737. package/src/engine/engine_components.ts +374 -373
  738. package/src/engine/engine_components_internal.ts +40 -40
  739. package/src/engine/engine_constants.ts +52 -52
  740. package/src/engine/engine_context.ts +1662 -1662
  741. package/src/engine/engine_context_registry.ts +129 -129
  742. package/src/engine/engine_coroutine.ts +54 -54
  743. package/src/engine/engine_create_objects.ts +398 -398
  744. package/src/engine/engine_default_parameters.ts +3 -3
  745. package/src/engine/engine_editor-sync.ts +28 -28
  746. package/src/engine/engine_element.ts +869 -871
  747. package/src/engine/engine_element_attributes.ts +85 -85
  748. package/src/engine/engine_element_extras.ts +16 -16
  749. package/src/engine/engine_element_loading.ts +381 -381
  750. package/src/engine/engine_element_overlay.ts +186 -186
  751. package/src/engine/engine_fileloader.js +9 -9
  752. package/src/engine/engine_gameobject.ts +684 -684
  753. package/src/engine/engine_generic_utils.js +13 -13
  754. package/src/engine/engine_gizmos.ts +577 -577
  755. package/src/engine/engine_gltf.ts +29 -29
  756. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  757. package/src/engine/engine_hot_reload.ts +198 -198
  758. package/src/engine/engine_input.ts +1460 -1460
  759. package/src/engine/engine_input_utils.ts +23 -23
  760. package/src/engine/engine_instancing.ts +45 -45
  761. package/src/engine/engine_license.ts +329 -329
  762. package/src/engine/engine_lifecycle_api.ts +106 -106
  763. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  764. package/src/engine/engine_lightdata.ts +117 -117
  765. package/src/engine/engine_loaders.ts +82 -82
  766. package/src/engine/engine_lods.ts +168 -168
  767. package/src/engine/engine_mainloop_utils.ts +472 -472
  768. package/src/engine/engine_math.ts +282 -282
  769. package/src/engine/engine_modules.ts +83 -83
  770. package/src/engine/engine_networking.ts +841 -841
  771. package/src/engine/engine_networking_auto.ts +352 -352
  772. package/src/engine/engine_networking_blob.ts +254 -254
  773. package/src/engine/engine_networking_files.ts +217 -217
  774. package/src/engine/engine_networking_files_default_components.ts +58 -58
  775. package/src/engine/engine_networking_instantiate.ts +419 -419
  776. package/src/engine/engine_networking_peer.ts +159 -159
  777. package/src/engine/engine_networking_streams.ts +713 -713
  778. package/src/engine/engine_networking_types.ts +24 -24
  779. package/src/engine/engine_networking_utils.ts +23 -23
  780. package/src/engine/engine_networking_websocket.ts +2 -2
  781. package/src/engine/engine_patcher.ts +199 -199
  782. package/src/engine/engine_physics.ts +783 -783
  783. package/src/engine/engine_physics.types.ts +46 -46
  784. package/src/engine/engine_physics_rapier.ts +1579 -1579
  785. package/src/engine/engine_playerview.ts +80 -80
  786. package/src/engine/engine_scenelighting.ts +294 -294
  787. package/src/engine/engine_scenetools.ts +365 -365
  788. package/src/engine/engine_serialization.ts +2 -2
  789. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  790. package/src/engine/engine_serialization_core.ts +705 -705
  791. package/src/engine/engine_serialization_decorator.ts +80 -80
  792. package/src/engine/engine_setup.ts +1 -1
  793. package/src/engine/engine_shaders.ts +267 -267
  794. package/src/engine/engine_shims.ts +32 -32
  795. package/src/engine/engine_test_utils.ts +109 -109
  796. package/src/engine/engine_texture.ts +82 -82
  797. package/src/engine/engine_three_utils.ts +849 -849
  798. package/src/engine/engine_time.ts +94 -94
  799. package/src/engine/engine_time_utils.ts +237 -237
  800. package/src/engine/engine_tonemapping.ts +210 -210
  801. package/src/engine/engine_types.ts +714 -714
  802. package/src/engine/engine_typestore.ts +63 -63
  803. package/src/engine/engine_util_decorator.ts +136 -136
  804. package/src/engine/engine_utils.ts +972 -972
  805. package/src/engine/engine_utils_format.ts +212 -212
  806. package/src/engine/engine_utils_screenshot.ts +698 -698
  807. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  808. package/src/engine/export/gltf/Writers.ts +34 -34
  809. package/src/engine/export/gltf/index.ts +158 -158
  810. package/src/engine/export/index.ts +2 -2
  811. package/src/engine/export/state.ts +19 -19
  812. package/src/engine/export/utils.ts +9 -9
  813. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  814. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  815. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  816. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  817. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  818. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  819. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  820. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  821. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  822. package/src/engine/extensions/extension_resolver.ts +4 -4
  823. package/src/engine/extensions/extension_utils.ts +166 -166
  824. package/src/engine/extensions/extensions.ts +135 -135
  825. package/src/engine/extensions/index.ts +5 -5
  826. package/src/engine/extensions/usage_tracker.ts +100 -100
  827. package/src/engine/js-extensions/Camera.ts +37 -37
  828. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  829. package/src/engine/js-extensions/Layers.ts +23 -23
  830. package/src/engine/js-extensions/Object3D.ts +296 -296
  831. package/src/engine/js-extensions/RGBAColor.ts +125 -75
  832. package/src/engine/js-extensions/Vector.ts +18 -18
  833. package/src/engine/js-extensions/index.ts +4 -4
  834. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +122 -122
  835. package/src/engine/shaders/shaderData.ts +67 -67
  836. package/src/engine/tests/test_utils.ts +63 -63
  837. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  838. package/src/engine/webcomponents/api.ts +6 -6
  839. package/src/engine/webcomponents/buttons.ts +262 -262
  840. package/src/engine/webcomponents/fonts.ts +41 -41
  841. package/src/engine/webcomponents/icons.ts +57 -57
  842. package/src/engine/webcomponents/index.ts +1 -1
  843. package/src/engine/webcomponents/logo-element.ts +78 -78
  844. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  845. package/src/engine/webcomponents/needle menu/needle-menu.ts +1107 -1107
  846. package/src/engine/webcomponents/needle-button.ts +181 -181
  847. package/src/engine/xr/NeedleXRController.ts +1126 -1126
  848. package/src/engine/xr/NeedleXRSession.ts +1585 -1585
  849. package/src/engine/xr/NeedleXRSync.ts +220 -220
  850. package/src/engine/xr/SceneTransition.ts +78 -78
  851. package/src/engine/xr/TempXRContext.ts +216 -216
  852. package/src/engine/xr/XRRig.ts +9 -9
  853. package/src/engine/xr/api.ts +5 -5
  854. package/src/engine/xr/events.ts +102 -102
  855. package/src/engine/xr/internal.ts +34 -34
  856. package/src/engine/xr/usdz.ts +30 -30
  857. package/src/engine/xr/utils.ts +39 -39
  858. package/src/engine-components/AlignmentConstraint.ts +36 -36
  859. package/src/engine-components/Animation.ts +557 -557
  860. package/src/engine-components/AnimationCurve.ts +150 -150
  861. package/src/engine-components/AnimationUtils.ts +28 -28
  862. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  863. package/src/engine-components/Animator.ts +397 -397
  864. package/src/engine-components/AnimatorController.ts +1293 -1293
  865. package/src/engine-components/AudioListener.ts +92 -92
  866. package/src/engine-components/AudioSource.ts +639 -639
  867. package/src/engine-components/AvatarLoader.ts +263 -263
  868. package/src/engine-components/AxesHelper.ts +59 -59
  869. package/src/engine-components/BasicIKConstraint.ts +54 -54
  870. package/src/engine-components/BoxCollider.ts +1 -1
  871. package/src/engine-components/BoxHelperComponent.ts +114 -114
  872. package/src/engine-components/Camera.ts +719 -707
  873. package/src/engine-components/CameraUtils.ts +133 -142
  874. package/src/engine-components/CharacterController.ts +253 -253
  875. package/src/engine-components/Collider.ts +374 -374
  876. package/src/engine-components/Component.ts +1294 -1294
  877. package/src/engine-components/ContactShadows.ts +482 -482
  878. package/src/engine-components/DeleteBox.ts +62 -62
  879. package/src/engine-components/DeviceFlag.ts +46 -46
  880. package/src/engine-components/DragControls.ts +1623 -1623
  881. package/src/engine-components/DropListener.ts +698 -698
  882. package/src/engine-components/Duplicatable.ts +198 -198
  883. package/src/engine-components/EventList.ts +266 -266
  884. package/src/engine-components/EventTrigger.ts +74 -74
  885. package/src/engine-components/EventType.ts +22 -22
  886. package/src/engine-components/Fog.ts +60 -60
  887. package/src/engine-components/Gizmos.ts +56 -56
  888. package/src/engine-components/GridHelper.ts +48 -48
  889. package/src/engine-components/GroundProjection.ts +356 -356
  890. package/src/engine-components/Interactable.ts +14 -14
  891. package/src/engine-components/Joints.ts +52 -52
  892. package/src/engine-components/LODGroup.ts +153 -153
  893. package/src/engine-components/Light.ts +558 -558
  894. package/src/engine-components/LookAtConstraint.ts +25 -25
  895. package/src/engine-components/NeedleMenu.ts +84 -84
  896. package/src/engine-components/NestedGltf.ts +86 -86
  897. package/src/engine-components/Networking.ts +114 -114
  898. package/src/engine-components/OffsetConstraint.ts +60 -60
  899. package/src/engine-components/OrbitControls.ts +1068 -1068
  900. package/src/engine-components/PlayerColor.ts +103 -103
  901. package/src/engine-components/ReflectionProbe.ts +216 -209
  902. package/src/engine-components/Renderer.ts +900 -900
  903. package/src/engine-components/RendererInstancing.ts +855 -855
  904. package/src/engine-components/RendererLightmap.ts +198 -198
  905. package/src/engine-components/RigidBody.ts +526 -526
  906. package/src/engine-components/SceneSwitcher.ts +1013 -1013
  907. package/src/engine-components/ScreenCapture.ts +592 -592
  908. package/src/engine-components/ShadowCatcher.ts +172 -172
  909. package/src/engine-components/Skybox.ts +455 -455
  910. package/src/engine-components/SmoothFollow.ts +76 -76
  911. package/src/engine-components/SpatialTrigger.ts +229 -229
  912. package/src/engine-components/SpectatorCamera.ts +787 -787
  913. package/src/engine-components/SphereCollider.ts +1 -1
  914. package/src/engine-components/SpriteRenderer.ts +468 -468
  915. package/src/engine-components/SyncedCamera.ts +220 -220
  916. package/src/engine-components/SyncedRoom.ts +380 -380
  917. package/src/engine-components/SyncedTransform.ts +383 -378
  918. package/src/engine-components/TestRunner.ts +118 -118
  919. package/src/engine-components/TransformGizmo.ts +219 -219
  920. package/src/engine-components/VideoPlayer.ts +1025 -1025
  921. package/src/engine-components/Voip.ts +363 -363
  922. package/src/engine-components/api.ts +60 -60
  923. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  924. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  925. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  926. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  927. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  928. package/src/engine-components/codegen/components.ts +217 -217
  929. package/src/engine-components/debug/LogStats.ts +21 -21
  930. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  931. package/src/engine-components/export/usdz/Extension.ts +24 -24
  932. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2413 -2413
  933. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  934. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  935. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  936. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  937. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  938. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  939. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  940. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  941. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  942. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  943. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  944. package/src/engine-components/export/usdz/index.ts +2 -2
  945. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  946. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  947. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  948. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  949. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  950. package/src/engine-components/particlesystem/api.ts +1 -1
  951. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +55 -55
  952. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  953. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  954. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +95 -95
  955. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  956. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  957. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  958. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  959. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +191 -191
  960. package/src/engine-components/postprocessing/Effects/Sharpening.ts +138 -138
  961. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  962. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +155 -155
  963. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  964. package/src/engine-components/postprocessing/PostProcessingEffect.ts +172 -172
  965. package/src/engine-components/postprocessing/PostProcessingHandler.ts +398 -398
  966. package/src/engine-components/postprocessing/Volume.ts +410 -410
  967. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  968. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  969. package/src/engine-components/postprocessing/index.ts +5 -5
  970. package/src/engine-components/postprocessing/utils.ts +52 -52
  971. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  972. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  973. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  974. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  975. package/src/engine-components/timeline/index.ts +3 -3
  976. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  977. package/src/engine-components/ui/Button.ts +307 -307
  978. package/src/engine-components/ui/Canvas.ts +419 -419
  979. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  980. package/src/engine-components/ui/EventSystem.ts +853 -853
  981. package/src/engine-components/ui/Graphic.ts +275 -275
  982. package/src/engine-components/ui/Image.ts +112 -112
  983. package/src/engine-components/ui/InputField.ts +321 -321
  984. package/src/engine-components/ui/Interfaces.ts +57 -57
  985. package/src/engine-components/ui/Layout.ts +334 -334
  986. package/src/engine-components/ui/Outline.ts +13 -13
  987. package/src/engine-components/ui/PointerEvents.ts +206 -206
  988. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  989. package/src/engine-components/ui/Raycaster.ts +102 -102
  990. package/src/engine-components/ui/RectTransform.ts +372 -372
  991. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  992. package/src/engine-components/ui/Text.ts +578 -578
  993. package/src/engine-components/ui/Utils.ts +112 -112
  994. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  995. package/src/engine-components/utils/LookAt.ts +88 -88
  996. package/src/engine-components/utils/OpenURL.ts +114 -114
  997. package/src/engine-components/webxr/Avatar.ts +265 -265
  998. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  999. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  1000. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  1001. package/src/engine-components/webxr/WebXR.ts +585 -585
  1002. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  1003. package/src/engine-components/webxr/WebXRImageTracking.ts +518 -518
  1004. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  1005. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  1006. package/src/engine-components/webxr/XRFlag.ts +147 -147
  1007. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  1008. package/src/engine-components/webxr/controllers/XRControllerModel.ts +374 -374
  1009. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  1010. package/src/engine-components/webxr/index.ts +2 -2
  1011. package/src/engine-components/webxr/types.ts +3 -3
  1012. package/src/engine-components-experimental/Presentation.ts +12 -12
  1013. package/src/engine-components-experimental/api.ts +4 -4
  1014. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  1015. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  1016. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  1017. package/src/engine-schemes/README.md +1 -1
  1018. package/src/engine-schemes/api.ts +12 -12
  1019. package/src/engine-schemes/dist/api.js +17 -0
  1020. package/src/engine-schemes/dist/api.js.meta +7 -0
  1021. package/src/engine-schemes/dist/schemes.js +25 -0
  1022. package/src/engine-schemes/dist/schemes.js.meta +7 -0
  1023. package/src/engine-schemes/dist/synced-camera-model.js +74 -0
  1024. package/src/engine-schemes/dist/synced-camera-model.js.meta +7 -0
  1025. package/src/engine-schemes/dist/synced-transform-model.js +73 -0
  1026. package/src/engine-schemes/dist/synced-transform-model.js.meta +7 -0
  1027. package/src/engine-schemes/dist/transform.js +46 -0
  1028. package/src/engine-schemes/dist/transform.js.meta +7 -0
  1029. package/src/engine-schemes/dist/vec2.js +32 -0
  1030. package/src/engine-schemes/dist/vec2.js.meta +7 -0
  1031. package/src/engine-schemes/dist/vec3.js +36 -0
  1032. package/src/engine-schemes/dist/vec3.js.meta +7 -0
  1033. package/src/engine-schemes/dist/vec4.js +40 -0
  1034. package/src/engine-schemes/dist/vec4.js.meta +7 -0
  1035. package/src/engine-schemes/dist/vr-user-state-buffer.js +110 -0
  1036. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +7 -0
  1037. package/src/engine-schemes/schemes.ts +28 -28
  1038. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1039. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1040. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1041. package/src/engine-schemes/transform.ts +50 -50
  1042. package/src/engine-schemes/transforms.fbs +25 -25
  1043. package/src/engine-schemes/vec.fbs +19 -19
  1044. package/src/engine-schemes/vec2.ts +33 -33
  1045. package/src/engine-schemes/vec3.ts +38 -38
  1046. package/src/engine-schemes/vec4.ts +43 -43
  1047. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1048. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1049. package/src/include/draco/draco_decoder.js +34 -34
  1050. package/src/include/ktx2/basis_transcoder.js +21 -21
  1051. package/src/include/needle/arial-msdf.json +1471 -1471
  1052. package/src/include/three/DragControls.js +231 -231
  1053. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1054. package/src/needle-engine.ts +70 -70
@@ -1,979 +1,979 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- import { ShaderMaterial, SRGBColorSpace, Texture, Vector2, Vector4, VideoTexture } from "three";
8
- import { isDevEnvironment } from "../engine/debug/index.js";
9
- import { ObjectUtils, PrimitiveType } from "../engine/engine_create_objects.js";
10
- import { awaitInput } from "../engine/engine_input_utils.js";
11
- import { serializable } from "../engine/engine_serialization_decorator.js";
12
- import { getWorldScale } from "../engine/engine_three_utils.js";
13
- import { getParam } from "../engine/engine_utils.js";
14
- import { Behaviour, GameObject } from "./Component.js";
15
- import { Renderer } from "./Renderer.js";
16
- const debug = getParam("debugvideo");
17
- export var AspectMode;
18
- (function (AspectMode) {
19
- AspectMode[AspectMode["None"] = 0] = "None";
20
- AspectMode[AspectMode["AdjustHeight"] = 1] = "AdjustHeight";
21
- AspectMode[AspectMode["AdjustWidth"] = 2] = "AdjustWidth";
22
- })(AspectMode || (AspectMode = {}));
23
- export var VideoSource;
24
- (function (VideoSource) {
25
- /// <summary>
26
- /// <para>Use the current clip as the video content source.</para>
27
- /// </summary>
28
- VideoSource[VideoSource["VideoClip"] = 0] = "VideoClip";
29
- /// <summary>
30
- /// <para>Use the current URL as the video content source.</para>
31
- /// </summary>
32
- VideoSource[VideoSource["Url"] = 1] = "Url";
33
- })(VideoSource || (VideoSource = {}));
34
- export var VideoAudioOutputMode;
35
- (function (VideoAudioOutputMode) {
36
- VideoAudioOutputMode[VideoAudioOutputMode["None"] = 0] = "None";
37
- VideoAudioOutputMode[VideoAudioOutputMode["AudioSource"] = 1] = "AudioSource";
38
- VideoAudioOutputMode[VideoAudioOutputMode["Direct"] = 2] = "Direct";
39
- VideoAudioOutputMode[VideoAudioOutputMode["APIOnly"] = 3] = "APIOnly";
40
- })(VideoAudioOutputMode || (VideoAudioOutputMode = {}));
41
- export var VideoRenderMode;
42
- (function (VideoRenderMode) {
43
- VideoRenderMode[VideoRenderMode["CameraFarPlane"] = 0] = "CameraFarPlane";
44
- VideoRenderMode[VideoRenderMode["CameraNearPlane"] = 1] = "CameraNearPlane";
45
- VideoRenderMode[VideoRenderMode["RenderTexture"] = 2] = "RenderTexture";
46
- VideoRenderMode[VideoRenderMode["MaterialOverride"] = 3] = "MaterialOverride";
47
- })(VideoRenderMode || (VideoRenderMode = {}));
48
- /**
49
- * The VideoPlayer component can be used to playback video clips from urls, streams or m3u8 playlists (livestreams)
50
- * @example Add a video player component to a game object and set the url to a video file. The video will start playing once the object becomes active in your scene
51
- * ```typescript
52
- * // Add a video player component to a game object and set the url to a video file. The video will start playing once the object becomes active in your scene
53
- * const videoPlayer = addComponent(obj, VideoPlayer, {
54
- * url: "https://www.w3schools.com/html/mov_bbb.mp4",
55
- * playOnAwake: true,
56
- * });
57
- * ```
58
- * @category Multimedia
59
- * @group Components
60
- */
61
- export class VideoPlayer extends Behaviour {
62
- /**
63
- * When true the video will start playing as soon as the component is enabled
64
- */
65
- playOnAwake = true;
66
- /**
67
- * The aspect mode to use for the video. If
68
- */
69
- aspectMode = AspectMode.None;
70
- clip = null;
71
- // set a default src, this should not be undefined
72
- source = VideoSource.Url;
73
- /**
74
- * The video clip url to play.
75
- */
76
- get url() { return this._url; }
77
- /**
78
- * The video clip to play.
79
- */
80
- set url(val) {
81
- const prev = this._url;
82
- const changed = prev !== val;
83
- if (this.__didAwake) {
84
- if (changed) {
85
- this.setClipURL(val ?? "");
86
- }
87
- }
88
- else
89
- this._url = val;
90
- }
91
- _url = null;
92
- renderMode;
93
- targetMaterialProperty;
94
- targetMaterialRenderer;
95
- targetTexture;
96
- time = 0;
97
- _playbackSpeed = 1;
98
- /**
99
- * Get the video playback speed. Increasing this value will speed up the video, decreasing it will slow it down.
100
- * @default 1
101
- */
102
- get playbackSpeed() {
103
- return this._videoElement?.playbackRate ?? this._playbackSpeed;
104
- }
105
- /**
106
- * Set the video playback speed. Increasing this value will speed up the video, decreasing it will slow it down.
107
- */
108
- set playbackSpeed(val) {
109
- this._playbackSpeed = val;
110
- if (this._videoElement)
111
- this._videoElement.playbackRate = val;
112
- }
113
- _isLooping = false;
114
- get isLooping() {
115
- return this._videoElement?.loop ?? this._isLooping;
116
- }
117
- set isLooping(val) {
118
- this._isLooping = val;
119
- if (this._videoElement)
120
- this._videoElement.loop = val;
121
- }
122
- /**
123
- * @returns the current time of the video in seconds
124
- */
125
- get currentTime() {
126
- return this._videoElement?.currentTime ?? this.time;
127
- }
128
- /**
129
- * set the current time of the video in seconds
130
- */
131
- set currentTime(val) {
132
- if (this._videoElement) {
133
- this._videoElement.currentTime = val;
134
- }
135
- else
136
- this.time = val;
137
- }
138
- /**
139
- * @returns true if the video is currently playing
140
- */
141
- get isPlaying() {
142
- const video = this._videoElement;
143
- if (video) {
144
- if (video.currentTime > 0 && !video.paused && !video.ended
145
- && video.readyState > video.HAVE_CURRENT_DATA)
146
- return true;
147
- else if (video.srcObject) {
148
- const stream = video.srcObject;
149
- if (stream.active)
150
- return true;
151
- }
152
- }
153
- return false;
154
- }
155
- get crossOrigin() {
156
- return this._videoElement?.crossOrigin ?? this._crossOrigin;
157
- }
158
- set crossOrigin(val) {
159
- this._crossOrigin = val;
160
- if (this._videoElement) {
161
- if (val !== null)
162
- this._videoElement.setAttribute("crossorigin", val);
163
- else
164
- this._videoElement.removeAttribute("crossorigin");
165
- }
166
- }
167
- /**
168
- * the material that is used to render the video
169
- */
170
- get videoMaterial() {
171
- if (!this._videoMaterial)
172
- if (!this.create(false))
173
- return null;
174
- return this._videoMaterial;
175
- }
176
- /**
177
- * the video texture that is used to render the video
178
- */
179
- get videoTexture() {
180
- if (!this._videoTexture)
181
- if (!this.create(false))
182
- return null;
183
- return this._videoTexture;
184
- }
185
- /**
186
- * the HTMLVideoElement that is used to play the video
187
- */
188
- get videoElement() {
189
- if (!this._videoElement)
190
- if (!this.create(false))
191
- return null;
192
- return this._videoElement;
193
- }
194
- /**
195
- * Request the browser to enter picture in picture mode
196
- * @link https://developer.mozilla.org/en-US/docs/Web/API/Picture-in-Picture_API
197
- * @returns the promise returned by the browser
198
- */
199
- requestPictureInPicture() {
200
- if (this._videoElement)
201
- return this._videoElement.requestPictureInPicture();
202
- return null;
203
- }
204
- /**
205
- * @returns true if the video is muted
206
- */
207
- get muted() {
208
- return this._videoElement?.muted ?? this._muted;
209
- }
210
- /**
211
- * set the video to be muted
212
- */
213
- set muted(val) {
214
- this._muted = val;
215
- if (this._videoElement)
216
- this._videoElement.muted = val;
217
- }
218
- _muted = false;
219
- /**
220
- * The current video clip that is being played
221
- */
222
- get currentVideo() {
223
- return this.clip;
224
- }
225
- set audioOutputMode(mode) {
226
- if (mode !== this._audioOutputMode) {
227
- if (mode === VideoAudioOutputMode.AudioSource && isDevEnvironment())
228
- console.warn("VideoAudioOutputMode.AudioSource is not yet implemented");
229
- this._audioOutputMode = mode;
230
- this.updateVideoElementSettings();
231
- }
232
- }
233
- get audioOutputMode() { return this._audioOutputMode; }
234
- _audioOutputMode = VideoAudioOutputMode.Direct;
235
- /** Set this to false to pause video playback while the tab is not active
236
- * @default true
237
- */
238
- playInBackground = true;
239
- _crossOrigin = "anonymous";
240
- _videoElement = null;
241
- _videoTexture = null;
242
- _videoMaterial = null;
243
- _isPlaying = false;
244
- wasPlaying = false;
245
- /** ensure's the video element has been created and will start loading the clip */
246
- preloadVideo() {
247
- if (debug)
248
- console.log("Video Preload: " + this.name, this.clip);
249
- this.create(false);
250
- }
251
- /** @deprecated use `preloadVideo()` */
252
- preload() { this.preloadVideo(); }
253
- /** Set a new video stream
254
- * starts to play automatically if the videoplayer hasnt been active before and playOnAwake is true */
255
- setVideo(video) {
256
- this.clip = video;
257
- this.source = VideoSource.VideoClip;
258
- if (!this._videoElement)
259
- this.create(this.playOnAwake);
260
- else {
261
- // TODO: how to prevent interruption error when another video is already playing
262
- this._videoElement.srcObject = video;
263
- if (this._isPlaying)
264
- this.play();
265
- this.updateAspect();
266
- }
267
- }
268
- setClipURL(url) {
269
- if (this._url === url)
270
- return;
271
- this._url = url;
272
- this.source = VideoSource.Url;
273
- if (debug)
274
- console.log("set url", url);
275
- if (!this._videoElement)
276
- this.create(this.playOnAwake);
277
- else {
278
- if (url.endsWith(".m3u8") || url.includes(".m3u")) {
279
- this.ensureM3UCanBePlayed();
280
- }
281
- else {
282
- this._videoElement.src = url;
283
- if (this._isPlaying) {
284
- this.stop();
285
- this.play();
286
- }
287
- }
288
- }
289
- }
290
- /** @internal */
291
- onEnable() {
292
- if (debug)
293
- console.log("VideoPlayer.onEnable", VideoSource[this.source], this.clip, this.url, this);
294
- window.addEventListener('visibilitychange', this.visibilityChanged);
295
- if (this.playOnAwake === true) {
296
- this.create(true);
297
- }
298
- else {
299
- this.preloadVideo();
300
- }
301
- if (this.screenspace) {
302
- this._overlay?.start();
303
- }
304
- else
305
- this._overlay?.stop();
306
- }
307
- /** @internal */
308
- onDisable() {
309
- window.removeEventListener('visibilitychange', this.visibilityChanged);
310
- this._overlay?.stop();
311
- this.pause();
312
- }
313
- visibilityChanged = (_) => {
314
- switch (document.visibilityState) {
315
- case "hidden":
316
- if (!this.playInBackground) {
317
- this.wasPlaying = this._isPlaying;
318
- this.pause();
319
- }
320
- break;
321
- case "visible":
322
- if (this.wasPlaying && !this._isPlaying)
323
- this.play();
324
- break;
325
- }
326
- };
327
- /** @internal */
328
- onDestroy() {
329
- if (this._videoElement) {
330
- this.videoElement?.remove();
331
- this._videoElement = null;
332
- }
333
- if (this._videoTexture) {
334
- this._videoTexture.dispose();
335
- this._videoTexture = null;
336
- }
337
- }
338
- _receivedInput = false;
339
- /**
340
- * @internal
341
- */
342
- constructor() {
343
- super();
344
- awaitInput(() => {
345
- this._receivedInput = true;
346
- this.updateVideoElementSettings();
347
- });
348
- this._targetObjects = [];
349
- if (getParam("videoscreenspace")) {
350
- window.addEventListener("keydown", evt => {
351
- if (evt.key === "f") {
352
- this.screenspace = !this.screenspace;
353
- }
354
- });
355
- }
356
- }
357
- /** start playing the video source */
358
- play() {
359
- if (!this._videoElement)
360
- this.create(false);
361
- if (!this._videoElement) {
362
- if (debug)
363
- console.warn("Can not play: no video element found", this);
364
- return;
365
- }
366
- if (this._isPlaying && !this._videoElement?.ended && !this._videoElement?.paused)
367
- return;
368
- this._isPlaying = true;
369
- if (!this._receivedInput)
370
- this._videoElement.muted = true;
371
- this.handleBeginPlaying(false);
372
- if (this.shouldUseM3U) {
373
- this.ensureM3UCanBePlayed();
374
- return;
375
- }
376
- if (debug)
377
- console.log("Video Play()", this.clip, this._videoElement, this.time);
378
- this._videoElement.currentTime = this.time;
379
- this._videoElement.play().catch(err => {
380
- console.log(err);
381
- // https://developer.chrome.com/blog/play-request-was-interrupted/
382
- if (debug)
383
- console.error("Error playing video", err, "CODE=" + err.code, this.videoElement?.src, this);
384
- setTimeout(() => {
385
- if (this._isPlaying && !this.destroyed && this.activeAndEnabled)
386
- this.play();
387
- }, 1000);
388
- });
389
- if (debug)
390
- console.log("play", this._videoElement, this.time);
391
- }
392
- /**
393
- * Stop the video playback. This will reset the video to the beginning
394
- */
395
- stop() {
396
- this._isPlaying = false;
397
- this.time = 0;
398
- if (!this._videoElement)
399
- return;
400
- this._videoElement.currentTime = 0;
401
- this._videoElement.pause();
402
- if (debug)
403
- console.log("STOP", this);
404
- }
405
- /**
406
- * Pause the video playback
407
- */
408
- pause() {
409
- this.time = this._videoElement?.currentTime ?? 0;
410
- this._isPlaying = false;
411
- this._videoElement?.pause();
412
- if (debug)
413
- console.log("PAUSE", this, this.currentTime);
414
- }
415
- /** create the video element and assign the video source url or stream */
416
- create(playAutomatically) {
417
- let src;
418
- switch (this.source) {
419
- case VideoSource.VideoClip:
420
- src = this.clip;
421
- break;
422
- case VideoSource.Url:
423
- src = this.url;
424
- if (!src?.length && typeof this.clip === "string")
425
- src = this.clip;
426
- break;
427
- }
428
- if (!src) {
429
- if (debug)
430
- console.warn("No video source set", this);
431
- return false;
432
- }
433
- if (!this._videoElement) {
434
- if (debug)
435
- console.warn("Create VideoElement", this);
436
- this._videoElement = this.createVideoElement();
437
- this.context.domElement.shadowRoot.prepend(this._videoElement);
438
- // hide it because otherwise it would overlay the website with default css
439
- this.updateVideoElementStyles();
440
- }
441
- if (typeof src === "string") {
442
- if (debug)
443
- console.log("Set Video src", src);
444
- this._videoElement.src = src;
445
- // Nor sure why we did this here, but with this code the video does not restart when being paused / enable toggled
446
- // const str = this._videoElement["captureStream"]?.call(this._videoElement);
447
- // this.clip = str;
448
- }
449
- else {
450
- if (debug)
451
- console.log("Set Video srcObject", src);
452
- this._videoElement.srcObject = src;
453
- }
454
- if (!this._videoTexture)
455
- this._videoTexture = new VideoTexture(this._videoElement);
456
- this._videoTexture.flipY = false;
457
- this._videoTexture.colorSpace = SRGBColorSpace;
458
- if (playAutomatically)
459
- this.handleBeginPlaying(playAutomatically);
460
- if (debug)
461
- console.log("Video: handle playing done...", src, playAutomatically);
462
- return true;
463
- }
464
- updateAspect() {
465
- if (this.aspectMode === AspectMode.None)
466
- return;
467
- this.startCoroutine(this.updateAspectImpl());
468
- }
469
- _overlay = null;
470
- /**
471
- * If true the video will be rendered in screenspace mode and overlayed on top of the scene.
472
- * Alternatively you can also request the video to be played in PictureInPicture mode by calling `requestPictureInPicture()`
473
- */
474
- get screenspace() {
475
- return this._overlay?.enabled ?? false;
476
- }
477
- set screenspace(val) {
478
- if (val) {
479
- if (!this._videoTexture)
480
- return;
481
- if (!this._overlay)
482
- this._overlay = new VideoOverlay(this.context);
483
- this._overlay.add(this._videoTexture);
484
- }
485
- else
486
- this._overlay?.remove(this._videoTexture);
487
- if (this._overlay)
488
- this._overlay.enabled = val;
489
- }
490
- _targetObjects;
491
- createVideoElement() {
492
- const video = document.createElement("video");
493
- if (this._crossOrigin)
494
- video.setAttribute("crossorigin", this._crossOrigin);
495
- if (debug)
496
- console.log("created video element", video);
497
- return video;
498
- }
499
- handleBeginPlaying(playAutomatically) {
500
- if (!this.activeAndEnabled)
501
- return;
502
- if (!this._videoElement)
503
- return;
504
- this._targetObjects.length = 0;
505
- let target = this.gameObject;
506
- switch (this.renderMode) {
507
- case VideoRenderMode.MaterialOverride:
508
- target = this.targetMaterialRenderer?.gameObject;
509
- if (!target)
510
- target = GameObject.getComponent(this.gameObject, Renderer)?.gameObject;
511
- break;
512
- case VideoRenderMode.RenderTexture:
513
- console.error("VideoPlayer renderTexture not implemented yet. Please use material override instead");
514
- return;
515
- }
516
- if (!target) {
517
- console.error("Missing target for video material renderer", this.name, VideoRenderMode[this.renderMode], this);
518
- return;
519
- }
520
- const mat = target["material"];
521
- if (mat) {
522
- this._targetObjects.push(target);
523
- if (mat !== this._videoMaterial) {
524
- this._videoMaterial = mat.clone();
525
- target["material"] = this._videoMaterial;
526
- }
527
- const fieldName = "map";
528
- const videoMaterial = this._videoMaterial;
529
- if (!this.targetMaterialProperty) {
530
- videoMaterial[fieldName] = this._videoTexture;
531
- }
532
- else {
533
- switch (this.targetMaterialProperty) {
534
- default:
535
- videoMaterial[fieldName] = this._videoTexture;
536
- break;
537
- // doesnt render:
538
- // case "emissiveTexture":
539
- // console.log(this.videoMaterial);
540
- // // (this.videoMaterial as any).map = this.videoTexture;
541
- // (this.videoMaterial as any).emissive?.set(1,1,1);// = this.videoTexture;
542
- // (this.videoMaterial as any).emissiveMap = this.videoTexture;
543
- // break;
544
- }
545
- }
546
- }
547
- else {
548
- console.warn("Can not play video, no material found, this might be a multimaterial case which is not supported yet");
549
- return;
550
- }
551
- this.updateVideoElementSettings();
552
- this.updateVideoElementStyles();
553
- if (playAutomatically) {
554
- if (this.shouldUseM3U) {
555
- this.ensureM3UCanBePlayed();
556
- }
557
- this.play();
558
- }
559
- }
560
- updateVideoElementSettings() {
561
- if (!this._videoElement)
562
- return;
563
- this._videoElement.loop = this._isLooping;
564
- this._videoElement.currentTime = this.currentTime;
565
- this._videoElement.playbackRate = this._playbackSpeed;
566
- // dont open in fullscreen on ios
567
- this._videoElement.playsInline = true;
568
- let muted = !this._receivedInput || this.audioOutputMode === VideoAudioOutputMode.None;
569
- if (!muted && this._muted)
570
- muted = true;
571
- this._videoElement.muted = muted;
572
- if (this.playOnAwake)
573
- this._videoElement.autoplay = true;
574
- }
575
- updateVideoElementStyles() {
576
- if (!this._videoElement)
577
- return;
578
- // set style here so preview frame is rendered
579
- // set display and selectable because otherwise is interfers with input/focus e.g. breaks orbit control
580
- this._videoElement.style.userSelect = "none";
581
- this._videoElement.style.visibility = "hidden";
582
- this._videoElement.style.display = "none";
583
- this.updateAspect();
584
- }
585
- _updateAspectRoutineId = -1;
586
- *updateAspectImpl() {
587
- const id = ++this._updateAspectRoutineId;
588
- const lastAspect = undefined;
589
- const stream = this.clip;
590
- while (id === this._updateAspectRoutineId && this.aspectMode !== AspectMode.None && this.clip && stream === this.clip && this._isPlaying) {
591
- if (!stream || typeof stream === "string") {
592
- return;
593
- }
594
- let aspect = undefined;
595
- for (const track of stream.getVideoTracks()) {
596
- const settings = track.getSettings();
597
- if (settings && settings.width && settings.height) {
598
- aspect = settings.width / settings.height;
599
- break;
600
- }
601
- // on firefox capture canvas stream works but looks like
602
- // the canvas stream track doesnt contain settings?!!?
603
- else {
604
- aspect = this.context.renderer.domElement.clientWidth / this.context.renderer.domElement.clientHeight;
605
- }
606
- }
607
- if (aspect === undefined) {
608
- for (let i = 0; i < 10; i++)
609
- yield;
610
- if (!this.isPlaying)
611
- break;
612
- continue;
613
- }
614
- if (lastAspect === aspect) {
615
- yield;
616
- continue;
617
- }
618
- for (const obj of this._targetObjects) {
619
- let worldAspect = 1;
620
- if (obj.parent) {
621
- const parentScale = getWorldScale(obj.parent);
622
- worldAspect = parentScale.x / parentScale.y;
623
- }
624
- switch (this.aspectMode) {
625
- case AspectMode.AdjustHeight:
626
- obj.scale.y = 1 / aspect * obj.scale.x * worldAspect;
627
- break;
628
- case AspectMode.AdjustWidth:
629
- obj.scale.x = aspect * obj.scale.y * worldAspect;
630
- break;
631
- }
632
- }
633
- for (let i = 0; i < 3; i++)
634
- yield;
635
- }
636
- }
637
- get shouldUseM3U() { return this.url != undefined && (this.url.endsWith(".m3u8") || this.url.endsWith(".m3u")) && this.source === VideoSource.Url; }
638
- ensureM3UCanBePlayed() {
639
- if (!this.shouldUseM3U)
640
- return;
641
- let hls_script = document.head.querySelector("script[data-hls_library]");
642
- if (!hls_script) {
643
- if (debug)
644
- console.log("HLS: load script");
645
- hls_script = document.createElement("script");
646
- hls_script.dataset["hls_library"] = "hls.js";
647
- hls_script.src = "https://cdn.jsdelivr.net/npm/hls.js@1";
648
- hls_script.addEventListener("load", this.onHlsAvailable);
649
- document.head.append(hls_script);
650
- }
651
- else if (globalThis["Hls"]) {
652
- this.onHlsAvailable();
653
- }
654
- else {
655
- hls_script.addEventListener("load", this.onHlsAvailable);
656
- }
657
- }
658
- _hls;
659
- onHlsAvailable = () => {
660
- if (debug)
661
- console.log("HLS: available", this.clip);
662
- if (!this.shouldUseM3U || !this.url)
663
- return;
664
- if (!this._hls)
665
- this._hls = new Hls();
666
- this.videoElement.autoplay = true;
667
- this._hls.loadSource(this.url);
668
- this._hls.attachMedia(this.videoElement);
669
- this._videoElement?.play();
670
- if (debug)
671
- console.log("HLS: loaded", this.clip);
672
- };
673
- }
674
- __decorate([
675
- serializable()
676
- ], VideoPlayer.prototype, "playOnAwake", void 0);
677
- __decorate([
678
- serializable()
679
- ], VideoPlayer.prototype, "aspectMode", void 0);
680
- __decorate([
681
- serializable(URL)
682
- ], VideoPlayer.prototype, "clip", void 0);
683
- __decorate([
684
- serializable()
685
- ], VideoPlayer.prototype, "source", void 0);
686
- __decorate([
687
- serializable(URL)
688
- ], VideoPlayer.prototype, "url", null);
689
- __decorate([
690
- serializable()
691
- ], VideoPlayer.prototype, "renderMode", void 0);
692
- __decorate([
693
- serializable()
694
- ], VideoPlayer.prototype, "targetMaterialProperty", void 0);
695
- __decorate([
696
- serializable(Renderer)
697
- ], VideoPlayer.prototype, "targetMaterialRenderer", void 0);
698
- __decorate([
699
- serializable(Texture)
700
- ], VideoPlayer.prototype, "targetTexture", void 0);
701
- __decorate([
702
- serializable()
703
- ], VideoPlayer.prototype, "time", void 0);
704
- __decorate([
705
- serializable()
706
- ], VideoPlayer.prototype, "playbackSpeed", null);
707
- __decorate([
708
- serializable()
709
- ], VideoPlayer.prototype, "isLooping", null);
710
- __decorate([
711
- serializable()
712
- ], VideoPlayer.prototype, "audioOutputMode", null);
713
- class VideoOverlay {
714
- context;
715
- constructor(context) {
716
- this.context = context;
717
- this._input = new VideoOverlayInput(this);
718
- }
719
- get enabled() {
720
- return this._isInScreenspaceMode;
721
- }
722
- set enabled(val) {
723
- if (val)
724
- this.start();
725
- else
726
- this.stop();
727
- }
728
- add(video) {
729
- if (this._videos.indexOf(video) === -1) {
730
- this._videos.push(video);
731
- }
732
- }
733
- remove(video) {
734
- if (!video)
735
- return;
736
- const index = this._videos.indexOf(video);
737
- if (index >= 0) {
738
- this._videos.splice(index, 1);
739
- }
740
- }
741
- start() {
742
- if (this._isInScreenspaceMode)
743
- return;
744
- if (this._videos.length < 0)
745
- return;
746
- const texture = this._videos[this._videos.length - 1];
747
- if (!texture)
748
- return;
749
- this._isInScreenspaceMode = true;
750
- if (!this._screenspaceModeQuad) {
751
- this._screenspaceModeQuad = ObjectUtils.createPrimitive(PrimitiveType.Quad, {
752
- material: new ScreenspaceTexture(texture)
753
- });
754
- if (!this._screenspaceModeQuad)
755
- return;
756
- this._screenspaceModeQuad.geometry.scale(2, 2, 2);
757
- }
758
- const quad = this._screenspaceModeQuad;
759
- this.context.scene.add(quad);
760
- this.updateScreenspaceMaterialUniforms();
761
- const mat = quad.material;
762
- mat?.reset();
763
- this._input?.enable(mat);
764
- }
765
- stop() {
766
- this._isInScreenspaceMode = false;
767
- if (this._screenspaceModeQuad) {
768
- this._input?.disable();
769
- this._screenspaceModeQuad.removeFromParent();
770
- }
771
- }
772
- updateScreenspaceMaterialUniforms() {
773
- const mat = this._screenspaceModeQuad?.material;
774
- if (!mat)
775
- return;
776
- // mat.videoAspect = this.videoTexture?.image?.width / this.videoTexture?.image?.height;
777
- mat.screenAspect = this.context.domElement.clientWidth / this.context.domElement.clientHeight;
778
- }
779
- _videos = [];
780
- _screenspaceModeQuad;
781
- _isInScreenspaceMode = false;
782
- _input;
783
- }
784
- class VideoOverlayInput {
785
- _onResizeScreenFn;
786
- _onKeyUpFn;
787
- _onMouseWheelFn;
788
- context;
789
- overlay;
790
- constructor(overlay) {
791
- this.overlay = overlay;
792
- this.context = overlay.context;
793
- }
794
- _material;
795
- enable(mat) {
796
- this._material = mat;
797
- window.addEventListener("resize", this._onResizeScreenFn = () => {
798
- this.overlay.updateScreenspaceMaterialUniforms();
799
- });
800
- window.addEventListener("keyup", this._onKeyUpFn = (args) => {
801
- if (args.key === "Escape")
802
- this.overlay.stop();
803
- });
804
- window.addEventListener("wheel", this._onMouseWheelFn = (args) => {
805
- if (this.overlay.enabled) {
806
- mat.zoom += args.deltaY * .0005;
807
- args.preventDefault();
808
- }
809
- }, { passive: false });
810
- const delta = new Vector2();
811
- window.addEventListener("mousemove", (args) => {
812
- if (this.overlay.enabled && this.context.input.getPointerPressed(0)) {
813
- const normalizedMovement = new Vector2(args.movementX, args.movementY);
814
- normalizedMovement.x /= this.context.domElement.clientWidth;
815
- normalizedMovement.y /= this.context.domElement.clientHeight;
816
- delta.set(normalizedMovement.x, normalizedMovement.y);
817
- delta.multiplyScalar(mat.zoom / -this.context.time.deltaTime * .01);
818
- mat.offset = mat.offset.add(delta);
819
- }
820
- });
821
- window.addEventListener("pointermove", (args) => {
822
- if (this.overlay.enabled && this.context.input.getPointerPressed(0)) {
823
- const count = this.context.input.getTouchesPressedCount();
824
- if (count === 1) {
825
- delta.set(args.movementX, args.movementY);
826
- delta.multiplyScalar(mat.zoom * -this.context.time.deltaTime * .05);
827
- mat.offset = mat.offset.add(delta);
828
- }
829
- }
830
- });
831
- let lastTouchStartTime = 0;
832
- window.addEventListener("touchstart", e => {
833
- if (e.touches.length < 2) {
834
- if (this.context.time.time - lastTouchStartTime < .3) {
835
- this.overlay.stop();
836
- }
837
- lastTouchStartTime = this.context.time.time;
838
- return;
839
- }
840
- this._isPinching = true;
841
- this._lastPinch = 0;
842
- });
843
- window.addEventListener("touchmove", e => {
844
- if (!this._isPinching || !this._material)
845
- return;
846
- const touch1 = e.touches[0];
847
- const touch2 = e.touches[1];
848
- const dx = touch1.clientX - touch2.clientX;
849
- const dy = touch1.clientY - touch2.clientY;
850
- const distance = Math.sqrt(dx * dx + dy * dy);
851
- if (this._lastPinch !== 0) {
852
- const delta = distance - this._lastPinch;
853
- this._material.zoom -= delta * .004;
854
- }
855
- this._lastPinch = distance;
856
- });
857
- window.addEventListener("touchend", () => {
858
- this._isPinching = false;
859
- });
860
- }
861
- _isPinching = false;
862
- _lastPinch = 0;
863
- disable() {
864
- if (this._onResizeScreenFn) {
865
- window.removeEventListener("resize", this._onResizeScreenFn);
866
- this._onResizeScreenFn = undefined;
867
- }
868
- if (this._onKeyUpFn) {
869
- window.removeEventListener("keyup", this._onKeyUpFn);
870
- this._onKeyUpFn = undefined;
871
- }
872
- if (this._onMouseWheelFn) {
873
- window.removeEventListener("wheel", this._onMouseWheelFn);
874
- this._onMouseWheelFn = undefined;
875
- }
876
- }
877
- }
878
- class ScreenspaceTexture extends ShaderMaterial {
879
- set screenAspect(val) {
880
- this.uniforms["screenAspect"].value = val;
881
- this.needsUpdate = true;
882
- }
883
- set offset(vec) {
884
- const val = this.uniforms["offsetScale"].value;
885
- val.x = vec.x;
886
- val.y = vec.y;
887
- // console.log(val);
888
- this.uniforms["offsetScale"].value = val;
889
- this.needsUpdate = true;
890
- }
891
- _offset = new Vector2();
892
- get offset() {
893
- const val = this.uniforms["offsetScale"].value;
894
- this._offset.set(val.x, val.y);
895
- return this._offset;
896
- }
897
- set zoom(val) {
898
- const zoom = this.uniforms["offsetScale"].value;
899
- if (val < .001)
900
- val = .001;
901
- zoom.z = val;
902
- // zoom.z = this.maxZoom - val;
903
- // zoom.z /= this.maxZoom;
904
- this.needsUpdate = true;
905
- }
906
- get zoom() {
907
- return this.uniforms["offsetScale"].value.z; // * this.maxZoom;
908
- }
909
- reset() {
910
- this.offset = this.offset.set(0, 0);
911
- this.zoom = 1;
912
- this.needsUpdate = true;
913
- }
914
- // maxZoom : number = 10
915
- constructor(tex) {
916
- super();
917
- this.uniforms = {
918
- map: { value: tex },
919
- screenAspect: { value: 1 },
920
- offsetScale: { value: new Vector4(0, 0, 1, 1) }
921
- };
922
- this.vertexShader = `
923
- uniform sampler2D map;
924
- uniform float screenAspect;
925
- uniform vec4 offsetScale;
926
- varying vec2 vUv;
927
-
928
- void main() {
929
-
930
- gl_Position = vec4( position , 1.0 );
931
- vUv = uv;
932
- vUv.y = 1. - vUv.y;
933
-
934
- // fit into screen
935
- ivec2 res = textureSize(map, 0);
936
- float videoAspect = float(res.x) / float(res.y);
937
- float aspect = videoAspect / screenAspect;
938
- if(aspect >= 1.0)
939
- {
940
- vUv.y = vUv.y * aspect;
941
- float offset = (1. - aspect) * .5;
942
- vUv.y = vUv.y + offset;
943
- }
944
- else
945
- {
946
- vUv.x = vUv.x / aspect;
947
- float offset = (1. - 1. / aspect) * .5;
948
- vUv.x = vUv.x + offset;
949
- }
950
-
951
- vUv.x -= .5;
952
- vUv.y -= .5;
953
-
954
- vUv.x *= offsetScale.z;
955
- vUv.y *= offsetScale.z;
956
- vUv.x += offsetScale.x;
957
- vUv.y += offsetScale.y;
958
-
959
- vUv.x += .5;
960
- vUv.y += .5;
961
- }
962
-
963
- `;
964
- this.fragmentShader = `
965
- uniform sampler2D map;
966
- varying vec2 vUv;
967
- void main() {
968
- if(vUv.x < 0. || vUv.x > 1. || vUv.y < 0. || vUv.y > 1.)
969
- gl_FragColor = vec4(0., 0., 0., 1.);
970
- else
971
- {
972
- vec4 texcolor = texture2D(map, vUv);
973
- gl_FragColor = texcolor;
974
- }
975
- }
976
- `;
977
- }
978
- }
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { ShaderMaterial, SRGBColorSpace, Texture, Vector2, Vector4, VideoTexture } from "three";
8
+ import { isDevEnvironment } from "../engine/debug/index.js";
9
+ import { ObjectUtils, PrimitiveType } from "../engine/engine_create_objects.js";
10
+ import { awaitInput } from "../engine/engine_input_utils.js";
11
+ import { serializable } from "../engine/engine_serialization_decorator.js";
12
+ import { getWorldScale } from "../engine/engine_three_utils.js";
13
+ import { getParam } from "../engine/engine_utils.js";
14
+ import { Behaviour, GameObject } from "./Component.js";
15
+ import { Renderer } from "./Renderer.js";
16
+ const debug = getParam("debugvideo");
17
+ export var AspectMode;
18
+ (function (AspectMode) {
19
+ AspectMode[AspectMode["None"] = 0] = "None";
20
+ AspectMode[AspectMode["AdjustHeight"] = 1] = "AdjustHeight";
21
+ AspectMode[AspectMode["AdjustWidth"] = 2] = "AdjustWidth";
22
+ })(AspectMode || (AspectMode = {}));
23
+ export var VideoSource;
24
+ (function (VideoSource) {
25
+ /// <summary>
26
+ /// <para>Use the current clip as the video content source.</para>
27
+ /// </summary>
28
+ VideoSource[VideoSource["VideoClip"] = 0] = "VideoClip";
29
+ /// <summary>
30
+ /// <para>Use the current URL as the video content source.</para>
31
+ /// </summary>
32
+ VideoSource[VideoSource["Url"] = 1] = "Url";
33
+ })(VideoSource || (VideoSource = {}));
34
+ export var VideoAudioOutputMode;
35
+ (function (VideoAudioOutputMode) {
36
+ VideoAudioOutputMode[VideoAudioOutputMode["None"] = 0] = "None";
37
+ VideoAudioOutputMode[VideoAudioOutputMode["AudioSource"] = 1] = "AudioSource";
38
+ VideoAudioOutputMode[VideoAudioOutputMode["Direct"] = 2] = "Direct";
39
+ VideoAudioOutputMode[VideoAudioOutputMode["APIOnly"] = 3] = "APIOnly";
40
+ })(VideoAudioOutputMode || (VideoAudioOutputMode = {}));
41
+ export var VideoRenderMode;
42
+ (function (VideoRenderMode) {
43
+ VideoRenderMode[VideoRenderMode["CameraFarPlane"] = 0] = "CameraFarPlane";
44
+ VideoRenderMode[VideoRenderMode["CameraNearPlane"] = 1] = "CameraNearPlane";
45
+ VideoRenderMode[VideoRenderMode["RenderTexture"] = 2] = "RenderTexture";
46
+ VideoRenderMode[VideoRenderMode["MaterialOverride"] = 3] = "MaterialOverride";
47
+ })(VideoRenderMode || (VideoRenderMode = {}));
48
+ /**
49
+ * The VideoPlayer component can be used to playback video clips from urls, streams or m3u8 playlists (livestreams)
50
+ * @example Add a video player component to a game object and set the url to a video file. The video will start playing once the object becomes active in your scene
51
+ * ```typescript
52
+ * // Add a video player component to a game object and set the url to a video file. The video will start playing once the object becomes active in your scene
53
+ * const videoPlayer = addComponent(obj, VideoPlayer, {
54
+ * url: "https://www.w3schools.com/html/mov_bbb.mp4",
55
+ * playOnAwake: true,
56
+ * });
57
+ * ```
58
+ * @category Multimedia
59
+ * @group Components
60
+ */
61
+ export class VideoPlayer extends Behaviour {
62
+ /**
63
+ * When true the video will start playing as soon as the component is enabled
64
+ */
65
+ playOnAwake = true;
66
+ /**
67
+ * The aspect mode to use for the video. If
68
+ */
69
+ aspectMode = AspectMode.None;
70
+ clip = null;
71
+ // set a default src, this should not be undefined
72
+ source = VideoSource.Url;
73
+ /**
74
+ * The video clip url to play.
75
+ */
76
+ get url() { return this._url; }
77
+ /**
78
+ * The video clip to play.
79
+ */
80
+ set url(val) {
81
+ const prev = this._url;
82
+ const changed = prev !== val;
83
+ if (this.__didAwake) {
84
+ if (changed) {
85
+ this.setClipURL(val ?? "");
86
+ }
87
+ }
88
+ else
89
+ this._url = val;
90
+ }
91
+ _url = null;
92
+ renderMode;
93
+ targetMaterialProperty;
94
+ targetMaterialRenderer;
95
+ targetTexture;
96
+ time = 0;
97
+ _playbackSpeed = 1;
98
+ /**
99
+ * Get the video playback speed. Increasing this value will speed up the video, decreasing it will slow it down.
100
+ * @default 1
101
+ */
102
+ get playbackSpeed() {
103
+ return this._videoElement?.playbackRate ?? this._playbackSpeed;
104
+ }
105
+ /**
106
+ * Set the video playback speed. Increasing this value will speed up the video, decreasing it will slow it down.
107
+ */
108
+ set playbackSpeed(val) {
109
+ this._playbackSpeed = val;
110
+ if (this._videoElement)
111
+ this._videoElement.playbackRate = val;
112
+ }
113
+ _isLooping = false;
114
+ get isLooping() {
115
+ return this._videoElement?.loop ?? this._isLooping;
116
+ }
117
+ set isLooping(val) {
118
+ this._isLooping = val;
119
+ if (this._videoElement)
120
+ this._videoElement.loop = val;
121
+ }
122
+ /**
123
+ * @returns the current time of the video in seconds
124
+ */
125
+ get currentTime() {
126
+ return this._videoElement?.currentTime ?? this.time;
127
+ }
128
+ /**
129
+ * set the current time of the video in seconds
130
+ */
131
+ set currentTime(val) {
132
+ if (this._videoElement) {
133
+ this._videoElement.currentTime = val;
134
+ }
135
+ else
136
+ this.time = val;
137
+ }
138
+ /**
139
+ * @returns true if the video is currently playing
140
+ */
141
+ get isPlaying() {
142
+ const video = this._videoElement;
143
+ if (video) {
144
+ if (video.currentTime > 0 && !video.paused && !video.ended
145
+ && video.readyState > video.HAVE_CURRENT_DATA)
146
+ return true;
147
+ else if (video.srcObject) {
148
+ const stream = video.srcObject;
149
+ if (stream.active)
150
+ return true;
151
+ }
152
+ }
153
+ return false;
154
+ }
155
+ get crossOrigin() {
156
+ return this._videoElement?.crossOrigin ?? this._crossOrigin;
157
+ }
158
+ set crossOrigin(val) {
159
+ this._crossOrigin = val;
160
+ if (this._videoElement) {
161
+ if (val !== null)
162
+ this._videoElement.setAttribute("crossorigin", val);
163
+ else
164
+ this._videoElement.removeAttribute("crossorigin");
165
+ }
166
+ }
167
+ /**
168
+ * the material that is used to render the video
169
+ */
170
+ get videoMaterial() {
171
+ if (!this._videoMaterial)
172
+ if (!this.create(false))
173
+ return null;
174
+ return this._videoMaterial;
175
+ }
176
+ /**
177
+ * the video texture that is used to render the video
178
+ */
179
+ get videoTexture() {
180
+ if (!this._videoTexture)
181
+ if (!this.create(false))
182
+ return null;
183
+ return this._videoTexture;
184
+ }
185
+ /**
186
+ * the HTMLVideoElement that is used to play the video
187
+ */
188
+ get videoElement() {
189
+ if (!this._videoElement)
190
+ if (!this.create(false))
191
+ return null;
192
+ return this._videoElement;
193
+ }
194
+ /**
195
+ * Request the browser to enter picture in picture mode
196
+ * @link https://developer.mozilla.org/en-US/docs/Web/API/Picture-in-Picture_API
197
+ * @returns the promise returned by the browser
198
+ */
199
+ requestPictureInPicture() {
200
+ if (this._videoElement)
201
+ return this._videoElement.requestPictureInPicture();
202
+ return null;
203
+ }
204
+ /**
205
+ * @returns true if the video is muted
206
+ */
207
+ get muted() {
208
+ return this._videoElement?.muted ?? this._muted;
209
+ }
210
+ /**
211
+ * set the video to be muted
212
+ */
213
+ set muted(val) {
214
+ this._muted = val;
215
+ if (this._videoElement)
216
+ this._videoElement.muted = val;
217
+ }
218
+ _muted = false;
219
+ /**
220
+ * The current video clip that is being played
221
+ */
222
+ get currentVideo() {
223
+ return this.clip;
224
+ }
225
+ set audioOutputMode(mode) {
226
+ if (mode !== this._audioOutputMode) {
227
+ if (mode === VideoAudioOutputMode.AudioSource && isDevEnvironment())
228
+ console.warn("VideoAudioOutputMode.AudioSource is not yet implemented");
229
+ this._audioOutputMode = mode;
230
+ this.updateVideoElementSettings();
231
+ }
232
+ }
233
+ get audioOutputMode() { return this._audioOutputMode; }
234
+ _audioOutputMode = VideoAudioOutputMode.Direct;
235
+ /** Set this to false to pause video playback while the tab is not active
236
+ * @default true
237
+ */
238
+ playInBackground = true;
239
+ _crossOrigin = "anonymous";
240
+ _videoElement = null;
241
+ _videoTexture = null;
242
+ _videoMaterial = null;
243
+ _isPlaying = false;
244
+ wasPlaying = false;
245
+ /** ensure's the video element has been created and will start loading the clip */
246
+ preloadVideo() {
247
+ if (debug)
248
+ console.log("Video Preload: " + this.name, this.clip);
249
+ this.create(false);
250
+ }
251
+ /** @deprecated use `preloadVideo()` */
252
+ preload() { this.preloadVideo(); }
253
+ /** Set a new video stream
254
+ * starts to play automatically if the videoplayer hasnt been active before and playOnAwake is true */
255
+ setVideo(video) {
256
+ this.clip = video;
257
+ this.source = VideoSource.VideoClip;
258
+ if (!this._videoElement)
259
+ this.create(this.playOnAwake);
260
+ else {
261
+ // TODO: how to prevent interruption error when another video is already playing
262
+ this._videoElement.srcObject = video;
263
+ if (this._isPlaying)
264
+ this.play();
265
+ this.updateAspect();
266
+ }
267
+ }
268
+ setClipURL(url) {
269
+ if (this._url === url)
270
+ return;
271
+ this._url = url;
272
+ this.source = VideoSource.Url;
273
+ if (debug)
274
+ console.log("set url", url);
275
+ if (!this._videoElement)
276
+ this.create(this.playOnAwake);
277
+ else {
278
+ if (url.endsWith(".m3u8") || url.includes(".m3u")) {
279
+ this.ensureM3UCanBePlayed();
280
+ }
281
+ else {
282
+ this._videoElement.src = url;
283
+ if (this._isPlaying) {
284
+ this.stop();
285
+ this.play();
286
+ }
287
+ }
288
+ }
289
+ }
290
+ /** @internal */
291
+ onEnable() {
292
+ if (debug)
293
+ console.log("VideoPlayer.onEnable", VideoSource[this.source], this.clip, this.url, this);
294
+ window.addEventListener('visibilitychange', this.visibilityChanged);
295
+ if (this.playOnAwake === true) {
296
+ this.create(true);
297
+ }
298
+ else {
299
+ this.preloadVideo();
300
+ }
301
+ if (this.screenspace) {
302
+ this._overlay?.start();
303
+ }
304
+ else
305
+ this._overlay?.stop();
306
+ }
307
+ /** @internal */
308
+ onDisable() {
309
+ window.removeEventListener('visibilitychange', this.visibilityChanged);
310
+ this._overlay?.stop();
311
+ this.pause();
312
+ }
313
+ visibilityChanged = (_) => {
314
+ switch (document.visibilityState) {
315
+ case "hidden":
316
+ if (!this.playInBackground) {
317
+ this.wasPlaying = this._isPlaying;
318
+ this.pause();
319
+ }
320
+ break;
321
+ case "visible":
322
+ if (this.wasPlaying && !this._isPlaying)
323
+ this.play();
324
+ break;
325
+ }
326
+ };
327
+ /** @internal */
328
+ onDestroy() {
329
+ if (this._videoElement) {
330
+ this.videoElement?.remove();
331
+ this._videoElement = null;
332
+ }
333
+ if (this._videoTexture) {
334
+ this._videoTexture.dispose();
335
+ this._videoTexture = null;
336
+ }
337
+ }
338
+ _receivedInput = false;
339
+ /**
340
+ * @internal
341
+ */
342
+ constructor() {
343
+ super();
344
+ awaitInput(() => {
345
+ this._receivedInput = true;
346
+ this.updateVideoElementSettings();
347
+ });
348
+ this._targetObjects = [];
349
+ if (getParam("videoscreenspace")) {
350
+ window.addEventListener("keydown", evt => {
351
+ if (evt.key === "f") {
352
+ this.screenspace = !this.screenspace;
353
+ }
354
+ });
355
+ }
356
+ }
357
+ /** start playing the video source */
358
+ play() {
359
+ if (!this._videoElement)
360
+ this.create(false);
361
+ if (!this._videoElement) {
362
+ if (debug)
363
+ console.warn("Can not play: no video element found", this);
364
+ return;
365
+ }
366
+ if (this._isPlaying && !this._videoElement?.ended && !this._videoElement?.paused)
367
+ return;
368
+ this._isPlaying = true;
369
+ if (!this._receivedInput)
370
+ this._videoElement.muted = true;
371
+ this.handleBeginPlaying(false);
372
+ if (this.shouldUseM3U) {
373
+ this.ensureM3UCanBePlayed();
374
+ return;
375
+ }
376
+ if (debug)
377
+ console.log("Video Play()", this.clip, this._videoElement, this.time);
378
+ this._videoElement.currentTime = this.time;
379
+ this._videoElement.play().catch(err => {
380
+ console.log(err);
381
+ // https://developer.chrome.com/blog/play-request-was-interrupted/
382
+ if (debug)
383
+ console.error("Error playing video", err, "CODE=" + err.code, this.videoElement?.src, this);
384
+ setTimeout(() => {
385
+ if (this._isPlaying && !this.destroyed && this.activeAndEnabled)
386
+ this.play();
387
+ }, 1000);
388
+ });
389
+ if (debug)
390
+ console.log("play", this._videoElement, this.time);
391
+ }
392
+ /**
393
+ * Stop the video playback. This will reset the video to the beginning
394
+ */
395
+ stop() {
396
+ this._isPlaying = false;
397
+ this.time = 0;
398
+ if (!this._videoElement)
399
+ return;
400
+ this._videoElement.currentTime = 0;
401
+ this._videoElement.pause();
402
+ if (debug)
403
+ console.log("STOP", this);
404
+ }
405
+ /**
406
+ * Pause the video playback
407
+ */
408
+ pause() {
409
+ this.time = this._videoElement?.currentTime ?? 0;
410
+ this._isPlaying = false;
411
+ this._videoElement?.pause();
412
+ if (debug)
413
+ console.log("PAUSE", this, this.currentTime);
414
+ }
415
+ /** create the video element and assign the video source url or stream */
416
+ create(playAutomatically) {
417
+ let src;
418
+ switch (this.source) {
419
+ case VideoSource.VideoClip:
420
+ src = this.clip;
421
+ break;
422
+ case VideoSource.Url:
423
+ src = this.url;
424
+ if (!src?.length && typeof this.clip === "string")
425
+ src = this.clip;
426
+ break;
427
+ }
428
+ if (!src) {
429
+ if (debug)
430
+ console.warn("No video source set", this);
431
+ return false;
432
+ }
433
+ if (!this._videoElement) {
434
+ if (debug)
435
+ console.warn("Create VideoElement", this);
436
+ this._videoElement = this.createVideoElement();
437
+ this.context.domElement.shadowRoot.prepend(this._videoElement);
438
+ // hide it because otherwise it would overlay the website with default css
439
+ this.updateVideoElementStyles();
440
+ }
441
+ if (typeof src === "string") {
442
+ if (debug)
443
+ console.log("Set Video src", src);
444
+ this._videoElement.src = src;
445
+ // Nor sure why we did this here, but with this code the video does not restart when being paused / enable toggled
446
+ // const str = this._videoElement["captureStream"]?.call(this._videoElement);
447
+ // this.clip = str;
448
+ }
449
+ else {
450
+ if (debug)
451
+ console.log("Set Video srcObject", src);
452
+ this._videoElement.srcObject = src;
453
+ }
454
+ if (!this._videoTexture)
455
+ this._videoTexture = new VideoTexture(this._videoElement);
456
+ this._videoTexture.flipY = false;
457
+ this._videoTexture.colorSpace = SRGBColorSpace;
458
+ if (playAutomatically)
459
+ this.handleBeginPlaying(playAutomatically);
460
+ if (debug)
461
+ console.log("Video: handle playing done...", src, playAutomatically);
462
+ return true;
463
+ }
464
+ updateAspect() {
465
+ if (this.aspectMode === AspectMode.None)
466
+ return;
467
+ this.startCoroutine(this.updateAspectImpl());
468
+ }
469
+ _overlay = null;
470
+ /**
471
+ * If true the video will be rendered in screenspace mode and overlayed on top of the scene.
472
+ * Alternatively you can also request the video to be played in PictureInPicture mode by calling `requestPictureInPicture()`
473
+ */
474
+ get screenspace() {
475
+ return this._overlay?.enabled ?? false;
476
+ }
477
+ set screenspace(val) {
478
+ if (val) {
479
+ if (!this._videoTexture)
480
+ return;
481
+ if (!this._overlay)
482
+ this._overlay = new VideoOverlay(this.context);
483
+ this._overlay.add(this._videoTexture);
484
+ }
485
+ else
486
+ this._overlay?.remove(this._videoTexture);
487
+ if (this._overlay)
488
+ this._overlay.enabled = val;
489
+ }
490
+ _targetObjects;
491
+ createVideoElement() {
492
+ const video = document.createElement("video");
493
+ if (this._crossOrigin)
494
+ video.setAttribute("crossorigin", this._crossOrigin);
495
+ if (debug)
496
+ console.log("created video element", video);
497
+ return video;
498
+ }
499
+ handleBeginPlaying(playAutomatically) {
500
+ if (!this.activeAndEnabled)
501
+ return;
502
+ if (!this._videoElement)
503
+ return;
504
+ this._targetObjects.length = 0;
505
+ let target = this.gameObject;
506
+ switch (this.renderMode) {
507
+ case VideoRenderMode.MaterialOverride:
508
+ target = this.targetMaterialRenderer?.gameObject;
509
+ if (!target)
510
+ target = GameObject.getComponent(this.gameObject, Renderer)?.gameObject;
511
+ break;
512
+ case VideoRenderMode.RenderTexture:
513
+ console.error("VideoPlayer renderTexture not implemented yet. Please use material override instead");
514
+ return;
515
+ }
516
+ if (!target) {
517
+ console.error("Missing target for video material renderer", this.name, VideoRenderMode[this.renderMode], this);
518
+ return;
519
+ }
520
+ const mat = target["material"];
521
+ if (mat) {
522
+ this._targetObjects.push(target);
523
+ if (mat !== this._videoMaterial) {
524
+ this._videoMaterial = mat.clone();
525
+ target["material"] = this._videoMaterial;
526
+ }
527
+ const fieldName = "map";
528
+ const videoMaterial = this._videoMaterial;
529
+ if (!this.targetMaterialProperty) {
530
+ videoMaterial[fieldName] = this._videoTexture;
531
+ }
532
+ else {
533
+ switch (this.targetMaterialProperty) {
534
+ default:
535
+ videoMaterial[fieldName] = this._videoTexture;
536
+ break;
537
+ // doesnt render:
538
+ // case "emissiveTexture":
539
+ // console.log(this.videoMaterial);
540
+ // // (this.videoMaterial as any).map = this.videoTexture;
541
+ // (this.videoMaterial as any).emissive?.set(1,1,1);// = this.videoTexture;
542
+ // (this.videoMaterial as any).emissiveMap = this.videoTexture;
543
+ // break;
544
+ }
545
+ }
546
+ }
547
+ else {
548
+ console.warn("Can not play video, no material found, this might be a multimaterial case which is not supported yet");
549
+ return;
550
+ }
551
+ this.updateVideoElementSettings();
552
+ this.updateVideoElementStyles();
553
+ if (playAutomatically) {
554
+ if (this.shouldUseM3U) {
555
+ this.ensureM3UCanBePlayed();
556
+ }
557
+ this.play();
558
+ }
559
+ }
560
+ updateVideoElementSettings() {
561
+ if (!this._videoElement)
562
+ return;
563
+ this._videoElement.loop = this._isLooping;
564
+ this._videoElement.currentTime = this.currentTime;
565
+ this._videoElement.playbackRate = this._playbackSpeed;
566
+ // dont open in fullscreen on ios
567
+ this._videoElement.playsInline = true;
568
+ let muted = !this._receivedInput || this.audioOutputMode === VideoAudioOutputMode.None;
569
+ if (!muted && this._muted)
570
+ muted = true;
571
+ this._videoElement.muted = muted;
572
+ if (this.playOnAwake)
573
+ this._videoElement.autoplay = true;
574
+ }
575
+ updateVideoElementStyles() {
576
+ if (!this._videoElement)
577
+ return;
578
+ // set style here so preview frame is rendered
579
+ // set display and selectable because otherwise is interfers with input/focus e.g. breaks orbit control
580
+ this._videoElement.style.userSelect = "none";
581
+ this._videoElement.style.visibility = "hidden";
582
+ this._videoElement.style.display = "none";
583
+ this.updateAspect();
584
+ }
585
+ _updateAspectRoutineId = -1;
586
+ *updateAspectImpl() {
587
+ const id = ++this._updateAspectRoutineId;
588
+ const lastAspect = undefined;
589
+ const stream = this.clip;
590
+ while (id === this._updateAspectRoutineId && this.aspectMode !== AspectMode.None && this.clip && stream === this.clip && this._isPlaying) {
591
+ if (!stream || typeof stream === "string") {
592
+ return;
593
+ }
594
+ let aspect = undefined;
595
+ for (const track of stream.getVideoTracks()) {
596
+ const settings = track.getSettings();
597
+ if (settings && settings.width && settings.height) {
598
+ aspect = settings.width / settings.height;
599
+ break;
600
+ }
601
+ // on firefox capture canvas stream works but looks like
602
+ // the canvas stream track doesnt contain settings?!!?
603
+ else {
604
+ aspect = this.context.renderer.domElement.clientWidth / this.context.renderer.domElement.clientHeight;
605
+ }
606
+ }
607
+ if (aspect === undefined) {
608
+ for (let i = 0; i < 10; i++)
609
+ yield;
610
+ if (!this.isPlaying)
611
+ break;
612
+ continue;
613
+ }
614
+ if (lastAspect === aspect) {
615
+ yield;
616
+ continue;
617
+ }
618
+ for (const obj of this._targetObjects) {
619
+ let worldAspect = 1;
620
+ if (obj.parent) {
621
+ const parentScale = getWorldScale(obj.parent);
622
+ worldAspect = parentScale.x / parentScale.y;
623
+ }
624
+ switch (this.aspectMode) {
625
+ case AspectMode.AdjustHeight:
626
+ obj.scale.y = 1 / aspect * obj.scale.x * worldAspect;
627
+ break;
628
+ case AspectMode.AdjustWidth:
629
+ obj.scale.x = aspect * obj.scale.y * worldAspect;
630
+ break;
631
+ }
632
+ }
633
+ for (let i = 0; i < 3; i++)
634
+ yield;
635
+ }
636
+ }
637
+ get shouldUseM3U() { return this.url != undefined && (this.url.endsWith(".m3u8") || this.url.endsWith(".m3u")) && this.source === VideoSource.Url; }
638
+ ensureM3UCanBePlayed() {
639
+ if (!this.shouldUseM3U)
640
+ return;
641
+ let hls_script = document.head.querySelector("script[data-hls_library]");
642
+ if (!hls_script) {
643
+ if (debug)
644
+ console.log("HLS: load script");
645
+ hls_script = document.createElement("script");
646
+ hls_script.dataset["hls_library"] = "hls.js";
647
+ hls_script.src = "https://cdn.jsdelivr.net/npm/hls.js@1";
648
+ hls_script.addEventListener("load", this.onHlsAvailable);
649
+ document.head.append(hls_script);
650
+ }
651
+ else if (globalThis["Hls"]) {
652
+ this.onHlsAvailable();
653
+ }
654
+ else {
655
+ hls_script.addEventListener("load", this.onHlsAvailable);
656
+ }
657
+ }
658
+ _hls;
659
+ onHlsAvailable = () => {
660
+ if (debug)
661
+ console.log("HLS: available", this.clip);
662
+ if (!this.shouldUseM3U || !this.url)
663
+ return;
664
+ if (!this._hls)
665
+ this._hls = new Hls();
666
+ this.videoElement.autoplay = true;
667
+ this._hls.loadSource(this.url);
668
+ this._hls.attachMedia(this.videoElement);
669
+ this._videoElement?.play();
670
+ if (debug)
671
+ console.log("HLS: loaded", this.clip);
672
+ };
673
+ }
674
+ __decorate([
675
+ serializable()
676
+ ], VideoPlayer.prototype, "playOnAwake", void 0);
677
+ __decorate([
678
+ serializable()
679
+ ], VideoPlayer.prototype, "aspectMode", void 0);
680
+ __decorate([
681
+ serializable(URL)
682
+ ], VideoPlayer.prototype, "clip", void 0);
683
+ __decorate([
684
+ serializable()
685
+ ], VideoPlayer.prototype, "source", void 0);
686
+ __decorate([
687
+ serializable(URL)
688
+ ], VideoPlayer.prototype, "url", null);
689
+ __decorate([
690
+ serializable()
691
+ ], VideoPlayer.prototype, "renderMode", void 0);
692
+ __decorate([
693
+ serializable()
694
+ ], VideoPlayer.prototype, "targetMaterialProperty", void 0);
695
+ __decorate([
696
+ serializable(Renderer)
697
+ ], VideoPlayer.prototype, "targetMaterialRenderer", void 0);
698
+ __decorate([
699
+ serializable(Texture)
700
+ ], VideoPlayer.prototype, "targetTexture", void 0);
701
+ __decorate([
702
+ serializable()
703
+ ], VideoPlayer.prototype, "time", void 0);
704
+ __decorate([
705
+ serializable()
706
+ ], VideoPlayer.prototype, "playbackSpeed", null);
707
+ __decorate([
708
+ serializable()
709
+ ], VideoPlayer.prototype, "isLooping", null);
710
+ __decorate([
711
+ serializable()
712
+ ], VideoPlayer.prototype, "audioOutputMode", null);
713
+ class VideoOverlay {
714
+ context;
715
+ constructor(context) {
716
+ this.context = context;
717
+ this._input = new VideoOverlayInput(this);
718
+ }
719
+ get enabled() {
720
+ return this._isInScreenspaceMode;
721
+ }
722
+ set enabled(val) {
723
+ if (val)
724
+ this.start();
725
+ else
726
+ this.stop();
727
+ }
728
+ add(video) {
729
+ if (this._videos.indexOf(video) === -1) {
730
+ this._videos.push(video);
731
+ }
732
+ }
733
+ remove(video) {
734
+ if (!video)
735
+ return;
736
+ const index = this._videos.indexOf(video);
737
+ if (index >= 0) {
738
+ this._videos.splice(index, 1);
739
+ }
740
+ }
741
+ start() {
742
+ if (this._isInScreenspaceMode)
743
+ return;
744
+ if (this._videos.length < 0)
745
+ return;
746
+ const texture = this._videos[this._videos.length - 1];
747
+ if (!texture)
748
+ return;
749
+ this._isInScreenspaceMode = true;
750
+ if (!this._screenspaceModeQuad) {
751
+ this._screenspaceModeQuad = ObjectUtils.createPrimitive(PrimitiveType.Quad, {
752
+ material: new ScreenspaceTexture(texture)
753
+ });
754
+ if (!this._screenspaceModeQuad)
755
+ return;
756
+ this._screenspaceModeQuad.geometry.scale(2, 2, 2);
757
+ }
758
+ const quad = this._screenspaceModeQuad;
759
+ this.context.scene.add(quad);
760
+ this.updateScreenspaceMaterialUniforms();
761
+ const mat = quad.material;
762
+ mat?.reset();
763
+ this._input?.enable(mat);
764
+ }
765
+ stop() {
766
+ this._isInScreenspaceMode = false;
767
+ if (this._screenspaceModeQuad) {
768
+ this._input?.disable();
769
+ this._screenspaceModeQuad.removeFromParent();
770
+ }
771
+ }
772
+ updateScreenspaceMaterialUniforms() {
773
+ const mat = this._screenspaceModeQuad?.material;
774
+ if (!mat)
775
+ return;
776
+ // mat.videoAspect = this.videoTexture?.image?.width / this.videoTexture?.image?.height;
777
+ mat.screenAspect = this.context.domElement.clientWidth / this.context.domElement.clientHeight;
778
+ }
779
+ _videos = [];
780
+ _screenspaceModeQuad;
781
+ _isInScreenspaceMode = false;
782
+ _input;
783
+ }
784
+ class VideoOverlayInput {
785
+ _onResizeScreenFn;
786
+ _onKeyUpFn;
787
+ _onMouseWheelFn;
788
+ context;
789
+ overlay;
790
+ constructor(overlay) {
791
+ this.overlay = overlay;
792
+ this.context = overlay.context;
793
+ }
794
+ _material;
795
+ enable(mat) {
796
+ this._material = mat;
797
+ window.addEventListener("resize", this._onResizeScreenFn = () => {
798
+ this.overlay.updateScreenspaceMaterialUniforms();
799
+ });
800
+ window.addEventListener("keyup", this._onKeyUpFn = (args) => {
801
+ if (args.key === "Escape")
802
+ this.overlay.stop();
803
+ });
804
+ window.addEventListener("wheel", this._onMouseWheelFn = (args) => {
805
+ if (this.overlay.enabled) {
806
+ mat.zoom += args.deltaY * .0005;
807
+ args.preventDefault();
808
+ }
809
+ }, { passive: false });
810
+ const delta = new Vector2();
811
+ window.addEventListener("mousemove", (args) => {
812
+ if (this.overlay.enabled && this.context.input.getPointerPressed(0)) {
813
+ const normalizedMovement = new Vector2(args.movementX, args.movementY);
814
+ normalizedMovement.x /= this.context.domElement.clientWidth;
815
+ normalizedMovement.y /= this.context.domElement.clientHeight;
816
+ delta.set(normalizedMovement.x, normalizedMovement.y);
817
+ delta.multiplyScalar(mat.zoom / -this.context.time.deltaTime * .01);
818
+ mat.offset = mat.offset.add(delta);
819
+ }
820
+ });
821
+ window.addEventListener("pointermove", (args) => {
822
+ if (this.overlay.enabled && this.context.input.getPointerPressed(0)) {
823
+ const count = this.context.input.getTouchesPressedCount();
824
+ if (count === 1) {
825
+ delta.set(args.movementX, args.movementY);
826
+ delta.multiplyScalar(mat.zoom * -this.context.time.deltaTime * .05);
827
+ mat.offset = mat.offset.add(delta);
828
+ }
829
+ }
830
+ });
831
+ let lastTouchStartTime = 0;
832
+ window.addEventListener("touchstart", e => {
833
+ if (e.touches.length < 2) {
834
+ if (this.context.time.time - lastTouchStartTime < .3) {
835
+ this.overlay.stop();
836
+ }
837
+ lastTouchStartTime = this.context.time.time;
838
+ return;
839
+ }
840
+ this._isPinching = true;
841
+ this._lastPinch = 0;
842
+ });
843
+ window.addEventListener("touchmove", e => {
844
+ if (!this._isPinching || !this._material)
845
+ return;
846
+ const touch1 = e.touches[0];
847
+ const touch2 = e.touches[1];
848
+ const dx = touch1.clientX - touch2.clientX;
849
+ const dy = touch1.clientY - touch2.clientY;
850
+ const distance = Math.sqrt(dx * dx + dy * dy);
851
+ if (this._lastPinch !== 0) {
852
+ const delta = distance - this._lastPinch;
853
+ this._material.zoom -= delta * .004;
854
+ }
855
+ this._lastPinch = distance;
856
+ });
857
+ window.addEventListener("touchend", () => {
858
+ this._isPinching = false;
859
+ });
860
+ }
861
+ _isPinching = false;
862
+ _lastPinch = 0;
863
+ disable() {
864
+ if (this._onResizeScreenFn) {
865
+ window.removeEventListener("resize", this._onResizeScreenFn);
866
+ this._onResizeScreenFn = undefined;
867
+ }
868
+ if (this._onKeyUpFn) {
869
+ window.removeEventListener("keyup", this._onKeyUpFn);
870
+ this._onKeyUpFn = undefined;
871
+ }
872
+ if (this._onMouseWheelFn) {
873
+ window.removeEventListener("wheel", this._onMouseWheelFn);
874
+ this._onMouseWheelFn = undefined;
875
+ }
876
+ }
877
+ }
878
+ class ScreenspaceTexture extends ShaderMaterial {
879
+ set screenAspect(val) {
880
+ this.uniforms["screenAspect"].value = val;
881
+ this.needsUpdate = true;
882
+ }
883
+ set offset(vec) {
884
+ const val = this.uniforms["offsetScale"].value;
885
+ val.x = vec.x;
886
+ val.y = vec.y;
887
+ // console.log(val);
888
+ this.uniforms["offsetScale"].value = val;
889
+ this.needsUpdate = true;
890
+ }
891
+ _offset = new Vector2();
892
+ get offset() {
893
+ const val = this.uniforms["offsetScale"].value;
894
+ this._offset.set(val.x, val.y);
895
+ return this._offset;
896
+ }
897
+ set zoom(val) {
898
+ const zoom = this.uniforms["offsetScale"].value;
899
+ if (val < .001)
900
+ val = .001;
901
+ zoom.z = val;
902
+ // zoom.z = this.maxZoom - val;
903
+ // zoom.z /= this.maxZoom;
904
+ this.needsUpdate = true;
905
+ }
906
+ get zoom() {
907
+ return this.uniforms["offsetScale"].value.z; // * this.maxZoom;
908
+ }
909
+ reset() {
910
+ this.offset = this.offset.set(0, 0);
911
+ this.zoom = 1;
912
+ this.needsUpdate = true;
913
+ }
914
+ // maxZoom : number = 10
915
+ constructor(tex) {
916
+ super();
917
+ this.uniforms = {
918
+ map: { value: tex },
919
+ screenAspect: { value: 1 },
920
+ offsetScale: { value: new Vector4(0, 0, 1, 1) }
921
+ };
922
+ this.vertexShader = `
923
+ uniform sampler2D map;
924
+ uniform float screenAspect;
925
+ uniform vec4 offsetScale;
926
+ varying vec2 vUv;
927
+
928
+ void main() {
929
+
930
+ gl_Position = vec4( position , 1.0 );
931
+ vUv = uv;
932
+ vUv.y = 1. - vUv.y;
933
+
934
+ // fit into screen
935
+ ivec2 res = textureSize(map, 0);
936
+ float videoAspect = float(res.x) / float(res.y);
937
+ float aspect = videoAspect / screenAspect;
938
+ if(aspect >= 1.0)
939
+ {
940
+ vUv.y = vUv.y * aspect;
941
+ float offset = (1. - aspect) * .5;
942
+ vUv.y = vUv.y + offset;
943
+ }
944
+ else
945
+ {
946
+ vUv.x = vUv.x / aspect;
947
+ float offset = (1. - 1. / aspect) * .5;
948
+ vUv.x = vUv.x + offset;
949
+ }
950
+
951
+ vUv.x -= .5;
952
+ vUv.y -= .5;
953
+
954
+ vUv.x *= offsetScale.z;
955
+ vUv.y *= offsetScale.z;
956
+ vUv.x += offsetScale.x;
957
+ vUv.y += offsetScale.y;
958
+
959
+ vUv.x += .5;
960
+ vUv.y += .5;
961
+ }
962
+
963
+ `;
964
+ this.fragmentShader = `
965
+ uniform sampler2D map;
966
+ varying vec2 vUv;
967
+ void main() {
968
+ if(vUv.x < 0. || vUv.x > 1. || vUv.y < 0. || vUv.y > 1.)
969
+ gl_FragColor = vec4(0., 0., 0., 1.);
970
+ else
971
+ {
972
+ vec4 texcolor = texture2D(map, vUv);
973
+ gl_FragColor = texcolor;
974
+ }
975
+ }
976
+ `;
977
+ }
978
+ }
979
979
  //# sourceMappingURL=VideoPlayer.js.map