Skip to content

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.

refactor(sdk): extract postProcessEffects shader factories (F3 B2b-2)

esengine59536df6bdad
diff --git a/sdk/src/postprocess.ts b/sdk/src/postprocess.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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]);