@galacean/engine-core 1.0.0 → 1.0.2

package/types/texture/Texture.d.ts

@@ -1,16 +1,18 @@
-import { RefObject } from "../asset/RefObject";
+import { GraphicsResource } from "../asset/GraphicsResource";
 import { TextureDepthCompareFunction } from "./enums/TextureDepthCompareFunction";
 import { TextureFilterMode } from "./enums/TextureFilterMode";
 import { TextureFormat } from "./enums/TextureFormat";
+import { TextureUsage } from "./enums/TextureUsage";
 import { TextureWrapMode } from "./enums/TextureWrapMode";
 /**
  * The base class of texture, contains some common functions of texture-related classes.
  */
-export declare abstract class Texture extends RefObject {
+export declare abstract class Texture extends GraphicsResource {
     name: string;
     protected _format: TextureFormat;
     protected _width: number;
     protected _height: number;
+    protected _usage: TextureUsage;
     protected _mipmapCount: number;
     private _wrapModeU;
     private _wrapModeV;
@@ -30,6 +32,10 @@ export declare abstract class Texture extends RefObject {
      * The height of the texture.
      */
     get height(): number;
+    /**
+     * The usage of the texture.
+     */
+    get usage(): TextureUsage;
     /**
      * Wrapping mode for texture coordinate S.
      */
@@ -64,10 +70,6 @@ export declare abstract class Texture extends RefObject {
      * Generate multi-level textures based on the 0th level data.
      */
     generateMipmaps(): void;
-    /**
-     * @override
-     */
-    _onDestroy(): void;
     /**
      * Get the maximum mip level of the corresponding size:rounding down.
      * @remarks http://download.nvidia.com/developer/Papers/2005/NP2_Mipmapping/NP2_Mipmap_Creation.pdf

package/types/texture/Texture2D.d.ts

@@ -1,5 +1,6 @@
 import { Engine } from "../Engine";
 import { TextureFormat } from "./enums/TextureFormat";
+import { TextureUsage } from "./enums/TextureUsage";
 import { Texture } from "./Texture";
 /**
  * Two-dimensional texture.
@@ -12,8 +13,9 @@ export declare class Texture2D extends Texture {
      * @param height - Texture height
      * @param format - Texture format. default  `TextureFormat.R8G8B8A8`
      * @param mipmap - Whether to use multi-level texture
+     * @param usage - Texture usage
      */
-    constructor(engine: Engine, width: number, height: number, format?: TextureFormat, mipmap?: boolean);
+    constructor(engine: Engine, width: number, height: number, format?: TextureFormat, mipmap?: boolean, usage?: TextureUsage);
     /**
      * Setting pixels data through color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
      * @remarks If it is the WebGL1.0 platform and the texture format is compressed, the first upload must be filled with textures.

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

@@ -0,0 +1,9 @@
+/**
+ * Texture usage.
+ */
+export declare enum TextureUsage {
+    /** The content of the texture is intended to be specified once.  */
+    Static = 0,
+    /** The content of the texture is intended to be updated frequently, with better performance. */
+    Dynamic = 1
+}

package/types/texture/index.d.ts

@@ -3,6 +3,7 @@ export { TextureCubeFace } from "./enums/TextureCubeFace";
 export { TextureDepthCompareFunction } from "./enums/TextureDepthCompareFunction";
 export { TextureFilterMode } from "./enums/TextureFilterMode";
 export { TextureFormat } from "./enums/TextureFormat";
+export { TextureUsage } from "./enums/TextureUsage";
 export { TextureWrapMode } from "./enums/TextureWrapMode";
 export { RenderTarget } from "./RenderTarget";
 export { Texture } from "./Texture";

package/types/trail/TrailRenderer.d.ts

@@ -1,6 +1,5 @@
 import { Entity } from "../Entity";
 import { MeshRenderer } from "../mesh/MeshRenderer";
-import { RenderContext } from "../RenderPipeline/RenderContext";
 import { Texture2D } from "../texture";
 /**
  * @deprecated
@@ -28,10 +27,6 @@ export declare class TrailRenderer extends MeshRenderer {
      * @param texture
      */
     setTexture(texture: Texture2D): void;
-    /**
-     * @override
-     */
-    protected _render(context: RenderContext): void;
     private _initGeometry;
     private _updateStrapVertices;
     private _updateStrapCoords;

package/types/utils/BoolUpdateFlag.d.ts

@@ -0,0 +1,12 @@
+import { UpdateFlag } from "./UpdateFlag";
+/**
+ * Bool update flag.
+ */
+export declare class BoolUpdateFlag extends UpdateFlag {
+    /** Bool flag. */
+    flag: boolean;
+    /**
+     * @inheritdoc
+     */
+    dispatch(): void;
+}

package/types/utils/DisorderedArray.d.ts

@@ -0,0 +1,18 @@
+/**
+ * High-performance unordered array, delete uses exchange method to improve performance, internal capacity only increases.
+ */
+export declare class DisorderedArray<T> {
+    _elements: T[];
+    length: number;
+    constructor(count?: number);
+    add(element: T): void;
+    delete(element: T): void;
+    get(index: number): T;
+    /**
+     *
+     * @param index
+     * @returns The replaced item is used to reset its index.
+     */
+    deleteByIndex(index: number): T;
+    garbageCollection(): void;
+}

package/types/utils/SafeLoopArray.d.ts

@@ -0,0 +1,41 @@
+export declare class SafeLoopArray<T> {
+    private _array;
+    private _loopArray;
+    private _loopArrayDirty;
+    /**
+     * Get the length of the array.
+     */
+    get length(): number;
+    /**
+     * Push item to the array.
+     * @param item - The item which want to be pushed
+     */
+    push(item: T): void;
+    /**
+     * Add item to the array.
+     * @param index - The index of the array
+     * @param item - The item which want to be added
+     */
+    add(index: number, item: T): void;
+    /**
+     * Remove item from the array.
+     * @param index - The index of the array
+     */
+    removeByIndex(index: number): void;
+    /**
+     * The index of the item.
+     * @param item - The item which want to get the index
+     * @returns Index of the item
+     */
+    indexOf(item: T): number;
+    /**
+     * Get the array.
+     * @returns The array
+     */
+    getArray(): ReadonlyArray<T>;
+    /**
+     * Get the array use for loop.
+     * @returns The array use for loop
+     */
+    getLoopArray(): ReadonlyArray<T>;
+}

package/types/utils/UpdateFlag.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Used to update tags.
+ */
+export declare abstract class UpdateFlag {
+    /**
+     * Dispatch.
+     * @param bit - Bit
+     * @param param - Parameter
+     */
+    abstract dispatch(bit?: number, param?: Object): void;
+    /**
+     * Clear.
+     */
+    clearFromManagers(): void;
+    /**
+     * Destroy.
+     */
+    destroy(): void;
+    private _removeFromManagers;
+}

package/types/utils/UpdateFlagManager.d.ts

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

package/types/utils/Utils.d.ts

@@ -0,0 +1,31 @@
+export declare class Utils {
+    /**
+     * Fast remove an element from array.
+     * @param array - Array
+     * @param item - Element
+     */
+    static removeFromArray(array: any[], item: any): boolean;
+    /**
+     * Decodes a given Uint8Array into a string.
+     */
+    static decodeText(array: Uint8Array): string;
+    /**
+     * Judge whether the url is absolute url.
+     * @param url - The url to be judged.
+     * @returns Whether the url is absolute url.
+     */
+    static isAbsoluteUrl(url: string): boolean;
+    /**
+     * Get the values of an object.
+     */
+    static objectValues(obj: any): any[];
+    /**
+     * Convert a relative URL to an absolute URL based on a given base URL.
+     * @param baseUrl - The base url.
+     * @param relativeUrl - The relative url.
+     * @returns The resolved url.
+     */
+    static resolveAbsoluteUrl(baseUrl: string, relativeUrl: string): string;
+    private static _stringToPath;
+    private static _formatRelativePath;
+}

package/types/xr/XRManager.d.ts

@@ -0,0 +1,31 @@
+import { Engine } from "../Engine";
+import { EnumXRMode } from "./enum/EnumXRMode";
+import { EnumXRFeature } from "./enum/EnumXRFeature";
+import { EnumXRTrackingMode } from "./enum/EnumXRTrackingMode";
+import { XRFeature } from "./feature/XRFeature";
+import { EnumXRSubsystem } from "./enum/EnumXRSubsystem";
+import { XRProvider } from "./provider/XRProvider";
+import { XRSubsystem } from "./subsystem/XRSubsystem";
+type FeatureConstructor = new (engine: Engine) => XRFeature;
+export declare class XRManager {
+    private _engine;
+    private _provider;
+    private _features;
+    private _subsystems;
+    private _isPaused;
+    isSupportedMode(mode: EnumXRMode): Promise<void>;
+    isSupportedTrackingMode(mode: EnumXRTrackingMode): Promise<void>;
+    isSupportedFeature(feature: EnumXRFeature): Promise<void>;
+    getFeature<T extends XRFeature>(feature: EnumXRFeature): T;
+    enableFeature(feature: EnumXRFeature): void;
+    disableFeature(feature: EnumXRFeature): void;
+    getSubsystem<T extends XRSubsystem>(subsystem: EnumXRSubsystem): T;
+    initialize(mode: EnumXRMode, trackingMode: EnumXRTrackingMode, requestFeatures?: EnumXRFeature[]): Promise<void>;
+    start(): Promise<void>;
+    pause(): void;
+    resume(): void;
+    destroy(): void;
+    constructor(engine: Engine, type: new (engine: Engine) => XRProvider);
+}
+export declare function registerFeature(feature: EnumXRFeature, dependentSubsystem?: EnumXRSubsystem[]): (featureConstructor: FeatureConstructor) => void;
+export {};

package/types/xr/component/XRPoseDriver.d.ts

@@ -0,0 +1,10 @@
+import { Script } from "../../Script";
+import { EnumXRInputSource } from "../enum/EnumXRInputSource";
+import { EnumXRTrackingMode } from "../enum/EnumXRTrackingMode";
+export declare class XRPoseDriver extends Script {
+    source: EnumXRInputSource;
+    updateType: EnumXRTrackingMode;
+    private _xrManager;
+    onLateUpdate(): void;
+    onAwake(): void;
+}

package/types/xr/data/XRCamera.d.ts

@@ -0,0 +1,6 @@
+import { Matrix, Vector4 } from "@galacean/engine-math";
+import { XRDevice } from "./XRDevice";
+export declare class XRCamera extends XRDevice {
+    project: Matrix;
+    viewport: Vector4;
+}

package/types/xr/data/XRDevice.d.ts

@@ -0,0 +1,9 @@
+import { Matrix, Quaternion, Vector3 } from "@galacean/engine-math";
+import { EnumXRDevicePhase } from "../enum/EnumXRDevicePhase";
+export declare class XRDevice {
+    matrix: Matrix;
+    position: Vector3;
+    linearVelocity: Vector3;
+    quaternion: Quaternion;
+    phase: EnumXRDevicePhase;
+}

package/types/xr/data/XRHandle.d.ts

@@ -0,0 +1,10 @@
+import { XRDevice } from "./XRDevice";
+import { EnumXRButton } from "../enum/EnumXRButton";
+import { DisorderedArray } from "../../DisorderedArray";
+export declare class XRHandle extends XRDevice {
+    pressedButtons: EnumXRButton;
+    upMap: number[];
+    downMap: number[];
+    upList: DisorderedArray<EnumXRButton>;
+    downList: DisorderedArray<EnumXRButton>;
+}

package/types/xr/enum/EnumXRButton.d.ts

@@ -0,0 +1,5 @@
+export declare enum EnumXRButton {
+    None = 0,
+    Select = 1,
+    Squeeze = 2
+}

package/types/xr/enum/EnumXRDevicePhase.d.ts

@@ -0,0 +1,4 @@
+export declare enum EnumXRDevicePhase {
+    active = 0,
+    leave = 1
+}

package/types/xr/enum/EnumXRFeature.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ */
+export declare enum EnumXRFeature {
+    input = 0,
+    camera = 1,
+    imageTracking = 2,
+    objectTracking = 3
+}

package/types/xr/enum/EnumXRInputSource.d.ts

@@ -0,0 +1,8 @@
+export declare enum EnumXRInputSource {
+    Handler = 0,
+    LeftHandle = 1,
+    RightHandle = 2,
+    Eye = 3,
+    LeftEye = 4,
+    RightEye = 5
+}

package/types/xr/enum/EnumXRMode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Modes for XR
+ */
+export declare enum EnumXRMode {
+    AR = 0,
+    VR = 1
+}

package/types/xr/enum/EnumXRSubsystem.d.ts

@@ -0,0 +1,4 @@
+export declare enum EnumXRSubsystem {
+    input = 0,
+    imageTracking = 1
+}

package/types/xr/enum/EnumXRTrackingMode.d.ts

@@ -0,0 +1,7 @@
+export declare enum EnumXRTrackingMode {
+    None = 0,
+    RotationOnly = 1,
+    PositionOnly = 2,
+    RotationAndPosition = 3,
+    Auto = 4
+}

package/types/xr/feature/XRCameraManager.d.ts

@@ -0,0 +1,21 @@
+import { Camera } from "../../Camera";
+import { EnumXRInputSource } from "../enum/EnumXRInputSource";
+import { XRFeature } from "./XRFeature";
+export declare class XRCameraManager extends XRFeature {
+    private _cameras;
+    private _automaticNear;
+    private _customNear;
+    private _automaticFar;
+    private _customFar;
+    get near(): number;
+    set near(value: number);
+    get far(): number;
+    set far(value: number);
+    attachCamera(source: EnumXRInputSource, camera: Camera): void;
+    detachCamera(source: EnumXRInputSource): void;
+    getCamera(source: EnumXRInputSource): Camera;
+    onUpdate(): void;
+    onEnable(): void;
+    onDisable(): void;
+    onDestroy(): void;
+}

package/types/xr/feature/XRFeature.d.ts

@@ -0,0 +1,29 @@
+import { Engine } from "../../Engine";
+export declare abstract class XRFeature {
+    protected _engine: Engine;
+    /**
+     * Enable an instance of a feature.
+     * This method needs to be override.
+     * @returns
+     */
+    onEnable(): void;
+    /**
+     * Disable an instance of a feature.
+     * This method needs to be override.
+     * @returns
+     */
+    onDisable(): void;
+    /**
+     * Update an instance of a feature.
+     * This method needs to be override.
+     * @returns
+     */
+    onUpdate(): void;
+    /**
+     * Destroy an instance of a feature.
+     * This method needs to be override.
+     * @returns
+     */
+    onDestroy(): void;
+    constructor(engine: Engine);
+}

package/types/xr/feature/XRImageTrackManager.d.ts

@@ -0,0 +1,10 @@
+import { Entity } from "../../Entity";
+import { XRFeature } from "./XRFeature";
+export declare class XRImageTrackManager extends XRFeature {
+    addImage(): void;
+    removeImage(): void;
+    getTrackedObject(): Entity;
+    onEnable(): void;
+    onDisable(): void;
+    onDestroy(): void;
+}

package/types/xr/feature/XRInputManager.d.ts

@@ -0,0 +1,16 @@
+import { Engine } from "../../Engine";
+import { XRDevice } from "../data/XRDevice";
+import { EnumXRButton } from "../enum/EnumXRButton";
+import { EnumXRInputSource } from "../enum/EnumXRInputSource";
+import { XRFeature } from "./XRFeature";
+export declare class XRInputManager extends XRFeature {
+    private _subSystem;
+    getDevice<T extends XRDevice>(source: EnumXRInputSource): T;
+    isButtonDown(handedness: EnumXRInputSource, button: EnumXRButton): boolean;
+    isButtonUp(handedness: EnumXRInputSource, button: EnumXRButton): boolean;
+    isButtonHeldDown(handedness: EnumXRInputSource, button: EnumXRButton): boolean;
+    onEnable(): void;
+    onDisable(): void;
+    onDestroy(): void;
+    constructor(engine: Engine);
+}

package/types/xr/index.d.ts

@@ -0,0 +1,18 @@
+export { XRManager, registerFeature } from "./XRManager";
+export { EnumXRMode } from "./enum/EnumXRMode";
+export { EnumXRButton } from "./enum/EnumXRButton";
+export { EnumXRFeature } from "./enum/EnumXRFeature";
+export { EnumXRSubsystem } from "./enum/EnumXRSubsystem";
+export { EnumXRDevicePhase } from "./enum/EnumXRDevicePhase";
+export { EnumXRInputSource } from "./enum/EnumXRInputSource";
+export { EnumXRTrackingMode } from "./enum/EnumXRTrackingMode";
+export { XRInputManager } from "./feature/XRInputManager";
+export { XRCameraManager } from "./feature/XRCameraManager";
+export { XRImageTrackManager } from "./feature/XRImageTrackManager";
+export { XRSubsystem } from "./subsystem/XRSubsystem";
+export { XRInputSubsystem } from "./subsystem/XRInputSubsystem";
+export { XRProvider } from "./provider/XRProvider";
+export { XRPoseDriver } from "./component/XRPoseDriver";
+export { XRDevice } from "./data/XRDevice";
+export { XRCamera } from "./data/XRCamera";
+export { XRHandle } from "./data/XRHandle";

package/types/xr/provider/XRProvider.d.ts

@@ -0,0 +1,19 @@
+import { EnumXRMode } from "../enum/EnumXRMode";
+import { EnumXRTrackingMode } from "../enum/EnumXRTrackingMode";
+import { XRSubsystem } from "../subsystem/XRSubsystem";
+import { Engine } from "../../Engine";
+import { EnumXRSubsystem } from "../enum/EnumXRSubsystem";
+export declare class XRProvider {
+    name: string;
+    protected _engine: Engine;
+    isSupportedMode(mode: EnumXRMode): Promise<void>;
+    isSupportedTrackingMode(mode: EnumXRTrackingMode): Promise<void>;
+    isSupportedSubsystem(feature: number): Promise<void>;
+    createSubsystem<T extends XRSubsystem>(feature: number): Promise<T>;
+    initialize(mode: EnumXRMode, trackingMode: EnumXRTrackingMode, subsystems: EnumXRSubsystem[]): Promise<XRSubsystem[]>;
+    start(): Promise<void>;
+    onUpdate(): void;
+    onLateUpdate(): void;
+    onDestroy(): void;
+    constructor(engine: Engine);
+}

package/types/xr/subsystem/XRInputSubsystem.d.ts

@@ -0,0 +1,5 @@
+import { XRDevice } from "../data/XRDevice";
+import { XRSubsystem } from "./XRSubsystem";
+export declare abstract class XRInputSubsystem extends XRSubsystem {
+    devices: XRDevice[];
+}

package/types/xr/subsystem/XRSubsystem.d.ts

@@ -0,0 +1,30 @@
+import { Engine } from "../../Engine";
+export declare abstract class XRSubsystem {
+    running: boolean;
+    _engine: Engine;
+    /**
+     * Starts an instance of a system.
+     * This method needs to be override.
+     * @returns
+     */
+    start(): Promise<void>;
+    /**
+     * Stops an instance of a system.
+     * This method needs to be override.
+     * @returns
+     */
+    stop(): Promise<void>;
+    /**
+     * Destroys this instance of a system.
+     * This method needs to be override.
+     * @returns
+     */
+    destroy(): Promise<void>;
+    /**
+     * Update this instance of a system.
+     * This method needs to be override.
+     * @returns
+     */
+    update(): void;
+    constructor(engine: Engine);
+}