mirror of
https://github.com/galacean/engine.git
synced 2026-07-01 08:44:18 +08:00
bdf54903bf
PhysX 射线/sweep 起点在碰撞体内部时会返回 distance=0 的命中， 与 Unity 行为不一致。通过启用 POST_FILTER 并在 postFilter 中 过滤 distance<=0 的结果，使 PhysX 跳过 initial overlap 并继续 查找下一个最近命中。 - 启用 POST_FILTER query flag - raycast 和 sweep callback 添加 postFilter 过滤 distance<=0 - 更新 PhysX wasm CDN URL（对应 QueryBinding.h postFilter 改动） - 更新本地 wasm 产物
E2E Testing Guide
Prerequisites
Git LFS
We use git-lfs to manage baseline images for e2e tests. Install it if you haven't already:
git lfs install
git lfs pull
Quick Start
Run all e2e tests
npm run e2e
Debug tests interactively
npm run e2e:debug
Both commands will automatically:
- Install required browsers (Chromium)
- Start the test server
- Run visual regression tests with odiff comparison
Project Structure
e2e/
├── case/ # Test case implementations
├── config.ts # Test configuration
├── fixtures/
│ └── originImage/ # Baseline images (managed by git-lfs)
├── downloads/ # Generated screenshots
├── tests/ # Playwright test files
└── utils/ # Helper utilities
Adding New Test Cases
1. Create a test case file
Create your test implementation in e2e/case/, following existing patterns:
// e2e/case/my-new-test.ts
WebGLEngine.create({ canvas: "canvas" }).then((engine) => {
// Your test implementation
updateForE2E(engine);
initScreenshot(engine, camera);
});
2. Add configuration
Add your test to e2e/config.ts:
MyCategory: {
myNewTest: {
category: "MyCategory",
caseFileName: "my-new-test",
threshold: 0.1 // 0.01 for strict tests, 0.1 for normal tests
}
}
3. Generate baseline image
Run in debug mode to generate the initial screenshot:
npm run e2e:debug
Copy the generated image from e2e/downloads/ to e2e/fixtures/originImage/ and commit it with git-lfs.
Threshold Guidelines
- 0.01: Strict comparison for pixel-perfect tests (e.g., FXAA, transparency)
- 0.1: Normal comparison for most 3D rendering tests
- Adjust based on rendering stability and requirements
Troubleshooting
Browser installation issues
Manually install browsers:
npm run e2e:install
Missing baseline images
Pull from git-lfs:
git lfs pull
Server startup issues
Manually start the test server:
npm run e2e:case
Framework Details
This project uses Playwright with odiff for visual regression testing. All tests run in Chromium for consistency.