@galacean/effects-webgl 2.6.6 → 2.7.0-alpha.0

package/dist/gl-engine.d.ts

@@ -1,11 +1,328 @@
-import { Engine } from '@galacean/effects-core';
 import type { GLRendererInternal } from './gl-renderer-internal';
 import type { GLRenderer } from './gl-renderer';
-import type { GLPipelineContext } from './gl-pipeline-context';
+import { GLShaderLibrary } from './gl-shader-library';
+import type { Nullable, Texture, math } from '@galacean/effects-core';
+import { Engine } from '@galacean/effects-core';
+type Color = math.Color;
+type Vector2 = math.Vector2;
+type Vector3 = math.Vector3;
+type Vector4 = math.Vector4;
+type Matrix3 = math.Matrix3;
+type Matrix4 = math.Matrix4;
+type Quaternion = math.Quaternion;
 export declare class GLEngine extends Engine {
+    gl: WebGLRenderingContext | WebGL2RenderingContext;
+    textureUnitDict: Record<string, WebGLTexture | null>;
+    shaderLibrary: GLShaderLibrary;
+    private readonly maxTextureCount;
+    private glCapabilityCache;
+    private currentFramebuffer;
+    private currentTextureBinding;
+    private currentRenderbuffer;
+    private activeTextureIndex;
+    private pixelStorei;
     constructor(gl: WebGLRenderingContext | WebGL2RenderingContext);
     dispose(): void;
     getGLRenderer(): GLRenderer;
     getGLRendererInternal(): GLRendererInternal;
-    getGLPipelineContext(): GLPipelineContext;
+    private reset;
+    toggle(capability: GLenum, enable?: boolean): void;
+    /**
+     * 对于该上下文开启某种特性
+     * @param capability
+     * example:
+     * gl.enable(gl.DITHER);
+     */
+    enable(capability: GLenum): void;
+    /**
+     * 基于某种上下文关闭特性
+     * @param capability
+     * example:
+     * gl.disable(gl.DITHER);
+     */
+    disable(capability: GLenum): void;
+    /**
+     * 绑定framebuffer webgl2新增: gl.DRAW_FRAMEBUFFER 和 gl.READ_FRAMEBUFFER
+     * @param target
+     * @param framebuffer
+     * example:
+     * const framebuffer = gl.createFramebuffer();
+     * gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+     */
+    bindFramebuffer(target: GLenum, framebuffer: WebGLFramebuffer | null): void;
+    bindRenderbuffer(target: GLenum, renderbuffer: WebGLRenderbuffer | null): void;
+    /**
+     * 绑定系统 framebuffer
+     */
+    bindSystemFramebuffer(): void;
+    /**
+     * 将定义好的 WebGLProgram 对象添加到当前的渲染状态中。
+     * @param program
+     * example:
+     * gl.useProgram(program);
+     * gl.useProgram(null);
+     */
+    useProgram(program: WebGLProgram | null): void;
+    /**
+     * 使用预设值来清空缓冲
+     * @param mask
+     * example:
+     * gl.clear(gl.DEPTH_BUFFER_BIT);
+     * gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
+     */
+    clear(mask: number): void;
+    /*** depth start ***/
+    /**
+     * 设置深度缓冲区的深度清除值
+     * @param depth
+     * example:
+     * gl.clearDepth(0.5);
+     */
+    clearDepth(depth: GLclampf): void;
+    /**
+     * 指定将输入像素深度与当前深度缓冲区值进行比较的函数。
+     * @param func
+     * example:
+     * gl.enable(gl.DEPTH_TEST);
+     * gl.depthFunc(gl.NEVER);
+     */
+    depthFunc(func: GLenum): void;
+    /**
+     * 设置是否启用写入深度缓冲。
+     * @param flag
+     * example:
+     * gl.depthMask(false);
+     */
+    depthMask(flag: boolean): void;
+    polygonOffset(factor: number, unit: number): void;
+    /**
+     * 将 z 值从规范化设备坐标映射到窗口坐标
+     * @param zNear
+     * @param zFar
+     * example:
+     * gl.depthRange(0.2, 0.6);
+     */
+    depthRange(zNear: number, zFar: number): void;
+    /*** depth end ***/
+    /*** stencil start ***/
+    /**
+     * 模版测试设置函数和引用值。
+     * @param func
+     * @param ref
+     * @param mask
+     * example:
+     * gl.enable(gl.STENCIL_TEST);
+     * gl.stencilFunc(gl.LESS, 0, 0b1110011);
+     */
+    clearStencil(s: GLint): void;
+    /**
+     * 控制启用和禁用模板平面中单个位的正面和背面写入
+     * @param mask
+     * example:
+     * gl.stencilMask(0xff);
+     */
+    stencilMask(mask: number): void;
+    /**
+     * 模版测试设置函数和引用值。
+     * @param func
+     * @param ref
+     * @param mask
+     * example:
+     * gl.enable(gl.STENCIL_TEST);
+     * gl.stencilFunc(gl.LESS, 0, 0b1110011);
+     */
+    stencilFunc(func: GLenum, ref: GLint, mask: GLuint): void;
+    /**
+     * 单面模版测试
+     * @param face
+     * @param func
+     * @param ref
+     * @param mask
+     * example:
+     * gl.enable(gl.STENCIL_TEST);
+     * gl.stencilFuncSeparate(gl.FRONT, gl.LESS, 0.2, 1110011);
+     */
+    stencilFuncSeparate(face: GLenum, func: GLenum, ref: GLint, mask: GLuint): void;
+    /**
+     * 单面的mask写入
+     * @param face
+     * @param mask
+     * example:
+     * gl.stencilMaskSeparate(gl.FRONT, 110101);
+     */
+    stencilMaskSeparate(face: GLenum, mask: GLuint): void;
+    /**
+     * 设置正面和背面模板测试操作
+     * @param fail
+     * @param zfail
+     * @param zpass
+     * example:
+     * gl.enable(gl.STENCIL_TEST);
+     * gl.stencilOp(gl.INCR, gl.DECR, gl.INVERT);
+     */
+    stencilOp(fail: GLenum, zfail: GLenum, zpass: GLenum): void;
+    /**
+     * 设置正面和/或背面模板测试操作
+     * @param face
+     * @param fail
+     * @param zfail
+     * @param zpass
+     * example:
+     * gl.enable(gl.STENCIL_TEST);
+     * gl.stencilOpSeparate(gl.FRONT, gl.INCR, gl.DECR, gl.INVERT);
+     */
+    stencilOpSeparate(face: GLenum, fail: GLenum, zfail: GLenum, zpass: GLenum): void;
+    /*** stencil end ***/
+    /*** face start ***/
+    /**
+     * 剔除方式
+     * @param mode
+     * example:
+     * gl.enable(gl.CULL_FACE);
+     * gl.cullFace(gl.FRONT_AND_BACK);
+     */
+    cullFace(mode: GLenum): void;
+    /**
+     * 设置卷绕方向
+     * @param mode
+     * example:
+     * gl.frontFace(gl.CW);
+     */
+    frontFace(mode: GLenum): void;
+    /*** face end ***/
+    /*** color start ***/
+    /**
+     * 设置颜色写入
+     * @param red
+     * @param green
+     * @param blue
+     * @param alpha
+     * example:
+     * gl.colorMask(true, true, true, false);
+     */
+    clearColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void;
+    /**
+     * 设置颜色写入
+     * @param red
+     * @param green
+     * @param blue
+     * @param alpha
+     * example:
+     * gl.colorMask(true, true, true, false);
+     */
+    colorMask(red: boolean, green: boolean, blue: boolean, alpha: boolean): void;
+    /**
+     * 设置源和目标混合因子
+     * @param red
+     * @param green
+     * @param blue
+     * @param alpha
+     * example:
+     * gl.blendColor(0, 0.5, 1, 1);
+     */
+    blendColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void;
+    /**
+     * 用于混合像素算法
+     * @param sfactor
+     * @param dfactor
+     * example:
+     * gl.enable(gl.BLEND);
+     * gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);
+     */
+    blendFunc(sfactor: GLenum, dfactor: GLenum): void;
+    /**
+     * 分别设置应用在 RGB 和 Alpha 上的 factor
+     * @param srcRGB
+     * @param dstRGB
+     * @param srcAlpha
+     * @param dstAlpha
+     * example:
+     * gl.enable(gl.BLEND);
+     * gl.blendFuncSeparate(gl.SRC_COLOR, gl.DST_COLOR, gl.ONE, gl.ZERO);
+     */
+    blendFuncSeparate(srcRGB: GLenum, dstRGB: GLenum, srcAlpha: GLenum, dstAlpha: GLenum): void;
+    /**
+     * 设置混合模式
+     * @param mode
+     * example:
+     * gl.blendEquation(gl.FUNC_ADD);
+     * gl.blendEquation(gl.FUNC_SUBTRACT);
+     * gl.blendEquation(gl.FUNC_REVERSE_SUBTRACT);
+     */
+    blendEquation(mode: GLenum): void;
+    /**
+     * 可以分别对 RGB 和 Alpha 做不同的操作处理
+     * @param modeRGB
+     * @param modeAlpha
+     * example:
+     * gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_SUBTRACT);
+     */
+    blendEquationSeparate(modeRGB: GLenum, modeAlpha: GLenum): void;
+    /*** color end ***/
+    /**
+     * 图像预处理
+     * @param pname
+     * @param param
+     * example:
+     * var tex = gl.createTexture();
+     * gl.bindTexture(gl.TEXTURE_2D, tex);
+     * gl.pixelStorei(gl.PACK_ALIGNMENT, 4);
+     */
+    setPixelStorei(pname: GLenum, param: GLenum): void;
+    /**
+     * 用来设置视口，即指定从标准设备到窗口坐标的x、y仿射变换。
+     * @param x
+     * @param y
+     * @param width
+     * @param height
+     * example:
+     * gl.viewport(0, 0, width, height);
+     */
+    viewport(x: number, y: number, width: number, height: number): void;
+    /**
+     * 激活指定的纹理单元
+     * @param texture
+     * example:
+     * gl.activeTexture(gl.TEXTURE1);
+     */
+    activeTexture(texture: GLenum): void;
+    /**
+     * 绑定WebGLTexture
+     * @param target
+     * @param texture
+     * @param force
+     * example:
+     * const texture = gl.createTexture();
+     * gl.bindTexture(gl.TEXTURE_2D, texture)
+     */
+    bindTexture(target: GLenum, texture: WebGLTexture | null, force?: boolean): void;
+    private set1;
+    private set2;
+    private set3;
+    private set4;
+    get(name: string): any;
+    setFloat(uniform: Nullable<WebGLUniformLocation>, value: number): void;
+    setInt(uniform: Nullable<WebGLUniformLocation>, value: number): void;
+    setFloats(uniform: Nullable<WebGLUniformLocation>, value: number[]): void;
+    setVector2(uniform: Nullable<WebGLUniformLocation>, value: Vector2): void;
+    setVector3(uniform: Nullable<WebGLUniformLocation>, value: Vector3): void;
+    setVector4(uniform: Nullable<WebGLUniformLocation>, value: Vector4): void;
+    setColor(uniform: Nullable<WebGLUniformLocation>, value: Color): void;
+    setQuaternion(uniform: Nullable<WebGLUniformLocation>, value: Quaternion): void;
+    setVector4Array(uniform: Nullable<WebGLUniformLocation>, array: number[]): void;
+    setMatrix(uniform: Nullable<WebGLUniformLocation>, value: Matrix4): void;
+    setMatrix3(uniform: Nullable<WebGLUniformLocation>, value: Matrix3): void;
+    setMatrixArray(uniform: Nullable<WebGLUniformLocation>, array: number[]): void;
+    setTexture(uniform: Nullable<WebGLUniformLocation>, channel: number, texture: Texture): void;
+    /**
+     * 查询所有uniform的location。
+     * @param program 查询的shader program
+     * @param uniformsNames 查询的uniform名称列表
+     * @returns
+     */
+    getUniforms(program: WebGLProgram, uniformsNames: string[]): Nullable<WebGLUniformLocation>[];
+    private setFloat4;
+    private setFloat3;
+    private setFloat2;
 }
