/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtGui 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$ ** ****************************************************************************/ #include "qplatformscreen_qpa.h" #include #include #include #include #include #include QT_BEGIN_NAMESPACE QPlatformScreen::QPlatformScreen() : d_ptr(new QPlatformScreenPrivate) { Q_D(QPlatformScreen); d->screen = 0; } QPlatformScreen::~QPlatformScreen() { Q_D(QPlatformScreen); QGuiApplicationPrivate::screen_list.removeOne(d->screen); delete d->screen; } /*! \fn QPixmap QPlatformScreen::grabWindow(WId window, int x, int y, int width, int height) const This function is called when Qt needs to be able to grab the content of a window. Returnes the content of the window specified with the WId handle within the boundaries of QRect(x,y,width,height). */ QPixmap QPlatformScreen::grabWindow(WId window, int x, int y, int width, int height) const { Q_UNUSED(window); Q_UNUSED(x); Q_UNUSED(y); Q_UNUSED(width); Q_UNUSED(height); return QPixmap(); } /*! Return the given top level window for a given position. Default implementation retrieves a list of all top level windows and finds the first window which contains point \a pos */ QWindow *QPlatformScreen::topLevelAt(const QPoint & pos) const { QWindowList list = QGuiApplication::topLevelWindows(); for (int i = list.size()-1; i >= 0; --i) { QWindow *w = list[i]; if (w->isVisible() && w->geometry().contains(pos)) return w; } return 0; } /*! Returns a list of all the platform screens that are part of the same virtual desktop. Screens part of the same virtual desktop share a common coordinate system, and windows can be freely moved between them. */ QList QPlatformScreen::virtualSiblings() const { QList list; list << const_cast(this); return list; } QScreen *QPlatformScreen::screen() const { Q_D(const QPlatformScreen); return d->screen; } /*! Reimplement this function in subclass to return the physical size of the screen. The physical size represents the actual physical dimensions of the display. The default implementation takes the pixel size of the screen, considers a resolution of 100 dots per inch, and returns the calculated physical size. A device with a screen that has different resolutions will need to be supported by a suitable reimplementation of this function. \sa logcalDpi */ QSizeF QPlatformScreen::physicalSize() const { static const int dpi = 100; return QSizeF(geometry().size()) / dpi * qreal(25.4); } /*! Reimplement this function in subclass to return the logical horizontal and vertical dots per inch metrics of the screen. The logical dots per inch metrics are used by QFont to convert point sizes to pixel sizes. The default implementation uses the screen pixel size and physical size to compute the metrics. \sa physicalSize */ QDpi QPlatformScreen::logicalDpi() const { QSizeF ps = physicalSize(); QSize s = geometry().size(); return QDpi(25.4 * s.width() / ps.width(), 25.4 * s.height() / ps.height()); } /*! Reimplement this function in subclass to return the current orientation of the screen, for example based on accelerometer data to determine the device orientation. The default implementation returns Qt::PrimaryOrientation. */ Qt::ScreenOrientation QPlatformScreen::orientation() const { return Qt::PrimaryOrientation; } QPlatformScreen * QPlatformScreen::platformScreenForWindow(const QWindow *window) { return window->screen()->handle(); } /*! \class QPlatformScreen \since 4.8 \internal \preliminary \ingroup qpa \brief The QPlatformScreen class provides an abstraction for visual displays. Many window systems has support for retrieving information on the attached displays. To be able to query the display QPA uses QPlatformScreen. Qt its self is most dependent on the physicalSize() function, since this is the function it uses to calculate the dpi to use when converting point sizes to pixels sizes. However, this is unfortunate on some systems, as the native system fakes its dpi size. QPlatformScreen is also used by the public api QDesktopWidget for information about the desktop. */ /*! \fn QRect QPlatformScreen::geometry() const = 0 Reimplement in subclass to return the pixel geometry of the screen */ /*! \fn QRect QPlatformScreen::availableGeometry() const Reimplement in subclass to return the pixel geometry of the available space This normally is the desktop screen minus the task manager, global menubar etc. */ /*! \fn int QPlatformScreen::depth() const = 0 Reimplement in subclass to return current depth of the screen */ /*! \fn QImage::Format QPlatformScreen::format() const = 0 Reimplement in subclass to return the image format which corresponds to the screen format */ /*! \class QPlatformScreenPageFlipper \since 5.0 \internal \preliminary \ingroup qpa \brief The QPlatformScreenPageFlipper class provides an abstract interface for display buffer swapping Implement the displayBuffer() function to initiate a buffer swap. The bufferDisplayed() signal should be emitted once the buffer is actually displayed on the screen. The bufferReleased() signal should be emitted when the buffer data is no longer owned by the display hardware. */ /*! \fn bool QPlatformScreenPageFlipper::displayBuffer(void *bufferHandle) Implemented in subclasses to display the buffer referenced by \a bufferHandle directly on the screen. Returns \c true if it is possible to display the buffer, and \c false if the buffer cannot be displayed. If this function returns true, the buffer must not be modified or destroyed before the bufferReleased() signal is emitted. The signal bufferDisplayed() is emitted when the buffer is displayed on the screen. The two signals may be emitted in either order. This function is allowed to block. */ /*! Implemented in subclasses to return a page flipper object for the screen, or 0 if the hardware does not support page flipping. The default implementation returns 0. */ QPlatformScreenPageFlipper *QPlatformScreen::pageFlipper() const { return 0; } QT_END_NAMESPACE