ce1473c9ab
tests/3d-regression mirrors the gal-regression pattern at renderer scale: shared C++ scenarios call real KiCad 3D-viewer code (opengl_utils, display lists + DrawCulled stencil subtraction, MODEL_3D VBOs, private generators via a rob-template accessor, and full reload()+Redraw() composites over a synthetic BOARD_ADAPTER). A native macOS harness renders them on real OpenGL into 47 committed goldens (bit-deterministic, FBO capture); the wasm harness compiles the same TUs against wasm/stubs/gl_ffp_stub.c no-ops so every scenario renders blank — the TDD red state (parity meter: 47/47 changed). Comparisons use the CI pixelmatch engine via the new generic compare-dirs.ts (floors.json levels; manifest.json cmp-guards registry drift). Documents an upstream bug: appendPostMachiningGeometry's countersink path adds middle quads without normals, silently erasing the walls of any display list it is batched into (3d-post-machining.png keeps the lists separate to record it). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
81 lines
3.1 KiB
TypeScript
81 lines
3.1 KiB
TypeScript
/**
|
|
* 3D Renderer WebGL Regression — capture-only.
|
|
*
|
|
* Renders every scenario of the 3D suite (tests/3d-regression) in the browser
|
|
* and writes 3d-<name>.png into tests/3d-regression/output/webgl/. This spec
|
|
* never compares pixels: the gates live in `npm run 3d:check:webgl`
|
|
* (browser-regression, once baseline-webgl exists) and the informational
|
|
* `npm run 3d:check:parity` port-progress meter (expected ~100% changed while
|
|
* the FFP stubs render blank — the TDD red state).
|
|
*
|
|
* Anti-drift: no hand-typed scenario list. The committed
|
|
* tests/3d-regression/manifest.json (written by the native golden generator,
|
|
* cmp-guarded by scripts/test-3d-regression.sh) is the single source of truth,
|
|
* and the wasm registry is asserted against it name-by-name.
|
|
*/
|
|
|
|
import { test, expect } from './utils/fixtures';
|
|
import * as path from 'path';
|
|
import * as fs from 'fs';
|
|
|
|
const MANIFEST_PATH = path.join(__dirname, '../3d-regression/manifest.json');
|
|
const OUTPUT_DIR = path.join(__dirname, '../3d-regression/output/webgl');
|
|
const APP_JS = path.join(__dirname, '../apps/3d-webgl/3d_webgl_test.js');
|
|
|
|
const MANIFEST: { width: number; height: number; scenarios: string[] } = JSON.parse(
|
|
fs.readFileSync(MANIFEST_PATH, 'utf8')
|
|
);
|
|
|
|
test.describe('3D WebGL Regression', () => {
|
|
test.skip(
|
|
!fs.existsSync(APP_JS),
|
|
'3d-webgl harness not built (run scripts/build-3d-webgl-test.sh)'
|
|
);
|
|
|
|
test.beforeAll(async () => {
|
|
fs.mkdirSync(OUTPUT_DIR, { recursive: true });
|
|
});
|
|
|
|
test('module loads and registry matches the committed manifest', async ({ page }) => {
|
|
await page.goto('/3d-webgl/3d_webgl_test.html');
|
|
|
|
await page.waitForFunction(() => (window as any).threeDTest?.isReady(), undefined, {
|
|
timeout: 60000,
|
|
});
|
|
|
|
const total = await page.evaluate(() => (window as any).threeDTest.getTotalScenarios());
|
|
expect(total).toBe(MANIFEST.scenarios.length);
|
|
|
|
const names = await page.evaluate((count) => {
|
|
const t = (window as any).threeDTest;
|
|
return Array.from({ length: count }, (_, i) => t.getScenarioName(i));
|
|
}, total);
|
|
expect(names).toEqual(MANIFEST.scenarios);
|
|
|
|
const width = await page.evaluate(() => (window as any).threeDTest.getCanvasWidth());
|
|
const height = await page.evaluate(() => (window as any).threeDTest.getCanvasHeight());
|
|
expect(width).toBe(MANIFEST.width);
|
|
expect(height).toBe(MANIFEST.height);
|
|
});
|
|
|
|
test('render all scenarios', async ({ page }) => {
|
|
test.setTimeout(300000);
|
|
|
|
await page.goto('/3d-webgl/3d_webgl_test.html');
|
|
await page.waitForFunction(() => (window as any).threeDTest?.isReady(), undefined, {
|
|
timeout: 60000,
|
|
});
|
|
|
|
for (const [i, name] of MANIFEST.scenarios.entries()) {
|
|
const rc = await page.evaluate((idx) => (window as any).threeDTest.runScenario(idx), i);
|
|
expect(rc, `runScenario(${i}) [${name}]`).toBe(0);
|
|
|
|
// One composite tick so the preserved drawing buffer is presentable.
|
|
await page.evaluate(() => new Promise(requestAnimationFrame));
|
|
|
|
await page
|
|
.locator('#canvas')
|
|
.screenshot({ path: path.join(OUTPUT_DIR, `3d-${name}.png`) });
|
|
}
|
|
});
|
|
});
|