+export {};

package/dist/gl-geometry.d.ts

@@ -2,7 +2,6 @@ import type { Engine, GeometryProps, SkinProps } from '@galacean/effects-core';
 import { spec, Geometry } from '@galacean/effects-core';
 import type { GLGPUBufferProps } from './gl-gpu-buffer';
 import { GLGPUBuffer } from './gl-gpu-buffer';
-import type { GLPipelineContext } from './gl-pipeline-context';
 import type { GLVertexArrayObject } from './gl-vertex-array-object';
 /**
  * 应用层 Geometry 对象，本身不直接保存 GPU 资源而是通过 geometryInternal 成员保存 GPU 资源
@@ -73,7 +72,7 @@ export declare class GLGeometry extends Geometry {
     getDrawCount(): number;
     getSkinProps(): SkinProps;
     private getAttributeBufferOption;
-    createIndicesBuffer(pipelineContext: GLPipelineContext, data: spec.TypedArray): GLGPUBuffer;
+    createIndicesBuffer(data: spec.TypedArray): GLGPUBuffer;
     flush(): void;
     private processProps;
     fromData(data: spec.GeometryData): void;

package/dist/gl-gpu-buffer.d.ts

@@ -1,5 +1,5 @@
 import type { Disposable, spec } from '@galacean/effects-core';
-import type { GLPipelineContext } from './gl-pipeline-context';
+import type { GLEngine } from './gl-engine';
 type GPUBufferTarget = WebGLRenderingContext['ARRAY_BUFFER'] | WebGLRenderingContext['ELEMENT_ARRAY_BUFFER'] | WebGL2RenderingContext['COPY_READ_BUFFER'] | WebGL2RenderingContext['COPY_WRITE_BUFFER'] | WebGL2RenderingContext['TRANSFORM_FEEDBACK_BUFFER'] | WebGL2RenderingContext['UNIFORM_BUFFER'] | WebGL2RenderingContext['PIXEL_PACK_BUFFER'] | WebGL2RenderingContext['PIXEL_UNPACK_BUFFER'];
 type GPUBufferType = WebGLRenderingContext['UNSIGNED_INT'] | WebGLRenderingContext['UNSIGNED_SHORT'] | WebGLRenderingContext['UNSIGNED_BYTE'] | WebGLRenderingContext['FLOAT'] | WebGLRenderingContext['INT'] | WebGLRenderingContext['SHORT'] | WebGLRenderingContext['BYTE'];
 export interface GLGPUBufferProps {
@@ -14,7 +14,7 @@ export interface GLGPUBufferProps {
     usage?: WebGLRenderingContext['STATIC_DRAW'] | WebGLRenderingContext['DYNAMIC_DRAW'];
 }
 export declare class GLGPUBuffer implements Disposable {
-    readonly pipelineContext: GLPipelineContext;
+    readonly engine: GLEngine;
     readonly bytesPerElement: number;
     readonly target: GPUBufferTarget;
     readonly type: GPUBufferType;
@@ -22,7 +22,7 @@ export declare class GLGPUBuffer implements Disposable {
     readonly glBuffer: WebGLBuffer | null;
     private byteLength;
     private destroyed;
-    constructor(pipelineContext: GLPipelineContext, props: GLGPUBufferProps);
+    constructor(engine: GLEngine, props: GLGPUBufferProps);
     get elementCount(): number;
     get isDestroyed(): boolean;
     private createGLBuffer;

package/dist/gl-material-state.d.ts

@@ -1,4 +1,4 @@
-import type { GLPipelineContext } from './gl-pipeline-context';
+import type { GLEngine } from './gl-engine';
 export declare class GLMaterialState {
     blending: boolean;
     blendFunctionParameters: [blendSrc: GLenum, blendDst: GLenum, blendSrcAlpha: GLenum, blendDstAlpha: GLenum];
@@ -46,5 +46,5 @@ export declare class GLMaterialState {
     setFrontFace(value: GLenum): void;
     setCullFace(value: GLenum): void;
     reset(): void;
-    apply(pipelineContext: GLPipelineContext): void;
+    apply(engine: GLEngine): void;
 }

package/dist/gl-material.d.ts

@@ -1,6 +1,6 @@
-import type { Engine, GlobalUniforms, MaterialDestroyOptions, MaterialProps, Renderer, Texture, UndefinedAble } from '@galacean/effects-core';
+import type { Engine, GlobalUniforms, MaterialProps, Renderer, Texture, UndefinedAble } from '@galacean/effects-core';
 import { spec, Material, math } from '@galacean/effects-core';
-import type { GLPipelineContext } from './gl-pipeline-context';
+import type { GLEngine } from './gl-engine';
 type Color = math.Color;
 type Vector2 = math.Vector2;
 type Vector3 = math.Vector3;
@@ -80,7 +80,7 @@ export declare class GLMaterial extends Material {
     /**shader和texture的GPU资源初始化。 */
     initialize(): void;
     createShaderVariant(): void;
