Release 0.12.0

Folder blur: while a folder is open on the home screen, what is behind it
is blurred, icons and widgets through a RenderEffect and the wallpaper
through the launcher surface's background blur. It is a new input of the
depth controller (folderBlur, 0 to 1), because that controller already
owns both kinds of blur and cleared anything set past it on every frame
of the folder's wallpaper zoom. The folder's spring animation drives it in
step with the dimming, and the places that reset the dimming reset it too.
It works with the wallpaper depth effect switched off, without bringing
the folder's wallpaper zoom along. Setting: Folders > Blur behind open
folders, on by default (flexera_folder_blur). Folders in the app list are
left as they were.

Dock: with the dock switched off the hotseat has no height, but its icons
were still drawn just below the screen edge, and the 97.5% zoom-out behind
an open folder brought their tops into view. One more alpha channel on
the icons hides them.

Checked on the emulator (Android 17 image, window blur available): open,
close by tap outside, Back and Home, an app started from the folder, sleep
and wake, the setting off, and the depth effect off.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

flexera/res/values/flexera_strings.xml

@@ -93,6 +93,8 @@
     <string name="flexera_scrub_from_home_description">Slide up or down along the alphabet\'s edge of the home screen to open the app list at a letter. Swipe up and hold does the same from anywhere.</string>
 
     <!-- Quick launch: a swipe on past the first or the last home screen page (app.flexera.home.QuickLaunch) -->
+    <string name="flexera_folder_blur">Blur behind open folders</string>
+    <string name="flexera_folder_blur_description">Blurs the home screen while a folder is open</string>
     <string name="flexera_quick_launch">Quick launch</string>
     <string name="flexera_quick_launch_description">Swipe on from the first or the last home screen page, as if there were one more, to open an app or do something else. Has no effect while Infinite scrolling is on.</string>
     <string name="flexera_quick_launch_first_page">Swipe past the first page</string>

flexera/src/app/flexera/home/FolderBlur.kt

@@ -0,0 +1,29 @@
+package app.flexera.home
+
+import android.content.Context
+import app.lawnchair.preferences2.PreferenceManager2
+import app.lawnchair.preferences2.firstCached
+import com.android.launcher3.Utilities
+
+/**
+ * The blur of the home screen behind an open folder: whether the owner wants it, and how strong
+ * it is. The blur itself is the depth controller's work
+ * ([com.android.quickstep.util.BaseDepthControllerImpl.folderBlur]), because that already blurs
+ * the same views and the wallpaper for other reasons and would undo anything done past it. The
+ * folder's opening and closing animation moves it
+ * ([com.android.launcher3.folder.FolderSpringAnimatorSet]).
+ */
+object FolderBlur {
+
+    /**
+     * The blur's radius behind a fully open folder, as a share of the largest radius the
+     * launcher blurs with (30dp). Strong enough that the icons behind the folder are no longer
+     * read, which is the point: the folder is what is in focus.
+     */
+    const val STRENGTH = 0.8f
+
+    /** Blurring a view needs Android 12. */
+    @JvmStatic
+    fun isOn(context: Context): Boolean =
+        Utilities.ATLEAST_S && PreferenceManager2.getInstance(context).folderBlur.firstCached()
+}

flexera/version.properties

@@ -2,4 +2,4 @@
 # build.gradle reads this and derives the Android version code from it
 # (major * 10000 + minor * 100 + patch), so the name and the code can never disagree.
 # flexera/release.ps1 raises it for every release.
-versionName=0.11.0
+versionName=0.12.0

lawnchair/src/app/lawnchair/preferences2/PreferenceManager2.kt

@@ -886,6 +886,13 @@ class PreferenceManager2 @Inject constructor(
         defaultValue = GestureHandlerConfig.NoOp,
     )
 
