@galacean/engine-core 1.2.0-alpha.0 → 1.2.0-alpha.10

package/package.json

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

package/types/2d/atlas/types.d.ts

@@ -64,4 +64,6 @@ export interface AtlasSprite {
         w: number;
     };
     pixelsPerUnit: number;
+    width: number;
+    height: number;
 }

package/types/2d/text/TextRenderer.d.ts

@@ -108,4 +108,5 @@ export declare class TextRenderer extends Renderer {
     private _resetSubFont;
     private _updatePosition;
     private _updateLocalData;
+    private _isTextNoVisible;
 }

package/types/Camera.d.ts

@@ -37,18 +37,18 @@ export declare class Camera extends Component {
     depthTextureMode: DepthTextureMode;
     private _priority;
     private _shaderData;
-    private _isProjMatSetting;
+    private _isCustomViewMatrix;
+    private _isCustomProjectionMatrix;
     private _nearClipPlane;
     private _farClipPlane;
     private _fieldOfView;
     private _orthographicSize;
     private _isProjectionDirty;
     private _isInvProjMatDirty;
-    private _isFrustumProjectDirty;
     private _customAspectRatio;
     private _renderTarget;
     private _depthBufferParams;
-    private _frustumViewChangeFlag;
+    private _frustumChangeFlag;
     private _transform;
     private _isViewMatrixDirty;
     private _isInvViewProjDirty;
@@ -112,12 +112,13 @@ export declare class Camera extends Component {
      * View matrix.
      */
     get viewMatrix(): Readonly<Matrix>;
+    set viewMatrix(value: Matrix);
     /**
      * The projection matrix is ​​calculated by the relevant parameters of the camera by default.
      * If it is manually set, the manual value will be maintained. Call resetProjectionMatrix() to restore it.
      */
+    get projectionMatrix(): Readonly<Matrix>;
     set projectionMatrix(value: Matrix);
-    get projectionMatrix(): Matrix;
     /**
      * Whether to enable HDR.
      * @todo When render pipeline modification
@@ -129,6 +130,10 @@ export declare class Camera extends Component {
      */
     get renderTarget(): RenderTarget | null;
     set renderTarget(value: RenderTarget | null);
+    /**
+     * Restore the view matrix to the world matrix of the entity.
+     */
+    resetViewMatrix(): void;
     /**
      * Restore the automatic calculation of projection matrix through fieldOfView, nearClipPlane and farClipPlane.
      */
@@ -237,7 +242,8 @@ export declare class Camera extends Component {
      */
     _onDisableInScene(): void;
     private _updatePixelViewport;
-    private _projMatChange;
+    private _viewMatrixChange;
+    private _projectionMatrixChange;
     private _innerViewportToWorldPoint;
     private _updateShaderData;
     /**

package/types/Canvas.d.ts

@@ -14,5 +14,6 @@ export declare abstract class Canvas {
      */
     get height(): number;
     set height(value: number);
-    protected abstract _onSizeChanged(width: number, height: number): void;
+    protected abstract _onWidthChanged(value: number): void;
+    protected abstract _onHeightChange(value: number): void;
 }

package/types/Engine.d.ts

@@ -1,4 +1,4 @@
-import { IHardwareRenderer, IPhysics, IShaderLab, IXRDevice } from "@galacean/engine-design";
+import { IHardwareRenderer, IInputOptions, IPhysics, IShaderLab, IXRDevice } from "@galacean/engine-design";
 import { Canvas } from "./Canvas";
 import { EngineSettings } from "./EngineSettings";
 import { Entity } from "./Entity";
@@ -136,6 +136,8 @@ export interface EngineConfiguration {
     xrDevice?: IXRDevice;
     /** Color space. */
     colorSpace?: ColorSpace;
-    /** Shader lab */
+    /** Shader lab. */
     shaderLab?: IShaderLab;
+    /** Input options. */
+    input?: IInputOptions;
 }

package/types/Scene.d.ts

@@ -30,6 +30,11 @@ export declare class Scene extends EngineObject {
     shadowFourCascadeSplits: Vector3;
     /** Max Shadow distance. */
     shadowDistance: number;
+    /**
+     * Last shadow fade distance in percentage, range [0,1].
+     * @remarks Value 0 is used for no shadow fade.
+     */
+    shadowFadeBorder: number;
     private _background;
     private _shaderData;
     private _shadowCascades;

package/types/SystemInfo.d.ts

@@ -7,6 +7,8 @@ export declare class SystemInfo {
     static platform: Platform;
     /** The operating system is running on. */
     static operatingSystem: string;
+    /** Whether the system support SIMD. */
+    private static _simdSupported;
     /**
      * The pixel ratio of the device.
      */

package/types/Utils.d.ts

@@ -15,6 +15,12 @@ export declare class Utils {
      * @returns Whether the url is absolute url.
      */
     static isAbsoluteUrl(url: string): boolean;
+    /**
+     * Judge whether the url is base64 url.
+     * @param url - The url to be judged.
+     * @returns Whether the url is base64 url.
+     */
+    static isBase64Url(url: string): boolean;
     /**
      * Get the values of an object.
      */

package/types/asset/AssetType.d.ts

@@ -39,6 +39,8 @@ export declare enum AssetType {
     KTX2 = "KTX2",
     /** Sprite. */
     Sprite = "Sprite",
+    /** PrimitiveMesh. */
+    PrimitiveMesh = "PrimitiveMesh",
     /** Sprite Atlas. */
     SpriteAtlas = "SpriteAtlas",
     /** Ambient light. */

package/types/asset/Loader.d.ts

@@ -24,7 +24,14 @@ export declare abstract class Loader<T> {
     static getClass(className: string): {
         new (...args: any): any;
     };
+    /**
+     * Get the class name by class object.
+     * @param obj - class object
+     * @returns class name
+     */
+    static getClassName(obj: Object): string;
     private static _engineObjects;
+    private static _classNameMap;
     constructor(useCache: boolean);
     initialize?(engine: Engine, configuration: EngineConfiguration): Promise<void>;
     abstract load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<T>;

package/types/asset/ResourceManager.d.ts

@@ -15,6 +15,8 @@ export declare class ResourceManager {
     retryInterval: number;
     /** The default timeout period for loading assets, in milliseconds. */
     timeout: number;
+    /** Base url for loading assets. */
+    baseUrl: string | null;
     private _loadingPromises;
     /** Asset path pool, key is the `instanceID` of resource, value is asset path. */
     private _assetPool;

package/types/input/InputManager.d.ts

@@ -62,6 +62,4 @@ export declare class InputManager {
      * @returns Whether the pointer is released during the current frame
      */
     isPointerUp(pointerButton?: PointerButton): boolean;
-    private _onBlur;
-    private _onFocus;
 }

package/types/input/interface/IInput.d.ts

@@ -7,12 +7,4 @@ export interface IInput {
      * Function called when the engine is destroyed.
      */
     _destroy(): void;
-    /**
-     * Function called when focused.
-     */
-    _onFocus(): void;
-    /**
-     * Function called when focus is lost.
-     */
-    _onBlur(): void;
 }

package/types/mesh/PrimitiveMesh.d.ts

@@ -6,6 +6,10 @@ import { ModelMesh } from "./ModelMesh";
  */
 export declare class PrimitiveMesh {
     private static _tempVec30;
+    private static readonly _sphereSeedPositions;
+    private static readonly _sphereSeedCells;
+    private static _sphereEdgeIdx;
+    private static _spherePoleIdx;
     /**
      * Create a sphere mesh.
      * @param engine - Engine
@@ -15,6 +19,16 @@ export declare class PrimitiveMesh {
      * @returns Sphere model mesh
      */
     static createSphere(engine: Engine, radius?: number, segments?: number, noLongerAccessible?: boolean): ModelMesh;
+    /**
+     * Create a sphere mesh by implementing Catmull-Clark Surface Subdivision Algorithm.
+     * Max step is limited to 6.
+     * @param engine - Engine
+     * @param radius - Sphere radius
+     * @param step - Number of subdiv steps
+     * @param noLongerAccessible - No longer access the vertices of the mesh after creation
+     * @returns Sphere model mesh
+     */
+    static createSubdivisionSurfaceSphere(engine: Engine, radius?: number, step?: number, noLongerAccessible?: boolean): ModelMesh;
     /**
      * Create a cuboid mesh.
      * @param engine - Engine
@@ -82,6 +96,14 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    /**
+     * Duplicate vertices at the poles and adjust their UV coordinates.
+     */
+    private static _generateAndReplacePoleUV;
+    /**
+     * Get edge point index for subdivision surface sphere.
+     */
+    private static _calculateEdgeIndex;
     static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: 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;

package/types/particle/modules/MainModule.d.ts

@@ -1,3 +1,4 @@
+import { Rand } from "@galacean/engine-math";
 import { ICustomClone } from "../../clone/ComponentCloner";
 import { ParticleScaleMode } from "../enums/ParticleScaleMode";
 import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
@@ -54,6 +55,7 @@ export declare class MainModule implements ICustomClone {
     scalingMode: ParticleScaleMode;
     /** If set to true, the Particle Generator automatically begins to play on startup. */
     playOnEnabled: boolean;
+    readonly _gravityModifierRand: Rand;
     private _generator;
     private _gravity;
     /**

package/types/particle/modules/shape/BaseShape.d.ts

@@ -4,9 +4,9 @@ import { ParticleShapeType } from "./enums/ParticleShapeType";
  */
 export declare abstract class BaseShape {
     /** The type of shape to emit particles from. */
-    shapeType: ParticleShapeType;
+    abstract readonly shapeType: ParticleShapeType;
     /** Specifies whether the ShapeModule is enabled or disabled. */
-    enable: boolean;
+    enabled: boolean;
     /** Randomizes the starting direction of particles. */
     randomDirectionAmount: number;
 }

package/types/particle/modules/shape/BoxShape.d.ts

@@ -1,11 +1,12 @@
 import { Vector3 } from "@galacean/engine-math";
 import { BaseShape } from "./BaseShape";
+import { ParticleShapeType } from "./enums/ParticleShapeType";
 /**
  * Particle shape that emits particles from a box.
  */
 export declare class BoxShape extends BaseShape {
     private static _tempVector30;
+    readonly shapeType = ParticleShapeType.Box;
     /** The size of the box. */
     size: Vector3;
-    constructor();
 }

package/types/particle/modules/shape/CircleShape.d.ts

@@ -1,10 +1,12 @@
 import { BaseShape } from "./BaseShape";
 import { ParticleShapeArcMode } from "./enums/ParticleShapeArcMode";
+import { ParticleShapeType } from "./enums/ParticleShapeType";
 /**
  * Particle shape that emits particles from a circle.
  */
 export declare class CircleShape extends BaseShape {
     private static _tempPositionPoint;
+    readonly shapeType = ParticleShapeType.Circle;
     /** Radius of the shape to emit particles from. */
     radius: number;
     /** Angle of the circle arc to emit particles from. */
@@ -13,5 +15,4 @@ export declare class CircleShape extends BaseShape {
     arcMode: ParticleShapeArcMode;
     /** The speed of complete 360 degree rotation. */
     arcSpeed: number;
-    constructor();
 }

package/types/particle/modules/shape/ConeShape.d.ts

@@ -1,4 +1,5 @@
 import { BaseShape } from "./BaseShape";
+import { ParticleShapeType } from "./enums/ParticleShapeType";
 /**
  * Cone shape.
  */
@@ -7,6 +8,7 @@ export declare class ConeShape extends BaseShape {
     private static _tempVector21;
     private static _tempVector30;
     private static _tempVector31;
+    readonly shapeType = ParticleShapeType.Cone;
     /** Angle of the cone to emit particles from. */
     angle: number;
     /** Radius of the shape to emit particles from. */
@@ -15,7 +17,6 @@ export declare class ConeShape extends BaseShape {
     length: number;
     /** Cone emitter type. */
     emitType: ConeEmitType;
-    constructor();
 }
 /**
  * Cone emitter type.

package/types/particle/modules/shape/HemisphereShape.d.ts

@@ -1,9 +1,10 @@
 import { BaseShape } from "./BaseShape";
+import { ParticleShapeType } from "./enums/ParticleShapeType";
 /**
  * Particle shape that emits particles from a hemisphere.
  */
 export declare class HemisphereShape extends BaseShape {
+    readonly shapeType = ParticleShapeType.Hemisphere;
     /** Radius of the shape to emit particles from. */
     radius: number;
-    constructor();
 }

package/types/particle/modules/shape/SphereShape.d.ts

@@ -1,9 +1,10 @@
 import { BaseShape } from "./BaseShape";
+import { ParticleShapeType } from "./enums/ParticleShapeType";
 /**
  * Particle shape that emits particles from a sphere.
  */
 export declare class SphereShape extends BaseShape {
+    readonly shapeType = ParticleShapeType.Sphere;
     /** Radius of the shape to emit particles from. */
     radius: number;
-    constructor();
 }

package/types/particle/modules/shape/index.d.ts

@@ -4,3 +4,4 @@ export { ConeShape, ConeEmitType } from "./ConeShape";
 export { HemisphereShape } from "./HemisphereShape";
 export { SphereShape } from "./SphereShape";
 export { ParticleShapeArcMode } from "./enums/ParticleShapeArcMode";
+export { ParticleShapeType } from "./enums/ParticleShapeType";

package/types/physics/HitResult.d.ts

@@ -1,5 +1,6 @@
 import { Entity } from "../Entity";
 import { Vector3 } from "@galacean/engine-math";
+import { ColliderShape } from "./shape";
 /**
  * Structure used to get information back from a raycast or a sweep.
  */
@@ -12,4 +13,6 @@ export declare class HitResult {
     point: Vector3;
     /** The normal of the surface the ray hit. */
     normal: Vector3;
+    /** The shape of the collider that was hit. */
+    shape: ColliderShape;
 }

package/types/shaderlib/ShaderFactory.d.ts

@@ -1,7 +1,12 @@
 export declare class ShaderFactory {
     static parseCustomMacros(macros: string[]): string;
     static registerInclude(includeName: string, includeSource: string): void;
-    static parseIncludes(src: string): string;
+    static unRegisterInclude(includeName: string): void;
+    /**
+     * @param regex The default regex is for engine's builtin glsl `#include` syntax,
+     * since `ShaderLab` use the same parsing function but different syntax for `#include` --- `/^[ \t]*#include +"([\w\d.]+)"/gm`
+     */
+    static parseIncludes(src: string, regex?: RegExp): string;
     /**
      * Convert lower GLSL version to GLSL 300 es.
      * @param shader - code

package/types/shadow/CascadedShadowCasterPass.d.ts

@@ -28,7 +28,6 @@ export declare class CascadedShadowCasterPass extends PipelinePass {
     private _shadowSliceData;
     private _lightUp;
     private _lightSide;
-    private _existShadowMap;
     private _splitBoundSpheres;
     /** The end is project precision problem in shader. */
     private _shadowMatrices;

package/types/texture/Texture.d.ts

@@ -76,4 +76,5 @@ export declare abstract class Texture extends GraphicsResource {
      */
     protected _getMaxMiplevel(size: number): number;
     protected _getMipmapCount(): number;
+    protected _isIntFormat(): boolean;
 }

package/types/texture/enums/TextureFormat.d.ts

@@ -20,56 +20,58 @@ export declare enum TextureFormat {
     R16G16B16A16 = 7,
     /** RGBA format, 32 bits per channel. */
     R32G32B32A32 = 8,
+    /** RGBA unsigned integer format, 32 bits per channel. */
+    R32G32B32A32_UInt = 9,
     /** RGB compressed format, 4 bits per pixel. */
-    BC1 = 9,
+    BC1 = 10,
     /** RGBA compressed format, 8 bits per pixel. */
-    BC3 = 10,
+    BC3 = 11,
     /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
-    BC7 = 11,
+    BC7 = 12,
     /** RGB compressed format, 4 bits per pixel. */
-    ETC1_RGB = 12,
+    ETC1_RGB = 13,
     /** RGB compressed format, 4 bits per pixel. */
-    ETC2_RGB = 13,
+    ETC2_RGB = 14,
     /** RGBA compressed format, 5 bits per pixel, 4 bit in RGB, 1 bit in A. */
-    ETC2_RGBA5 = 14,
+    ETC2_RGBA5 = 15,
     /** RGB compressed format, 8 bits per pixel. */
-    ETC2_RGBA8 = 15,
+    ETC2_RGBA8 = 16,
     /** RGB compressed format, 2 bits per pixel. */
-    PVRTC_RGB2 = 16,
+    PVRTC_RGB2 = 17,
     /** RGBA compressed format, 2 bits per pixel. */
-    PVRTC_RGBA2 = 17,
+    PVRTC_RGBA2 = 18,
     /** RGB compressed format, 4 bits per pixel. */
-    PVRTC_RGB4 = 18,
+    PVRTC_RGB4 = 19,
     /** RGBA compressed format, 4 bits per pixel. */
-    PVRTC_RGBA4 = 19,
+    PVRTC_RGBA4 = 20,
     /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
-    ASTC_4x4 = 20,
+    ASTC_4x4 = 21,
     /** RGB(A) compressed format, 128 bits per 5x5 pixel block. */
-    ASTC_5x5 = 21,
+    ASTC_5x5 = 22,
     /** RGB(A) compressed format, 128 bits per 6x6 pixel block. */
-    ASTC_6x6 = 22,
+    ASTC_6x6 = 23,
     /** RGB(A) compressed format, 128 bits per 8x8 pixel block. */
-    ASTC_8x8 = 23,
+    ASTC_8x8 = 24,
     /** RGB(A) compressed format, 128 bits per 10x10 pixel block. */
-    ASTC_10x10 = 24,
+    ASTC_10x10 = 25,
     /** RGB(A) compressed format, 128 bits per 12x12 pixel block. */
-    ASTC_12x12 = 25,
+    ASTC_12x12 = 26,
     /** Automatic depth format, engine will automatically select the supported precision. */
-    Depth = 26,
+    Depth = 27,
     /** Automatic depth stencil format, engine will automatically select the supported precision. */
-    DepthStencil = 27,
+    DepthStencil = 28,
     /** 16-bit depth format. */
-    Depth16 = 28,
+    Depth16 = 29,
     /** 24-bit depth format. */
-    Depth24 = 29,
+    Depth24 = 30,
     /** 32-bit depth format. */
-    Depth32 = 30,
+    Depth32 = 31,
     /** 16-bit depth + 8-bit stencil format. */
-    Depth24Stencil8 = 31,
+    Depth24Stencil8 = 32,
     /** 32-bit depth + 8-bit stencil format. */
-    Depth32Stencil8 = 32,
+    Depth32Stencil8 = 33,
     /** @deprecated Use `TextureFormat.BC1` instead. */
-    DXT1 = 33,
+    DXT1 = 34,
     /** @deprecated Use `TextureFormat.BC3` instead. */
-    DXT5 = 34
+    DXT5 = 35
 }