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.

fix(ci): the WebGL2 Voxel GI scene is not launched on a runner with no GPU, where it kills the GPU process before it draws

yhhee1bf6b1a6c5
diff --git a/tools/renderScenes.mjs b/tools/renderScenes.mjs
index 75930910d..b6e5adcf9 100644
--- a/tools/renderScenes.mjs
+++ b/tools/renderScenes.mjs
@@ -167,7 +167,7 @@ export const SCENES = [
// The same room unbaked, lit by Voxel GI: the bounce light on the red wall is red, because it is reflected by the albedo the wall wrote beside its
// normal. Before the albedo attachment it was guessed from the lit picture, and a wall the sun does not reach came out grey. Both backends' caches
// also take the sun's shadow map and feed each bounce back, and land within a few levels of each other.
- { id: "gi-room-voxel", tier: "pr", webgpu: true, env: { "ESTELLA_VERIFY_PLAY": "1", "ESTELLA_VERIFY_COLORSPACE": "linear", "ESTELLA_VERIFY_SCENE": "/scenes/gi-room-voxel.esscene", "ESTELLA_VERIFY_MANIFEST": "/scenes/gi-room-voxel.textures.json", "ESTELLA_VERIFY_W": "320", "ESTELLA_VERIFY_H": "180", "ESTELLA_VERIFY_STEPS": "120", "ESTELLA_VERIFY_EXPECT": "[{\"x\":0.5,\"y\":0.099,\"rgb\":[81,77,76],\"tol\":18},{\"x\":0.239,\"y\":0.508,\"rgb\":[77,35,30],\"tol\":18},{\"x\":0.761,\"y\":0.508,\"rgb\":[30,55,28],\"tol\":18}]" } },
+ { id: "gi-room-voxel", tier: "pr", webgpu: true, softwareGpu: false, env: { "ESTELLA_VERIFY_PLAY": "1", "ESTELLA_VERIFY_COLORSPACE": "linear", "ESTELLA_VERIFY_SCENE": "/scenes/gi-room-voxel.esscene", "ESTELLA_VERIFY_MANIFEST": "/scenes/gi-room-voxel.textures.json", "ESTELLA_VERIFY_W": "320", "ESTELLA_VERIFY_H": "180", "ESTELLA_VERIFY_STEPS": "120", "ESTELLA_VERIFY_EXPECT": "[{\"x\":0.5,\"y\":0.099,\"rgb\":[81,77,76],\"tol\":18},{\"x\":0.239,\"y\":0.508,\"rgb\":[77,35,30],\"tol\":18},{\"x\":0.761,\"y\":0.508,\"rgb\":[30,55,28],\"tol\":18}]" } },
{ id: "lightmap-model", tier: "pr", webgpu: true, env: { "ESTELLA_VERIFY_MESH_MATERIAL": "/scenes/lightmap-model/rough.esmaterial", "ESTELLA_VERIFY_SCENE": "/scenes/lightmap-model.esscene", "ESTELLA_VERIFY_MANIFEST": "/scenes/lightmap-model.textures.json", "ESTELLA_VERIFY_W": "256", "ESTELLA_VERIFY_H": "256", "ESTELLA_VERIFY_STEPS": "2", "ESTELLA_VERIFY_EXPECT": "[{\"x\":0.25,\"y\":0.4,\"rgb\":[0,255,255],\"tol\":20},{\"x\":0.25,\"y\":0.6,\"rgb\":[128,255,0],\"tol\":20},{\"x\":0.75,\"y\":0.4,\"rgb\":[29,255,61],\"tol\":20},{\"x\":0.75,\"y\":0.6,\"rgb\":[29,255,61],\"tol\":20}]" } },
// Why the rectangle rides the per-object record: ONE mesh and ONE atlas, and
// the two objects drawn from them read different halves of it. A rectangle
diff --git a/tools/verify-render.mjs b/tools/verify-render.mjs
index 34361752e..94d1c2576 100644
--- a/tools/verify-render.mjs
+++ b/tools/verify-render.mjs
@@ -80,9 +80,18 @@ const LAUNCH_MARGIN_MS = 30_000;
// A tier run on the second backend takes the scenes that DECLARE it; naming
// scenes explicitly is a decision already made, so `--only` is not filtered —
// that is how a scene earns the declaration in the first place.
+// A Linux runner has no GPU, so WebGL2 there is a software rasteriser, and a scene that says `softwareGpu: false` takes its GPU process
+// down before it draws, every launch. That says nothing about the scene and spends a budget the other scenes need. Named below, and
+// still run wherever there is a GPU, the second backend's Metal runner included.
+const softwareGpu = process.platform === 'linux' && Boolean(process.env.CI);
+const tierScenes = scenesAtTier(TIER);
+const needsGpu = BACKEND === 'webgl2' && softwareGpu ? tierScenes.filter((s) => s.softwareGpu === false) : [];
const selected = only
? SCENES.filter((s) => only.has(s.id))
- : scenesAtTier(TIER).filter((s) => (BACKEND === 'webgpu' ? Boolean(s.webgpu) : true));
+ : tierScenes.filter((s) => (BACKEND === 'webgpu' ? Boolean(s.webgpu) : !needsGpu.includes(s)));
+if (!only && needsGpu.length > 0) {
+ console.log(`not run on this machine's software rasteriser: ${needsGpu.map((s) => s.id).join(', ')}`);
+}
const scenes = selected.map((s) => ({
id: s.id,
// Which host answers this scene's driving surface. The engine's is the