/****************************************************************************+
−
**+
−
** Copyright (C) 2010 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<const QWidget *>(fromDevice)->x11Info().x11data;+
−
        else if (fromDevice->devType() == QInternal::Pixmap)+
−
            xd = static_cast<const QPixmap *>(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<const QWidget *>(fromDevice)->x11Info().x11data;+
−
	} else {+
−
	    Q_ASSERT(fromDevice->devType() == QInternal::Pixmap);+
−
            xd = static_cast<const QPixmap *>(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->ref = 0;+
−
        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+
−