「Qt Widget中文示例指南」如何实现一个简单的RHI小部件示例（一）

Qt 是目前最先进、最完整的跨平台C++开发工具。它不仅完全实现了一次编写，所有平台无差别运行，更提供了几乎所有开发过程中需要用到的工具。如今，Qt已被运用于超过70个行业、数千家企业，支持数百万设备及应用。

本文将为大家演示如何使用QRhi、Qt的3D API和着色语言抽象层渲染三角形。

点击获取Qt Widget组件下载(Q技术交流：166830288）

在很多方面，这个示例都是QWidget世界中的RHI窗口示例的对应。这个应用程序中的QRhiWidget子类使用带有基本顶点和片段着色器的简单图形管道渲染单个三角形。与普通的基于QWindow的应用程序不同，本示例不需要担心较低级别的细节，比如设置窗口和QRhi，或者处理交换链和窗口事件，因为这些都由这里的QWidget框架负责。QRhiWidget子类的实例被添加到QVBoxLayout中，为了使示例保持最小和紧凑，没有引入更多的小部件或3D内容。

一旦将ExampleRhiWidget (QRhiWidget的子类)的实例添加到顶级小部件的子层次结构中，相应的窗口就会自动变成Direct 3D、Vulkan、Metal或opengl渲染窗口。QPainter渲染的小部件内容，即不是QRhiWidget、QOpenGLWidget或QQuickWidget的所有内容，然后上传到纹理，而提到的特殊小部件每个渲染到纹理，生成的纹理集由顶级小部件的backingstore组合在一起。

结构和main()

main()函数非常简单，顶级小部件的默认大小为720p(此大小以逻辑单位表示），实际像素大小可能不同，具体取决于比例因子。窗口可调整大小，QRhiWidget使实现正确处理由于窗口大小或布局变化而调整小部件大小的子类变得简单。

int main(int argc, char **argv)
{
QApplication app(argc, argv);

ExampleRhiWidget *rhiWidget = new ExampleRhiWidget;

QVBoxLayout *layout = new QVBoxLayout;
layout->addWidget(rhiWidget);

QWidget w;
w.setLayout(layout);
w.resize(1280, 720);
w.show();

return app.exec();
}

QRhiWidget子类重新实现了两个虚拟对象：initialize()和render()，initialize()在render()之前至少被调用一次，但是在一些重要的变化时也会被调用，比如当小部件的背景纹理由于小部件大小的变化而被重新创建时，当呈现目标参数发生变化时，或者当小部件由于移动到新的顶级窗口而被更改为新的QRhi时。

注意：与QOpenGLWidget遗留的initializeGL - resizeGL - paintGL模型不同，QRhiWidget中只有两个虚拟值。这是因为有更多的特殊事件可能需要照顾，而不仅仅是调整大小。例如，当重新父级到不同的顶层窗口时。(健壮的QOpenGLWidget实现必须通过执行额外的簿记来处理这个问题，例如通过跟踪相关的QOpenGLContext生命周期，这意味着三个虚拟对象实际上是不够的)一个更简单的initialize - render，在重要的更改时重新调用initialize更适合这个。

QRhi实例不属于小部件，它将在initialize()中从基类中查询，将其存储为成员允许在再次调用initialize()时识别更改。图形资源，比如顶点和统一缓冲区，或者图形管道，都在ExampleRhiWidget的控制之下。

#include <QRhiWidget>
#include <rhi/qrhi.h>

class ExampleRhiWidget : public QRhiWidget
{
public:
ExampleRhiWidget(QWidget *parent = nullptr) : QRhiWidget(parent) { }

void initialize(QRhiCommandBuffer *cb) override;
void render(QRhiCommandBuffer *cb) override;

private:
QRhi *m_rhi = nullptr;
std::unique_ptr<QRhiBuffer> m_vbuf;
std::unique_ptr<QRhiBuffer> m_ubuf;
std::unique_ptr<QRhiShaderResourceBindings> m_srb;
std::unique_ptr<QRhiGraphicsPipeline> m_pipeline;
QMatrix4x4 m_viewProjection;
float m_rotation = 0.0f;
};

要使#include <rhi/qrhi.h>语句起作用，应用程序必须链接到GuiPrivate(或使用qmake链接到gui-private)。

CMakeLists.txt

target_link_libraries(simplerhiwidget PRIVATE
Qt6::Core
Qt6::Gui
Qt6::GuiPrivate
Qt6::Widgets
)

未完待续，下期接着讲......

Qt Widget组件推荐

• QtitanRibbon - Ribbon UI组件：是一款遵循Microsoft Ribbon UI Paradigm for Qt技术的Ribbon UI组件，QtitanRibbon致力于为Windows、Linux和Mac OS X提供功能完整的Ribbon组件。
• QtitanChart - Qt类图表组件：是一个C ++库，代表一组控件，这些控件使您可以快速地为应用程序提供漂亮而丰富的图表。
• QtitanDataGrid - Qt网格组件：提供了一套完整的标准 QTableView 函数和传统组件无法实现的独特功能。使您能够将不同来源的各类数据加载到一个快速、灵活且功能强大的可编辑网格中，支持排序、分组、报告、创建带状列、拖放按钮和许多其他方便的功能。
• QtitanDocking：允许您像 Visual Studio 一样为您的伟大应用程序配备可停靠面板和可停靠工具栏。黑色、白色、蓝色调色板完全支持 Visual Studio 2019 主题！