Qt 5.15.2下自定义QQuick3DGeometry无法显示的问题求助

核心问题根源（Qt5与Qt6的API实现差异导致） #

同一份代码在Qt6能正常运行、在Qt5.15.2完全不显示，本质是Qt5.15版本的QtQuick3D属于早期技术预览版，API规则和Qt6正式版存在明显不兼容，代码里有几处必然导致渲染失败的配置错误：

• 错误注册了Qt5不存在的索引属性
  代码中addAttribute(Attribute::IndexSemantic, 0, Attribute::U32Type);属于完全无效的配置：
  • IndexSemantic是Qt6版本才新增的枚举值，Qt5.15的QQuick3DGeometry实现中根本不支持这个语义
  • 索引数据本来就是通过setIndexData()独立配置的，压根不需要通过addAttribute注册。这行代码会直接导致几何元数据校验失败，渲染器连资源都不会加载，更别说显示了。
• 顶点属性与实际存储的数据不匹配
  你当前的顶点缓冲每个顶点仅存储了3个float的位置坐标，总共12字节，没有给法线预留存储空间，但代码里同时注册了偏移为0的法线属性：
  • 渲染管线按照你声明的属性列表读取顶点数据时，会发现顶点结构和声明格式不匹配，轻则读取越界，重则直接跳过整个几何体的绘制
  • 位置和法线属性都指向偏移0的位置，就算数据能正常读取，两个属性抢占同一块内存，渲染结果也必然是错的。
• 缺失Qt5要求的手动资源更新通知
  Qt6中修改几何属性后会自动通知渲染线程刷新资源，但Qt5.15的技术预览版不会自动触发这个流程，所有配置完成后必须手动调用update()方法，不然就算数据全对，渲染端也拿不到最新的几何体。

这也能解释为什么之前尝试改用16位整数索引没有效果——问题根本不在索引宽度，纯粹是前面的配置错误导致连渲染流程都走不到读取索引的步骤。

修正后的核心代码 #

只需要调整setData函数的逻辑，其余代码无需改动：

void MyCustomGeometry::setData(QByteArray vertexData, QByteArray indexData)
{
    clear();
    setPrimitiveType(PrimitiveType::Triangles);
    // 仅注册实际存在的顶点属性：位置
    addAttribute(Attribute::PositionSemantic, 0, Attribute::F32Type);
    // 移除非法的索引属性注册
    // addAttribute(Attribute::IndexSemantic, 0, Attribute::U32Type);
    // 移除无对应存储数据的法线属性，无指定法线时Qt会自动使用面向相机的近似光照计算
    // addAttribute(Attribute::NormalSemantic, 0, Attribute::F32Type);
    setVertexData(vertexData);
    setIndexData(indexData);
    // 每个顶点3个float，步长12字节
    setStride(sizeof(float) * 3);

    // 替换原来脆弱的边界计算逻辑
    QVector3D boundsMin(std::numeric_limits<float>::max(), std::numeric_limits<float>::max(), std::numeric_limits<float>::max());
    QVector3D boundsMax(std::numeric_limits<float>::lowest(), std::numeric_limits<float>::lowest(), std::numeric_limits<float>::lowest());
    auto vertices = reinterpret_cast<const float*>(vertexData.constData());
    const int totalFloats = vertexData.length() / sizeof(float);
    for(int i = 0; i < totalFloats; i += 3)
    {
        boundsMin.setX(std::min(boundsMin.x(), vertices[i]));
        boundsMin.setY(std::min(boundsMin.y(), vertices[i+1]));
        boundsMin.setZ(std::min(boundsMin.z(), vertices[i+2]));
        boundsMax.setX(std::max(boundsMax.x(), vertices[i]));
        boundsMax.setY(std::max(boundsMax.y(), vertices[i+1]));
        boundsMax.setZ(std::max(boundsMax.z(), vertices[i+2]));
    }
    setBounds(boundsMin, boundsMax);
    // 适配Qt5：手动触发渲染资源更新
    update();
}

后续优化提示 #

先保证模型能正常显示，等基础流程跑通后如果需要更真实的光照效果，只需要给每个顶点追加3个float的法线坐标，把顶点步长改成6个float，再设置法线属性的偏移为3个float的长度即可。
另外提一句，Qt5.15自带的QtQuick3D是早期预览版本，bug较多，如果项目允许调整依赖版本，优先使用Qt6正式版的QtQuick3D会减少很多适配成本。

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