1dd8b5ceec
qrhi.h, qshader.h, qshaderdescription.h (and qshaderbaker.h from shadertools; done separately) become "RHI APIs", following the concept of QPA APIs. Mirror completely what is done for QPA headers, but using the "rhi" prefix for the headers. This involves updating syncqt to handle the new category of headers. (a note on the regex: matching everything starting with "qrhi" is not acceptable due to incorrectly matching existing and future headers, hence specifying the four header names explicitly) There is going to be one difference to QPA: the documentation for everything RHI is going to be public and part of the regular docs, not hidden with \internal. In addition to the header renaming and adding the comments and documentation notes and warnings, there is one significant change here: there is no longer a need to do API-specific includes, such as qrhid3d11[_p].h, qrhivulkan[_p].h, etc. These are simply merged into a single header that is then included from qrhi.h. This means that users within Qt, and any future applications can just do #include <rhi/qrhi.h> (or rhi/qshader.h if the QRhi stuff is not relevant), no other headers are needed. There are no changes to functionality in this patch. Only the documentation is expanded, quite a lot, to eliminate all qdoc warnings and make the generated API docs complete. An example, with a quite extensive doc page is added as well. Task-number: QTBUG-113331 Change-Id: I91c749826348f14320cb335b1c83e9d1ea2b1d8b Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io> Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
52 lines
1.2 KiB
C++
52 lines
1.2 KiB
C++
// Copyright (C) 2020 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
|
|
|
|
#ifndef WINDOW_H
|
|
#define WINDOW_H
|
|
|
|
#include <QWindow>
|
|
#include <QOffscreenSurface>
|
|
#include <rhi/qrhi.h>
|
|
|
|
class Window : public QWindow
|
|
{
|
|
public:
|
|
Window(QRhi::Implementation graphicsApi);
|
|
|
|
void releaseSwapChain();
|
|
|
|
protected:
|
|
virtual void customInit();
|
|
virtual void customRender();
|
|
|
|
// destruction order matters to a certain degree: the fallbackSurface must
|
|
// outlive the rhi, the rhi must outlive all other resources. The resources
|
|
// need no special order when destroying.
|
|
#if QT_CONFIG(opengl)
|
|
std::unique_ptr<QOffscreenSurface> m_fallbackSurface;
|
|
#endif
|
|
std::unique_ptr<QRhi> m_rhi;
|
|
std::unique_ptr<QRhiSwapChain> m_sc;
|
|
std::unique_ptr<QRhiRenderBuffer> m_ds;
|
|
std::unique_ptr<QRhiRenderPassDescriptor> m_rp;
|
|
|
|
bool m_hasSwapChain = false;
|
|
QMatrix4x4 m_proj;
|
|
|
|
private:
|
|
void init();
|
|
void resizeSwapChain();
|
|
void render();
|
|
|
|
void exposeEvent(QExposeEvent *) override;
|
|
bool event(QEvent *) override;
|
|
|
|
QRhi::Implementation m_graphicsApi;
|
|
|
|
bool m_running = false;
|
|
bool m_notExposed = false;
|
|
bool m_newlyExposed = false;
|
|
};
|
|
|
|
#endif
|