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

package/types/material/BaseMaterial.d.ts

@@ -5,6 +5,10 @@ import { BlendMode } from "./enums/BlendMode";
 import { RenderFace } from "./enums/RenderFace";
 import { Material } from "./Material";
 export declare class BaseMaterial extends Material {
+    /** @internal */
+    static _shadowCasterRenderQueueProp: ShaderProperty;
+    /** @internal */
+    static _depthOnlyRenderQueueProp: ShaderProperty;
     protected static _baseTextureMacro: ShaderMacro;
     protected static _normalTextureMacro: ShaderMacro;
     protected static _emissiveTextureMacro: ShaderMacro;

package/types/material/Material.d.ts

@@ -9,6 +9,8 @@ import { ShaderData } from "../shader/ShaderData";
 export declare class Material extends ReferResource implements IClone {
     /** Name. */
     name: string;
+    /** @internal */
+    _shader: Shader;
     private _shaderData;
     /**
      *  Shader data.

package/types/mesh/BlendShape.d.ts

@@ -1,4 +1,5 @@
 import { Vector3 } from "@galacean/engine-math";
+import { UpdateFlagManager } from "../UpdateFlagManager";
 import { BlendShapeFrame } from "./BlendShapeFrame";
 /**
  * BlendShape.
@@ -6,6 +7,14 @@ import { BlendShapeFrame } from "./BlendShapeFrame";
 export declare class BlendShape {
     /** Name of BlendShape. */
     name: string;
+    /** @internal */
+    _useBlendShapeNormal: boolean;
+    /** @internal */
+    _useBlendShapeTangent: boolean;
+    /** @internal */
+    _layoutChangeManager: UpdateFlagManager;
+    /** @internal */
+    _dataChangeManager: UpdateFlagManager;
     private _frames;
     /**
      * Frames of BlendShape.
@@ -33,6 +42,10 @@ export declare class BlendShape {
      * Clear all frames.
      */
     clearFrames(): void;
+    /**
+     * @internal
+     */
+    _releaseData(): void;
     private _addFrame;
     private _updateUseNormalAndTangent;
     private _frameDataChangeListener;

package/types/mesh/BlendShapeFrame.d.ts

@@ -1,10 +1,13 @@
 import { Vector3 } from "@galacean/engine-math";
+import { UpdateFlagManager } from "../UpdateFlagManager";
 /**
  * BlendShapeFrame.
  */
 export declare class BlendShapeFrame {
     /** Weight of BlendShapeFrame. */
     readonly weight: number;
+    /** @internal */
+    _dataChangeManager: UpdateFlagManager;
     private _dirty;
     private _deltaPositions;
     private _deltaNormals;
@@ -35,6 +38,10 @@ export declare class BlendShapeFrame {
      * @param deltaTangents - Delta tangents for the frame being added
      */
     constructor(weight: number, deltaPositions: Vector3[], deltaNormals?: Vector3[], deltaTangents?: Vector3[]);
+    /**
+     * @internal
+     */
+    _releaseData(): void;
 }
 export declare enum BlendShapeFrameDirty {
     Position = 1,

package/types/mesh/BlendShapeManager.d.ts

@@ -1 +1,101 @@
-export {};
+import { BoolUpdateFlag } from "../BoolUpdateFlag";
+import { Engine } from "../Engine";
+import { Buffer } from "../graphic/Buffer";
+import { ShaderData } from "../shader/ShaderData";
+import { Texture2DArray } from "../texture";
+import { BlendShape } from "./BlendShape";
+import { ModelMesh } from "./ModelMesh";
+import { SkinnedMeshRenderer } from "./SkinnedMeshRenderer";
+/**
+ * @internal
+ */
+export declare class BlendShapeManager {
+    private static _blendShapeMacro;
+    private static _blendShapeTextureMacro;
+    private static _blendShapeNormalMacro;
+    private static _blendShapeTangentMacro;
+    private static _blendShapeWeightsProperty;
+    private static _blendShapeTextureProperty;
+    private static _blendShapeTextureInfoProperty;
+    /** @internal */
+    _blendShapeCount: number;
+    /** @internal */
+    _blendShapes: BlendShape[];
+    /** @internal */
+    _subDataDirtyFlags: BoolUpdateFlag[];
+    /** @internal */
+    _vertexTexture: Texture2DArray;
+    /** @internal */
+    _vertexBuffers: Buffer[];
+    /** @internal */
+    _vertices: Float32Array;
+    /** @internal */
+    _uniformOccupiesCount: number;
+    /** @internal */
+    _bufferBindingOffset: number;
+    /** @internal */
+    _vertexElementOffset: number;
+    private _useBlendNormal;
+    private _useBlendTangent;
+    private _vertexElementCount;
+    private _storeInVertexBufferInfo;
+    private _maxCountSingleVertexBuffer;
+    private readonly _engine;
+    private readonly _modelMesh;
+    private readonly _lastHostCreatedInfo;
+    private readonly _canUseTextureStoreData;
+    private readonly _dataTextureInfo;
+    constructor(engine: Engine, modelMesh: ModelMesh);
+    /**
+     * @internal
+     */
+    _addBlendShape(blendShape: BlendShape): void;
+    /**
+     * @internal
+     */
+    _clearBlendShapes(): void;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData, skinnedMeshRenderer: SkinnedMeshRenderer): void;
+    /**
+     * @internal
+     */
+    _useTextureMode(): boolean;
+    /**
+     * @internal
+     */
+    _isCreateHost(vertexCount: number): boolean;
+    /**
+     * @internal
+     */
+    _vertexElementsNeedUpdate(): boolean;
+    /**
+     * @internal
+     */
+    _needUpdateData(): boolean;
+    private _updateVertexBufferIndex;
+    /**
+     * @internal
+     */
+    _addVertexElements(modelMesh: ModelMesh): number;
+    /**
+     * @internal
+     */
+    _update(noLongerReadable: boolean): void;
+    /**
+     * @internal
+     */
+    _releaseMemoryCache(): void;
+    private _createVertexBuffers;
+    private _createTextureArray;
+    /**
+     * @internal
+     */
+    _updateVertexBuffers(vertexCount: number, force: boolean): void;
+    private _updateTextureArray;
+    private _updateLayoutChange;
+    private _attributeModeUpdateVertexElement;
+    private _getVertexBufferModeSupportCount;
+    private _filterCondensedBlendShapeWeights;
+}

package/types/mesh/MeshRenderer.d.ts

@@ -1,14 +1,23 @@
+import { BoundingBox } from "@galacean/engine-math";
+import { Entity } from "../Entity";
+import { RenderContext } from "../RenderPipeline/RenderContext";
+import { RenderElement } from "../RenderPipeline/RenderElement";
 import { Renderer } from "../Renderer";
 import { Mesh } from "../graphic/Mesh";
+import { ShaderMacro } from "../shader/ShaderMacro";
 /**
  * MeshRenderer Component.
  */
 export declare class MeshRenderer extends Renderer {
+    /** @internal */
+    static _enableVertexColorMacro: ShaderMacro;
     private static _uvMacro;
     private static _uv1Macro;
     private static _normalMacro;
     private static _tangentMacro;
     private _enableVertexColor;
+    /** @internal */
+    _mesh: Mesh;
     /**
      * Mesh assigned to the renderer.
      */
@@ -19,10 +28,38 @@ export declare class MeshRenderer extends Renderer {
      */
     get enableVertexColor(): boolean;
     set enableVertexColor(value: boolean);
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    protected _onDestroy(): void;
     /**
      * @inheritdoc
      */
     _onClone(target: MeshRenderer): void;
+    /**
+     * @internal
+     */
+    _prepareRender(context: RenderContext): void;
+    /**
+     * @internal
+     */
+    protected _updateBounds(worldBounds: BoundingBox): void;
+    /**
+     * @internal
+     */
+    protected _render(context: RenderContext): void;
+    /**
+     * @internal
+     */
+    _canBatch(preElement: RenderElement, curElement: RenderElement): boolean;
+    /**
+     * @internal
+     */
+    _batch(preElement: RenderElement | null, curElement: RenderElement): void;
     private _setMesh;
     private _onMeshChanged;
 }

package/types/mesh/ModelMesh.d.ts

@@ -1,10 +1,12 @@
 import { Color, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
 import { Engine } from "../Engine";
+import { DataType, TypedArray } from "../base";
 import { Buffer } from "../graphic/Buffer";
 import { Mesh } from "../graphic/Mesh";
 import { VertexBufferBinding } from "../graphic/VertexBufferBinding";
 import { VertexElement } from "../graphic/VertexElement";
 import { BlendShape } from "./BlendShape";
+import { BlendShapeManager } from "./BlendShapeManager";
 import { VertexAttribute } from "./enums/VertexAttribute";
 /**
  * Mesh containing common vertex elements of the model.
@@ -15,6 +17,10 @@ export declare class ModelMesh extends Mesh {
     private static _tempVec2;
     private static _tempVec3;
     private static _tempVec4;
+    /** @internal */
+    _blendShapeManager: BlendShapeManager;
+    /** @internal */
+    _internalVertexBufferIndex: number;
     private _vertexCount;
     private _vertexCountDirty;
     private _dataVersionCounter;
@@ -222,6 +228,18 @@ export declare class ModelMesh extends Mesh {
      * @remark based on http://foundationsofgameenginedev.com/FGED2-sample.pdf
      */
     calculateTangents(): void;
+    /**
+     * @internal
+     */
+    _setVertexBufferBinding(index: number, binding: VertexBufferBinding): void;
+    /**
+     * @internal
+     */
+    _getVertexTypedArray(vertexDataBuffer: ArrayBufferLike, dataType: DataType): TypedArray;
+    /**
+     * @internal
+     */
+    protected _onDestroy(): void;
     private _getVertexElementData;
     private _beforeSetAdvancedVertexData;
     private _updateAdvancedVertexDataMarks;

package/types/mesh/PrimitiveMesh.d.ts

@@ -40,10 +40,10 @@ export declare class PrimitiveMesh {
      */
     static createCuboid(engine: Engine, width?: number, height?: number, depth?: number, noLongerAccessible?: boolean): ModelMesh;
     /**
-     * Create a plane mesh.
+     * Create a plane mesh with U mapped along local +X and V along local +Z.
      * @param engine - Engine
-     * @param width - Plane width
-     * @param height - Plane height
+     * @param width - Plane width along the local X axis
+     * @param height - Plane height along the local Z axis
      * @param horizontalSegments - Plane horizontal segments
      * @param verticalSegments - Plane vertical segments
      * @param noLongerAccessible - No longer access the vertices of the mesh after creation
@@ -96,6 +96,18 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    /**
+     * @internal
+     */
+    static _setSubdivisionSurfaceSphereData(sphereMesh: ModelMesh, radius: number, step: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
+    /**
+     * @internal
+     */
+    static _setSphereData(sphereMesh: ModelMesh, radius: number, segments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
+    /**
+     * @internal
+     */
+    static _subdiveCatmullClark(step: number, positions: Float32Array, cells: Float32Array): void;
     /**
      * Duplicate vertices at the poles and adjust their UV coordinates.
      */
@@ -104,7 +116,23 @@ export declare class PrimitiveMesh {
      * Get edge point index for subdivision surface sphere.
      */
     private static _calculateEdgeIndex;
+    /**
+     * @internal
+     */
+    static _setCuboidData(cuboidMesh: ModelMesh, width: number, height: number, depth: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
+    /**
+     * @internal
+     */
+    static _setPlaneData(planeMesh: ModelMesh, width: number, height: number, horizontalSegments: number, verticalSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
     static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
+    /**
+     * @internal
+     */
+    static _setTorusData(torusMesh: ModelMesh, radius: number, tubeRadius: number, radialSegments: number, tubularSegments: number, arc: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
+    /**
+     * @internal
+     */
+    static _setConeData(coneMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
     static _setCapsuleData(capsuleMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
     private static _initialize;
     private static _generateIndices;

package/types/mesh/PrimitiveMeshRestorer.d.ts

@@ -1 +1,108 @@
+import { ContentRestorer } from "../asset/ContentRestorer";
+import { Buffer } from "../graphic/Buffer";
+import { ModelMesh } from "./ModelMesh";
+/**
+ * @internal
+ */
+export declare class PrimitiveMeshRestorer extends ContentRestorer<ModelMesh> {
+    primitiveInfo: PrimitiveRestoreInfo;
+    constructor(resource: ModelMesh, primitiveInfo: PrimitiveRestoreInfo);
+    restoreContent(): void;
+}
+declare enum PrimitiveType {
+    Sphere = 0,
+    Cuboid = 1,
+    Plane = 2,
+    Cylinder = 3,
+    Torus = 4,
+    Cone = 5,
+    Capsule = 6,
+    CCSphere = 7
+}
+/**
+ * @internal
+ */
+export declare class PrimitiveRestoreInfo {
+    type: PrimitiveType;
+    vertexBuffer: Buffer;
+    noLongerAccessible: boolean;
+    constructor(type: PrimitiveType, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class SphereRestoreInfo extends PrimitiveRestoreInfo {
+    radius: number;
+    segments: number;
+    constructor(radius: number, segments: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class SubdivisionSurfaceSphereRestoreInfo extends PrimitiveRestoreInfo {
+    radius: number;
+    step: number;
+    constructor(radius: number, step: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class CuboidRestoreInfo extends PrimitiveRestoreInfo {
+    width: number;
+    height: number;
+    depth: number;
+    constructor(width: number, height: number, depth: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class PlaneRestoreInfo extends PrimitiveRestoreInfo {
+    width: number;
+    height: number;
+    horizontalSegments: number;
+    verticalSegments: number;
+    constructor(width: number, height: number, horizontalSegments: number, verticalSegments: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class CylinderRestoreInfo extends PrimitiveRestoreInfo {
+    radiusTop: number;
+    radiusBottom: number;
+    height: number;
+    radialSegments: number;
+    heightSegments: number;
+    constructor(radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class TorusRestoreInfo extends PrimitiveRestoreInfo {
+    radius: number;
+    tubeRadius: number;
+    radialSegments: number;
+    tubularSegments: number;
+    arc: number;
+    constructor(radius: number, tubeRadius: number, radialSegments: number, tubularSegments: number, arc: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class ConeRestoreInfo extends PrimitiveRestoreInfo {
+    radius: number;
+    height: number;
+    radialSegments: number;
+    heightSegments: number;
+    constructor(radius: number, height: number, radialSegments: number, heightSegments: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
+/**
+ * @internal
+ */
+export declare class CapsuleRestoreInfo extends PrimitiveRestoreInfo {
+    radius: number;
+    height: number;
+    radialSegments: number;
+    heightSegments: number;
+    constructor(radius: number, height: number, radialSegments: number, heightSegments: number, vertexBuffer: Buffer, noLongerAccessible: boolean);
+}
 export {};

package/types/mesh/Skin.d.ts

@@ -1,6 +1,8 @@
 import { Matrix } from "@galacean/engine-math";
 import { Entity } from "../Entity";
+import { UpdateFlagManager } from "../UpdateFlagManager";
 import { DataObject } from "../base/DataObject";
+import { SkinnedMeshRenderer } from "./SkinnedMeshRenderer";
 /**
  * Skin used for skinned mesh renderer.
  */
@@ -8,6 +10,10 @@ export declare class Skin extends DataObject {
     name: string;
     /** Inverse bind matrices. */
     inverseBindMatrices: Matrix[];
+    /** @internal */
+    _skinMatrices: Float32Array;
+    /** @internal */
+    _updatedManager: UpdateFlagManager;
     private _rootBone;
     private _bones;
     private _updateMark;
@@ -22,6 +28,10 @@ export declare class Skin extends DataObject {
     get bones(): ReadonlyArray<Entity>;
     set bones(value: ReadonlyArray<Entity>);
     constructor(name: string);
+    /**
+     * @internal
+     */
+    _updateSkinMatrices(renderer: SkinnedMeshRenderer): void;
     /** @deprecated Please use `bones` instead. */
     joints: string[];
     /** @deprecated Please use `rootBone` instead. */

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -1,15 +1,20 @@
 import { BoundingBox } from "@galacean/engine-math";
 import { Entity } from "../Entity";
 import { RenderContext } from "../RenderPipeline/RenderContext";
+import { RenderElement } from "../RenderPipeline/RenderElement";
 import { MeshRenderer } from "./MeshRenderer";
 import { Skin } from "./Skin";
 /**
  * SkinnedMeshRenderer.
  */
 export declare class SkinnedMeshRenderer extends MeshRenderer {
+    /** @internal */
+    static _baseVertexUniformVectorCount: number;
     private static _jointCountProperty;
     private static _jointSamplerProperty;
     private static _jointMatrixProperty;
+    /** @internal */
+    _condensedBlendShapeWeights: Float32Array;
     private _localBounds;
     private _jointDataCreateCache;
     private _blendShapeWeights;
@@ -32,11 +37,27 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
      */
     get localBounds(): BoundingBox;
     set localBounds(value: BoundingBox);
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _canBatch(_preElement: RenderElement, _curElement: RenderElement): boolean;
+    /**
+     * @internal
+     */
+    _onDestroy(): void;
     /**
      * @inheritdoc
      */
     _onClone(target: SkinnedMeshRenderer): void;
     protected _update(context: RenderContext): void;
+    /**
+     * @internal
+     */
+    protected _updateBounds(worldBounds: BoundingBox): void;
     private _checkBlendShapeWeightLength;
     private _onLocalBoundsChanged;
     private _onSkinUpdated;

package/types/particle/ParticleBufferUtils.d.ts

@@ -1 +1,26 @@
-export {};
+import { Engine } from "../Engine";
+import { IndexBufferBinding } from "../graphic/IndexBufferBinding";
+import { VertexBufferBinding } from "../graphic/VertexBufferBinding";
+import { VertexElement } from "../graphic/VertexElement";
+/**
+ * @internal
+ */
+export declare class ParticleBufferUtils {
+    static readonly feedbackVertexStride = 24;
+    static readonly feedbackVertexElements: VertexElement[];
+    static readonly feedbackInstanceElements: VertexElement[];
+    static readonly instanceVertexStride = 168;
+    static readonly instanceVertexFloatStride: number;
+    static readonly startLifeTimeOffset = 3;
+    static readonly timeOffset = 7;
+    static readonly simulationUVOffset = 34;
+    static readonly billboardIndexCount = 6;
+    static readonly boundsFloatStride = 8;
+    static readonly boundsTimeOffset = 6;
+    static readonly boundsMaxLifetimeOffset = 7;
+    readonly billboardVertexElement: VertexElement;
+    readonly instanceVertexElements: VertexElement[];
+    readonly billboardVertexBufferBinding: VertexBufferBinding;
+    readonly billboardIndexBufferBinding: IndexBufferBinding;
+    constructor(engine: Engine);
+}