SDL结合QWidget的简单使用说明

SDL(Simple DirectMeida Layer)是一个简单的封装媒体库,功能主要涉及了相关于OpenGL或者DirectX的显卡硬件功能和一些鼠标,键盘等外设访问。这里主要只说明一下它的渲染功能

因为Qt本身不支持YUV流媒体数据显示,且QWidget默认是栅格式渲染(qml是默认GPU),用的是CPU,这样如果渲染方面涉及了反走样,优化等数据计算,对CPU的消耗是比较高的,这里我们期望能用GPU来负责处理渲染

GPU的处理就必须使用能调用显卡的功能,通常来说在Win下是Opengl和D3D,但是要短时间熟悉使用还是比较麻烦的,这里就需要SDL了;SDL已经在下层封装好了这些显卡相关库的使用,我们只需要按照他定义的更简洁的一系列接口即可实现效果

这里以YV12为例,因为个人需求,我又加上了在渲染层上再渲染一张png图片和一段文字的效果

首先在官网下载源代码http://www.libsdl.org/download-2.0.php

目前最新的源码版本是2.0.8,且主页依然提供了1.0版本的下载。1.0的使用和接口跟2.0有很多不一样的地方,这里建议还是直接用最新版

下载解压后目录如图

可以看到SDL支持各大主流平台,这里因为是在Win上,直接进入VisualC目录

解决方案已经存在,直接打开编译即可。

成功后在输出目录找到

这就是我们需要的动态库(另外还有一个SDL2main的库,因为我们是通过Qt创建的窗口,所以这个不需要了,如果完全使用SDL来建立渲染窗口的话,一定要加上这个库)

下一步,先创建一个QWidget用来做渲染

#ifndef _SDL_RENDER_WND_H__
#define _SDL_RENDER_WND_H__
/********************************************************************
文件名  :    SDLRenderWnd
作者    :    @Kaiming
创建时间:    2018/3/26 11:27
版本    :     1.0
文件描述:    SDL YUV420流输出窗口
*********************************************************************/

#include <QWidget>
struct SDL_Renderer;
struct SDL_Texture;
struct SDL_Window;

class SDLRenderWnd : public QWidget
{
    Q_OBJECT

public:
    SDLRenderWnd(QWidget *parent = 0);
    ~SDLRenderWnd();

    void Clear();

protected:
    virtual void resizeEvent(QResizeEvent *event);

private:
    static void SDL_Related_Init();
    static void SDL_Related_Uninit();

public slots:
//根据传入数据流显示视频
    void PresentFrame(const unsigned char* pBuffer, int nImageWidth, int nImageHeight);
private:
    SDL_Renderer*        m_pRender;
    SDL_Texture*         m_pTexture;
    SDL_Window*          m_pWindow;

    static int            m_nRef;        //引用计数来确定SDL全局资源的创建和回收
};

#endif // _SDL_RENDER_WND_H__

具体实现

#include "SDLRenderWnd.h"
extern "C" {
#include "sdl\SDL.h"
}
#pragma comment(lib, "SDL2.lib")

int SDLRenderWnd::m_nRef = 0;
SDLRenderWnd::SDLRenderWnd(QWidget *parent)
    : QWidget(parent),
      m_pTexture(nullptr),
      m_bEmpty(true)
{
    setUpdatesEnabled(false);
    SDL_Related_Init();
    m_pWindow = SDL_CreateWindowFrom((void*)winId());
    m_pRender = SDL_CreateRenderer(m_pWindow, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
}

SDLRenderWnd::~SDLRenderWnd()
{
    if (m_pWindow)
        SDL_DestroyWindow(m_pWindow);
    if (m_pRender)
        SDL_DestroyRenderer(m_pRender);
    if (m_pTexture)
        SDL_DestroyTexture(m_pTexture);
    SDL_Related_Uninit();
}

void SDLRenderWnd::PresentFrame(const unsigned char* pBuffer, int nImageWidth, int nImageHeight)
{
    if (!m_pRender) {
        printf("Render not Create\n");
    }
    else {
        int nTextureWidth = 0, nTextureHeight = 0;
    //首先查询当前纹理对象的宽高,如果不符合,那么需要重建纹理对象 SDL_QueryTexture(m_pTexture, nullptr, nullptr,
&nTextureWidth, &nTextureHeight); if (nTextureWidth != nImageWidth || nTextureHeight != nImageHeight) { if (m_pTexture) SDL_DestroyTexture(m_pTexture);
      //这里指定了渲染的数据格式,访问方式和宽高大小 m_pTexture
= SDL_CreateTexture(m_pRender, SDL_PIXELFORMAT_IYUV, SDL_TEXTUREACCESS_STREAMING, nImageWidth, nImageHeight); } } if (!m_pTexture) { printf("YUV Texture Create Failed\n"); } else {
     //用新数据刷新纹理 SDL_UpdateTexture(m_pTexture, nullptr, pBuffer, nImageWidth);
     //清除当前渲染 SDL_RenderClear(m_pRender);
//拷贝纹理对象到渲染器中 SDL_RenderCopy(m_pRender, m_pTexture, nullptr, nullptr);
     //最终渲染
     SDL_RenderPresent(m_pRender);
  } }
void SDLRenderWnd::Clear()
 
} void SDLRenderWnd::SDL_Related_Init() { if (0 == m_nRef++) { SDL_Init(SDL_INIT_VIDEO); } } void SDLRenderWnd::SDL_Related_Uninit() { if (0 == --m_nRef) { SDL_Quit(); } }

因为SDL是纯C库,注意加上extern “C";通过SDL_CreateWindowFrom((void*)winId());建立QWidget的窗口句柄和SDL的联系,这之后,Widget本身就没什么操作的了,剩下的工程都交给SDL来负责;然后通过创建的SDL_Window建立SDL_Render渲染器

渲染过程具体看PresentFrame里面的注释,还有一点要特别注意的是一定要加上setUpdatesEnabled(false);这句是关闭QWidget自身的刷新动作,如果不设置,那么就会存在两个渲染互相刷新,如果窗口不动还好,一旦resize的时候就就会有明显的闪烁效果

还有一点就是,参看我头文件里是把PresentFrame写成了一个slot,所以刷新动作是放在主线程执行的,并不是说子线程执行不可以,但是从自己的测试来看,子线程执行渲染会出现很多不可预知的问题,比如窗口缩放后会导致渲染无效,崩溃等等。另外提一句老生常谈的话就是调用这个slot注意保护参数,数据流是指针形式,如果异步执行要小心指针无效的情况

下一篇谈在这个基础上给视频加图片,文字效果的方式

 

posted @ 2018-04-18 15:04  公子开明  阅读(3099)  评论(0编辑  收藏  举报