QWaylandOutput Class

The QWaylandOutput class represents a displayable area managed by the compositor. More...

Header:	#include <QWaylandOutput>
qmake:	QT += waylandcompositor
Since:	Qt 5.8
Inherits:	QWaylandObject

• List of all members, including inherited members
• Obsolete members

Public Types

enum	Subpixel { SubpixelUnknown, SubpixelNone, SubpixelHorizontalRgb, SubpixelHorizontalBgr, SubpixelVerticalRgb, SubpixelVerticalBgr }
enum	Transform { TransformNormal, Transform90, Transform180, Transform270, ..., TransformFlipped270 }

Properties

availableGeometry : QRect compositor : QWaylandCompositor* const geometry : const QRect manufacturer : QString model : QString physicalSize : QSize

position : QPoint scaleFactor : int sizeFollowsWindow : bool subpixel : QWaylandOutput::Subpixel transform : QWaylandOutput::Transform window : QWindow*

• 1 property inherited from QObject

Public Functions

	QWaylandOutput()
	QWaylandOutput(QWaylandCompositor *compositor, QWindow *window)
virtual	~QWaylandOutput() override
void	addMode(const QWaylandOutputMode &mode, bool preferred = false)
QRect	availableGeometry() const
QWaylandCompositor *	compositor() const
QWaylandOutputMode	currentMode() const
void	frameStarted()
QRect	geometry() const
QString	manufacturer() const
QString	model() const
QList<QWaylandOutputMode>	modes() const
QSize	physicalSize() const
bool	physicalSizeFollowsSize() const
QPoint	position() const
int	scaleFactor() const
void	sendFrameCallbacks()
void	setAvailableGeometry(const QRect &availableGeometry)
void	setCurrentMode(const QWaylandOutputMode &mode)
void	setManufacturer(const QString &manufacturer)
void	setModel(const QString &model)
void	setPhysicalSize(const QSize &size)
void	setPhysicalSizeFollowsSize(bool follow)
void	setPosition(const QPoint &pt)
void	setScaleFactor(int scale)
void	setSizeFollowsWindow(bool follow)
void	setSubpixel(const QWaylandOutput::Subpixel &subpixel)
void	setTransform(const QWaylandOutput::Transform &transform)
void	setWindow(QWindow *window)
bool	sizeFollowsWindow() const
QWaylandOutput::Subpixel	subpixel() const
QWaylandOutput::Transform	transform() const
virtual void	update()
QWindow *	window() const

• 31 public functions inherited from QObject

Signals

void	availableGeometryChanged()
void	compositorChanged()
void	currentModeChanged()
void	geometryChanged()
void	manufacturerChanged()
void	modeAdded()
void	modelChanged()
void	physicalSizeChanged()
void	physicalSizeFollowsSizeChanged()
void	positionChanged()
void	scaleFactorChanged()
void	sizeFollowsWindowChanged()
void	subpixelChanged()
void	transformChanged()
void	windowChanged()
void	windowDestroyed()

• 2 signals inherited from QObject

Static Public Members

QWaylandOutput *	fromResource(wl_resource *resource)
const QMetaObject	staticMetaObject

• 9 static public members inherited from QObject

Additional Inherited Members

• 1 public slot inherited from QObject
• 9 protected functions inherited from QObject

Detailed Description

The QWaylandOutput class represents a displayable area managed by the compositor.

The QWaylandOutput manages a rectangular area within bounds of the compositor's geometry, to use it for displaying client content. This could, for instance, be a screen managed by the WaylandCompositor.

The class corresponds to the wl_output interface in the Wayland protocol.

Member Type Documentation

enum QWaylandOutput::Subpixel

This enum type is used to specify the subpixel arrangement of a QWaylandOutput.

