@galacean/engine-core 2.0.0-alpha.6 → 2.0.0-alpha.60

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 (321) hide show
  1. package/dist/main.js +28967 -22183
  2. package/dist/main.js.map +1 -1
  3. package/dist/module.js +28951 -22175
  4. package/dist/module.js.map +1 -1
  5. package/package.json +3 -5
  6. package/types/2d/assembler/ISpriteAssembler.d.ts +1 -0
  7. package/types/2d/assembler/ISpriteRenderer.d.ts +3 -2
  8. package/types/2d/assembler/SimpleSpriteAssembler.d.ts +1 -0
  9. package/types/2d/assembler/SlicedSpriteAssembler.d.ts +1 -0
  10. package/types/2d/assembler/TiledSpriteAssembler.d.ts +1 -0
  11. package/types/2d/atlas/FontAtlas.d.ts +23 -1
  12. package/types/2d/atlas/SpriteAtlas.d.ts +8 -0
  13. package/types/2d/sprite/Sprite.d.ts +30 -4
  14. package/types/2d/sprite/SpriteMask.d.ts +49 -1
  15. package/types/2d/sprite/SpriteRenderer.d.ts +35 -1
  16. package/types/2d/text/CharInfo.d.ts +20 -1
  17. package/types/2d/text/CharRenderInfo.d.ts +15 -1
  18. package/types/2d/text/Font.d.ts +11 -1
  19. package/types/2d/text/ITextRenderer.d.ts +3 -0
  20. package/types/2d/text/SubFont.d.ts +35 -1
  21. package/types/2d/text/TextRenderer.d.ts +54 -1
  22. package/types/2d/text/TextUtils.d.ts +89 -1
  23. package/types/Background.d.ts +19 -2
  24. package/types/BasicResources.d.ts +58 -0
  25. package/types/Camera.d.ts +79 -1
  26. package/types/Canvas.d.ts +36 -7
  27. package/types/Component.d.ts +35 -2
  28. package/types/ComponentsDependencies.d.ts +38 -1
  29. package/types/ComponentsManager.d.ts +20 -0
  30. package/types/Engine.d.ts +114 -7
  31. package/types/EngineEventType.d.ts +13 -0
  32. package/types/Entity.d.ts +112 -21
  33. package/types/Polyfill.d.ts +12 -1
  34. package/types/RenderPipeline/BasicRenderPipeline.d.ts +4 -2
  35. package/types/RenderPipeline/BatcherManager.d.ts +23 -1
  36. package/types/RenderPipeline/Blitter.d.ts +1 -1
  37. package/types/RenderPipeline/CullingResults.d.ts +17 -1
  38. package/types/RenderPipeline/DepthOnlyPass.d.ts +15 -1
  39. package/types/RenderPipeline/InstanceBuffer.d.ts +28 -0
  40. package/types/RenderPipeline/MaskManager.d.ts +36 -1
  41. package/types/RenderPipeline/OpaqueTexturePass.d.ts +16 -1
  42. package/types/RenderPipeline/PipelineUtils.d.ts +11 -1
  43. package/types/RenderPipeline/PrimitiveChunk.d.ts +27 -1
  44. package/types/RenderPipeline/PrimitiveChunkManager.d.ts +16 -1
  45. package/types/RenderPipeline/RenderContext.d.ts +46 -1
  46. package/types/RenderPipeline/RenderElement.d.ts +26 -6
  47. package/types/RenderPipeline/RenderQueue.d.ts +23 -1
  48. package/types/RenderPipeline/RenderTargetPool.d.ts +17 -1
  49. package/types/RenderPipeline/SubPrimitiveChunk.d.ts +14 -1
  50. package/types/RenderPipeline/VertexArea.d.ts +10 -1
  51. package/types/RenderPipeline/VertexMergeBatcher.d.ts +11 -0
  52. package/types/RenderPipeline/enums/RenderQueueMaskType.d.ts +9 -1
  53. package/types/RenderPipeline/index.d.ts +4 -1
  54. package/types/Renderer.d.ts +82 -19
  55. package/types/Scene.d.ts +34 -7
  56. package/types/SceneManager.d.ts +18 -6
  57. package/types/Script.d.ts +41 -0
  58. package/types/Signal.d.ts +71 -0
  59. package/types/SystemInfo.d.ts +14 -2
  60. package/types/Transform.d.ts +26 -1
  61. package/types/UpdateFlag.d.ts +4 -1
  62. package/types/UpdateFlagManager.d.ts +41 -1
  63. package/types/Utils.d.ts +20 -0
  64. package/types/VirtualCamera.d.ts +16 -1
  65. package/types/animation/AnimationClip.d.ts +13 -2
  66. package/types/animation/AnimationClipCurveBinding.d.ts +17 -2
  67. package/types/animation/AnimationEvent.d.ts +2 -2
  68. package/types/animation/Animator.d.ts +49 -10
  69. package/types/animation/AnimatorController.d.ts +20 -2
  70. package/types/animation/AnimatorControllerLayer.d.ts +17 -2
  71. package/types/animation/AnimatorControllerParameter.d.ts +4 -0
  72. package/types/animation/AnimatorState.d.ts +46 -2
  73. package/types/animation/AnimatorStateInstance.d.ts +46 -0
  74. package/types/animation/AnimatorStateMachine.d.ts +17 -2
  75. package/types/animation/AnimatorStateTransition.d.ts +9 -0
  76. package/types/animation/AnimatorStateTransitionCollection.d.ts +23 -1
  77. package/types/animation/Keyframe.d.ts +1 -1
  78. package/types/animation/StateMachineScript.d.ts +2 -0
  79. package/types/animation/animationCurve/AnimationArrayCurve.d.ts +39 -0
  80. package/types/animation/animationCurve/AnimationBoolCurve.d.ts +39 -0
  81. package/types/animation/animationCurve/AnimationColorCurve.d.ts +39 -0
  82. package/types/animation/animationCurve/AnimationCurve.d.ts +9 -1
  83. package/types/animation/animationCurve/AnimationFloatArrayCurve.d.ts +38 -0
  84. package/types/animation/animationCurve/AnimationFloatCurve.d.ts +39 -0
  85. package/types/animation/animationCurve/AnimationQuaternionCurve.d.ts +41 -0
  86. package/types/animation/animationCurve/AnimationRectCurve.d.ts +18 -0
  87. package/types/animation/animationCurve/AnimationRefCurve.d.ts +20 -2
  88. package/types/animation/animationCurve/AnimationStringCurve.d.ts +39 -0
  89. package/types/animation/animationCurve/AnimationVector2Curve.d.ts +39 -0
  90. package/types/animation/animationCurve/AnimationVector3Curve.d.ts +43 -0
  91. package/types/animation/animationCurve/AnimationVector4Curve.d.ts +39 -0
  92. package/types/animation/animationCurve/interfaces/IAnimationCurveCalculator.d.ts +18 -1
  93. package/types/animation/enums/AnimatorStatePlayState.d.ts +8 -1
  94. package/types/animation/index.d.ts +1 -0
  95. package/types/animation/internal/AnimationCurveLayerOwner.d.ts +15 -1
  96. package/types/animation/internal/AnimationEventHandler.d.ts +8 -1
  97. package/types/animation/internal/AnimatorLayerData.d.ts +28 -1
  98. package/types/animation/internal/AnimatorStateData.d.ts +14 -1
  99. package/types/animation/internal/AnimatorStatePlayData.d.ts +27 -1
  100. package/types/animation/internal/AnimatorTempValue.d.ts +12 -1
  101. package/types/animation/internal/animationCurveOwner/AnimationCurveOwner.d.ts +39 -0
  102. package/types/animation/internal/animationCurveOwner/assembler/BlendShapeWeightsAnimationCurveOwnerAssembler.d.ts +12 -1
  103. package/types/animation/internal/animationCurveOwner/assembler/IAnimationCurveOwnerAssembler.d.ts +10 -1
  104. package/types/animation/internal/animationCurveOwner/assembler/PositionAnimationCurveOwnerAssembler.d.ts +13 -1
  105. package/types/animation/internal/animationCurveOwner/assembler/RotationAnimationCurveOwnerAssembler.d.ts +13 -1
  106. package/types/animation/internal/animationCurveOwner/assembler/ScaleAnimationCurveOwnerAssembler.d.ts +13 -1
  107. package/types/animation/internal/animationCurveOwner/assembler/UniversalAnimationCurveOwnerAssembler.d.ts +23 -1
  108. package/types/asset/AssetPromise.d.ts +4 -4
  109. package/types/asset/AssetType.d.ts +7 -9
  110. package/types/asset/GraphicsResource.d.ts +10 -0
  111. package/types/asset/IReferable.d.ts +8 -0
  112. package/types/asset/JSONAsset.d.ts +1 -1
  113. package/types/asset/LoadItem.d.ts +1 -1
  114. package/types/asset/Loader.d.ts +2 -2
  115. package/types/asset/ReferResource.d.ts +28 -0
  116. package/types/asset/RenderingStatistics.d.ts +8 -0
  117. package/types/asset/ResourceManager.d.ts +117 -9
  118. package/types/audio/AudioClip.d.ts +8 -0
  119. package/types/audio/AudioManager.d.ts +18 -0
  120. package/types/audio/AudioSource.d.ts +20 -2
  121. package/types/base/Constant.d.ts +2 -19
  122. package/types/base/DataObject.d.ts +6 -0
  123. package/types/base/EngineObject.d.ts +4 -0
  124. package/types/base/Time.d.ts +13 -0
  125. package/types/base/index.d.ts +1 -0
  126. package/types/clone/CloneDecorators.d.ts +37 -0
  127. package/types/clone/CloneUtil.d.ts +30 -0
  128. package/types/clone/ComponentCloner.d.ts +4 -10
  129. package/types/clone/ICloneHook.d.ts +12 -0
  130. package/types/enums/CameraType.d.ts +9 -1
  131. package/types/env-probe/CubeProbe.d.ts +2 -0
  132. package/types/env-probe/Probe.d.ts +1 -1
  133. package/types/graphic/Buffer.d.ts +23 -3
  134. package/types/graphic/BufferUtil.d.ts +8 -0
  135. package/types/graphic/ElementRangeMapping.d.ts +9 -0
  136. package/types/graphic/IndexBufferBinding.d.ts +4 -0
  137. package/types/graphic/Mesh.d.ts +58 -1
  138. package/types/graphic/Primitive.d.ts +50 -1
  139. package/types/graphic/TransformFeedback.d.ts +46 -0
  140. package/types/graphic/TransformFeedbackPrimitive.d.ts +57 -0
  141. package/types/graphic/TransformFeedbackSimulator.d.ts +55 -0
  142. package/types/graphic/VertexBufferBinding.d.ts +4 -0
  143. package/types/graphic/VertexElement.d.ts +1 -0
  144. package/types/graphic/enums/BufferBindFlag.d.ts +5 -3
  145. package/types/index.d.ts +7 -4
  146. package/types/input/InputManager.d.ts +25 -6
  147. package/types/input/enums/PointerButton.d.ts +8 -0
  148. package/types/input/keyboard/KeyboardManager.d.ts +41 -1
  149. package/types/input/pointer/Pointer.d.ts +37 -1
  150. package/types/input/pointer/PointerEventData.d.ts +4 -0
  151. package/types/input/pointer/PointerManager.d.ts +58 -0
  152. package/types/input/pointer/emitter/IHitResult.d.ts +11 -1
  153. package/types/input/pointer/emitter/PhysicsPointerEventEmitter.d.ts +20 -1
  154. package/types/input/wheel/WheelManager.d.ts +34 -1
  155. package/types/lighting/AmbientLight.d.ts +9 -8
  156. package/types/lighting/DirectLight.d.ts +17 -0
  157. package/types/lighting/KHR_lights.d.ts +13 -1
  158. package/types/lighting/Light.d.ts +2 -0
  159. package/types/lighting/LightManager.d.ts +57 -0
  160. package/types/lighting/PointLight.d.ts +17 -0
  161. package/types/lighting/SpotLight.d.ts +17 -0
  162. package/types/lighting/ambientOcclusion/AmbientOcclusion.d.ts +4 -0
  163. package/types/lighting/ambientOcclusion/ScalableAmbientObscurancePass.d.ts +37 -1
  164. package/types/material/BaseMaterial.d.ts +15 -11
  165. package/types/material/Material.d.ts +6 -9
  166. package/types/mesh/BlendShape.d.ts +14 -1
  167. package/types/mesh/BlendShapeFrame.d.ts +11 -4
  168. package/types/mesh/BlendShapeManager.d.ts +100 -1
  169. package/types/mesh/BufferMesh.d.ts +2 -2
  170. package/types/mesh/MeshRenderer.d.ts +42 -0
  171. package/types/mesh/MeshTangentUtils.d.ts +9 -0
  172. package/types/mesh/ModelMesh.d.ts +28 -12
  173. package/types/mesh/PrimitiveMesh.d.ts +266 -104
  174. package/types/mesh/PrimitiveMeshOptions.d.ts +415 -0
  175. package/types/mesh/Skin.d.ts +12 -3
  176. package/types/mesh/SkinnedMeshRenderer.d.ts +27 -1
  177. package/types/mesh/enums/PrimitiveMeshCapMode.d.ts +21 -0
  178. package/types/mesh/index.d.ts +2 -0
  179. package/types/mesh/primitive/MeshPathUtils.d.ts +13 -0
  180. package/types/mesh/primitive/PolygonUtils.d.ts +44 -0
  181. package/types/mesh/primitive/PrimitiveMeshBuilder.d.ts +25 -0
  182. package/types/mesh/primitive/PrimitiveMeshRestorer.d.ts +15 -0
  183. package/types/mesh/primitive/SubdivisionUtils.d.ts +9 -0
  184. package/types/particle/ParticleBounds.d.ts +87 -0
  185. package/types/particle/ParticleBufferUtils.d.ts +33 -1
  186. package/types/particle/ParticleGenerator.d.ts +142 -24
  187. package/types/particle/ParticleMaterial.d.ts +3 -1
  188. package/types/particle/ParticleRenderer.d.ts +62 -6
  189. package/types/particle/ParticleSubEmitterSpawnState.d.ts +36 -0
  190. package/types/particle/ParticleSystemManager.d.ts +17 -0
  191. package/types/particle/ParticleTransformFeedbackSimulator.d.ts +48 -0
  192. package/types/particle/enums/ParticleInheritVelocityMode.d.ts +14 -0
  193. package/types/particle/enums/ParticleRandomSubSeeds.d.ts +26 -1
  194. package/types/particle/enums/ParticleScaleMode.d.ts +5 -5
  195. package/types/particle/enums/ParticleSubEmitterInheritProperty.d.ts +17 -0
  196. package/types/particle/enums/ParticleSubEmitterType.d.ts +12 -0
  197. package/types/particle/enums/attributes/BillboardParticleVertexAttribute.d.ts +6 -1
  198. package/types/particle/enums/attributes/ParticleFeedbackVertexAttribute.d.ts +10 -0
  199. package/types/particle/enums/attributes/ParticleInstanceVertexAttribute.d.ts +19 -1
  200. package/types/particle/index.d.ts +9 -0
  201. package/types/particle/modules/BirthSubEmitterCommand.d.ts +29 -0
  202. package/types/particle/modules/BirthSubEmitterState.d.ts +9 -0
  203. package/types/particle/modules/Burst.d.ts +23 -2
  204. package/types/particle/modules/ColorOverLifetimeModule.d.ts +19 -0
  205. package/types/particle/modules/CustomDataModule.d.ts +90 -0
  206. package/types/particle/modules/DeathSubEmitterCommand.d.ts +19 -0
  207. package/types/particle/modules/EmissionModule.d.ts +51 -4
  208. package/types/particle/modules/EmissionState.d.ts +13 -0
  209. package/types/particle/modules/ForceOverLifetimeModule.d.ts +16 -1
  210. package/types/particle/modules/InheritVelocityModule.d.ts +86 -0
  211. package/types/particle/modules/LimitVelocityOverLifetimeModule.d.ts +163 -0
  212. package/types/particle/modules/MainModule.d.ts +56 -11
  213. package/types/particle/modules/NoiseModule.d.ts +114 -0
  214. package/types/particle/modules/ParticleCompositeCurve.d.ts +46 -4
  215. package/types/particle/modules/ParticleCompositeGradient.d.ts +8 -2
  216. package/types/particle/modules/ParticleCurve.d.ts +31 -2
  217. package/types/particle/modules/ParticleGeneratorModule.d.ts +9 -3
  218. package/types/particle/modules/ParticleGradient.d.ts +22 -5
  219. package/types/particle/modules/RotationOverLifetimeModule.d.ts +27 -3
  220. package/types/particle/modules/SizeOverLifetimeModule.d.ts +25 -0
  221. package/types/particle/modules/SubEmitter.d.ts +32 -0
  222. package/types/particle/modules/SubEmittersModule.d.ts +111 -0
  223. package/types/particle/modules/TextureSheetAnimationModule.d.ts +14 -1
  224. package/types/particle/modules/VelocityOverLifetimeModule.d.ts +124 -3
  225. package/types/particle/modules/shape/BaseShape.d.ts +65 -2
  226. package/types/particle/modules/shape/BoxShape.d.ts +13 -2
  227. package/types/particle/modules/shape/CircleShape.d.ts +13 -1
  228. package/types/particle/modules/shape/ConeShape.d.ts +13 -4
  229. package/types/particle/modules/shape/HemisphereShape.d.ts +13 -0
  230. package/types/particle/modules/shape/MeshShape.d.ts +26 -3
  231. package/types/particle/modules/shape/ShapeUtils.d.ts +13 -1
  232. package/types/particle/modules/shape/SphereShape.d.ts +13 -0
  233. package/types/physics/CharacterController.d.ts +24 -3
  234. package/types/physics/Collider.d.ts +47 -3
  235. package/types/physics/Collision.d.ts +3 -0
  236. package/types/physics/DynamicCollider.d.ts +33 -7
  237. package/types/physics/HitResult.d.ts +2 -2
  238. package/types/physics/PhysicsMaterial.d.ts +11 -2
  239. package/types/physics/PhysicsScene.d.ts +99 -7
  240. package/types/physics/StaticCollider.d.ts +5 -0
  241. package/types/physics/enums/HingeJointFlag.d.ts +14 -1
  242. package/types/physics/joint/HingeJoint.d.ts +4 -0
  243. package/types/physics/joint/Joint.d.ts +22 -2
  244. package/types/physics/joint/JointLimits.d.ts +2 -1
  245. package/types/physics/joint/JointMotor.d.ts +2 -1
  246. package/types/physics/shape/ColliderShape.d.ts +44 -7
  247. package/types/physics/shape/MeshColliderShape.d.ts +13 -12
  248. package/types/postProcess/FinalPass.d.ts +20 -1
  249. package/types/postProcess/PostProcess.d.ts +11 -6
  250. package/types/postProcess/PostProcessEffect.d.ts +6 -1
  251. package/types/postProcess/PostProcessEffectParameter.d.ts +23 -3
  252. package/types/postProcess/PostProcessManager.d.ts +43 -0
  253. package/types/postProcess/PostProcessPass.d.ts +3 -2
  254. package/types/postProcess/PostProcessUberPass.d.ts +2 -1
  255. package/types/postProcess/effects/BloomEffect.d.ts +26 -1
  256. package/types/postProcess/effects/TonemappingEffect.d.ts +3 -0
  257. package/types/renderingHardwareInterface/IHardwareRenderer.d.ts +74 -0
  258. package/types/renderingHardwareInterface/IPlatformBuffer.d.ts +1 -0
  259. package/types/renderingHardwareInterface/IPlatformPrimitive.d.ts +6 -0
  260. package/types/renderingHardwareInterface/IPlatformShaderProgram.d.ts +4 -0
  261. package/types/renderingHardwareInterface/IPlatformTexture2D.d.ts +0 -1
  262. package/types/renderingHardwareInterface/IPlatformTextureCube.d.ts +0 -1
  263. package/types/renderingHardwareInterface/IPlatformTransformFeedback.d.ts +36 -0
  264. package/types/renderingHardwareInterface/IPlatformTransformFeedbackPrimitive.d.ts +39 -0
  265. package/types/renderingHardwareInterface/index.d.ts +5 -0
  266. package/types/shader/BuiltinShaders.d.ts +27 -0
  267. package/types/shader/Shader.d.ts +52 -25
  268. package/types/shader/ShaderBlockProperty.d.ts +19 -0
  269. package/types/shader/ShaderData.d.ts +43 -4
  270. package/types/shader/ShaderFactory.d.ts +77 -0
  271. package/types/shader/ShaderMacro.d.ts +17 -2
  272. package/types/shader/ShaderMacroCollection.d.ts +57 -1
  273. package/types/shader/ShaderMacroProcessor.d.ts +54 -0
  274. package/types/shader/ShaderPass.d.ts +42 -13
  275. package/types/shader/ShaderProgram.d.ts +92 -1
  276. package/types/shader/ShaderProgramMap.d.ts +20 -0
  277. package/types/shader/ShaderProperty.d.ts +17 -0
  278. package/types/shader/ShaderTagKey.d.ts +2 -0
  279. package/types/shader/ShaderUniform.d.ts +49 -1
  280. package/types/shader/ShaderUniformBlock.d.ts +9 -1
  281. package/types/shader/enums/ConstantBufferBindingPoint.d.ts +7 -0
  282. package/types/shader/enums/ShaderLanguage.d.ts +1 -3
  283. package/types/shader/enums/ShaderPreprocessorDirective.d.ts +22 -0
  284. package/types/shader/index.d.ts +3 -1
  285. package/types/shader/state/BlendState.d.ts +16 -1
  286. package/types/shader/state/DepthState.d.ts +16 -1
  287. package/types/shader/state/RasterState.d.ts +19 -1
  288. package/types/shader/state/RenderState.d.ts +13 -2
  289. package/types/shader/state/RenderTargetBlendState.d.ts +2 -1
  290. package/types/shader/state/StencilState.d.ts +15 -1
  291. package/types/shadow/CascadedShadowCasterPass.d.ts +5 -3
  292. package/types/shadow/ShadowSliceData.d.ts +13 -1
  293. package/types/shadow/ShadowUtils.d.ts +41 -1
  294. package/types/sky/Sky.d.ts +13 -4
  295. package/types/sky/SkyBoxMaterial.d.ts +0 -7
  296. package/types/texture/RenderTarget.d.ts +28 -3
  297. package/types/texture/Texture.d.ts +46 -12
  298. package/types/texture/Texture2D.d.ts +4 -1
  299. package/types/texture/Texture2DArray.d.ts +4 -1
  300. package/types/texture/TextureCube.d.ts +4 -1
  301. package/types/texture/TextureUtils.d.ts +15 -1
  302. package/types/texture/enums/TextureFormat.d.ts +1 -9
  303. package/types/trail/TrailRenderer.d.ts +13 -8
  304. package/types/ui/IUICanvas.d.ts +16 -1
  305. package/types/utils/DisorderedArray.d.ts +3 -1
  306. package/types/xr/XRManager.d.ts +28 -0
  307. package/types/RenderPipeline/BatchUtils.d.ts +0 -1
  308. package/types/RenderPipeline/SubRenderElement.d.ts +0 -22
  309. package/types/clone/CloneManager.d.ts +0 -31
  310. package/types/clone/enums/CloneMode.d.ts +0 -13
  311. package/types/mesh/PrimitiveMeshRestorer.d.ts +0 -1
  312. package/types/physics/enums/ColliderShapeChangeFlag.d.ts +0 -1
  313. package/types/shader/ShaderPool.d.ts +0 -1
  314. package/types/shader/ShaderProgramPool.d.ts +0 -1
  315. package/types/shader/state/index.d.ts +0 -6
  316. package/types/shaderlib/ShaderFactory.d.ts +0 -20
  317. package/types/shaderlib/ShaderLib.d.ts +0 -73
  318. package/types/shaderlib/index.d.ts +0 -1
  319. package/types/shaderlib/particle/index.d.ts +0 -15
  320. package/types/shaderlib/pbr/index.d.ts +0 -11
  321. package/types/shaderlib/shadow/index.d.ts +0 -8
