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>
88 lines
2.2 KiB
C++
88 lines
2.2 KiB
C++
// Copyright (C) 2018 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
|
|
|
|
#include "window.h"
|
|
#include <QPlatformSurfaceEvent>
|
|
|
|
#if QT_CONFIG(vulkan)
|
|
extern QVulkanInstance *instance;
|
|
#endif
|
|
|
|
Window::Window(const QString &title, GraphicsApi api)
|
|
{
|
|
switch (api) {
|
|
case OpenGL:
|
|
setSurfaceType(OpenGLSurface);
|
|
break;
|
|
case Vulkan:
|
|
setSurfaceType(VulkanSurface);
|
|
#if QT_CONFIG(vulkan)
|
|
setVulkanInstance(instance);
|
|
#endif
|
|
break;
|
|
case D3D11:
|
|
case D3D12:
|
|
setSurfaceType(Direct3DSurface);
|
|
break;
|
|
case Metal:
|
|
setSurfaceType(MetalSurface);
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
resize(800, 600);
|
|
setTitle(title);
|
|
}
|
|
|
|
Window::~Window()
|
|
{
|
|
}
|
|
|
|
void Window::exposeEvent(QExposeEvent *)
|
|
{
|
|
if (isExposed()) {
|
|
if (!m_running) {
|
|
// initialize and start rendering when the window becomes usable for graphics purposes
|
|
m_running = true;
|
|
m_notExposed = false;
|
|
emit initRequested();
|
|
emit renderRequested(true);
|
|
} else {
|
|
// continue when exposed again
|
|
if (m_notExposed) {
|
|
m_notExposed = false;
|
|
emit renderRequested(true);
|
|
} else {
|
|
// resize generates exposes - this is very important here (unlike in a single-threaded renderer)
|
|
emit syncSurfaceSizeRequested();
|
|
}
|
|
}
|
|
} else {
|
|
// stop pushing frames when not exposed (on some platforms this is essential, optional on others)
|
|
if (m_running)
|
|
m_notExposed = true;
|
|
}
|
|
}
|
|
|
|
bool Window::event(QEvent *e)
|
|
{
|
|
switch (e->type()) {
|
|
case QEvent::UpdateRequest:
|
|
if (!m_notExposed)
|
|
emit renderRequested(false);
|
|
break;
|
|
|
|
case QEvent::PlatformSurface:
|
|
// this is the proper time to tear down the swapchain (while the native window and surface are still around)
|
|
if (static_cast<QPlatformSurfaceEvent *>(e)->surfaceEventType() == QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed)
|
|
emit surfaceGoingAway();
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return QWindow::event(e);
|
|
}
|