diff options
author | Alan Alpert <alan.alpert@nokia.com> | 2012-07-11 17:32:16 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-07-17 07:26:15 +0200 |
commit | feb996e3ab44e68082c97102556ea396f5df3f44 (patch) | |
tree | 7613a8a4eaf5a8e0fb2801e9d0d9d1869524c348 /src/quick/items/qquickwindow.h | |
parent | 68bbdacd2d5a6fa02f085a996411fb2b71875174 (diff) |
QQuickCanvas renames
QQuickCanvas is now called QQuickWindow
QQuickCanvas::rootItem is now QQuickWindow::contentItem
QQuickItem::canvas is now QQuickItem::window
QQuickItem::ItemChangeData::canvas is also renamed window
QQuickCanvas::grabFrameBuffer is now QQuickWindow::grabWindow
The functions related to the color property have dropped the clear from
their names.
The first three changes have interim compatibility measures in place to
ease the transition.
Change-Id: Id34e29546a22a74a7ae2ad90ee3a8def6fc541d2
Reviewed-by: Martin Jones <martin.jones@nokia.com>
Diffstat (limited to 'src/quick/items/qquickwindow.h')
-rw-r--r-- | src/quick/items/qquickwindow.h | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/src/quick/items/qquickwindow.h b/src/quick/items/qquickwindow.h new file mode 100644 index 0000000000..9e351ed412 --- /dev/null +++ b/src/quick/items/qquickwindow.h @@ -0,0 +1,181 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the QtQml module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** GNU Lesser General Public License Usage +** This file may be used under the terms of the GNU Lesser General Public +** License version 2.1 as published by the Free Software Foundation and +** appearing in the file LICENSE.LGPL included in the packaging of this +** file. Please review the following information to ensure the GNU Lesser +** General Public License version 2.1 requirements will be met: +** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain additional +** rights. These rights are described in the Nokia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU General +** Public License version 3.0 as published by the Free Software Foundation +** and appearing in the file LICENSE.GPL included in the packaging of this +** file. Please review the following information to ensure the GNU General +** Public License version 3.0 requirements will be met: +** http://www.gnu.org/copyleft/gpl.html. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms and +** conditions contained in a signed written agreement between you and Nokia. +** +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#ifndef QQUICKWINDOW_H +#define QQUICKWINDOW_H + +#include <QtQuick/qtquickglobal.h> +#include <QtCore/qmetatype.h> +#include <QtGui/qopengl.h> +#include <QtGui/qwindow.h> +#include <QtGui/qevent.h> + +QT_BEGIN_HEADER + +QT_BEGIN_NAMESPACE + +class QQuickItem; +class QSGTexture; +class QInputMethodEvent; +class QQuickWindowPrivate; +class QOpenGLFramebufferObject; +class QQmlIncubationController; +class QInputMethodEvent; + +class Q_QUICK_EXPORT QQuickWindow : public QWindow +{ + Q_OBJECT + 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 FINAL) + Q_CLASSINFO("DefaultProperty", "data") + Q_DECLARE_PRIVATE(QQuickWindow) +public: + enum CreateTextureOption { + TextureHasAlphaChannel = 0x0001, + TextureHasMipmaps = 0x0002, + TextureOwnsGLTexture = 0x0004 + }; + + Q_DECLARE_FLAGS(CreateTextureOptions, CreateTextureOption) + + QQuickWindow(QWindow *parent = 0); + + virtual ~QQuickWindow(); + + QQuickItem *contentItem() const; + //XXX rootItem renamed contentItem - this function must be removed before 5.0 + QQuickItem *rootItem() const { return contentItem(); } + + QQuickItem *activeFocusItem() const; + QObject *focusObject() const; + + QQuickItem *mouseGrabberItem() const; + + bool sendEvent(QQuickItem *, QEvent *); + + QImage grabWindow(); + + void setRenderTarget(QOpenGLFramebufferObject *fbo); + QOpenGLFramebufferObject *renderTarget() const; + + void setRenderTarget(uint fboId, const QSize &size); + uint renderTargetId() const; + QSize renderTargetSize() const; + + QQmlIncubationController *incubationController() const; + +#ifndef QT_NO_ACCESSIBILITY + virtual QAccessibleInterface *accessibleRoot() const; +#endif + + // Scene graph specific functions + QSGTexture *createTextureFromImage(const QImage &image) const; + QSGTexture *createTextureFromId(uint id, const QSize &size, CreateTextureOptions options = CreateTextureOption(0)) const; + + void setClearBeforeRendering(bool enabled); + bool clearBeforeRendering() const; + + void setColor(const QColor &color); + QColor color() const; + + void setPersistentOpenGLContext(bool persistent); + bool isPersistentOpenGLContext() const; + + void setPersistentSceneGraph(bool persistent); + bool isPersistentSceneGraph() const; + + QOpenGLContext *openglContext() const; + +Q_SIGNALS: + void frameSwapped(); + void sceneGraphInitialized(); + void sceneGraphInvalidated(); + void beforeSynchronizing(); + void beforeRendering(); + void afterRendering(); + void colorChanged(const QColor &); + +public Q_SLOTS: + void update(); + void releaseResources(); + +protected: + QQuickWindow(QQuickWindowPrivate &dd, QWindow *parent = 0); + + virtual void exposeEvent(QExposeEvent *); + virtual void resizeEvent(QResizeEvent *); + + virtual void showEvent(QShowEvent *); + virtual void hideEvent(QHideEvent *); + + virtual void focusInEvent(QFocusEvent *); + virtual void focusOutEvent(QFocusEvent *); + + virtual bool event(QEvent *); + virtual void keyPressEvent(QKeyEvent *); + virtual void keyReleaseEvent(QKeyEvent *); + virtual void mousePressEvent(QMouseEvent *); + virtual void mouseReleaseEvent(QMouseEvent *); + virtual void mouseDoubleClickEvent(QMouseEvent *); + virtual void mouseMoveEvent(QMouseEvent *); +#ifndef QT_NO_WHEELEVENT + virtual void wheelEvent(QWheelEvent *); +#endif + +private Q_SLOTS: + void maybeUpdate(); + void cleanupSceneGraph(); + +private: + friend class QQuickItem; + friend class QQuickWindowRenderLoop; + Q_DISABLE_COPY(QQuickWindow) +}; + +QT_END_NAMESPACE + +Q_DECLARE_METATYPE(QQuickWindow *) + +QT_END_HEADER + +#endif // QQUICKWINDOW_H + |