QBBIntegration Class Reference

#include <qbbintegration.h>

Inheritance diagram for QBBIntegration:

Public Functions
virtual QPlatformClipboard *	clipboard () const
	Accessor for the platform integrations clipboard. More...
void	createDisplay (screen_display_t display, int screenIndex)
virtual QPixmapData *	createPixmapData (QPixmapData::PixelType type) const
	Factory function for QPixmapData. More...
virtual QPlatformWindow *	createPlatformWindow (QWidget *widget, WId winId) const
	Factory function for QPlatformWindow. More...
virtual QWindowSurface *	createWindowSurface (QWidget *widget, WId winId) const
	Factory function for QWindowSurface. More...
virtual QPlatformFontDatabase *	fontDatabase () const
	Accessor for the platform integrations fontdatabase. More...
virtual bool	hasCapability (QPlatformIntegration::Capability cap) const
virtual void	moveToScreen (QWidget *window, int screen)
	This function is called when a QWidget is displayed on screen, or the QWidget is to be displayed on a new screen. More...
virtual QPlatformNativeInterface *	nativeInterface () const
bool	paintUsingOpenGL () const
	QBBIntegration ()
void	removeDisplay (QBBScreen *screen)
QBBScreen *	screenForNative (screen_display_t screen) const
QBBScreen *	screenForWindow (screen_window_t window) const
virtual QList< QPlatformScreen * >	screens () const
	Accessor function to a list of all the screens on the current system. More...
virtual void	setCursorPos (int x, int y)
virtual	~QBBIntegration ()
Public Functions inherited from QPlatformIntegration
virtual QPlatformEventLoopIntegration *	createEventLoopIntegration () const
	Factory function for the eventloop integration interface. More...
virtual QPixmap	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. More...
virtual bool	isVirtualDesktop ()
	Returns if the current windowing system configuration defines all the screens to be one desktop(virtual desktop), or if each screen is a desktop of its own. More...
virtual	~QPlatformIntegration ()

Private Functions
void	createDisplays ()
void	destroyDisplays ()
QBBScreen *	primaryDisplay () const

Properties
QBBBpsEventFilter *	mBpsEventFilter
QBBButtonEventNotifier *	mButtonsNotifier
screen_context_t	mContext
QPlatformFontDatabase *	mFontDb
QBBLocaleThread *	mLocaleThread
QBBNativeInterface *	mNativeInterface
QBBNavigatorEventHandler *	mNavigatorEventHandler
QBBNavigatorEventNotifier *	mNavigatorEventNotifier
bool	mPaintUsingOpenGL
QBBScreenEventHandler *	mScreenEventHandler
QBBScreenEventThread *	mScreenEventThread
QList< QPlatformScreen * >	mScreens
QBBAbstractVirtualKeyboard *	mVirtualKeyboard

Additional Inherited Members
Public Types inherited from QPlatformIntegration
enum	Capability { ThreadedPixmaps = 1, OpenGL = 2 }

Detailed Description

Definition at line 62 of file qbbintegration.h.

Constructors and Destructors

QBBIntegration()

QBBIntegration::QBBIntegration

(

)

