Tigris 液态玻璃 Dock 的幕后:CPU 预计算模糊与折射的渲染技术拆解

原创2026-11-12 19:08:342,594 阅读

Tigris 液态玻璃 Dock 的幕后:CPU 预计算模糊与折射的渲染技术拆解

Tigris 液态玻璃 Dock 主屏效果,Android TV 桌面

Tigris 是一款把 Android TV 桌面改成 tvOS 26 风格的开源启动器:沉底的液态玻璃 Dock、Top Shelf 顶部内容、毛玻璃控制中心和相框屏保。这篇技术拆解带你走进 Tigris 液态玻璃 Dock 的幕后——它的模糊、折射和高光并不是每帧实时渲染的,而是由 CPU 提前"烤"好的一张位图。这个看似反直觉的决策,正是它在低配电视上依然流畅的关键。

为什么不用 GPU 实时渲染,而选择 CPU 预计算?

大多数应用实现毛玻璃效果的方式是:每帧把背景送进 GPU,用高斯模糊滤镜实时糊一遍。Tigris 的 LiquidGlass 走了另一条路,源码注释把动机说得非常直白:

Android 12 没有运行时 shader(runtime shaders),而桌面背景大多数时候是一张静止图片——所以玻璃效果按每张图片计算一次,然后作为普通位图显示(Glass.kt)。

这意味着:

  • 静止壁纸:切换一张壁纸时,在后台线程把玻璃效果烘焙一次,之后 Dock 就是一张普通位图,渲染开销约等于零;
  • 动态视频壁纸:以 100 ms 的间隔抓取小尺寸快照来驱动烘焙,而不是逐帧计算,视频播放本身保持原始分辨率(详见 docs/video-wallpaper-glass.md)。

预计算的前提是"背景变化慢",而桌面启动器恰好完美符合这个前提。

模糊核心:可分离盒式模糊逼近高斯

玻璃底板内的背景先是柔和模糊、再略微提亮。Tigris 用纯 Kotlin 实现了一个可分离盒式模糊(separable box blur),核心入口是 boxBlur():

Tigris 控制中心的毛玻璃面板,玻璃内背景被柔和模糊

它分三步走:

  1. 截取背景区域:以 Dock 为圆心,向外扩出一圈 margin(留给边缘折射"伸手"和模糊扩散),把这块区域画到一张离屏位图,再用 getPixels() 读成一维 IntArray(Glass.kt)。
  2. 行、列各扫一遍:水平方向滑窗平均写入临时数组,垂直方向再平均写回。用"滑动窗口累加和"(新加进一个像素、减掉滑出像素)让每条扫描线的成本降为 O(宽度 × 半径),而不是 O(宽度 × 半径²)。
  3. 重复多次逼近高斯:根据中心极限定理,多次盒式卷积会趋近高斯分布。Dock 玻璃跑 2 遍(Glass.kt),控制中心跑 3 遍——代码注释里写着 "Three box passes come close to a Gaussian blur"(ControlCenter.kt)。

同一家族里还有更轻量的用法:设置页和软件更新页的背景只缩到 480 px 宽再糊 1 遍小半径(SettingsBackdrop.kt),"够用就好"的层次感很清晰。

边缘折射:一张 SDF 驱动的采样偏移

液态玻璃最有辨识度的细节,是边缘处背景被"往里拉"的折射感。Tigris 用一个圆角矩形的有向距离场(SDF) 驱动了整个过程(Glass.kt):

  1. 算距离:对玻璃内每个像素,按圆角矩形 SDF 公式算出它到边缘的有向距离 sdf——负值在内部,绝对值越大越靠近中心;
  2. 算法线:由 SDF 梯度方向推导出指向玻璃外侧的单位法线 (nx, ny),圆角区沿对角方向,直边区沿水平或垂直;
  3. 偏移采样:越靠近边缘(depth 越小),沿法线向外偏移越多,偏移量按二次曲线增长(off = t * t * pull,Glass.kt),再回到背景数组里采样——这就是"从边缘之外把像素拉进来"的折射带,宽度约取 min(高 × 0.26, 圆角 × 1.4)。

