@galacean/engine-core 2.0.0-alpha.44 → 2.0.0-alpha.46

package/types/graphic/TransformFeedbackPrimitive.d.ts

@@ -1 +1,67 @@
-export {};
+import { Engine } from "../Engine";
+import { GraphicsResource } from "../asset/GraphicsResource";
+import { IPlatformTransformFeedbackPrimitive } from "../renderingHardwareInterface";
+import { ShaderProgram } from "../shader/ShaderProgram";
+import { MeshTopology } from "./enums/MeshTopology";
+import { VertexBufferBinding } from "./VertexBufferBinding";
+import { VertexElement } from "./VertexElement";
+/**
+ * @internal
+ * Primitive for Transform Feedback simulation with read/write buffer swapping.
+ */
+export declare class TransformFeedbackPrimitive extends GraphicsResource {
+    /** @internal */
+    _platformPrimitive: IPlatformTransformFeedbackPrimitive;
+    private _transformFeedback;
+    private _bindingA;
+    private _bindingB;
+    private _byteStride;
+    private _readIsA;
+    /**
+     * The current read buffer binding.
+     */
+    get readBinding(): VertexBufferBinding;
+    /**
+     * The current write buffer binding.
+     */
+    get writeBinding(): VertexBufferBinding;
+    /**
+     * @param engine - Engine instance
+     * @param byteStride - Bytes per vertex
+     */
+    constructor(engine: Engine, byteStride: number);
+    /**
+     * Resize read and write buffers.
+     * @param vertexCount - Number of vertices to allocate
+     */
+    resize(vertexCount: number): void;
+    /**
+     * Update vertex layout, only rebuilds when program changes.
+     * @param program - Shader program for attribute locations
+     * @param feedbackElements - Vertex elements describing the read/write buffer
+     * @param inputBinding - Additional input buffer binding
+     * @param inputElements - Vertex elements describing the input buffer
+     */
+    updateVertexLayout(program: ShaderProgram, feedbackElements: VertexElement[], inputBinding: VertexBufferBinding, inputElements: VertexElement[]): void;
+    /**
+     * Bind state before issuing draw calls.
+     */
+    beginDraw(): void;
+    /**
+     * Issue a draw call for a vertex range, capturing output to the write buffer.
+     * @param mode - Primitive topology
+     * @param first - First vertex index
+     * @param count - Number of vertices
+     */
+    draw(mode: MeshTopology, first: number, count: number): void;
+    /**
+     * Unbind state after draw calls.
+     */
+    endDraw(): void;
+    /**
+     * Swap read and write buffers.
+     */
+    swap(): void;
+    _rebuild(): void;
+    protected _onDestroy(): void;
+}

package/types/graphic/TransformFeedbackSimulator.d.ts

@@ -1 +1,55 @@
-export {};
+import { Engine } from "../Engine";
+import { MeshTopology } from "./enums/MeshTopology";
+import { VertexBufferBinding } from "./VertexBufferBinding";
+import { VertexElement } from "./VertexElement";
+import { ShaderData } from "../shader/ShaderData";
+import { ShaderPass } from "../shader/ShaderPass";
+/**
+ * @internal
+ * General-purpose Transform Feedback simulator.
+ * Manages per-frame simulation with shared shader program caching.
+ */
+export declare class TransformFeedbackSimulator {
+    private _engine;
+    private _primitive;
+    private _shaderPass;
+    /**
+     * The current read buffer binding.
+     */
+    get readBinding(): VertexBufferBinding;
+    /**
+     * The current write buffer binding.
+     */
+    get writeBinding(): VertexBufferBinding;
+    /**
+     * @param engine - Engine instance
+     * @param byteStride - Bytes per vertex in the feedback buffer
+     * @param shaderPass - ShaderPass with feedbackVaryings configured
+     */
+    constructor(engine: Engine, byteStride: number, shaderPass: ShaderPass);
+    /**
+     * Resize feedback buffers.
+     * @param vertexCount - Number of vertices to allocate
+     */
+    resize(vertexCount: number): void;
+    /**
+     * Begin a simulation step: get/compile program, bind, upload uniforms, update layout.
+     * @param shaderData - Shader data with current macros and uniforms
+     * @param feedbackElements - Vertex elements for the feedback buffer
+     * @param inputBinding - Input buffer binding
+     * @param inputElements - Vertex elements for the input buffer
+     */
+    beginUpdate(shaderData: ShaderData, feedbackElements: VertexElement[], inputBinding: VertexBufferBinding, inputElements: VertexElement[]): boolean;
+    /**
+     * Issue a draw call for a vertex range.
+     * @param mode - Primitive topology
+     * @param first - First vertex index
+     * @param count - Number of vertices
+     */
+    draw(mode: MeshTopology, first: number, count: number): void;
+    /**
+     * End the simulation step: unbind state and swap buffers.
+     */
+    endUpdate(): void;
+    destroy(): void;
+}

