Back to Qt.io
Contact Us Blog Download Qt

WaylandSurface QML Type

Represents a rectangular area on an output device. More...

Import Statement: import QtWayland.Compositor 1.5
Instantiates: QWaylandSurface

Properties

Signals

Methods

Detailed Description

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

Property Documentation

[read-only] bufferScale : size

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


[read-only] bufferSize : size

This property holds the size of the current buffer of this WaylandSurface in pixels, not in surface coordinates.

For the size in surface coordinates, use destinationSize instead.

See also destinationSize and bufferScale.


[read-only] client : WaylandClient

This property holds the client using this WaylandSurface.


[read-only] contentOrientation : enum

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

See also WaylandOutput.transform.


cursorSurface : bool

This property holds whether the WaylandSurface is a cursor surface.


[read-only] destinationSize : size

This property holds the size of this WaylandSurface in surface coordinates.

See also bufferScale and bufferSize.


[read-only] hasContent : bool

This property holds whether the WaylandSurface has content.


[read-only] inhibitsIdle : bool

This property holds whether this surface is intended to inhibit the idle behavior of the compositor such as screen blanking, locking and screen saving.

See also IdleInhibitManagerV1.


[read-only, since 6.4] isOpaque : bool

This property holds whether the surface is fully opaque, as reported by the client through the set_opaque_region request.

This property was introduced in Qt 6.4.


[read-only] origin : enum

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

It can have the following values:

  • WaylandSurface.OriginTopLeft The origin is the top left corner of the buffer.
  • WaylandSurface.OriginBottomLeft The origin is the bottom left corner of the buffer.

[read-only] sourceGeometry : rect

This property describes the portion of the attached Wayland buffer that should be drawn on the screen. The coordinates are from the corner of the buffer and are scaled by bufferScale.

See also bufferScale, bufferSize, and destinationSize.


useTextureAlpha : bool

This property specifies whether the surface should use texture alpha.


Signal Documentation

childAdded(WaylandSurface child)

This signal is emitted when a wl_subsurface, child, has been added to the surface.

Note: The corresponding handler is onChildAdded.


void dragStarted(WaylandDrag drag)

This signal is emitted when a drag has started from this surface.

Note: The corresponding handler is onDragStarted.


surfaceDestroyed()

This signal is emitted when the corresponding wl_surface is destroyed.

Note: The corresponding handler is onSurfaceDestroyed.


Method Documentation

void destroy()

Destroys the WaylandSurface.


void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

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


bool isDestroyed()

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


© 2024 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.