QWSSharedMemSurface Class Reference

#include <qwindowsurface_qws_p.h>

Inheritance diagram for QWSSharedMemSurface:

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...
	QWSSharedMemSurface ()
	QWSSharedMemSurface (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...
	~QWSSharedMemSurface ()
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...

Private Functions
bool	setMemory (int memId)

Properties
QWSSharedMemory	mem

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
Protected Variables inherited from QWSMemorySurface
QImage	img
QWSLock *	memlock
QMutex	threadLock

Detailed Description

Definition at line 218 of file qwindowsurface_qws_p.h.

Constructors and Destructors

QWSSharedMemSurface() [1/2]

QWSSharedMemSurface::QWSSharedMemSurface

(

)

Definition at line 1075 of file qwindowsurface_qws.cpp.

    : QWSMemorySurface()
{
}

QWSSharedMemSurface() [2/2]

QWSSharedMemSurface::QWSSharedMemSurface

(

QWidget *

widget

)

Definition at line 1080 of file qwindowsurface_qws.cpp.

    : QWSMemorySurface(widget)
{
}

~QWSSharedMemSurface()

QWSSharedMemSurface::~QWSSharedMemSurface

(

)

Definition at line 1085 of file qwindowsurface_qws.cpp.

{
    // mem.detach() is done automatically by ~QSharedMemory
}

Functions

key()

QString QWSSharedMemSurface::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 227 of file qwindowsurface_qws_p.h.

{ return QLatin1String("shm"); }

permanentState()

QByteArray QWSSharedMemSurface::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 1192 of file qwindowsurface_qws.cpp.

{
    QByteArray array(6 * sizeof(int), Qt::Uninitialized);

    int *ptr = reinterpret_cast<int*>(array.data());

    ptr[0] = mem.id();
    ptr[1] = img.width();
    ptr[2] = img.height();
    ptr[3] = (memlock ? memlock->id() : -1);
    ptr[4] = int(img.format());
    ptr[5] = int(surfaceFlags());

    return array;
}

releaseSurface()

void QWSSharedMemSurface::releaseSurface ( )

virtual

Reimplemented from QWSWindowSurface.

Definition at line 1208 of file qwindowsurface_qws.cpp.

{
    mem.detach();
    img = QImage();
}

setGeometry()

void QWSSharedMemSurface::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 1155 of file qwindowsurface_qws.cpp.

{
    const QSize size = rect.size();
    if (img.size() != size) {
        if (size.isEmpty()) {
            mem.detach();
            img = QImage();
        } else {
            QWidget *win = window();
            const QImage::Format format = preferredImageFormat(win);
            const int bpl = nextMulOf4(bytesPerPixel(format) * size.width());
#ifdef QT_QWS_CLIENTBLIT
            const int imagesize = bpl * size.height() + sizeof(uint);
#else
            const int imagesize = bpl * size.height();
#endif
            if (mem.size() < imagesize) {
                mem.detach();
                if (!mem.create(imagesize)) {
                    perror("QWSSharedMemSurface::setGeometry allocating shared memory");
                    qFatal("Error creating shared memory of size %d", imagesize);
                }
            }
#ifdef QT_QWS_CLIENTBLIT
            *((uint *)mem.address()) = 0;
            uchar *base = static_cast<uchar*>(mem.address()) + sizeof(uint);
#else
            uchar *base = static_cast<uchar*>(mem.address());
#endif
            img = QImage(base, size.width(), size.height(), bpl, format);
            setImageMetrics(img, win);
        }
    }

    QWSWindowSurface::setGeometry(rect);
}

setMemory()

bool QWSSharedMemSurface::setMemory ( int  memId )

private

Definition at line 1090 of file qwindowsurface_qws.cpp.

Referenced by setPermanentState().

{
    if (mem.id() == memId)
        return true;

    mem.detach();

    if (memId != -1 && !mem.attach(memId)) {
#ifndef QT_NO_DEBUG
        perror("QWSSharedMemSurface: attaching to shared memory");
        qCritical("QWSSharedMemSurface: Error attaching to shared memory 0x%x", memId);
#endif
        return false;
    }

    return true;
}

setPermanentState()

void QWSSharedMemSurface::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 1124 of file qwindowsurface_qws.cpp.

{
    int memId;
    int width;
    int height;
    int lockId;
    QImage::Format format;
    SurfaceFlags flags;

    const int *ptr = reinterpret_cast<const int*>(data.constData());

    memId = ptr[0];
    width = ptr[1];
    height = ptr[2];
    lockId = ptr[3];
    format = QImage::Format(ptr[4]);
    flags = SurfaceFlags(ptr[5]);

    setSurfaceFlags(flags);
    setMemory(memId);
    setLock(lockId);

#ifdef QT_QWS_CLIENTBLIT
    uchar *base = static_cast<uchar*>(mem.address()) + sizeof(uint);
#else
    uchar *base = static_cast<uchar*>(mem.address());
#endif
    const int bpl = nextMulOf4(bytesPerPixel(format) * width);
    QWSMemorySurface::img = QImage(base, width, height, bpl, format);
}

Properties

mem

QWSSharedMemory QWSSharedMemSurface::mem

private

Definition at line 241 of file qwindowsurface_qws_p.h.

Referenced by permanentState(), releaseSurface(), setGeometry(), setMemory(), and setPermanentState().

---

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

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