@galacean/engine-core 2.0.0-alpha.49 → 2.0.0-alpha.50

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 (90) hide show
  1. package/dist/main.js +89 -74
  2. package/dist/main.js.map +1 -1
  3. package/dist/module.js +89 -74
  4. package/dist/module.js.map +1 -1
  5. package/package.json +3 -3
  6. package/types/2d/assembler/ISpriteRenderer.d.ts +2 -2
  7. package/types/2d/sprite/Sprite.d.ts +3 -3
  8. package/types/2d/sprite/SpriteMask.d.ts +1 -1
  9. package/types/2d/sprite/SpriteRenderer.d.ts +1 -1
  10. package/types/2d/text/CharInfo.d.ts +1 -1
  11. package/types/2d/text/Font.d.ts +1 -1
  12. package/types/2d/text/SubFont.d.ts +2 -2
  13. package/types/2d/text/TextRenderer.d.ts +2 -2
  14. package/types/Background.d.ts +2 -2
  15. package/types/Camera.d.ts +3 -3
  16. package/types/Component.d.ts +2 -2
  17. package/types/Engine.d.ts +1 -1
  18. package/types/Entity.d.ts +19 -19
  19. package/types/RenderPipeline/Blitter.d.ts +1 -1
  20. package/types/RenderPipeline/DepthOnlyPass.d.ts +1 -1
  21. package/types/RenderPipeline/PipelineUtils.d.ts +1 -1
  22. package/types/RenderPipeline/PrimitiveChunkManager.d.ts +1 -1
  23. package/types/RenderPipeline/RenderContext.d.ts +5 -5
  24. package/types/RenderPipeline/VertexArea.d.ts +2 -2
  25. package/types/Renderer.d.ts +8 -8
  26. package/types/Scene.d.ts +7 -8
  27. package/types/SceneManager.d.ts +5 -6
  28. package/types/Utils.d.ts +1 -1
  29. package/types/animation/AnimationClipCurveBinding.d.ts +1 -1
  30. package/types/animation/AnimationEvent.d.ts +2 -2
  31. package/types/animation/Animator.d.ts +1 -1
  32. package/types/animation/AnimatorController.d.ts +2 -2
  33. package/types/animation/AnimatorControllerParameter.d.ts +1 -1
  34. package/types/animation/AnimatorState.d.ts +3 -3
  35. package/types/animation/AnimatorStateInstance.d.ts +1 -1
  36. package/types/animation/AnimatorStateTransition.d.ts +1 -1
  37. package/types/animation/Keyframe.d.ts +1 -1
  38. package/types/animation/animationCurve/AnimationCurve.d.ts +2 -2
  39. package/types/animation/animationCurve/AnimationRefCurve.d.ts +4 -4
  40. package/types/animation/internal/AnimatorLayerData.d.ts +1 -1
  41. package/types/animation/internal/animationCurveOwner/AnimationCurveOwner.d.ts +4 -4
  42. package/types/asset/AssetPromise.d.ts +4 -4
  43. package/types/asset/JSONAsset.d.ts +1 -1
  44. package/types/asset/Loader.d.ts +2 -2
  45. package/types/asset/ResourceManager.d.ts +1 -1
  46. package/types/audio/AudioClip.d.ts +1 -1
  47. package/types/audio/AudioSource.d.ts +2 -2
  48. package/types/env-probe/Probe.d.ts +1 -1
  49. package/types/graphic/Buffer.d.ts +2 -2
  50. package/types/graphic/Mesh.d.ts +2 -2
  51. package/types/graphic/Primitive.d.ts +5 -5
  52. package/types/input/keyboard/KeyboardManager.d.ts +1 -1
  53. package/types/input/pointer/emitter/IHitResult.d.ts +1 -1
  54. package/types/input/pointer/emitter/PhysicsPointerEventEmitter.d.ts +3 -3
  55. package/types/lighting/KHR_lights.d.ts +13 -1
  56. package/types/mesh/BlendShape.d.ts +1 -1
  57. package/types/mesh/BlendShapeFrame.d.ts +4 -4
  58. package/types/mesh/BlendShapeManager.d.ts +1 -1
  59. package/types/mesh/BufferMesh.d.ts +2 -2
  60. package/types/mesh/ModelMesh.d.ts +4 -4
  61. package/types/mesh/PrimitiveMesh.d.ts +1 -1
  62. package/types/mesh/SkinnedMeshRenderer.d.ts +1 -1
  63. package/types/particle/ParticleGenerator.d.ts +1 -1
  64. package/types/particle/modules/ParticleCompositeCurve.d.ts +2 -2
  65. package/types/particle/modules/ParticleCompositeGradient.d.ts +1 -1
  66. package/types/particle/modules/ParticleGeneratorModule.d.ts +1 -1
  67. package/types/particle/modules/ParticleGradient.d.ts +4 -4
  68. package/types/particle/modules/SubEmitter.d.ts +2 -2
  69. package/types/particle/modules/shape/MeshShape.d.ts +2 -2
  70. package/types/particle/modules/shape/ShapeUtils.d.ts +1 -1
  71. package/types/physics/HitResult.d.ts +2 -2
  72. package/types/physics/joint/Joint.d.ts +3 -3
  73. package/types/physics/shape/ColliderShape.d.ts +3 -3
  74. package/types/physics/shape/MeshColliderShape.d.ts +2 -2
  75. package/types/postProcess/PostProcess.d.ts +6 -6
  76. package/types/postProcess/PostProcessEffectParameter.d.ts +2 -2
  77. package/types/postProcess/PostProcessManager.d.ts +1 -1
  78. package/types/postProcess/PostProcessPass.d.ts +2 -2
  79. package/types/shader/Shader.d.ts +8 -8
  80. package/types/shader/ShaderData.d.ts +3 -3
  81. package/types/shader/ShaderMacro.d.ts +2 -2
  82. package/types/shader/state/BlendState.d.ts +1 -1
  83. package/types/shader/state/DepthState.d.ts +1 -1
  84. package/types/shader/state/RasterState.d.ts +1 -1
  85. package/types/shader/state/RenderState.d.ts +1 -1
  86. package/types/shader/state/StencilState.d.ts +1 -1
  87. package/types/sky/Sky.d.ts +4 -4
  88. package/types/texture/RenderTarget.d.ts +3 -3
  89. package/types/utils/DisorderedArray.d.ts +1 -1
  90. package/types/xr/XRManager.d.ts +2 -2
