@galacean/engine-core 2.0.0-alpha.43 → 2.0.0-alpha.45

package/types/physics/PhysicsScene.d.ts

@@ -1,6 +1,8 @@
 import { Ray, Vector3, Quaternion } from "@galacean/engine-math";
 import { Layer } from "../Layer";
 import { Scene } from "../Scene";
+import { CharacterController } from "./CharacterController";
+import { Collider } from "./Collider";
 import { HitResult } from "./HitResult";
 import { ColliderShape } from "./shape";
 /**
@@ -265,6 +267,55 @@ export declare class PhysicsScene {
      * @returns The collider shapes overlapping with the capsule
      */
     overlapCapsuleAll(center: Vector3, radius: number, height: number, orientation?: Quaternion, layerMask?: Layer, shapes?: ColliderShape[]): ColliderShape[];
+    /**
+     * Call on every frame to update pose of objects.
+     * @internal
+     */
+    _update(deltaTime: number): void;
+    /**
+     * Add collider into the manager.
+     * @param collider - StaticCollider or DynamicCollider.
+     * @internal
+     */
+    _addCollider(collider: Collider): void;
+    /**
+     * Add character controller into the manager.
+     * @param controller - Character Controller.
+     * @internal
+     */
+    _addCharacterController(controller: CharacterController): void;
+    /**
+     * Remove collider.
+     * @param collider - StaticCollider or DynamicCollider.
+     * @internal
+     */
+    _removeCollider(collider: Collider): void;
+    /**
+     * Remove collider.
+     * @param controller - Character Controller.
+     * @internal
+     */
+    _removeCharacterController(controller: CharacterController): void;
+    /**
+     * @internal
+     */
+    _addContactEventConsumer(delta: 1 | -1): void;
+    /**
+     * @internal
+     */
+    _callColliderOnUpdate(): void;
+    /**
+     * @internal
+     */
+    _callColliderOnLateUpdate(): void;
+    /**
+     * @internal
+     */
+    _gc(): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
     private _dispatchEvents;
     private _setGravity;
     private _createPreFilter;

package/types/physics/StaticCollider.d.ts

@@ -1,7 +1,12 @@
+import { Entity } from "../Entity";
 import { Collider } from "./Collider";
 /**
  * A static collider component that will not move.
  * @remarks Mostly used for object which always stays at the same place and never moves around.
  */
 export declare class StaticCollider extends Collider {
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
 }

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

@@ -1 +1,8 @@
-export {};
+/**
+ * @internal
+ */
+export declare enum ColliderShapeChangeFlag {
+    Property = 1,
+    Count = 2,
+    Both = 3
+}

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

@@ -1 +1,14 @@
-export {};
+/**
+ * Flags specific to the Hinge Joint.
+ * @internal
+ */
+export declare enum HingeJointFlag {
+    /** None. */
+    None = 0,
+    /** Enable the limit. */
+    LimitEnabled = 1,
+    /** Enable the drive. */
+    DriveEnabled = 2,
+    /** If the existing velocity is beyond the drive velocity, do not add force. */
+    DriveFreeSpin = 4
+}

package/types/physics/joint/HingeJoint.d.ts

