@galacean/engine-core 2.0.0-alpha.5 → 2.0.0-alpha.51

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 (293) hide show
  1. package/dist/main.js +23869 -20445
  2. package/dist/main.js.map +1 -1
  3. package/dist/module.js +23857 -20437
  4. package/dist/module.js.map +1 -1
  5. package/package.json +3 -3
  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 +52 -0
  25. package/types/Camera.d.ts +73 -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 +17 -0
  30. package/types/Engine.d.ts +110 -4
  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 -1
  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 +18 -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 +81 -18
  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 +69 -0
  59. package/types/SystemInfo.d.ts +13 -0
  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/DataObject.d.ts +6 -0
  122. package/types/base/EngineObject.d.ts +4 -0
  123. package/types/base/Time.d.ts +13 -0
  124. package/types/base/index.d.ts +1 -0
  125. package/types/clone/CloneDecorators.d.ts +37 -0
  126. package/types/clone/CloneUtil.d.ts +30 -0
  127. package/types/clone/ComponentCloner.d.ts +4 -10
  128. package/types/clone/ICloneHook.d.ts +12 -0
  129. package/types/enums/CameraType.d.ts +9 -1
  130. package/types/env-probe/CubeProbe.d.ts +2 -0
  131. package/types/env-probe/Probe.d.ts +1 -1
  132. package/types/graphic/Buffer.d.ts +23 -3
  133. package/types/graphic/BufferUtil.d.ts +8 -0
  134. package/types/graphic/IndexBufferBinding.d.ts +4 -0
  135. package/types/graphic/Mesh.d.ts +58 -1
  136. package/types/graphic/Primitive.d.ts +50 -1
  137. package/types/graphic/TransformFeedback.d.ts +46 -0
  138. package/types/graphic/TransformFeedbackPrimitive.d.ts +67 -0
  139. package/types/graphic/TransformFeedbackSimulator.d.ts +55 -0
  140. package/types/graphic/VertexBufferBinding.d.ts +4 -0
  141. package/types/graphic/VertexElement.d.ts +1 -0
  142. package/types/graphic/enums/BufferBindFlag.d.ts +5 -3
  143. package/types/index.d.ts +7 -4
  144. package/types/input/InputManager.d.ts +25 -6
  145. package/types/input/enums/PointerButton.d.ts +8 -0
  146. package/types/input/keyboard/KeyboardManager.d.ts +41 -1
  147. package/types/input/pointer/Pointer.d.ts +37 -1
  148. package/types/input/pointer/PointerEventData.d.ts +4 -0
  149. package/types/input/pointer/PointerManager.d.ts +58 -0
  150. package/types/input/pointer/emitter/IHitResult.d.ts +11 -1
  151. package/types/input/pointer/emitter/PhysicsPointerEventEmitter.d.ts +20 -1
  152. package/types/input/wheel/WheelManager.d.ts +34 -1
  153. package/types/lighting/AmbientLight.d.ts +9 -8
  154. package/types/lighting/DirectLight.d.ts +17 -0
  155. package/types/lighting/KHR_lights.d.ts +13 -1
  156. package/types/lighting/Light.d.ts +2 -0
  157. package/types/lighting/LightManager.d.ts +57 -0
  158. package/types/lighting/PointLight.d.ts +17 -0
  159. package/types/lighting/SpotLight.d.ts +17 -0
  160. package/types/lighting/ambientOcclusion/AmbientOcclusion.d.ts +4 -0
  161. package/types/lighting/ambientOcclusion/ScalableAmbientObscurancePass.d.ts +38 -1
  162. package/types/material/BaseMaterial.d.ts +15 -11
  163. package/types/material/Material.d.ts +5 -9
  164. package/types/mesh/BlendShape.d.ts +14 -1
  165. package/types/mesh/BlendShapeFrame.d.ts +11 -4
  166. package/types/mesh/BlendShapeManager.d.ts +101 -1
  167. package/types/mesh/BufferMesh.d.ts +2 -2
  168. package/types/mesh/MeshRenderer.d.ts +42 -0
  169. package/types/mesh/ModelMesh.d.ts +23 -4
  170. package/types/mesh/PrimitiveMesh.d.ts +38 -4
  171. package/types/mesh/PrimitiveMeshRestorer.d.ts +107 -0
  172. package/types/mesh/Skin.d.ts +12 -3
  173. package/types/mesh/SkinnedMeshRenderer.d.ts +27 -1
  174. package/types/particle/ParticleBufferUtils.d.ts +26 -1
  175. package/types/particle/ParticleGenerator.d.ts +147 -2
  176. package/types/particle/ParticleMaterial.d.ts +3 -1
  177. package/types/particle/ParticleRenderer.d.ts +61 -1
  178. package/types/particle/ParticleTransformFeedbackSimulator.d.ts +52 -0
  179. package/types/particle/enums/ParticleRandomSubSeeds.d.ts +25 -1
  180. package/types/particle/enums/ParticleScaleMode.d.ts +5 -5
  181. package/types/particle/enums/ParticleSubEmitterInheritProperty.d.ts +17 -0
  182. package/types/particle/enums/ParticleSubEmitterType.d.ts +9 -0
  183. package/types/particle/enums/attributes/BillboardParticleVertexAttribute.d.ts +6 -1
  184. package/types/particle/enums/attributes/ParticleFeedbackVertexAttribute.d.ts +8 -0
  185. package/types/particle/enums/attributes/ParticleInstanceVertexAttribute.d.ts +17 -1
  186. package/types/particle/index.d.ts +7 -0
  187. package/types/particle/modules/Burst.d.ts +23 -2
  188. package/types/particle/modules/ColorOverLifetimeModule.d.ts +19 -0
  189. package/types/particle/modules/CustomDataModule.d.ts +90 -0
  190. package/types/particle/modules/EmissionModule.d.ts +36 -0
  191. package/types/particle/modules/ForceOverLifetimeModule.d.ts +16 -1
  192. package/types/particle/modules/LimitVelocityOverLifetimeModule.d.ts +164 -0
  193. package/types/particle/modules/MainModule.d.ts +45 -6
  194. package/types/particle/modules/NoiseModule.d.ts +114 -0
  195. package/types/particle/modules/ParticleCompositeCurve.d.ts +42 -4
  196. package/types/particle/modules/ParticleCompositeGradient.d.ts +8 -2
  197. package/types/particle/modules/ParticleCurve.d.ts +31 -2
  198. package/types/particle/modules/ParticleGeneratorModule.d.ts +9 -3
  199. package/types/particle/modules/ParticleGradient.d.ts +22 -5
  200. package/types/particle/modules/RotationOverLifetimeModule.d.ts +27 -3
  201. package/types/particle/modules/SizeOverLifetimeModule.d.ts +25 -0
  202. package/types/particle/modules/SubEmitter.d.ts +31 -0
  203. package/types/particle/modules/SubEmittersModule.d.ts +57 -0
  204. package/types/particle/modules/TextureSheetAnimationModule.d.ts +14 -1
  205. package/types/particle/modules/VelocityOverLifetimeModule.d.ts +120 -0
  206. package/types/particle/modules/shape/BaseShape.d.ts +65 -2
  207. package/types/particle/modules/shape/BoxShape.d.ts +13 -2
  208. package/types/particle/modules/shape/CircleShape.d.ts +13 -1
  209. package/types/particle/modules/shape/ConeShape.d.ts +13 -4
  210. package/types/particle/modules/shape/HemisphereShape.d.ts +13 -0
  211. package/types/particle/modules/shape/MeshShape.d.ts +26 -3
  212. package/types/particle/modules/shape/ShapeUtils.d.ts +13 -1
  213. package/types/particle/modules/shape/SphereShape.d.ts +13 -0
  214. package/types/physics/CharacterController.d.ts +21 -0
  215. package/types/physics/Collider.d.ts +47 -2
  216. package/types/physics/Collision.d.ts +3 -0
  217. package/types/physics/DynamicCollider.d.ts +28 -1
  218. package/types/physics/HitResult.d.ts +2 -2
  219. package/types/physics/PhysicsMaterial.d.ts +3 -0
  220. package/types/physics/PhysicsScene.d.ts +56 -6
  221. package/types/physics/StaticCollider.d.ts +5 -0
  222. package/types/physics/enums/ColliderShapeChangeFlag.d.ts +8 -1
  223. package/types/physics/enums/HingeJointFlag.d.ts +14 -1
  224. package/types/physics/joint/HingeJoint.d.ts +4 -0
  225. package/types/physics/joint/Joint.d.ts +22 -2
  226. package/types/physics/joint/JointLimits.d.ts +2 -1
  227. package/types/physics/joint/JointMotor.d.ts +2 -1
  228. package/types/physics/shape/ColliderShape.d.ts +26 -3
  229. package/types/physics/shape/MeshColliderShape.d.ts +11 -5
  230. package/types/postProcess/FinalPass.d.ts +19 -1
  231. package/types/postProcess/PostProcess.d.ts +11 -6
  232. package/types/postProcess/PostProcessEffect.d.ts +6 -1
  233. package/types/postProcess/PostProcessEffectParameter.d.ts +23 -3
  234. package/types/postProcess/PostProcessManager.d.ts +43 -0
  235. package/types/postProcess/PostProcessPass.d.ts +3 -2
  236. package/types/postProcess/PostProcessUberPass.d.ts +2 -1
  237. package/types/postProcess/effects/BloomEffect.d.ts +26 -1
  238. package/types/postProcess/effects/TonemappingEffect.d.ts +3 -0
  239. package/types/renderingHardwareInterface/IPlatformBuffer.d.ts +1 -0
  240. package/types/renderingHardwareInterface/IPlatformTransformFeedback.d.ts +36 -0
  241. package/types/renderingHardwareInterface/IPlatformTransformFeedbackPrimitive.d.ts +40 -0
  242. package/types/renderingHardwareInterface/index.d.ts +2 -0
  243. package/types/shader/Shader.d.ts +38 -22
  244. package/types/shader/ShaderBlockProperty.d.ts +19 -0
  245. package/types/shader/ShaderData.d.ts +43 -4
  246. package/types/shader/ShaderFactory.d.ts +78 -0
  247. package/types/shader/ShaderMacro.d.ts +17 -2
  248. package/types/shader/ShaderMacroCollection.d.ts +57 -1
  249. package/types/shader/ShaderMacroProcessor.d.ts +72 -0
  250. package/types/shader/ShaderPass.d.ts +46 -13
  251. package/types/shader/ShaderProgram.d.ts +91 -1
  252. package/types/shader/ShaderProgramMap.d.ts +20 -0
  253. package/types/shader/ShaderProperty.d.ts +17 -0
  254. package/types/shader/ShaderTagKey.d.ts +2 -0
  255. package/types/shader/ShaderUniform.d.ts +49 -1
  256. package/types/shader/ShaderUniformBlock.d.ts +9 -1
  257. package/types/shader/enums/ConstantBufferBindingPoint.d.ts +7 -0
  258. package/types/shader/enums/ShaderPreprocessorDirective.d.ts +16 -0
  259. package/types/shader/index.d.ts +1 -1
  260. package/types/shader/state/BlendState.d.ts +16 -1
  261. package/types/shader/state/DepthState.d.ts +16 -1
  262. package/types/shader/state/RasterState.d.ts +19 -1
  263. package/types/shader/state/RenderState.d.ts +13 -2
  264. package/types/shader/state/RenderTargetBlendState.d.ts +2 -1
  265. package/types/shader/state/StencilState.d.ts +15 -1
  266. package/types/shadow/CascadedShadowCasterPass.d.ts +5 -0
  267. package/types/shadow/ShadowSliceData.d.ts +13 -1
  268. package/types/shadow/ShadowUtils.d.ts +43 -1
  269. package/types/sky/Sky.d.ts +13 -4
  270. package/types/sky/SkyBoxMaterial.d.ts +0 -7
  271. package/types/texture/RenderTarget.d.ts +28 -3
  272. package/types/texture/Texture.d.ts +21 -0
  273. package/types/texture/Texture2D.d.ts +4 -0
  274. package/types/texture/Texture2DArray.d.ts +4 -0
  275. package/types/texture/TextureCube.d.ts +4 -0
  276. package/types/texture/TextureUtils.d.ts +16 -1
  277. package/types/trail/TrailRenderer.d.ts +13 -8
  278. package/types/ui/IUICanvas.d.ts +16 -1
  279. package/types/utils/DisorderedArray.d.ts +3 -1
  280. package/types/xr/XRManager.d.ts +28 -0
  281. package/types/RenderPipeline/BatchUtils.d.ts +0 -1
  282. package/types/RenderPipeline/SubRenderElement.d.ts +0 -22
  283. package/types/clone/CloneManager.d.ts +0 -31
  284. package/types/clone/enums/CloneMode.d.ts +0 -13
  285. package/types/shader/ShaderPool.d.ts +0 -1
  286. package/types/shader/ShaderProgramPool.d.ts +0 -1
  287. package/types/shader/state/index.d.ts +0 -6
  288. package/types/shaderlib/ShaderFactory.d.ts +0 -20
  289. package/types/shaderlib/ShaderLib.d.ts +0 -73
  290. package/types/shaderlib/index.d.ts +0 -1
  291. package/types/shaderlib/particle/index.d.ts +0 -15
  292. package/types/shaderlib/pbr/index.d.ts +0 -11
  293. package/types/shaderlib/shadow/index.d.ts +0 -8