@@ -32,28 +32,28 @@ export declare class Shader implements IReferable {
32
32
  * ```
33
33
  *
34
34
  * @param shaderSource - Shader code
35
- * @param platformTarget - Shader platform target, @defaultValue ShaderLanguage.GLSLES300
35
+ * @param platformTarget - Shader platform target, @defaultValue ShaderLanguage.GLSLES100
36
36
  * @param path - Shader location path, used to resolve relative `#include` paths in ShaderLab source
37
- * @returns Shader
37
+ * @returns The shader, or `undefined` if its name already exists.
38
38
  *
39
39
  * @throws
40
40
  * Throw string exception if the shader compiler has not been enabled properly.
41
41
  */
42
- static create(shaderSource: string, platformTarget?: ShaderLanguage, path?: string): Shader;
42
+ static create(shaderSource: string, platformTarget?: ShaderLanguage, path?: string): Shader | undefined;
43
43
  /**
44
44
  * Create a shader.
45
45
  * @param name - Name of the shader
46
46
  * @param shaderPasses - Shader passes
47
- * @returns Shader
47
+ * @returns The shader, or `undefined` if its name already exists.
48
48
  */
49
- static create(name: string, shaderPasses: ShaderPass[]): Shader;
49
+ static create(name: string, shaderPasses: ShaderPass[]): Shader | undefined;
50
50
  /**
51
51
  * Create a shader.
52
52
  * @param name - Name of the shader
53
53
  * @param subShaders - Sub shaders
54
- * @returns Shader
54
+ * @returns The shader, or `undefined` if its name already exists.
55
55
  */
56
- static create(name: string, subShaders: SubShader[]): Shader;
56
+ static create(name: string, subShaders: SubShader[]): Shader | undefined;
57
57
  /**
58
58
  * Find a shader by name.
59
59
  * @param name - Name of the shader
@@ -62,7 +62,7 @@ export declare class Shader implements IReferable {
62
62
  /**
63
63
  * @internal
64
64
  */
65
- static _createFromPrecompiled(data: IPrecompiledShader): Shader;
65
+ static _createFromPrecompiled(data: IPrecompiledShader): Shader | undefined;
66
66
  /**
67
67
  * @internal
68
68
  */
@@ -277,13 +277,13 @@ export declare class ShaderData extends DataObject implements IReferable, IClone
277
277
  * @param propertyName - Shader property name
278
278
  * @param value - Texture
279
279
  */
280
- setTexture(propertyName: string, value: Texture): void;
280
+ setTexture(propertyName: string, value: Texture | null): void;
281
281
  /**
282
282
  * Set texture by shader property.
283
283
  * @param property - Shader property, use `ShaderProperty.getByName` to get
284
284
  * @param value - Texture
285
285
  */
286
- setTexture(property: ShaderProperty, value: Texture): void;
286
+ setTexture(property: ShaderProperty, value: Texture | null): void;
287
287
  /**
288
288
  * Get texture array by shader property name.
289
289
  * @param propertyName - Shader property name
@@ -386,4 +386,4 @@ export declare class ShaderData extends DataObject implements IReferable, IClone
386
386
  private _addTexturesReferCount;
387
387
  private _updateRendererBatchSharedFields;
388
388
  }
389
- export type ShaderPropertyValueType = number | Vector2 | Vector3 | Vector4 | Color | Matrix | Texture | Texture[] | Int32Array | Float32Array;
389
+ export type ShaderPropertyValueType = null | number | Vector2 | Vector3 | Vector4 | Color | Matrix | Texture | Texture[] | Int32Array | Float32Array;
@@ -22,7 +22,7 @@ export declare class ShaderMacro {
22
22
  * @param value - Value of the shader macro
23
23
  * @returns Shader macro
24
24
  */
25
- static getByName(name: string, value: string): ShaderMacro;
25
+ static getByName(name: string, value: string | undefined): ShaderMacro;
26
26
  /**
27
27
  * @internal
28
28
  */
@@ -30,7 +30,7 @@ export declare class ShaderMacro {
30
30
  /** Name. */
31
31
  readonly name: string;
32
32
  /** Value. */
33
- readonly value: string;
33
+ readonly value: string | undefined;
34
34
  /** @internal */
35
35
  _nameId: number;
36
36
  /** @internal */
@@ -26,6 +26,6 @@ export declare class BlendState extends DataObject {
26
26
  * @internal
27
27
  * Apply the current blend state by comparing with the last blend state.
28
28
  */
29
- _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap): void;
29
+ _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap | null): void;
30
30
  private _platformApply;
31
31
  }