@@ -1,15 +1,24 @@
1
1
  import { GraphicsResource } from "../asset/GraphicsResource";
2
2
  import { Engine } from "../Engine";
3
+ import { IPlatformTexture } from "../renderingHardwareInterface";
3
4
  import { TextureDepthCompareFunction } from "./enums/TextureDepthCompareFunction";
4
5
  import { TextureFilterMode } from "./enums/TextureFilterMode";
5
6
  import { TextureFormat } from "./enums/TextureFormat";
6
7
  import { TextureUsage } from "./enums/TextureUsage";
7
8
  import { TextureWrapMode } from "./enums/TextureWrapMode";
8
9
  /**
9
- * The base class of texture, contains some common functions of texture-related classes.
10
+ * Base class for textures, holding format, base dimensions, mipmap count, and sampler state.
10
11
  */
11
12
  export declare abstract class Texture extends GraphicsResource {
12
13
  name: string;
14
+ /** @internal */
15
+ _platformTexture: IPlatformTexture;
16
+ /** @internal */
17
+ _mipmap: boolean;
18
+ /** @internal */
19
+ _isDepthTexture: boolean;
20
+ /** @internal */
21
+ _memorySize: number;
13
22
  protected _format: TextureFormat;
14
23
  protected _width: number;
15
24
  protected _height: number;
@@ -23,23 +32,23 @@ export declare abstract class Texture extends GraphicsResource {
23
32
  private _depthCompareFunction;
24
33
  private _useDepthCompareMode;
25
34
  /**
26
- * Whether the texture data is in sRGB color space, otherwise is linear color space.
35
+ * Whether texels are stored in sRGB rather than linear color space.
27
36
  */
28
37
  get isSRGBColorSpace(): boolean;
29
38
  /**
30
- * Texture format.
39
+ * Pixel storage format of the texture.
31
40
  */
32
41
  get format(): TextureFormat;
33
42
  /**
34
- * The width of the texture.
43
+ * Width of mip level `0`, in pixels.
35
44
  */
36
45
  get width(): number;
37
46
  /**
38
- * The height of the texture.
47
+ * Height of mip level `0`, in pixels.
39
48
  */
40
49
  get height(): number;
41
50
  /**
42
- * The usage of the texture.
51
+ * Upload frequency hint for the texture.
43
52
  */
44
53
  get usage(): TextureUsage;
45
54
  /**
@@ -53,32 +62,57 @@ export declare abstract class Texture extends GraphicsResource {
53
62
  get wrapModeV(): TextureWrapMode;
54
63
  set wrapModeV(value: TextureWrapMode);
55
64
  /**
56
- * Texture mipmapping count.
65
+ * Number of mip levels; `1` when mipmapping is disabled.
57
66
  */
58
67
  get mipmapCount(): number;
59
68
  /**
60
- * Filter mode for texture.
69
+ * Sampling filter mode.
70
+ * @remarks Integer formats (`TextureFormat.R32G32B32A32_UInt`) only accept `TextureFilterMode.Point`; other modes log a warning and are ignored.
61
71
  */
62
72
  get filterMode(): TextureFilterMode;
63
73
  set filterMode(value: TextureFilterMode);
64
74
  /**
65
75
  * Anisotropic level for texture.
76
+ * @defaultValue `1`
77
+ * @remarks Values below `1` are clamped to `1`; values above the device limit are kept on this property and clamped when sampling.
66
78
  */
67
79
  get anisoLevel(): number;
68
80
  set anisoLevel(value: number);
69
81
  /**
70
- * Filter mode when texture as depth Texture.
71
- * @remarks Only depth-related formats take effect.
82
+ * Comparison function used when sampling this texture as a shadow depth map.
83
+ * @remarks Kept on this property across backends, and takes effect only for depth formats sampled with comparison in WebGL2.
72
84
  */
73
85
  get depthCompareFunction(): TextureDepthCompareFunction;
74
86
  set depthCompareFunction(value: TextureDepthCompareFunction);
87
+ /**
88
+ * Initialize base texture metadata and validate format support.
89
+ * @param engine - Owning engine instance
90
+ * @param width - Width of mip level `0` in pixels
91
+ * @param height - Height of mip level `0` in pixels
92
+ * @param format - Pixel storage format
93
+ * @param mipmap - Whether to allocate a full mip chain down to `1x1`
94
+ * @param isSRGBColorSpace - Whether texels use sRGB rather than linear encoding
95
+ * @throws If `format` is not supported by `engine`.
96
+ */
75
97
  constructor(engine: Engine, width: number, height: number, format: TextureFormat, mipmap: boolean, isSRGBColorSpace: boolean);
76
98
  /**
77
- * Generate multi-level textures based on the 0th level data.
99
+ * Regenerate mip levels `1..mipmapCount - 1` from mip level `0`. No-op if mipmapping is disabled.
78
100
  */
79
101
  generateMipmaps(): void;
80
102
  /**
81
- * Get the maximum mip level of the corresponding size:rounding down.
103
+ * @internal
104
+ */
105
+ _setUseDepthCompareMode(value: boolean): void;
106
+ /**
107
+ * @internal
108
+ */
109
+ _rebuild(): void;
110
+ /**
111
+ * @internal
112
+ */
113
+ protected _onDestroy(): void;
114
+ /**
115
+ * Maximum 0-based mip level for a dimension of `size` pixels, rounding down.
82
116
  * @remarks http://download.nvidia.com/developer/Papers/2005/NP2_Mipmapping/NP2_Mipmap_Creation.pdf
83
117
  */
84
118
  protected _getMaxMiplevel(size: number): number;
@@ -19,7 +19,6 @@ export declare class Texture2D extends Texture {
19
19
  constructor(engine: Engine, width: number, height: number, format?: TextureFormat, mipmap?: boolean, isSRGBColorSpace?: boolean, usage?: TextureUsage);
20
20
  /**
21
21
  * Setting pixels data through color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
22
- * @remarks If it is the WebGL1.0 platform and the texture format is compressed, the first upload must be filled with textures.
23
22
  * @param colorBuffer - Color buffer data
24
23
  * @param mipLevel - Texture mipmapping level
25
24
  * @param x - X coordinate of area start
@@ -68,4 +67,8 @@ export declare class Texture2D extends Texture {
68
67
  * @param out - Color buffer
69
68
  */
70
69
  getPixelBuffer(x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
70
+ /**
71
+ * @internal
72
+ */
73
+ _rebuild(): void;
71
74
  }
@@ -23,7 +23,6 @@ export declare class Texture2DArray extends Texture {
23
23
  constructor(engine: Engine, width: number, height: number, length: number, format?: TextureFormat, mipmap?: boolean, isSRGBColorSpace?: boolean);
24
24
  /**
25
25
  * Setting pixels data through color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
26
- * @remarks If it is the WebGL1.0 platform and the texture format is compressed, the first upload must be filled with textures.
27
26
  * @param offsetIndex - The texture array element offset index
28
27
  * @param colorBuffer - Color buffer data
29
28
  * @param mipLevel - Texture mipmapping level
@@ -79,4 +78,8 @@ export declare class Texture2DArray extends Texture {
79
78
  * @param out - Color buffer
80
79
  */
81
80
  getPixelBuffer(elementIndex: number, x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
81
+ /**
82
+ * @internal
83
+ */
84
+ _rebuild(): void;
82
85
  }
@@ -17,7 +17,6 @@ export declare class TextureCube extends Texture {
17
17
  constructor(engine: Engine, size: number, format?: TextureFormat, mipmap?: boolean, isSRGBColorSpace?: boolean);
18
18
  /**
19
19
  * Setting pixels data through cube face,color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
20
- * @remarks When compressed texture is in WebGL1, the texture must be filled first before writing the sub-region
21
20
  * @param face - Cube face
22
21
  * @param colorBuffer - Color buffer data
23
22
  * @param mipLevel - Texture mipmapping level
@@ -68,4 +67,8 @@ export declare class TextureCube extends Texture {
68
67
  * @param out - Color buffer
69
68
  */
70
69
  getPixelBuffer(face: TextureCubeFace, x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
70
+ /**
71
+ * @internal
72
+ */
73
+ _rebuild(): void;
71
74
  }
@@ -1 +1,15 @@
1
- export {};
1
+ import { TextureFormat } from "./enums/TextureFormat";
2
+ /**
3
+ * @internal
4
+ */
5
+ export declare class TextureUtils {
6
+ /**
7
+ * Check if the texture config supports auto mipmap generation with real correction for mipmap and isSRGBColorSpace.
8
+ */
9
+ static supportGenerateMipmapsWithCorrection(format: TextureFormat, mipmap: boolean, isSRGBColorSpace: boolean): boolean;
10
+ static isHDRFormat(format: TextureFormat): boolean;
11
+ static supportSRGB(format: TextureFormat): boolean;
12
+ static supportGenerateMipmaps(format: TextureFormat, mipmap: boolean, isSRGBColorSpace: boolean): boolean;
13
+ static getTextureByteCount(format: TextureFormat, width: number, height: number, mipmapCount: number, faceCount: number): number;
14
+ static getMipLevelByteCount(format: TextureFormat, width: number, height: number): number;
15
+ }
@@ -75,13 +75,5 @@ export declare enum TextureFormat {
75
75
  /** 16-bit depth + 8-bit stencil format. */
76
76
  Depth24Stencil8 = 33,
77
77
  /** 32-bit depth + 8-bit stencil format. */
78
- Depth32Stencil8 = 34,
79
- /** @deprecated Use 'TextureFormat.R8' instead. */
80
- Alpha8 = 5,
81
- /** @deprecated Use 'TextureFormat.R8G8' instead. */
82
- LuminanceAlpha = 6,
83
- /** @deprecated Use `TextureFormat.BC1` instead. */
84
- DXT1 = 10,
85
- /** @deprecated Use `TextureFormat.BC3` instead. */
86
- DXT5 = 11
78
+ Depth32Stencil8 = 34
87
79
  }
@@ -1,12 +1,13 @@
1
1
  import { BoundingBox, Vector2 } from "@galacean/engine-math";
2
+ import { Entity } from "../Entity";
2
3
  import { RenderContext } from "../RenderPipeline/RenderContext";
3
4
  import { Renderer } from "../Renderer";
4
5
  import { ParticleCurve } from "../particle/modules/ParticleCurve";
5
6
  import { ParticleGradient } from "../particle/modules/ParticleGradient";
6
7
  import { TrailTextureMode } from "./enums/TrailTextureMode";
7
8
  /**
8
- * Trail Renderer Component.
9
- * Renders a trail behind a moving object.
9
+ * Renders a trail by sampling the entity's world position during render updates.
10
+ * Trail length depends on sampled movement and point lifetime.
10
11
  */
11
12
  export declare class TrailRenderer extends Renderer {
12
13
  private static readonly VERTEX_STRIDE;
@@ -22,13 +23,13 @@ export declare class TrailRenderer extends Renderer {
22
23
  private static _alphaKeysProp;
23
24
  private static _curveMaxTimeProp;
24
25
  private static _tempVector3;
25
- /** Whether the trail is being created as the object moves. */
26
+ /** Whether to record new trail points. */
26
27
  emitting: boolean;
27
- /** The minimum distance the object must move before a new trail segment is added, in world units. */
28
+ /** Minimum world-space distance from the last recorded point before adding a sample. */
28
29
  minVertexDistance: number;
29
- /** The curve describing the trail width from start to end. */
30
+ /** Full width in world units over normalized trail distance: head (0) to tail (1). */
30
31
  widthCurve: ParticleCurve;
31
- /** The gradient describing the trail color from start to end. */
32
+ /** Linear HDR color and opacity over normalized trail distance: head (0) to tail (1). */
32
33
  colorGradient: ParticleGradient;
33
34
  private _trailParams;
34
35
  private _textureScale;
@@ -52,7 +53,7 @@ export declare class TrailRenderer extends Renderer {
52
53
  private _playTime;
53
54
  private _lastPlayTimeUpdateFrameCount;
54
55
  /**
55
- * How long the trail takes to fade out, in seconds.
56
+ * Point lifetime in seconds.
56
57
  */
57
58
  get time(): number;
58
59
  set time(value: number);
@@ -67,6 +68,10 @@ export declare class TrailRenderer extends Renderer {
67
68
  */
68
69
  get textureScale(): Vector2;
69
70
  set textureScale(value: Vector2);
71
+ /**
72
+ * @internal
73
+ */
74
+ constructor(entity: Entity);
70
75
  /**
71
76
  * Clear all trail points.
72
77
  */
@@ -85,6 +90,6 @@ export declare class TrailRenderer extends Renderer {
85
90
  private _addPoint;
86
91
  private _getActivePointCount;
87
92
  private _addActivePointsToVertexBuffer;
88
- private _addSubRenderElement;
93
+ private _addRenderElement;
89
94
  private _onTextureScaleChanged;
90
95
  }
@@ -1 +1,16 @@
1
- export {};
1
+ import { Camera } from "../Camera";
2
+ import { Entity } from "../Entity";
3
+ import { RenderContext } from "../RenderPipeline/RenderContext";
4
+ import { RenderElement } from "../RenderPipeline/RenderElement";
5
+ /**
6
+ * @internal
7
+ */
8
+ export interface IUICanvas {
9
+ entity: Entity;
10
+ sortOrder: number;
11
+ _canvasIndex: number;
12
+ _renderElements: RenderElement[];
13
+ _batchedRenderElements: RenderElement[];
14
+ _canRender(camera: Camera): boolean;
15
+ _prepareRender(renderContext: RenderContext): void;
16
+ }
@@ -4,6 +4,8 @@
4
4
  export declare class DisorderedArray<T> {
5
5
  /** The length of the array. */
6
6
  length: number;
7
+ /** @internal */
8
+ _elements: T[];
7
9
  private _loopCounter;
8
10
  private _blankCount;
9
11
  /**
@@ -42,7 +44,7 @@ export declare class DisorderedArray<T> {
42
44
  * @param index - The index of the element to be deleted
43
45
  * @returns The replaced item is used to reset its index
44
46
  */
45
- deleteByIndex(index: number): T;
47
+ deleteByIndex(index: number): T | undefined;
46
48
  /**
47
49
  * Loop through all elements.
48
50
  * @param callbackFn - The callback function
@@ -1,5 +1,33 @@
1
+ import { IXRDevice } from "@galacean/engine-design";
2
+ import { Engine } from "../Engine";
3
+ import { CameraClearFlags } from "../enums/CameraClearFlags";
4
+ import { CameraType } from "../enums/CameraType";
1
5
  /**
2
6
  * XRManager located in the main package, its implementation logic is XRManagerExtended in the sub-package engine-xr.
3
7
  */
4
8
  export declare class XRManager {
9
+ /**
10
+ * @internal
11
+ */
12
+ _initialize(engine: Engine, xrDevice: IXRDevice): void;
13
+ /**
14
+ * @internal
15
+ */
16
+ _update(): void;
17
+ /**
18
+ * @internal
19
+ */
20
+ _destroy(): void;
21
+ /**
22
+ * @internal
23
+ */
24
+ _getRequestAnimationFrame(): ((callback: FrameRequestCallback) => number) | null;
25
+ /**
26
+ * @internal
27
+ */
28
+ _getCancelAnimationFrame(): ((id: number) => void) | null;
29
+ /**
30
+ * @internal
31
+ */
32
+ _getCameraIgnoreClearFlags(type: CameraType): CameraClearFlags;
5
33
  }
@@ -1 +0,0 @@
1
- export {};
@@ -1,22 +0,0 @@
1
- import { Renderer } from "../Renderer";
2
- import { Primitive, SubMesh } from "../graphic";
3
- import { Material } from "../material";
4
- import { ShaderData, ShaderPass } from "../shader";
5
- import { Texture2D } from "../texture";
6
- import { IPoolElement } from "../utils/ObjectPool";
7
- import { RenderQueueFlags } from "./BasicRenderPipeline";
8
- import { SubPrimitiveChunk } from "./SubPrimitiveChunk";
9
- export declare class SubRenderElement implements IPoolElement {
10
- component: Renderer;
11
- primitive: Primitive;
12
- material: Material;
13
- subPrimitive: SubMesh;
14
- shaderPasses: ReadonlyArray<ShaderPass>;
15
- shaderData?: ShaderData;
16
- batched: boolean;
17
- renderQueueFlags: RenderQueueFlags;
18
- texture?: Texture2D;
19
- subChunk?: SubPrimitiveChunk;
20
- set(component: Renderer, material: Material, primitive: Primitive, subPrimitive: SubMesh, texture?: Texture2D, subChunk?: SubPrimitiveChunk): void;
21
- dispose(): void;
22
- }
@@ -1,31 +0,0 @@
1
- /**
2
- * Property decorator, ignore the property when cloning.
3
- */
4
- export declare function ignoreClone(target: Object, propertyKey: string): void;
5
- /**
6
- * Property decorator, assign value to the property when cloning.
7
- *
8
- * @remarks
9
- * If it's a primitive type, the value will be copied.
10
- * If it's a class type, the reference will be copied.
11
- */
12
- export declare function assignmentClone(target: Object, propertyKey: string): void;
13
- /**
14
- * Property decorator, shallow clone the property when cloning.
15
- * After cloning, it will keep its own reference independent, and use the method of assignment to clone all its internal properties.
16
- * if the internal property is a primitive type, the value will be copied, if the internal property is a reference type, its reference address will be copied.。
17
- *
18
- * @remarks
19
- * Applicable to Object, Array, TypedArray and Class types.
20
- */
21
- export declare function shallowClone(target: Object, propertyKey: string): void;
22
- /**
23
- * Property decorator, deep clone the property when cloning.
24
- * After cloning, it will maintain its own reference independence, and all its internal deep properties will remain completely independent.
25
- *
26
- * @remarks
27
- * Applicable to Object, Array, TypedArray and Class types.
28
- * If Class is encountered during the deep cloning process, the custom cloning function of the object will be called first.
29
- * Custom cloning requires the object to implement the IClone interface.
30
- */
31
- export declare function deepClone(target: Object, propertyKey: string): void;
@@ -1,13 +0,0 @@
1
- /**
2
- * Clone mode.
3
- */
4
- export declare enum CloneMode {
5
- /** Ignore clone. */
6
- Ignore = 0,
7
- /** Assignment clone. */
8
- Assignment = 1,
9
- /** Shallow clone. */
10
- Shallow = 2,
11
- /** Deep clone. */
12
- Deep = 3
13
- }
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1,6 +0,0 @@
1
- export { BlendState } from "./BlendState";
2
- export { DepthState } from "./DepthState";
3
- export { RasterState } from "./RasterState";
4
- export { RenderState } from "./RenderState";
5
- export { RenderTargetBlendState } from "./RenderTargetBlendState";
6
- export { StencilState } from "./StencilState";
@@ -1,20 +0,0 @@
1
- import { ShaderMacro } from "../shader/ShaderMacro";
2
- export declare class ShaderFactory {
3
- private static readonly _has300OutInFragReg;
4
- static parseCustomMacros(macros: ShaderMacro[]): string;
5
- static registerInclude(includeName: string, includeSource: string): void;
6
- static unRegisterInclude(includeName: string): void;
7
- /**
8
- * @param regex The default regex is for engine's builtin glsl `#include` syntax,
9
- * since `ShaderLab` use the same parsing function but different syntax for `#include` --- `/^[ \t]*#include +"([\w\d.]+)"/gm`
10
- */
11
- static parseIncludes(src: string, regex?: RegExp): string;
12
- /**
13
- * Convert lower GLSL version to GLSL 300 es.
14
- * @param shader - code
15
- * @param isFrag - Whether it is a fragment shader.
16
- * */
17
- static convertTo300(shader: string, isFrag?: boolean): string;
18
- private static _has300Output;
19
- private static _replaceMRTShader;
20
- }
@@ -1,73 +0,0 @@
1
- export declare const ShaderLib: {
2
- particle_common: string;
3
- velocity_over_lifetime_module: string;
4
- rotation_over_lifetime_module: string;
5
- size_over_lifetime_module: string;
6
- color_over_lifetime_module: string;
7
- texture_sheet_animation_module: string;
8
- force_over_lifetime_module: string;
9
- sphere_billboard: string;
10
- stretched_billboard: string;
11
- vertical_billboard: string;
12
- horizontal_billboard: string;
13
- particle_mesh: string;
14
- normal_get: string;
15
- pbr_frag_define: string;
16
- pbr_helper: string;
17
- brdf: string;
18
- direct_irradiance_frag_define: string;
19
- ibl_frag_define: string;
20
- pbr_frag: string;
21
- btdf: string;
22
- refraction: string;
23
- ShadowCoord: string;
24
- ShadowFragmentDeclaration: string;
25
- shadow_sample_tent: string;
26
- ShadowVertexDeclaration: string;
27
- ShadowVertex: string;
28
- common: string;
29
- common_vert: string;
30
- transform_declare: string;
31
- camera_declare: string;
32
- color_share: string;
33
- normal_share: string;
34
- uv_share: string;
35
- worldpos_share: string;
36
- FogVertexDeclaration: string;
37
- FogFragmentDeclaration: string;
38
- PositionClipSpaceDeclaration: string;
39
- begin_normal_vert: string;
40
- begin_position_vert: string;
41
- position_vert: string;
42
- color_vert: string;
43
- normal_vert: string;
44
- skinning_vert: string;
45
- blendShape_input: string;
46
- blendShape_vert: string;
47
- uv_vert: string;
48
- worldpos_vert: string;
49
- FogVertex: string;
50
- light_frag_define: string;
51
- mobile_material_frag: string;
52
- FogFragment: string;
53
- PositionClipSpaceVertex: string;
54
- begin_mobile_frag: string;
55
- begin_viewdir_frag: string;
56
- mobile_blinnphong_frag: string;
57
- noise_common: string;
58
- noise_cellular_2D: string;
59
- noise_cellular_2x2: string;
60
- noise_cellular_2x2x2: string;
61
- noise_cellular_3D: string;
62
- noise_cellular: string;
63
- noise_perlin_2D: string;
64
- noise_perlin_3D: string;
65
- noise_perlin_4D: string;
66
- noise_perlin: string;
67
- noise_psrd_2D: string;
68
- noise_simplex_2D: string;
69
- noise_simplex_3D_grad: string;
70
- noise_simplex_3D: string;
71
- noise_simplex_4D: string;
72
- noise_simplex: string;
73
- };
@@ -1 +0,0 @@
1
- export { ShaderFactory } from "./ShaderFactory";
@@ -1,15 +0,0 @@
1
- declare const _default: {
2
- particle_common: string;
3
- velocity_over_lifetime_module: string;
4
- rotation_over_lifetime_module: string;
5
- size_over_lifetime_module: string;
6
- color_over_lifetime_module: string;
7
- texture_sheet_animation_module: string;
8
- force_over_lifetime_module: string;
9
- sphere_billboard: string;
10
- stretched_billboard: string;
11
- vertical_billboard: string;
12
- horizontal_billboard: string;
13
- particle_mesh: string;
14
- };
15
- export default _default;
@@ -1,11 +0,0 @@
1
- declare const _default: {
2
- pbr_frag_define: string;
3
- pbr_helper: string;
4
- brdf: string;
5
- direct_irradiance_frag_define: string;
6
- ibl_frag_define: string;
7
- pbr_frag: string;
8
- btdf: string;
9
- refraction: string;
10
- };
11
- export default _default;
@@ -1,8 +0,0 @@
1
- declare const _default: {
2
- ShadowCoord: string;
3
- ShadowFragmentDeclaration: string;
4
- shadow_sample_tent: string;
5
- ShadowVertexDeclaration: string;
6
- ShadowVertex: string;
7
- };
8
- export default _default;