Warning
Debug Build Only - This beta is solely for debugging and testing gradient box art border color extraction. Settings are temporary and reset when leaving the Box Art Style screen. Do not use for normal gameplay.
New Features
- Add gradient extraction debug UI in Box Art Style settings (only visible when Border Style is "Gradient")
- Use L2/R2 triggers to cycle through preview games from Continue Playing
- Display extraction metrics: generation time, sample count, color families used
Debugging Notes
Parameters exposed for testing:
| Setting | Range | Default | Effect |
|---|---|---|---|
| Sample Grid | 8x12 to 16x24 | 12x18 | More samples = better color detection, slower extraction |
| Sample Radius | 1-4 | 3 | Larger radius = smoother sampling, O((2r+1)^2) complexity |
| Min Saturation | 0.20-0.50 | 0.35 | Threshold for "colorful" pixels |
| Min Brightness | 0.10-0.25 | 0.15 | Threshold to exclude dark pixels |
| Hue Distance | 20-60 | 40 | Minimum hue separation between primary/secondary |
| Saturation Boost | 0.30-0.55 | 0.45 | Applied to output colors |
| Brightness Clamp | 0.70-0.90 | 0.80 | Maximum brightness for output colors |
Known behavior - Saturation cliff edge:
When Min Saturation is set too high (e.g., 50%), you may see colors suddenly become pale instead of more vibrant. This happens because no pixels meet the saturation threshold, causing the algorithm to fall back to using ALL sampled colors (including unsaturated ones) rather than just the vibrant subset. If colors look unexpectedly washed out, try lowering the Min Saturation threshold.
Performance notes:
- Sample Radius has the biggest performance impact: radius 4 does 9x more pixel reads than radius 1
- Extraction times shown are real-time measurements on your device
- Target: <50ms for production viability