A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
refactor(sdk): extract postProcessEffects shader factories (F3 B2b-2)
esengine59536df6bdad
diff --git a/sdk/src/postprocess.ts b/sdk/src/postprocess.tsindex bcee35121..70a6692c2 100644--- a/sdk/src/postprocess.ts+++ b/sdk/src/postprocess.ts@@ -1,6 +1,7 @@export {PostProcess,PostProcessStack,+ postProcessEffects,initPostProcessAPI,shutdownPostProcessAPI,syncStackToWasm,diff --git a/sdk/src/postprocess/PostProcessAPI.ts b/sdk/src/postprocess/PostProcessAPI.tsindex 86c09e7d1..274be72bb 100644--- a/sdk/src/postprocess/PostProcessAPI.ts+++ b/sdk/src/postprocess/PostProcessAPI.ts@@ -1,11 +1,8 @@import type { ESEngineModule } from '../wasm';import type { Entity } from '../types';-import type { ShaderHandle } from '../material';-import { Material } from '../material';import { handleWasmError } from '../wasmError';import { CoreApiBridge } from '../CoreApiBridge';import { PostProcessStack, getCameraBindings, getStacks, createStack as createPostProcessStack } from './PostProcessStack';-import { POSTPROCESS_VERTEX } from './shaders';const bridge = new CoreApiBridge('postprocess');let module: ESEngineModule | null = null;@@ -263,163 +260,4 @@ export const PostProcess = {handleWasmError(e, 'PostProcess._executeScreenPasses');}},-- createBlur(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform vec2 u_resolution;-uniform float u_intensity;-out vec4 fragColor;--void main() {- vec2 texelSize = 1.0 / u_resolution;- float offset = u_intensity;-- vec4 color = vec4(0.0);- color += texture(u_texture, v_texCoord + vec2(-offset, -offset) * texelSize) * 0.0625;- color += texture(u_texture, v_texCoord + vec2( 0.0, -offset) * texelSize) * 0.125;- color += texture(u_texture, v_texCoord + vec2( offset, -offset) * texelSize) * 0.0625;- color += texture(u_texture, v_texCoord + vec2(-offset, 0.0) * texelSize) * 0.125;- color += texture(u_texture, v_texCoord) * 0.25;- color += texture(u_texture, v_texCoord + vec2( offset, 0.0) * texelSize) * 0.125;- color += texture(u_texture, v_texCoord + vec2(-offset, offset) * texelSize) * 0.0625;- color += texture(u_texture, v_texCoord + vec2( 0.0, offset) * texelSize) * 0.125;- color += texture(u_texture, v_texCoord + vec2( offset, offset) * texelSize) * 0.0625;-- fragColor = color;-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createVignette(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform float u_intensity;-uniform float u_softness;-out vec4 fragColor;--void main() {- vec4 color = texture(u_texture, v_texCoord);- vec2 uv = v_texCoord * 2.0 - 1.0;- float dist = length(uv);- float vig = 1.0 - smoothstep(1.0 - u_softness, 1.0, dist);- fragColor = vec4(color.rgb * mix(1.0, vig, u_intensity), color.a);-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createGrayscale(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform float u_intensity;-out vec4 fragColor;--void main() {- vec4 color = texture(u_texture, v_texCoord);- float gray = dot(color.rgb, vec3(0.299, 0.587, 0.114));- fragColor = vec4(mix(color.rgb, vec3(gray), u_intensity), color.a);-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createBloomExtract(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform float u_threshold;-out vec4 fragColor;--void main() {- vec4 color = texture(u_texture, v_texCoord);- float brightness = dot(color.rgb, vec3(0.2126, 0.7152, 0.0722));- float knee = u_threshold * 0.5;- float soft = brightness - u_threshold + knee;- soft = clamp(soft, 0.0, 2.0 * knee);- soft = soft * soft / (4.0 * knee + 0.00001);- float contrib = max(soft, brightness - u_threshold);- contrib /= max(brightness, 0.00001);- fragColor = vec4(color.rgb * contrib, 1.0);-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createBloomKawase(iteration: number): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform vec2 u_resolution;-uniform float u_radius;-out vec4 fragColor;--void main() {- float d = (${iteration.toFixed(1)} + 0.5) * max(u_radius, 0.5);- vec2 ts = 1.0 / u_resolution;- fragColor = (- texture(u_texture, v_texCoord + vec2(-d, -d) * ts) +- texture(u_texture, v_texCoord + vec2( d, -d) * ts) +- texture(u_texture, v_texCoord + vec2(-d, d) * ts) +- texture(u_texture, v_texCoord + vec2( d, d) * ts)- ) * 0.25;-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createBloomComposite(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform sampler2D u_sceneTexture;-uniform float u_intensity;-out vec4 fragColor;--void main() {- vec4 blur = texture(u_texture, v_texCoord);- vec4 scene = texture(u_sceneTexture, v_texCoord);- fragColor = vec4(scene.rgb + blur.rgb * u_intensity, scene.a);-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },-- createChromaticAberration(): ShaderHandle {- const fragmentSrc = `#version 300 es-precision highp float;--in vec2 v_texCoord;-uniform sampler2D u_texture;-uniform vec2 u_resolution;-uniform float u_intensity;-out vec4 fragColor;--void main() {- vec2 offset = u_intensity / u_resolution;- float r = texture(u_texture, v_texCoord + offset).r;- float g = texture(u_texture, v_texCoord).g;- float b = texture(u_texture, v_texCoord - offset).b;- float a = texture(u_texture, v_texCoord).a;- fragColor = vec4(r, g, b, a);-}-`;- return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);- },};diff --git a/sdk/src/postprocess/effects.ts b/sdk/src/postprocess/effects.tsindex 8a41c3a9b..dfdf6a4cf 100644--- a/sdk/src/postprocess/effects.ts+++ b/sdk/src/postprocess/effects.ts@@ -1,5 +1,5 @@import type { ShaderHandle } from '../material';-import { PostProcess } from './PostProcessAPI';+import { postProcessEffects } from './postProcessEffects';export interface EffectUniformDef {name: string;@@ -44,7 +44,7 @@ export function getAllEffectDefs(): EffectDef[] {registerEffect({type: 'blur',label: 'Blur',- factory: () => PostProcess.createBlur(),+ factory: () => postProcessEffects.createBlur(),uniforms: [{ name: 'u_intensity', label: 'Intensity', min: 0, max: 20, step: 0.1, defaultValue: 2 },],@@ -53,27 +53,27 @@ registerEffect({registerEffect({type: 'bloom',label: 'Bloom',- factory: () => PostProcess.createBloomExtract(),+ factory: () => postProcessEffects.createBloomExtract(),uniforms: [{ name: 'u_threshold', label: 'Threshold', min: 0, max: 1, step: 0.01, defaultValue: 0.4 },{ name: 'u_intensity', label: 'Intensity', min: 0, max: 5, step: 0.1, defaultValue: 1.5 },{ name: 'u_radius', label: 'Radius', min: 0.5, max: 5, step: 0.1, defaultValue: 1 },],multiPass: [- { name: 'bloom_extract', factory: () => PostProcess.createBloomExtract() },- { name: 'bloom_kawase_0', factory: () => PostProcess.createBloomKawase(0) },- { name: 'bloom_kawase_1', factory: () => PostProcess.createBloomKawase(1) },- { name: 'bloom_kawase_2', factory: () => PostProcess.createBloomKawase(2) },- { name: 'bloom_kawase_3', factory: () => PostProcess.createBloomKawase(3) },- { name: 'bloom_kawase_4', factory: () => PostProcess.createBloomKawase(4) },- { name: 'bloom_composite', factory: () => PostProcess.createBloomComposite() },+ { name: 'bloom_extract', factory: () => postProcessEffects.createBloomExtract() },+ { name: 'bloom_kawase_0', factory: () => postProcessEffects.createBloomKawase(0) },+ { name: 'bloom_kawase_1', factory: () => postProcessEffects.createBloomKawase(1) },+ { name: 'bloom_kawase_2', factory: () => postProcessEffects.createBloomKawase(2) },+ { name: 'bloom_kawase_3', factory: () => postProcessEffects.createBloomKawase(3) },+ { name: 'bloom_kawase_4', factory: () => postProcessEffects.createBloomKawase(4) },+ { name: 'bloom_composite', factory: () => postProcessEffects.createBloomComposite() },],});registerEffect({type: 'vignette',label: 'Vignette',- factory: () => PostProcess.createVignette(),+ factory: () => postProcessEffects.createVignette(),uniforms: [{ name: 'u_intensity', label: 'Intensity', min: 0, max: 1, step: 0.01, defaultValue: 0.6 },{ name: 'u_softness', label: 'Softness', min: 0, max: 1, step: 0.01, defaultValue: 0.5 },@@ -83,7 +83,7 @@ registerEffect({registerEffect({type: 'grayscale',label: 'Grayscale',- factory: () => PostProcess.createGrayscale(),+ factory: () => postProcessEffects.createGrayscale(),uniforms: [{ name: 'u_intensity', label: 'Intensity', min: 0, max: 1, step: 0.01, defaultValue: 1 },],@@ -92,7 +92,7 @@ registerEffect({registerEffect({type: 'chromaticAberration',label: 'Chromatic Aberration',- factory: () => PostProcess.createChromaticAberration(),+ factory: () => postProcessEffects.createChromaticAberration(),uniforms: [{ name: 'u_intensity', label: 'Intensity', min: 0, max: 20, step: 0.1, defaultValue: 3 },],diff --git a/sdk/src/postprocess/index.ts b/sdk/src/postprocess/index.tsindex 4f462df30..5da1a784a 100644--- a/sdk/src/postprocess/index.ts+++ b/sdk/src/postprocess/index.ts@@ -1,6 +1,7 @@export { PostProcessStack } from './PostProcessStack';export type { PassConfig } from './PostProcessStack';export { PostProcess, initPostProcessAPI, shutdownPostProcessAPI, syncStackToWasm } from './PostProcessAPI';+export { postProcessEffects } from './postProcessEffects';export { POSTPROCESS_VERTEX } from './shaders';export {type EffectDef,diff --git a/sdk/src/postprocess/postProcessEffects.ts b/sdk/src/postprocess/postProcessEffects.tsnew file mode 100644index 000000000..bfeb1b845--- /dev/null+++ b/sdk/src/postprocess/postProcessEffects.ts@@ -0,0 +1,171 @@+/**+ * @file postProcessEffects.ts+ * @brief Stateless post-process shader factories.+ * @details Pure Material.createShader builders, extracted verbatim from the+ * former four-in-one PostProcess object. No state, no per-App, no+ * module — just shader source. (B2b: slim the god-object.)+ */+import type { ShaderHandle } from '../material';+import { Material } from '../material';+import { POSTPROCESS_VERTEX } from './shaders';++export const postProcessEffects = {+ createBlur(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform vec2 u_resolution;+uniform float u_intensity;+out vec4 fragColor;++void main() {+ vec2 texelSize = 1.0 / u_resolution;+ float offset = u_intensity;++ vec4 color = vec4(0.0);+ color += texture(u_texture, v_texCoord + vec2(-offset, -offset) * texelSize) * 0.0625;+ color += texture(u_texture, v_texCoord + vec2( 0.0, -offset) * texelSize) * 0.125;+ color += texture(u_texture, v_texCoord + vec2( offset, -offset) * texelSize) * 0.0625;+ color += texture(u_texture, v_texCoord + vec2(-offset, 0.0) * texelSize) * 0.125;+ color += texture(u_texture, v_texCoord) * 0.25;+ color += texture(u_texture, v_texCoord + vec2( offset, 0.0) * texelSize) * 0.125;+ color += texture(u_texture, v_texCoord + vec2(-offset, offset) * texelSize) * 0.0625;+ color += texture(u_texture, v_texCoord + vec2( 0.0, offset) * texelSize) * 0.125;+ color += texture(u_texture, v_texCoord + vec2( offset, offset) * texelSize) * 0.0625;++ fragColor = color;+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createVignette(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform float u_intensity;+uniform float u_softness;+out vec4 fragColor;++void main() {+ vec4 color = texture(u_texture, v_texCoord);+ vec2 uv = v_texCoord * 2.0 - 1.0;+ float dist = length(uv);+ float vig = 1.0 - smoothstep(1.0 - u_softness, 1.0, dist);+ fragColor = vec4(color.rgb * mix(1.0, vig, u_intensity), color.a);+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createGrayscale(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform float u_intensity;+out vec4 fragColor;++void main() {+ vec4 color = texture(u_texture, v_texCoord);+ float gray = dot(color.rgb, vec3(0.299, 0.587, 0.114));+ fragColor = vec4(mix(color.rgb, vec3(gray), u_intensity), color.a);+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createBloomExtract(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform float u_threshold;+out vec4 fragColor;++void main() {+ vec4 color = texture(u_texture, v_texCoord);+ float brightness = dot(color.rgb, vec3(0.2126, 0.7152, 0.0722));+ float knee = u_threshold * 0.5;+ float soft = brightness - u_threshold + knee;+ soft = clamp(soft, 0.0, 2.0 * knee);+ soft = soft * soft / (4.0 * knee + 0.00001);+ float contrib = max(soft, brightness - u_threshold);+ contrib /= max(brightness, 0.00001);+ fragColor = vec4(color.rgb * contrib, 1.0);+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createBloomKawase(iteration: number): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform vec2 u_resolution;+uniform float u_radius;+out vec4 fragColor;++void main() {+ float d = (${iteration.toFixed(1)} + 0.5) * max(u_radius, 0.5);+ vec2 ts = 1.0 / u_resolution;+ fragColor = (+ texture(u_texture, v_texCoord + vec2(-d, -d) * ts) ++ texture(u_texture, v_texCoord + vec2( d, -d) * ts) ++ texture(u_texture, v_texCoord + vec2(-d, d) * ts) ++ texture(u_texture, v_texCoord + vec2( d, d) * ts)+ ) * 0.25;+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createBloomComposite(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform sampler2D u_sceneTexture;+uniform float u_intensity;+out vec4 fragColor;++void main() {+ vec4 blur = texture(u_texture, v_texCoord);+ vec4 scene = texture(u_sceneTexture, v_texCoord);+ fragColor = vec4(scene.rgb + blur.rgb * u_intensity, scene.a);+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },++ createChromaticAberration(): ShaderHandle {+ const fragmentSrc = `#version 300 es+precision highp float;++in vec2 v_texCoord;+uniform sampler2D u_texture;+uniform vec2 u_resolution;+uniform float u_intensity;+out vec4 fragColor;++void main() {+ vec2 offset = u_intensity / u_resolution;+ float r = texture(u_texture, v_texCoord + offset).r;+ float g = texture(u_texture, v_texCoord).g;+ float b = texture(u_texture, v_texCoord - offset).b;+ float a = texture(u_texture, v_texCoord).a;+ fragColor = vec4(r, g, b, a);+}+`;+ return Material.createShader(POSTPROCESS_VERTEX, fragmentSrc);+ },+};diff --git a/sdk/tests/postprocess.test.ts b/sdk/tests/postprocess.test.tsindex 928285ca9..38ad4705d 100644--- a/sdk/tests/postprocess.test.ts+++ b/sdk/tests/postprocess.test.ts@@ -6,7 +6,7 @@ vi.mock('../src/material', () => ({}));import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';-import { PostProcess, PostProcessStack, initPostProcessAPI, shutdownPostProcessAPI } from '../src/postprocess';+import { PostProcess, PostProcessStack, postProcessEffects, initPostProcessAPI, shutdownPostProcessAPI } from '../src/postprocess';import { Material } from '../src/material';import type { ESEngineModule } from '../src/wasm';@@ -324,7 +324,7 @@ describe('PostProcess API', () => {describe('built-in effects', () => {it('should create blur shader using Material.createShader', () => {- const handle = PostProcess.createBlur();+ const handle = postProcessEffects.createBlur();expect(Material.createShader).toHaveBeenCalledWith(expect.stringContaining('a_position'),expect.stringContaining('u_intensity'),@@ -333,7 +333,7 @@ describe('PostProcess API', () => {});it('should create vignette shader using Material.createShader', () => {- const handle = PostProcess.createVignette();+ const handle = postProcessEffects.createVignette();expect(Material.createShader).toHaveBeenCalledWith(expect.stringContaining('a_position'),expect.stringContaining('u_softness'),@@ -342,7 +342,7 @@ describe('PostProcess API', () => {});it('should create grayscale shader using Material.createShader', () => {- const handle = PostProcess.createGrayscale();+ const handle = postProcessEffects.createGrayscale();expect(Material.createShader).toHaveBeenCalledWith(expect.stringContaining('a_position'),expect.stringContaining('0.299'),@@ -351,7 +351,7 @@ describe('PostProcess API', () => {});it('should create chromatic aberration shader using Material.createShader', () => {- const handle = PostProcess.createChromaticAberration();+ const handle = postProcessEffects.createChromaticAberration();expect(Material.createShader).toHaveBeenCalledWith(expect.stringContaining('a_position'),expect.stringContaining('u_intensity'),@@ -360,10 +360,10 @@ describe('PostProcess API', () => {});it('should use the shared POSTPROCESS_VERTEX shader for all effects', () => {- PostProcess.createBlur();- PostProcess.createVignette();- PostProcess.createGrayscale();- PostProcess.createChromaticAberration();+ postProcessEffects.createBlur();+ postProcessEffects.createVignette();+ postProcessEffects.createGrayscale();+ postProcessEffects.createChromaticAberration();const calls = (Material.createShader as ReturnType<typeof vi.fn>).mock.calls;const vertexShaders = calls.map((c: unknown[]) => c[0]);