QBBRasterWindowSurface Class Reference

#include <qbbrasterwindowsurface.h>

Inheritance diagram for QBBRasterWindowSurface:

Classes
class	ScrollOp

Public Functions
virtual void	beginPaint (const QRegion &region)
	This function is called before painting onto the surface begins, with the region in which the painting will occur. More...
virtual void	endPaint (const QRegion &region)
	This function is called after painting onto the surface has ended, with the region in which the painting was performed. More...
virtual void	flush (QWidget *widget, const QRegion &region, const QPoint &offset)
	Flushes the given region from the specified widget onto the screen. More...
virtual QPixmap	grabWidget (const QWidget *widget, const QRect &rectangle) const
	Returns a QPixmap generated from the part of the backing store corresponding to widget. More...
virtual QPaintDevice *	paintDevice ()
	Implement this function to return the appropriate paint device. More...
	QBBRasterWindowSurface (QWidget *window)
virtual void	resize (const QSize &size)
virtual bool	scroll (const QRegion &area, int dx, int dy)
	Scrolls the given area dx pixels to the right and dy downward; both dx and dy may be negative. More...
virtual	~QBBRasterWindowSurface ()
Public Functions inherited from QWindowSurface
virtual QImage *	buffer (const QWidget *widget)
	Returns a QImage pointer which represents the actual buffer the widget is drawn into or 0 if this is unavailable. More...
virtual WindowSurfaceFeatures	features () const
QRect	geometry () const
	Returns the currently allocated area on the screen. More...
bool	hasFeature (WindowSurfaceFeature feature) const
virtual QPoint	offset (const QWidget *widget) const
	Returns the offset of widget in the coordinates of this window surface. More...
	QWindowSurface (QWidget *window, bool setDefaultSurface=true)
	Constructs an empty surface for the given top-level window. More...
QRect	rect (const QWidget *widget) const
	Returns the rectangle for widget in the coordinates of this window surface. More...
virtual void	setGeometry (const QRect &rect)
	Sets the currently allocated area to be the given rect. More...
void	setStaticContents (const QRegion &region)
QRegion	staticContents () const
QWidget *	window () const
	Returns a pointer to the top-level window associated with this surface. More...
virtual	~QWindowSurface ()
	Destroys this surface. More...

Properties
QBBWindow *	mPlatformWindow
QList< ScrollOp >	mScrollOpList
bool	mUseFrontBuffer

Additional Inherited Members
Public Types inherited from QWindowSurface
enum	WindowSurfaceFeature { PartialUpdates = 0x00000001, PreservedContents = 0x00000002, StaticContents = 0x00000004, AllFeatures = 0xffffffff }
Protected Functions inherited from QWindowSurface
bool	hasStaticContents () const

Detailed Description

Definition at line 53 of file qbbrasterwindowsurface.h.

Constructors and Destructors

QBBRasterWindowSurface()

QBBRasterWindowSurface::QBBRasterWindowSurface

(

QWidget *

window

)

Definition at line 55 of file qbbrasterwindowsurface.cpp.

    : QWindowSurface(window),
      mUseFrontBuffer(false)
{
#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::QBBRasterWindowSurface - w=" << window;
#endif

    // save platform window associated with widget
    mPlatformWindow = static_cast<QBBWindow*>(window->platformWindow());
}

~QBBRasterWindowSurface()

QBBRasterWindowSurface::~QBBRasterWindowSurface ( )

virtual

Definition at line 67 of file qbbrasterwindowsurface.cpp.

{
#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::~QBBRasterWindowSurface - w=" << window();
#endif
}

Functions

beginPaint()

void QBBRasterWindowSurface::beginPaint ( const QRegion &  region )

virtual

This function is called before painting onto the surface begins, with the region in which the painting will occur.

See also

endPaint(), paintDevice()

Reimplemented from QWindowSurface.

Definition at line 153 of file qbbrasterwindowsurface.cpp.

{
    Q_UNUSED(region);

#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::beginPaint - w=" << window();
#endif

    // resize window buffers if surface resized
    QSize s = size();
    if (s != mPlatformWindow->bufferSize()) {
        mPlatformWindow->setBufferSize(s);
    }
}

endPaint()

void QBBRasterWindowSurface::endPaint ( const QRegion &  region )

virtual

This function is called after painting onto the surface has ended, with the region in which the painting was performed.

See also

beginPaint(), paintDevice()

Reimplemented from QWindowSurface.

Definition at line 168 of file qbbrasterwindowsurface.cpp.

{
    Q_UNUSED(region);
#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::endPaint - w=" << window();
#endif
}

flush()

void QBBRasterWindowSurface::flush ( QWidget *  widget, const QRegion &  region, const QPoint &  offset  )

virtual

Flushes the given region from the specified widget onto the screen.

