QWSLocalMemSurface Class Reference

#include <qwindowsurface_qws_p.h>

Inheritance diagram for QWSLocalMemSurface:

Public Functions
QString	key () const
	Implement this function to return a string that uniquely identifies the class of this surface. More...
QByteArray	permanentState () const
	Implement this function to return the data required for creating a server-side representation of the surface. More...
	QWSLocalMemSurface ()
	QWSLocalMemSurface (QWidget *widget)
virtual void	releaseSurface ()
void	setGeometry (const QRect &rect)
	Sets the currently allocated area to be the given rect. More...
void	setPermanentState (const QByteArray &data)
	Implement this function to attach a server-side surface instance to the corresponding client side instance using the given data. More...
	~QWSLocalMemSurface ()
Public Functions inherited from QWSMemorySurface
void	beginPaint (const QRegion &rgn)
	This function is called before painting onto the surface begins, with the region in which the painting will occur. More...
QImage	image () const
	Implement this function to return an image of the top-level window. More...
bool	isValid () const
	Implement this function to return true if the surface is a valid surface for the given top-level window; otherwise return false. More...
bool	lock (int timeout=-1)
QPaintDevice *	paintDevice ()
	Implement this function to return the appropriate paint device. More...
QPoint	painterOffset () const
	Returns the offset to be used when painting. More...
	QWSMemorySurface ()
	QWSMemorySurface (QWidget *widget)
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...
void	unlock ()
	~QWSMemorySurface ()
Public Functions inherited from QWSWindowSurface
const QRegion	clipRegion () const
	Returns the region currently visible on the screen. More...
virtual void	endPaint (const QRegion &)
	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...
bool	isBuffered () const
	Returns true if the QWSWindowSurface::Buffered is set; otherwise returns false. More...
bool	isOpaque () const
	Returns true if the QWSWindowSurface::Opaque is set; otherwise returns false. More...
bool	isRegionReserved () const
	Returns true if the QWSWindowSurface::RegionReserved is set; otherwise returns false. More...
virtual bool	move (const QPoint &offset)
	Move the surface with the given offset. More...
virtual QRegion	move (const QPoint &offset, const QRegion &newClip)
	Move the surface with the given offset. More...
	QWSWindowSurface ()
	Constructs an empty surface. More...
	QWSWindowSurface (QWidget *widget)
	Constructs an empty surface for the given top-level widget. More...
void	setClipRegion (const QRegion &)
	Sets the region currently visible on the screen to be the given clip region. More...
virtual void	setGeometry (const QRect &rect, const QRegion &mask)
virtual void	setTransientState (const QByteArray &state)
SurfaceFlags	surfaceFlags () const
	Returns the surface flags describing the contents of this surface. More...
virtual QByteArray	transientState () const
int	winId () const
	~QWSWindowSurface ()
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...
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. 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...
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...

Protected Variables
uchar *	mem
int	memsize
Protected Variables inherited from QWSMemorySurface
QImage	img
QWSLock *	memlock
QMutex	threadLock

Additional Inherited Members
Public Types inherited from QWSWindowSurface
enum	SurfaceFlag { RegionReserved = 0x1, Buffered = 0x2, Opaque = 0x4 }
	This enum is used to describe the window surface's contents. More...
Public Types inherited from QWindowSurface
enum	WindowSurfaceFeature { PartialUpdates = 0x00000001, PreservedContents = 0x00000002, StaticContents = 0x00000004, AllFeatures = 0xffffffff }
Protected Functions inherited from QWSMemorySurface
QImage::Format	preferredImageFormat (const QWidget *widget) const
void	setLock (int lockId)
Protected Functions inherited from QWSWindowSurface
void	setSurfaceFlags (SurfaceFlags type)
	Sets the surface flags describing the contents of this surface, to be the given flags. More...
void	setWinId (int id)
Protected Functions inherited from QWindowSurface
bool	hasStaticContents () const

Detailed Description

Definition at line 198 of file qwindowsurface_qws_p.h.

Constructors and Destructors

QWSLocalMemSurface() [1/2]

QWSLocalMemSurface::QWSLocalMemSurface

(

)

Definition at line 953 of file qwindowsurface_qws.cpp.

    : QWSMemorySurface(), mem(0), memsize(0)
{
}

QWSLocalMemSurface() [2/2]

QWSLocalMemSurface::QWSLocalMemSurface

(

QWidget *

widget

)

Definition at line 958 of file qwindowsurface_qws.cpp.

    : QWSMemorySurface(w), mem(0), memsize(0)
{
}

~QWSLocalMemSurface()

QWSLocalMemSurface::~QWSLocalMemSurface

(

)

Definition at line 963 of file qwindowsurface_qws.cpp.

{
    if (memsize)
        delete[] mem;
}

Functions

key()

QString QWSLocalMemSurface::key ( ) const

