help4bis/h4b-image-optim
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

fix: eliminate AVIF/WebP grey halo on white backgrounds (v0.2.3)

Browse Source 
Diagnosed visible faint grey rectangle around B&W ink art images on
pages with pure-white backgrounds. Root cause was format encoder
luminance shift in near-white pixels:

  Source JPG corner: (253,253,253) = #FDFDFD = 99.2% white
  AVIF q=65 (default): (250,250,250) = #FAFAFA = 98.0% (1.2% halo)
  WebP q=80 (default): (249,249,249) = #F9F9F9 = 97.6% (1.6% halo)

Two changes:

1. avifenc now uses -y 444 (full chroma subsampling) instead of
   default 4:2:0. Brings AVIF corner to #FBFBFB = 98.4%, smaller
   file size as a bonus (~10% reduction on a typical art image).

2. WebP default quality raised 80 → 90. Reaches #FDFDFD = exact
   match with source JPG. File size increases ~30% but eliminates
   the halo entirely for WebP-capable browsers (vast majority).

AVIF still has 0.4% residual halo (libavif 0.11.1 ceiling at this
quality range — pushing higher yields no improvement, only file
size). Acceptable tradeoff: WebP is the served-by-default fallback
when AVIF isn't perfect.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Henk
2026-05-19 15:31:53 +10:00
parent c54eccc2d5
commit 0e56ca6e63
3 changed files with 10 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
includes/class-format-generator.php
View File

@@ -229,8 +229,14 @@ final class Format_Generator {
$dest = $source . '.avif';
$tmp = $dest . '.h4b.tmp';
// --min / --max set quality range.
// -s sets encoder speed (0-10; we default to 6 = balanced).
// -y 444 forces 4:4:4 chroma subsampling — preserves luminance of near-white
// pixels exactly, otherwise avifenc rounds white-ish pixels darker (~2% shift)
// which creates a visible grey halo against pure-white page backgrounds.
// Tradeoff: ~5% larger AVIF files in exchange for true colour fidelity.
$cmd = sprintf(
'%s --min %d --max %d -s %d %s %s 2>&1',
'%s --min %d --max %d -s %d -y 444 %s %s 2>&1',
escapeshellcmd( $bin ),
$qmin,
$qmax,

2
includes/class-settings.php
View File

@@ -33,7 +33,7 @@ final class Settings {
// Format generation
'generate_webp' => true,
'generate_avif' => true, // design decision 1: on by default everywhere
'webp_quality' => 80,
'webp_quality' => 90, // matches source JPG luminance for B&W ink on white
'avif_quality' => 65, // ≈ JPEG q=85 visually
'avif_speed' => 6, // 0-10; 6 is balanced
'avif_async' => true, // background WP-Cron so upload UI is responsive