Definition at line 85 of file qbbintegration.cpp.

                               :
    mScreenEventThread(0),
    mNavigatorEventHandler(new QBBNavigatorEventHandler()),
    mButtonsNotifier(new QBBButtonEventNotifier()),
    mFontDb(new QGenericUnixFontDatabase()),
    mScreenEventHandler(new QBBScreenEventHandler(this)),
    mPaintUsingOpenGL(getenv("QBB_USE_OPENGL") != NULL),
    mVirtualKeyboard(0),
    mNativeInterface(new QBBNativeInterface(this)),
    mBpsEventFilter(0)
{
    qRegisterMetaType<screen_window_t>();

    if (mPaintUsingOpenGL) {
        // Set default window API to OpenGL
        QPlatformWindowFormat format = QPlatformWindowFormat::defaultFormat();
        format.setWindowApi(QPlatformWindowFormat::OpenGL);
        QPlatformWindowFormat::setDefaultFormat(format);
    }

    // initialize global OpenGL resources
    QBBGLContext::initialize();

    // open connection to QNX composition manager
    errno = 0;
    int result = screen_create_context(&mContext, SCREEN_APPLICATION_CONTEXT);
    if (result != 0) {
        qFatal("QBB: failed to connect to composition manager, errno=%d", errno);
    }

    // Create/start navigator event notifier
    // Not on BlackBerry, it has specialised event dispatcher which also handles navigator events
#if !defined(Q_OS_BLACKBERRY)
    mNavigatorEventNotifier = new QBBNavigatorEventNotifier(mNavigatorEventHandler);

    // delay invocation of start() to the time the event loop is up and running
    // needed to have the QThread internals of the main thread properly initialized
    QMetaObject::invokeMethod(mNavigatorEventNotifier, "start", Qt::QueuedConnection);
#endif

    // Create displays for all possible screens (which may not be attached)
    createDisplays();

    // create/start event thread
#if defined(QBB_SCREENEVENTTHREAD)
    mScreenEventThread = new QBBScreenEventThread(mContext, mScreenEventHandler);
    mScreenEventThread->start();
#endif

#ifdef QBBLOCALETHREAD_ENABLED
    // Start the locale change monitoring thread.
    mLocaleThread = new QBBLocaleThread();
    mLocaleThread->start();
#endif

#if defined(Q_OS_BLACKBERRY)
    bps_initialize();

    QBBVirtualKeyboardBps *virtualKeyboardBps = new QBBVirtualKeyboardBps;

    mBpsEventFilter = new QBBBpsEventFilter(mNavigatorEventHandler,
            (mScreenEventThread ? 0 : mScreenEventHandler), virtualKeyboardBps);

    if (!mScreenEventThread) {
        Q_FOREACH (QPlatformScreen *platformScreen, mScreens) {
            QBBScreen *screen = static_cast<QBBScreen*>(platformScreen);
            mBpsEventFilter->registerForScreenEvents(screen);
        }
    }

    mBpsEventFilter->installOnEventDispatcher(QAbstractEventDispatcher::instance());

    mVirtualKeyboard = virtualKeyboardBps;
#else
    // create/start the keyboard class.
    mVirtualKeyboard = new QBBVirtualKeyboardPps();

    // delay invocation of start() to the time the event loop is up and running
    // needed to have the QThread internals of the main thread properly initialized
    QMetaObject::invokeMethod(mVirtualKeyboard, "start", Qt::QueuedConnection);
#endif

    // TODO check if we need to do this for all screens or only the primary one
    QObject::connect(mVirtualKeyboard, SIGNAL(heightChanged(int)),
                     primaryDisplay(), SLOT(keyboardHeightChanged(int)));

    // Set up the input context
    qApp->setInputContext(new QBBInputContext(*mVirtualKeyboard, qApp));

    // delay invocation of start() to the time the event loop is up and running
    // needed to have the QThread internals of the main thread properly initialized
    QMetaObject::invokeMethod(mButtonsNotifier, "start", Qt::QueuedConnection);
}

~QBBIntegration()

QBBIntegration::~QBBIntegration ( )

virtual

Definition at line 179 of file qbbintegration.cpp.

{
#if defined(QBBINTEGRATION_DEBUG)
    qDebug() << "QBB: platform plugin shutdown begin";
#endif
    delete mNativeInterface;

    // Destroy the hardware button notifier
    delete mButtonsNotifier;

#ifdef QBBLOCALETHREAD_ENABLED
    // stop/destroy the locale thread.
    delete mLocaleThread;
#endif

#if defined(QBB_SCREENEVENTTHREAD)
    // stop/destroy event thread
    delete mScreenEventThread;
#elif defined(Q_OS_BLACKBERRY)
    Q_FOREACH (QPlatformScreen *platformScreen, mScreens) {
        QBBScreen *screen = static_cast<QBBScreen*>(platformScreen);
        mBpsEventFilter->unregisterForScreenEvents(screen);
    }
#endif

#if defined(Q_OS_BLACKBERRY)
    delete mBpsEventFilter;
#else
    // stop/destroy navigator event handling classes
    delete mNavigatorEventNotifier;
#endif

    // destroy the keyboard class.
    delete mVirtualKeyboard;

    delete mNavigatorEventHandler;
    delete mScreenEventHandler;

    // destroy all displays
    destroyDisplays();

    // close connection to QNX composition manager
    screen_destroy_context(mContext);

    // cleanup global OpenGL resources
    QBBGLContext::shutdown();

#if defined(Q_OS_BLACKBERRY)
    bps_shutdown();
#endif

#if defined(QBBINTEGRATION_DEBUG)
    qDebug() << "QBB: platform plugin shutdown end";
#endif
}

Functions

clipboard()

QPlatformClipboard * QBBIntegration::clipboard ( ) const

virtual

Accessor for the platform integrations clipboard.

Default implementation returns a default QPlatformClipboard.

See also

QPlatformClipboard

Reimplemented from QPlatformIntegration.

Definition at line 299 of file qbbintegration.cpp.

Referenced by fontDatabase().

