pyqtgraph GLTextItem在3D界面中无法显示文本的问题求助

常见原因及修复方案 #

• 字体加载异常：GLTextItem依赖系统字体，默认字体可能无法被正确加载，显式指定系统字体名称即可解决：

  from PyQt5.QtGui import QFont
  # 根据系统选择字体，Windows用"Arial"，Linux/macOS用"DejaVu Sans"
  font = QFont("DejaVu Sans", 16)
  self.view.addItem(gl.GLTextItem(pos=[length, 0, 0], text='X', color=(1, 0, 0, 1), font=font))
  

• 文本尺寸或视角问题：文本可能太小，或者处于相机视野外，调整尺寸和相机参数：

  # 放大文本尺寸，默认size为1，可调整为2或更大
  self.view.addItem(gl.GLTextItem(pos=[length, 0, 0], text='X', color=(1, 0, 0, 1), size=2))
  # 调整相机位置，确保文本在视野内
  self.view.opts['center'] = (0, 0, 0)
  self.view.opts['distance'] = length * 2
  

• 渲染层级被遮挡：GLTextItem可能被其他3D元素覆盖，关闭深度测试让文本优先渲染：

  self.view.addItem(gl.GLTextItem(pos=[length, 0, 0], text='X', color=(1, 0, 0, 1), depthTest=False))
  

• 版本兼容bug：pyqtgraph 0.13.7的GLTextItem存在已知渲染问题，可尝试升级到0.14.x版本（需保证与PyQt5 5.15.9兼容）。

组合参数测试代码 #

如果单一步骤无效，可组合多个参数尝试：

from PyQt5.QtGui import QFont
import pyqtgraph.opengl as gl

font = QFont("DejaVu Sans", 18)
# 添加文本并配置参数
self.view.addItem(gl.GLTextItem(pos=[length, 0, 0], text='X', color=(1, 0, 0, 1), font=font, size=2, depthTest=False))
self.view.addItem(gl.GLTextItem(pos=[0, length, 0], text='Y', color=(0, 1, 0, 1), font=font, size=2, depthTest=False))
self.view.addItem(gl.GLTextItem(pos=[0, 0, length], text='Z', color=(0, 0, 1, 1), font=font, size=2, depthTest=False))
# 调整相机视角
self.view.opts['distance'] = length * 1.5
self.view.opts['azimuth'] = 45
self.view.opts['elevation'] = 30

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