Constant	Value	Description
QWaylandOutput::SubpixelUnknown	0	The subpixel arrangement is not set.
QWaylandOutput::SubpixelNone	1	There are no subpixels.
QWaylandOutput::SubpixelHorizontalRgb	2	The subpixels are arranged horizontally in red, green, blue order.
QWaylandOutput::SubpixelHorizontalBgr	3	The subpixels are arranged horizontally in blue, green, red order.
QWaylandOutput::SubpixelVerticalRgb	4	The subpixels are arranged vertically in red, green, blue order.
QWaylandOutput::SubpixelVerticalBgr	5	The subpixels are arranged vertically in blue, green, red order.

See also QWaylandOutput::subpixel.

enum QWaylandOutput::Transform

* * This enum type is used to specify the orientation of a QWaylandOutput. * *

Constant	Value	Description
QWaylandOutput::TransformNormal	0	The orientation is normal. *
QWaylandOutput::Transform90	1	The orientation is rotated 90 degrees. *
QWaylandOutput::Transform180	2	The orientation is rotated 180 degrees. *
QWaylandOutput::Transform270	3	The orientation is rotated 270 degrees. *
QWaylandOutput::TransformFlipped	4	The orientation is mirrored. *
QWaylandOutput::TransformFlipped90	5	The orientation is mirrored, and rotated 90 degrees. *
QWaylandOutput::TransformFlipped180	6	The orientation is mirrored, and rotated 180 degrees. *
QWaylandOutput::TransformFlipped270	7	The orientation is mirrored, and rotated 270 degrees. * *

See also QWaylandOutput::transform.

Member Function Documentation

QWaylandOutput::QWaylandOutput()

Default constructs an instance of QWaylandOutput.

QWaylandOutput::QWaylandOutput(QWaylandCompositor *compositor, QWindow *window)

Constructs a QWaylandOutput in compositor and with the specified window. The create() function must be called on the compositor before constructing a QWaylandOutput for it.

The QWaylandOutput object is initialized later, in reaction to an event. At this point it is added as an output for the compositor. If it is the first QWaylandOutput object created for this compositor, it becomes the default output.

[override virtual] QWaylandOutput::~QWaylandOutput()

Destroys the QWaylandOutput.

void QWaylandOutput::addMode(const QWaylandOutputMode &mode, bool preferred = false)

Adds the mode mode to the output and mark it as preferred if preferred is true. Please note there can only be one preferred mode.

QWaylandCompositor *QWaylandOutput::compositor() const

Returns the compositor for this QWaylandOutput.

Note: Getter function for property compositor.

QWaylandOutputMode QWaylandOutput::currentMode() const

Returns the output's size in pixels and refresh rate in mHz. If the current mode is not set it will return an invalid mode.

See also setCurrentMode(), QWaylandOutput::modes, and QWaylandOutputMode.

[signal] void QWaylandOutput::currentModeChanged()

void QWaylandOutput::frameStarted()

Informs QWaylandOutput that a frame has started.

[static] QWaylandOutput *QWaylandOutput::fromResource(wl_resource *resource)

Returns the QWaylandOutput corresponding to resource.

[signal] void QWaylandOutput::modeAdded()

QList<QWaylandOutputMode> QWaylandOutput::modes() const

Returns the list of modes.

bool QWaylandOutput::physicalSizeFollowsSize() const

See also setPhysicalSizeFollowsSize().

[signal] void QWaylandOutput::physicalSizeFollowsSizeChanged()

void QWaylandOutput::sendFrameCallbacks()

Sends pending frame callbacks.

void QWaylandOutput::setCurrentMode(const QWaylandOutputMode &mode)

Sets the current mode. The mode mode must have been previously added.

See also currentMode(), QWaylandOutput::modes, and QWaylandOutputMode.

void QWaylandOutput::setPhysicalSizeFollowsSize(bool follow)

See also physicalSizeFollowsSize().

[virtual] void QWaylandOutput::update()

Schedules a QEvent::UpdateRequest to be delivered to the QWaylandOutput's window.

See also QWindow::requestUpdate().

[signal] void QWaylandOutput::windowDestroyed()