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>
101 lines
3.4 KiB
C++
101 lines
3.4 KiB
C++
// Copyright (C) 2023 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
|
|
|
|
#include <QGuiApplication>
|
|
#include <QCommandLineParser>
|
|
#include "rhiwindow.h"
|
|
|
|
int main(int argc, char **argv)
|
|
{
|
|
QGuiApplication app(argc, argv);
|
|
|
|
QRhi::Implementation graphicsApi;
|
|
|
|
// Use platform-specific defaults when no command-line arguments given.
|
|
#if defined(Q_OS_WIN)
|
|
graphicsApi = QRhi::D3D11;
|
|
#elif defined(Q_OS_MACOS) || defined(Q_OS_IOS)
|
|
graphicsApi = QRhi::Metal;
|
|
#elif QT_CONFIG(vulkan)
|
|
graphicsApi = QRhi::Vulkan;
|
|
#else
|
|
graphicsApi = QRhi::OpenGLES2;
|
|
#endif
|
|
|
|
QCommandLineParser cmdLineParser;
|
|
cmdLineParser.addHelpOption();
|
|
QCommandLineOption nullOption({ "n", "null" }, QLatin1String("Null"));
|
|
cmdLineParser.addOption(nullOption);
|
|
QCommandLineOption glOption({ "g", "opengl" }, QLatin1String("OpenGL"));
|
|
cmdLineParser.addOption(glOption);
|
|
QCommandLineOption vkOption({ "v", "vulkan" }, QLatin1String("Vulkan"));
|
|
cmdLineParser.addOption(vkOption);
|
|
QCommandLineOption d3d11Option({ "d", "d3d11" }, QLatin1String("Direct3D 11"));
|
|
cmdLineParser.addOption(d3d11Option);
|
|
QCommandLineOption d3d12Option({ "D", "d3d12" }, QLatin1String("Direct3D 12"));
|
|
cmdLineParser.addOption(d3d12Option);
|
|
QCommandLineOption mtlOption({ "m", "metal" }, QLatin1String("Metal"));
|
|
cmdLineParser.addOption(mtlOption);
|
|
|
|
cmdLineParser.process(app);
|
|
if (cmdLineParser.isSet(nullOption))
|
|
graphicsApi = QRhi::Null;
|
|
if (cmdLineParser.isSet(glOption))
|
|
graphicsApi = QRhi::OpenGLES2;
|
|
if (cmdLineParser.isSet(vkOption))
|
|
graphicsApi = QRhi::Vulkan;
|
|
if (cmdLineParser.isSet(d3d11Option))
|
|
graphicsApi = QRhi::D3D11;
|
|
if (cmdLineParser.isSet(d3d12Option))
|
|
graphicsApi = QRhi::D3D12;
|
|
if (cmdLineParser.isSet(mtlOption))
|
|
graphicsApi = QRhi::Metal;
|
|
|
|
//! [api-setup]
|
|
// For OpenGL.
|
|
QSurfaceFormat fmt;
|
|
fmt.setDepthBufferSize(24);
|
|
fmt.setStencilBufferSize(8);
|
|
QSurfaceFormat::setDefaultFormat(fmt);
|
|
|
|
// For Vulkan.
|
|
#if QT_CONFIG(vulkan)
|
|
QVulkanInstance inst;
|
|
if (graphicsApi == QRhi::Vulkan) {
|
|
// Request validation, if available. This is completely optional
|
|
// and has a performance impact, and should be avoided in production use.
|
|
inst.setLayers({ "VK_LAYER_KHRONOS_validation" });
|
|
// Play nice with QRhi.
|
|
inst.setExtensions(QRhiVulkanInitParams::preferredInstanceExtensions());
|
|
if (!inst.create()) {
|
|
qWarning("Failed to create Vulkan instance, switching to OpenGL");
|
|
graphicsApi = QRhi::OpenGLES2;
|
|
}
|
|
}
|
|
#endif
|
|
//! [api-setup]
|
|
|
|
HelloWindow window(graphicsApi);
|
|
|
|
#if QT_CONFIG(vulkan)
|
|
if (graphicsApi == QRhi::Vulkan)
|
|
window.setVulkanInstance(&inst);
|
|
#endif
|
|
window.resize(1280, 720);
|
|
window.setTitle(QCoreApplication::applicationName() + QLatin1String(" - ") + window.graphicsApiName());
|
|
window.show();
|
|
|
|
int ret = app.exec();
|
|
|
|
// RhiWindow::event() will not get invoked when the
|
|
// PlatformSurfaceAboutToBeDestroyed event is sent during the QWindow
|
|
// destruction. That happens only when exiting via app::quit() instead of
|
|
// the more common QWindow::close(). Take care of it: if the QPlatformWindow
|
|
// is still around (there was no close() yet), get rid of the swapchain
|
|
// while it's not too late.
|
|
if (window.handle())
|
|
window.releaseSwapChain();
|
|
|
|
return ret;
|
|
}
|