{
    static QPlatformClipboard *clipboard = 0;
    if (!clipboard) {
        clipboard = static_cast<QPlatformClipboard *>(new QBBClipboard);
    }
    return clipboard;
}

createDisplay()

void QBBIntegration::createDisplay	(	screen_display_t	display,
		int	screenIndex
	)

Definition at line 368 of file qbbintegration.cpp.

Referenced by createDisplays(), QBBScreenEventHandler::handleDisplayEvent(), and paintUsingOpenGL().

{
    QBBScreen *screen = new QBBScreen(mContext, display, screenIndex);
    mScreens.append(screen);
    screen->adjustOrientation();

    QObject::connect(mScreenEventHandler, SIGNAL(newWindowCreated(screen_window_t)),
                  screen, SLOT(newWindowCreated(screen_window_t)));
    QObject::connect(mScreenEventHandler, SIGNAL(windowClosed(screen_window_t)),
                  screen, SLOT(windowClosed(screen_window_t)));

    QObject::connect(mNavigatorEventHandler, SIGNAL(rotationChanged(int)), screen, SLOT(setRotation(int)));
    QObject::connect(mNavigatorEventHandler, SIGNAL(windowGroupActivated(QByteArray)), screen, SLOT(activateWindowGroup(QByteArray)));
    QObject::connect(mNavigatorEventHandler, SIGNAL(windowGroupDeactivated(QByteArray)), screen, SLOT(deactivateWindowGroup(QByteArray)));
    QObject::connect(mNavigatorEventHandler, SIGNAL(windowGroupStateChanged(QByteArray,Qt::WindowState)),
            screen, SLOT(windowGroupStateChanged(QByteArray,Qt::WindowState)));
}

createDisplays()

void QBBIntegration::createDisplays ( )

private

Definition at line 337 of file qbbintegration.cpp.

Referenced by paintUsingOpenGL(), and QBBIntegration().

{
    // get number of displays
    errno = 0;
    int displayCount;
    int result = screen_get_context_property_iv(mContext, SCREEN_PROPERTY_DISPLAY_COUNT, &displayCount);
    if (result != 0)
        qFatal("QBBIntegration: failed to query display count, errno=%d", errno);

    // get all displays
    errno = 0;
    screen_display_t *displays = (screen_display_t *)alloca(sizeof(screen_display_t) * displayCount);
    result = screen_get_context_property_pv(mContext, SCREEN_PROPERTY_DISPLAYS, (void **)displays);
    if (result != 0)
        qFatal("QBBIntegration: failed to query displays, errno=%d", errno);

    for (int i=0; i<displayCount; i++) {
        int isAttached = 0;
        result = screen_get_display_property_iv(displays[i], SCREEN_PROPERTY_ATTACHED, &isAttached);
        if (result != 0) {
            qWarning("QBBIntegration: failed to query display attachment, errno=%d", errno);
            isAttached = 1; // assume attached
        }

        if (!isAttached)
            continue;

        createDisplay(displays[i], i);
    } // of displays iteration
}

createPixmapData()

QPixmapData * QBBIntegration::createPixmapData ( QPixmapData::PixelType  type ) const

virtual

Factory function for QPixmapData.

PixelType can be either PixmapType or BitmapType.

See also

QPixmapData

Implements QPlatformIntegration.

Definition at line 246 of file qbbintegration.cpp.

{
    if (paintUsingOpenGL())
        return new QGLPixmapData(type);
    else
        return new QRasterPixmapData(type);
}

createPlatformWindow()

QPlatformWindow * QBBIntegration::createPlatformWindow ( QWidget *  widget, WId  winId  ) const

virtual

Factory function for QPlatformWindow.

The widget parameter is a pointer to the top level widget(tlw) which the QPlatformWindow is suppose to be created for. The WId handle is actually never used, but there for future reference. Its purpose is if it is going to be possible to create QPlatformWindows on existing WId.

All tlw has to have a QPlatformWindow, and it will be created when the QPlatformWindow is set to be visible for the first time. If the tlw's window flags are changed, or if the tlw's QPlatformWindowFormat is changed, then the tlw's QPlatformWindow is deleted and a new one is created.

See also

QPlatformWindow, QPlatformWindowFormat

createWindowSurface(QWidget *widget, WId winId) const

Implements QPlatformIntegration.

Definition at line 254 of file qbbintegration.cpp.

{
    Q_UNUSED(winId);

    return new QBBWindow(widget, mContext, primaryDisplay());
}

createWindowSurface()

QWindowSurface * QBBIntegration::createWindowSurface ( QWidget *  widget, WId  winId  ) const

virtual

Factory function for QWindowSurface.