Tigris 液态玻璃 Top Shelf 栏,边缘折射与背景虚化

同一段循环里还顺手做掉了三件事:

  • 乳白 + 微饱和:按亮度分量把颜色轻微推向灰白再提饱和("a little milky",Glass.kt),frostStrength 参数控制乳白强度;
  • 定向高光:光源假定在左上角,法线朝光的面更亮、背光面保留一道更柔和的反射,2.2 px 宽的边缘描边按这个光照混合白色(Glass.kt);
  • 内侧柔光:紧贴亮边内侧再叠一圈 16% 强度的柔光,让边缘"由内发光"。

高光与投影的缓存:光照只算一次

折射和模糊依赖背景,但光照只依赖玻璃的形状。软件更新页的 UpdateGlass 利用了这一点:先用一张纯黑 1×1 位图烘焙,把折射、高光从结果中剥出来变成一张与背景无关的白色光照蒙版,按「宽:高:圆角:类型」为 key 缓存——背景怎么换,高光都只需算一次(UpdateGlass.kt)。

Tigris 软件更新页的玻璃面板,复用同一套烘焙管线

应用卡片的投影同样是预计算位图:用软件绘制的 BlurMaskFilter 画一张"比卡片略窄"的模糊阴影,让它聚在卡片底下方而不是四周晕开(Glass.kt),再按卡片尺寸缓存——注释里解释得很细:5/6 列布局的 Dock 瓦片尺寸不同,一张全局阴影在切换布局后会被悄悄拉伸,所以必须按 (宽,高) 分别缓存(TileAdapter.kt)。

动态壁纸与滚动:预计算如何跟上"活"的场景

视频壁纸。视频层是硬件 TextureView,软件 Canvas 根本读不到它——这就是早期"视频壁纸下玻璃失灵"的原因。解法是不去读硬件层,而是每 100 ms 抓一张最大 640 px 宽的小快照喂给同一套烘焙管线,同时降低乳白强度和不透明度,让运动的场景多透一些出来(HomeActivity.kt、docs/video-wallpaper-glass.md)。还有一套小票(ticket)机制保证"同一时刻只有一个烘焙在飞",晚到的旧帧结果会被丢弃,防止暂停/换源时旧画面盖住新场景。

滚动场景。主屏下滑时应用列表会自然滑走,玻璃底板需要"跟着滚动继续采样同一张模糊壁纸"。FrostGlass 用 BitmapShader 持有预模糊好的位图,绘制时按控件在窗口中的实时位置重算矩阵——纹理始终是同一张图,只是"取图的位置"在变,因此滚动零重算。

控制中心。面板展开时,sampleBehind() 把面板周围(外扩 48 dp)的区域以约 1/4 分辨率截到小位图上,糊 3 遍半径 7 的盒式模糊,整件事在 UI 线程上只花几毫秒、每次打开最多跑一次;背景变化时才置脏重采(ControlCenter.kt)。

Tigris 影视内容场景,视频壁纸透过 Dock 玻璃

小结:一张"烤"好的玻璃,换全场景的性能余量

技术点 做法 出处
渲染策略 每张背景 CPU 烘焙一次,之后当普通位图显示 Glass.kt
模糊 可分离盒式模糊 ×2~3 遍逼近高斯 boxBlur()
折射 圆角矩形 SDF + 法线偏移采样 Glass.kt
高光 左上定向光,与背景解耦后可缓存 UpdateGlass.kt
动态壁纸 100 ms 小快照 + 单烘焙在飞 + 小票防过期 video-wallpaper-glass.md
滚动 同一张模糊纹理按矩阵重采样 FrostGlass.kt

Tigris 的液态玻璃 Dock 证明了:在电视这类算力敏感的场景里,识别出"输入变化慢"的结构,把工作从渲染循环挪到事件触发的预计算里,比堆 GPU 技巧更省钱、也更稳。想动手看完整实现,从 app/src/main/java/com/leslie/tvhome/Glass.kt 这个不到 200 行的文件读起就够,再配合 docs/modules.md 了解模块划分即可。

登录后查看全文
Tigris