如何像使用QLabel一样用QCameraViewFinder显示QImage或Pixmap？

好问题！QCameraViewFinder本身确实没有像QLabel那样直接的setPixmap方法——毕竟它的本职工作是显示相机的实时预览帧。不过我们可以借助Qt的绘图机制，用两种方式实现类似QLabel的图像显示效果：

方案一：自定义ViewFinder子类（推荐） #

通过继承QCameraViewFinder并重写paintEvent，我们可以给它添加一个setPixmap方法，完全复刻QLabel的使用体验。

步骤1：创建自定义子类 #

首先定义一个CustomCameraViewFinder类，添加存储Pixmap的成员变量和setPixmap方法：

// customcameraviewfinder.h
#include <QCameraViewfinder>
#include <QPixmap>

class CustomCameraViewFinder : public QCameraViewfinder
{
    Q_OBJECT
public:
    explicit CustomCameraViewFinder(QWidget *parent = nullptr);

    void setPixmap(const QPixmap &pixmap);

protected:
    void paintEvent(QPaintEvent *event) override;

private:
    QPixmap m_pixmap;
};

步骤2：实现子类逻辑 #

在cpp文件中实现setPixmap和paintEvent，处理图像的缩放和居中：

// customcameraviewfinder.cpp
#include "customcameraviewfinder.h"
#include <QPainter>

CustomCameraViewFinder::CustomCameraViewFinder(QWidget *parent)
    : QCameraViewfinder(parent)
{}

void CustomCameraViewFinder::setPixmap(const QPixmap &pixmap)
{
    m_pixmap = pixmap;
    update(); // 触发重绘
}

void CustomCameraViewFinder::paintEvent(QPaintEvent *event)
{
    if (!m_pixmap.isNull()) {
        QPainter painter(this);
        painter.setRenderHint(QPainter::SmoothPixmapTransform); // 开启平滑缩放

        // 按比例缩放图像，适配控件大小并居中
        QPixmap scaledPixmap = m_pixmap.scaled(size(), Qt::KeepAspectRatio, Qt::SmoothTransformation);
        QPoint drawPos = rect().center() - scaledPixmap.rect().center();
        painter.drawPixmap(drawPos, scaledPixmap);
    } else {
        // 如果没有自定义图像，调用父类的paintEvent显示相机预览
        QCameraViewfinder::paintEvent(event);
    }
}

使用方式 #

之后你就可以像用QLabel一样使用它了：

CustomCameraViewFinder *viewFinder = new CustomCameraViewFinder(this);
viewFinder->setPixmap(QPixmap("path/to/your/image.png"));
// 切换回相机预览的话，只需调用setPixmap(QPixmap())清空图像即可

方案二：直接在现有ViewFinder上绘制（临时场景） #

如果只是临时需要在ViewFinder上画一次图像，不想子类化，可以直接用QPainter绘制：

void drawImageOnViewFinder(QCameraViewFinder *viewFinder, const QImage &image)
{
    QPixmap pixmap = QPixmap::fromImage(image);
    QPainter painter(viewFinder);
    painter.setRenderHint(QPainter::SmoothPixmapTransform);

    // 填充整个ViewFinder（忽略比例）
    painter.drawPixmap(viewFinder->rect(), pixmap.scaled(viewFinder->size(), Qt::IgnoreAspectRatio));

    // 或者保持比例居中：
    // QPixmap scaled = pixmap.scaled(viewFinder->size(), Qt::KeepAspectRatio);
    // painter.drawPixmap((viewFinder->width() - scaled.width())/2, (viewFinder->height() - scaled.height())/2, scaled);
}

⚠️ 注意：如果你的ViewFinder正在显示相机预览，直接绘制的图像会被下一帧相机画面覆盖。所以使用前需要先暂停相机：

camera->stop();
drawImageOnViewFinder(viewFinder, myImage);

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