@galacean/engine-core 0.0.0-experimental-animator-additive.1

package/types/physics/shape/BoxColliderShape.d.ts

@@ -0,0 +1,15 @@
+import { ColliderShape } from "./ColliderShape";
+import { Vector3 } from "@galacean/engine-math";
+/**
+ * Physical collider shape for box.
+ */
+export declare class BoxColliderShape extends ColliderShape {
+    private _size;
+    /**
+     * Size of box shape.
+     */
+    get size(): Vector3;
+    set size(value: Vector3);
+    constructor();
+    private _setSize;
+}

package/types/physics/shape/CapsuleColliderShape.d.ts

@@ -0,0 +1,26 @@
+import { ColliderShape } from "./ColliderShape";
+import { ColliderShapeUpAxis } from "../enums/ColliderShapeUpAxis";
+/**
+ * Physical collider shape for capsule.
+ */
+export declare class CapsuleColliderShape extends ColliderShape {
+    private _radius;
+    private _height;
+    private _upAxis;
+    /**
+     * Radius of capsule.
+     */
+    get radius(): number;
+    set radius(value: number);
+    /**
+     * Height of capsule.
+     */
+    get height(): number;
+    set height(value: number);
+    /**
+     * Up axis of capsule.
+     */
+    get upAxis(): ColliderShapeUpAxis;
+    set upAxis(value: ColliderShapeUpAxis);
+    constructor();
+}

package/types/physics/shape/ColliderShape.d.ts

@@ -0,0 +1,51 @@
+import { PhysicsMaterial } from "../PhysicsMaterial";
+import { Vector3 } from "@galacean/engine-math";
+import { Collider } from "../Collider";
+/**
+ * Abstract class for collider shapes.
+ */
+export declare abstract class ColliderShape {
+    private static _idGenerator;
+    protected _id: number;
+    protected _material: PhysicsMaterial;
+    private _isTrigger;
+    private _rotation;
+    private _position;
+    private _contactOffset;
+    /**
+     * Collider owner of this shape.
+     */
+    get collider(): Collider;
+    /**
+     * Unique id for this shape.
+     */
+    get id(): number;
+    /**
+     * Contact offset for this shape.
+     */
+    get contactOffset(): number;
+    set contactOffset(value: number);
+    /**
+     * Physical material.
+     */
+    get material(): PhysicsMaterial;
+    set material(value: PhysicsMaterial);
+    /**
+     * The local rotation of this ColliderShape.
+     */
+    get rotation(): Vector3;
+    set rotation(value: Vector3);
+    /**
+     * The local position of this ColliderShape.
+     */
+    get position(): Vector3;
+    set position(value: Vector3);
+    /**
+     * True for TriggerShape, false for SimulationShape.
+     */
+    get isTrigger(): boolean;
+    set isTrigger(value: boolean);
+    protected constructor();
+    private _setPosition;
+    private _setRotation;
+}

package/types/physics/shape/PlaneColliderShape.d.ts

@@ -0,0 +1,7 @@
+import { ColliderShape } from "./ColliderShape";
+/**
+ * Physical collider shape plane.
+ */
+export declare class PlaneColliderShape extends ColliderShape {
+    constructor();
+}

package/types/physics/shape/SphereColliderShape.d.ts

@@ -0,0 +1,13 @@
+import { ColliderShape } from "./ColliderShape";
+/**
+ * Physical collider shape for sphere.
+ */
+export declare class SphereColliderShape extends ColliderShape {
+    private _radius;
+    /**
+     * Radius of sphere shape.
+     */
+    get radius(): number;
+    set radius(value: number);
+    constructor();
+}

package/types/physics/shape/index.d.ts

@@ -0,0 +1,5 @@
+export { ColliderShape } from "./ColliderShape";
+export { BoxColliderShape } from "./BoxColliderShape";
+export { SphereColliderShape } from "./SphereColliderShape";
+export { PlaneColliderShape } from "./PlaneColliderShape";
+export { CapsuleColliderShape } from "./CapsuleColliderShape";

package/types/renderingHardwareInterface/IHardwareRenderer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hardware graphics API renderer.
+ */
+export interface IHardwareRenderer {
+    [key: string]: any;
+}

package/types/renderingHardwareInterface/IPlatformBuffer.d.ts

@@ -0,0 +1,8 @@
+import { SetDataOptions } from "../graphic";
+export interface IPlatformBuffer {
+    bind(): void;
+    setData(byteLength: number, data: ArrayBuffer | ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number, options?: SetDataOptions): void;
+    getData(data: ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number): void;
+    resize(byteLength: number): void;
+    destroy(): void;
+}

package/types/renderingHardwareInterface/IPlatformRenderTarget.d.ts

@@ -0,0 +1,20 @@
+import { TextureCubeFace } from "../texture";
+/**
+ * Off-screen rendering target specification.
+ */
+export interface IPlatformRenderTarget {
+    /**
+     * Set which face and mipLevel of the cube texture to render to.
+     * @param faceIndex - Cube texture face
+     * @param mipLevel - Set mip level the data want to write
+     */
+    setRenderTargetInfo(faceIndex: TextureCubeFace, mipLevel: number): void;
+    /**
+     * Blit FBO.
+     */
+    blitRenderTarget(): void;
+    /**
+     * Destroy render target.
+     */
+    destroy(): void;
+}

