Picom 项目中窗口透明度调节问题的分析与解决方案

问题背景

在 Picom 合成器的最新版本(v12-rc2)中，用户报告了一个关于窗口透明度调节功能的问题。具体表现为使用 picom-trans 命令调整活动窗口透明度时，窗口透明度不会立即改变，需要移动窗口或切换焦点后才能看到效果变化。

技术分析

问题根源

经过开发者调查，发现这个问题源于 Picom 12-rc2 版本中透明度规则处理逻辑的变化。当窗口透明度通过规则集(rules)设置时，picom-trans 命令设置的透明度属性会被忽略。这是因为：

1. 规则集(rules)定义的透明度优先级高于 picom-trans 设置的透明度属性
2. 只有当窗口状态改变(如移动或焦点变化)时，Picom 才会重新评估窗口属性

新旧版本行为对比

在旧版本中，Picom 使用简单的全局透明度设置：

• inactive-opacity - 非活动窗口透明度
• active-opacity - 活动窗口透明度

而在新版本中，推荐使用更灵活的规则集(rules)来定义透明度行为，例如：

rules: ({
    match = "focused",
    opacity = 0.9,
}, {
    match = "! focused",
    opacity = 0.6,
})

解决方案

方法一：修改规则匹配条件

开发者建议在规则集中添加对 _NET_WM_WINDOW_OPACITY 属性的排除条件，允许 picom-trans 的修改生效：

rules: ({
    match = "focused && ! _NET_WM_WINDOW_OPACITY",
    opacity = 0.9,
}, {
    match = "! focused && ! _NET_WM_WINDOW_OPACITY",
    opacity = 0.6,
})

方法二：兼容旧配置方式

对于习惯旧配置方式的用户，可以继续使用 opacity-rule 语法，但需要注意：

1. 确保没有冲突的规则集定义
2. 可能需要添加 ! _NET_WM_WINDOW_OPACITY 条件

示例配置：

opacity-rule = [
    "100:fullscreen && ! _NET_WM_WINDOW_OPACITY",
    "95:class_g = 'URxvt' && ! _NET_WM_WINDOW_OPACITY",
    ...
];

最佳实践建议

1. 明确优先级：理解规则集(rules)优先级高于单独属性设置
2. 测试验证：修改配置后，通过移动窗口或切换焦点验证效果
3. 逐步迁移：从简单规则开始，逐步增加复杂度
4. 日志调试：使用 log-level = "DEBUG" 查看透明度计算过程

总结

Picom 12-rc2 引入了更强大的规则系统，但也改变了透明度调节的工作方式。通过合理配置规则条件和理解属性优先级，用户既可以享受新功能的灵活性，又能保持原有的窗口透明度调节习惯。对于依赖 picom-trans 命令的高级用户，特别注意排除 _NET_WM_WINDOW_OPACITY 条件是实现平滑过渡的关键。