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

Qt是目前最先进、最完整的跨平台C开发工具。它不仅完全实现了一次编写所有平台无差别运行更提供了几乎所有开发过程中需要用到的工具。如今Qt已被运用于超过70个行业、数千家企业支持数百万设备及应用。本文将为大家演示如何使用QRhi、Qt的3D API和着色语言抽象层渲染三角形。在很多方面这个示例都是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_ptrQRhiBuffer m_vbuf; std::unique_ptrQRhiBuffer m_ubuf; std::unique_ptrQRhiShaderResourceBindings m_srb; std::unique_ptrQRhiGraphicsPipeline m_pipeline; QMatrix4x4 m_viewProjection; float m_rotation 0.0f; };要使#include rhi/qrhi.h语句起作用应用程序必须链接到GuiPrivate(或使用qmake链接到gui-private)。CMakeLists.txttarget_link_libraries(simplerhiwidget PRIVATE Qt6::Core Qt6::Gui Qt6::GuiPrivate Qt6::Widgets )未完待续下期接着讲......