QWaylandSurface Class

The QWaylandSurface class represents a rectangular area on an output device. More...

Header: #include <QWaylandSurface>
qmake: QT += waylandcompositor
Inherits: QWaylandObject

This class is under development and is subject to change.

Public Types

enum Origin { OriginTopLeft, OriginBottomLeft }


  • 1 property inherited from QObject

Public Functions

QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)
virtual ~QWaylandSurface()
int bufferScale() const
QWaylandClient *client() const
QWaylandCompositor *compositor() const
Qt::ScreenOrientation contentOrientation() const
void destroy()
void frameStarted()
void initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)
QWaylandInputMethodControl *inputMethodControl() const
bool inputRegionContains(const QPoint &p) const
bool isCursorSurface() const
bool isDestroyed() const
bool isInitialized() const
bool isMapped() const
void markAsCursorSurface(bool cursorSurface)
Origin origin() const
QWaylandSurfaceRole *role() const
void sendFrameCallbacks()
void setThrottlingView(QWaylandView *view)
QSize size() const
QWaylandView *throttlingView() const
QList<QWaylandView *> views() const

Public Slots

  • 1 public slot inherited from QObject


void bufferScaleChanged()
void childAdded(QWaylandSurface *child)
void configure(bool hasBuffer)
void contentOrientationChanged()
void damaged(const QRegion &rect)
void mappedChanged()
void offsetForNextFrame(const QPoint &offset)
void originChanged()
void parentChanged(QWaylandSurface *newParent, QWaylandSurface *oldParent)
void redraw()
void sizeChanged()
void subsurfacePlaceAbove(QWaylandSurface *sibling)
void subsurfacePlaceBelow(QWaylandSurface *sibling)
void subsurfacePositionChanged(const QPoint &position)
void surfaceDestroyed()

Additional Inherited Members

  • 11 static public members inherited from QObject
  • 9 protected functions inherited from QObject

Detailed Description

The QWaylandSurface class represents a rectangular area on an output device.

This class encapsulates a rectangular area of pixels that is displayed on an output device. It corresponds to the interface wl_surface in the Wayland protocol.

Member Type Documentation

enum QWaylandSurface::Origin

This enum type is used to specify the origin of a QWaylandSurface's buffer.

QWaylandSurface::OriginTopLeft0The origin is the top left corner of the buffer.
QWaylandSurface::OriginBottomLeft1The origin is the bottom left corner of the buffer.

Property Documentation

bufferScale : const int

This property holds the QWaylandSurface's buffer scale. The buffer scale lets a client supply higher resolution buffer data for use on high resolution outputs.

Access functions:

int bufferScale() const

Notifier signal:

void bufferScaleChanged()

client : QWaylandClient * const

This property holds the client using this QWaylandSurface.

Access functions:

QWaylandClient *client() const

contentOrientation : const Qt::ScreenOrientation

This property holds the orientation of the QWaylandSurface's contents.

Access functions:

Qt::ScreenOrientation contentOrientation() const

Notifier signal:

void contentOrientationChanged()

See also QWaylandOutput::transform.

cursorSurface : bool

This property holds whether the QWaylandSurface is a cursor surface.

Access functions:

bool isCursorSurface() const
void markAsCursorSurface(bool cursorSurface)

isMapped : const bool

This property holds whether the QWaylandSurface has content.

Access functions:

bool isMapped() const

Notifier signal:

void mappedChanged()

origin : const QWaylandSurface::Origin

This property holds the origin of the QWaylandSurface's buffer, or QWaylandSurface::OriginTopLeft if the surface has no buffer.

Access functions:

Origin origin() const

Notifier signal:

void originChanged()

size : const QSize

This property holds the QWaylandSurface's size in pixels.

Access functions:

QSize size() const

Notifier signal:

void sizeChanged()

Member Function Documentation


Constructs a an uninitialized QWaylandSurface.

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Constructs and initializes a QWaylandSurface for the given compositor and client, and with the given id and version.

[virtual] QWaylandSurface::~QWaylandSurface()

Destroys the QWaylandSurface.

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

QWaylandCompositor *QWaylandSurface::compositor() const

Returns the compositor for this QWaylandSurface.

[signal] void QWaylandSurface::configure(bool hasBuffer)

[signal] void QWaylandSurface::damaged(const QRegion &rect)

void QWaylandSurface::destroy()

Destroys the QWaylandSurface.

void QWaylandSurface::frameStarted()

Prepares all frame callbacks for sending.

void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Initializes the QWaylandSurface with the given compositor and client, and with the given id and version.

QWaylandInputMethodControl *QWaylandSurface::inputMethodControl() const

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

Returns true if the QWaylandSurface's input region contains the point p. Otherwise returns false.

bool QWaylandSurface::isDestroyed() const

Returns true if the QWaylandSurface has been destroyed. Otherwise returns false.

bool QWaylandSurface::isInitialized() const

Returns true if the QWaylandSurface has been initialized.

[signal] void QWaylandSurface::offsetForNextFrame(const QPoint &offset)

[signal] void QWaylandSurface::parentChanged(QWaylandSurface *newParent, QWaylandSurface *oldParent)

[signal] void QWaylandSurface::redraw()

QWaylandSurfaceRole *QWaylandSurface::role() const

void QWaylandSurface::sendFrameCallbacks()

Sends pending frame callbacks.

void QWaylandSurface::setThrottlingView(QWaylandView *view)

Sets this QWaylandSurface's throttling view to view, in case there are multiple views of this surface. The throttling view is the view that governs the client's refresh rate. It takes care of discarding buffer references when QWaylandView::advance() is called. See the documentation for QWaylandView::advance() for more details.

See also throttlingView() and QWaylandView::advance().

[signal] void QWaylandSurface::subsurfacePlaceAbove(QWaylandSurface *sibling)

[signal] void QWaylandSurface::subsurfacePlaceBelow(QWaylandSurface *sibling)

[signal] void QWaylandSurface::subsurfacePositionChanged(const QPoint &position)

[signal] void QWaylandSurface::surfaceDestroyed()

QWaylandView *QWaylandSurface::throttlingView() const

Returns this QWaylandSurface's throttling view.

See also setThrottlingView() and QWaylandView::advance().

[slot] void QWaylandSurface::updateSelection()

Updates the surface with the compositor's retained clipboard selection. Although this is done automatically when the surface receives keyboard focus, this function is useful for updating clients which do not have keyboard focus.

QList<QWaylandView *> QWaylandSurface::views() const

Returns the views for this QWaylandSurface.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.