使用Qt Q3DSurface显示平面时无渲染输出的问题咨询

你遇到的问题是由Q3DSurface几个容易忽略的默认规则和渲染特性导致的，核心原因如下： #

1. 默认开启背面剔除 #

Q3DSurface默认开启背面剔除功能，只会渲染三角形面的正面，背面会被直接丢弃。你第一次构造的平面的顶点顺序生成的三角形面，正面朝向恰好和默认相机视角方向相反，就会被剔除，导致看不到任何内容。
你可以添加代码调整相机视角验证：

// 调整相机到X轴负方向，面向你的平面
graph->scene()->activeCamera()->setCameraPreset(Q3DCamera::CameraPresetFront);

调整后就能看到你构造的垂直于ZOY平面的平面。 #

2. 小范围数值的浮点精度问题 #

你第一次构造的平面Y轴数值范围只有0.1（0.16_{0.26），远小于X轴（0}1.5）和Z轴（0.29~0.825）的范围，Q3DSurface默认的自动轴适配会放大Y轴的渲染精度，容易出现浮点精度误差导致的面片裁剪问题。
你可以手动指定Y轴范围解决这个问题：

graph->axisY()->setRange(0, 0.5);

3. Q3DSurface的数据排列规范（易踩坑） #

Q3DSurface作为高度图渲染组件，对数据排列有严格要求，不符合规范的数据即使逻辑上是合法的平面，也可能无法渲染：

• 每一个QSurfaceDataRow内的所有点X坐标必须一致，Z坐标必须严格单调递增
• 不同QSurfaceDataRow之间的X坐标必须严格单调递增
• 所有QSurfaceDataRow的长度必须完全相同
  你第一次的代码符合这个规范，而你替换后的代码里同一行的Z坐标相同，其实是不符合规范的，只是刚好能渲染而已。

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