// Copyright (C) 2018 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause // Adapted from hellominimalcrossgfxtriangle with the frame rendering stripped out. // Include this file and implement Window::customInit, release and render. // Debug/validation layer is enabled for D3D and Vulkan. #include #include #include #include #include #include #include #include #include #include #include #ifndef QT_NO_OPENGL #include #include #endif #if QT_CONFIG(vulkan) #include #endif #ifdef Q_OS_WIN #include #endif #if defined(Q_OS_MACOS) || defined(Q_OS_IOS) #include #endif QShader getShader(const QString &name) { QFile f(name); if (f.open(QIODevice::ReadOnly)) return QShader::fromSerialized(f.readAll()); return QShader(); } enum GraphicsApi { Null, OpenGL, Vulkan, D3D11, Metal }; GraphicsApi graphicsApi; QString graphicsApiName() { switch (graphicsApi) { case Null: return QLatin1String("Null (no output)"); case OpenGL: return QLatin1String("OpenGL"); case Vulkan: return QLatin1String("Vulkan"); case D3D11: return QLatin1String("Direct3D 11"); case Metal: return QLatin1String("Metal"); default: break; } return QString(); } QRhi::Flags rhiFlags = QRhi::EnableDebugMarkers; int sampleCount = 1; QRhiSwapChain::Flags scFlags; QRhi::BeginFrameFlags beginFrameFlags; QRhi::EndFrameFlags endFrameFlags; int framesUntilTdr = -1; bool transparentBackground = false; bool debugLayer = true; class Window : public QWindow { public: Window(); ~Window(); protected: void init(); void releaseResources(); void resizeSwapChain(); void releaseSwapChain(); void render(); void customInit(); void customRelease(); void customRender(); void exposeEvent(QExposeEvent *) override; bool event(QEvent *) override; #ifdef EXAMPLEFW_KEYPRESS_EVENTS void keyPressEvent(QKeyEvent *e) override; #endif bool m_running = false; bool m_notExposed = false; bool m_newlyExposed = false; QRhi *m_r = nullptr; bool m_hasSwapChain = false; QRhiSwapChain *m_sc = nullptr; QRhiRenderBuffer *m_ds = nullptr; QRhiRenderPassDescriptor *m_rp = nullptr; QMatrix4x4 m_proj; QElapsedTimer m_timer; int m_frameCount; #ifndef QT_NO_OPENGL QOffscreenSurface *m_fallbackSurface = nullptr; #endif QColor m_clearColor; friend int main(int, char**); }; Window::Window() { // Tell the platform plugin what we want. switch (graphicsApi) { case OpenGL: setSurfaceType(OpenGLSurface); break; case Vulkan: setSurfaceType(VulkanSurface); break; case D3D11: setSurfaceType(Direct3DSurface); break; case Metal: setSurfaceType(MetalSurface); break; default: break; } m_clearColor = transparentBackground ? Qt::transparent : QColor::fromRgbF(0.4f, 0.7f, 0.0f, 1.0f); } Window::~Window() { releaseResources(); } void Window::exposeEvent(QExposeEvent *) { // initialize and start rendering when the window becomes usable for graphics purposes if (isExposed() && !m_running) { m_running = true; init(); resizeSwapChain(); } const QSize surfaceSize = m_hasSwapChain ? m_sc->surfacePixelSize() : QSize(); // stop pushing frames when not exposed (or size is 0) if ((!isExposed() || (m_hasSwapChain && surfaceSize.isEmpty())) && m_running) m_notExposed = true; // continue when exposed again and the surface has a valid size. // note that the surface size can be (0, 0) even though size() reports a valid one... if (isExposed() && m_running && m_notExposed && !surfaceSize.isEmpty()) { m_notExposed = false; m_newlyExposed = true; } // always render a frame on exposeEvent() (when exposed) in order to update // immediately on window resize. if (isExposed() && !surfaceSize.isEmpty()) render(); } bool Window::event(QEvent *e) { switch (e->type()) { case QEvent::UpdateRequest: render(); 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(e)->surfaceEventType() == QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed) releaseSwapChain(); break; default: break; } return QWindow::event(e); } void Window::init() { if (graphicsApi == Null) { QRhiNullInitParams params; m_r = QRhi::create(QRhi::Null, ¶ms, rhiFlags); } #ifndef QT_NO_OPENGL if (graphicsApi == OpenGL) { m_fallbackSurface = QRhiGles2InitParams::newFallbackSurface(); QRhiGles2InitParams params; params.fallbackSurface = m_fallbackSurface; params.window = this; m_r = QRhi::create(QRhi::OpenGLES2, ¶ms, rhiFlags); } #endif #if QT_CONFIG(vulkan) if (graphicsApi == Vulkan) { QRhiVulkanInitParams params; params.inst = vulkanInstance(); params.window = this; m_r = QRhi::create(QRhi::Vulkan, ¶ms, rhiFlags); } #endif #ifdef Q_OS_WIN if (graphicsApi == D3D11) { QRhiD3D11InitParams params; if (debugLayer) qDebug("Enabling D3D11 debug layer"); params.enableDebugLayer = debugLayer; if (framesUntilTdr > 0) { params.framesUntilKillingDeviceViaTdr = framesUntilTdr; params.repeatDeviceKill = true; } m_r = QRhi::create(QRhi::D3D11, ¶ms, rhiFlags); } #endif #if defined(Q_OS_MACOS) || defined(Q_OS_IOS) if (graphicsApi == Metal) { QRhiMetalInitParams params; m_r = QRhi::create(QRhi::Metal, ¶ms, rhiFlags); } #endif if (!m_r) qFatal("Failed to create RHI backend"); // now onto the backend-independent init m_sc = m_r->newSwapChain(); m_ds = m_r->newRenderBuffer(QRhiRenderBuffer::DepthStencil, QSize(), // no need to set the size here, due to UsedWithSwapChainOnly sampleCount, QRhiRenderBuffer::UsedWithSwapChainOnly); m_sc->setWindow(this); m_sc->setDepthStencil(m_ds); m_sc->setSampleCount(sampleCount); m_sc->setFlags(scFlags); m_rp = m_sc->newCompatibleRenderPassDescriptor(); m_sc->setRenderPassDescriptor(m_rp); customInit(); } void Window::releaseResources() { customRelease(); delete m_rp; m_rp = nullptr; delete m_ds; m_ds = nullptr; delete m_sc; m_sc = nullptr; delete m_r; m_r = nullptr; #ifndef QT_NO_OPENGL delete m_fallbackSurface; m_fallbackSurface = nullptr; #endif } void Window::resizeSwapChain() { m_hasSwapChain = m_sc->createOrResize(); // also handles m_ds m_frameCount = 0; m_timer.restart(); const QSize outputSize = m_sc->currentPixelSize(); m_proj = m_r->clipSpaceCorrMatrix(); m_proj.perspective(45.0f, outputSize.width() / (float) outputSize.height(), 0.01f, 1000.0f); m_proj.translate(0, 0, -4); } void Window::releaseSwapChain() { if (m_hasSwapChain) { m_hasSwapChain = false; m_sc->destroy(); } } void Window::render() { if (!m_hasSwapChain || m_notExposed) return; // If the window got resized or got newly exposed, resize the swapchain. // (the newly-exposed case is not actually required by some // platforms/backends, but f.ex. Vulkan on Windows seems to need it) if (m_sc->currentPixelSize() != m_sc->surfacePixelSize() || m_newlyExposed) { resizeSwapChain(); if (!m_hasSwapChain) return; m_newlyExposed = false; } // Start a new frame. This is where we block when too far ahead of // GPU/present, and that's what throttles the thread to the refresh rate. // (except for OpenGL where it happens either in endFrame or somewhere else // depending on the GL implementation) QRhi::FrameOpResult r = m_r->beginFrame(m_sc, beginFrameFlags); if (r == QRhi::FrameOpSwapChainOutOfDate) { resizeSwapChain(); if (!m_hasSwapChain) return; r = m_r->beginFrame(m_sc); } if (r != QRhi::FrameOpSuccess) { requestUpdate(); return; } m_frameCount += 1; if (m_timer.elapsed() > 1000) { qDebug("ca. %d fps", m_frameCount); m_timer.restart(); m_frameCount = 0; } customRender(); m_r->endFrame(m_sc, endFrameFlags); if (!scFlags.testFlag(QRhiSwapChain::NoVSync)) requestUpdate(); else // try prevent all delays when NoVSync QCoreApplication::postEvent(this, new QEvent(QEvent::UpdateRequest)); } int main(int argc, char **argv) { QGuiApplication app(argc, argv); QLoggingCategory::setFilterRules(QLatin1String("qt.rhi.*=true")); // Defaults. #if defined(Q_OS_WIN) graphicsApi = D3D11; #elif defined(Q_OS_MACOS) || defined(Q_OS_IOS) graphicsApi = Metal; #elif QT_CONFIG(vulkan) graphicsApi = Vulkan; #else graphicsApi = OpenGL; #endif // Allow overriding via the command line. 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 d3dOption({ "d", "d3d11" }, QLatin1String("Direct3D 11")); cmdLineParser.addOption(d3dOption); QCommandLineOption mtlOption({ "m", "metal" }, QLatin1String("Metal")); cmdLineParser.addOption(mtlOption); // Testing cleanup both with QWindow::close() (hitting X or Alt-F4) and // QCoreApplication::quit() (e.g. what a menu widget would do) is important. // Use this parameter for the latter. QCommandLineOption sdOption({ "s", "self-destruct" }, QLatin1String("Self-destruct after 5 seconds.")); cmdLineParser.addOption(sdOption); QCommandLineOption coreProfOption({ "c", "core" }, QLatin1String("Request a core profile context for OpenGL")); cmdLineParser.addOption(coreProfOption); // Attempt testing device lost situations on D3D at least. QCommandLineOption tdrOption(QLatin1String("curse"), QLatin1String("Curse the graphics device. " "(generate a device reset every frames when on D3D11)"), QLatin1String("count")); cmdLineParser.addOption(tdrOption); // Allow testing preferring the software adapter (D3D). QCommandLineOption swOption(QLatin1String("software"), QLatin1String("Prefer a software renderer when choosing the adapter. " "Only applicable with some APIs and platforms.")); cmdLineParser.addOption(swOption); // Allow testing having a semi-transparent window. QCommandLineOption transparentOption(QLatin1String("transparent"), QLatin1String("Make background transparent")); cmdLineParser.addOption(transparentOption); cmdLineParser.process(app); if (cmdLineParser.isSet(nullOption)) graphicsApi = Null; if (cmdLineParser.isSet(glOption)) graphicsApi = OpenGL; if (cmdLineParser.isSet(vkOption)) graphicsApi = Vulkan; if (cmdLineParser.isSet(d3dOption)) graphicsApi = D3D11; if (cmdLineParser.isSet(mtlOption)) graphicsApi = Metal; qDebug("Selected graphics API is %s", qPrintable(graphicsApiName())); qDebug("This is a multi-api example, use command line arguments to override:\n%s", qPrintable(cmdLineParser.helpText())); if (cmdLineParser.isSet(transparentOption)) { transparentBackground = true; scFlags |= QRhiSwapChain::SurfaceHasPreMulAlpha; } #ifdef EXAMPLEFW_PREINIT void preInit(); preInit(); #endif // OpenGL specifics. QSurfaceFormat fmt; fmt.setDepthBufferSize(24); fmt.setStencilBufferSize(8); if (cmdLineParser.isSet(coreProfOption)) { #ifdef Q_OS_DARWIN fmt.setVersion(4, 1); #else fmt.setVersion(4, 3); #endif fmt.setProfile(QSurfaceFormat::CoreProfile); } if (sampleCount > 1) fmt.setSamples(sampleCount); if (scFlags.testFlag(QRhiSwapChain::NoVSync)) fmt.setSwapInterval(0); if (scFlags.testFlag(QRhiSwapChain::sRGB)) fmt.setColorSpace(QColorSpace::SRgb); // Exception: The alpha size is not necessarily OpenGL specific. if (transparentBackground) fmt.setAlphaBufferSize(8); QSurfaceFormat::setDefaultFormat(fmt); // Vulkan setup. #if QT_CONFIG(vulkan) QVulkanInstance inst; if (graphicsApi == Vulkan) { if (debugLayer) { qDebug("Enabling Vulkan validation layer (if available)"); inst.setLayers({ "VK_LAYER_KHRONOS_validation" }); } const QVersionNumber supportedVersion = inst.supportedApiVersion(); qDebug() << "Supported Vulkan API version:" << supportedVersion; if (supportedVersion >= QVersionNumber(1, 1)) { qDebug("Requesting Vulkan API 1.1 on the VkInstance"); inst.setApiVersion(QVersionNumber(1, 1)); } inst.setExtensions(QRhiVulkanInitParams::preferredInstanceExtensions()); if (!inst.create()) { qWarning("Failed to create Vulkan instance, switching to OpenGL"); graphicsApi = OpenGL; } } #endif if (cmdLineParser.isSet(tdrOption)) framesUntilTdr = cmdLineParser.value(tdrOption).toInt(); if (cmdLineParser.isSet(swOption)) rhiFlags |= QRhi::PreferSoftwareRenderer; // Create and show the window. Window w; #if QT_CONFIG(vulkan) if (graphicsApi == Vulkan) w.setVulkanInstance(&inst); #endif w.resize(1280, 720); w.setTitle(QCoreApplication::applicationName() + QLatin1String(" - ") + graphicsApiName()); w.show(); if (cmdLineParser.isSet(sdOption)) QTimer::singleShot(5000, qGuiApp, SLOT(quit())); int ret = app.exec(); // Window::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 (w.handle()) w.releaseSwapChain(); return ret; }