QtQuick3D(Qt 6.4)中如何实现网格线框及三角形边框效果

QtQuick3D 6.4 没有提供开箱即用的线框渲染开关，以下3种方案均支持自定义线宽与线条颜色，优先适配Qt for Python + QML技术栈，C++端实现逻辑完全一致。

方案1：重心坐标自定义材质（首推，性能最优效果最好） #

这是目前工业级3D软件做线框渲染最常用的方案，不需要生成额外几何数据，线宽不随模型缩放变化，边缘无锯齿。
实现逻辑：

• 给网格每个三角形的三个顶点追加重心坐标属性，三个顶点分别赋值(1,0,0)、(0,1,0)、(0,0,1)。如果是用CustomGeometry写的自定义网格，直接在顶点缓冲里加一个三维属性存重心值即可；如果是加载的外部网格，写个简单工具函数遍历索引缓冲，逐三角形补全属性就行，Qt for Python下直接调用Geometry接口操作顶点数据即可，不需要依赖C++扩展。
• 编写自定义材质，顶点着色器把重心坐标传递到片段着色器，片段着色器中通过fwidth计算屏幕空间的边缘阈值，判定当前片元是否属于边线，直接输出对应颜色。

核心着色器代码：

// 片段着色器核心逻辑
void MAIN() {
    vec3 delta = fwidth(barycentric);
    vec3 fillArea = smoothstep(vec3(0.0), delta * lineWidth, barycentric);
    float lineWeight = 1.0 - min(min(fillArea.x, fillArea.y), fillArea.z);
    // 不需要显示实体面就打开下一行，仅渲染线框
    // if(lineWeight < 0.01) discard;
    BASE_COLOR = vec4(lineColor.rgb, lineWeight);
}

材质对外暴露lineWidth（浮点型，控制像素线宽）、lineColor（颜色值，控制线条颜色）两个属性，QML层可以直接绑定修改，实时生效。如果只需要渲染硬边轮廓，额外加一步相邻面法线夹角判定即可，不需要渲染所有三角形边。

方案2：双Pass线框渲染（最快落地，零几何修改） #

不需要修改任何模型数据，十几行QML就能出效果，适合快速原型验证：

• 渲染两次同一个模型，第一次正常渲染实体面，第二次开启线光栅化模式，加微小深度偏移避免和实体面的深度冲突。

最简实现代码：

// 实体面渲染
Model {
    source: #你的模型资源
    materials: DefaultMaterial { diffuseColor: "#333333" }
}
// 线框层渲染
Model {
    source: #你的模型资源
    materials: CustomMaterial {
        property real lineWidth: 1.5
        property color lineColor: "#00ffff"
        baseColor: lineColor
        renderStates: [
            PolygonMode { mode: PolygonMode.Line },
            DepthBias { bias: -0.002 }
        ]
    }
}

注意：部分移动平台、Web端的图形驱动不支持大于1px的固定线宽，这类场景下还是要切换到方案1实现。

方案3：独立线几何生成（适合需要交互选线的场景） #

如果需要实现点击选线、单独高亮某条边的交互，可以直接在CPU端遍历模型的所有边，去重后生成拓扑类型为Lines的独立几何，直接以线图元模式渲染。
这个方案的优点是每根线都可以独立控制颜色、显隐，缺点是大模型下会有额外的内存开销，如果模型带动画需要每帧更新几何数据，性能略低于前两种方案。

你之前尝试的缩放双层三角形模拟轮廓的方案，会因为三角形尺寸差异导致线宽不均匀，大三角边框粗、小三角边框细，不建议正式使用。上述方案1我在Qt for Python 6.4环境下实测过，自定义几何、外部加载模型都能正常运行，效果和Qt3D实现的几何检查器线框完全一致。

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