pyqtgraph显示STL文件时如何隐藏同一完整平面上的多余线条与边

问题核心原因 #

pyqtgraph的GLMeshItem默认开启drawEdges=True时会渲染所有三角面片的全部边界，而STL模型本质是大量三角面片拼接而成，同一平面内相邻三角面片的共边也会被绘制，因此会出现大量多余的共面边。 #

方案1：预处理网格提取特征边（效果最优，最接近VTK渲染效果） #

原理为筛选出两类边作为需要显示的轮廓边：仅属于一个三角面的模型外轮廓边、两个相邻三角面法向量夹角大于设定阈值的折角边，共面边由于夹角接近0会被过滤。无需使用GLMeshItem自带的边绘制功能，单独将筛选后的边渲染为线元素即可。
示例实现代码：

import numpy as np
from pyqtgraph.opengl import GLMeshItem, GLLinePlotItem

def extract_feature_edges(meshdata, angle_threshold=10):
    # angle_threshold：特征边判断阈值，单位为度，夹角大于该值的边会被保留
    angle_threshold_rad = np.deg2rad(angle_threshold)
    faces = meshdata.faces()
    normals = meshdata.faceNormals()
    edge_face_map = {}

    # 遍历所有三角面，收集边对应的相邻面索引
    for face_idx, face in enumerate(faces):
        for i in range(3):
            edge = tuple(sorted((face[i], face[(i+1)%3])))
            if edge not in edge_face_map:
                edge_face_map[edge] = []
            edge_face_map[edge].append(face_idx)
    
    # 筛选符合要求的特征边
    feature_edge_points = []
    for edge, face_ids in edge_face_map.items():
        # 外轮廓边：仅关联一个三角面
        if len(face_ids) == 1:
            feature_edge_points.append(meshdata.vertexes()[edge[0]])
            feature_edge_points.append(meshdata.vertexes()[edge[1]])
        # 折角边：相邻面法向量夹角大于阈值
        elif len(face_ids) == 2:
            n1 = normals[face_ids[0]]
            n2 = normals[face_ids[1]]
            cos_angle = np.clip(np.dot(n1, n2), -1, 1)
            if np.arccos(cos_angle) > angle_threshold_rad:
                feature_edge_points.append(meshdata.vertexes()[edge[0]])
                feature_edge_points.append(meshdata.vertexes()[edge[1]])
    
    return np.array(feature_edge_points)

# 原网格渲染配置，关闭自带边绘制
mesh = GLMeshItem(
    meshdata=meshdata, 
    smooth=True, 
    drawEdges=False, 
    drawFaces=True,  
    shader='balloon',
    color=(0.4,0.9,0.6,1)
)
# 生成特征边并渲染
feature_edges = extract_feature_edges(meshdata, angle_threshold=8)
edge_item = GLLinePlotItem(
    pos=feature_edges,
    color=(0, 0, 0, 1), # 可自定义边颜色
    width=1,
    antialias=True
)
# 向视图中添加两个渲染元素
view.addItem(mesh)
view.addItem(edge_item)

可调参数说明：

• 调整angle_threshold数值可控制边显示的精细度，数值越小保留的边越多，数值越大保留的边越少，一般5~15度可适配绝大多数场景
• 调整GLLinePlotItem的width、color参数可修改轮廓边的显示样式

方案2：使用社区增强组件 #

如果不需要自定义边处理逻辑，可直接使用pyqtgraph社区扩展的GLFeatureEdgeMeshItem组件，该组件已内置特征边筛选逻辑，仅需传入edgeAngleThreshold参数即可直接实现预期效果。

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