@galacean/engine-core 0.0.0-experimental-double11.4 → 0.0.0-experimental-double11.6

package/package.json

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

package/types/Background.d.ts

@@ -33,11 +33,19 @@ export declare class Background {
      */
     get texture(): Texture2D;
     set texture(value: Texture2D);
+    /**
+     * Background texture fill mode.
+     * @remarks When `mode` is `BackgroundMode.Texture`, the property will take effects.
+     * @defaultValue `BackgroundTextureFillMode.FitHeight`
+     */
+    get textureFillMode(): BackgroundTextureFillMode;
     set textureFillMode(value: BackgroundTextureFillMode);
     /**
      * Constructor of Background.
      * @param _engine Engine Which the background belongs to.
      */
     constructor(_engine: Engine);
+    private _initMesh;
+    private _initMaterial;
     private _createPlane;
 }

package/types/Camera.d.ts

@@ -1,19 +1,23 @@
-import { Matrix, Ray, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
+import { Matrix, Ray, Rect, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
-import { CameraClearFlags } from "./enums/CameraClearFlags";
 import { Layer } from "./Layer";
+import { CameraClearFlags } from "./enums/CameraClearFlags";
+import { DepthTextureMode } from "./enums/DepthTextureMode";
 import { Shader } from "./shader/Shader";
 import { ShaderData } from "./shader/ShaderData";
 import { ShaderTagKey } from "./shader/ShaderTagKey";
-import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
 import { RenderTarget } from "./texture/RenderTarget";
+import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
 /**
  * Camera component, as the entrance to the three-dimensional world.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
 export declare class Camera extends Component {
-    /** Rendering priority - A Camera with higher priority will be rendered on top of a camera with lower priority. */
-    priority: number;
+    private static _inverseViewMatrixProperty;
+    private static _cameraPositionProperty;
+    private static _cameraForwardProperty;
+    private static _cameraUpProperty;
+    private static _cameraDepthBufferParamsProperty;
     /** Whether to enable frustum culling, it is enabled by default. */
     enableFrustumCulling: boolean;
     /**
@@ -26,6 +30,12 @@ export declare class Camera extends Component {
      * @remarks Support bit manipulation, corresponding to `Layer`.
      */
     cullingMask: Layer;
+    /**
+     * Depth texture mode.
+     * @defaultValue `DepthTextureMode.None`
+     */
+    depthTextureMode: DepthTextureMode;
+    private _priority;
     private _shaderData;
     private _isProjMatSetting;
     private _nearClipPlane;
@@ -37,11 +47,13 @@ export declare class Camera extends Component {
     private _isFrustumProjectDirty;
     private _customAspectRatio;
     private _renderTarget;
+    private _depthBufferParams;
     private _frustumViewChangeFlag;
     private _transform;
     private _isViewMatrixDirty;
     private _isInvViewProjDirty;
     private _viewport;
+    private _pixelViewport;
     private _inverseProjectionMatrix;
     private _lastAspectSize;
     private _invViewProjMat;
@@ -71,11 +83,22 @@ export declare class Camera extends Component {
     get aspectRatio(): number;
     set aspectRatio(value: number);
     /**
-     * Viewport, normalized expression, the upper left corner is (0, 0), and the lower right corner is (1, 1).
+     * The viewport of the camera in normalized coordinates on the screen.
+     * In normalized screen coordinates, the upper-left corner is (0, 0), and the lower-right corner is (1.0, 1.0).
      * @remarks Re-assignment is required after modification to ensure that the modification takes effect.
      */
     get viewport(): Vector4;
     set viewport(value: Vector4);
+    /**
+     * The viewport of the camera in pixel coordinates on the screen.
+     * In pixel screen coordinates, the upper-left corner is (0, 0), and the lower-right corner is (1.0, 1.0).
+     */
+    get pixelViewport(): Rect;
+    /**
+     * Rendering priority, higher priority will be rendered on top of a camera with lower priority.
+     */
+    get priority(): number;
+    set priority(value: number);
     /**
      * Whether it is orthogonal, the default is false. True will use orthographic projection, false will use perspective projection.
      */
@@ -209,11 +232,12 @@ export declare class Camera extends Component {
     /**
      * @inheritdoc
      */
-    _onEnable(): void;
+    _onEnableInScene(): void;
     /**
      * @inheritdoc
      */
-    _onDisable(): void;
+    _onDisableInScene(): void;
+    private _updatePixelViewport;
     private _projMatChange;
     private _innerViewportToWorldPoint;
     private _updateShaderData;

package/types/Component.d.ts

@@ -5,6 +5,7 @@ import { Scene } from "./Scene";
  * The base class of the components.
  */
 export declare class Component extends EngineObject {
+    protected _phasedActiveInScene: boolean;
     private _phasedActive;
     private _enabled;
     /**

package/types/ComponentsManager.d.ts

@@ -11,7 +11,6 @@ export declare class ComponentsManager {
     private _onUpdateScripts;
     private _onLateUpdateScripts;
     private _onPhysicsUpdateScripts;
-    private _disableScripts;
     private _pendingDestroyScripts;
     private _disposeDestroyScripts;
     private _onUpdateAnimations;
@@ -31,7 +30,6 @@ export declare class ComponentsManager {
     removeOnUpdateAnimations(animation: Animator): void;
     addOnUpdateRenderers(renderer: Renderer): void;
     removeOnUpdateRenderers(renderer: Renderer): void;
-    addDisableScript(component: Script): void;
     addPendingDestroyScript(component: Script): void;
     callScriptOnStart(): void;
     callScriptOnUpdate(deltaTime: number): void;

package/types/DisorderedArray.d.ts

@@ -2,8 +2,10 @@
  * High-performance unordered array, delete uses exchange method to improve performance, internal capacity only increases.
  */
 export declare class DisorderedArray<T> {
-    _elements: T[];
     length: number;
+    _elements: T[];
+    private _isLooping;
+    private _blankCount;
     constructor(count?: number);
     add(element: T): void;
     delete(element: T): void;
@@ -15,5 +17,10 @@ export declare class DisorderedArray<T> {
      * @returns The replaced item is used to reset its index
      */
     deleteByIndex(index: number): T;
+    forEach(callbackFn: (element: T) => void, swapFn: (element: T, index: number) => void): void;
+    forEachAndClean(callbackFn: (e: T) => void): void;
     garbageCollection(): void;
+    private _startLoop;
+    private _endLoop;
+    private _endLoopAndClear;
 }

package/types/Engine.d.ts

@@ -1,4 +1,4 @@
-import { IPhysics } from "@galacean/engine-design";
+import { IPhysics, IShaderLab } from "@galacean/engine-design";
 import { Canvas } from "./Canvas";
 import { EngineSettings } from "./EngineSettings";
 import { Entity } from "./Entity";
@@ -7,14 +7,12 @@ import { ResourceManager } from "./asset/ResourceManager";
 import { EventDispatcher, Time } from "./base";
 import { ColorSpace } from "./enums/ColorSpace";
 import { InputManager } from "./input";
-import { PhysicsManager } from "./physics";
+import { PhysicsScene } from "./physics/PhysicsScene";
 import { IHardwareRenderer } from "./renderingHardwareInterface";
 /**
  * Engine.
  */
 export declare class Engine extends EventDispatcher {
-    /** Physics manager of Engine. */
-    readonly physicsManager: PhysicsManager;
     /** Input manager of Engine. */
     readonly inputManager: InputManager;
     private _settings;
@@ -120,6 +118,11 @@ export declare class Engine extends EventDispatcher {
     private _onDeviceLost;
     private _onDeviceRestored;
     private _gc;
+    /**
+     * @deprecated
+     * The first scene physics manager.
+     */
+    get physicsManager(): PhysicsScene;
 }
 /**
  * Engine configuration.
@@ -129,4 +132,6 @@ export interface EngineConfiguration {
     physics?: IPhysics;
     /** Color space. */
     colorSpace?: ColorSpace;
+    /** Shader lab */
+    shaderLab?: IShaderLab;
 }

package/types/Entity.d.ts

@@ -130,6 +130,8 @@ export declare class Entity extends EngineObject {
      * @returns Cloned entity
      */
     clone(): Entity;
+    private _createCloneEntity;
+    private _parseCloneEntity;
     /**
      * Destroy self.
      */

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -9,13 +9,12 @@ import { RenderPass } from "./RenderPass";
  * Basic render pipeline.
  */
 export declare class BasicRenderPipeline {
-    private static _shadowCasterPipelineStageTagValue;
-    private static _forwardPipelineStageTagValue;
     private _camera;
     private _defaultPass;
     private _renderPassArray;
     private _lastCanvasSize;
     private _cascadedShadowCaster;
+    private _depthOnlyPass;
     /**
      * Create a basic render pipeline.
      * @param camera - Camera
@@ -62,7 +61,7 @@ export declare class BasicRenderPipeline {
      * @param data - Render data
      */
     pushRenderData(context: RenderContext, data: RenderData): void;
-    private pushRenderDataWihShader;
+    private pushRenderDataWithShader;
     private _drawBackgroundTexture;
     private _callRender;
 }

package/types/RenderPipeline/RenderData.d.ts

@@ -1,7 +1,14 @@
+import { SubMesh } from "../graphic";
+import { Primitive } from "../graphic/Primitive";
 import { Material } from "../material";
 import { Renderer } from "../Renderer";
-export declare class RenderData {
+import { IPoolElement } from "./IPoolElement";
+export declare class RenderData implements IPoolElement {
     component: Renderer;
     material: Material;
+    primitive: Primitive;
+    subPrimitive: SubMesh;
     multiRenderData: boolean;
+    setX(component: Renderer, material: Material, primitive: Primitive, subPrimitive: SubMesh): void;
+    dispose(): void;
 }

package/types/RenderPipeline/RenderElement.d.ts

@@ -1,11 +1,9 @@
 import { ShaderPass } from "../shader/ShaderPass";
-import { RenderState } from "../shader/state/RenderState";
 import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
 export declare class RenderElement implements IPoolElement {
     data: RenderData;
-    shaderPass: ShaderPass;
-    renderState: RenderState;
-    set(data: RenderData, shaderPass: ShaderPass, renderState: RenderState): void;
+    shaderPasses: ReadonlyArray<ShaderPass>;
+    set(data: RenderData, shaderPasses: ReadonlyArray<ShaderPass>): void;
     dispose(): void;
 }

package/types/RenderPipeline/RenderQueue.d.ts

@@ -1,6 +1,7 @@
 import { Camera } from "../Camera";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
+import { RenderQueueType } from "../shader";
 import { RenderElement } from "./RenderElement";
 /**
  * Render queue.
@@ -8,12 +9,13 @@ import { RenderElement } from "./RenderElement";
 export declare class RenderQueue {
     readonly elements: RenderElement[];
     private _spriteBatcher;
-    constructor(engine: Engine);
+    private readonly _renderQueueType;
+    constructor(engine: Engine, renderQueueType: RenderQueueType);
     /**
      * Push a render element.
      */
     pushRenderElement(element: RenderElement): void;
-    render(camera: Camera, mask: Layer): void;
+    render(camera: Camera, mask: Layer, pipelineStageTagValue: string): void;
     /**
      * Clear collection.
      */

package/types/RenderPipeline/enums/PipelineStage.d.ts

@@ -2,6 +2,8 @@
  * Pipeline stage.
  */
 export declare enum PipelineStage {
+    /** DepthOnly stage. */
+    DepthOnly = "DepthOnly",
     /** Shadow caster stage. */
     ShadowCaster = "ShadowCaster",
     /** Forward shading stage. */

package/types/Renderer.d.ts

@@ -1,13 +1,13 @@
 import { BoundingBox, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
-import { ICustomClone } from "./clone/ComponentCloner";
+import { IComponentCustomClone } from "./clone/ComponentCloner";
 import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
 /**
  * Basis for all renderers.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
-export declare class Renderer extends Component implements ICustomClone {
+export declare class Renderer extends Component implements IComponentCustomClone {
     private static _tempVector0;
     private static _receiveShadowMacro;
     private static _localMatrixProperty;

package/types/Scene.d.ts

@@ -5,6 +5,7 @@ import { Entity } from "./Entity";
 import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
 import { AmbientLight } from "./lighting/AmbientLight";
+import { PhysicsScene } from "./physics/PhysicsScene";
 import { ShaderData } from "./shader/ShaderData";
 import { ShadowCascadesMode } from "./shadow/enum/ShadowCascadesMode";
 import { ShadowResolution } from "./shadow/enum/ShadowResolution";
@@ -18,6 +19,8 @@ export declare class Scene extends EngineObject {
     private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
+    /** Physics. */
+    readonly physics: PhysicsScene;
     /** If cast shadows. */
     castShadows: boolean;
     /** The resolution of the shadow maps. */
@@ -38,6 +41,12 @@ export declare class Scene extends EngineObject {
     private _fogEnd;
     private _fogDensity;
     private _fogParams;
+    private _isActive;
+    /**
+     * Whether the scene is active.
+     */
+    get isActive(): boolean;
+    set isActive(value: boolean);
     /**
      * Scene-related shader data.
      */
@@ -140,10 +149,6 @@ export declare class Scene extends EngineObject {
      * @returns Entity
      */
     findEntityByPath(path: string): Entity | null;
-    /**
-     * Destroy this scene.
-     */
-    destroy(): void;
     private _addToRootEntityList;
     private _computeLinearFogParams;
     private _computeExponentialFogParams;

package/types/SceneManager.d.ts

@@ -1,20 +1,35 @@
-import { AssetPromise } from "./asset/AssetPromise";
 import { Engine } from "./Engine";
 import { Scene } from "./Scene";
+import { AssetPromise } from "./asset/AssetPromise";
 /**
  * Scene manager.
  */
 export declare class SceneManager {
     readonly engine: Engine;
     /**
-     * Get the activated scene.
+     * Get the scene list.
      */
-    get activeScene(): Scene;
-    set activeScene(scene: Scene);
+    get scenes(): ReadonlyArray<Scene>;
+    /**
+     * Add scene.
+     * @param scene - The scene which want to be added
+     */
+    addScene(scene: Scene): void;
+    /**
+     * Add scene at specified index.
+     * @param index - specified index
+     * @param child - The scene which want to be added
+     */
+    addScene(index: number, scene: Scene): void;
+    /**
+     * Remove scene.
+     * @param scene - The scene which want to be removed
+     */
+    removeScene(scene: Scene): void;
     /**
      * Load and activate scene.
      * @param url - the path of the scene
-     * @param destroyOldScene - whether to destroy old scene information
+     * @param destroyOldScene - whether to destroy old scene
      * @returns scene promise
      */
     loadScene(url: string, destroyOldScene?: boolean): AssetPromise<Scene>;
@@ -25,4 +40,12 @@ export declare class SceneManager {
      * @param destScene - target scene
      */
     mergeScenes(sourceScene: Scene, destScene: Scene): void;
+    /**
+     * @deprecated
+     * Please use `scenes` instead.
+     *
+     * Get the first scene.
+     */
+    get activeScene(): Scene;
+    set activeScene(scene: Scene);
 }

package/types/Script.d.ts

@@ -8,7 +8,6 @@ import { Collision } from "./physics/Collision";
  */
 export declare class Script extends Component {
     _entityScriptsIndex: number;
-    _waitHandlingInValid: boolean;
     /**
      * Called when be enabled first time, only once.
      */

package/types/animation/Keyframe.d.ts

@@ -1,9 +1,10 @@
-import { Color, Quaternion, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
+import { Color, Quaternion, Rect, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
+import { ReferResource } from "../asset/ReferResource";
 /**
  * Keyframe.
  * @typeParam V - Type of Keyframe value
  */
-export declare class Keyframe<V extends KeyframeValueType, T = V extends number ? number : V extends Vector2 ? Vector2 : V extends Vector3 ? Vector3 : V extends Vector4 | Color | Quaternion ? Vector4 : V extends number[] | Float32Array ? number[] : never> {
+export declare class Keyframe<V extends KeyframeValueType, T = V extends number ? number : V extends Vector2 ? Vector2 : V extends Vector3 ? Vector3 : V extends Vector4 | Color | Quaternion | Rect ? Vector4 : V extends number[] | Float32Array ? number[] : V extends ReferResource ? ReferResource : never> {
     /** The time of the Keyframe. */
     time: number;
     /** The value of the Keyframe. */
@@ -16,4 +17,4 @@ export declare class Keyframe<V extends KeyframeValueType, T = V extends number
 /**
  * Type of Keyframe value.
  */
-export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | boolean;
+export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | Rect | boolean | ReferResource;

package/types/animation/animationCurve/index.d.ts

@@ -8,3 +8,5 @@ export { AnimationQuaternionCurve } from "./AnimationQuaternionCurve";
 export { AnimationVector2Curve } from "./AnimationVector2Curve";
 export { AnimationVector3Curve } from "./AnimationVector3Curve";
 export { AnimationVector4Curve } from "./AnimationVector4Curve";
+export { AnimationRefCurve } from "./AnimationRefCurve";
+export { AnimationRectCurve } from "./AnimationRectCurve";

package/types/animation/index.d.ts

@@ -1,3 +1,7 @@
+import "./internal/animationCurveOwner/assembler/PositionAnimationCurveOwnerAssembler";
+import "./internal/animationCurveOwner/assembler/RotationAnimationCurveOwnerAssembler";
+import "./internal/animationCurveOwner/assembler/ScaleAnimationCurveOwnerAssembler";
+import "./internal/animationCurveOwner/assembler/BlendShapeWeightsAnimationCurveOwnerAssembler";
 export { AnimationClip } from "./AnimationClip";
 export { AnimationClipCurveBinding } from "./AnimationClipCurveBinding";
 export * from "./animationCurve";

package/types/asset/AssetType.d.ts

@@ -35,6 +35,8 @@ export declare enum AssetType {
     KTX = "KTX",
     /** Cube Compress Texture. */
     KTXCube = "KTXCube",
+    /** KTX2 Compress Texture */
+    KTX2 = "KTX2",
     /** Sprite. */
     Sprite = "Sprite",
     /** Sprite Atlas. */
@@ -48,5 +50,7 @@ export declare enum AssetType {
     /** Font. */
     Font = "Font",
     /** Source Font, include ttf、 otf and woff. */
-    SourceFont = "SourceFont"
+    SourceFont = "SourceFont",
+    /** Project asset. */
+    Project = "project"
 }

package/types/asset/GraphicsResource.d.ts

@@ -1,5 +1,9 @@
 import { Engine } from "../Engine";
 import { ReferResource } from "./ReferResource";
 export declare abstract class GraphicsResource extends ReferResource {
+    /**
+     * Whether the content of the resource is lost.
+     */
+    get isContentLost(): boolean;
     protected constructor(engine: Engine);
 }

package/types/asset/Loader.d.ts

@@ -1,3 +1,4 @@
+import { Engine, EngineConfiguration } from "../Engine";
 import { AssetPromise } from "./AssetPromise";
 import { LoadItem } from "./LoadItem";
 import { RequestConfig } from "./request";
@@ -25,6 +26,7 @@ export declare abstract class Loader<T> {
     };
     private static _engineObjects;
     constructor(useCache: boolean);
+    initialize?(engine: Engine, configuration: EngineConfiguration): Promise<void>;
+    abstract load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<T>;
     request: <U>(url: string, config: RequestConfig) => AssetPromise<U>;
-    abstract load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<T> | Record<string, AssetPromise<any>>;
 }

package/types/asset/ResourceManager.d.ts

@@ -7,8 +7,6 @@ import { LoadItem } from "./LoadItem";
  */
 export declare class ResourceManager {
     readonly engine: Engine;
-    /** Loader collection. */
-    private static _loaders;
     private static _extTypeMapping;
     private static _getTypeByUrl;
     /** The number of retries after failing to load assets. */
@@ -28,6 +26,7 @@ export declare class ResourceManager {
     private _graphicResourcePool;
     /** Restorable resource information pool, key is the `instanceID` of resource. */
     private _contentRestorerPool;
+    private _subAssetPromiseCallbacks;
     /**
      * Create a ResourceManager.
      * @param engine - Engine to which the current ResourceManager belongs
@@ -63,6 +62,12 @@ export declare class ResourceManager {
      * @returns Resource object
      */
     getFromCache<T>(url: string): T;
+    /**
+     * Find the resource by type.
+     * @param type - Resource type
+     * @returns - Resource collection
+     */
+    findResourcesByType<T extends EngineObject>(type: new (...args: any[]) => T): T[];
     /**
      * Get asset url from instanceId.
      * @param instanceId - Engine instance id
@@ -95,6 +100,7 @@ export declare class ResourceManager {
     addContentRestorer<T extends EngineObject>(restorer: ContentRestorer<T>): void;
     private _assignDefaultOptions;
     private _loadSingleItem;
+    private _pushSubAssetPromiseCallback;
     private _gc;
     private _getResolveResource;
     private _parseURL;

package/types/base/Constant.d.ts

@@ -106,6 +106,7 @@ export declare enum GLCapabilityType {
     pvrtc_webkit = "WEBKIT_WEBGL_compressed_texture_pvrtc",
     s3tc = "WEBGL_compressed_texture_s3tc",
     s3tc_webkit = "WEBKIT_WEBGL_compressed_texture_s3tc",
+    bptc = "EXT_texture_compression_bptc",
     WEBGL_lose_context = "WEBGL_lose_context"
 }
 export type TypedArray = Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array | Uint8ClampedArray | Float32Array | Float64Array;

package/types/clone/ComponentCloner.d.ts

@@ -1,14 +1,17 @@
 import { Component } from "../Component";
+import { Entity } from "../Entity";
 /**
  * Custom clone interface.
  */
 export interface ICustomClone {
 }
+export interface IComponentCustomClone {
+}
 export declare class ComponentCloner {
     /**
      * Clone component.
      * @param source - Clone source
      * @param target - Clone target
      */
-    static cloneComponent(source: Component, target: Component): void;
+    static cloneComponent(source: Component, target: Component, srcRoot: Entity, targetRoot: Entity): void;
 }

package/types/graphic/Buffer.d.ts

@@ -11,6 +11,8 @@ export declare class Buffer extends GraphicsResource {
     private _byteLength;
     private _bufferUsage;
     private _platformBuffer;
+    private _readable;
+    private _data;
     /**
      * Buffer binding flag.
      */
@@ -23,22 +25,36 @@ export declare class Buffer extends GraphicsResource {
      * Buffer usage.
      */
     get bufferUsage(): BufferUsage;
+    /**
+     * If buffer is readable.
+     */
+    get readable(): boolean;
+    /**
+     * Buffer data cache.
+     *
+     * @remarks
+     * Buffer must be readable.
+     * If the data you get is modified, must call `setData()` to update buffer to GPU.
+     */
+    get data(): Uint8Array;
     /**
      * Create Buffer.
      * @param engine - Engine
      * @param type - Buffer binding flag
      * @param byteLength - Byte length
      * @param bufferUsage - Buffer usage
+     * @param readable - If buffer is readable
      */
-    constructor(engine: Engine, type: BufferBindFlag, byteLength: number, bufferUsage?: BufferUsage);
+    constructor(engine: Engine, type: BufferBindFlag, byteLength: number, bufferUsage?: BufferUsage, readable?: boolean);
     /**
      * Create Buffer.
      * @param engine - Engine
      * @param type - Buffer binding flag
-     * @param data - Byte
+     * @param data - Buffer data, if `readable` is true, the`data` property will store a copy of this
      * @param bufferUsage - Buffer usage
+     * @param readable - If buffer is readable
      */
-    constructor(engine: Engine, type: BufferBindFlag, data: ArrayBuffer | ArrayBufferView, bufferUsage?: BufferUsage);
+    constructor(engine: Engine, type: BufferBindFlag, data: ArrayBuffer | ArrayBufferView, bufferUsage?: BufferUsage, readable?: boolean);
     /**
      * Bind buffer.
      */
@@ -90,9 +106,9 @@ export declare class Buffer extends GraphicsResource {
      * @param dataLength - Output data length
      */
     getData(data: ArrayBufferView, bufferByteOffset: number, dataOffset: number, dataLength: number): void;
-    _rebuild(): void;
     /**
-     * @deprecated
+     * Mark buffer as readable, the `data` property will be not accessible anymore.
      */
-    resize(byteLength: number): void;
+    markAsUnreadable(): void;
+    _rebuild(): void;
 }