@galacean/engine-core 0.0.0-experimental-0.9-plus.7 → 0.0.0-experimental-ktx2.0

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 (127) hide show
  1. package/dist/main.js +18302 -15438
  2. package/dist/main.js.map +1 -1
  3. package/dist/miniprogram.js +18302 -15438
  4. package/dist/module.js +18088 -15234
  5. package/dist/module.js.map +1 -1
  6. package/package.json +3 -3
  7. package/types/2d/atlas/SpriteAtlas.d.ts +2 -6
  8. package/types/2d/enums/SpriteDrawMode.d.ts +4 -2
  9. package/types/2d/index.d.ts +1 -0
  10. package/types/2d/sprite/Sprite.d.ts +5 -2
  11. package/types/2d/sprite/SpriteMask.d.ts +0 -11
  12. package/types/2d/sprite/SpriteRenderer.d.ts +15 -11
  13. package/types/2d/text/Font.d.ts +2 -7
  14. package/types/2d/text/TextRenderer.d.ts +0 -11
  15. package/types/2d/text/index.d.ts +1 -0
  16. package/types/Camera.d.ts +60 -16
  17. package/types/Component.d.ts +1 -8
  18. package/types/ComponentsDependencies.d.ts +17 -9
  19. package/types/DisorderedArray.d.ts +4 -3
  20. package/types/Engine.d.ts +43 -46
  21. package/types/Entity.d.ts +4 -2
  22. package/types/RenderPipeline/Basic2DBatcher.d.ts +6 -7
  23. package/types/RenderPipeline/BasicRenderPipeline.d.ts +7 -6
  24. package/types/RenderPipeline/ClassPool.d.ts +3 -1
  25. package/types/RenderPipeline/IPoolElement.d.ts +3 -0
  26. package/types/RenderPipeline/MeshRenderData.d.ts +3 -1
  27. package/types/RenderPipeline/PipelinePass.d.ts +16 -0
  28. package/types/RenderPipeline/PipelineUtils.d.ts +1 -0
  29. package/types/RenderPipeline/RenderElement.d.ts +8 -10
  30. package/types/RenderPipeline/RenderPass.d.ts +1 -1
  31. package/types/RenderPipeline/RenderQueue.d.ts +3 -5
  32. package/types/RenderPipeline/SpriteMaskBatcher.d.ts +4 -3
  33. package/types/RenderPipeline/SpriteMaskRenderData.d.ts +3 -1
  34. package/types/RenderPipeline/SpriteRenderData.d.ts +3 -1
  35. package/types/RenderPipeline/TextRenderData.d.ts +3 -1
  36. package/types/RenderPipeline/enums/PipelineStage.d.ts +2 -0
  37. package/types/Renderer.d.ts +8 -14
  38. package/types/Scene.d.ts +13 -9
  39. package/types/SceneManager.d.ts +28 -5
  40. package/types/Script.d.ts +18 -15
  41. package/types/Transform.d.ts +10 -12
  42. package/types/Utils.d.ts +28 -0
  43. package/types/animation/AnimationClip.d.ts +2 -1
  44. package/types/animation/Animator.d.ts +5 -4
  45. package/types/animation/animationCurve/AnimationFloatArrayCurve.d.ts +0 -1
  46. package/types/animation/enums/LayerState.d.ts +3 -1
  47. package/types/asset/AssetType.d.ts +18 -16
  48. package/types/asset/LoadItem.d.ts +16 -9
  49. package/types/asset/Loader.d.ts +3 -1
  50. package/types/asset/ResourceManager.d.ts +23 -11
  51. package/types/asset/request.d.ts +7 -3
  52. package/types/base/Constant.d.ts +3 -1
  53. package/types/base/EngineObject.d.ts +1 -0
  54. package/types/base/EventDispatcher.d.ts +2 -15
  55. package/types/base/Time.d.ts +25 -24
  56. package/types/base/index.d.ts +0 -2
  57. package/types/clone/ComponentCloner.d.ts +2 -1
  58. package/types/enums/DepthTextureMode.d.ts +7 -0
  59. package/types/env-probe/CubeProbe.d.ts +0 -7
  60. package/types/env-probe/Probe.d.ts +0 -6
  61. package/types/graphic/Buffer.d.ts +25 -16
  62. package/types/graphic/BufferUtil.d.ts +1 -0
  63. package/types/graphic/Mesh.d.ts +5 -16
  64. package/types/graphic/SubMesh.d.ts +3 -1
  65. package/types/graphic/VertexElement.d.ts +10 -6
  66. package/types/index.d.ts +9 -7
  67. package/types/input/InputManager.d.ts +3 -3
  68. package/types/input/interface/IInput.d.ts +1 -1
  69. package/types/lighting/AmbientLight.d.ts +4 -1
  70. package/types/lighting/DirectLight.d.ts +0 -1
  71. package/types/lighting/Light.d.ts +0 -1
  72. package/types/lighting/LightManager.d.ts +1 -0
  73. package/types/lighting/SpotLight.d.ts +0 -1
  74. package/types/material/BaseMaterial.d.ts +8 -10
  75. package/types/material/BlinnPhongMaterial.d.ts +0 -3
  76. package/types/material/Material.d.ts +8 -8
  77. package/types/material/PBRMaterial.d.ts +1 -1
  78. package/types/material/PBRSpecularMaterial.d.ts +1 -1
  79. package/types/material/UnlitMaterial.d.ts +1 -1
  80. package/types/mesh/BlendShape.d.ts +1 -1
  81. package/types/mesh/BlendShapeFrame.d.ts +28 -6
  82. package/types/mesh/BufferMesh.d.ts +2 -2
  83. package/types/mesh/MeshRenderer.d.ts +1 -11
  84. package/types/mesh/ModelMesh.d.ts +62 -41
  85. package/types/mesh/PrimitiveMesh.d.ts +6 -2
  86. package/types/mesh/Skin.d.ts +3 -0
  87. package/types/mesh/SkinnedMeshRenderer.d.ts +18 -24
  88. package/types/mesh/index.d.ts +6 -5
  89. package/types/particle/ParticleRenderer.d.ts +2 -2
  90. package/types/physics/CharacterController.d.ts +0 -2
  91. package/types/physics/Collider.d.ts +1 -1
  92. package/types/physics/PhysicsManager.d.ts +1 -20
  93. package/types/physics/index.d.ts +7 -7
  94. package/types/physics/joint/HingeJoint.d.ts +2 -2
  95. package/types/physics/joint/Joint.d.ts +2 -2
  96. package/types/physics/joint/SpringJoint.d.ts +1 -1
  97. package/types/renderingHardwareInterface/IPlatformBuffer.d.ts +0 -1
  98. package/types/renderingHardwareInterface/IPlatformTexture2D.d.ts +1 -1
  99. package/types/renderingHardwareInterface/IPlatformTexture2DArray.d.ts +1 -1
  100. package/types/renderingHardwareInterface/IPlatformTextureCube.d.ts +1 -1
  101. package/types/renderingHardwareInterface/index.d.ts +1 -0
  102. package/types/shader/Shader.d.ts +54 -23
  103. package/types/shader/ShaderData.d.ts +24 -24
  104. package/types/shader/ShaderMacro.d.ts +16 -0
  105. package/types/shader/ShaderPass.d.ts +9 -2
  106. package/types/shader/ShaderProperty.d.ts +7 -0
  107. package/types/shader/enums/RenderStateElementKey.d.ts +58 -0
  108. package/types/shader/index.d.ts +6 -1
  109. package/types/shadow/CascadedShadowCasterPass.d.ts +5 -7
  110. package/types/sky/SkyBoxMaterial.d.ts +27 -9
  111. package/types/sky/index.d.ts +1 -0
  112. package/types/texture/RenderTarget.d.ts +3 -8
  113. package/types/texture/Texture.d.ts +8 -6
  114. package/types/texture/Texture2D.d.ts +4 -2
  115. package/types/texture/Texture2DArray.d.ts +1 -1
  116. package/types/texture/TextureCube.d.ts +1 -1
  117. package/types/texture/enums/TextureFormat.d.ts +55 -49
  118. package/types/texture/enums/TextureUsage.d.ts +9 -0
  119. package/types/texture/index.d.ts +1 -0
  120. package/types/trail/TrailRenderer.d.ts +0 -5
  121. package/types/SafeLoopArray.d.ts +0 -37
  122. package/types/utils/BoolUpdateFlag.d.ts +0 -12
  123. package/types/utils/DisorderedArray.d.ts +0 -18
  124. package/types/utils/UpdateFlag.d.ts +0 -20
  125. package/types/utils/Utils.d.ts +0 -31
  126. /package/types/{animation/internal/AnimationCurveOwnerLayerData.d.ts → RenderPipeline/CullingResults.d.ts} +0 -0
  127. /package/types/{utils/UpdateFlagManager.d.ts → RenderPipeline/DepthOnlyPass.d.ts} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@galacean/engine-core",