The QWidget parameter is a pointer to the top level widget(tlw) the window surface is created for. A QPlatformWindow is always created before the QWindowSurface for tlw where the widget also requires a WindowSurface. It is possible to create top level QWidgets without a QWindowSurface by specifying QPlatformWindowFormat::setWindowSurface(false) for the tlw QPlatformWindowFormat.

See also

QWindowSurface

createPlatformWindow(QWidget *widget, WId winId = 0) const

Implements QPlatformIntegration.

Definition at line 261 of file qbbintegration.cpp.

{
    Q_UNUSED(winId);
    if (paintUsingOpenGL())
        return new QBBGLWindowSurface(widget);
    else
        return new QBBRasterWindowSurface(widget);
}

destroyDisplays()

void QBBIntegration::destroyDisplays ( )

private

Definition at line 394 of file qbbintegration.cpp.

Referenced by paintUsingOpenGL(), and ~QBBIntegration().

{
    qDeleteAll(mScreens);
    mScreens.clear();
}

fontDatabase()

virtual QPlatformFontDatabase* QBBIntegration::fontDatabase ( ) const

inlinevirtual

Accessor for the platform integrations fontdatabase.

Default implementation returns a default QPlatformFontDatabase.

See also

QPlatformFontDatabase

Reimplemented from QPlatformIntegration.

Definition at line 79 of file qbbintegration.h.

{ return mFontDb; }

hasCapability()

bool QBBIntegration::hasCapability ( QPlatformIntegration::Capability  cap ) const

virtual

Reimplemented from QPlatformIntegration.

Definition at line 235 of file qbbintegration.cpp.

{
    switch (cap) {
    case ThreadedPixmaps: return true;
#if defined(QT_OPENGL_ES)
    case OpenGL: return true;
#endif
    default: return QPlatformIntegration::hasCapability(cap);
    }
}

moveToScreen()

void QBBIntegration::moveToScreen ( QWidget *  window, int  screen  )

virtual

This function is called when a QWidget is displayed on screen, or the QWidget is to be displayed on a new screen.

The QWidget parameter is a pointer to the top level widget and the int parameter is the index to the screen in QList<QPlatformScreen *> screens() const.

Default implementation does nothing.

See also

screens() const

Reimplemented from QPlatformIntegration.

Definition at line 275 of file qbbintegration.cpp.

{
#if defined(QBBINTEGRATION_DEBUG)
    qDebug() << "QBBIntegration::moveToScreen - w=" << window << ", s=" << screen;
#endif

    // get platform window used by widget
    QBBWindow* platformWindow = static_cast<QBBWindow*>(window->platformWindow());

    // lookup platform screen by index
    QBBScreen* platformScreen = static_cast<QBBScreen*>(mScreens.at(screen));

    // move the platform window to the platform screen (this can fail when move to screen
    // is called before the window is actually created).
    if (platformWindow && platformScreen)
        platformWindow->setScreen(platformScreen);
}

nativeInterface()

QPlatformNativeInterface * QBBIntegration::nativeInterface ( ) const

virtual

Reimplemented from QPlatformIntegration.

Definition at line 270 of file qbbintegration.cpp.

{
    return mNativeInterface;
}

paintUsingOpenGL()

bool QBBIntegration::paintUsingOpenGL ( ) const

inline

Definition at line 85 of file qbbintegration.h.

Referenced by createPixmapData(), and createWindowSurface().

{ return mPaintUsingOpenGL; }

primaryDisplay()

QBBScreen * QBBIntegration::primaryDisplay ( ) const

private

Definition at line 327 of file qbbintegration.cpp.

Referenced by createPlatformWindow(), paintUsingOpenGL(), and QBBIntegration().

{
    return static_cast<QBBScreen*>(mScreens.first());
}

removeDisplay()

void QBBIntegration::removeDisplay

(

QBBScreen *

screen

)

Definition at line 386 of file qbbintegration.cpp.

Referenced by QBBScreenEventHandler::handleDisplayEvent(), and paintUsingOpenGL().

{
    Q_CHECK_PTR(screen);
    Q_ASSERT(mScreens.contains(screen));
    mScreens.removeAll(screen);
    screen->deleteLater();
}

screenForNative()

QBBScreen * QBBIntegration::screenForNative

(

screen_display_t

screen

)

const

Definition at line 400 of file qbbintegration.cpp.

Referenced by QBBScreenEventHandler::handleDisplayEvent(), and paintUsingOpenGL().

{
    Q_FOREACH (QPlatformScreen *screen, mScreens) {
        QBBScreen *bbScreen = static_cast<QBBScreen*>(screen);
        if (bbScreen->nativeDisplay() == nativeScreen)
            return bbScreen;
    }

    return 0;
}