inlinevirtual

Implement this function to return a string that uniquely identifies the class of this surface.

See also

window(), isValid()

Implements QWSWindowSurface.

Definition at line 207 of file qwindowsurface_qws_p.h.

{ return QLatin1String("mem"); }

permanentState()

QByteArray QWSLocalMemSurface::permanentState ( ) const

virtual

Implement this function to return the data required for creating a server-side representation of the surface.

Since

4.3

See also

attach()

Reimplemented from QWSWindowSurface.

Definition at line 1011 of file qwindowsurface_qws.cpp.

{
    QByteArray array(sizeof(uchar*) + 3 * sizeof(int) + sizeof(SurfaceFlags), Qt::Uninitialized);

    char *ptr = array.data();

    *reinterpret_cast<uchar**>(ptr) = mem;
    ptr += sizeof(uchar*);

    reinterpret_cast<int*>(ptr)[0] = img.width();
    reinterpret_cast<int*>(ptr)[1] = img.height();
    ptr += 2 * sizeof(int);

    *reinterpret_cast<int *>(ptr) = img.format();
    ptr += sizeof(int);

    *reinterpret_cast<SurfaceFlags*>(ptr) = surfaceFlags();

    return array;
}

releaseSurface()

void QWSLocalMemSurface::releaseSurface ( )

virtual

Reimplemented from QWSWindowSurface.

Definition at line 1063 of file qwindowsurface_qws.cpp.

{
    if (memsize) {
        delete[] mem;
        memsize = 0;
    }
    mem = 0;
    img = QImage();
}

setGeometry()

void QWSLocalMemSurface::setGeometry ( const QRect &  rect )

virtual

Sets the currently allocated area to be the given rect.

This function is called whenever area covered by the top-level window changes.

See also

geometry()

Reimplemented from QWSWindowSurface.

Definition at line 969 of file qwindowsurface_qws.cpp.

{
    QSize size = rect.size();

    QWidget *win = window();
    if (win && !win->mask().isEmpty()) {
        const QRegion region = win->mask()
                               & rect.translated(-win->geometry().topLeft());
        size = region.boundingRect().size();
    }

    uchar *deleteLater = 0;

    if (img.size() != size) {
        if (size.isEmpty()) {
            if (memsize) {
                // In case of a Hide event we need to delete the memory after sending the
                // event to the server in order to let the server animate the event.
                deleteLater = mem;
                memsize = 0;
            }
            mem = 0;
            img = QImage();
        } else {
            const QImage::Format format = preferredImageFormat(win);
            const int bpl = nextMulOf4(bytesPerPixel(format) * size.width());
            const int imagesize = bpl * size.height();
            if (memsize < imagesize) {
                delete[] mem;
                memsize = imagesize;
                mem = new uchar[memsize];
            }
            img = QImage(mem, size.width(), size.height(), bpl, format);
            setImageMetrics(img, win);
        }
    }

    QWSWindowSurface::setGeometry(rect);

    delete[] deleteLater;
}

setPermanentState()

void QWSLocalMemSurface::setPermanentState ( const QByteArray &  data )

virtual

Implement this function to attach a server-side surface instance to the corresponding client side instance using the given data.

Since

4.3

Return true if successful; otherwise return false.

See also

data()

Reimplemented from QWSWindowSurface.

Definition at line 1032 of file qwindowsurface_qws.cpp.

{
    if (memsize) {
        delete[] mem;
        memsize = 0;
    }

    int width;
    int height;
    QImage::Format format;
    SurfaceFlags flags;

    const char *ptr = data.constData();

    mem = *reinterpret_cast<uchar* const*>(ptr);
    ptr += sizeof(uchar*);

    width = reinterpret_cast<const int*>(ptr)[0];
    height = reinterpret_cast<const int*>(ptr)[1];
    ptr += 2 * sizeof(int);

    format = QImage::Format(*reinterpret_cast<const int*>(ptr));
    ptr += sizeof(int);

    flags = *reinterpret_cast<const SurfaceFlags*>(ptr);

    const int bpl = nextMulOf4(bytesPerPixel(format) * width);
    QWSMemorySurface::img = QImage(mem, width, height, bpl, format);
    setSurfaceFlags(flags);
}

Properties

mem

uchar* QWSLocalMemSurface::mem

protected

Definition at line 213 of file qwindowsurface_qws_p.h.

Referenced by permanentState(), releaseSurface(), setGeometry(), setPermanentState(), and ~QWSLocalMemSurface().

memsize

int QWSLocalMemSurface::memsize

protected

Definition at line 214 of file qwindowsurface_qws_p.h.

Referenced by releaseSurface(), setGeometry(), setPermanentState(), and ~QWSLocalMemSurface().

---

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

• /src/gui/painting/qwindowsurface_qws_p.h
• /src/gui/painting/qwindowsurface_qws.cpp