[ Impact ]

 * On systems with more than one monitor, the lock screen wallpaper
   disappears (turns black) on the primary monitor when a second monitor
   is plugged in or unplugged while the screen is locked, leaving only
   the lock screen text on a black background. This has been reported by
   multiple users since 2021 (LP: #2013042, duplicates LP: #1922340,
   #2044190 and #2128888), affecting noble, resolute and stonking.
 * The cause is in mutter's clutter: when painting is redirected into a
   private offscreen framebuffer (e.g. on behalf of the lock screen blur
   effect), the on-screen redraw clip was still applied to the offscreen
   capture. During a full-stage repaint of one monitor, the blur cache
   for the other monitor could be captured with an unrelated (empty)
   clip and end up blank. The fix stops applying the redraw clip when
   painting into an offscreen framebuffer, so the cached content is
   always valid. Because the wrong-clip capture depends on paint
   scheduling, the bug reproduces intermittently rather than on every
   attempt.
 * The fix is a 14-line change, upstream as mutter merge request !5307,
   authored by the mutter (Ubuntu) assignee of this bug.

[ Test Plan ]

 * Reproduction requires a multi-monitor setup (real hardware or a VM
   with two virtual displays). If possible, first reproduce the bug on
   the current -updates package to confirm the environment reproduces
   it at all; failure to reproduce after many attempts suggests the
   environment is not hitting the race and is not a valid verification
   environment:
   1. Connect two monitors.
   2. Lock the screen (Super+L). Confirm the blurred wallpaper is shown
      on the lock screen.
   3. While the screen stays locked, plug in/unplug (or enable/disable)
      the second monitor, and repeat this several times. The unfixed
      behaviour is a race between the blur effect's offscreen capture
      and the stage view being repainted, so it is intermittent rather
      than guaranteed on every attempt; several attempts may be needed.
   4. Expected with the fix: the lock screen wallpaper continues to be
      shown on the remaining monitor(s) on every attempt. Without the
      fix, the wallpaper on one monitor intermittently turns black,
      leaving only the lock screen text.
 * Also lock/unlock the screen several times with the second monitor
   connected, to check the blur cache stays valid across repaints.
 * Regression testing: check normal rendering with and without effects,
   including desktop and lock screen wallpaper updates on monitor
   changes, lock/unlock blur, the overview, and general painting
   performance with blur effects active. The desktop team Mutter test
   plan applies:
   
https://canonical-ubuntu-projectubuntu.readthedocs-hosted.com/maintainers/test-plans/desktop-team/Mutter/
 * autopkgtests for mutter run automatically against the upload in
   -proposed.

[ Where problems could occur ]

 * The change only affects painting that is redirected into private
   offscreen framebuffers (ClutterOffscreenEffect users, e.g. the lock
   screen blur). The redraw clip continues to be applied exactly as
   before for all on-screen painting, so normal partial redraws and
   window-group culling are unchanged.
 * Returning "no clip" for offscreen captures is an already-supported
   case in mutter: every consumer of the redraw clip has an explicit
   NULL fallback (meta_window_group paints without culling,
   meta_background_content paints its full area, and stage watchers are
   notified of a full-stage redraw), so this code path is not new.
 * During an offscreen capture the affected actor is now repainted in
   full instead of being intersected with the current view's redraw
   clip. Offscreen captures happen when an effect's cache is refreshed
   (e.g. when the lock screen background blur is invalidated by
   lock/unlock or monitor changes) rather than every frame, so the
   extra work is bounded; if a session nevertheless refreshed such
   caches frequently this could show up as increased CPU/GPU usage with
   blur effects active.
 * A latent bug in offscreen cache invalidation could surface as visual
   artifacts (e.g. flickering or stale blur textures) on the lock
   screen or other effect users; the verification steps above cover
   lock/unlock and monitor changes.

[ Other Info ]

 * mutter and gnome-shell are not covered by the GNOME micro release
   exception, so this is a standard bug-fix SRU.
 * The same patch is applied to:
   - tenacious (devel): mutter 51.0-1ubuntu4 (development release fixed
     first, per SRU policy)
   - stonking: mutter 51.0-1ubuntu3.1
   - resolute: mutter 50.1-0ubuntu2.7 (stacked on 50.1-0ubuntu2.6,
     currently in resolute-proposed)
 * noble (24.04 LTS) is also affected but is a prior release relative to
   resolute; it is not being fixed in this SRU round. It can be
   considered separately if there is demand.
 * The upstream merge request !5307 is still open; the exact same commit
   is used in all three Ubuntu uploads and will land upstream as-is
   (or is re-reviewable there).

** Changed in: mutter (Ubuntu Stonking)
   Importance: Undecided => Low

** Changed in: mutter (Ubuntu Resolute)
   Importance: Undecided => Low

-- 
You received this bug notification because you are a member of Ubuntu
Desktop Bugs, which is subscribed to gnome-shell in Ubuntu.
https://bugs.launchpad.net/bugs/2013042

Title:
  Lock screen wallpaper vanishes (goes black) if a second monitor is
  plugged in/out

To manage notifications about this bug go to:
https://bugs.launchpad.net/gnome-shell/+bug/2013042/+subscriptions


-- 
desktop-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/desktop-bugs

Reply via email to