@@ -10,8 +10,11 @@ import 'package:flutter/rendering.dart';
1010import 'package:flutter_miuix/miuix.dart' show MiuixGlassEdgeFade;
1111
1212import '../../../models/liquid_glass_tuning.dart' ;
13+ import '../../../widgets/course_glass_shader.dart' ;
14+ import '../../../widgets/preblurred_wallpaper_glass.dart' ;
1315import '../frosted/liquid_glass_degradation.dart' ;
1416import '../hyperos_blurred_header.dart' ;
17+ import '../hyperos_glass_backdrop_host.dart' ;
1518import 'liquid_glass_shader.dart' ;
1619
1720/// 这块玻璃表面**按哪个作用域取参数**。
@@ -183,8 +186,25 @@ class LiquidGlassSurface extends StatefulWidget {
183186 this .forceCanvasBoard = false ,
184187 this .canvasBoardColor,
185188 this .probeName = 'glassLiquid' ,
189+ this .freezeOnRouteTransition = false ,
186190 });
187191
192+ /// 转场期间把这块玻璃冻结成预糊壁纸位图,不再产生任何滤镜层(默认关)。
193+ ///
194+ /// 为什么需要:Impeller 上**每个 `BackdropFilter` 都会结束一次渲染 pass、
195+ /// 把整屏回读一遍**,玻璃多小都一样;而「组的模糊折叠成一次」要求组内所有
196+ /// filter 属性完全一致(`flutter/flutter#191207` ,以及合并进文档的
197+ /// `PR #191613` )。本表面的 filter 里带着一块**逐面不同**的屏幕坐标折射
198+ /// shader,因此永远折叠不了 —— 玻璃有几块就付几次整屏回读。
199+ ///
200+ /// 真机实测(25060RK16C / profile / 120Hz 预算 7.5~8.3ms):同一次运行里
201+ /// 「底层是设置页」的转场 5.0~6.5ms,「底层是首页」的 8.5~10.1ms,差值正是
202+ /// 首页常驻的这几块玻璃。
203+ ///
204+ /// 只给**首页常驻 chrome**开。冻结用的是与首页玻璃带同一个预糊位图
205+ /// (`PreblurredWallpaperAlignedFill` ),所以观感差异仅限转场那 0.3 秒。
206+ final bool freezeOnRouteTransition;
207+
188208 /// 诊断用层名:这块玻璃逐帧重绘时记到这个名字下(`[frame-perf] layers=名字:N` )。
189209 ///
190210 /// 见 `_RenderLiquidGlass.probeName` 的长注释:所有液态玻璃共用一个名字时,
@@ -460,6 +480,20 @@ class LiquidGlassSurfaceState extends State<LiquidGlassSurface>
460480 if (! LiquidGlassSurface ._isActuallyRenderable (context, widget.role)) {
461481 return widget.fallbackBuilder (context);
462482 }
483+ // 转场期间改画预糊位图,不再挂滤镜层(理由见 [freezeOnRouteTransition])。
484+ // 拿不到位图就保持实时玻璃 —— 宁可多付这笔钱,也不要闪一块空白。
485+ if (widget.freezeOnRouteTransition &&
486+ HyperosGlassBackdropController .routeTransitionRunning.value) {
487+ final frozen = _frozenWallpaperGlassBoard (
488+ context,
489+ role: widget.role,
490+ borderRadius: widget.borderRadius,
491+ maxRefraction: widget.maxRefraction,
492+ );
493+ if (frozen != null ) {
494+ return frozen;
495+ }
496+ }
463497 // 两个作用域,各自只有一个出口:表面只提供自己的圆角与当前明暗,折射旋钮、
464498 // 底色、光来向一律从 [resolveStyleFor] 出 —— 固定小件拿标准档,其余拿
465499 // [FrostedAppearanceScope] 里那一份,表面自己仍然碰不到参数。
@@ -514,6 +548,57 @@ class LiquidGlassSurfaceState extends State<LiquidGlassSurface>
514548 }
515549}
516550
551+ /// 转场期间「冻结」一块首页玻璃:改画同一份预糊壁纸位图,不再产生滤镜层。
552+ ///
553+ /// 与首页玻璃带的冻结分支共用同一套取参(同一个 role、同一份成对配置),
554+ /// 所以两条路在同一块材质上给出同一观感 —— 漏一个就会重现「同一材质两种观感」。
555+ ///
556+ /// 拿不到位图(还没烤好 / 这棵树不在 [PreblurredWallpaperScope] 里)返回 null,
557+ /// 由调用方回落成实时玻璃。
558+ Widget ? _frozenWallpaperGlassBoard (
559+ BuildContext context, {
560+ required LiquidGlassRole role,
561+ required double borderRadius,
562+ double ? maxRefraction,
563+ }) {
564+ if (PreblurredWallpaperScope .isWaitingForBitmap (context)) return null ;
565+ if (PreblurredWallpaperScope .maybeOf (context) == null ) return null ;
566+ final style = LiquidGlassSurface .resolveStyleFor (
567+ appearance: FrostedAppearanceScope .of (context),
568+ role: role,
569+ borderRadius: borderRadius,
570+ brightness: Theme .of (context).brightness,
571+ );
572+ final glass = CourseGlassStyle (
573+ borderRadius: style.borderRadius,
574+ tint: style.tint,
575+ // 窄件(回到今天那颗钮)会压折射位移;冻结这条路同样要压,否则两条分支
576+ // 在同一块表面上给出不同的折射量。
577+ refraction: maxRefraction == null
578+ ? style.refraction
579+ : math.min (style.refraction, maxRefraction),
580+ refractionBand: style.refractionBand,
581+ refractionEdgePow: style.refractionEdgePow,
582+ dispersion: style.dispersion,
583+ rimStrength: style.rimStrength,
584+ rimWidth: style.rimWidth,
585+ rimColor: style.rimColor,
586+ );
587+ final fill = PreblurredWallpaperAlignedFill (
588+ glass: glass,
589+ // 显式写出来:这张填的是**哪一份**位图,是载荷信息不是风格 —— 枚举自己的
590+ // 文档就写着「必须显式指定,不许猜」。
591+ // ignore: avoid_redundant_argument_values
592+ source: PreblurredWallpaperSource .home,
593+ );
594+ if (borderRadius <= 0 ) return fill;
595+ // 形状圆角由玻璃自己按 SDF 画,外面这层裁只负责把溢出的采样收干净。
596+ return ClipRRect (
597+ borderRadius: BorderRadius .circular (borderRadius),
598+ child: fill,
599+ );
600+ }
601+
517602class _LiquidGlassLayer extends SingleChildRenderObjectWidget {
518603 const _LiquidGlassLayer ({
519604 required this .style,
0 commit comments