package/types/renderingHardwareInterface/IPlatformTexture.d.ts

@@ -0,0 +1,36 @@
+import { TextureFilterMode, TextureWrapMode } from "../texture";
+import { TextureDepthCompareFunction } from "../texture/enums/TextureDepthCompareFunction";
+/**
+ * Texture interface specification.
+ */
+export interface IPlatformTexture {
+    /**
+     * Wrapping mode for texture coordinate S.
+     */
+    wrapModeU: TextureWrapMode;
+    /**
+     * Wrapping mode for texture coordinate T.
+     */
+    wrapModeV: TextureWrapMode;
+    /**
+     * Filter mode for texture.
+     */
+    filterMode: TextureFilterMode;
+    /**
+     * Anisotropic level for texture.
+     */
+    anisoLevel: number;
+    /**
+     *  Filter mode when texture as depth Texture.
+     */
+    depthCompareFunction: TextureDepthCompareFunction;
+    /**
+     * Destroy texture.
+     */
+    destroy(): void;
+    /**
+     * Generate multi-level textures based on the 0th level data.
+     */
+    generateMipmaps(): void;
+    setUseDepthCompareMode(value: boolean): any;
+}

package/types/renderingHardwareInterface/IPlatformTexture2D.d.ts

@@ -0,0 +1,37 @@
+import { IPlatformTexture } from "./IPlatformTexture";
+/**
+ * 2D texture interface specification.
+ */
+export interface IPlatformTexture2D extends IPlatformTexture {
+    /**
+     * 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.
+     * @param colorBuffer - Color buffer data
+     * @param mipLevel - Texture mipmapping level
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     * @param width - Data width. if it's empty, width is the width corresponding to mipLevel minus x , width corresponding to mipLevel is Math.max(1, this.width >> mipLevel)
+     * @param height - Data height. if it's empty, height is the height corresponding to mipLevel minus y , height corresponding to mipLevel is Math.max(1, this.height >> mipLevel)
+     */
+    setPixelBuffer(colorBuffer: ArrayBufferView, mipLevel: number, x: number, y: number, width?: number, height?: number): void;
+    /**
+     * Setting pixels data through TexImageSource, designated area and texture mipmapping level.
+     * @param imageSource - The source of texture
+     * @param mipLevel - Texture mipmapping level
+     * @param flipY - Whether to flip the Y axis
+     * @param premultiplyAlpha - Whether to premultiply the transparent channel
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     */
+    setImageSource(imageSource: TexImageSource | OffscreenCanvas, mipLevel: number, flipY: boolean, premultiplyAlpha: boolean, x: number, y: number): void;
+    /**
+     * Get the pixel color buffer according to the specified area.
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     * @param width - Area width
+     * @param height - Area height
+     * @param mipLevel - Set mip level the data want to get from
+     * @param out - Color buffer
+     */
+    getPixelBuffer(x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
+}

package/types/renderingHardwareInterface/IPlatformTexture2DArray.d.ts

@@ -0,0 +1,40 @@
+import { IPlatformTexture } from "./IPlatformTexture";
+/**
+ * 2D texture array interface specification.
+ */
+export interface IPlatformTexture2DArray extends IPlatformTexture {
+    /**
+     * Setting pixels data through color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
+     * @param offsetIndex - The texture array element offset index
+     * @param colorBuffer - Color buffer data
+     * @param mipLevel - Texture mipmapping level
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     * @param width - Data width. if it's empty, width is the width corresponding to mipLevel minus x , width corresponding to mipLevel is Math.max(1, this.width >> mipLevel)
+     * @param height - Data height. if it's empty, height is the height corresponding to mipLevel minus y , height corresponding to mipLevel is Math.max(1, this.height >> mipLevel)
+     * @param length - Data length.
+     */
+    setPixelBuffer(offsetIndex: number, colorBuffer: ArrayBufferView, mipLevel: number, x: number, y: number, width?: number, height?: number, length?: number): void;
+    /**
+     * Setting pixels data through TexImageSource, designated area and texture mipmapping level.
+     * @param index - The texture array element index
+     * @param imageSource - The source of texture
+     * @param mipLevel - Texture mipmapping level
+     * @param flipY - Whether to flip the Y axis
+     * @param premultiplyAlpha - Whether to premultiply the transparent channel
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     */
+    setImageSource(index: number, imageSource: TexImageSource | OffscreenCanvas, mipLevel: number, flipY: boolean, premultiplyAlpha: boolean, x: number, y: number): void;
+    /**
+     * Get the pixel color buffer according to the specified area.
+     * @param elementIndex - The texture array element index
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     * @param width - Area width
+     * @param height - Area height
+     * @param mipLevel - Set mip level the data want to get from
+     * @param out - Color buffer
+     */
+    getPixelBuffer(elementIndex: number, x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
+}

package/types/renderingHardwareInterface/IPlatformTextureCube.d.ts

@@ -0,0 +1,41 @@
+import { TextureCubeFace } from "../texture";
+import { IPlatformTexture } from "./IPlatformTexture";
+/**
+ * Cube texture interface specification.
+ */
+export interface IPlatformTextureCube extends IPlatformTexture {
+    /**
+     * Setting pixels data through cube face,color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
+     * @remarks When compressed texture is in WebGL1, the texture must be filled first before writing the sub-region
+     * @param face - Cube face
+     * @param colorBuffer - Color buffer data
+     * @param mipLevel - Texture mipmapping level
+     * @param x - X coordinate of area start
+     * @param y -  Y coordinate of area start
+     * @param width - Data width.if it's empty, width is the width corresponding to mipLevel minus x , width corresponding to mipLevel is Math.max(1, this.width >> mipLevel)
+     * @param height - Data height.if it's empty, height is the height corresponding to mipLevel minus y , height corresponding to mipLevel is Math.max(1, this.height >> mipLevel)
+     */
+    setPixelBuffer(face: TextureCubeFace, colorBuffer: ArrayBufferView, mipLevel: number, x: number, y: number, width?: number, height?: number): void;
+    /**
+     * Setting pixels data through cube face, TexImageSource, designated area and texture mipmapping level.
+     * @param face - Cube face
+     * @param imageSource - The source of texture
+     * @param mipLevel - Texture mipmapping level
+     * @param flipY - Whether to flip the Y axis
+     * @param premultiplyAlpha - Whether to premultiply the transparent channel
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     */
+    setImageSource(face: TextureCubeFace, imageSource: TexImageSource | OffscreenCanvas, mipLevel: number, flipY: boolean, premultiplyAlpha: boolean, x: number, y: number): void;
+    /**
+     * Get the pixel color buffer according to the specified cube face and area.
+     * @param face - You can choose which cube face to read
+     * @param x - X coordinate of area start
+     * @param y - Y coordinate of area start
+     * @param width - Area width
+     * @param height - Area height
+     * @param mipLevel - Set mip level the data want to get from
+     * @param out - Color buffer
+     */
+    getPixelBuffer(face: TextureCubeFace, x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
+}

package/types/renderingHardwareInterface/index.d.ts

@@ -0,0 +1,6 @@
+export type { IHardwareRenderer } from "./IHardwareRenderer";
+export type { IPlatformRenderTarget } from "./IPlatformRenderTarget";
+export type { IPlatformTexture } from "./IPlatformTexture";
+export type { IPlatformTexture2D } from "./IPlatformTexture2D";
+export type { IPlatformTexture2DArray } from "./IPlatformTexture2DArray";
+export type { IPlatformTextureCube } from "./IPlatformTextureCube";

package/types/shader/Shader.d.ts

@@ -0,0 +1,72 @@
+import { Engine } from "../Engine";
+import { ShaderMacro } from "./ShaderMacro";
+import { ShaderPass } from "./ShaderPass";
+import { ShaderProperty } from "./ShaderProperty";
+/**
+ * Shader for rendering.
+ */
+export declare class Shader {
+    private static _shaderMap;
+    private static _propertyNameMap;
+    private static _macroMaskMap;
+    private static _macroCounter;
+    private static _macroMap;
+    /**
+     * Create a shader.
+     * @param name - Name of the shader
+     * @param vertexSource - Vertex source code
+     * @param fragmentSource - Fragment source code
+     * @returns Shader
+     */
+    static create(name: string, vertexSource: string, fragmentSource: string): Shader;
+    /**
+     * Create a shader.
+     * @param name - Name of the shader
+     * @param shaderPasses - Shader passes
+     * @returns Shader
+     */
+    static create(name: string, shaderPasses: ShaderPass[]): Shader;
+    /**
+     * Find a shader by name.
+     * @param name - Name of the shader
+     */
+    static find(name: string): Shader;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @returns Shader macro
+     */
+    static getMacroByName(name: string): ShaderMacro;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @param value - Value of the shader macro
+     * @returns Shader macro
+     */
+    static getMacroByName(name: string, value: string): ShaderMacro;
+    /**
+     * Get shader property by name.
+     * @param name - Name of the shader property
+     * @returns Shader property
+     */
+    static getPropertyByName(name: string): ShaderProperty;
+    /** The name of shader. */
+    readonly name: string;
+    /**
+     *  Shader passes.
+     */
+    get passes(): ReadonlyArray<ShaderPass>;
+    private _passes;
+    private constructor();
+    /**
+     * Compile shader variant by macro name list.
+     *
+     * @remarks
+     * Usually a shader contains some macros,any combination of macros is called shader variant.
+     *
+     * @param engine - Engine to which the shader variant belongs
+     * @param macros - Macro name list
+     * @returns Is the compiled shader variant valid
+     */
+    compileVariant(engine: Engine, macros: string[]): boolean;
+}