Qt5.15使用QQuick3DGeometry实现自定义几何体网格渲染问题咨询

完全可以在Qt 5.15版本下实现自定义几何体网格渲染，QQuick3DGeometry类完全可以支撑该需求。你遇到的网格无法渲染问题，是Qt5与Qt6的QtQuick3D模块API细节差异导致的，而非能力不支持。

核心适配要点 #

• 顶点步长显式声明：Qt6中QQuick3DGeometry可自动推导顶点步长，但Qt5.15必须调用setStride()方法显式设置每个顶点的总字节长度，否则顶点缓冲解析会出错。
• 脏标记手动触发：Qt6中修改几何体数据后会自动标记更新，Qt5.15在调用update()后，必须额外调用markDirty(DirtyGeometry)通知渲染管线刷新数据。
• 属性语义手动配置：Qt5.15没有提供Qt6新增的预设顶点属性枚举，所有顶点属性（位置、法线、UV、颜色等）都需要手动指定语义、偏移量、数据类型和分量数，参数不匹配会导致渲染失败。
• 材质显式适配：Qt5.15的默认材质不会自动检测顶点属性是否存在，比如使用顶点颜色时需要显式开启vertexColorsEnabled: true，缺少法线/UV属性时要关闭材质对应的光照/纹理特性，避免管线报错。
• 裁剪规则校验：Qt5与Qt6的默认背面裁剪规则存在细微差异，调试阶段可以先将模型的cullMode设为NoCull，排除裁剪导致的网格不可见问题。

最小可运行示例片段 #

C++ 几何体定义 #

#include <QQuick3DGeometry>

class CustomTriangle : public QQuick3DGeometry
{
public:
    CustomTriangle() {
        // 定义顶点结构
        struct Vertex {
            QVector3D position;
            QVector3D color;
        };

        // 构造三角形顶点数据
        const QVector<Vertex> vertexData = {
            {{-1.0f, -1.0f, 0.0f}, {1.0f, 0.0f, 0.0f}},
            {{1.0f, -1.0f, 0.0f}, {0.0f, 1.0f, 0.0f}},
            {{0.0f, 1.0f, 0.0f}, {0.0f, 0.0f, 1.0f}}
        };

        // 填充顶点缓冲
        QByteArray buffer(reinterpret_cast<const char*>(vertexData.constData()),
                          vertexData.size() * sizeof(Vertex));
        setVertexData(buffer);

        // 显式设置步长（Qt5必填）
        setStride(sizeof(Vertex));

        // 添加顶点属性
        addAttribute(Attribute::PositionSemantic, 0, Attribute::F32Type, 3);
        addAttribute(Attribute::ColorSemantic, sizeof(QVector3D), Attribute::F32Type, 3);

        // 配置渲染参数
        setPrimitiveType(Triangles);
        setVertexCount(vertexData.size());

        // 触发更新（两个方法都要调用）
        update();
        markDirty(DirtyGeometry);
    }
};

QML 调用代码 #

import QtQuick3D 1.15

Model {
    geometry: CustomTriangle {}
    materials: DefaultMaterial {
        vertexColorsEnabled: true // 显式开启顶点颜色支持
    }
    cullMode: Model.NoCull // 调试阶段关闭背面裁剪
}

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