package/types/graphic/VertexBufferBinding.d.ts

@@ -3,6 +3,10 @@ import { Buffer } from "./Buffer";
  * Vertex buffer binding.
  */
 export declare class VertexBufferBinding {
+    /** @internal */
+    _buffer: Buffer;
+    /** @internal */
+    _stride: number;
     /**
      * Vertex buffer.
      */

package/types/input/InputManager.d.ts

@@ -1,4 +1,7 @@
+import { IInputOptions } from "@galacean/engine-design";
 import { Vector3 } from "@galacean/engine-math";
+import { Engine } from "../Engine";
+import { Scene } from "../Scene";
 import { Keys } from "./enums/Keys";
 import { PointerButton } from "./enums/PointerButton";
 import { Pointer } from "./pointer/Pointer";
@@ -62,4 +65,20 @@ export declare class InputManager {
      * @returns Whether the pointer is released during the current frame
      */
     isPointerUp(pointerButton?: PointerButton): boolean;
+    /**
+     * @internal
+     */
+    constructor(engine: Engine, inputOptions?: IInputOptions);
+    /**
+     * @internal
+     */
+    _update(): void;
+    /**
+     * @internal
+     */
+    _firePointerScript(scenes: readonly Scene[]): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
 }

package/types/input/enums/PointerButton.d.ts

@@ -31,3 +31,11 @@ export declare enum PointerButton {
     /** Indicate the X8 pointer. */
     XButton8 = 1024
 }
+/**
+ * @internal
+ */
+export declare const _pointerDec2BinMap: PointerButton[];
+/**
+ * @internal
+ */
+export declare const _pointerBin2DecMap: Record<number, number>;

package/types/input/keyboard/KeyboardManager.d.ts

@@ -1 +1,41 @@
-export {};
+import { Engine } from "../../Engine";
+import { DisorderedArray } from "../../utils/DisorderedArray";
+import { Keys } from "../enums/Keys";
+import { IInput } from "../interface/IInput";
+/**
+ * Keyboard Manager.
+ * @internal
+ */
+export declare class KeyboardManager implements IInput {
+    /** @internal */
+    _curHeldDownKeyToIndexMap: number[];
+    /** @internal */
+    _upKeyToFrameCountMap: number[];
+    /** @internal */
+    _downKeyToFrameCountMap: number[];
+    /** @internal */
+    _curFrameHeldDownList: DisorderedArray<Keys>;
+    /** @internal */
+    _curFrameDownList: DisorderedArray<Keys>;
+    /** @internal */
+    _curFrameUpList: DisorderedArray<Keys>;
+    _target: EventTarget;
+    private _engine;
+    private _nativeEvents;
+    /**
+     * @internal
+     */
+    constructor(engine: Engine, target: EventTarget);
+    /**
+     * @internal
+     */
+    _update(): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
+    private _onBlur;
+    private _onKeyEvent;
+    private _addEventListener;
+    private _removeEventListener;
+}

package/types/input/pointer/Pointer.d.ts

@@ -1,6 +1,10 @@
 import { Vector2 } from "@galacean/engine-math";
+import { ClearableObjectPool } from "../../utils/ClearableObjectPool";
+import { DisorderedArray } from "../../utils/DisorderedArray";
 import { PointerButton } from "../enums/PointerButton";
 import { PointerPhase } from "../enums/PointerPhase";
+import { PointerEventData } from "./PointerEventData";
+import { PointerEventEmitter } from "./emitter/PointerEventEmitter";
 /**
  * Pointer.
  */
@@ -20,6 +24,38 @@ export declare class Pointer {
     position: Vector2;
     /** The change of the pointer. */
     deltaPosition: Vector2;
+    /** @internal */
+    _events: PointerEvent[];
+    /** @internal */
+    _uniqueID: number;
+    /** @internal */
+    _upMap: number[];
+    /** @internal */
+    _downMap: number[];
+    /** @internal */
+    _upList: DisorderedArray<PointerButton>;
+    /** @internal */
+    _downList: DisorderedArray<PointerButton>;
+    /** @internal */
+    _frameEvents: PointerEventType;
+    /** @internal */
+    _emitters: PointerEventEmitter[];
+    /**
+     * @internal
+     */
+    constructor(id: number);
+    /**
+     * @internal
+     */
+    _addEmitters<T extends new (pool: ClearableObjectPool<PointerEventData>) => PointerEventEmitter>(type: T, pool: ClearableObjectPool<PointerEventData>): void;
+    /**
+     * @internal
+     */
+    _resetOnFrameBegin(): void;
+    /**
+     * @internal
+     */
+    _dispose(): void;
 }
 export declare enum PointerEventType {
     None = 0,

package/types/input/pointer/PointerEventData.d.ts

@@ -9,4 +9,8 @@ export declare class PointerEventData implements IPoolElement {
     pointer: Pointer;
     /** The position of the event trigger (in world space). */
     worldPosition: Vector3;
+    /**
+     * @internal
+     */
+    dispose(): void;
 }

package/types/input/pointer/PointerManager.d.ts

@@ -1,9 +1,67 @@
+import { Engine } from "../../Engine";
+import { Scene } from "../../Scene";
 import { ClearableObjectPool } from "../../utils/ClearableObjectPool";
+import { DisorderedArray } from "../../utils/DisorderedArray";
+import { PointerButton } from "../enums/PointerButton";
+import { IInput } from "../interface/IInput";
+import { Pointer } from "./Pointer";
 import { PointerEventData } from "./PointerEventData";
 import { PointerEventEmitter } from "./emitter/PointerEventEmitter";
+type PointerEventEmitterConstructor = new (pool: ClearableObjectPool<PointerEventData>) => PointerEventEmitter;
+/**
+ * Pointer Manager.
+ * @internal
+ */
+export declare class PointerManager implements IInput {
+    /** @internal */
+    static _pointerEventEmitters: PointerEventEmitterConstructor[];
+    /** @internal */
+    _pointers: Pointer[];
+    /** @internal */
+    _multiPointerEnabled: boolean;
+    /** @internal */
+    _buttons: PointerButton;
+    /** @internal */
+    _upMap: number[];
+    /** @internal */
+    _downMap: number[];
+    /** @internal */
+    _upList: DisorderedArray<PointerButton>;
+    /** @internal */
+    _downList: DisorderedArray<PointerButton>;
+    _target: EventTarget;
+    private _engine;
+    private _canvas;
+    private _nativeEvents;
+    private _pointerPool;
+    private _htmlCanvas;
+    private _eventPool;
+    /**
+     * @internal
+     */
+    constructor(engine: Engine, target: EventTarget);
+    /**
+     * @internal
+     */
+    _update(): void;
+    /**
+     * @internal
+     */
+    _firePointerScript(scenes: readonly Scene[]): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
+    private _onPointerEvent;
+    private _getPointerByID;
+    private _updatePointerInfo;
+    private _addEventListener;
+    private _removeEventListener;
+}
 /**
  * Declare pointer event emitter decorator.
  */
 export declare function registerPointerEventEmitter(): <T extends PointerEventEmitter>(Target: {
     new (pool: ClearableObjectPool<PointerEventData>): T;
 }) => void;
+export {};

package/types/input/pointer/emitter/IHitResult.d.ts

@@ -1 +1,11 @@
-export {};
+import { Vector3 } from "@galacean/engine-math";
+import { Entity } from "../../../Entity";
+/**
+ * @internal
+ */
+export interface IHitResult {
+    entity: Entity;
+    distance: number;
+    point: Vector3;
+    normal: Vector3;
+}

package/types/input/pointer/emitter/PhysicsPointerEventEmitter.d.ts

@@ -1 +1,20 @@
-export {};
+import { Entity } from "../../../Entity";
+import { Scene } from "../../../Scene";
+import { Pointer } from "../Pointer";
+import { PointerEventEmitter } from "./PointerEventEmitter";
+/**
+ * @internal
+ */
+export declare class PhysicsPointerEventEmitter extends PointerEventEmitter {
+    protected _enteredEntity: Entity;
+    protected _pressedEntity: Entity;
+    protected _draggedEntity: Entity;
+    processRaycast(scenes: readonly Scene[], pointer: Pointer): void;
+    processDrag(pointer: Pointer): void;
+    processDown(pointer: Pointer): void;
+    processUp(pointer: Pointer): void;
+    processLeave(pointer: Pointer): void;
+    dispose(): void;
+    protected _init(): void;
+    private _updateRaycast;
+}

package/types/input/wheel/WheelManager.d.ts

@@ -1 +1,34 @@
-export {};
+import { Vector3 } from "@galacean/engine-math";
+import { Engine } from "../../Engine";
+import { IInput } from "../interface/IInput";
+/**
+ * Wheel Manager.
+ * @internal
+ */
+export declare class WheelManager implements IInput {
+    /** @internal */
+    _delta: Vector3;
+    _target: EventTarget;
+    private _nativeEvents;
+    /**
+     * @internal
+     */
+    constructor(engine: Engine, target: EventTarget);
+    /**
+     * @internal
+     */
+    _update(): void;
+    /**
+     * @internal
+     */
+    _addEventListener(): void;
+    /**
+     * @internal
+     */
+    _removeEventListener(): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
+    private _onWheelEvent;
+}

package/types/lighting/AmbientLight.d.ts

@@ -1,6 +1,7 @@
 import { Color, SphericalHarmonics3 } from "@galacean/engine-math";
 import { ReferResource } from "../asset/ReferResource";
 import { Engine } from "../Engine";
+import { Scene } from "../Scene";
 import { TextureCube } from "../texture";
 import { DiffuseMode } from "./enums/DiffuseMode";
 /**
@@ -55,6 +56,14 @@ export declare class AmbientLight extends ReferResource {
      */
     get specularIntensity(): number;
     set specularIntensity(value: number);
+    /**
+     * @internal
+     */
+    _addToScene(scene: Scene): void;
+    /**
+     * @internal
+     */
+    _removeFromScene(scene: Scene): void;
     constructor(engine: Engine);
     private _setDiffuseMode;
     private _setSpecularTexture;

package/types/lighting/DirectLight.d.ts

@@ -1,4 +1,5 @@
 import { Vector3 } from "@galacean/engine-math";
+import { ShaderData } from "../shader";
 import { Light } from "./Light";
 /**
  * Directional light.
@@ -7,6 +8,10 @@ export declare class DirectLight extends Light {
     private static _cullingMaskProperty;
     private static _colorProperty;
     private static _directionProperty;
+    /**
+     * @internal
+     */
+    static _updateShaderData(shaderData: ShaderData, data: IDirectLightShaderData): void;
     /**
      * The offset distance in the opposite direction of light direction when generating shadows.
      * @remarks Increasing this value can avoid the holes in the shadow caused by low polygon models.
@@ -21,6 +26,18 @@ export declare class DirectLight extends Light {
      * Get the opposite direction of the directional light direction.
      */
     get reverseDirection(): Vector3;
+    /**
+     * @internal
+     */
+    _appendData(lightIndex: number, data: IDirectLightShaderData): void;
+    /**
+     * @internal
+     */
+    _onEnableInScene(): void;
+    /**
+     * @internal
+     */
+    _onDisableInScene(): void;
 }
 /**
  * Shader properties data of direct lights in the scene.

package/types/lighting/Light.d.ts

@@ -22,6 +22,8 @@ export declare abstract class Light extends Component {
      * Please use `shadowNearPlaneOffset` instead.
      */
     shadowNearPlane: number;
+    /** @internal */
+    _lightIndex: number;
     private _shadowStrength;
     private _color;
     private _viewMat;

package/types/lighting/LightManager.d.ts

@@ -1,12 +1,69 @@
+import { ShaderData, ShaderProperty } from "../shader";
+import { DisorderedArray } from "../utils/DisorderedArray";
+import { DirectLight } from "./DirectLight";
+import { PointLight } from "./PointLight";
+import { SpotLight } from "./SpotLight";
 /**
  * Light manager.
  */
 export declare class LightManager {
+    /** @internal */
+    static _sunlightColorProperty: ShaderProperty;
+    /** @internal */
+    static _sunlightDirectionProperty: ShaderProperty;
     /**
      * Each type of light source is at most 10, beyond which it will not take effect.
      * */
     private static _maxLight;
+    /** @internal */
+    _spotLights: DisorderedArray<SpotLight>;
+    /** @internal */
+    _pointLights: DisorderedArray<PointLight>;
+    /** @internal */
+    _directLights: DisorderedArray<DirectLight>;
+    /** @internal */
+    _sunlight: DirectLight | null;
     private _directData;
     private _pointData;
     private _spotData;
+    /**
+     * @internal
+     */
+    _attachSpotLight(light: SpotLight): void;
+    /**
+     * @internal
+     */
+    _detachSpotLight(light: SpotLight): void;
+    /**
+     * @internal
+     */
+    _attachPointLight(light: PointLight): void;
+    /**
+     * @internal
+     */
+    _detachPointLight(light: PointLight): void;
+    /**
+     * @internal
+     */
+    _attachDirectLight(light: DirectLight): void;
+    /**
+     * @internal
+     */
+    _detachDirectLight(light: DirectLight): void;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _gc(): void;
+    /**
+     * @internal
+     */
+    _updateSunlightIndex(light: DirectLight): void;
+    /**
+     * @internal
+     */
+    _getMaxBrightestSunlight(): DirectLight | null;
 }

package/types/lighting/PointLight.d.ts

@@ -1,4 +1,5 @@
 import { Vector3 } from "@galacean/engine-math";
+import { ShaderData } from "../shader";
 import { Light } from "./Light";
 /**
  * Point light.
@@ -8,12 +9,28 @@ export declare class PointLight extends Light {
     private static _colorProperty;
     private static _positionProperty;
     private static _distanceProperty;
+    /**
+     * @internal
+     */
+    static _updateShaderData(shaderData: ShaderData, data: IPointLightShaderData): void;
     /** Defines a distance cutoff at which the light's intensity must be considered zero. */
     distance: number;
     /**
      * Get light position.
      */
     get position(): Vector3;
+    /**
+     * @internal
+     */
+    _appendData(lightIndex: number, data: IPointLightShaderData): void;
+    /**
+     * @internal
+     */
+    _onEnableInScene(): void;
+    /**
+     * @internal
+     */
+    _onDisableInScene(): void;
 }
 /**
  * Shader properties data of point lights in the scene.

package/types/lighting/SpotLight.d.ts

@@ -1,4 +1,5 @@
 import { Vector3 } from "@galacean/engine-math";
+import { ShaderData } from "../shader";
 import { Light } from "./Light";
 /**
  * Spot light.
@@ -11,6 +12,10 @@ export declare class SpotLight extends Light {
     private static _distanceProperty;
     private static _angleCosProperty;
     private static _penumbraCosProperty;
+    /**
+     * @internal
+     */
+    static _updateShaderData(shaderData: ShaderData, data: ISpotLightShaderData): void;
     /** Defines a distance cutoff at which the light's intensity must be considered zero. */
     distance: number;
     /** Angle, in radians, from centre of spotlight where falloff begins. */