@@ -1,2 +1,54 @@
1
+ import { SpriteMaskInteraction } from "./2d";
2
+ import { Engine } from "./Engine";
3
+ import { RenderQueueMaskType } from "./RenderPipeline/enums/RenderQueueMaskType";
4
+ import { BlinnPhongMaterial, Material } from "./material";
5
+ import { ModelMesh } from "./mesh";
1
6
  import { RenderStateElementKey } from "./shader/enums/RenderStateElementKey";
7
+ import { Texture2D, TextureCube } from "./texture";
8
+ import { Texture2DArray } from "./texture/Texture2DArray";
9
+ /**
10
+ * @internal
11
+ */
12
+ export declare class BasicResources {
13
+ engine: Engine;
14
+ private static _maskReadInsideRenderStates;
15
+ private static _maskReadOutsideRenderStates;
16
+ private static _maskWriteIncrementRenderStates;
17
+ private static _maskWriteDecrementRenderStates;
18
+ static getMaskInteractionRenderStates(maskInteraction: SpriteMaskInteraction): RenderStateElementMap;
19
+ static getMaskTypeRenderStates(maskType: RenderQueueMaskType): RenderStateElementMap;
20
+ /**
21
+ * Use triangle to blit texture, ref: https://michaldrobot.com/2014/04/01/gcn-execution-patterns-in-full-screen-passes/ .
22
+ */
23
+ readonly blitMesh: ModelMesh;
24
+ readonly flipYBlitMesh: ModelMesh;
25
+ readonly blitMaterial: Material;
26
+ readonly blitScreenMaterial: Material;
27
+ readonly whiteTexture2D: Texture2D;
28
+ readonly whiteTextureCube: TextureCube;
29
+ readonly whiteTexture2DArray: Texture2DArray;
30
+ readonly uintWhiteTexture2D: Texture2D;
31
+ readonly spriteDefaultMaterial: Material;
32
+ readonly textDefaultMaterial: Material;
33
+ readonly spriteMaskDefaultMaterial: Material;
34
+ readonly meshMagentaMaterial: Material;
35
+ readonly particleMagentaMaterial: Material;
36
+ private _blinnPhongMaterial;
37
+ private _prefilteredDFGTexture;
38
+ get prefilteredDFGTexture(): Texture2D;
39
+ constructor(engine: Engine);
40
+ /**
41
+ * @internal
42
+ */
43
+ _getBlinnPhongMaterial(): BlinnPhongMaterial;
44
+ /**
45
+ * @internal
46
+ */
47
+ _initialize(): Promise<BasicResources>;
48
+ private _createBlitMesh;
49
+ private _create1x1Texture;
50
+ private _create2DMaterial;
51
+ private _createMagentaMaterial;
52
+ private _createSpriteMaskMaterial;
53
+ }
2
54
  export type RenderStateElementMap = Record<RenderStateElementKey, number | boolean>;
