/****************************************************************************

**

** 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<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()

*/