Improve despill and add quality checks

2026-06-30 14:29:19 +08:00
parent 8fc53925e0
commit 464a60c733
6 changed files with 190 additions and 14 deletions
@@ -86,9 +86,21 @@ qa_grid.png
 metadata.json
 ```

+## Quality Check
+
+The quality checker measures alpha validity and green spill on semi-transparent
+edge pixels.
+
+```powershell
+D:\MiniConda\envs\lightML\python.exe -m bgfilter.quality_cli `
+  Outputs\TestImage_rgba.png `
+  --max-edge-green-excess-p95 0.55
+```
+
 ## Current Notes

 - `Samples/` and `Outputs/` are ignored by Git.
 - `ViTMatte` model weights are loaded from Hugging Face on first use.
- Current despill is conservative and edge-local. Strong green spill around hair may
-  still need parameter tuning or a stronger foreground color estimation pass.
+- Current despill is edge-local and includes a lightweight foreground unmixing pass.
+  Strong green spill around hair may still need more advanced foreground color
+  estimation.