+    // Flexera Launcher: whether the home screen behind an open folder is blurred
+    // (app.flexera.home.FolderBlur). Read when a folder opens, so nothing has to be reloaded.
+    val folderBlur = preference(
+        key = booleanPreferencesKey(name = "flexera_folder_blur"),
+        defaultValue = true,
+    )
+
     val autoUpdaterNightly = preference(
         key = booleanPreferencesKey(name = "enable_nightly_auto_updater"),
         defaultValue = if (BuildConfig.APPLICATION_ID.contains("nightly")) {

lawnchair/src/app/lawnchair/ui/preferences/destinations/FolderPreferences.kt

@@ -33,6 +33,7 @@ import app.lawnchair.ui.preferences.components.layout.PreferenceGroup
 import app.lawnchair.ui.preferences.components.layout.PreferenceLayout
 import app.lawnchair.ui.preferences.navigation.GeneralIconShape
 import com.android.launcher3.R
+import com.android.launcher3.Utilities
 
 @Composable
 fun FolderPreferences(
@@ -75,6 +76,14 @@ fun FolderPreferences(
                 valueRange = 0F..1F,
                 showAsPercentage = true,
             )
+            // Flexera Launcher: blurring a view needs Android 12.
+            if (Utilities.ATLEAST_S) {
+                SwitchPreference(
+                    adapter = prefs2.folderBlur.getAdapter(),
+                    label = stringResource(id = R.string.flexera_folder_blur),
+                    description = stringResource(id = R.string.flexera_folder_blur_description),
+                )
+            }
         }
         PreferenceGroup(heading = stringResource(id = R.string.grid)) {
             SliderPreference(

quickstep/src/com/android/launcher3/statehandlers/DepthController.java

@@ -32,6 +32,7 @@ import android.view.ViewTreeObserver;
 
 import androidx.annotation.VisibleForTesting;
 
+import com.android.launcher3.AbstractFloatingView;
 import com.android.launcher3.BaseActivity;
 import com.android.launcher3.LauncherState;
 import com.android.launcher3.Utilities;
@@ -220,6 +221,12 @@ public class DepthController extends BaseDepthControllerImpl implements StateHan
      * Clears a stuck workspace icon blur after resume when settled on home.
      */
     public void clearStuckBlurOnResumeIfHome() {
+        // Flexera Launcher: a folder blur with no folder on the screen, open or still closing,
+        // is a stuck one too. It should not come about; this makes sure it could not stay.
+        if (folderBlur.getValue() > 0f && AbstractFloatingView.getAnyView(
+                mLauncher, AbstractFloatingView.TYPE_FOLDER) == null) {
+            folderBlur.setValue(0f);
+        }
         if (mLauncher.getStateManager().getState() == LauncherState.NORMAL
                 && !mLauncher.getStateManager().isInTransition()) {
             clearWorkspaceRenderEffects();
@@ -227,10 +234,18 @@ public class DepthController extends BaseDepthControllerImpl implements StateHan
         }
     }
 
+    @Override
+    protected boolean isDepthEffectEnabled() {
+        return mEnableDepth;
+    }
+
     @Override
     protected void applyDepthAndBlur() {
         try {
-            if (LawnchairQuickstepCompat.ATLEAST_R && mEnableDepth) {
+            // Flexera Launcher: the blur behind an open folder is a setting of its own, and
+            // also comes where the wallpaper's zoom is switched off.
+            if (LawnchairQuickstepCompat.ATLEAST_R
+                    && (mEnableDepth || folderBlurNeedsApplying())) {
                 ensureDependencies();
                 super.applyDepthAndBlur();
             } else if (mLauncher.getStateManager().getState() == LauncherState.NORMAL

quickstep/src/com/android/quickstep/util/BaseDepthControllerImpl.java

@@ -90,6 +90,11 @@ public class BaseDepthControllerImpl implements BaseDepthController {
     public final MultiProperty widgetDepth;
     /** Property to set just the wallpaper zoom for folder expansion. */
     public final MultiProperty folderZoom;
+    /**
+     * Flexera Launcher: property to set the blur behind an open folder, from 0 to 1. Unlike the
+     * depth it comes with no zoom, and it reaches the icons as well as the wallpaper.
+     */
+    public final MultiProperty folderBlur;
 
     /**
      * Blur radius when completely zoomed out, in pixels.
@@ -106,6 +111,10 @@ public class BaseDepthControllerImpl implements BaseDepthController {
     private float mDepth;
     // Used just for animating wallpaper zoom without affecting blur.
     private final AnimatedFloat mWallpaperZoomOnly = new AnimatedFloat(this::applyDepthAndBlur);
+    // Flexera Launcher: the blur behind an open folder, see folderBlur.
+    private final AnimatedFloat mFolderBlur = new AnimatedFloat(this::applyDepthAndBlur);
+    // Whether a folder blur is on the launcher's surface, and so has to come off again.
+    private boolean mFolderBlurApplied;
 
     protected SurfaceControl mBaseSurface;
 
@@ -164,6 +173,9 @@ public class BaseDepthControllerImpl implements BaseDepthController {
         } else {
             folderZoom = null;
         }
+        // Flexera Launcher
+        folderBlur = new MultiPropertyFactory<>(mFolderBlur, AnimatedFloat.VALUE, 1, Float::max)
+                .get(0);
 
 //        mEarlyWakeupInfo.token = new Binder();
 //        mEarlyWakeupInfo.trace = BaseDepthControllerImpl.class.getName();
@@ -184,6 +196,53 @@ public class BaseDepthControllerImpl implements BaseDepthController {
         return folderZoom;
     }
 
+    @Override
+    public MultiProperty getFolderBlur() {
+        return folderBlur;
+    }
+
+    /** Flexera Launcher: the blur behind an open folder as it is now, from 0 to 1. */
+    private float folderBlurAmount() {
+        return Utilities.boundToRange(mFolderBlur.value, 0f, 1f);
+    }
+
+    /**
+     * Flexera Launcher: true while a folder blur is wanted, and after that until it has been
+     * taken off the launcher's surface again.
+     */
+    protected boolean folderBlurNeedsApplying() {
+        return folderBlurAmount() > 0f || mFolderBlurApplied;
+    }
+
+    /** Flexera Launcher: false where the owner switched the wallpaper's zoom off. */
+    protected boolean isDepthEffectEnabled() {
+        return true;
+    }
+
+    /**
+     * Flexera Launcher: blurs the icons and widgets behind an open folder. That works without
+     * blur across windows as well, so also where the wallpaper has to stay sharp.
+     *
+     * @return {@code false} when no folder blur is wanted, and nothing was done
+     */
+    private boolean blurFolderBackdrop() {
+        float amount = folderBlurAmount();
+        if (!Utilities.ATLEAST_S || amount <= 0f) {
+            return false;
+        }
+        float radius = Math.max(mCurrentBlur,
+                amount * app.flexera.home.FolderBlur.STRENGTH * mMaxBlurRadius);
+        if (radius < 1f) {
+            // Too little to see, and a blur of no radius is not one the system accepts.
+            mLauncher.getDepthBlurTargets().forEach(target -> target.setRenderEffect(null));
+            return true;
+        }
+        RenderEffect blurEffect = RenderEffect.createBlurEffect(
+                radius, radius, Shader.TileMode.DECAL);
+        mLauncher.getDepthBlurTargets().forEach(target -> target.setRenderEffect(blurEffect));
+        return true;
+    }
+
     /**
      * Returns if cross window blurs are enabled. In other words, whether launcher should use blurs
      * style UI or fallback style UI.
@@ -236,7 +295,9 @@ public class BaseDepthControllerImpl implements BaseDepthController {
             boolean applyImmediately, boolean skipSimilarBlur) {
         float depth = mDepth;
         float wallpaperZoom = depth;
-        if (Flags.enableExpressiveFolderExpansion()) {
+        // Flexera Launcher: with the zoom switched off this used to be reached by accident
+        // only; the folder blur now brings it here on purpose, and must not bring the zoom along.
+        if (Flags.enableExpressiveFolderExpansion() && isDepthEffectEnabled()) {
             wallpaperZoom = Math.max(wallpaperZoom, mWallpaperZoomOnly.value);
         }
         IBinder windowToken = mLauncher.getRootView().getWindowToken();
@@ -261,6 +322,10 @@ public class BaseDepthControllerImpl implements BaseDepthController {
         } else {
             blurAmount = depth;
         }
+        // Flexera Launcher: an open folder blurs what is behind it, whatever the depth is.
+        float behindFolder = folderBlurAmount() * app.flexera.home.FolderBlur.STRENGTH;
+        blurAmount = Math.max(blurAmount, behindFolder);
+        mFolderBlurApplied = behindFolder > 0f;
 
         int previousBlur = mCurrentBlur;
         int newBlur = BlurUtils.supportsBlursOnWindows() && mCrossWindowBlursEnabled
@@ -378,6 +443,11 @@ public class BaseDepthControllerImpl implements BaseDepthController {
         if (!Utilities.ATLEAST_S) {
             return false;
         }
+        // Flexera Launcher: an open folder blurs these views in every state, the home screen
+        // at rest included, which the rules below would leave sharp.
+        if (blurFolderBackdrop()) {
+            return true;
+        }
         StateManager<LauncherState, Launcher> stateManager = mLauncher.getStateManager();
         LauncherState settledState = stateManager.getState();
 
@@ -414,6 +484,10 @@ public class BaseDepthControllerImpl implements BaseDepthController {
         if (!Utilities.ATLEAST_S) {
             return;
         }
+        // Flexera Launcher: the blur behind an open folder is not a stuck one, and stays.
+        if (blurFolderBackdrop()) {
+            return;
+        }
         mLauncher.getDepthBlurTargets().forEach(target -> {
             target.setRenderEffect(null);
             target.invalidate();

src/com/android/launcher3/Hotseat.java

@@ -185,8 +185,16 @@ public class Hotseat extends FrameLayout implements Insettable {
         // Create an initial page so alpha/translation channels have a target during construction.
         mPagedView.resetPages(false, null, mActivity.getDeviceProfile());
 
-        mIconsAlphaChannels = new MultiValueAlpha(mIconsContainer, ALPHA_CHANNEL_CHANNELS_COUNT);
+        // Flexera Launcher: one more channel than upstream, which hides the icons of a dock
+        // that is switched off. Such a dock has no height, but its icons were still drawn,
+        // just below the screen edge, and the zoom-out behind an open folder brought their
+        // tops into view.
+        mIconsAlphaChannels = new MultiValueAlpha(mIconsContainer,
+                ALPHA_CHANNEL_CHANNELS_COUNT + 1);
         mIconsAlphaChannels.setUpdateVisibility(true);
+        if (!hotseatEnabled) {
+            mIconsAlphaChannels.get(ALPHA_CHANNEL_CHANNELS_COUNT).setValue(0f);
+        }
         if (mQsb instanceof Reorderable qsbReorderable) {
             mQsbTranslationX = qsbReorderable.getTranslateDelegate()
                     .getTranslationX(MultiTranslateDelegate.INDEX_NAV_BAR_ANIM);

src/com/android/launcher3/folder/FolderAnimationSpringBuilderManager.kt

@@ -81,6 +81,8 @@ class FolderAnimationSpringBuilderManager(
             val launcher = launcherDelegate.launcher ?: return
             val scrim = launcher.scrimView
             launcherDelegate.launcher?.depthController?.folderZoom?.value = 0f
+            // Flexera Launcher: the blur behind the folder goes with it.
+            launcherDelegate.launcher?.depthController?.folderBlur?.value = 0f
             if (!launcher.isInState(LauncherState.ALL_APPS)) {
                 scrim.alpha = 1f
                 scrim.setBackgroundColor(Color.TRANSPARENT)

src/com/android/launcher3/folder/FolderScrimAnimationListener.kt

@@ -57,6 +57,8 @@ class FolderScrimAnimationListener(
         // Folder.closeComplete's restore path, leaving workspace/hotseat visually dimmed/scaled.
         SCALE_PROPERTY.set(launcher.workspace, 1f)
         SCALE_PROPERTY.set(launcher.hotseat, 1f)
+        // Flexera Launcher: and the blur behind the folder, for the same reason.
+        launcher.depthController?.folderBlur?.value = 0f
         if (Utilities.ATLEAST_S && launcher.stateManager.state.getDepth(launcher) == 0f) {
             launcher.depthBlurTargets.forEach { it.setRenderEffect(null) }
         }

src/com/android/launcher3/folder/FolderSpringAnimatorSet.kt

@@ -91,6 +91,12 @@ class FolderSpringAnimatorSet(val animatorSet: AnimatorSet) {
             launcherDelegate.launcher?.depthController?.folderZoom?.let {
                 addWallpaperZoomAnimator(folder.context, animatorSet, folderAnimData.isOpening, it)
             }
+            addBackdropBlurAnimator(
+                folder.context,
+                animatorSet,
+                folderAnimData.isOpening,
+                launcherDelegate,
+            )
             iconAnimData.forEach { addContentIconAnimators(folder.context, animatorSet, it) }
             return FolderSpringAnimatorSet(animatorSet)
         }
@@ -258,6 +264,39 @@ class FolderSpringAnimatorSet(val animatorSet: AnimatorSet) {
             )
         }
 
+        /**
+         * Flexera Launcher: blurs the home screen behind the folder as it opens, and clears it
+         * again as it closes, in step with the dimming. Closing always plays, also when the
+         * setting has been switched off since the folder was opened.
+         */
+        private fun addBackdropBlurAnimator(
+            context: Context,
+            animatorSet: AnimatorSet,
+            isOpening: Boolean,
+            launcherDelegate: LauncherDelegate,
+        ) {
+            val launcher = launcherDelegate.launcher ?: return
+            // As with the dimming: a folder in the app list leaves the list as it is.
+            if (launcher.isInState(LauncherState.ALL_APPS)) return
+            val blur = launcher.depthController?.folderBlur ?: return
+            val wanted =
+                if (isOpening) app.flexera.home.FolderBlur.isOn(context) else blur.value > 0f
+            if (!wanted) return
+            playSpringAnimation(
+                context = context,
+                animatorSet = animatorSet,
+                isOpening = isOpening,
+                startDelay = 0,
+                stiffness = STIFFNESS_LAUNCHER_SCRIM,
+                damping = DAMPING_LAUNCHER_SCRIM,
+                startValue = 0f,
+                endValue = 1f,
+                minVisibleChange = MIN_VISIBLE_CHANGE_ALPHA,
+                property = MULTI_PROPERTY_VALUE,
+                view = blur,
+            )
+        }
+
         private fun addAlphaAndColorAnimators(
             folder: Folder,
             animatorSet: AnimatorSet,

src/com/android/launcher3/statehandlers/BaseDepthController.kt

@@ -40,4 +40,10 @@ interface BaseDepthController {
      * Property for folder expansion wallpaper zoom.
      */
     val folderZoom: MultiPropertyFactory<*>.MultiProperty?
+
+    /**
+     * Flexera Launcher: property for the blur of the home screen behind an open folder, from 0
+     * (none) to 1 (as strong as it gets).
+     */
+    val folderBlur: MultiPropertyFactory<*>.MultiProperty?
 }