Note that the offset parameter is currently unused.

Implements QWindowSurface.

Definition at line 83 of file qbbrasterwindowsurface.cpp.

{
    Q_UNUSED(widget);
    Q_UNUSED(offset);

#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::flush - w=" << window();
#endif

    // visit all pending scroll operations
    for (int i = mScrollOpList.size() - 1; i >= 0; i--) {

        // do the scroll operation
        ScrollOp& op = mScrollOpList[i];
        QRegion srcArea = op.totalArea.intersected( op.totalArea.translated(-op.dx, -op.dy) );
        mPlatformWindow->scroll(srcArea, op.dx, op.dy);
    }

    // clear all pending scroll operations
    mScrollOpList.clear();

    // update the display with newly rendered content
    mPlatformWindow->post(region);
}

grabWidget()

QPixmap QBBRasterWindowSurface::grabWidget ( const QWidget *  widget, const QRect &  rectangle  ) const

virtual

Returns a QPixmap generated from the part of the backing store corresponding to widget.

Returns a null QPixmap if an error occurs. The contents of the pixmap are only defined for the regions of widget that have received paint events since the last resize of the backing store.

If rectangle is a null rectangle (the default), the entire widget is grabbed. Otherwise, the grabbed area is limited to rectangle.

The default implementation uses QWindowSurface::buffer().

See also

QPixmap::grabWidget()

Reimplemented from QWindowSurface.

Definition at line 176 of file qbbrasterwindowsurface.cpp.

{
    // mUseFrontBuffer is used as a workaround to tell
    // QBBRasterWindowSurface::paintDevice() to return the
    // front buffer instead of the renderBuffer. grabWidget()
    // is the only use case.
    mUseFrontBuffer = true;

    QPixmap pixmap = QWindowSurface::grabWidget(widget, rectangle);

    mUseFrontBuffer = false;

    return pixmap;
}

paintDevice()

QPaintDevice * QBBRasterWindowSurface::paintDevice ( )

virtual

Implement this function to return the appropriate paint device.

Implements QWindowSurface.

Definition at line 74 of file qbbrasterwindowsurface.cpp.

{
    if (mPlatformWindow->hasBuffers())
        return (mUseFrontBuffer) ? mPlatformWindow->frontBuffer().image()
                                : mPlatformWindow->renderBuffer().image();

    return 0;
}

resize()

void QBBRasterWindowSurface::resize ( const QSize &  size )

virtual

Definition at line 108 of file qbbrasterwindowsurface.cpp.

{
#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::resize - w=" << window() << ", s=" << size;
#endif

    // call parent method
    QWindowSurface::resize(size);

    // NOTE: defer resizing window buffers until next paint as
    // resize() can be called multiple times before a paint occurs
}

scroll()

bool QBBRasterWindowSurface::scroll ( const QRegion &  area, int  dx, int  dy  )

virtual

Scrolls the given area dx pixels to the right and dy downward; both dx and dy may be negative.

Returns true if the area was scrolled successfully; false otherwise.

Reimplemented from QWindowSurface.

Definition at line 121 of file qbbrasterwindowsurface.cpp.

{
#if defined(QBBRASTERWINDOWSURFACE_DEBUG)
    qDebug() << "QBBRasterWindowSurface::scroll - w=" << window();
#endif

    // calculate entire region affected by scroll operation (src + dst)
    QRegion totalArea = area.translated(dx, dy);
    totalArea += area;

    // visit all pending scroll operations
    for (int i = mScrollOpList.size() - 1; i >= 0; i--) {

        ScrollOp& op = mScrollOpList[i];
        if (op.totalArea == totalArea) {
            // same area is being scrolled again - update delta
            op.dx += dx;
            op.dy += dy;
            return true;
        } else if (op.totalArea.intersects(totalArea)) {
            // current scroll overlaps previous scroll but is
            // not equal in area - just paint everything
            qWarning("QBB: pending scroll operations overlap but not equal");
            return false;
        }
    }

    // create new scroll operation
    mScrollOpList.append( ScrollOp(totalArea, dx, dy) );
    return true;
}

Properties

mPlatformWindow

QBBWindow* QBBRasterWindowSurface::mPlatformWindow

private

Definition at line 79 of file qbbrasterwindowsurface.h.

Referenced by beginPaint(), flush(), paintDevice(), and QBBRasterWindowSurface().

mScrollOpList

QList<ScrollOp> QBBRasterWindowSurface::mScrollOpList

private

Definition at line 80 of file qbbrasterwindowsurface.h.

Referenced by flush(), and scroll().

mUseFrontBuffer

bool QBBRasterWindowSurface::mUseFrontBuffer

mutableprivate

Definition at line 77 of file qbbrasterwindowsurface.h.

Referenced by grabWidget(), and paintDevice().

---

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

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