如何移除pyqtgraph.GraphicsLayoutWidget的黑色边距？

要消除界面的黑色边距，可从以下几个关键环节调整：

1. 清除GraphicsLayout的默认边距 #

PyQtGraph的GraphicsLayout对象支持和PyQt5一致的setContentsMargins方法，直接设置四边边距为0即可：

layout.setContentsMargins(0, 0, 0, 0)

2. 关闭ViewBox的自动内边距 #

ViewBox默认会给图像添加少量内边距（padding）以适配自动范围，可通过两种方式消除：

• 方式一：关闭自动范围的padding

self.viewbox.setAutoVisible(y=True, x=True, padding=0)

• 方式二：手动指定ViewBox范围匹配图像尺寸
  如果你的图像是二维numpy数组，可直接获取其宽高后设置范围：

h, w = image.shape
self.viewbox.setRange(pg.QtCore.QRectF(0, 0, w, h))

完整修改后的代码 #

整合以上调整后的完整类实现：

import pyqtgraph as pg
import numpy as np

class MyGraphicsLayoutWidget(pg.GraphicsLayoutWidget):
    def __init__(self, image):
        super().__init__()
        layout = self.addLayout()
        # 清除layout默认边距
        layout.setContentsMargins(0, 0, 0, 0)
        
        self.viewbox = layout.addViewBox(lockAspect=True)
        self.image_item = pg.ImageItem(image)
        self.viewbox.addItem(self.image_item)
        
        # 关闭ViewBox自动内边距
        self.viewbox.setAutoVisible(y=True, x=True, padding=0)
        
        self.show()

# 测试示例
if __name__ == "__main__":
    import sys
    from PyQt5.QtWidgets import QApplication
    app = QApplication(sys.argv)
    test_img = np.random.rand(200, 200)
    widget = MyGraphicsLayoutWidget(test_img)
    sys.exit(app.exec_())

说明 #

黑色边距通常来自两个源头：一是GraphicsLayout自带的默认边距，二是ViewBox为自动范围添加的padding。同时调整这两处即可彻底消除边距。

内容的提问来源于stack exchange，提问作者温泽海