@@ -30,6 +35,18 @@ export declare class SpotLight extends Light {
      * Get the opposite direction of the spotlight.
      */
     get reverseDirection(): Vector3;
+    /**
+     * @internal
+     */
+    _appendData(lightIndex: number, data: ISpotLightShaderData): void;
+    /**
+     * @internal
+     */
+    _onEnableInScene(): void;
+    /**
+     * @internal
+     */
+    _onDisableInScene(): void;
 }
 /**
  * Shader properties data of spot lights in the scene.

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

@@ -75,5 +75,9 @@ export declare class AmbientOcclusion {
     get minHorizonAngle(): number;
     set minHorizonAngle(value: number);
     constructor(scene: Scene);
+    /**
+     * @internal
+     */
+    _isValid(): boolean;
     private _toggleAmbientOcclusionMacro;
 }

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

@@ -1 +1,38 @@
-export {};
+import { Camera } from "../../Camera";
+import { Engine } from "../../Engine";
+import { PipelinePass } from "../../RenderPipeline/PipelinePass";
+import { RenderContext } from "../../RenderPipeline/RenderContext";
+import { RenderTarget } from "../../texture";
+/**
+ * @internal
+ * Scalable Ambient Obscurance render pass.
+ */
+export declare class ScalableAmbientObscurancePass extends PipelinePass {
+    static readonly SHADER_NAME = "Lighting/ScalableAmbientOcclusion";
+    private static _invRadiusSquaredProp;
+    private static _intensityProp;
+    private static _projectionScaleRadiusProp;
+    private static _biasProp;
+    private static _minHorizonAngleSineSquaredProp;
+    private static _peak2Prop;
+    private static _powerProp;
+    private static _invProjScaleXYProp;
+    readonly isSupported: boolean;
+    private static _farPlaneOverEdgeDistanceProp;
+    private static _kernelProp;
+    private readonly _material;
+    private _saoRenderTarget?;
+    private _depthRenderTarget;
+    private _blurRenderTarget;
+    private _aoSpiralSampleCount;
+    private _blurStepPixels;
+    private _invProjScaleXY;
+    private _offsetX;
+    private _offsetY;
+    private _quality;
+    constructor(engine: Engine);
+    onConfig(camera: Camera, depthRenderTarget: RenderTarget): void;
+    onRender(context: RenderContext): void;
+    release(): void;
+    private _updateBlurKernel;
+}