@@ -24,6 +24,6 @@ export declare class DepthState extends DataObject {
24
24
  * @internal
25
25
  * Apply the current depth state by comparing with the last depth state.
26
26
  */
27
- _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap): void;
27
+ _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap | null): void;
28
28
  private _platformApply;
29
29
  }
@@ -26,6 +26,6 @@ export declare class RasterState extends DataObject {
26
26
  /**
27
27
  * @internal
28
28
  */
29
- _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, frontFaceInvert: boolean, customStates?: RenderStateElementMap): void;
29
+ _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, frontFaceInvert: boolean, customStates?: RenderStateElementMap | null): void;
30
30
  private _platformApply;
31
31
  }
@@ -24,7 +24,7 @@ export declare class RenderState extends DataObject {
24
24
  /**
25
25
  * @internal
26
26
  */
27
- _applyStates(engine: Engine, frontFaceInvert: boolean, renderStateDataMap: Record<number, ShaderProperty>, shaderData: ShaderData, customRenderStates?: RenderStateElementMap): void;
27
+ _applyStates(engine: Engine, frontFaceInvert: boolean, renderStateDataMap: Record<number, ShaderProperty>, shaderData: ShaderData, customRenderStates?: RenderStateElementMap | null): void;
28
28
  /**
29
29
  * @internal
30
30
  */
@@ -43,6 +43,6 @@ export declare class StencilState extends DataObject {
43
43
  /**
44
44
  * @internal
45
45
  */
46
- _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap): void;
46
+ _apply(hardwareRenderer: IHardwareRenderer, lastRenderState: RenderState, customStates?: RenderStateElementMap | null): void;
47
47
  private _platformApply;
48
48
  }
