/**************************************************************************** ** ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the QtGui module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** No Commercial Usage ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the Technology Preview License Agreement accompanying ** this package. ** ** GNU Lesser General Public License Usage ** Alternatively, 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. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** ** ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qwidget.h" #include "qpixmap.h" #include "qx11info_x11.h" #include "qt_x11_p.h" QT_BEGIN_NAMESPACE /*! \class QX11Info \brief The QX11Info class provides information about the X display configuration. \ingroup shared The class provides two APIs: a set of non-static functions that provide information about a specific widget or pixmap, and a set of static functions that provide the default information for the application. \warning This class is only available on X11. For querying per-screen information in a portable way, use QDesktopWidget. \sa QWidget::x11Info(), QPixmap::x11Info(), QDesktopWidget */ /*! Constructs an empty QX11Info object. */ QX11Info::QX11Info() : x11data(0) { } /*! Constructs a copy of \a other. */ QX11Info::QX11Info(const QX11Info &other) { x11data = other.x11data; if (x11data) ++x11data->ref; } /*! Assigns \a other to this object and returns a reference to this object. */ QX11Info &QX11Info::operator=(const QX11Info &other) { if (other.x11data) ++other.x11data->ref; if (x11data && !--x11data->ref) delete x11data; x11data = other.x11data; return *this; } /*! Destroys the QX11Info object. */ QX11Info::~QX11Info() { if (x11data && !--x11data->ref) delete x11data; } /*! \internal Makes a shallow copy of the X11-specific data of \a fromDevice, if it is not null. Otherwise this function sets it to null. */ void QX11Info::copyX11Data(const QPaintDevice *fromDevice) { QX11InfoData *xd = 0; if (fromDevice) { if (fromDevice->devType() == QInternal::Widget) xd = static_cast(fromDevice)->x11Info().x11data; else if (fromDevice->devType() == QInternal::Pixmap) xd = static_cast(fromDevice)->x11Info().x11data; } setX11Data(xd); } /*! \internal Makes a deep copy of the X11-specific data of \a fromDevice, if it is not null. Otherwise this function sets it to null. */ void QX11Info::cloneX11Data(const QPaintDevice *fromDevice) { QX11InfoData *d = 0; if (fromDevice) { QX11InfoData *xd; if (fromDevice->devType() == QInternal::Widget) { xd = static_cast(fromDevice)->x11Info().x11data; } else { Q_ASSERT(fromDevice->devType() == QInternal::Pixmap); xd = static_cast(fromDevice)->x11Info().x11data; } d = new QX11InfoData(*xd); d->ref = 0; } setX11Data(d); } /*! \internal Makes a shallow copy of the X11-specific data \a d and assigns it to this class. This function increments the reference code of \a d. */ void QX11Info::setX11Data(const QX11InfoData* d) { if (x11data && !--x11data->ref) delete x11data; x11data = (QX11InfoData *)d; if (x11data) ++x11data->ref; } /*! \internal If \a def is false, returns a deep copy of the x11Data, or 0 if x11Data is 0. If \a def is true, makes a QX11Data struct filled with the default values. In either case the caller is responsible for deleting the returned struct. But notice that the struct is a shared class, so other classes might also have a reference to it. The reference count of the returned QX11Data* is 0. */ QX11InfoData* QX11Info::getX11Data(bool def) const { QX11InfoData* res = 0; if (def) { res = new QX11InfoData; res->screen = appScreen(); res->depth = appDepth(); res->cells = appCells(); res->colormap = colormap(); res->defaultColormap = appDefaultColormap(); res->visual = (Visual*) appVisual(); res->defaultVisual = appDefaultVisual(); } else if (x11data) { res = new QX11InfoData; *res = *x11data; } res->ref = 0; return res; } /*! Returns the horizontal resolution of the given \a screen in terms of the number of dots per inch. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa setAppDpiX(), appDpiY() */ int QX11Info::appDpiX(int screen) { if (!X11) return 75; if (screen < 0) screen = X11->defaultScreen; if (screen > X11->screenCount) return 0; return X11->screens[screen].dpiX; } /*! Sets the horizontal resolution of the given \a screen to the number of dots per inch specified by \a xdpi. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa appDpiX(), setAppDpiY() */ void QX11Info::setAppDpiX(int screen, int xdpi) { if (!X11) return; if (screen < 0) screen = X11->defaultScreen; if (screen > X11->screenCount) return; X11->screens[screen].dpiX = xdpi; } /*! Returns the vertical resolution of the given \a screen in terms of the number of dots per inch. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa setAppDpiY(), appDpiX() */ int QX11Info::appDpiY(int screen) { if (!X11) return 75; if (screen < 0) screen = X11->defaultScreen; if (screen > X11->screenCount) return 0; return X11->screens[screen].dpiY; } /*! Sets the vertical resolution of the given \a screen to the number of dots per inch specified by \a ydpi. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa appDpiY(), setAppDpiX() */ void QX11Info::setAppDpiY(int screen, int ydpi) { if (!X11) return; if (screen < 0) screen = X11->defaultScreen; if (screen > X11->screenCount) return; X11->screens[screen].dpiY = ydpi; } /*! Returns the X11 time. \sa setAppTime(), appUserTime() */ unsigned long QX11Info::appTime() { return X11 ? X11->time : 0; } /*! Sets the X11 time to the value specified by \a time. \sa appTime(), setAppUserTime() */ void QX11Info::setAppTime(unsigned long time) { if (X11) { X11->time = time; } } /*! Returns the X11 user time. \sa setAppUserTime(), appTime() */ unsigned long QX11Info::appUserTime() { return X11 ? X11->userTime : 0; } /*! Sets the X11 user time as specified by \a time. \sa appUserTime(), setAppTime() */ void QX11Info::setAppUserTime(unsigned long time) { if (X11) { X11->userTime = time; } } /*! \fn const char *QX11Info::appClass() Returns the X11 application class. \sa display() */ /*! Returns the default display for the application. \sa appScreen() */ Display *QX11Info::display() { return X11 ? X11->display : 0; } /*! Returns the number of the screen where the application is being displayed. \sa display(), screen() */ int QX11Info::appScreen() { return X11 ? X11->defaultScreen : 0; } /*! Returns a handle for the application's color map on the given \a screen. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa colormap(), defaultColormap() */ Qt::HANDLE QX11Info::appColormap(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].colormap : 0; } /*! Returns the current visual used by the application on the given \a screen. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa visual(), defaultVisual() */ void *QX11Info::appVisual(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].visual : 0; } /*! Returns a handle for the applications root window on the given \a screen. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa QApplication::desktop() */ Qt::HANDLE QX11Info::appRootWindow(int screen) { return X11 ? RootWindow(X11->display, screen == -1 ? X11->defaultScreen : screen) : 0; } /*! Returns the color depth (bits per pixel) used by the application on the given \a screen. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa depth() */ int QX11Info::appDepth(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].depth : 32; } /*! Returns the number of cells used by the application on the given \a screen. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa cells() */ int QX11Info::appCells(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].cells : 0; } /*! Returns true if the application has a default color map on the given \a screen; otherwise returns false. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. */ bool QX11Info::appDefaultColormap(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].defaultColormap : true; } /*! Returns true if the application has a default visual on the given \a screen; otherwise returns false. The \a screen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. */ bool QX11Info::appDefaultVisual(int screen) { return X11 ? X11->screens[screen == -1 ? X11->defaultScreen : screen].defaultVisual : true; } /*! Returns the number of the screen currently in use. The return value is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. Use QDesktopWidget to query for information about Xinerama screens. \sa appScreen() */ int QX11Info::screen() const { return x11data ? x11data->screen : QX11Info::appScreen(); } /*! Returns the color depth (bits per pixel) of the X display. \sa appDepth() */ int QX11Info::depth() const { return x11data ? x11data->depth : QX11Info::appDepth(); } /*! Returns the number of cells. \sa appCells() */ int QX11Info::cells() const { return x11data ? x11data->cells : QX11Info::appCells(); } /*! Returns a handle for the color map. \sa defaultColormap() */ Qt::HANDLE QX11Info::colormap() const { return x11data ? x11data->colormap : QX11Info::appColormap(); } /*! Returns true if there is a default color map; otherwise returns false. \sa colormap() */ bool QX11Info::defaultColormap() const { return x11data ? x11data->defaultColormap : QX11Info::appDefaultColormap(); } /*! Returns the current visual. \sa appVisual(), defaultVisual() */ void *QX11Info::visual() const { return x11data ? x11data->visual : QX11Info::appVisual(); } /*! Returns true if there is a default visual; otherwise returns false. \sa visual(), appVisual() */ bool QX11Info::defaultVisual() const { return x11data ? x11data->defaultVisual : QX11Info::appDefaultVisual(); } /*! \since 4.4 Returns true if there is a compositing manager running. */ bool QX11Info::isCompositingManagerRunning() { return X11 ? X11->compositingManagerRunning : false; } QT_END_NAMESPACE