@galacean/engine-core 1.3.0-alpha.1 → 1.3.0-alpha.2

package/package.json

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

package/types/Camera.d.ts

@@ -5,6 +5,7 @@ import { CameraClearFlags } from "./enums/CameraClearFlags";
 import { DepthTextureMode } from "./enums/DepthTextureMode";
 import { Downsampling } from "./enums/Downsampling";
 import { MSAASamples } from "./enums/MSAASamples";
+import { ReplacementFailureStrategy } from "./enums/ReplacementFailureStrategy";
 import { Shader } from "./shader/Shader";
 import { ShaderData } from "./shader/ShaderData";
 import { ShaderTagKey } from "./shader/ShaderTagKey";
@@ -254,22 +255,24 @@ export declare class Camera extends Component {
      * Set the replacement shader.
      * @param shader - Replacement shader
      * @param replacementTagName - Sub shader tag name
+     * @param failureStrategy - Replacement failure strategy, @defaultValue `ReplacementFailureStrategy.KeepOriginalShader`
      *
      * @remarks
      * If replacementTagName is not specified, the first sub shader will be replaced.
-     * If replacementTagName is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey.
+     * If replacementTagName is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey. If failed to find the sub shader, the strategy will be determined by failureStrategy.
      */
-    setReplacementShader(shader: Shader, replacementTagName?: string): any;
+    setReplacementShader(shader: Shader, replacementTagName?: string, failureStrategy?: ReplacementFailureStrategy): any;
     /**
      * Set the replacement shader.
      * @param shader - Replacement shader
      * @param replacementTag - Sub shader tag
+     * @param failureStrategy - Replacement failure strategy, @defaultValue `ReplacementFailureStrategy.KeepOriginalShader`
      *
      * @remarks
      * If replacementTag is not specified, the first sub shader will be replaced.
-     * If replacementTag is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey.
+     * If replacementTag is specified, the replacement shader will find the first sub shader which has the same tag value get by replacementTagKey. If failed to find the sub shader, the strategy will be determined by failureStrategy.
      */
-    setReplacementShader(shader: Shader, replacementTag?: ShaderTagKey): any;
+    setReplacementShader(shader: Shader, replacementTag?: ShaderTagKey, failureStrategy?: ReplacementFailureStrategy): any;
     /**
      * Reset and clear the replacement shader.
      */

package/types/enums/ReplacementFailureStrategy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The strategy to use when a shader replacement fails.
+ */
+export declare enum ReplacementFailureStrategy {
+    /** Keep the original shader. */
+    KeepOriginalShader = 0,
+    /** Do not render. */
+    DoNotRender = 1
+}

package/types/index.d.ts

@@ -31,6 +31,7 @@ export { FogMode } from "./enums/FogMode";
 export { CameraClearFlags } from "./enums/CameraClearFlags";
 export { CameraType } from "./enums/CameraType";
 export { MSAASamples } from "./enums/MSAASamples";
+export { ReplacementFailureStrategy } from "./enums/ReplacementFailureStrategy";
 export { Downsampling } from "./enums/Downsampling";
 export { ColorSpace } from "./enums/ColorSpace";
 export { BackgroundTextureFillMode } from "./enums/BackgroundTextureFillMode";

package/types/shader/ShaderPass.d.ts

@@ -6,6 +6,11 @@ export declare class ShaderPass extends ShaderPart {
     private static _shaderPassCounter;
     private _vertexSource;
     private _fragmentSource;
+    private readonly _type;
+    private readonly _shaderLabSource;
+    private readonly _vertexEntry;
+    private readonly _fragmentEntry;
+    private _platformMacros;
     /**
      * Create a shader pass.
      * @param name - Shader pass name
@@ -21,4 +26,9 @@ export declare class ShaderPass extends ShaderPart {
      * @param tags - Tags
      */
     constructor(vertexSource: string, fragmentSource: string, tags?: Record<string, number | string | boolean>);
+    /**
+     * Shader Lab compilation
+     */
+    private _compileShaderProgram;
+    private _getCanonicalShaderProgram;
 }

package/types/shader/index.d.ts

@@ -7,6 +7,7 @@ export { RenderStateElementKey as RenderStateDataKey } from "./enums/RenderState
 export { RenderQueueType } from "./enums/RenderQueueType";
 export { ShaderPropertyType } from "./enums/ShaderPropertyType";
 export { StencilOperation } from "./enums/StencilOperation";
+export { ShaderPlatformTarget } from "./enums/ShaderPlatformTarget";
 export { Shader } from "./Shader";
 export { ShaderData } from "./ShaderData";
 export { ShaderMacro } from "./ShaderMacro";

package/types/shaderlib/ShaderFactory.d.ts

@@ -1,6 +1,7 @@
+import { ShaderMacro } from "../shader/ShaderMacro";
 export declare class ShaderFactory {
     private static readonly _has300OutInFragReg;
-    static parseCustomMacros(macros: string[]): string;
+    static parseCustomMacros(macros: ShaderMacro[]): string;
     static registerInclude(includeName: string, includeSource: string): void;
     static unRegisterInclude(includeName: string): void;
     /**

package/types/2d/assembler/IAssembler.d.ts

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

package/types/2d/data/VertexData2D.d.ts

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

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

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

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

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

package/types/Deprecated.d.ts

@@ -1,101 +0,0 @@
-/**
- * @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/Basic2DBatcher.d.ts

@@ -1,19 +0,0 @@
-import { Camera } from "../Camera";
-import { Engine } from "../Engine";
-import { ShaderTagKey } from "../shader/ShaderTagKey";
-import { RenderElement } from "./RenderElement";
-export declare abstract class Basic2DBatcher {
-    protected static _disableBatchTag: ShaderTagKey;
-    /** The maximum number of vertex. */
-    static MAX_VERTEX_COUNT: number;
-    static _canUploadSameBuffer: boolean;
-    constructor(engine: Engine);
-    drawElement(element: RenderElement, camera: Camera): void;
-    flush(camera: Camera): void;
-    clear(): void;
-    destroy(): void;
-    private _drawSubElement;
-    private _createMesh;
-    private _updateData;
-    private _getSubMeshFromPool;
-}

package/types/RenderPipeline/Chunk.d.ts

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

package/types/RenderPipeline/ClassPool.d.ts

@@ -1,19 +0,0 @@
-import { IPoolElement } from "./IPoolElement";
-/**
- * Class pool utils.
- */
-export declare class ClassPool<T extends IPoolElement> {
-    private _elementPoolIndex;
-    private _elementPool;
-    private _type;
-    constructor(type: new () => T);
-    /**
-     * Get element from pool.
-     */
-    getFromPool(): T;
-    /**
-     * Reset pool.
-     */
-    resetPool(): void;
-    garbageCollection(): void;
-}

package/types/RenderPipeline/DynamicGeometryData.d.ts

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

package/types/RenderPipeline/DynamicGeometryDataManager.d.ts

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

package/types/RenderPipeline/IPoolElement.d.ts

@@ -1,3 +0,0 @@
-export interface IPoolElement {
-    dispose?(): void;
-}

package/types/RenderPipeline/RenderData.d.ts

@@ -1,14 +0,0 @@
-import { SubMesh } from "../graphic";
-import { Primitive } from "../graphic/Primitive";
-import { Material } from "../material";
-import { Renderer } from "../Renderer";
-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/RenderData2D.d.ts

@@ -1,14 +0,0 @@
-import { Primitive, SubMesh } from "../graphic";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { Texture2D } from "../texture";
-import { IPoolElement } from "../utils/Pool";
-import { Chunk } from "./DynamicGeometryData";
-import { RenderData } from "./RenderData";
-export declare class RenderData2D extends RenderData implements IPoolElement {
-    texture: Texture2D;
-    chunk: Chunk;
-    constructor();
-    set(component: Renderer, material: Material, primitive: Primitive, subPrimitive: SubMesh, texture?: Texture2D, chunk?: Chunk): void;
-    dispose(): void;
-}

package/types/RenderPipeline/RenderPass.d.ts

@@ -1,55 +0,0 @@
-import { Color } from "@galacean/engine-math";
-import { Camera } from "../Camera";
-import { CameraClearFlags } from "../enums/CameraClearFlags";
-import { Layer } from "../Layer";
-import { Material } from "../material/Material";
-import { RenderTarget } from "../texture/RenderTarget";
-import { RenderQueue } from "./RenderQueue";
-/**
- * RenderPass.
- */
-declare class RenderPass {
-    name: string;
-    enabled: boolean;
-    priority: number;
-    renderTarget: RenderTarget;
-    replaceMaterial: Material;
-    mask: Layer;
-    renderOverride: boolean;
-    clearFlags: CameraClearFlags | undefined;
-    clearColor: Color | undefined;
-    /**
-     * Create a RenderPass.
-     * @param name - Pass name
-     * @param priority - Priority, less than 0 before the default pass, greater than 0 after the default pass
-     * @param renderTarget - The specified Render Target
-     * @param replaceMaterial - Replaced material
-     * @param mask - Perform bit and operations with Entity.Layer to filter the objects that this Pass needs to render
-     */
-    constructor(name?: string, priority?: number, renderTarget?: any, replaceMaterial?: any, mask?: any);
-    /**
-     * Rendering callback, will be executed if renderOverride is set to true.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    render(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-    /**
-     * Post rendering callback.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    preRender(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-    /**
-     * Post rendering callback.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    postRender(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-}
-export { RenderPass };

package/types/RenderPipeline/SpriteBatcher.d.ts

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

package/types/RenderPipeline/SpriteMaskBatcher.d.ts

@@ -1,11 +0,0 @@
-import { Camera } from "../Camera";
-import { VertexElement } from "../graphic/VertexElement";
-import { Basic2DBatcher } from "./Basic2DBatcher";
-import { RenderElement } from "./RenderElement";
-import { SpriteMaskRenderData } from "./SpriteMaskRenderData";
-export declare class SpriteMaskBatcher extends Basic2DBatcher {
-    createVertexElements(vertexElements: VertexElement[]): number;
-    canBatch(preElement: RenderElement, curElement: RenderElement): boolean;
-    updateVertices(element: SpriteMaskRenderData, vertices: Float32Array, vertexIndex: number): number;
-    drawBatches(camera: Camera): void;
-}

package/types/RenderPipeline/SpriteMaskManager.d.ts

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

package/types/RenderPipeline/SpriteMaskRenderData.d.ts

@@ -1,12 +0,0 @@
-import { VertexData2D } from "../2d/data/VertexData2D";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { IPoolElement } from "./IPoolElement";
-import { RenderData } from "./RenderData";
-export declare class SpriteMaskRenderData extends RenderData implements IPoolElement {
-    isAdd: boolean;
-    verticesData: VertexData2D;
-    constructor();
-    set(component: Renderer, material: Material, verticesData: VertexData2D): void;
-    dispose(): void;
-}

package/types/RenderPipeline/SpriteRenderData.d.ts

@@ -1,14 +0,0 @@
-import { VertexData2D } from "../2d/data/VertexData2D";
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { Texture2D } from "../texture";
-import { IPoolElement } from "./IPoolElement";
-import { RenderData } from "./RenderData";
-export declare class SpriteRenderData extends RenderData implements IPoolElement {
-    verticesData: VertexData2D;
-    texture: Texture2D;
-    dataIndex: number;
-    constructor();
-    set(component: Renderer, material: Material, verticesData: VertexData2D, texture: Texture2D, dataIndex?: number): void;
-    dispose(): void;
-}

package/types/RenderPipeline/TextRenderData.d.ts

@@ -1,8 +0,0 @@
-import { IPoolElement } from "./IPoolElement";
-import { RenderData } from "./RenderData";
-import { SpriteRenderData } from "./SpriteRenderData";
-export declare class TextRenderData extends RenderData implements IPoolElement {
-    charsData: SpriteRenderData[];
-    constructor();
-    dispose(): void;
-}

package/types/RenderPipeline/batcher/MeshBuffer.d.ts

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

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

@@ -1,15 +0,0 @@
-/**
- * Force upload shader data flag.
- */
-export declare enum ForceUploadShaderDataFlag {
-    /** Upload nothing. */
-    None = 0,
-    /** Upload scene shader data. */
-    Scene = 1,
-    /** Upload camera shader data. */
-    Camera = 2,
-    /** Upload renderer shader data. */
-    Renderer = 4,
-    /** Upload material shader data. */
-    Material = 8
-}

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

@@ -1,13 +0,0 @@
-/**
- * This enum describes what should be done on the render target when the GPU is done rendering into it.
- */
-export declare enum RenderBufferStoreAction {
-    /**
-     * Do nothing after rendering.
-     */
-    DontCare = 0,
-    /**
-     * Blit the MSAA render target after rendering.
-     */
-    BlitMSAA = 1
-}

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

@@ -1,13 +0,0 @@
-/**
- * RenderData usage.
- */
-export declare enum RenderDataUsage {
-    /** Usage for mesh. */
-    Mesh = 0,
-    /** Usage for sprite. */
-    Sprite = 1,
-    /** Usage for sprite mask. */
-    SpriteMask = 2,
-    /** Usage for text. */
-    Text = 3
-}

package/types/animation/AnimatorTransition.d.ts

@@ -1,14 +0,0 @@
-import { AnimatorState } from "./AnimatorState";
-/**
- * Transitions define when and how the state machine switch from on state to another. AnimatorTransition always originate from a StateMachine or a StateMachine entry.
- */
-export declare class AnimatorStateTransition {
-    /** The duration of the transition. This is represented in normalized time. */
-    duration: number;
-    /** The time at which the destination state will start. This is represented in normalized time. */
-    offset: number;
-    /** ExitTime represents the exact time at which the transition can take effect. This is represented in normalized time. */
-    exitTime: number;
-    /** The destination state of the transition. */
-    destinationState: AnimatorState;
-}

package/types/postProcess/PostProcessEffect.d.ts

@@ -1,13 +0,0 @@
-import { RenderContext } from "../RenderPipeline/RenderContext";
-import { RenderTarget, Texture2D } from "../texture";
-export declare abstract class PostProcessEffect {
-    readonly engine: any;
-    private _enabled;
-    /**
-     * Indicates whether the post process effect is enabled.
-     */
-    get enabled(): boolean;
-    set enabled(value: boolean);
-    constructor(engine: any);
-    abstract onRender(context: RenderContext, srcTexture: Texture2D, destRenderTarget: RenderTarget): void;
-}

package/types/postProcess/PostProcessPass.d.ts

@@ -1,55 +0,0 @@
-import { Engine } from "../Engine";
-import { PipelinePass } from "../RenderPipeline/PipelinePass";
-import { RenderContext } from "../RenderPipeline/RenderContext";
-import { PostProcessEffect } from "./PostProcessEffect";
-export declare class PostProcessPass extends PipelinePass {
-    private _isActive;
-    private _effects;
-    /** The name of pass. */
-    name: string;
-    /**
-     * Whether to activate current post process.
-     */
-    get isActive(): boolean;
-    set isActive(value: boolean);
-    /**
-     * Get the post process effect list.
-     */
-    get effects(): ReadonlyArray<PostProcessEffect>;
-    /**
-     * Create a post process pass.
-     * @param engine - The engine the pass belongs to
-     * @param name - The pass name if need
-     */
-    constructor(engine: Engine, name?: string);
-    onRender(context: RenderContext): void;
-    /**
-     * Get post process effect which match the type.
-     * @param type - The type of the post process effect
-     * @returns The first post process effect which match type
-     */
-    getEffect(type: typeof PostProcessEffect): PostProcessEffect | null;
-    /**
-     * Get post process effects which match the type.
-     * @param type - The type of the post process effect
-     * @param results - The effects which match type
-     * @returns The effects which match type
-     */
-    getEffects(type: typeof PostProcessEffect, results: PostProcessEffect[]): PostProcessEffect[];
-    /**
-     * Add post process effect.
-     * @param effect - The post process effect want to be added
-     */
-    addEffect(effect: PostProcessEffect): void;
-    /**
-     * Add post process at specified index.
-     * @param indexOrEffect - Specified index
-     * @param effect - The post process effect want to be added
-     */
-    addEffect(index: number, effect: PostProcessEffect): void;
-    /**
-     * Remove post process effect.
-     * @param effect - The post process effect want to be removed
-     */
-    removeEffect(effect: PostProcessEffect): void;
-}

package/types/renderingHardwareInterface/IHardwareRenderer.d.ts

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

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

@@ -1,73 +0,0 @@
-/**
- * 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
-}