-    setupStates(pipelineContext: GLPipelineContext): void;
+    setupStates(engine: GLEngine): void;
     use(renderer: Renderer, globalUniforms?: GlobalUniforms): void;
     getFloat(name: string): number | null;
     setFloat(name: string, value: number): void;
@@ -119,6 +119,6 @@ export declare class GLMaterial extends Material {
     toData(): spec.MaterialData;
     cloneUniforms(sourceMaterial: Material): void;
     private checkUniform;
-    dispose(options?: MaterialDestroyOptions): void;
+    dispose(): void;
 }
 export {};

package/dist/gl-program.d.ts

@@ -21,9 +21,7 @@ export declare class GLProgram implements Disposable {
     engine: GLEngine;
     readonly program: WebGLProgram;
     private readonly id;
-    private readonly uniformBlockMap;
     private attribInfoMap;
-    private pipelineContext;
     constructor(engine: GLEngine, program: WebGLProgram, id: string);
     bind(): void;
     /**

package/dist/gl-renderer-internal.d.ts

@@ -1,7 +1,6 @@
 import type { Disposable, LostHandler, Material, Geometry } from '@galacean/effects-core';
 import type { GLFramebuffer } from './gl-framebuffer';
 import type { GLGPUBuffer } from './gl-gpu-buffer';
-import type { GLPipelineContext } from './gl-pipeline-context';
 import type { GLRenderbuffer } from './gl-renderbuffer';
 import { GLTexture } from './gl-texture';
 import { GLVertexArrayObject } from './gl-vertex-array-object';
@@ -10,7 +9,6 @@ export declare class GLRendererInternal implements Disposable, LostHandler {
     engine: GLEngine;
     emptyTexture2D: GLTexture;
     emptyTextureCube: GLTexture;
-    pipelineContext: GLPipelineContext;
     gl: WebGLRenderingContext | WebGL2RenderingContext;
     readonly name: string;
     readonly textures: GLTexture[];

package/dist/gl-renderer.d.ts

@@ -1,8 +1,7 @@
-import type { Disposable, Framebuffer, GLType, Geometry, LostHandler, Material, RenderFrame, RenderPass, RenderPassClearAction, RenderPassStoreAction, RendererComponent, RestoreHandler, ShaderLibrary } from '@galacean/effects-core';
-import { FilterMode, RenderTextureFormat, Renderer, math } from '@galacean/effects-core';
+import type { Disposable, Framebuffer, GLType, Geometry, LostHandler, Material, RenderFrame, RenderPass, RenderPassClearAction, RenderPassStoreAction, RendererComponent, RestoreHandler, ShaderLibrary, math } from '@galacean/effects-core';
+import { FilterMode, RenderTextureFormat, Renderer } from '@galacean/effects-core';
 import { ExtWrap } from './ext-wrap';
 import { GLContextManager } from './gl-context-manager';
-import { GLPipelineContext } from './gl-pipeline-context';
 import { GLRendererInternal } from './gl-renderer-internal';
 type Matrix4 = math.Matrix4;
 type Vector4 = math.Vector4;
@@ -13,7 +12,6 @@ export declare class GLRenderer extends Renderer implements Disposable {
     extension: ExtWrap;
     framebuffer: Framebuffer;
     temporaryRTs: Record<string, Framebuffer>;
-    pipelineContext: GLPipelineContext;
     readonly context: GLContextManager;
     constructor(canvas: HTMLCanvasElement | OffscreenCanvas, framework: GLType, renderOptions?: WebGLContextAttributes);
     get isDestroyed(): boolean;
@@ -28,7 +26,7 @@ export declare class GLRenderer extends Renderer implements Disposable {
     setGlobalInt(name: string, value: number): void;
     setGlobalMatrix(name: string, value: Matrix4): void;
     setGlobalVector3(name: string, value: Vector3): void;
-    drawGeometry(geometry: Geometry, material: Material, subMeshIndex?: number): void;
+    drawGeometry(geometry: Geometry, matrix: Matrix4, material: Material, subMeshIndex?: number): void;
     setFramebuffer(framebuffer: Framebuffer | null): void;
     getFramebuffer(): Framebuffer;
     getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): Framebuffer;

package/dist/gl-shader-library.d.ts

@@ -1,10 +1,8 @@
 import type { Disposable, RestoreHandler, ShaderCompileResult, ShaderLibrary, ShaderMacros, ShaderWithSource } from '@galacean/effects-core';
 import { GLShaderVariant } from './gl-shader';
-import type { GLPipelineContext } from './gl-pipeline-context';
 import type { GLEngine } from './gl-engine';
 export declare class GLShaderLibrary implements ShaderLibrary, Disposable, RestoreHandler {
     engine: GLEngine;
-    pipelineContext: GLPipelineContext;
     readonly shaderResults: Record<string, ShaderCompileResult>;
     private readonly glAsyncCompileExt;
     private programMap;
@@ -12,7 +10,7 @@ export declare class GLShaderLibrary implements ShaderLibrary, Disposable, Resto
     private glFragShaderMap;
     private shaderAllDone;
     private cachedShaders;
-    constructor(engine: GLEngine, pipelineContext: GLPipelineContext);
+    constructor(engine: GLEngine);
     compileAllShaders(asyncCallback?: (results: ShaderCompileResult[]) => void): void;
     addShader(shaderSource: ShaderWithSource, macros?: ShaderMacros): string;
     createShader(shaderSource: ShaderWithSource, macros?: ShaderMacros): GLShaderVariant;
@@ -24,3 +22,4 @@ export declare class GLShaderLibrary implements ShaderLibrary, Disposable, Resto
     restore(): void;
     dispose(): void;
 }
+export declare function stringHash(...strings: string[]): number;

package/dist/gl-shader.d.ts

@@ -1,7 +1,6 @@
 import type { ShaderCompileResult, ShaderWithSource, Texture, Engine, math } from '@galacean/effects-core';
 import { ShaderVariant } from '@galacean/effects-core';
 import type { GLProgram } from './gl-program';
-import type { GLPipelineContext } from './gl-pipeline-context';
 type Color = math.Color;
 type Vector2 = math.Vector2;
 type Vector3 = math.Vector3;
@@ -10,7 +9,6 @@ type Matrix3 = math.Matrix3;
 type Matrix4 = math.Matrix4;
 type Quaternion = math.Quaternion;
 export declare class GLShaderVariant extends ShaderVariant {
-    pipelineContext: GLPipelineContext;
     program: GLProgram;
     compileResult: ShaderCompileResult;
     id: string;

package/dist/gl-texture.d.ts

@@ -3,7 +3,6 @@ import { Texture } from '@galacean/effects-core';
 export declare class GLTexture extends Texture implements Disposable, RestoreHandler {
     textureBuffer: WebGLTexture | null;
     target: GLenum;
-    private pipelineContext;
     private initialized;
     constructor(engine: Engine, source?: TextureSourceOptions);
     /**

package/dist/index.d.ts

@@ -7,7 +7,6 @@ export * from './gl-texture';
 export * from './gl-framebuffer';
 export * from './gl-gpu-buffer';
 export * from './gl-vertex-array-object';
-export * from './gl-pipeline-context';
 export * from './gl-shader-library';
 export * from './gl-engine';
 export * from './gl-shader';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-webgl",
-  "version": "2.6.6",
+  "version": "2.7.0-alpha.0",
   "description": "Galacean Effects runtime webgl for the web",
   "types": "./dist/index.d.ts",
   "files": [
@@ -38,7 +38,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@galacean/effects-core": "2.6.6"
+    "@galacean/effects-core": "2.7.0-alpha.0"
   },
   "scripts": {
     "prebuild": "pnpm clean",

package/dist/gl-pipeline-context.d.ts

@@ -1,325 +0,0 @@
-import type { Disposable, Nullable, Texture, math } from '@galacean/effects-core';
-import { GLShaderLibrary } from './gl-shader-library';
-import type { GLEngine } from './gl-engine';
-type Color = math.Color;
-type Vector2 = math.Vector2;
-type Vector3 = math.Vector3;
-type Vector4 = math.Vector4;
-type Matrix3 = math.Matrix3;
-type Matrix4 = math.Matrix4;
-type Quaternion = math.Quaternion;
-export declare class GLPipelineContext implements Disposable {
-    engine: GLEngine;
-    gl: WebGLRenderingContext | WebGL2RenderingContext;
-    textureUnitDict: Record<string, WebGLTexture | null>;
-    shaderLibrary: GLShaderLibrary;
-    private readonly maxTextureCount;
-    private glCapabilityCache;
-    private currentFramebuffer;
-    private currentTextureBinding;
-    private currentRenderbuffer;
-    private activeTextureIndex;
-    private pixelStorei;
-    constructor(engine: GLEngine, gl: WebGLRenderingContext | WebGL2RenderingContext);
-    dispose(): void;
-    private reset;
-    toggle(capability: GLenum, enable?: boolean): void;
-    /**
-     * 对于该上下文开启某种特性
-     * @param capability
-     * example:
-     * gl.enable(gl.DITHER);
-     */
-    enable(capability: GLenum): void;
-    /**
-     * 基于某种上下文关闭特性
-     * @param capability
-     * example:
-     * gl.disable(gl.DITHER);
-     */
-    disable(capability: GLenum): void;
-    /**
-     * 绑定framebuffer webgl2新增: gl.DRAW_FRAMEBUFFER 和 gl.READ_FRAMEBUFFER
-     * @param target
-     * @param framebuffer
-     * example:
-     * const framebuffer = gl.createFramebuffer();
-     * gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
-     */
-    bindFramebuffer(target: GLenum, framebuffer: WebGLFramebuffer | null): void;
-    bindRenderbuffer(target: GLenum, renderbuffer: WebGLRenderbuffer | null): void;
-    /**
-     * 绑定系统 framebuffer
-     */
-    bindSystemFramebuffer(): void;
-    /**
-     * 将定义好的 WebGLProgram 对象添加到当前的渲染状态中。
-     * @param program
-     * example:
-     * gl.useProgram(program);
-     * gl.useProgram(null);
-     */
-    useProgram(program: WebGLProgram | null): void;
-    /**
-     * 使用预设值来清空缓冲
-     * @param mask
-     * example:
-     * gl.clear(gl.DEPTH_BUFFER_BIT);
-     * gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
-     */
-    clear(mask: number): void;
-    /*** depth start ***/
-    /**
-     * 设置深度缓冲区的深度清除值
-     * @param depth
-     * example:
-     * gl.clearDepth(0.5);
-     */
-    clearDepth(depth: GLclampf): void;
-    /**
-     * 指定将输入像素深度与当前深度缓冲区值进行比较的函数。
-     * @param func
-     * example:
-     * gl.enable(gl.DEPTH_TEST);
-     * gl.depthFunc(gl.NEVER);
-     */
-    depthFunc(func: GLenum): void;
-    /**
-     * 设置是否启用写入深度缓冲。
-     * @param flag
-     * example:
-     * gl.depthMask(false);
-     */
-    depthMask(flag: boolean): void;
-    polygonOffset(factor: number, unit: number): void;
-    /**
-     * 将 z 值从规范化设备坐标映射到窗口坐标
-     * @param zNear
-     * @param zFar
-     * example:
-     * gl.depthRange(0.2, 0.6);
-     */
-    depthRange(zNear: number, zFar: number): void;
-    /*** depth end ***/
-    /*** stencil start ***/
-    /**
-     * 模版测试设置函数和引用值。
-     * @param func
-     * @param ref
-     * @param mask
-     * example:
-     * gl.enable(gl.STENCIL_TEST);
-     * gl.stencilFunc(gl.LESS, 0, 0b1110011);
-     */
-    clearStencil(s: GLint): void;
-    /**
-     * 控制启用和禁用模板平面中单个位的正面和背面写入
-     * @param mask
-     * example:
-     * gl.stencilMask(0xff);
-     */
-    stencilMask(mask: number): void;
-    /**
-     * 模版测试设置函数和引用值。
-     * @param func
-     * @param ref
-     * @param mask
-     * example:
-     * gl.enable(gl.STENCIL_TEST);
-     * gl.stencilFunc(gl.LESS, 0, 0b1110011);
-     */
-    stencilFunc(func: GLenum, ref: GLint, mask: GLuint): void;
-    /**
-     * 单面模版测试
-     * @param face
-     * @param func
-     * @param ref
-     * @param mask
-     * example:
-     * gl.enable(gl.STENCIL_TEST);
-     * gl.stencilFuncSeparate(gl.FRONT, gl.LESS, 0.2, 1110011);
-     */
-    stencilFuncSeparate(face: GLenum, func: GLenum, ref: GLint, mask: GLuint): void;
-    /**
-     * 单面的mask写入
-     * @param face
-     * @param mask
-     * example:
-     * gl.stencilMaskSeparate(gl.FRONT, 110101);
-     */
-    stencilMaskSeparate(face: GLenum, mask: GLuint): void;
-    /**
-     * 设置正面和背面模板测试操作
-     * @param fail
-     * @param zfail
-     * @param zpass
-     * example:
-     * gl.enable(gl.STENCIL_TEST);
-     * gl.stencilOp(gl.INCR, gl.DECR, gl.INVERT);
-     */
-    stencilOp(fail: GLenum, zfail: GLenum, zpass: GLenum): void;
-    /**
-     * 设置正面和/或背面模板测试操作
-     * @param face
-     * @param fail
-     * @param zfail
-     * @param zpass
-     * example:
-     * gl.enable(gl.STENCIL_TEST);
-     * gl.stencilOpSeparate(gl.FRONT, gl.INCR, gl.DECR, gl.INVERT);
-     */
-    stencilOpSeparate(face: GLenum, fail: GLenum, zfail: GLenum, zpass: GLenum): void;
-    /*** stencil end ***/
-    /*** face start ***/
-    /**
-     * 剔除方式
-     * @param mode
-     * example:
-     * gl.enable(gl.CULL_FACE);
-     * gl.cullFace(gl.FRONT_AND_BACK);
-     */
-    cullFace(mode: GLenum): void;
-    /**
-     * 设置卷绕方向
-     * @param mode
-     * example:
-     * gl.frontFace(gl.CW);
-     */
-    frontFace(mode: GLenum): void;
-    /*** face end ***/
-    /*** color start ***/
-    /**
-     * 设置颜色写入
-     * @param red
-     * @param green
-     * @param blue
-     * @param alpha
-     * example:
-     * gl.colorMask(true, true, true, false);
-     */
-    clearColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void;
-    /**
-     * 设置颜色写入
-     * @param red
-     * @param green
-     * @param blue
-     * @param alpha
-     * example:
-     * gl.colorMask(true, true, true, false);
-     */
-    colorMask(red: boolean, green: boolean, blue: boolean, alpha: boolean): void;
-    /**
-     * 设置源和目标混合因子
-     * @param red
-     * @param green
-     * @param blue
-     * @param alpha
-     * example:
-     * gl.blendColor(0, 0.5, 1, 1);
-     */
-    blendColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void;
-    /**
-     * 用于混合像素算法
-     * @param sfactor
-     * @param dfactor
-     * example:
-     * gl.enable(gl.BLEND);
-     * gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);
-     */
-    blendFunc(sfactor: GLenum, dfactor: GLenum): void;
-    /**
-     * 分别设置应用在 RGB 和 Alpha 上的 factor
-     * @param srcRGB
-     * @param dstRGB
-     * @param srcAlpha
-     * @param dstAlpha
-     * example:
-     * gl.enable(gl.BLEND);
-     * gl.blendFuncSeparate(gl.SRC_COLOR, gl.DST_COLOR, gl.ONE, gl.ZERO);
-     */
-    blendFuncSeparate(srcRGB: GLenum, dstRGB: GLenum, srcAlpha: GLenum, dstAlpha: GLenum): void;
-    /**
-     * 设置混合模式
-     * @param mode
-     * example:
-     * gl.blendEquation(gl.FUNC_ADD);
-     * gl.blendEquation(gl.FUNC_SUBTRACT);
-     * gl.blendEquation(gl.FUNC_REVERSE_SUBTRACT);
-     */
-    blendEquation(mode: GLenum): void;
-    /**
-     * 可以分别对 RGB 和 Alpha 做不同的操作处理
-     * @param modeRGB
-     * @param modeAlpha
-     * example:
-     * gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_SUBTRACT);
-     */
-    blendEquationSeparate(modeRGB: GLenum, modeAlpha: GLenum): void;
-    /*** color end ***/
-    /**
-     * 图像预处理
-     * @param pname
-     * @param param
-     * example:
-     * var tex = gl.createTexture();
-     * gl.bindTexture(gl.TEXTURE_2D, tex);
-     * gl.pixelStorei(gl.PACK_ALIGNMENT, 4);
-     */
-    setPixelStorei(pname: GLenum, param: GLenum): void;
-    /**
-     * 用来设置视口，即指定从标准设备到窗口坐标的x、y仿射变换。
-     * @param x
-     * @param y
-     * @param width
-     * @param height
-     * example:
-     * gl.viewport(0, 0, width, height);
-     */
-    viewport(x: number, y: number, width: number, height: number): void;
-    /**
-     * 激活指定的纹理单元
-     * @param texture
-     * example:
-     * gl.activeTexture(gl.TEXTURE1);
-     */
-    activeTexture(texture: GLenum): void;
-    /**
-     * 绑定WebGLTexture
-     * @param target
-     * @param texture
-     * @param force
-     * example:
-     * const texture = gl.createTexture();
-     * gl.bindTexture(gl.TEXTURE_2D, texture)
-     */
-    bindTexture(target: GLenum, texture: WebGLTexture | null, force?: boolean): void;
-    private set1;
-    private set2;
-    private set3;
-    private set4;
-    get(name: string): any;
-    setFloat(uniform: Nullable<WebGLUniformLocation>, value: number): void;
-    setInt(uniform: Nullable<WebGLUniformLocation>, value: number): void;
-    setFloats(uniform: Nullable<WebGLUniformLocation>, value: number[]): void;
-    setVector2(uniform: Nullable<WebGLUniformLocation>, value: Vector2): void;
-    setVector3(uniform: Nullable<WebGLUniformLocation>, value: Vector3): void;
-    setVector4(uniform: Nullable<WebGLUniformLocation>, value: Vector4): void;
-    setColor(uniform: Nullable<WebGLUniformLocation>, value: Color): void;
-    setQuaternion(uniform: Nullable<WebGLUniformLocation>, value: Quaternion): void;
-    setVector4Array(uniform: Nullable<WebGLUniformLocation>, array: number[]): void;
-    setMatrix(uniform: Nullable<WebGLUniformLocation>, value: Matrix4): void;
-    setMatrix3(uniform: Nullable<WebGLUniformLocation>, value: Matrix3): void;
-    setMatrixArray(uniform: Nullable<WebGLUniformLocation>, array: number[]): void;
-    setTexture(uniform: Nullable<WebGLUniformLocation>, channel: number, texture: Texture): void;
-    /**
-     * 查询所有uniform的location。
-     * @param program 查询的shader program
-     * @param uniformsNames 查询的uniform名称列表
-     * @returns
-     */
-    getUniforms(program: WebGLProgram, uniformsNames: string[]): Nullable<WebGLUniformLocation>[];
-    private setFloat4;
-    private setFloat3;
-    private setFloat2;
-}
-export {};

