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

package/package.json

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

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -12,6 +12,7 @@ export declare class BasicRenderPipeline {
     private _internalColorTarget;
     private _cascadedShadowCasterPass;
     private _depthOnlyPass;
+    private _saoPass;
     private _opaqueTexturePass;
     private _finalPass;
     private _copyBackgroundTexture;

package/types/Scene.d.ts

@@ -4,7 +4,7 @@ import { Engine } from "./Engine";
 import { Entity } from "./Entity";
 import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
-import { DirectLight } from "./lighting";
+import { AmbientOcclusion, DirectLight } from "./lighting";
 import { AmbientLight } from "./lighting/AmbientLight";
 import { PhysicsScene } from "./physics/PhysicsScene";
 import { PostProcessManager } from "./postProcess";
@@ -39,6 +39,13 @@ export declare class Scene extends EngineObject {
     shadowFadeBorder: number;
     /** Post process manager. */
     readonly postProcessManager: PostProcessManager;
+    /**
+     * Ambient Occlusion settings.
+     * @remarks
+     * Darkens areas where objects are close together to simulate natural light blocking,
+     * such as corners, crevices, and contact points between surfaces.
+     */
+    readonly ambientOcclusion: AmbientOcclusion;
     private _background;
     private _shaderData;
     private _shadowCascades;

package/types/Transform.d.ts

@@ -192,8 +192,8 @@ export declare class Transform extends Component {
      * @param worldUp - Up direction in world space, default is Vector3(0, 1, 0)
      */
     lookAt(targetPosition: Vector3, worldUp?: Vector3): void;
-    protected _onLocalMatrixChanging?(): void;
-    protected _onWorldMatrixChange(): void;
+    protected _onLocalMatrixChanging(): void;
+    protected _onWorldMatrixChanging(): void;
     protected _isContainDirtyFlags(targetDirtyFlags: number): boolean;
     protected _isContainDirtyFlag(type: number): boolean;
     protected _setDirtyFlagTrue(type: number): void;
@@ -298,5 +298,7 @@ export declare enum TransformModifyFlags {
     /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale */
     WmWpWeWqWs = 188,
     /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling */
-    WmWpWeWqWsWus = 444
+    WmWpWeWqWsWus = 444,
+    /** LocalQuat | LocalMatrix | WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling */
+    LqLmWmWpWeWqWsWus = 510
 }

package/types/lighting/ambientOcclusion/AmbientOcclusion.d.ts

@@ -0,0 +1,79 @@
+import { Scene } from "../../Scene";
+import { AmbientOcclusionQuality } from "../enums/AmbientOcclusionQuality";
+/**
+ * Ambient Occlusion settings.
+ * @remarks
+ * Adds realistic shadows to corners, crevices, and areas where objects meet.
+ */
+export declare class AmbientOcclusion {
+    private static _enableMacro;
+    /**
+     * Controls the quality of the ambient occlusion effect.
+     * @remarks
+     * If set to `AmbientOcclusionQuality.Low`, the effect will use fewer samples for faster performance.
+     * If set to `AmbientOcclusionQuality.Medium`, the effect will balance quality and performance.
+     * If set to `AmbientOcclusionQuality.High`, the effect will use more samples for better quality, but the performance will be worse.
+     */
+    quality: AmbientOcclusionQuality;
+    private _scene;
+    private _enabled;
+    private _power;
+    private _bilateralThreshold;
+    private _radius;
+    private _intensity;
+    private _bias;
+    private _minHorizonAngle;
+    /**
+     * Control whether ambient occlusion is enabled or not.
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    /**
+     * Controls the radius of the ambient occlusion effect.
+     * Higher values create larger occlusion areas.
+     * Valid range: [0.1, 10.0]
+     * @defaultValue 0.3
+     */
+    get radius(): number;
+    set radius(value: number);
+    /**
+     * Controls the strength of the ambient occlusion effect.
+     * Valid range: [0.0, Infinity)
+     * @defaultValue 1.0
+     */
+    get intensity(): number;
+    set intensity(value: number);
+    /**
+     * Control the contrast of the ambient occlusion effect.
+     * The larger the value, the grayer the effect.
+     * Valid range: [1.0, 8.0]
+     * @defaultValue 1.0
+     */
+    get power(): number;
+    set power(value: number);
+    /**
+     * Control the threshold for blurred edges.
+     * Smaller value that retains the edge will result in sharper edges,
+     * while a larger value will make the edges softer.
+     * Valid range: [0.000001, 0.1]
+     * @defaultValue 0.05
+     */
+    get bilateralThreshold(): number;
+    set bilateralThreshold(value: number);
+    /**
+     * Controls the bias to prevent self-occlusion artifacts.
+     * Valid range: [0.0, 0.5]
+     * @defaultValue 0.0005
+     */
+    get bias(): number;
+    set bias(value: number);
+    /**
+     * Controls the minimum horizon angle to reduce artifacts from low-tessellation geometry.
+     * Valid range: [0.0, π/4] (0 to 45 degrees in radians)
+     * @defaultValue 0.0
+     */
+    get minHorizonAngle(): number;
+    set minHorizonAngle(value: number);
+    constructor(scene: Scene);
+    private _toggleAmbientOcclusionMacro;
+}

package/types/lighting/ambientOcclusion/ScalableAmbientObscurancePass.d.ts

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

package/types/lighting/ambientOcclusion/index.d.ts

@@ -0,0 +1,2 @@
+export { AmbientOcclusionQuality } from "../enums/AmbientOcclusionQuality";
+export { AmbientOcclusion } from "./AmbientOcclusion";

package/types/lighting/enums/AmbientOcclusionQuality.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ambient occlusion quality levels that control the balance between visual quality and performance.
+ */
+export declare enum AmbientOcclusionQuality {
+    /** Low quality - fewer samples, better performance. */
+    Low = 0,
+    /** Medium quality - balanced samples and performance. */
+    Medium = 1,
+    /** High quality - more samples, slower performance. */
+    High = 2
+}

package/types/lighting/index.d.ts

@@ -4,3 +4,4 @@ export { DiffuseMode } from "./enums/DiffuseMode";
 export { Light } from "./Light";
 export { PointLight } from "./PointLight";
 export { SpotLight } from "./SpotLight";
+export { AmbientOcclusion, AmbientOcclusionQuality } from "./ambientOcclusion";

package/types/shaderlib/ShaderLib.d.ts

@@ -35,6 +35,7 @@ export declare const ShaderLib: {
     worldpos_share: string;
     FogVertexDeclaration: string;
     FogFragmentDeclaration: string;
+    PositionClipSpaceDeclaration: string;
     begin_normal_vert: string;
     begin_position_vert: string;
     position_vert: string;
@@ -49,6 +50,7 @@ export declare const ShaderLib: {
     light_frag_define: string;
     mobile_material_frag: string;
     FogFragment: string;
+    PositionClipSpaceVertex: string;
     begin_mobile_frag: string;
     begin_viewdir_frag: string;
     mobile_blinnphong_frag: string;