screenForWindow()

QBBScreen * QBBIntegration::screenForWindow

(

screen_window_t

window

)

const

Definition at line 310 of file qbbintegration.cpp.

Referenced by QBBNativeInterface::nativeResourceForWidget(), and paintUsingOpenGL().

{
    screen_display_t display = 0;
    if (screen_get_window_property_pv(window, SCREEN_PROPERTY_DISPLAY, (void**)&display) != 0) {
        qWarning("QBBIntegration: Failed to get screen for window, errno=%d", errno);
        return 0;
    }

    Q_FOREACH (QPlatformScreen *screen, mScreens) {
        QBBScreen * const bbScreen = static_cast<QBBScreen*>(screen);
        if (bbScreen->nativeDisplay() == display)
            return bbScreen;
    }

    return 0;
}

screens()

QList< QPlatformScreen * > QBBIntegration::screens ( ) const

virtual

Accessor function to a list of all the screens on the current system.

The screen with the index == 0 is the default/main screen.

Implements QPlatformIntegration.

Definition at line 293 of file qbbintegration.cpp.

{
    return mScreens;
}

setCursorPos()

void QBBIntegration::setCursorPos ( int  x, int  y  )

virtual

Definition at line 332 of file qbbintegration.cpp.

{
    mScreenEventThread->injectPointerMoveEvent(x, y);
}

Properties

mBpsEventFilter

QBBBpsEventFilter* QBBIntegration::mBpsEventFilter

private

Definition at line 110 of file qbbintegration.h.

Referenced by QBBIntegration(), and ~QBBIntegration().

mButtonsNotifier

QBBButtonEventNotifier* QBBIntegration::mButtonsNotifier

private

Definition at line 102 of file qbbintegration.h.

Referenced by QBBIntegration(), and ~QBBIntegration().

mContext

screen_context_t QBBIntegration::mContext

private

Definition at line 98 of file qbbintegration.h.

Referenced by createDisplay(), createDisplays(), createPlatformWindow(), QBBIntegration(), and ~QBBIntegration().

mFontDb

QPlatformFontDatabase* QBBIntegration::mFontDb

private

Definition at line 104 of file qbbintegration.h.

Referenced by fontDatabase().

mLocaleThread

QBBLocaleThread* QBBIntegration::mLocaleThread

private

Definition at line 103 of file qbbintegration.h.

Referenced by QBBIntegration(), and ~QBBIntegration().

mNativeInterface

QBBNativeInterface* QBBIntegration::mNativeInterface

private

Definition at line 109 of file qbbintegration.h.

Referenced by nativeInterface(), and ~QBBIntegration().

mNavigatorEventHandler

QBBNavigatorEventHandler* QBBIntegration::mNavigatorEventHandler

private

Definition at line 100 of file qbbintegration.h.

Referenced by createDisplay(), QBBIntegration(), and ~QBBIntegration().

mNavigatorEventNotifier

QBBNavigatorEventNotifier* QBBIntegration::mNavigatorEventNotifier

private

Definition at line 101 of file qbbintegration.h.

Referenced by QBBIntegration(), and ~QBBIntegration().

mPaintUsingOpenGL

bool QBBIntegration::mPaintUsingOpenGL

private

Definition at line 107 of file qbbintegration.h.

Referenced by paintUsingOpenGL(), and QBBIntegration().

mScreenEventHandler

QBBScreenEventHandler* QBBIntegration::mScreenEventHandler

private

Definition at line 106 of file qbbintegration.h.

Referenced by createDisplay(), QBBIntegration(), and ~QBBIntegration().

mScreenEventThread

QBBScreenEventThread* QBBIntegration::mScreenEventThread

private

Definition at line 99 of file qbbintegration.h.

Referenced by QBBIntegration(), setCursorPos(), and ~QBBIntegration().

mScreens

QList<QPlatformScreen*> QBBIntegration::mScreens

private

Definition at line 105 of file qbbintegration.h.

Referenced by createDisplay(), destroyDisplays(), moveToScreen(), primaryDisplay(), QBBIntegration(), removeDisplay(), screenForNative(), screenForWindow(), screens(), and ~QBBIntegration().

mVirtualKeyboard

QBBAbstractVirtualKeyboard* QBBIntegration::mVirtualKeyboard

private

Definition at line 108 of file qbbintegration.h.

Referenced by QBBIntegration(), and ~QBBIntegration().

---

The documentation for this class was generated from the following files:

• /src/plugins/platforms/blackberry/qbbintegration.h
• /src/plugins/platforms/blackberry/qbbintegration.cpp