PyQt QGraphicsScene导出带文字MP4：效率优化与ffmpeg报错解决

一、高效渲染优化方案 #

1. 按帧率采样，放弃逐毫秒渲染 #

• 改用**目标帧率（如25/30fps）**控制采样，30fps对应每33ms渲染一帧，5秒视频仅需150帧，既保证流畅度又大幅降低渲染量。
• 跟随原视频帧率同步渲染：监听QMediaPlayer::videoFrameChanged信号获取实时视频帧，收到新帧时同步渲染整个场景，确保视频与文字元素完全对齐，避免手动设置QMediaPlayer::setPosition()带来的延迟和同步问题。

2. 优化QGraphicsScene渲染性能 #

• 直接渲染到QImage：QImage是CPU友好的像素容器，避免QPixmap的GPU/CPU内存转换开销，用预分配的QImage接收渲染结果：

  // 预分配与场景分辨率一致的QImage
  QImage sceneImage(scene->sceneRect().size().toSize(), QImage::Format_RGB888);
  QPainter painter(&sceneImage);
  scene->render(&painter);
  

• 关闭不必要的渲染提示：禁用抗锯齿、平滑转换等选项减少渲染耗时：

  QGraphicsView* view = new QGraphicsView(scene);
  view->setRenderHint(QPainter::Antialiasing, false);
  view->setRenderHint(QPainter::SmoothPixmapTransform, false);
  

• 复用渲染容器：避免每次渲染创建新QImage，预分配后直接覆盖内容。

3. 自定义视频帧渲染逻辑 #

替代原生QGraphicsVideoItem，用QAbstractVideoSurface接收视频帧并绘制到自定义QGraphicsItem，更灵活控制帧更新：

class VideoItem : public QGraphicsItem, public QAbstractVideoSurface {
public:
    bool present(const QVideoFrame& frame) override {
        currentFrame = frame.image();
        update();
        return true;
    }
    void paint(QPainter* painter, const QStyleOptionGraphicsItem*, QWidget*) override {
        painter->drawImage(boundingRect(), currentFrame);
        // 可直接在此叠加绘制文字，减少QGraphicsTextItem的渲染开销
    }
private:
    QImage currentFrame;
};

二、FFmpeg断言错误解决（Assertion fctx->async_lock failed） #

该错误源于编码上下文线程安全问题或参数初始化错误，按以下步骤修复：

1. 禁用多线程编码 #

直接强制单线程编码，避免异步锁未正确初始化的问题：

AVCodecContext* codec_ctx = avcodec_alloc_context3(codec);
codec_ctx->thread_count = 1; // 禁用多线程编码

2. 规范编码器初始化流程 #

确保编码上下文参数配置正确，编码器打开流程无遗漏：

// 1. 查找H.264编码器
AVCodec* codec = avcodec_find_encoder(AV_CODEC_ID_H264);
if (!codec) { /* 错误处理 */ }

// 2. 初始化编码上下文
AVCodecContext* codec_ctx = avcodec_alloc_context3(codec);
codec_ctx->width = sceneImage.width();
codec_ctx->height = sceneImage.height();
codec_ctx->pix_fmt = AV_PIX_FMT_YUV420P; // MP4标准像素格式
codec_ctx->framerate = av_make_q(30, 1);
codec_ctx->bit_rate = 5000000;
codec_ctx->thread_count = 1;

// 3. 打开编码器
if (avcodec_open2(codec_ctx, codec, nullptr) < 0) { /* 错误处理 */ }

3. 确保输入帧格式匹配 #

将QImage的RGB格式转换为FFmpeg编码器要求的YUV420P格式：

AVFrame* frame = av_frame_alloc();
frame->width = sceneImage.width();
frame->height = sceneImage.height();
frame->format = AV_PIX_FMT_YUV420P;
av_frame_get_buffer(frame, 0);

// 像素格式转换
struct SwsContext* sws_ctx = sws_getContext(
    sceneImage.width(), sceneImage.height(), AV_PIX_FMT_RGB24,
    frame->width(), frame->height(), AV_PIX_FMT_YUV420P,
    SWS_BILINEAR, nullptr, nullptr, nullptr
);
uint8_t* src_data[] = {sceneImage.bits()};
int src_linesize[] = {sceneImage.bytesPerLine()};
sws_scale(sws_ctx, src_data, src_linesize, 0, sceneImage.height(),
          frame->data, frame->linesize);

4. 线程安全保护编码流程 #

若渲染与编码在不同线程执行，用QMutex保护编码上下文操作：

QMutex encodeMutex;

// 编码线程中
encodeMutex.lock();
int ret = avcodec_send_frame(codec_ctx, frame);
if (ret >= 0) {
    ret = avcodec_receive_packet(codec_ctx, pkt);
    // 写入数据包到输出文件
}
encodeMutex.unlock();

三、整体流程总结 #

1. 初始化QMediaPlayer，用自定义VideoItem接收并绘制视频帧。
2. 预分配QImage，按视频帧率同步渲染整个场景（包含文字元素）。
3. 初始化FFmpeg编码器，配置单线程模式，将QImage转换为YUV420P格式帧。
4. 编码每帧并写入MP4文件，完成后释放FFmpeg资源。

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