diff options
Diffstat (limited to 'src/quick/items/qquickwindow.h')
-rw-r--r-- | src/quick/items/qquickwindow.h | 161 |
1 files changed, 87 insertions, 74 deletions
diff --git a/src/quick/items/qquickwindow.h b/src/quick/items/qquickwindow.h index 53fe0a4c4b..17c4bb6fd4 100644 --- a/src/quick/items/qquickwindow.h +++ b/src/quick/items/qquickwindow.h @@ -1,53 +1,18 @@ -/**************************************************************************** -** -** Copyright (C) 2016 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the QtQuick module of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:LGPL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Lesser General Public License Usage -** Alternatively, this file may be used under the terms of the GNU Lesser -** General Public License version 3 as published by the Free Software -** Foundation and appearing in the file LICENSE.LGPL3 included in the -** packaging of this file. Please review the following information to -** ensure the GNU Lesser General Public License version 3 requirements -** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. -** -** GNU General Public License Usage -** Alternatively, this file may be used under the terms of the GNU -** General Public License version 2.0 or (at your option) the GNU General -** Public license version 3 or any later version approved by the KDE Free -** Qt Foundation. The licenses are as published by the Free Software -** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 -** included in the packaging of this file. Please review the following -** information to ensure the GNU General Public License requirements will -** be met: https://www.gnu.org/licenses/gpl-2.0.html and -** https://www.gnu.org/licenses/gpl-3.0.html. -** -** $QT_END_LICENSE$ -** -****************************************************************************/ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only #ifndef QQUICKWINDOW_H #define QQUICKWINDOW_H #include <QtQuick/qtquickglobal.h> #include <QtQuick/qsgrendererinterface.h> + #include <QtCore/qmetatype.h> -#include <QtGui/qopengl.h> #include <QtGui/qwindow.h> #include <QtGui/qevent.h> #include <QtQml/qqml.h> #include <QtQml/qqmldebug.h> +#include <QtQml/qqmlinfo.h> QT_BEGIN_NAMESPACE @@ -57,8 +22,6 @@ class QSGTexture; class QInputMethodEvent; class QQuickWindowPrivate; class QQuickWindowAttached; -class QOpenGLContext; -class QOpenGLFramebufferObject; class QQmlIncubationController; class QInputMethodEvent; class QQuickCloseEvent; @@ -66,6 +29,14 @@ class QQuickRenderControl; class QSGRectangleNode; class QSGImageNode; class QSGNinePatchNode; +class QQuickPalette; +class QQuickRenderTarget; +class QQuickGraphicsDevice; +class QQuickGraphicsConfiguration; +class QRhi; +class QRhiSwapChain; +class QRhiTexture; +class QSGTextNode; class Q_QUICK_EXPORT QQuickWindow : public QWindow { @@ -73,9 +44,16 @@ class Q_QUICK_EXPORT QQuickWindow : public QWindow Q_PRIVATE_PROPERTY(QQuickWindow::d_func(), QQmlListProperty<QObject> data READ data DESIGNABLE false) Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged) Q_PROPERTY(QQuickItem* contentItem READ contentItem CONSTANT) - Q_PROPERTY(QQuickItem* activeFocusItem READ activeFocusItem NOTIFY activeFocusItemChanged REVISION 1) + Q_PROPERTY(QQuickItem* activeFocusItem READ activeFocusItem NOTIFY activeFocusItemChanged REVISION(2, 1)) + Q_PRIVATE_PROPERTY(QQuickWindow::d_func(), QQuickPalette *palette READ palette WRITE setPalette + RESET resetPalette NOTIFY paletteChanged REVISION(6, 2)) + QDOC_PROPERTY(QWindow* transientParent READ transientParent WRITE setTransientParent NOTIFY transientParentChanged) Q_CLASSINFO("DefaultProperty", "data") Q_DECLARE_PRIVATE(QQuickWindow) + + QML_NAMED_ELEMENT(Window) + QML_ADDED_IN_VERSION(2, 0) + QML_REMOVED_IN_VERSION(2, 1) public: enum CreateTextureOption { TextureHasAlphaChannel = 0x0001, @@ -104,7 +82,8 @@ public: enum TextRenderType { QtTextRendering, - NativeTextRendering + NativeTextRendering, + CurveTextRendering }; Q_ENUM(TextRenderType) @@ -120,21 +99,18 @@ public: QQuickItem *mouseGrabberItem() const; -#if QT_DEPRECATED_SINCE(5, 8) - QT_DEPRECATED bool sendEvent(QQuickItem *, QEvent *); -#endif - QImage grabWindow(); -#if QT_CONFIG(opengl) - void setRenderTarget(QOpenGLFramebufferObject *fbo); - QOpenGLFramebufferObject *renderTarget() const; -#endif - void setRenderTarget(uint fboId, const QSize &size); - uint renderTargetId() const; - QSize renderTargetSize() const; -#if QT_CONFIG(opengl) - void resetOpenGLState(); -#endif + + void setRenderTarget(const QQuickRenderTarget &target); + QQuickRenderTarget renderTarget() const; + + struct GraphicsStateInfo { + int currentFrameSlot; + int framesInFlight; + }; + const GraphicsStateInfo &graphicsStateInfo(); + void beginExternalCommands(); + void endExternalCommands(); QQmlIncubationController *incubationController() const; #if QT_CONFIG(accessibility) @@ -144,10 +120,7 @@ public: // Scene graph specific functions QSGTexture *createTextureFromImage(const QImage &image) const; QSGTexture *createTextureFromImage(const QImage &image, CreateTextureOptions options) const; - QSGTexture *createTextureFromId(uint id, const QSize &size, CreateTextureOptions options = CreateTextureOption()) const; - - void setClearBeforeRendering(bool enabled); - bool clearBeforeRendering() const; + QSGTexture *createTextureFromRhiTexture(QRhiTexture *texture, CreateTextureOptions options = {}) const; void setColor(const QColor &color); QColor color() const; @@ -155,13 +128,12 @@ public: static bool hasDefaultAlphaBuffer(); static void setDefaultAlphaBuffer(bool useAlpha); - void setPersistentOpenGLContext(bool persistent); - bool isPersistentOpenGLContext() const; + void setPersistentGraphics(bool persistent); + bool isPersistentGraphics() const; void setPersistentSceneGraph(bool persistent); bool isPersistentSceneGraph() const; - QOpenGLContext *openglContext() const; bool isSceneGraphInitialized() const; void scheduleRenderJob(QRunnable *job, RenderStage schedule); @@ -170,34 +142,53 @@ public: QSGRendererInterface *rendererInterface() const; - static void setSceneGraphBackend(QSGRendererInterface::GraphicsApi api); + static void setGraphicsApi(QSGRendererInterface::GraphicsApi api); + static QSGRendererInterface::GraphicsApi graphicsApi(); + static void setSceneGraphBackend(const QString &backend); static QString sceneGraphBackend(); + void setGraphicsDevice(const QQuickGraphicsDevice &device); + QQuickGraphicsDevice graphicsDevice() const; + + void setGraphicsConfiguration(const QQuickGraphicsConfiguration &config); + QQuickGraphicsConfiguration graphicsConfiguration() const; + QSGRectangleNode *createRectangleNode() const; QSGImageNode *createImageNode() const; QSGNinePatchNode *createNinePatchNode() const; + QSGTextNode *createTextNode() const; static TextRenderType textRenderType(); static void setTextRenderType(TextRenderType renderType); + QRhi *rhi() const; + QRhiSwapChain *swapChain() const; + Q_SIGNALS: void frameSwapped(); - Q_REVISION(2) void openglContextCreated(QOpenGLContext *context); void sceneGraphInitialized(); void sceneGraphInvalidated(); void beforeSynchronizing(); - Q_REVISION(2) void afterSynchronizing(); + Q_REVISION(2, 2) void afterSynchronizing(); void beforeRendering(); void afterRendering(); - Q_REVISION(2) void afterAnimating(); - Q_REVISION(2) void sceneGraphAboutToStop(); + Q_REVISION(2, 2) void afterAnimating(); + Q_REVISION(2, 2) void sceneGraphAboutToStop(); - Q_REVISION(1) void closing(QQuickCloseEvent *close); + Q_REVISION(2, 1) void closing(QQuickCloseEvent *close); void colorChanged(const QColor &); - Q_REVISION(1) void activeFocusItemChanged(); - Q_REVISION(2) void sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message); + Q_REVISION(2, 1) void activeFocusItemChanged(); + Q_REVISION(2, 2) void sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message); + + Q_REVISION(2, 14) void beforeRenderPassRecording(); + Q_REVISION(2, 14) void afterRenderPassRecording(); + Q_REVISION(6, 0) void paletteChanged(); + Q_REVISION(6, 0) void paletteCreated(); + + Q_REVISION(6, 0) void beforeFrameBegin(); + Q_REVISION(6, 0) void afterFrameEnd(); public Q_SLOTS: void update(); @@ -212,12 +203,15 @@ protected: void showEvent(QShowEvent *) override; void hideEvent(QHideEvent *) override; - // TODO Qt 6: reimplement QWindow::closeEvent to emit closing + void closeEvent(QCloseEvent *) override; void focusInEvent(QFocusEvent *) override; void focusOutEvent(QFocusEvent *) override; bool event(QEvent *) override; + + // These overrides are no longer normal entry points for + // input events, but kept in case legacy code calls them. void keyPressEvent(QKeyEvent *) override; void keyReleaseEvent(QKeyEvent *) override; void mousePressEvent(QMouseEvent *) override; @@ -227,26 +221,45 @@ protected: #if QT_CONFIG(wheelevent) void wheelEvent(QWheelEvent *) override; #endif +#if QT_CONFIG(tabletevent) + void tabletEvent(QTabletEvent *) override; +#endif private Q_SLOTS: void maybeUpdate(); void cleanupSceneGraph(); void physicalDpiChanged(); void handleScreenChanged(QScreen *screen); - void setTransientParent_helper(QQuickWindow *window); void runJobsAfterSwap(); void handleApplicationStateChanged(Qt::ApplicationState state); + void handleFontDatabaseChanged(); private: +#ifndef QT_NO_DEBUG_STREAM + inline friend QQmlInfo operator<<(QQmlInfo info, const QQuickWindow *window) + { + info.QDebug::operator<<(window); + return info; + } +#endif + friend class QQuickItem; + friend class QQuickItemPrivate; friend class QQuickWidget; friend class QQuickRenderControl; friend class QQuickAnimatorController; friend class QQuickWidgetPrivate; + friend class QQuickDeliveryAgentPrivate; Q_DISABLE_COPY(QQuickWindow) }; #ifndef QT_NO_DEBUG_STREAM QDebug Q_QUICK_EXPORT operator<<(QDebug debug, const QQuickWindow *item); + +inline QQmlInfo operator<<(QQmlInfo info, const QWindow *window) +{ + info.QDebug::operator<<(window); + return info; +} #endif QT_END_NAMESPACE |