WayfireWM中自定义视频模式问题的分析与解决

在WayfireWM项目中，用户报告了一个关于自定义视频模式无法正确设置的问题。该问题表现为当用户尝试通过wlr-randr工具设置自定义刷新率（如1920x1080@70Hz）时，系统实际上会使用显示器EDID中报告的默认模式（如143.766006Hz），而不是用户指定的自定义模式。

问题背景

WayfireWM作为一款基于wlroots的合成器，理论上应该支持通过wlr-randr工具设置任意自定义视频模式。这一功能在其他基于wlroots的合成器（如Sway和Labwc）中工作正常，用户可以通过命令行轻松创建和使用非标准刷新率的视频模式，这对于运行老式游戏或特定应用程序非常有用。

问题表现

用户尝试使用以下命令设置自定义模式：

wlr-randr --output HDMI-A-1 --custom-mode 1920x1080@70

虽然命令执行成功，但实际生效的却是显示器EDID中报告的143.766006Hz模式。通过调试日志可以看到以下错误信息：

Failed to page-flip output: a page-flip is already pending
Output commit failed!

技术分析

该问题源于WayfireWM对自定义视频模式的处理逻辑存在缺陷。具体表现为：

1. 系统能够接受自定义模式的设置请求
2. 但在实际应用新模式时，会回退到EDID报告的模式
3. 错误日志显示页面翻转操作失败，表明存在同步问题

解决方案

开发团队通过代码审查和测试，提出了修复方案（PR #2383）。该修复主要解决了以下方面：

1. 正确处理自定义视频模式的设置请求
2. 确保模式切换时的同步操作正确执行
3. 避免与现有页面翻转操作的冲突

验证结果

经过验证，修复后的版本能够：

• 正确应用通过wlr-randr设置的自定义视频模式
• 在系统日志中显示正确的模式切换信息
• 保持与其他wlroots合成器相同的行为一致性

总结

这个问题的解决不仅修复了WayfireWM中自定义视频模式的功能，也增强了其与其他wlroots生态工具的兼容性。对于需要使用非标准刷新率的用户（如游戏玩家或多媒体创作者）来说，这一修复具有重要意义。

开发团队建议用户更新到包含该修复的版本，以获得完整的视频模式控制功能。同时，也展示了WayfireWM项目对用户反馈的积极响应和对功能完整性的持续追求。