@@ -53,6 +53,10 @@ export declare class HingeJoint extends Joint {
     get limits(): JointLimits;
     set limits(value: JointLimits);
     constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _onDisableInScene(): void;
     protected _createJoint(): void;
     protected _syncNative(): void;
     private _onMotorChanged;

package/types/physics/joint/Joint.d.ts

@@ -1,3 +1,4 @@
+import { DataObject } from "../../base/DataObject";
 import { IJoint } from "@galacean/engine-design";
 import { Vector3 } from "@galacean/engine-math";
 import { Component } from "../../Component";
@@ -70,6 +71,14 @@ export declare abstract class Joint extends Component {
     get breakTorque(): number;
     set breakTorque(value: number);
     constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _onEnableInScene(): void;
+    /**
+     * @internal
+     */
+    _onDisableInScene(): void;
     protected abstract _createJoint(): void;
     protected _syncNative(): void;
     private _calculateConnectedAnchor;
@@ -79,3 +88,14 @@ export declare abstract class Joint extends Component {
     private _updateRotation;
     private _updateActualAnchor;
 }
+/**
+ * @internal
+ */
+declare class JointColliderInfo extends DataObject {
+    collider: Collider;
+    anchor: Vector3;
+    actualAnchor: Vector3;
+    massScale: number;
+    inertiaScale: number;
+}
+export {};

package/types/physics/joint/JointLimits.d.ts

@@ -1,8 +1,11 @@
 import { DataObject } from "../../base/DataObject";
+import { UpdateFlagManager } from "../../UpdateFlagManager";
 /**
  * JointLimits is used to limit the joints angle.
  */
 export declare class JointLimits extends DataObject {
+    /** @internal */
+    _updateFlagManager: UpdateFlagManager;
     private _max;
     private _min;
     private _contactDistance;

package/types/physics/joint/JointMotor.d.ts

@@ -1,8 +1,11 @@
 import { DataObject } from "../../base/DataObject";
+import { UpdateFlagManager } from "../../UpdateFlagManager";
 /**
  * The JointMotor is used to motorize a joint.
  */
 export declare class JointMotor extends DataObject {
+    /** @internal */
+    _updateFlagManager: UpdateFlagManager;
     private _targetVelocity;
     private _forceLimit;
     private _gearRatio;

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

@@ -1,4 +1,5 @@
 import { DataObject } from "../../base/DataObject";
+import { IColliderShape } from "@galacean/engine-design";
 import { PhysicsMaterial } from "../PhysicsMaterial";
 import { Vector3 } from "@galacean/engine-math";
 import { Collider } from "../Collider";
@@ -8,12 +9,24 @@ import type { ICloneHook } from "../../clone/ICloneHook";
  */
 export declare abstract class ColliderShape extends DataObject implements ICloneHook<ColliderShape> {
     private static _idGenerator;
+    /** @internal */
+    _collider: Collider;
+    /** @internal */
+    _nativeShape: IColliderShape;
+    /** @internal */
+    _isShapeAttached: boolean;
     protected _id: number;
     protected _material: PhysicsMaterial;
     private _isTrigger;
     private _rotation;
     private _position;
     private _contactOffset;
+    /**
+     * @internal
+     * @beta
+     * Whether raycast can select it.
+     */
+    isSceneQuery: boolean;
     /**
      * Collider owner of this shape.
      */
@@ -60,6 +73,10 @@ export declare abstract class ColliderShape extends DataObject implements IClone
      * @inheritdoc
      */
     _onClone(target: ColliderShape): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
     protected _syncNative(): void;
     private _setPosition;
     private _setRotation;

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

@@ -38,6 +38,10 @@ export declare class MeshColliderShape extends ColliderShape {
      * @inheritdoc
      */
     _onClone(target: MeshColliderShape): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
     private _clearMeshData;
     private _destroyNativeShape;
     private _extractMeshData;

package/types/postProcess/FinalPass.d.ts

@@ -1 +1,19 @@
-export {};
+import { Camera } from "../Camera";
+import { Engine } from "../Engine";
+import { PipelinePass } from "../RenderPipeline/PipelinePass";
+import { RenderContext } from "../RenderPipeline/RenderContext";
+import { RenderTarget } from "../texture";
+/**
+ * @internal
+ * Processing sRGB Conversion and FXAA.
+ */
+export declare class FinalPass extends PipelinePass {
+    private _inputRenderTarget;
+    private _srgbRenderTarget;
+    private _antiAliasingMaterial;
+    private _sRGBmaterial;
+    constructor(engine: Engine);
+    onConfig(camera: Camera, inputRenderTarget: RenderTarget): void;
+    onRender(context: RenderContext): void;
+    release(): void;
+}

package/types/postProcess/PostProcess.d.ts

@@ -13,6 +13,8 @@ export declare class PostProcess extends Component {
      * The outer distance to start blending from, only takes effect when the `isGlobal` is false.
      */
     blendDistance: number;
+    /** @internal */
+    _effects: PostProcessEffect[];
     private _priority;
     private _isGlobal;
     /**

package/types/postProcess/PostProcessEffect.d.ts

@@ -17,6 +17,10 @@ export declare class PostProcessEffect extends DataObject {
      * This method can be overridden to control the effect's real validity.
      */
     isValid(): boolean;
+    /**
+     * @internal
+     */
+    _lerp(to: PostProcessEffect, factor: number): void;
     /**
      * Get all parameters of the post process effect.
      * @remarks

package/types/postProcess/PostProcessEffectParameter.d.ts

@@ -19,6 +19,10 @@ export declare abstract class PostProcessEffectParameter<T> extends DataObject {
     get value(): T;
     set value(value: T);
     constructor(value: T, needLerp?: boolean);
+    /**
+     * @internal
+     */
+    _lerp(to: T, factor: number): void;
 }
 /**
  * Represents a float parameter of a post process effect.

package/types/postProcess/PostProcessManager.d.ts

@@ -1,4 +1,8 @@
+import { Camera } from "../Camera";
 import { Scene } from "../Scene";
+import { Material } from "../material";
+import { RenderTarget } from "../texture";
+import { PostProcess } from "./PostProcess";
 import { PostProcessEffect } from "./PostProcessEffect";
 /**
  * A global manager of the PostProcess.
@@ -7,6 +11,12 @@ export declare class PostProcessManager {
     readonly scene: Scene;
     private static _tempColliders;
     private static _tempVector3;
+    /** @internal */
+    _uberMaterial: Material;
+    /** @internal */
+    _postProcessNeedSorting: boolean;
+    /** @internal */
+    _postProcessPassNeedSorting: boolean;
     private _activePostProcesses;
     private _swapRenderTarget;
     private _srcRenderTarget;
@@ -22,6 +32,23 @@ export declare class PostProcessManager {
      * @param scene - Scene to which the current PostProcessManager belongs
      */
     constructor(scene: Scene);
+    /**
+     * @internal
+     * Whether has any valid post process pass.
+     */
+    _isValid(): boolean;
+    /**
+     * @internal
+     */
+    _update(camera: Camera): void;
+    /**
+     * @internal
+     */
+    _addPostProcess(postProcess: PostProcess): void;
+    /**
+     * @internal
+     */
+    _removePostProcess(postProcess: PostProcess): void;
     /**
      * Get the blend effect by type.
      * @remarks
@@ -30,6 +57,22 @@ export declare class PostProcessManager {
      * @returns The PostProcessEffect instance found
      */
     getBlendEffect<T extends typeof PostProcessEffect>(type: T): InstanceType<T>;
+    /**
+     * @internal
+     */
+    _render(camera: Camera, srcRenderTarget: RenderTarget, destRenderTarget: RenderTarget): void;
+    /**
+     * @internal
+     */
+    _releaseSwapRenderTarget(): void;
+    /**
+     * @internal
+     */
+    _releaseOutputRenderTarget(): void;
+    /**
+     * @internal
+     */
+    _getOutputRenderTarget(camera: Camera): RenderTarget;
     private _sortActivePostProcess;
     private _resetDefaultValue;
     private _initSwapRenderTarget;

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

@@ -1,3 +1,4 @@
+import { ShaderMacro, ShaderProperty } from "../../shader";
 import { PostProcessEffect } from "../PostProcessEffect";
 import { PostProcessEffectBoolParameter, PostProcessEffectColorParameter, PostProcessEffectEnumParameter, PostProcessEffectFloatParameter, PostProcessEffectTextureParameter } from "../PostProcessEffectParameter";
 /**
@@ -11,6 +12,30 @@ export declare enum BloomDownScaleMode {
 }
 export declare class BloomEffect extends PostProcessEffect {
     static readonly SHADER_NAME = "PostProcess/Bloom";
+    /** @internal */
+    static _maxIterations: number;
+    /** @internal */
+    static _hqMacro: ShaderMacro;
+    /** @internal */
+    static _dirtMacro: ShaderMacro;
+    /** @internal */
+    static _bloomParams: ShaderProperty;
+    /** @internal */
+    static _lowMipTextureProp: ShaderProperty;
+    /** @internal */
+    static _lowMipTexelSizeProp: ShaderProperty;
+    /** @internal */
+    static _enableMacro: ShaderMacro;
+    /** @internal */
+    static _bloomTextureProp: ShaderProperty;
+    /** @internal */
+    static _dirtTextureProp: ShaderProperty;
+    /** @internal */
+    static _tintProp: ShaderProperty;
+    /** @internal */
+    static _bloomIntensityParams: ShaderProperty;
+    /** @internal */
+    static _dirtTilingOffsetProp: ShaderProperty;
     /**
      * Controls whether to use bicubic sampling instead of bilinear sampling for the upSampling passes.
      * @remarks This is slightly more expensive but helps getting smoother visuals.

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

@@ -1,3 +1,4 @@
+import { ShaderMacro } from "../../shader";
 import { PostProcessEffect } from "../PostProcessEffect";
 import { PostProcessEffectEnumParameter } from "../PostProcessEffectParameter";
 /**
@@ -18,6 +19,8 @@ export declare enum TonemappingMode {
     ACES = 1
 }
 export declare class TonemappingEffect extends PostProcessEffect {
+    /** @internal */
+    static _enableMacro: ShaderMacro;
     /**
      * Use this to select a tonemapping algorithm to use.
      */

package/types/renderingHardwareInterface/IPlatformTransformFeedback.d.ts

@@ -1 +1,36 @@
-export {};
+import { IPlatformBuffer } from "./IPlatformBuffer";
+/**
+ * Platform interface for Transform Feedback operations.
+ * @internal
+ */
+export interface IPlatformTransformFeedback {
+    /**
+     * Bind a buffer range as Transform Feedback output at the given index.
+     */
+    bindBufferRange(index: number, buffer: IPlatformBuffer, byteOffset: number, byteSize: number): void;
+    /**
+     * Unbind buffer from Transform Feedback output at the given index.
+     */
+    unbindBuffer(index: number): void;
+    /**
+     * Begin a Transform Feedback pass.
+     * @param primitiveMode - The primitive mode (e.g., POINTS)
+     */
+    begin(primitiveMode: number): void;
+    /**
+     * End the current Transform Feedback pass.
+     */
+    end(): void;
+    /**
+     * Bind this Transform Feedback object as the active TF.
+     */
+    bind(): void;
+    /**
+     * Unbind the Transform Feedback object.
+     */
+    unbind(): void;
+    /**
+     * Destroy native resources.
+     */
+    destroy(): void;
+}

package/types/renderingHardwareInterface/IPlatformTransformFeedbackPrimitive.d.ts

@@ -1 +1,40 @@
-export {};
+/**
+ * Platform interface for Transform Feedback primitive operations.
+ * @internal
+ */
+export interface IPlatformTransformFeedbackPrimitive {
+    /**
+     * Update vertex layout. Auto-rebuilds when program changes.
+     * @param program - Shader program (for attribute locations)
+     * @param readBinding - Current read buffer binding
+     * @param writeBinding - Current write buffer binding
+     * @param feedbackElements - Vertex elements for feedback buffer
+     * @param inputBinding - Input buffer binding
+     * @param inputElements - Vertex elements for input buffer
+     */
+    updateVertexLayout(program: any, readBinding: any, writeBinding: any, feedbackElements: any[], inputBinding: any, inputElements: any[]): void;
+    /**
+     * Bind attribute state for the given read direction.
+     * @param readIsA - Whether to use direction A as read
+     */
+    bind(readIsA: boolean): void;
+    /**
+     * Unbind attribute state.
+     */
+    unbind(): void;
+    /**
+     * Issue a draw call.
+     * @param mode - Primitive topology
+     * @param first - First vertex index
+     * @param count - Number of vertices
+     */
+    draw(mode: number, first: number, count: number): void;
+    /**
+     * Invalidate cached state, forcing rebuild on next updateVertexLayout.
+     */
+    invalidate(): void;
+    /**
+     * Destroy native resources.
+     */
+    destroy(): void;
+}

package/types/shader/Shader.d.ts

@@ -1,6 +1,8 @@
+import { IShaderCompiler, IPrecompiledShader } from "@galacean/engine-design";
 import { Engine } from "../Engine";
 import { IReferable } from "../asset/IReferable";
 import { ShaderMacro } from "./ShaderMacro";
+import { ShaderMacroCollection } from "./ShaderMacroCollection";
 import { ShaderPass } from "./ShaderPass";
 import { ShaderProperty } from "./ShaderProperty";
 import { SubShader } from "./SubShader";
@@ -10,6 +12,10 @@ import { ShaderLanguage } from "./enums/ShaderLanguage";
  */
 export declare class Shader implements IReferable {
     readonly name: string;
+    /** @internal */
+    static readonly _compileMacros: ShaderMacroCollection;
+    /** @internal */
+    static _shaderCompiler?: IShaderCompiler;
     private static _shaderMap;
     /**
      * Create a shader by source code.
@@ -53,6 +59,14 @@ export declare class Shader implements IReferable {
      * @param name - Name of the shader
      */
     static find(name: string): Shader;
+    /**
+     * @internal
+     */
+    static _createFromPrecompiled(data: IPrecompiledShader): Shader;
+    /**
+     * @internal
+     */
+    static _clear(engine: Engine): void;
     private static _resolveUsePass;
     private static _applyRenderStates;
     private static _applyConstRenderStates;
@@ -85,6 +99,14 @@ export declare class Shader implements IReferable {
      * @returns Whether the release was successful.
      */
     destroy(force?: boolean): boolean;
+    /**
+     * @internal
+     */
+    _getReferCount(): number;
+    /**
+     * @internal
+     */
+    _addReferCount(value: number): void;
     /**
      * @deprecated Please use `ShaderMacro.getByName` instead
      *

package/types/shader/ShaderBlockProperty.d.ts

@@ -1 +1,19 @@
-export {};
+/**
+ * @internal
+ * Shader block property, used to identify uniform blocks by id.
+ */
+export declare class ShaderBlockProperty {
+    private static _counter;
+    private static _nameMap;
+    /**
+     * Get shader block property by name.
+     * @param name - Name of the uniform block
+     * @returns Shader block property
+     */
+    static getByName(name: string): ShaderBlockProperty;
+    /** Uniform block name. */
+    readonly name: string;
+    /** @internal */
+    readonly _uniqueId: number;
+    private constructor();
+}

package/types/shader/ShaderData.d.ts

@@ -5,14 +5,27 @@ import { IReferable } from "../asset/IReferable";
 import type { ICloneHook } from "../clone/ICloneHook";
 import { Texture } from "../texture/Texture";
 import { ShaderMacro } from "./ShaderMacro";
+import { ShaderMacroCollection } from "./ShaderMacroCollection";
 import { ShaderProperty } from "./ShaderProperty";
+import { ShaderDataGroup } from "./enums/ShaderDataGroup";
+import { ShaderPropertyType } from "./enums/ShaderPropertyType";
 /**
  * Shader data collection,Correspondence includes shader properties data and macros data.
  */
 export declare class ShaderData extends DataObject implements IReferable, IClone, ICloneHook<ShaderData> {
+    /** @internal */
+    _group: ShaderDataGroup;
+    /** @internal */
+    _propertyValueMap: Record<number, ShaderPropertyValueType>;
+    /** @internal */
+    _macroCollection: ShaderMacroCollection;
     private _batchSharedFields;
     private _macroMap;
     private _refCount;
+    /**
+     * @internal
+     */
+    constructor(group: ShaderDataGroup);
     /**
      * Get float by shader property name.
      * @param propertyName - Shader property name
@@ -353,6 +366,22 @@ export declare class ShaderData extends DataObject implements IReferable, IClone
      * @inheritdoc
      */
     _onClone(target: ShaderData): void;
+    /**
+     * @internal
+     */
+    _setPropertyValue<T extends ShaderPropertyValueType>(property: string | ShaderProperty, type: ShaderPropertyType, value: T): void;
+    /**
+     * @internal
+     */
+    _matchesRendererBatchShared(other: ShaderData): boolean;
+    /**
+     * @internal
+     */
+    _getReferCount(): number;
+    /**
+     * @internal
+     */
+    _addReferCount(value: number): void;
     private _addTexturesReferCount;
     private _updateRendererBatchSharedFields;
 }

package/types/shader/ShaderFactory.d.ts

@@ -1,4 +1,5 @@
 import { Engine } from "../Engine";
+import { ShaderProperty } from "./ShaderProperty";
 /**
  * Shader registry and GLSL utilities. Holds the `#include` lookup table
  * the runtime preprocessor reads, the GLSL ES 100 → 300 syntax converter
@@ -53,3 +54,25 @@ export declare class ShaderFactory {
     private static _buildFieldDefines;
     private static _replaceMRTShader;
 }
+/**
+ * @internal
+ */
+export interface InstanceFieldInfo {
+    property: ShaderProperty;
+    type: string;
+    offset: number;
+    /** offset / 4, precomputed to avoid repeated division in upload loop */
+    offsetInElements: number;
+    useIntView: boolean;
+    pack: InstancePackFunc;
+}
+/**
+ * @internal
+ */
+export interface InstanceBufferLayout {
+    instanceFields: InstanceFieldInfo[];
+    instanceMaxCount: number;
+    structSize: number;
+}
+type InstancePackFunc = (view: Float32Array | Int32Array, offset: number, value: any) => void;
+export {};

package/types/shader/ShaderMacro.d.ts

@@ -1,7 +1,12 @@
+import { ShaderMacroCollection } from "./ShaderMacroCollection";
 /**
  * Shader macro。
  */
 export declare class ShaderMacro {
+    /** @internal */
+    static _macroMaskMap: ShaderMacro[][];
+    /** @internal */
+    static _macroNameIdMap: Record<string, number>;
     private static _macroNameCounter;
     private static _macroCounter;
     private static _macroMap;
@@ -18,9 +23,19 @@ export declare class ShaderMacro {
      * @returns Shader macro
      */
     static getByName(name: string, value: string): ShaderMacro;
+    /**
+     * @internal
+     */
+    static _getMacrosElements(macros: ShaderMacroCollection, out: ShaderMacro[]): void;
     /** Name. */
     readonly name: string;
     /** Value. */
     readonly value: string;
+    /** @internal */
+    _nameId: number;
+    /** @internal */
+    _maskIndex: number;
+    /** @internal */
+    _maskValue: number;
     private constructor();
 }