package/types/Camera.d.ts CHANGED
@@ -1,15 +1,23 @@
1
- import { Matrix, Ray, Rect, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
1
+ import { BoundingFrustum, Matrix, Ray, Rect, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
2
2
  import { Component } from "./Component";
3
+ import { Entity } from "./Entity";
3
4
  import { Layer } from "./Layer";
5
+ import { BasicRenderPipeline } from "./RenderPipeline/BasicRenderPipeline";
6
+ import { VirtualCamera } from "./VirtualCamera";
4
7
  import { AntiAliasing } from "./enums/AntiAliasing";
5
8
  import { CameraClearFlags } from "./enums/CameraClearFlags";
9
+ import { CameraModifyFlags } from "./enums/CameraModifyFlags";
10
+ import { CameraType } from "./enums/CameraType";
6
11
  import { DepthTextureMode } from "./enums/DepthTextureMode";
7
12
  import { Downsampling } from "./enums/Downsampling";
8
13
  import { MSAASamples } from "./enums/MSAASamples";
9
14
  import { ReplacementFailureStrategy } from "./enums/ReplacementFailureStrategy";
10
15
  import { Shader } from "./shader/Shader";
11
16
  import { ShaderData } from "./shader/ShaderData";
17
+ import { ShaderMacroCollection } from "./shader/ShaderMacroCollection";
18
+ import { ShaderProperty } from "./shader/ShaderProperty";
12
19
  import { ShaderTagKey } from "./shader/ShaderTagKey";
20
+ import { TextureFormat } from "./texture";
13
21
  import { RenderTarget } from "./texture/RenderTarget";
14
22
  import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
15
23
  /**
@@ -17,6 +25,12 @@ import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
17
25
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
18
26
  */
19
27
  export declare class Camera extends Component {
28
+ /** @internal */
29
+ static _cameraDepthTextureProperty: ShaderProperty;
30
+ /** @internal */
31
+ static _cameraOpaqueTextureProperty: ShaderProperty;
32
+ /** @internal */
33
+ static _cameraAOTextureProperty: ShaderProperty;
20
34
  private static _inverseViewMatrixProperty;
21
35
  private static _cameraPositionProperty;
22
36
  private static _cameraForwardProperty;
@@ -70,6 +84,24 @@ export declare class Camera extends Component {
70
84
  * @defaultValue `false`
71
85
  */
72
86
  isAlphaOutputRequired: boolean;
87
+ /** @internal */
88
+ _cameraType: CameraType;
89
+ /** @internal */
90
+ _globalShaderMacro: ShaderMacroCollection;
91
+ /** @internal */
92
+ _frustum: BoundingFrustum;
93
+ /** @internal */
94
+ _renderPipeline: BasicRenderPipeline;
95
+ /** @internal */
96
+ _virtualCamera: VirtualCamera;
97
+ /** @internal */
98
+ _replacementShader: Shader | null;
99
+ /** @internal */
100
+ _replacementSubShaderTag: ShaderTagKey | null | undefined;
101
+ /** @internal */
102
+ _replacementFailureStrategy: ReplacementFailureStrategy | null;
103
+ /** @internal */
104
+ _cameraIndex: number;
73
105
  private _priority;
74
106
  private _isCustomViewMatrix;
75
107
  private _isCustomProjectionMatrix;
@@ -189,6 +221,10 @@ export declare class Camera extends Component {
189
221
  */
190
222
  get msaaSamples(): MSAASamples;
191
223
  set msaaSamples(value: MSAASamples);
224
+ /**
225
+ * @internal
226
+ */
227
+ constructor(entity: Entity);
192
228
  /**
193
229
  * Restore the view matrix to the world matrix of the entity.
194
230
  */
@@ -295,13 +331,49 @@ export declare class Camera extends Component {
295
331
  */
296
332
  resetReplacementShader(): void;
297
333
  /**
334
+ * @internal
298
335
  * @inheritdoc
299
336
  */
300
337
  _onEnableInScene(): void;
301
338
  /**
339
+ * @internal
302
340
  * @inheritdoc
303
341
  */
304
342
  _onDisableInScene(): void;
343
+ /**
344
+ * @internal
345
+ * Whether independent canvas is enabled.
346
+ */
347
+ _isIndependentCanvasEnabled(): boolean;
348
+ /**
349
+ * @internal
350
+ */
351
+ _getInternalColorTextureFormat(): TextureFormat;
352
+ /**
353
+ * @internal
354
+ */
355
+ _needFinalPass(): boolean;
356
+ /**
357
+ * @internal
358
+ */
359
+ _getTargetColorTextureFormat(): TextureFormat;
360
+ /**
361
+ * @internal
362
+ */
363
+ _isTargetFormatHDR(): boolean;
364
+ /**
365
+ * @internal
366
+ */
367
+ _registerModifyListener(onChange: (flag: CameraModifyFlags) => void): void;
368
+ /**
369
+ * @internal
370
+ */
371
+ _unRegisterModifyListener(onChange: (flag: CameraModifyFlags) => void): void;
372
+ /**
373
+ * @internal
374
+ * @inheritdoc
375
+ */
376
+ protected _onDestroy(): void;
305
377
  private _updatePixelViewport;
306
378
  private _adjustPixelViewport;
307
379
  private _viewMatrixChange;
package/types/Canvas.d.ts CHANGED
@@ -1,19 +1,48 @@
1
+ import { UpdateFlagManager } from "./UpdateFlagManager";
1
2
  /**
2
- * Canvas.
3
+ * The canvas the engine renders to; owns the render-buffer resolution.
3
4
  */
4
5
  export declare abstract class Canvas {
6
+ /**
7
+ * @internal
8
+ */
9
+ _sizeUpdateFlagManager: UpdateFlagManager;
5
10
  private _width;
6
11
  private _height;
7
12
  /**
8
- * The width of the canvas.
13
+ * The width component of the canvas resolution, in pixels.
9
14
  */
10
15
  get width(): number;
11
- set width(value: number);
12
16
  /**
13
- *The height of the canvas.
17
+ * The height component of the canvas resolution, in pixels.
14
18
  */
15
19
  get height(): number;
16
- set height(value: number);
17
- protected abstract _onWidthChanged(value: number): void;
18
- protected abstract _onHeightChange(value: number): void;
20
+ /**
21
+ * Lock the render buffer to an explicit resolution and stop following the display size.
22
+ * @param width - Render buffer width in pixels
23
+ * @param height - Render buffer height in pixels
24
+ *
25
+ * @throws
26
+ * Throw an error if width or height is not a positive finite number.
27
+ */
28
+ setResolution(width: number, height: number): void;
29
+ /**
30
+ * Make the render buffer automatically follow the canvas display size.
31
+ * @param scale - Multiplier applied to the device pixel ratio (1 = native sharpness, 0.7 = save GPU, 2 = supersample), defaults to `1`
32
+ *
33
+ * @throws
34
+ * Throw an error if scale is not a positive finite number.
35
+ */
36
+ abstract setAutoResolution(scale?: number): void;
37
+ protected _setResolution(width: number, height: number): void;
38
+ /**
39
+ * @internal
40
+ */
41
+ _pumpPendingResolution(): void;
42
+ /**
43
+ * @internal
44
+ */
45
+ abstract _destroy(): void;
46
+ protected _exitAutoResolution(): void;
47
+ protected abstract _onResolutionChanged(width: number, height: number): void;
19
48
  }
@@ -1,11 +1,16 @@
1
1
  import { IReferable } from "./asset/IReferable";
2
2
  import { EngineObject } from "./base";
3
3
  import { Entity } from "./Entity";
4
+ import { ActiveChangeFlag } from "./enums/ActiveChangeFlag";
4
5
  import { Scene } from "./Scene";
5
6
  /**
6
7
  * The base class of the components.
7
8
  */
8
9
  export declare class Component extends EngineObject {
10
+ /** @internal */
11
+ _entity: Entity;
12
+ /** @internal */
13
+ _awoken: boolean;
9
14
  protected _phasedActiveInScene: boolean;
10
15
  private _phasedActive;
11
16
  private _enabled;
@@ -19,9 +24,37 @@ export declare class Component extends EngineObject {
19
24
  */
20
25
  get entity(): Entity;
21
26
  /**
22
- * The scene which the component's entity belongs to.
27
+ * The owning entity's scene, or null/undefined if it is not in a scene.
23
28
  */
24
- get scene(): Scene;
29
+ get scene(): Scene | null | undefined;
25
30
  constructor(entity: Entity);
31
+ /**
32
+ * @internal
33
+ */
34
+ _onAwake(): void;
35
+ /**
36
+ * @internal
37
+ */
38
+ _onEnable(): void;
39
+ /**
40
+ * @internal
41
+ */
42
+ _onDisable(): void;
43
+ /**
44
+ * @internal
45
+ */
46
+ _onEnableInScene(): void;
47
+ /**
48
+ * @internal
49
+ */
50
+ _onDisableInScene(): void;
51
+ /**
52
+ * @internal
53
+ */
54
+ _setActive(value: boolean, activeChangeFlag: ActiveChangeFlag): void;
26
55
  protected _addResourceReferCount(resource: IReferable, count: number): void;
56
+ /**
57
+ * @internal
58
+ */
59
+ protected _onDestroy(): void;
27
60
  }
@@ -1,4 +1,33 @@
1
- import { ComponentConstructor } from "./Entity";
1
+ import { ComponentConstructor, Entity } from "./Entity";
2
+ /**
3
+ * @internal
4
+ * Used for component dependency registration.
5
+ */
6
+ export declare class ComponentsDependencies {
7
+ private static _invDependenciesMap;
8
+ static _dependenciesMap: Map<ComponentConstructor, DependentInfo>;
9
+ /**
10
+ * @internal
11
+ */
12
+ static _addCheck(entity: Entity, type: ComponentConstructor): void;
13
+ /**
14
+ * @internal
15
+ */
16
+ static _hasDependencies(type: ComponentConstructor): boolean;
17
+ /**
18
+ * @internal
19
+ */
20
+ static _removeCheck(entity: Entity, type: ComponentConstructor, replace?: ComponentConstructor): void;
21
+ /**
22
+ * @internal
23
+ */
24
+ static _addDependency(targetInfo: DependentInfo, dependentComponent: ComponentConstructor, map: Map<DependentInfo, ComponentConstructor[]>): void;
25
+ /**
26
+ * @internal
27
+ */
28
+ static _addInvDependency(currentComponent: ComponentConstructor, dependentComponent: ComponentConstructor): void;
29
+ private constructor();
30
+ }
2
31
  /**
3
32
  * Declare dependent component.
4
33
  * @param component - Dependent component
@@ -20,3 +49,11 @@ export declare enum DependentMode {
20
49
  /** Auto add if dependent components do not exist. */
21
50
  AutoAdd = 1
22
51
  }
52
+ /**
53
+ * @internal
54
+ */
55
+ interface DependentInfo {
56
+ mode: DependentMode;
57
+ components: ComponentConstructor[];
58
+ }
59
+ export {};
@@ -4,10 +4,23 @@ import { Renderer } from "./Renderer";
4
4
  import { Script } from "./Script";
5
5
  import { Animator } from "./animation";
6
6
  import { IUICanvas } from "./ui/IUICanvas";
7
+ import { DisorderedArray } from "./utils/DisorderedArray";
7
8
  /**
8
9
  * The manager of the components.
9
10
  */
10
11
  export declare class ComponentsManager {
12
+ /** @internal */
13
+ _cameraNeedSorting: boolean;
14
+ /** @internal */
15
+ _activeCameras: DisorderedArray<Camera>;
16
+ /** @internal */
17
+ _renderers: DisorderedArray<Renderer>;
18
+ /** @internal */
19
+ _overlayCanvases: DisorderedArray<IUICanvas>;
20
+ /** @internal */
21
+ _overlayCanvasesSortingDirty: boolean;
22
+ /** @internal */
23
+ _canvases: DisorderedArray<IUICanvas>;
11
24
  private _onStartScripts;
12
25
  private _onUpdateScripts;
13
26
  private _onLateUpdateScripts;
@@ -45,4 +58,8 @@ export declare class ComponentsManager {
45
58
  callCameraOnEndRender(camera: Camera): void;
46
59
  getActiveChangedTempList(): Component[];
47
60
  putActiveChangedTempList(componentContainer: Component[]): void;
61
+ /**
62
+ * @internal
63
+ */
64
+ _gc(): void;
48
65
  }
package/types/Engine.d.ts CHANGED
@@ -1,24 +1,101 @@
1
- import { IHardwareRenderer, IInputOptions, IPhysics, IShaderLab, IXRDevice } from "@galacean/engine-design";
1
+ import { IHardwareRenderer, IInputOptions, IPhysics, IPhysicsManager, IShaderCompiler, IXRDevice } from "@galacean/engine-design";
2
+ import { CharRenderInfo } from "./2d/text/CharRenderInfo";
3
+ import { Font } from "./2d/text/Font";
4
+ import { BasicResources } from "./BasicResources";
2
5
  import { Canvas } from "./Canvas";
3
6
  import { EngineSettings } from "./EngineSettings";
4
7
  import { Entity } from "./Entity";
8
+ import { BatcherManager } from "./RenderPipeline/BatcherManager";
9
+ import { RenderContext } from "./RenderPipeline/RenderContext";
10
+ import { RenderTargetPool } from "./RenderPipeline/RenderTargetPool";
11
+ import { RenderElement } from "./RenderPipeline/RenderElement";
12
+ import { Scene } from "./Scene";
5
13
  import { SceneManager } from "./SceneManager";
6
14
  import { RenderingStatistics } from "./asset/RenderingStatistics";
7
15
  import { ResourceManager } from "./asset/ResourceManager";
8
- import { EventDispatcher, Time } from "./base";
16
+ import { EngineObject, EventDispatcher, Time } from "./base";
9
17
  import { InputManager } from "./input";
10
18
  import { ParticleBufferUtils } from "./particle/ParticleBufferUtils";
19
+ import { ColliderShape } from "./physics/shape/ColliderShape";
11
20
  import { PostProcessPass } from "./postProcess/PostProcessPass";
21
+ import { ShaderMacro } from "./shader/ShaderMacro";
22
+ import { ShaderMacroCollection } from "./shader/ShaderMacroCollection";
23
+ import { ShaderProgramMap } from "./shader/ShaderProgramMap";
24
+ import { RenderState } from "./shader/state/RenderState";
25
+ import { Texture2D } from "./texture";
26
+ import { ClearableObjectPool } from "./utils/ClearableObjectPool";
27
+ import { ReturnableObjectPool } from "./utils/ReturnableObjectPool";
12
28
  import { XRManager } from "./xr/XRManager";
13
29
  /**
14
30
  * Engine.
15
31
  */
16
32
  export declare class Engine extends EventDispatcher {
33
+ /** @internal */
34
+ static _noDepthTextureMacro: ShaderMacro;
35
+ /** @internal */
36
+ static _noSRGBSupportMacro: ShaderMacro;
37
+ /** @internal */
38
+ static _outputSRGBCorrectMacro: ShaderMacro;
39
+ /** @internal Conversion of space units to pixel units for 2D. */
40
+ static _pixelsPerUnit: number;
41
+ /** @internal */
42
+ static _physicalObjectsMap: Record<number, ColliderShape>;
43
+ /** @internal */
44
+ static _nativePhysics: IPhysics;
17
45
  /** Input manager of Engine. */
18
46
  readonly inputManager: InputManager;
19
47
  /** XR manager of Engine. */
20
48
  readonly xrManager: XRManager;
49
+ /** @internal */
50
+ _renderingStatistics: RenderingStatistics;
51
+ /** @internal */
52
+ _isDeviceLost: boolean;
53
+ /** @internal */
54
+ _batcherManager: BatcherManager;
55
+ /** @internal */
21
56
  _particleBufferUtils: ParticleBufferUtils;
57
+ /** @internal */
58
+ _frameInProcess: boolean;
59
+ /** @internal */
60
+ _pendingDestroyObjects: EngineObject[];
61
+ /** @internal */
62
+ _processingPendingDestroys: boolean;
63
+ /** @internal */
64
+ _physicsInitialized: boolean;
65
+ /** @internal */
66
+ _nativePhysicsManager: IPhysicsManager;
67
+ /** @internal */
68
+ _hardwareRenderer: IHardwareRenderer;
69
+ /** @internal */
70
+ _renderTargetPool: RenderTargetPool;
71
+ /** @internal */
72
+ _lastRenderState: RenderState;
73
+ /** @internal */
74
+ _renderElementPool: ClearableObjectPool<RenderElement>;
75
+ /** @internal */
76
+ _textRenderElementPool: ClearableObjectPool<RenderElement>;
77
+ /** @internal */
78
+ _charRenderInfoPool: ReturnableObjectPool<CharRenderInfo>;
79
+ /** @internal */
80
+ _basicResources: BasicResources;
81
+ /** @internal */
82
+ _textDefaultFont: Font | null;
83
+ /** @internal */
84
+ _renderContext: RenderContext;
85
+ /** @internal */
86
+ _depthTexture2D: Texture2D;
87
+ /** @internal */
88
+ _renderCount: number;
89
+ /** @internal */
90
+ _shaderProgramMaps: ShaderProgramMap[];
91
+ /** @internal */
92
+ _fontMap: Record<string, Font>;
93
+ /** @internal */
94
+ _macroCollection: ShaderMacroCollection;
95
+ /** @internal */
96
+ _postProcessPassNeedRefresh: boolean;
97
+ /** @internal */
98
+ protected _canvas: Canvas;
22
99
  private _settings;
23
100
  private _resourceManager;
24
101
  private _sceneManager;
@@ -35,6 +112,7 @@ export declare class Engine extends EventDispatcher {
35
112
  private _waitingGC;
36
113
  private _postProcessPasses;
37
114
  private _activePostProcessPasses;
115
+ private _onCanvasResize;
38
116
  private _animate;
39
117
  /**
40
118
  * Settings of Engine.
@@ -124,6 +202,18 @@ export declare class Engine extends EventDispatcher {
124
202
  * @param pass - Post process pass to add
125
203
  */
126
204
  addPostProcessPass(pass: PostProcessPass): void;
205
+ /**
206
+ * @internal
207
+ */
208
+ _removePostProcessPass(pass: PostProcessPass): void;
209
+ /**
210
+ * @internal
211
+ */
212
+ _refreshActivePostProcessPasses(): void;
213
+ /**
214
+ * @internal
215
+ */
216
+ _getActivePostProcessPasses(): ReadonlyArray<PostProcessPass>;
127
217
  private _processPendingDestroyObjects;
128
218
  private _destroy;
129
219
  /**
@@ -131,6 +221,22 @@ export declare class Engine extends EventDispatcher {
131
221
  * @remarks If call during frame execution will delay until the end of the frame
132
222
  */
133
223
  destroy(): void;
224
+ /**
225
+ * @internal
226
+ */
227
+ _getShaderProgramMap(index: number, trackMaps?: ShaderProgramMap[]): ShaderProgramMap;
228
+ /**
229
+ * @internal
230
+ */
231
+ _render(scenes: ReadonlyArray<Scene>): void;
232
+ /**
233
+ * @internal
234
+ */
235
+ _pendingGC(): void;
236
+ /**
237
+ * @internal
238
+ */
239
+ protected _initialize(configuration: EngineConfiguration): Promise<Engine>;
134
240
  private _onDeviceLost;
135
241
  private _onDeviceRestored;
136
242
  private _gc;
@@ -148,8 +254,8 @@ export interface EngineConfiguration {
148
254
  physics?: IPhysics;
149
255
  /** XR Device. */
150
256
  xrDevice?: IXRDevice;
151
- /** Shader lab. */
152
- shaderLab?: IShaderLab;
257
+ /** Shader compiler. */
258
+ shaderCompiler?: IShaderCompiler;
153
259
  /** Input options. */
154
260
  input?: IInputOptions;
155
261
  }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Engine event type.
3
+ */
4
+ export declare enum EngineEventType {
5
+ /** Dispatched when the engine starts running. */
6
+ Run = "run",
7
+ /** Dispatched when the engine shuts down. */
8
+ Shutdown = "shutdown",
9
+ /** Dispatched when the graphic device is lost. */
10
+ DeviceLost = "devicelost",
11
+ /** Dispatched when the graphic device is restored. */
12
+ DeviceRestored = "devicerestored"
13
+ }