Tigris 液态玻璃 Dock 的幕后:CPU 预计算模糊与折射的渲染技术拆解
Tigris 液态玻璃 Dock 的幕后:CPU 预计算模糊与折射的渲染技术拆解
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():
它分三步走:
- 截取背景区域:以 Dock 为圆心,向外扩出一圈 margin(留给边缘折射"伸手"和模糊扩散),把这块区域画到一张离屏位图,再用
getPixels()读成一维IntArray(Glass.kt)。 - 行、列各扫一遍:水平方向滑窗平均写入临时数组,垂直方向再平均写回。用"滑动窗口累加和"(新加进一个像素、减掉滑出像素)让每条扫描线的成本降为 O(宽度 × 半径),而不是 O(宽度 × 半径²)。
- 重复多次逼近高斯:根据中心极限定理,多次盒式卷积会趋近高斯分布。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):
- 算距离:对玻璃内每个像素,按圆角矩形 SDF 公式算出它到边缘的有向距离
sdf——负值在内部,绝对值越大越靠近中心; - 算法线:由 SDF 梯度方向推导出指向玻璃外侧的单位法线
(nx, ny),圆角区沿对角方向,直边区沿水平或垂直; - 偏移采样:越靠近边缘(
depth越小),沿法线向外偏移越多,偏移量按二次曲线增长(off = t * t * pull,Glass.kt),再回到背景数组里采样——这就是"从边缘之外把像素拉进来"的折射带,宽度约取min(高 × 0.26, 圆角 × 1.4)。
同一段循环里还顺手做掉了三件事:
- 乳白 + 微饱和:按亮度分量把颜色轻微推向灰白再提饱和("a little milky",Glass.kt),
frostStrength参数控制乳白强度; - 定向高光:光源假定在左上角,法线朝光的面更亮、背光面保留一道更柔和的反射,2.2 px 宽的边缘描边按这个光照混合白色(Glass.kt);
- 内侧柔光:紧贴亮边内侧再叠一圈 16% 强度的柔光,让边缘"由内发光"。
高光与投影的缓存:光照只算一次
折射和模糊依赖背景,但光照只依赖玻璃的形状。软件更新页的 UpdateGlass 利用了这一点:先用一张纯黑 1×1 位图烘焙,把折射、高光从结果中剥出来变成一张与背景无关的白色光照蒙版,按「宽:高:圆角:类型」为 key 缓存——背景怎么换,高光都只需算一次(UpdateGlass.kt)。
应用卡片的投影同样是预计算位图:用软件绘制的 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)。
小结:一张"烤"好的玻璃,换全场景的性能余量
| 技术点 | 做法 | 出处 |
|---|---|---|
| 渲染策略 | 每张背景 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 了解模块划分即可。