package/dist/gl-uniform-utils.d.ts

@@ -1,46 +0,0 @@
-import type { Disposable, UniformValue, spec } from '@galacean/effects-core';
-import { GLGPUBuffer } from './gl-gpu-buffer';
-import type { GLPipelineContext } from './gl-pipeline-context';
-type BlockUniformInfo = [
-    type: number,
-    offset: number,
-    size: number,
-    blockIndex: number,
-    arrayStride: number,
-    maxStride: number,
-    rowMajor: number,
-    index: number,
-    byteLength: number
-];
-export interface UniformBlockSpec {
-    index: number;
-    usedByVertexShader: boolean;
-    usedByFragmentShader: boolean;
-    size: number;
-    uniformIndices: number[];
-    used: boolean;
-    name: string;
-    uniforms: Record<string, BlockUniformInfo>;
-    id: string;
-}
-interface UBODirtyFlag {
-    start: number;
-    dirty: boolean;
-    buffer?: spec.TypedArray;
-}
-export declare class UniformBlockBuffer implements Disposable {
-    private readonly info;
-    buffer?: GLGPUBuffer;
-    dirtyFlags: Record<string, UBODirtyFlag>;
-    keepData: boolean;
-    constructor(pipelineContext: GLPipelineContext, info: UniformBlockSpec);
-    setValues(uniformValues: Record<string, UniformValue>, dirtyFlags: Record<string, boolean>, uniformValueOffsets: Record<string, spec.vec2>): void;
-    bind(gl: WebGL2RenderingContext, program: WebGLProgram, bufferBindIndex: number): void;
-    dispose(): void;
-}
-export declare function createUniformBlockDataFromProgram(gl: WebGL2RenderingContext, program: WebGLProgram): {
-    blockSpecs: UniformBlockSpec[];
-    blockUniformNames: string[];
-};
-export declare function stringHash(...strings: string[]): number;
-export {};