Qt 4.8
qbbrasterwindowsurface.cpp
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2011 - 2012 Research In Motion <blackberry-qt@qnx.com>
4 ** Contact: http://www.qt-project.org/legal
5 **
6 ** This file is part of the QtCore module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and Digia. For licensing terms and
14 ** conditions see http://qt.digia.com/licensing. For further information
15 ** use the contact form at http://qt.digia.com/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights. These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file. Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 // #define QBBRASTERWINDOWSURFACE_DEBUG
43 
44 
45 #include "qbbrasterwindowsurface.h"
46 #include "qbbwindow.h"
47 
48 #include <QtGui/QWidget>
49 #include <QDebug>
50 
51 #include <errno.h>
52 
54 
56  : QWindowSurface(window),
57  mUseFrontBuffer(false)
58 {
59 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
60  qDebug() << "QBBRasterWindowSurface::QBBRasterWindowSurface - w=" << window;
61 #endif
62 
63  // save platform window associated with widget
64  mPlatformWindow = static_cast<QBBWindow*>(window->platformWindow());
65 }
66 
68 {
69 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
70  qDebug() << "QBBRasterWindowSurface::~QBBRasterWindowSurface - w=" << window();
71 #endif
72 }
73 
75 {
79 
80  return 0;
81 }
82 
84 {
85  Q_UNUSED(widget);
86  Q_UNUSED(offset);
87 
88 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
89  qDebug() << "QBBRasterWindowSurface::flush - w=" << window();
90 #endif
91 
92  // visit all pending scroll operations
93  for (int i = mScrollOpList.size() - 1; i >= 0; i--) {
94 
95  // do the scroll operation
96  ScrollOp& op = mScrollOpList[i];
97  QRegion srcArea = op.totalArea.intersected( op.totalArea.translated(-op.dx, -op.dy) );
98  mPlatformWindow->scroll(srcArea, op.dx, op.dy);
99  }
100 
101  // clear all pending scroll operations
102  mScrollOpList.clear();
103 
104  // update the display with newly rendered content
105  mPlatformWindow->post(region);
106 }
107 
109 {
110 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
111  qDebug() << "QBBRasterWindowSurface::resize - w=" << window() << ", s=" << size;
112 #endif
113 
114  // call parent method
115  QWindowSurface::resize(size);
116 
117  // NOTE: defer resizing window buffers until next paint as
118  // resize() can be called multiple times before a paint occurs
119 }
120 
121 bool QBBRasterWindowSurface::scroll(const QRegion &area, int dx, int dy)
122 {
123 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
124  qDebug() << "QBBRasterWindowSurface::scroll - w=" << window();
125 #endif
126 
127  // calculate entire region affected by scroll operation (src + dst)
128  QRegion totalArea = area.translated(dx, dy);
129  totalArea += area;
130 
131  // visit all pending scroll operations
132  for (int i = mScrollOpList.size() - 1; i >= 0; i--) {
133 
134  ScrollOp& op = mScrollOpList[i];
135  if (op.totalArea == totalArea) {
136  // same area is being scrolled again - update delta
137  op.dx += dx;
138  op.dy += dy;
139  return true;
140  } else if (op.totalArea.intersects(totalArea)) {
141  // current scroll overlaps previous scroll but is
142  // not equal in area - just paint everything
143  qWarning("QBB: pending scroll operations overlap but not equal");
144  return false;
145  }
146  }
147 
148  // create new scroll operation
149  mScrollOpList.append( ScrollOp(totalArea, dx, dy) );
150  return true;
151 }
152 
154 {
155  Q_UNUSED(region);
156 
157 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
158  qDebug() << "QBBRasterWindowSurface::beginPaint - w=" << window();
159 #endif
160 
161  // resize window buffers if surface resized
162  QSize s = size();
163  if (s != mPlatformWindow->bufferSize()) {
165  }
166 }
167 
169 {
170  Q_UNUSED(region);
171 #if defined(QBBRASTERWINDOWSURFACE_DEBUG)
172  qDebug() << "QBBRasterWindowSurface::endPaint - w=" << window();
173 #endif
174 }
175 
177 {
178  // mUseFrontBuffer is used as a workaround to tell
179  // QBBRasterWindowSurface::paintDevice() to return the
180  // front buffer instead of the renderBuffer. grabWidget()
181  // is the only use case.
182  mUseFrontBuffer = true;
183 
184  QPixmap pixmap = QWindowSurface::grabWidget(widget, rectangle);
185 
186  mUseFrontBuffer = false;
187 
188  return pixmap;
189 }
190 
bool hasBuffers() const
Definition: qbbwindow.h:74
QRegion intersected(const QRegion &r) const
Returns a region which is the intersection of this region and r.
Definition: qregion.h:112
virtual void flush(QWidget *widget, const QRegion &region, const QPoint &offset)
Flushes the given region from the specified widget onto the screen.
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
QPointer< QWidget > widget
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
virtual QPoint offset(const QWidget *widget) const
Returns the offset of widget in the coordinates of this window surface.
void setBufferSize(const QSize &size)
Definition: qbbwindow.cpp:288
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...
virtual void beginPaint(const QRegion &region)
This function is called before painting onto the surface begins, with the region in which the paintin...
QSize bufferSize() const
Definition: qbbwindow.h:73
virtual QPixmap grabWidget(const QWidget *widget, const QRect &rectangle=QRect()) const
Returns a QPixmap generated from the part of the backing store corresponding to widget.
Q_CORE_EXPORT void qDebug(const char *,...)
NSWindow * window
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
QBBRasterWindowSurface(QWidget *window)
Q_CORE_EXPORT void qWarning(const char *,...)
void post(const QRegion &dirty)
Definition: qbbwindow.cpp:417
The QRegion class specifies a clip region for a painter.
Definition: qregion.h:68
QBBBuffer & renderBuffer()
Definition: qbbwindow.cpp:350
The QWindowSurface class provides the drawing area for top-level windows.
virtual void endPaint(const QRegion &region)
This function is called after painting onto the surface has ended, with the region in which the paint...
void scroll(const QRegion &region, int dx, int dy, bool flush=false)
Definition: qbbwindow.cpp:411
const QImage * image() const
Definition: qbbbuffer.h:60
QList< ScrollOp > mScrollOpList
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53
virtual void resize(const QSize &size)
virtual QPixmap grabWidget(const QWidget *widget, const QRect &rectangle) const
Returns a QPixmap generated from the part of the backing store corresponding to widget.
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
QBBBuffer & frontBuffer()
Definition: qbbwindow.cpp:359
The QPixmap class is an off-screen image representation that can be used as a paint device...
Definition: qpixmap.h:71
bool intersects(const QRegion &r) const
Returns true if this region intersects with region, otherwise returns false.
Definition: qregion.cpp:766
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
QRegion translated(int dx, int dy) const
Returns a copy of the region that is translated dx along the x axis and dy along the y axis...
Definition: qregion.cpp:743
virtual QPaintDevice * paintDevice()
Implement this function to return the appropriate paint device.
#define Q_UNUSED(x)
Indicates to the compiler that the parameter with the specified name is not used in the body of a fun...
Definition: qglobal.h:1729
QWidget * window() const
Returns a pointer to the top-level window associated with this surface.
static int area(const QSize &s)
Definition: qicon.cpp:155