QML Material风格涟漪显示异常：点击按钮时涟漪出现在屏幕左上角

以下是可能的原因及对应的解决思路：

• 触摸坐标映射未正确校准
  linuxfb平台没有窗口系统做坐标中转，Qt可能无法将触摸硬件的原始坐标正确转换为控件的局部坐标。可以通过以下方式排查：

  • 设置环境变量QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS指定触摸校准参数，格式为device_name:min_x:max_x:min_y:max_y，比如QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event0:0:1920:0:1080；
  • 在QML中添加调试代码，打印触摸事件的全局坐标和按钮的mapToGlobal()坐标，确认两者的对应关系是否匹配。

• 屏幕尺寸与Qt识别的尺寸不匹配
  即使窗口尺寸设置正确，Qt可能未正确识别Framebuffer的实际分辨率，导致坐标计算偏差：

  • 启动应用时显式设置QT_QPA_FB_WIDTH和QT_QPA_FB_HEIGHT环境变量，比如QT_QPA_FB_WIDTH=1920 QT_QPA_FB_HEIGHT=1080；
  • 禁用高DPI缩放，设置QT_SCALE_FACTOR=1，避免因自动缩放导致坐标偏移。

• linuxfb平台对Material风格效果的支持缺陷
  Qt的linuxfb插件对部分Qt Quick Material控件的动态效果存在兼容性问题，尤其是Ripple的坐标计算逻辑：

  • 尝试升级Qt到6.8.x的最新补丁版本，或后续稳定版，看是否修复了该已知问题；
  • 自定义Ripple效果：替换默认的Material按钮Ripple，手动计算触摸点相对于按钮的局部坐标，比如在按钮的onPressed信号中获取mouse.x和mouse.y，作为Ripple的起始位置。

• 无边窗口的坐标计算逻辑差异
  嵌入式linuxfb的窗口模型与桌面端不同，根窗口的坐标基准可能存在差异：

  • 确保QML根Item的x、y属性均为0，且未设置额外的边距或偏移；
  • 检查是否存在嵌套Item的坐标偏移，导致按钮的全局位置计算错误。

内容的提问来源于stack exchange，提问作者Neeraj Usadadiya