@galacean/engine-core 1.2.0-alpha.11 → 1.2.0-alpha.12

package/package.json

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

package/types/Camera.d.ts

@@ -39,8 +39,6 @@ export declare class Camera extends Component {
     private _shaderData;
     private _isCustomViewMatrix;
     private _isCustomProjectionMatrix;
-    private _nearClipPlane;
-    private _farClipPlane;
     private _fieldOfView;
     private _orthographicSize;
     private _isProjectionDirty;

package/types/Deprecated.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @deprecated Please use `PixelFormat` instead.
+ * Defines various pixel formats.
+ */
+export declare enum TextureFormat {
+    /** RGB format, 8 bits per channel. */
+    R8G8B8 = 0,
+    /** RGBA format, 8 bits per channel. */
+    R8G8B8A8 = 1,
+    /** RGBA format, 4 bits per channel. */
+    R4G4B4A4 = 2,
+    /** RGBA format, 5 bits in R channel, 5 bits in G channel, 5 bits in B channel, 1 bit in A channel. */
+    R5G5B5A1 = 3,
+    /** RGB format, 5 bits in R channel, 6 bits in G channel, 5 bits in B channel. */
+    R5G6B5 = 4,
+    /** Transparent format, 8 bits. */
+    Alpha8 = 5,
+    /** Luminance/alpha in RGB channel, alpha in A channel. */
+    LuminanceAlpha = 6,
+    /** RGBA format, 16 bits per channel. */
+    R16G16B16A16 = 7,
+    /** RGBA format, 32 bits per channel. */
+    R32G32B32A32 = 8,
+    /** RGB compressed format, 4 bits per pixel. */
+    BC1 = 9,
+    /** RGBA compressed format, 8 bits per pixel. */
+    BC3 = 10,
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    BC7 = 11,
+    /** RGB compressed format, 4 bits per pixel. */
+    ETC1_RGB = 12,
+    /** RGB compressed format, 4 bits per pixel. */
+    ETC2_RGB = 13,
+    /** RGBA compressed format, 5 bits per pixel, 4 bit in RGB, 1 bit in A. */
+    ETC2_RGBA5 = 14,
+    /** RGB compressed format, 8 bits per pixel. */
+    ETC2_RGBA8 = 15,
+    /** RGB compressed format, 2 bits per pixel. */
+    PVRTC_RGB2 = 16,
+    /** RGBA compressed format, 2 bits per pixel. */
+    PVRTC_RGBA2 = 17,
+    /** RGB compressed format, 4 bits per pixel. */
+    PVRTC_RGB4 = 18,
+    /** RGBA compressed format, 4 bits per pixel. */
+    PVRTC_RGBA4 = 19,
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    ASTC_4x4 = 20,
+    /** RGB(A) compressed format, 128 bits per 5x5 pixel block. */
+    ASTC_5x5 = 21,
+    /** RGB(A) compressed format, 128 bits per 6x6 pixel block. */
+    ASTC_6x6 = 22,
+    /** RGB(A) compressed format, 128 bits per 8x8 pixel block. */
+    ASTC_8x8 = 23,
+    /** RGB(A) compressed format, 128 bits per 10x10 pixel block. */
+    ASTC_10x10 = 24,
+    /** RGB(A) compressed format, 128 bits per 12x12 pixel block. */
+    ASTC_12x12 = 25,
+    /** Automatic depth format, engine will automatically select the supported precision. */
+    Depth = 26,
+    /** Render to stencil buffer. */
+    Stencil = 27,
+    /** Automatic depth stencil format, engine will automatically select the supported precision. */
+    DepthStencil = 28,
+    /** 16-bit depth format. */
+    Depth16 = 29,
+    /** 24-bit depth format. */
+    Depth24 = 30,
+    /** 32-bit depth format. */
+    Depth32 = 31,
+    /** 16-bit depth + 8-bit stencil format. */
+    Depth24Stencil8 = 32,
+    /** 32-bit depth + 8-bit stencil format. */
+    Depth32Stencil8 = 33,
+    /** @deprecated Use `PixelFormat.BC1` instead. */
+    DXT1 = 9,
+    /** @deprecated Use `PixelFormat.BC3` instead. */
+    DXT5 = 10
+}
+/**
+ * @deprecated Use `PixelFormat` instead.
+ *
+ * Render buffer depth format enumeration.
+ */
+export declare enum RenderBufferDepthFormat {
+    /** Render to depth buffer,engine will automatically select the supported precision. */
+    Depth = 26,
+    /** Render to stencil buffer. */
+    Stencil = 27,
+    /** Render to depth stencil buffer, engine will automatically select the supported precision. */
+    DepthStencil = 28,
+    /** Force 16-bit depth buffer. */
+    Depth16 = 29,
+    /** Force 24-bit depth buffer. */
+    Depth24 = 30,
+    /** Force 32-bit depth buffer. */
+    Depth32 = 31,
+    /** Force 16-bit depth + 8-bit stencil buffer. */
+    Depth24Stencil8 = 32,
+    /** Force 32-bit depth + 8-bit stencil buffer. */
+    Depth32Stencil8 = 33
+}

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -65,5 +65,6 @@ export declare class BasicRenderPipeline {
     pushRenderData(context: RenderContext, data: RenderData): void;
     private pushRenderDataWithShader;
     private _drawBackgroundTexture;
-    private _callRender;
+    private _prepareRender;
+    private _updateMVPShaderData;
 }

package/types/RenderPipeline/OpaqueTexturePass.d.ts

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

package/types/enums/Downsampling.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Down sampling.
+ */
+export declare enum Downsampling {
+    /** No down sampling. */
+    None = 1,
+    /** Half resolution down sampling. */
+    TwoX = 2,
+    /** Quarter resolution down sampling. */
+    FourX = 4
+}

package/types/enums/MSAASamples.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Multi-sample anti-aliasing samples.
+ */
+export declare enum MSAASamples {
+    /** No multi-sample anti-aliasing. */
+    None = 1,
+    /** Multi-sample anti-aliasing with 2 samples. */
+    TwoX = 2,
+    /** Multi-sample anti-aliasing with 4 samples. */
+    FourX = 4,
+    /** Multi-sample anti-aliasing with 8 samples. */
+    EightX = 8
+}

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

@@ -0,0 +1,73 @@
+/**
+ * Defines various pixel formats.
+ */
+export declare enum PixelFormat {
+    /** RGB format, 8 bits per channel. */
+    R8G8B8 = 0,
+    /** RGBA format, 8 bits per channel. */
+    R8G8B8A8 = 1,
+    /** RGBA format, 4 bits per channel. */
+    R4G4B4A4 = 2,
+    /** RGBA format, 5 bits in R channel, 5 bits in G channel, 5 bits in B channel, 1 bit in A channel. */
+    R5G5B5A1 = 3,
+    /** RGB format, 5 bits in R channel, 6 bits in G channel, 5 bits in B channel. */
+    R5G6B5 = 4,
+    /** Transparent format, 8 bits. */
+    Alpha8 = 5,
+    /** Luminance/alpha in RGB channel, alpha in A channel. */
+    LuminanceAlpha = 6,
+    /** RGBA format, 16 bits per channel. */
+    R16G16B16A16 = 7,
+    /** RGBA format, 32 bits per channel. */
+    R32G32B32A32 = 8,
+    /** RGB compressed format, 4 bits per pixel. */
+    BC1 = 9,
+    /** RGBA compressed format, 8 bits per pixel. */
+    BC3 = 10,
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    BC7 = 11,
+    /** RGB compressed format, 4 bits per pixel. */
+    ETC1_RGB = 12,
+    /** RGB compressed format, 4 bits per pixel. */
+    ETC2_RGB = 13,
+    /** RGBA compressed format, 5 bits per pixel, 4 bit in RGB, 1 bit in A. */
+    ETC2_RGBA5 = 14,
+    /** RGB compressed format, 8 bits per pixel. */
+    ETC2_RGBA8 = 15,
+    /** RGB compressed format, 2 bits per pixel. */
+    PVRTC_RGB2 = 16,
+    /** RGBA compressed format, 2 bits per pixel. */
+    PVRTC_RGBA2 = 17,
+    /** RGB compressed format, 4 bits per pixel. */
+    PVRTC_RGB4 = 18,
+    /** RGBA compressed format, 4 bits per pixel. */
+    PVRTC_RGBA4 = 19,
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    ASTC_4x4 = 20,
+    /** RGB(A) compressed format, 128 bits per 5x5 pixel block. */
+    ASTC_5x5 = 21,
+    /** RGB(A) compressed format, 128 bits per 6x6 pixel block. */
+    ASTC_6x6 = 22,
+    /** RGB(A) compressed format, 128 bits per 8x8 pixel block. */
+    ASTC_8x8 = 23,
+    /** RGB(A) compressed format, 128 bits per 10x10 pixel block. */
+    ASTC_10x10 = 24,
+    /** RGB(A) compressed format, 128 bits per 12x12 pixel block. */
+    ASTC_12x12 = 25,
+    /** Automatic depth format, engine will automatically select the supported precision. */
+    Depth = 26,
+    /** Render to stencil buffer. */
+    Stencil = 27,
+    /** Automatic depth stencil format, engine will automatically select the supported precision. */
+    DepthStencil = 28,
+    /** 16-bit depth format. */
+    Depth16 = 29,
+    /** 24-bit depth format. */
+    Depth24 = 30,
+    /** 32-bit depth format. */
+    Depth32 = 31,
+    /** 16-bit depth + 8-bit stencil format. */
+    Depth24Stencil8 = 32,
+    /** 32-bit depth + 8-bit stencil format. */
+    Depth32Stencil8 = 33
+}

package/types/RenderPipeline/MeshRenderData.d.ts

@@ -1,17 +0,0 @@
-import { Mesh } from "../graphic/Mesh";
-import { SubMesh } from "../graphic/SubMesh";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { IPoolElement } from "./IPoolElement";
-import { RenderData } from "./RenderData";
-/**
- * Render element.
- */
-export declare class MeshRenderData extends RenderData implements IPoolElement {
-    /** Mesh. */
-    mesh: Mesh;
-    /** Sub mesh. */
-    subMesh: SubMesh;
-    set(component: Renderer, material: Material, mesh: Mesh, subMesh: SubMesh): void;
-    dispose(): void;
-}

package/types/RenderPipeline/MeshRenderElement.d.ts

@@ -1,19 +0,0 @@
-import { Mesh } from "../graphic/Mesh";
-import { SubMesh } from "../graphic/SubMesh";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { ShaderPass } from "../shader/ShaderPass";
-import { RenderState } from "../shader/state/RenderState";
-import { IPoolElement } from "./IPoolElement";
-import { RenderElement } from "./RenderElement";
-/**
- * Render element.
- */
-export declare class MeshRenderElement extends RenderElement implements IPoolElement {
-    /** Mesh. */
-    mesh: Mesh;
-    /** Sub mesh. */
-    subMesh: SubMesh;
-    setValue(component: Renderer, mesh: Mesh, subMesh: SubMesh, material: Material, renderState: RenderState, shaderPass: ShaderPass): void;
-    dispose(): void;
-}

package/types/RenderPipeline/SpriteElement.d.ts

@@ -1,15 +0,0 @@
-import { RenderData2D } from "../2d/data/RenderData2D";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { ShaderPass } from "../shader";
-import { RenderState } from "../shader/state/RenderState";
-import { Texture2D } from "../texture";
-import { IPoolElement } from "./IPoolElement";
-import { RenderElement } from "./RenderElement";
-export declare class SpriteElement extends RenderElement implements IPoolElement {
-    renderData: RenderData2D;
-    texture: Texture2D;
-    constructor();
-    setValue(component: Renderer, renderDate: RenderData2D, material: Material, texture: Texture2D, renderState: RenderState, shaderPass: ShaderPass): void;
-    dispose(): void;
-}

package/types/RenderPipeline/SpriteMaskElement.d.ts

@@ -1,12 +0,0 @@
-import { RenderData2D } from "../2d/data/RenderData2D";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { IPoolElement } from "./IPoolElement";
-import { RenderElement } from "./RenderElement";
-export declare class SpriteMaskElement extends RenderElement implements IPoolElement {
-    renderData: RenderData2D;
-    isAdd: boolean;
-    constructor();
-    setValue(component: Renderer, renderData: RenderData2D, material: Material): void;
-    dispose(): void;
-}

package/types/RenderPipeline/TextRenderElement.d.ts

@@ -1,8 +0,0 @@
-import { IPoolElement } from "./IPoolElement";
-import { RenderElement } from "./RenderElement";
-import { SpriteElement } from "./SpriteElement";
-export declare class TextRenderElement extends RenderElement implements IPoolElement {
-    charElements: SpriteElement[];
-    constructor();
-    dispose(): void;
-}

package/types/asset/IRefObject.d.ts

@@ -1,2 +0,0 @@
-export interface IRefObject {
-}

package/types/asset/RefObject.d.ts

@@ -1,27 +0,0 @@
-import { EngineObject } from "../base/EngineObject";
-import { Engine } from "../Engine";
-import { IRefObject } from "./IRefObject";
-/**
- * The base class of assets, with reference counting capability.
- */
-export declare abstract class RefObject extends EngineObject implements IRefObject {
-    /** Whether to ignore the garbage collection check, if it is true, it will not be affected by ResourceManager.gc(). */
-    isGCIgnored: boolean;
-    private _refCount;
-    /**
-     * Counted by valid references.
-     */
-    get refCount(): number;
-    protected constructor(engine: Engine);
-    /**
-     * Destroy self.
-     * @param force - Whether to force the destruction, if it is false, refCount = 0 can be released successfully.
-     * @returns Whether the release was successful.
-     */
-    destroy(force?: boolean): boolean;
-    /**
-     * Called when the resource is destroyed.
-     * Subclasses can override this function.
-     */
-    protected abstract _onDestroy(): void;
-}

package/types/base/Event.d.ts

@@ -1,24 +0,0 @@
-import { EventDispatcher } from "./EventDispatcher";
-export type Listener = ((e: Event) => any) & {
-    once?: boolean;
-};
-/** Event Object. * @class */
-export declare class Event {
-    get propagationStopped(): boolean;
-    get target(): EventDispatcher;
-    set target(t: EventDispatcher);
-    get timeStamp(): number;
-    get currentTarget(): EventDispatcher;
-    set currentTarget(t: EventDispatcher);
-    get bubbles(): boolean;
-    get type(): string | number;
-    data: any;
-    private _timeStamp;
-    private _target;
-    private _currentTarget;
-    private _bubbles;
-    private _propagationStopped;
-    private _type;
-    constructor(type: string | number, target?: EventDispatcher, data?: any, bubbles?: boolean);
-    stopPropagation(): void;
-}

package/types/base/Util.d.ts

@@ -1,14 +0,0 @@
-export declare const Util: {
-    isArray: (value: any) => boolean;
-    isArrayLike(x: any): boolean;
-    clone<T>(obj: T): T;
-    downloadBlob(blob: Blob, fileName?: string): void;
-};
-export declare const isArrayLike: <T>(x: any) => x is ArrayLike<T>;
-/**
- * Fastly remove an element from array.
- * @param array - Array
- * @param item - Element
- */
-export declare function removeFromArray(array: any[], item: any): boolean;
-export declare function ObjectValues(obj: any): any[];

package/types/physics/PhysicsManager.d.ts

@@ -1,78 +0,0 @@
-import { Ray, Vector3 } from "@galacean/engine-math";
-import { Engine } from "../Engine";
-import { Layer } from "../Layer";
-import { HitResult } from "./HitResult";
-/**
- * A physics manager is a collection of colliders and constraints which can interact.
- */
-export declare class PhysicsManager {
-    private static _collision;
-    private _engine;
-    private _restTime;
-    private _fixedTimeStep;
-    private _colliders;
-    private _gravity;
-    private _nativePhysicsManager;
-    private _physicalObjectsMap;
-    private _onContactEnter;
-    private _onContactExit;
-    private _onContactStay;
-    private _onTriggerEnter;
-    private _onTriggerExit;
-    private _onTriggerStay;
-    /**
-     * The gravity of physics scene.
-     */
-    get gravity(): Vector3;
-    set gravity(value: Vector3);
-    /** The fixed time step in seconds at which physics are performed. */
-    get fixedTimeStep(): number;
-    set fixedTimeStep(value: number);
-    constructor(engine: Engine);
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, outHitResult: HitResult): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number, outHitResult: HitResult): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number, layerMask: Layer): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false.
-     */
-    raycast(ray: Ray, distance: number, layerMask: Layer, outHitResult: HitResult): boolean;
-    private _setGravity;
-}