PyQt6实现视频流上方显示瞄准标线的问题求助

场景1：使用QGraphicsScene/QGraphicsView显示视频 #

问题核心大概率是视频项与标记项的层级或添加顺序错误，或是每次更新视频时重新创建了视频项（导致新项覆盖标记）。

正确实现方式： #

1. 先初始化视频项并添加到场景，设置较低的zValue（置于底层）。
2. 添加瞄准标记项，设置更高的zValue，或确保标记项在视频项之后添加（场景中后添加的项默认在上层）。
3. 视频帧更新时，仅更新现有视频项的Pixmap，不要重新创建项。

示例代码：

from PyQt6.QtWidgets import QApplication, QGraphicsView, QGraphicsScene, QGraphicsPixmapItem, QGraphicsLineItem
from PyQt6.QtGui import QPixmap, QPen
from PyQt6.QtCore import Qt, QTimer
import sys

class VideoDisplay(QGraphicsView):
    def __init__(self):
        super().__init__()
        self.scene = QGraphicsScene()
        self.setScene(self.scene)
        self.setFixedSize(640, 480)

        # 初始化视频项（仅创建一次）
        self.video_item = QGraphicsPixmapItem(QPixmap(640, 480))
        self.video_item.setZValue(0)  # 视频置于底层
        self.scene.addItem(self.video_item)

        # 创建瞄准十字标线
        red_pen = QPen(Qt.red, 2, Qt.PenStyle.SolidLine)
        h_line = QGraphicsLineItem(0, 240, 640, 240)
        h_line.setPen(red_pen)
        h_line.setZValue(1)  # 标线置于上层
        v_line = QGraphicsLineItem(320, 0, 320, 480)
        v_line.setPen(red_pen)
        v_line.setZValue(1)

        self.scene.addItem(h_line)
        self.scene.addItem(v_line)

        # 模拟视频帧更新（实际替换为视频流读取逻辑）
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.refresh_video_frame)
        self.timer.start(30)

    def refresh_video_frame(self):
        # 模拟生成视频帧（实际场景可通过OpenCV等转成QPixmap）
        frame = QPixmap(640, 480)
        frame.fill(Qt.GlobalColor.darkGray)
        self.video_item.setPixmap(frame)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = VideoDisplay()
    window.show()
    sys.exit(app.exec())

场景2：使用QLabel显示视频 #

直接在QLabel的paintEvent中绘制标记会被视频帧覆盖，因为每次更新视频都会重写QLabel内容。正确做法是用独立透明覆盖Widget叠加在视频QLabel上方。

正确实现方式： #

1. 创建父Widget，布局中添加视频QLabel。
2. 自定义覆盖Widget，在paintEvent中绘制瞄准标线。
3. 将覆盖Widget设为父Widget的子控件，设置透明属性并调用raise_()确保在上层。

示例代码：

from PyQt6.QtWidgets import QApplication, QWidget, QLabel, QVBoxLayout
from PyQt6.QtGui import QPainter, QPen, QPixmap
from PyQt6.QtCore import Qt, QTimer
import sys

class CrosshairOverlay(QWidget):
    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
        red_pen = QPen(Qt.red, 2, Qt.PenStyle.SolidLine)
        painter.setPen(red_pen)
        
        # 根据控件尺寸绘制十字线
        w, h = self.width(), self.height()
        painter.drawLine(w//2, 0, w//2, h)
        painter.drawLine(0, h//2, w, h//2)

class VideoWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.setFixedSize(640, 480)
        layout = QVBoxLayout(self)
        layout.setContentsMargins(0, 0, 0, 0)

        # 视频显示QLabel
        self.video_label = QLabel()
        self.video_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
        layout.addWidget(self.video_label)

        # 添加覆盖层
        self.overlay = CrosshairOverlay(self)
        self.overlay.setAttribute(Qt.WidgetAttribute.WA_TransparentForMouseEvents)  # 不拦截视频控件交互
        self.overlay.raise_()  # 强制置于视频上方

        # 模拟视频更新
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_video_frame)
        self.timer.start(30)

    def resizeEvent(self, event):
        super().resizeEvent(event)
        # 覆盖层随父控件同步缩放
        self.overlay.resize(self.size())

    def update_video_frame(self):
        # 模拟视频帧更新
        frame = QPixmap(self.video_label.size())
        frame.fill(Qt.GlobalColor.darkGray)
        self.video_label.setPixmap(frame)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = VideoWidget()
    window.show()
    sys.exit(app.exec())

常见错误排查点 #

• 避免每次更新视频都重新创建显示项（QGraphicsItem/QLabel），新创建的控件/项会自动置于上层覆盖标记。
• 使用QGraphicsScene时，确保标记项的zValue大于视频项，或添加顺序在视频项之后。
• 使用覆盖Widget时，必须设置WA_TransparentForMouseEvents避免拦截视频交互，同时调用raise_()确保层级正确。

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