@@ -13,13 +13,13 @@ export declare class Sky {
13
13
  /**
14
14
  * Material of the sky.
15
15
  */
16
- get material(): Material;
17
- set material(value: Material);
16
+ get material(): Material | null;
17
+ set material(value: Material | null);
18
18
  /**
19
19
  * Mesh of the sky.
20
20
  */
21
- get mesh(): Mesh;
22
- set mesh(value: Mesh);
21
+ get mesh(): Mesh | null;
22
+ set mesh(value: Mesh | null);
23
23
  /**
24
24
  * @internal
25
25
  */
@@ -61,7 +61,7 @@ export declare class RenderTarget extends GraphicsResource {
61
61
  * @param depthFormat - Depth format. default TextureFormat.Depth, engine will automatically select the supported precision
62
62
  * @param antiAliasing - Anti-aliasing level, default is 1
63
63
  */
64
- constructor(engine: Engine, width: number, height: number, colorTexture: Texture, depthFormat?: TextureFormat | null | RenderBufferDepthFormat, antiAliasing?: number);
64
+ constructor(engine: Engine, width: number, height: number, colorTexture: Texture | null, depthFormat?: TextureFormat | null | RenderBufferDepthFormat, antiAliasing?: number);
65
65
  /**
66
66
  * Create a render target through color texture and depth format.
67
67
  * @remarks If the color texture is not transmitted, only the depth texture is generated.
@@ -72,7 +72,7 @@ export declare class RenderTarget extends GraphicsResource {
72
72
  * @param depthTexture - Render depth texture
73
73
  * @param antiAliasing - Anti-aliasing level, default is 1
74
74
  */
75
- constructor(engine: Engine, width: number, height: number, colorTexture: Texture | null, depthTexture: Texture, antiAliasing?: number);
75
+ constructor(engine: Engine, width: number, height: number, colorTexture: Texture | null, depthTexture: Texture | null, antiAliasing?: number);
76
76
  /**
77
77
  * Create a render target with color texture array and depth format.
78
78
  * @param engine - Define the engine to use for this off-screen rendering
@@ -92,7 +92,7 @@ export declare class RenderTarget extends GraphicsResource {
92
92
  * @param depthTexture - Depth texture
93
93
  * @param antiAliasing - Anti-aliasing level, default is 1
94
94
  */
95
- constructor(engine: Engine, width: number, height: number, colorTextures: Texture[], depthTexture: Texture, antiAliasing?: number);
95
+ constructor(engine: Engine, width: number, height: number, colorTextures: Texture[], depthTexture: Texture | null, antiAliasing?: number);
96
96
  /**
97
97
  * Get the render color texture by index.
98
98
  * @param index - Render color texture index
@@ -44,7 +44,7 @@ export declare class DisorderedArray<T> {
44
44
  * @param index - The index of the element to be deleted
45
45
  * @returns The replaced item is used to reset its index
46
46
  */
47
- deleteByIndex(index: number): T;
47
+ deleteByIndex(index: number): T | undefined;
48
48
  /**
49
49
  * Loop through all elements.
50
50
  * @param callbackFn - The callback function
@@ -21,11 +21,11 @@ export declare class XRManager {
21
21
  /**
22
22
  * @internal
23
23
  */
24
- _getRequestAnimationFrame(): (callback: FrameRequestCallback) => number;
24
+ _getRequestAnimationFrame(): ((callback: FrameRequestCallback) => number) | null;
25
25
  /**
26
26
  * @internal
27
27
  */
28
- _getCancelAnimationFrame(): (id: number) => void;
28
+ _getCancelAnimationFrame(): ((id: number) => void) | null;
29
29
  /**
30
30
  * @internal
31
31
  */