@galacean/engine-core 1.5.0-alpha.0 → 1.5.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.5.0-alpha.0",
+  "version": "1.5.0-alpha.2",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -18,10 +18,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.5.0-alpha.0"
+    "@galacean/engine-math": "1.5.0-alpha.2"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.5.0-alpha.0"
+    "@galacean/engine-design": "1.5.0-alpha.2"
   },
   "scripts": {
     "b:types": "tsc"

package/types/Background.d.ts

@@ -24,7 +24,7 @@ export declare class Background {
     private _texture;
     /**
      * Background solid color.
-     * @defaultValue `new Color(0.25, 0.25, 0.25, 1.0)`
+     * @defaultValue `new Color(0.05, 0.05, 0.05, 1.0)`
      * @remarks When `mode` is `BackgroundMode.SolidColor`, the property will take effects.
      */
     get solidColor(): Color;

package/types/Camera.d.ts

@@ -53,16 +53,23 @@ export declare class Camera extends Component {
      */
     opaqueTextureDownsampling: Downsampling;
     /**
-     * Multi-sample anti-aliasing samples when use independent canvas mode.
+     * The screen-space anti-aliasing mode applied after the camera renders the final image.
+     * Unlike MSAA, it can smooth all pixels, including by shader-generated specular, alpha-cutoff edge, low resolution texture.
      *
-     * @remarks It will take effect when `independentCanvasEnabled` property is `true`, otherwise it will be invalid.
-     */
-    msaaSamples: MSAASamples;
-    /**
-     * Anti-aliasing mode.
      * @defaultValue `AntiAliasing.None`
      */
     antiAliasing: AntiAliasing;
+    /**
+     * Determines whether to preserve the alpha channel in the output.
+     * When set to true, the alpha channel is always preserved.
+     * When set to false, the engine automatically decides whether to preserve it.
+     *
+     * @remarks
+     * Set to true if you need to ensure the alpha channel is preserved, for example, when performing canvas transparent blending.
+     *
+     * @defaultValue `false`
+     */
+    isAlphaOutputRequired: boolean;
     private _priority;
     private _shaderData;
     private _isCustomViewMatrix;
@@ -77,6 +84,7 @@ export declare class Camera extends Component {
     private _opaqueTextureEnabled;
     private _enableHDR;
     private _enablePostProcess;
+    private _msaaSamples;
     private _updateFlagManager;
     private _frustumChangeFlag;
     private _isViewMatrixDirty;
@@ -90,15 +98,9 @@ export declare class Camera extends Component {
      * If enabled, the opaque texture can be accessed in the shader using `camera_OpaqueTexture`.
      *
      * @defaultValue `false`
-     * @remarks If enabled, the `independentCanvasEnabled` property will be forced to be true.
      */
     get opaqueTextureEnabled(): boolean;
     set opaqueTextureEnabled(value: boolean);
-    /**
-     * Whether independent canvas is enabled.
-     * @remarks If true, the msaa in viewport can turn or off independently by `msaaSamples` property.
-     */
-    get independentCanvasEnabled(): boolean;
     /**
      * Shader data.
      */
@@ -165,14 +167,12 @@ export declare class Camera extends Component {
     /**
      * Whether to enable HDR.
      * @defaultValue `false`
-     * @remarks If enabled, the `independentCanvasEnabled` property will be forced to be true.
      */
     get enableHDR(): boolean;
     set enableHDR(value: boolean);
     /**
      * Whether to enable post process.
      * @defaultValue `false`
-     * @remarks If enabled, the `independentCanvasEnabled` property will be forced to be true.
      */
     get enablePostProcess(): boolean;
     set enablePostProcess(value: boolean);
@@ -181,6 +181,14 @@ export declare class Camera extends Component {
      */
     get renderTarget(): RenderTarget | null;
     set renderTarget(value: RenderTarget | null);
+    /**
+     * The number of samples used for hardware multisample anti-aliasing (MSAA) to smooth geometry edges during rasterization.
+     * Higher sample counts (e.g., 2x, 4x, 8x) produce smoother edges.
+     *
+     * @defaultValue `MSAASamples.FourX`
+     */
+    get msaaSamples(): MSAASamples;
+    set msaaSamples(value: MSAASamples);
     /**
      * Restore the view matrix to the world matrix of the entity.
      */
@@ -308,6 +316,5 @@ export declare class Camera extends Component {
      */
     private _getInverseProjectionMatrix;
     private _onPixelViewportChanged;
-    private _checkMainCanvasAntialiasWaste;
     private _dispatchModify;
 }

package/types/lighting/AmbientLight.d.ts

@@ -1,8 +1,8 @@
 import { Color, SphericalHarmonics3 } from "@galacean/engine-math";
-import { TextureCube } from "../texture";
-import { DiffuseMode } from "./enums/DiffuseMode";
 import { ReferResource } from "../asset/ReferResource";
 import { Engine } from "../Engine";
+import { TextureCube } from "../texture";
+import { DiffuseMode } from "./enums/DiffuseMode";
 /**
  * Ambient light.
  */

package/types/lighting/Light.d.ts

@@ -6,8 +6,6 @@ import { ShadowType } from "../shadow";
  * Light base class.
  */
 export declare abstract class Light extends Component {
-    /** Light Intensity */
-    intensity: number;
     /**
      * Culling mask - which layers the light affect.
      * @remarks Support bit manipulation, corresponding to `Layer`.

package/types/particle/ParticleMaterial.d.ts

@@ -16,6 +16,16 @@ export declare class ParticleMaterial extends BaseMaterial {
      */
     get baseTexture(): Texture2D;
     set baseTexture(value: Texture2D);
+    /**
+     * Emissive color.
+     */
+    get emissiveColor(): Color;
+    set emissiveColor(value: Color);
+    /**
+     * Emissive texture.
+     */
+    get emissiveTexture(): Texture2D;
+    set emissiveTexture(value: Texture2D);
     /**
      * Create a unlit material instance.
      * @param engine - Engine to which the material belongs

package/types/physics/Collider.d.ts

@@ -1,7 +1,8 @@
 import { BoolUpdateFlag } from "../BoolUpdateFlag";
+import { ICustomClone } from "../clone/ComponentCloner";
 import { Component } from "../Component";
+import { Layer } from "../Layer";
 import { ColliderShape } from "./shape/ColliderShape";
-import { ICustomClone } from "../clone/ComponentCloner";
 /**
  * Base class for all colliders.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
@@ -9,10 +10,18 @@ import { ICustomClone } from "../clone/ComponentCloner";
 export declare class Collider extends Component implements ICustomClone {
     protected _updateFlag: BoolUpdateFlag;
     protected _shapes: ColliderShape[];
+    protected _collisionLayerIndex: number;
     /**
      * The shapes of this collider.
      */
     get shapes(): Readonly<ColliderShape[]>;
+    /**
+     * The collision layer of this collider, only support single layer.
+     *
+     * @defaultValue `Layer.Layer0`
+     */
+    get collisionLayer(): Layer;
+    set collisionLayer(value: Layer);
     /**
      * Add collider shape on this collider.
      * @param shape - Collider shape
@@ -30,4 +39,5 @@ export declare class Collider extends Component implements ICustomClone {
     protected _syncNative(): void;
     protected _addNativeShape(shape: ColliderShape): void;
     protected _removeNativeShape(shape: ColliderShape): void;
+    private _setCollisionLayer;
 }

package/types/physics/PhysicsScene.d.ts

@@ -30,6 +30,20 @@ export declare class PhysicsScene {
     get fixedTimeStep(): number;
     set fixedTimeStep(value: number);
     constructor(scene: Scene);
+    /**
+     * Get whether two colliders can collide with each other.
+     * @param layer1 - The first collision layer
+     * @param layer2 - The second collision layer
+     * @returns Whether the colliders should collide
+     */
+    getColliderLayerCollision(layer1: Layer, layer2: Layer): boolean;
+    /**
+     * Set whether two colliders can collide with each other.
+     * @param layer1 - The first collision layer
+     * @param layer2 - The second collision layer
+     * @param isCollide - Whether the colliders should collide
+     */
+    setColliderLayerCollision(layer1: Layer, layer2: Layer, isCollide: boolean): void;
     /**
      * Casts a ray through the Scene and returns the first hit.
      * @param ray - The ray

package/types/physics/enums/ColliderShapeChangeFlag.d.ts

@@ -0,0 +1 @@
+export {};

package/types/physics/shape/ColliderShape.d.ts

@@ -23,6 +23,7 @@ export declare abstract class ColliderShape implements ICustomClone {
     get id(): number;
     /**
      * Contact offset for this shape, the value must be greater than or equal to 0.
+     * @defaultValue 0.02
      */
     get contactOffset(): number;
     set contactOffset(value: number);

package/types/postProcess/effects/BloomEffect.d.ts

@@ -26,7 +26,7 @@ export declare class BloomEffect extends PostProcessEffect {
     dirtTexture: PostProcessEffectTextureParameter;
     /**
      * Set the level of brightness to filter out pixels under this level.
-     * @remarks This value is expressed in gamma-space.
+     * @remarks This value is expressed in linear.
      */
     threshold: PostProcessEffectFloatParameter;
     /**