3
- "version": "0.0.0-experimental-0.9-plus.7",
3
+ "version": "0.0.0-experimental-ktx2.0",
4
4
  "publishConfig": {
5
5
  "access": "public",
6
6
  "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
15
15
  "types/**/*"
16
16
  ],
17
17
  "dependencies": {
18
- "@galacean/engine-math": "0.0.0-experimental-0.9-plus.7"
18
+ "@galacean/engine-math": "0.0.0-experimental-ktx2.0"
19
19
  },
20
20
  "devDependencies": {
21
- "@galacean/engine-design": "0.0.0-experimental-0.9-plus.7"
21
+ "@galacean/engine-design": "0.0.0-experimental-ktx2.0"
22
22
  },
23
23
  "scripts": {
24
24
  "b:types": "tsc"
@@ -1,10 +1,10 @@
1
- import { RefObject } from "../../asset/RefObject";
1
+ import { ReferResource } from "../../asset/ReferResource";
2
2
  import { Engine } from "../../Engine";
3
3
  import { Sprite } from "../sprite/Sprite";
4
4
  /**
5
5
  * Sprite Atlas.
6
6
  */
7
- export declare class SpriteAtlas extends RefObject {
7
+ export declare class SpriteAtlas extends ReferResource {
8
8
  private _sprites;
9
9
  private _spriteNamesToIndex;
10
10
  /**
@@ -29,8 +29,4 @@ export declare class SpriteAtlas extends RefObject {
29
29
  * @param engine - Engine to which the SpriteAtlas belongs
30
30
  */
31
31
  constructor(engine: Engine);
32
- /**
33
- * @override
34
- */
35
- _onDestroy(): void;
36
32
  }
@@ -4,6 +4,8 @@
4
4
  export declare enum SpriteDrawMode {
5
5
  /** Overall scaling when modifying size. */
6
6
  Simple = 0,
7
- /** When modifying the size, it is transformed according to the 9-slice settings (border). */
8
- Sliced = 1
7
+ /** When modifying the size of the renderer, it scales to fill the range according to the sprite border settings. */
8
+ Sliced = 1,
9
+ /** When modifying the size of the renderer, it will tile to fill the range according to the sprite border settings. */
10
+ Tiled = 2
9
11
  }
@@ -5,5 +5,6 @@ export { OverflowMode } from "./enums/TextOverflow";
5
5
  export { FontStyle } from "./enums/FontStyle";
6
6
  export { SpriteAtlas } from "./atlas/SpriteAtlas";
7
7
  export { SpriteDrawMode } from "./enums/SpriteDrawMode";
8
+ export { SpriteTileMode } from "./enums/SpriteTileMode";
8
9
  export * from "./sprite/index";
9
10
  export * from "./text/index";
@@ -1,11 +1,11 @@
1
1
  import { Rect, Vector2, Vector4 } from "@galacean/engine-math";
2
- import { RefObject } from "../../asset/RefObject";
3
2
  import { Engine } from "../../Engine";
3
+ import { ReferResource } from "../../asset/ReferResource";
4
4
  import { Texture2D } from "../../texture/Texture2D";
5
5
  /**
6
6
  * 2D sprite.
7
7
  */
8
- export declare class Sprite extends RefObject {
8
+ export declare class Sprite extends ReferResource {
9
9
  /** The name of sprite. */
10
10
  name: string;
11
11
  private _automaticWidth;
@@ -100,4 +100,7 @@ export declare class Sprite extends RefObject {
100
100
  private _updatePositions;
101
101
  private _updateUVs;
102
102
  private _dispatchSpriteChange;
103
+ private _onRegionChange;
104
+ private _onPivotChange;
105
+ private _onBorderChange;
103
106
  }
@@ -1,5 +1,3 @@
1
- import { BoundingBox } from "@galacean/engine-math";
2
- import { RenderContext } from "../../RenderPipeline/RenderContext";
3
1
  import { Renderer } from "../../Renderer";
4
2
  import { Sprite } from "./Sprite";
5
3
  /**
@@ -54,15 +52,6 @@ export declare class SpriteMask extends Renderer {
54
52
  */
55
53
  get alphaCutoff(): number;
56
54
  set alphaCutoff(value: number);
57
- /**
58
- * @override
59
- */
60
- protected _updateBounds(worldBounds: BoundingBox): void;
61
- /**
62
- * @override
63
- * @inheritdoc
64
- */
65
- protected _render(context: RenderContext): void;
66
55
  private _calDefaultSize;
67
56
  private _onSpriteChange;
68
57
  }
@@ -1,8 +1,8 @@
1
- import { BoundingBox, Color } from "@galacean/engine-math";
2
- import { RenderContext } from "../../RenderPipeline/RenderContext";
1
+ import { Color } from "@galacean/engine-math";
3
2
  import { Renderer } from "../../Renderer";
4
3
  import { SpriteDrawMode } from "../enums/SpriteDrawMode";
5
4
  import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
5
+ import { SpriteTileMode } from "../enums/SpriteTileMode";
6
6
  import { Sprite } from "./Sprite";
7
7
  /**
8
8
  * Renders a Sprite for 2D graphics.
@@ -10,6 +10,8 @@ import { Sprite } from "./Sprite";
10
10
  export declare class SpriteRenderer extends Renderer {
11
11
  private _drawMode;
12
12
  private _assembler;
13
+ private _tileMode;
14
+ private _tiledAdaptiveThreshold;
13
15
  private _color;
14
16
  private _sprite;
15
17
  private _automaticWidth;
@@ -24,7 +26,17 @@ export declare class SpriteRenderer extends Renderer {
24
26
  * The draw mode of the sprite renderer.
25
27
  */
26
28
  get drawMode(): SpriteDrawMode;
27
- set drawMode(drawMode: SpriteDrawMode);
29
+ set drawMode(value: SpriteDrawMode);
30
+ /**
31
+ * The tiling mode of the sprite renderer. (Only works in tiled mode.)
32
+ */
33
+ get tileMode(): SpriteTileMode;
34
+ set tileMode(value: SpriteTileMode);
35
+ /**
36
+ * Stretch Threshold in Tile Adaptive Mode, specified in normalized. (Only works in tiled adaptive mode.)
37
+ */
38
+ get tiledAdaptiveThreshold(): number;
39
+ set tiledAdaptiveThreshold(value: number);
28
40
  /**
29
41
  * The Sprite to render.
30
42
  */
@@ -73,14 +85,6 @@ export declare class SpriteRenderer extends Renderer {
73
85
  */
74
86
  get maskInteraction(): SpriteMaskInteraction;
75
87
  set maskInteraction(value: SpriteMaskInteraction);
76
- /**
77
- * @override
78
- */
79
- protected _updateBounds(worldBounds: BoundingBox): void;
80
- /**
81
- * @override
82
- */
83
- protected _render(context: RenderContext): void;
84
88
  private _calDefaultSize;
85
89
  private _updateStencilState;
86
90
  private _onSpriteChange;
@@ -1,10 +1,9 @@
1
- import { RefObject } from "../../asset/RefObject";
1
+ import { ReferResource } from "../../asset/ReferResource";
2
2
  import { Engine } from "../../Engine";
3
3
  /**
4
4
  * Font.
5
5
  */
6
- export declare class Font extends RefObject {
7
- private static _fontMap;
6
+ export declare class Font extends ReferResource {
8
7
  /**
9
8
  * Create a system font.
10
9
  * @param engine - Engine to which the font belongs
@@ -19,8 +18,4 @@ export declare class Font extends RefObject {
19
18
  */
20
19
  get name(): string;
21
20
  constructor(engine: Engine, name?: string);
22
- /**
23
- * @override
24
- */
25
- _onDestroy(): void;
26
21
  }
@@ -1,8 +1,6 @@
1
1
  import { BoundingBox, Color } from "@galacean/engine-math";
2
2
  import { Entity } from "../../Entity";
3
- import { RenderContext } from "../../RenderPipeline/RenderContext";
4
3
  import { Renderer } from "../../Renderer";
5
- import { TransformModifyFlags } from "../../Transform";
6
4
  import { FontStyle } from "../enums/FontStyle";
7
5
  import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
8
6
  import { TextHorizontalAlignment, TextVerticalAlignment } from "../enums/TextAlignment";
@@ -106,17 +104,8 @@ export declare class TextRenderer extends Renderer {
106
104
  */
107
105
  get bounds(): BoundingBox;
108
106
  constructor(entity: Entity);
109
- /**
110
- * @override
111
- */
112
- protected _updateBounds(worldBounds: BoundingBox): void;
113
- /**
114
- * @override
115
- */
116
- protected _render(context: RenderContext): void;
117
107
  private _updateStencilState;
118
108
  private _resetSubFont;
119
109
  private _updatePosition;
120
110
  private _updateLocalData;
121
- protected _onTransformChanged(bit: TransformModifyFlags): void;
122
111
  }
@@ -1,2 +1,3 @@
1
1
  export { Font } from "./Font";
2
2
  export { TextRenderer } from "./TextRenderer";
3
+ export { TextUtils } from "./TextUtils";
package/types/Camera.d.ts CHANGED
@@ -1,19 +1,21 @@
1
- import { Matrix, Ray, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
1
+ import { Matrix, Ray, Rect, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
2
2
  import { Component } from "./Component";
3
- import { CameraClearFlags } from "./enums/CameraClearFlags";
4
3
  import { Layer } from "./Layer";
4
+ import { CameraClearFlags } from "./enums/CameraClearFlags";
5
+ import { DepthTextureMode } from "./enums/DepthTextureMode";
6
+ import { Shader } from "./shader/Shader";
5
7
  import { ShaderData } from "./shader/ShaderData";
6
- import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
8
+ import { ShaderTagKey } from "./shader/ShaderTagKey";
7
9
  import { RenderTarget } from "./texture/RenderTarget";
10
+ import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
8
11
  /**
9
12
  * Camera component, as the entrance to the three-dimensional world.
10
- * @decorator `@dependentComponents(Transform)`
13
+ * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
11
14
  */
12
15
  export declare class Camera extends Component {
13
- /** Shader data. */
14
- readonly shaderData: ShaderData;
15
- /** Rendering priority - A Camera with higher priority will be rendered on top of a camera with lower priority. */
16
- priority: number;
16
+ private static _inverseViewMatrixProperty;
17
+ private static _cameraPositionProperty;
18
+ private static _cameraDepthBufferParamsProperty;
17
19
  /** Whether to enable frustum culling, it is enabled by default. */
18
20
  enableFrustumCulling: boolean;
19
21
  /**
@@ -26,6 +28,13 @@ export declare class Camera extends Component {
26
28
  * @remarks Support bit manipulation, corresponding to `Layer`.
27
29
  */
28
30
  cullingMask: Layer;
31
+ /**
32
+ * Depth texture mode.
33
+ * @defaultValue `DepthTextureMode.None`
34
+ */
35
+ depthTextureMode: DepthTextureMode;
36
+ private _priority;
37
+ private _shaderData;
29
38
  private _isProjMatSetting;
30
39
  private _nearClipPlane;
31
40
  private _farClipPlane;
@@ -36,14 +45,20 @@ export declare class Camera extends Component {
36
45
  private _isFrustumProjectDirty;
37
46
  private _customAspectRatio;
38
47
  private _renderTarget;
48
+ private _depthBufferParams;
39
49
  private _frustumViewChangeFlag;
40
50
  private _transform;
41
51
  private _isViewMatrixDirty;
42
52
  private _isInvViewProjDirty;
43
53
  private _viewport;
54
+ private _pixelViewport;
44
55
  private _inverseProjectionMatrix;
45
56
  private _lastAspectSize;
46
57
  private _invViewProjMat;
58
+ /**
59
+ * Shader data.
60
+ */
61
+ get shaderData(): ShaderData;
47
62
  /**
48
63
  * Near clip plane - the closest point to the camera when rendering occurs.
49
64
  */
@@ -66,11 +81,22 @@ export declare class Camera extends Component {
66
81
  get aspectRatio(): number;
67
82
  set aspectRatio(value: number);
68
83
  /**
69
- * Viewport, normalized expression, the upper left corner is (0, 0), and the lower right corner is (1, 1).
84
+ * The viewport of the camera in normalized coordinates on the screen.
85
+ * In normalized screen coordinates, the upper-left corner is (0, 0), and the lower-right corner is (1.0, 1.0).
70
86
  * @remarks Re-assignment is required after modification to ensure that the modification takes effect.
71
87
  */
72
88
  get viewport(): Vector4;
73
89
  set viewport(value: Vector4);
90
+ /**
91
+ * The viewport of the camera in pixel coordinates on the screen.
92
+ * In pixel screen coordinates, the upper-left corner is (0, 0), and the lower-right corner is (1.0, 1.0).
93
+ */
94
+ get pixelViewport(): Rect;
95
+ /**
96
+ * Rendering priority, higher priority will be rendered on top of a camera with lower priority.
97
+ */
98
+ get priority(): number;
99
+ set priority(value: number);
74
100
  /**
75
101
  * Whether it is orthogonal, the default is false. True will use orthographic projection, false will use perspective projection.
76
102
  */
@@ -178,20 +204,38 @@ export declare class Camera extends Component {
178
204
  */
179
205
  render(cubeFace?: TextureCubeFace, mipLevel?: number): void;
180
206
  /**
181
- * @override
182
- * @inheritdoc
207
+ * Set the replacement shader.
208
+ * @param shader - Replacement shader
209
+ * @param replacementTagName - Sub shader tag name
210
+ *
211
+ * @remarks
212
+ * If replacementTagName is not specified, the first sub shader will be replaced.
213
+ * If replacementTagName is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey.
214
+ */
215
+ setReplacementShader(shader: Shader, replacementTagName?: string): any;
216
+ /**
217
+ * Set the replacement shader.
218
+ * @param shader - Replacement shader
219
+ * @param replacementTag - Sub shader tag
220
+ *
221
+ * @remarks
222
+ * If replacementTag is not specified, the first sub shader will be replaced.
223
+ * If replacementTag is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey.
224
+ */
225
+ setReplacementShader(shader: Shader, replacementTag?: ShaderTagKey): any;
226
+ /**
227
+ * Reset and clear the replacement shader.
183
228
  */
184
- _onEnable(): void;
229
+ resetReplacementShader(): void;
185
230
  /**
186
- * @override
187
231
  * @inheritdoc
188
232
  */
189
- _onDisable(): void;
233
+ _onEnableInScene(): void;
190
234
  /**
191
- * @override
192
235
  * @inheritdoc
193
236
  */
194
- _onDestroy(): void;
237
+ _onDisableInScene(): void;
238
+ private _updatePixelViewport;
195
239
  private _projMatChange;
196
240
  private _innerViewportToWorldPoint;
197
241
  private _updateShaderData;
@@ -6,16 +6,13 @@ import { Scene } from "./Scene";
6
6
  */
7
7
  export declare class Component extends EngineObject {
8
8
  private _phasedActive;
9
+ private _phasedActiveInScene;
9
10
  private _enabled;
10
11
  /**
11
12
  * Indicates whether the component is enabled.
12
13
  */
13
14
  get enabled(): boolean;
14
15
  set enabled(value: boolean);
15
- /**
16
- * Indicates whether the component is destroyed.
17
- */
18
- get destroyed(): boolean;
19
16
  /**
20
17
  * The entity which the component belongs to.
21
18
  */
@@ -25,8 +22,4 @@ export declare class Component extends EngineObject {
25
22
  */
26
23
  get scene(): Scene;
27
24
  constructor(entity: Entity);
28
- /**
29
- * Destroy this instance.
30
- */
31
- destroy(): void;
32
25
  }
@@ -2,16 +2,24 @@ import { Component } from "./Component";
2
2
  import { Entity } from "./Entity";
3
3
  type ComponentConstructor = new (entity: Entity) => Component;
4
4
  /**
5
- * Used for component dependency registration.
5
+ * Declare dependent component.
6
+ * @param component - Dependent component
7
+ * @param dependentMode - Dependent mode
6
8
  */
7
- export declare class ComponentsDependencies {
8
- private static _invDependenciesMap;
9
- private static _addDependency;
10
- private constructor();
11
- }
9
+ export declare function dependentComponents(component: ComponentConstructor, dependentMode?: DependentMode): any;
10
+ /**
11
+ * Declare dependent components.
12
+ * @param components - Dependent components
13
+ * @param dependentMode - Dependent mode
14
+ */
15
+ export declare function dependentComponents(components: ComponentConstructor[], dependentMode?: DependentMode): any;
12
16
  /**
13
- * Dependent components, automatically added if they do not exist.
14
- * @param components - Dependent components
17
+ * Dependent mode.
15
18
  */
16
- export declare function dependentComponents(...components: ComponentConstructor[]): <T extends ComponentConstructor>(target: T) => void;
19
+ export declare enum DependentMode {
20
+ /** Check only, throw error if dependent components do not exist. */
21
+ CheckOnly = 0,
22
+ /** Auto add if dependent components do not exist. */
23
+ AutoAdd = 1
24
+ }
17
25
  export {};
@@ -7,11 +7,12 @@ export declare class DisorderedArray<T> {
7
7
  constructor(count?: number);
8
8
  add(element: T): void;
9
9
  delete(element: T): void;
10
+ set(index: number, element: T): void;
10
11
  get(index: number): T;
11
12
  /**
12
- *
13
- * @param index
14
- * @returns The replaced item is used to reset its index.
13
+ * Delete the element at the specified index.
14
+ * @param index - The index of the element to be deleted
15
+ * @returns The replaced item is used to reset its index
15
16
  */
16
17
  deleteByIndex(index: number): T;
17
18
  garbageCollection(): void;
package/types/Engine.d.ts CHANGED
@@ -1,44 +1,20 @@
1
- import { Font } from "./2d/text/Font";
2
- import { ResourceManager } from "./asset/ResourceManager";
3
- import { EventDispatcher, Time } from "./base";
1
+ import { IPhysics, IShaderLab } from "@galacean/engine-design";
4
2
  import { Canvas } from "./Canvas";
5
- import { ComponentsManager } from "./ComponentsManager";
6
3
  import { EngineSettings } from "./EngineSettings";
7
4
  import { Entity } from "./Entity";
5
+ import { SceneManager } from "./SceneManager";
6
+ import { ResourceManager } from "./asset/ResourceManager";
7
+ import { EventDispatcher, Time } from "./base";
8
+ import { ColorSpace } from "./enums/ColorSpace";
8
9
  import { InputManager } from "./input";
9
- import { LightManager } from "./lighting/LightManager";
10
- import { Material } from "./material/Material";
11
- import { PhysicsManager } from "./physics";
10
+ import { PhysicsScene } from "./physics/PhysicsScene";
12
11
  import { IHardwareRenderer } from "./renderingHardwareInterface";
13
- import { ClassPool } from "./RenderPipeline/ClassPool";
14
- import { MeshRenderElement } from "./RenderPipeline/MeshRenderElement";
15
- import { RenderContext } from "./RenderPipeline/RenderContext";
16
- import { SpriteElement } from "./RenderPipeline/SpriteElement";
17
- import { SpriteMaskElement } from "./RenderPipeline/SpriteMaskElement";
18
- import { TextRenderElement } from "./RenderPipeline/TextRenderElement";
19
- import { Scene } from "./Scene";
20
- import { SceneManager } from "./SceneManager";
21
- import { RenderState } from "./shader/state/RenderState";
22
12
  /**
23
13
  * Engine.
24
14
  */
25
15
  export declare class Engine extends EventDispatcher {
26
- /** Physics manager of Engine. */
27
- readonly physicsManager: PhysicsManager;
16
+ /** Input manager of Engine. */
28
17
  readonly inputManager: InputManager;
29
- _lightManager: LightManager;
30
- _componentsManager: ComponentsManager;
31
- _hardwareRenderer: IHardwareRenderer;
32
- _lastRenderState: RenderState;
33
- _renderElementPool: ClassPool<MeshRenderElement>;
34
- _spriteElementPool: ClassPool<SpriteElement>;
35
- _spriteMaskElementPool: ClassPool<SpriteMaskElement>;
36
- _textElementPool: ClassPool<TextRenderElement>;
37
- _spriteDefaultMaterial: Material;
38
- _spriteMaskDefaultMaterial: Material;
39
- _textDefaultFont: Font;
40
- _renderContext: RenderContext;
41
- protected _canvas: Canvas;
42
18
  private _settings;
43
19
  private _resourceManager;
44
20
  private _sceneManager;
@@ -52,7 +28,9 @@ export declare class Engine extends EventDispatcher {
52
28
  private _targetFrameInterval;
53
29
  private _destroyed;
54
30
  private _frameInProcess;
55
- private _waittingDestroy;
31
+ private _waitingDestroy;
32
+ private _isDeviceLost;
33
+ private _waitingGC;
56
34
  private _animate;
57
35
  /**
58
36
  * Settings of Engine.
@@ -63,15 +41,15 @@ export declare class Engine extends EventDispatcher {
63
41
  */
64
42
  get canvas(): Canvas;
65
43
  /**
66
- * Get the resource manager.
44
+ * The resource manager.
67
45
  */
68
46
  get resourceManager(): ResourceManager;
69
47
  /**
70
- * Get the scene manager.
48
+ * The scene manager.
71
49
  */
72
50
  get sceneManager(): SceneManager;
73
51
  /**
74
- * Get the Time class.
52
+ * The time information of the engine.
75
53
  */
76
54
  get time(): Time;
77
55
  /**
@@ -96,13 +74,7 @@ export declare class Engine extends EventDispatcher {
96
74
  * Indicates whether the engine is destroyed.
97
75
  */
98
76
  get destroyed(): boolean;
99
- /**
100
- * Create engine.
101
- * @param canvas - The canvas to use for rendering
102
- * @param hardwareRenderer - Graphics API renderer
103
- * @param settings - Engine Settings
104
- */
105
- constructor(canvas: Canvas, hardwareRenderer: IHardwareRenderer, settings?: EngineSettings);
77
+ protected constructor(canvas: Canvas, hardwareRenderer: IHardwareRenderer, configuration: EngineConfiguration);
106
78
  /**
107
79
  * Create an entity.
108
80
  * @param name - The name of the entity
@@ -125,16 +97,41 @@ export declare class Engine extends EventDispatcher {
125
97
  * Execution engine loop.
126
98
  */
127
99
  run(): void;
100
+ /**
101
+ * Force lose graphic device.
102
+ * @remarks Used to simulate the phenomenon after the real loss of device.
103
+ */
104
+ forceLoseDevice(): void;
105
+ /**
106
+ * Force restore graphic device.
107
+ * @remarks Used to simulate the phenomenon after the real restore of device.
108
+ */
109
+ forceRestoreDevice(): void;
128
110
  private _destroy;
129
111
  /**
130
112
  * Destroy engine.
131
113
  * @remarks If call during frame execution will delay until the end of the frame
132
114
  */
133
115
  destroy(): void;
134
- /**
135
- * @intenral
136
- */
137
- _render(scene: Scene): void;
138
116
  private _createSpriteMaterial;
139
117
  private _createSpriteMaskMaterial;
118
+ private _onDeviceLost;
119
+ private _onDeviceRestored;
120
+ private _gc;
121
+ /**
122
+ * @deprecated
123
+ * The first scene physics manager.
124
+ */
125
+ get physicsManager(): PhysicsScene;
126
+ }
127
+ /**
128
+ * Engine configuration.
129
+ */
130
+ export interface EngineConfiguration {
131
+ /** Physics. */
132
+ physics?: IPhysics;
133
+ /** Color space. */
134
+ colorSpace?: ColorSpace;
135
+ /** Shader lab */
136
+ shaderLab?: IShaderLab;
140
137
  }
package/types/Entity.d.ts CHANGED
@@ -1,10 +1,10 @@
1
1
  import { Matrix } from "@galacean/engine-math";
2
- import { EngineObject } from "./base";
3
2
  import { Component } from "./Component";
4
3
  import { Engine } from "./Engine";
5
4
  import { Layer } from "./Layer";
6
5
  import { Scene } from "./Scene";
7
6
  import { Transform } from "./Transform";
7
+ import { EngineObject } from "./base";
8
8
  /**
9
9
  * Entity, be used as components container.
10
10
  */
@@ -65,7 +65,7 @@ export declare class Entity extends EngineObject {
65
65
  * @param type - The type of the component
66
66
  * @returns The first component which match type
67
67
  */
68
- getComponent<T extends Component>(type: new (entity: Entity) => T): T;
68
+ getComponent<T extends Component>(type: new (entity: Entity) => T): T | null;
69
69
  /**
70
70
  * Get components which match the type.
71
71
  * @param type - The type of the component
@@ -130,6 +130,8 @@ export declare class Entity extends EngineObject {
130
130
  * @returns Cloned entity
131
131
  */
132
132
  clone(): Entity;
133
+ private _createCloneEntity;
134
+ private _parseCloneEntity;
133
135
  /**
134
136
  * Destroy self.
135
137
  */
@@ -1,19 +1,18 @@
1
1
  import { Camera } from "../Camera";
2
2
  import { Engine } from "../Engine";
3
- import { Material } from "../material";
4
- import { SpriteElement } from "./SpriteElement";
5
- import { SpriteMaskElement } from "./SpriteMaskElement";
6
- import { TextRenderElement } from "./TextRenderElement";
3
+ import { ShaderTagKey } from "../shader/ShaderTagKey";
4
+ import { RenderElement } from "./RenderElement";
7
5
  export declare abstract class Basic2DBatcher {
6
+ protected static _disableBatchTag: ShaderTagKey;
8
7
  /** The maximum number of vertex. */
9
8
  static MAX_VERTEX_COUNT: number;
10
9
  static _canUploadSameBuffer: boolean;
11
10
  constructor(engine: Engine);
12
- drawElement(element: SpriteMaskElement | SpriteElement | TextRenderElement, camera: Camera, replaceMaterial: Material): void;
13
- private _drawSubElement;
14
- flush(camera: Camera, replaceMaterial: Material): void;
11
+ drawElement(element: RenderElement, camera: Camera): void;
12
+ flush(camera: Camera): void;
15
13
  clear(): void;
16
14
  destroy(): void;
15
+ private _drawSubElement;
17
16
  private _createMesh;
18
17
  private _updateData;
19
18
  private _getSubMeshFromPool;
@@ -3,19 +3,18 @@ import { Layer } from "../Layer";
3
3
  import { Material } from "../material";
4
4
  import { RenderTarget, TextureCubeFace } from "../texture";
5
5
  import { RenderContext } from "./RenderContext";
6
- import { RenderElement } from "./RenderElement";
6
+ import { RenderData } from "./RenderData";
7
7
  import { RenderPass } from "./RenderPass";
8
8
  /**
9
9
  * Basic render pipeline.
10
10
  */
11
11
  export declare class BasicRenderPipeline {
12
- private static _tempVector0;
13
- private static _tempVector1;
14
12
  private _camera;
15
13
  private _defaultPass;
16
14
  private _renderPassArray;
17
15
  private _lastCanvasSize;
18
16
  private _cascadedShadowCaster;
17
+ private _depthOnlyPass;
19
18
  /**
20
19
  * Create a basic render pipeline.
21
20
  * @param camera - Camera
@@ -57,10 +56,12 @@ export declare class BasicRenderPipeline {
57
56
  render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number): void;
58
57
  private _drawRenderPass;
59
58
  /**
60
- * Push a render element to the render queue.
61
- * @param element - Render element
59
+ * Push render data to render queue.
60
+ * @param context - Render context
61
+ * @param data - Render data
62
62
  */
63
- pushPrimitive(element: RenderElement): void;
63
+ pushRenderData(context: RenderContext, data: RenderData): void;
64
+ private pushRenderDataWihShader;
64
65
  private _drawBackgroundTexture;
65
66
  private _callRender;
66
67
  }