QWaylandOutput Class
Die Klasse „QWaylandOutput“ repräsentiert einen vom Compositor verwalteten Anzeigebereich. Mehr dazu...
| Header: | #include <QWaylandOutput> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| In QML: | WaylandOutput |
| Erbt von: | QWaylandObject |
Öffentliche Typen
| enum | Subpixel { SubpixelUnknown, SubpixelNone, SubpixelHorizontalRgb, SubpixelHorizontalBgr, SubpixelVerticalRgb, SubpixelVerticalBgr } |
| enum | Transform { TransformNormal, Transform90, Transform180, Transform270, TransformFlipped, …, TransformFlipped270 } |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
| 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 | 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 |
Signale
| void | availableGeometryChanged() |
| void | compositorChanged() |
| void | geometryChanged() |
| void | manufacturerChanged() |
| void | modelChanged() |
| void | physicalSizeChanged() |
| void | positionChanged() |
| void | scaleFactorChanged() |
| void | sizeFollowsWindowChanged() |
| void | subpixelChanged() |
| void | transformChanged() |
| void | windowChanged() |
Statische öffentliche Mitglieder
| QWaylandOutput * | fromResource(wl_resource *resource) |
Ausführliche Beschreibung
QWaylandOutput verwaltet einen rechteckigen Bereich innerhalb der Geometrie des Compositors, um ihn zur Darstellung von Client-Inhalten zu nutzen. Dies könnte beispielsweise ein Bildschirm sein, der von der Schnittstelle ` WaylandCompositor` verwaltet wird.
Die Klasse entspricht der Schnittstelle ` wl_output ` im Wayland-Protokoll.
Dokumentation zu den Mitgliedstypen
enum QWaylandOutput::Subpixel
Dieser Enum-Typ wird verwendet, um die Subpixel-Anordnung eines „ QWaylandOutput “ festzulegen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWaylandOutput::SubpixelUnknown | 0 | Die Subpixel-Anordnung ist nicht festgelegt. |
QWaylandOutput::SubpixelNone | 1 | Es sind keine Subpixel vorhanden. |
QWaylandOutput::SubpixelHorizontalRgb | 2 | Die Subpixel sind horizontal in der Reihenfolge Rot, Grün, Blau angeordnet. |
QWaylandOutput::SubpixelHorizontalBgr | 3 | Die Subpixel sind horizontal in der Reihenfolge Blau, Grün, Rot angeordnet. |
QWaylandOutput::SubpixelVerticalRgb | 4 | Die Subpixel sind vertikal in der Reihenfolge Rot, Grün, Blau angeordnet. |
QWaylandOutput::SubpixelVerticalBgr | 5 | Die Subpixel sind vertikal in der Reihenfolge Blau, Grün, Rot angeordnet. |
Siehe auch QWaylandOutput::subpixel.
enum QWaylandOutput::Transform
* * Dieser Enum-Typ dient zur Angabe der Ausrichtung eines „ QWaylandOutput “. * *
| Konstante | Wert | Beschreibung |
|---|---|---|
QWaylandOutput::TransformNormal | 0 | Die Ausrichtung ist normal. * |
QWaylandOutput::Transform90 | 1 | Die Ausrichtung ist um 90 Grad gedreht. * |
QWaylandOutput::Transform180 | 2 | Die Ausrichtung ist um 180 Grad gedreht. * |
QWaylandOutput::Transform270 | 3 | Die Ausrichtung ist um 270 Grad gedreht. * |
QWaylandOutput::TransformFlipped | 4 | Die Ausrichtung ist gespiegelt. * |
QWaylandOutput::TransformFlipped90 | 5 | Die Ausrichtung ist gespiegelt und um 90 Grad gedreht. * |
QWaylandOutput::TransformFlipped180 | 6 | Die Ausrichtung ist gespiegelt und um 180 Grad gedreht. * |
QWaylandOutput::TransformFlipped270 | 7 | Die Ausrichtung ist gespiegelt und um 270 Grad gedreht. * * |
Siehe auch QWaylandOutput::transform.
Dokumentation zu den Eigenschaften
availableGeometry : QRect
Diese Eigenschaft enthält die Geometrie des „ QWaylandOutput “, der für die Anzeige von Inhalten zur Verfügung steht. Die verfügbare Geometrie befindet sich im Ausgabekoordinatenraum, beginnt bei 0,0 und entspricht standardmäßig der Größe der Ausgabe.
Zugriffsfunktionen:
| QRect | availableGeometry() const |
| void | setAvailableGeometry(const QRect &availableGeometry) |
Benachrichtigungssignal:
| void | availableGeometryChanged() |
Siehe auch „ QWaylandOutput::currentMode “ und „ QWaylandOutput::geometry “.
compositor : QWaylandCompositor*
Diese Eigenschaft gibt den Compositor an, der Inhalte auf dieser QWaylandOutput anzeigt.
Hinweis: Diese Eigenschaft kann nur einmal gesetzt werden, und zwar bevor die „ QWaylandOutput “ initialisiert wurde.
Zugriffsfunktionen:
| QWaylandCompositor * | compositor() const |
Notifier-Signal:
| void | compositorChanged() |
[read-only] geometry : QRect
Diese Eigenschaft enthält die Geometrie des „ QWaylandOutput “.
Zugriffsfunktionen:
| QRect | geometry() const |
Benachrichtigungssignal:
| void | geometryChanged() |
Siehe auch „ QWaylandOutput::currentMode “.
manufacturer : QString
Diese Eigenschaft enthält eine textuelle Beschreibung des Herstellers des Displays, das von diesem QWaylandOutput verwaltet wird.
Zugriffsfunktionen:
| QString | manufacturer() const |
| void | setManufacturer(const QString &manufacturer) |
Benachrichtigungssignal:
| void | manufacturerChanged() |
model : QString
Diese Eigenschaft enthält eine textuelle Beschreibung des Modells der Anzeige, die von diesem QWaylandOutput verwaltet wird.
Zugriffsfunktionen:
| QString | model() const |
| void | setModel(const QString &model) |
Benachrichtigungssignal:
| void | modelChanged() |
physicalSize : QSize
Diese Eigenschaft enthält die physikalische Größe des „ QWaylandOutput “ in Millimetern.
Zugriffsfunktionen:
| QSize | physicalSize() const |
| void | setPhysicalSize(const QSize &size) |
Notifier-Signal:
| void | physicalSizeChanged() |
Siehe auch „ QWaylandOutput::geometry “ und „ QWaylandOutput::currentMode “.
position : QPoint
Diese Eigenschaft gibt die Position dieses QWaylandOutput im Koordinatensystem des Compositors an.
Zugriffsfunktionen:
| QPoint | position() const |
| void | setPosition(const QPoint &pt) |
Notifier-Signal:
| void | positionChanged() |
scaleFactor : int
Diese Eigenschaft enthält den Faktor, mit dem der „ QWaylandCompositor “ Oberflächenpuffer skaliert, bevor sie angezeigt werden. Dies wird bei Ausgabegeräten mit hoher Auflösung verwendet, bei denen nicht skalierte Inhalte zu klein wären, um praktisch nutzbar zu sein. Der Client kann seinerseits den Skalierungsfaktor seines Puffers so einstellen, dass er zur Ausgabe passt, wenn er hochauflösende Inhalte bereitstellen möchte, die für das Ausgabegerät geeignet sind.
Der Standardwert ist 1 (keine Skalierung).
Zugriffsfunktionen:
| int | scaleFactor() const |
| void | setScaleFactor(int scale) |
Benachrichtigungssignal:
| void | scaleFactorChanged() |
sizeFollowsWindow : bool
Diese Eigenschaft legt fest, ob die Größe des „ QWaylandOutput “ mit der Größe seines Fensters übereinstimmt.
Ist diese Eigenschaft auf „true“ gesetzt, werden alle zuvor hinzugefügten Modi durch einen Modus ersetzt, der der Fenstergröße und der Bildwiederholfrequenz des Bildschirms entspricht.
Der Standardwert ist „false“.
Zugriffsfunktionen:
| bool | sizeFollowsWindow() const |
| void | setSizeFollowsWindow(bool follow) |
Notifier-Signal:
| void | sizeFollowsWindowChanged() |
subpixel : QWaylandOutput::Subpixel
Diese Eigenschaft enthält die Subpixel-Anordnung dieses QWaylandOutput. Der Standardwert ist QWaylandOutput::SubpixelUnknown.
Zugriffsfunktionen:
| QWaylandOutput::Subpixel | subpixel() const |
| void | setSubpixel(const QWaylandOutput::Subpixel &subpixel) |
Benachrichtigungssignal:
| void | subpixelChanged() |
transform : QWaylandOutput::Transform
Diese Eigenschaft enthält die Transformation, die der „ QWaylandCompositor “ auf eine Oberfläche anwendet, um die Ausrichtung des „ QWaylandOutput “ auszugleichen.
Der Standardwert ist „ QWaylandOutput::TransformNormal “.
Zugriffsfunktionen:
| QWaylandOutput::Transform | transform() const |
| void | setTransform(const QWaylandOutput::Transform &transform) |
Benachrichtigungssignal:
| void | transformChanged() |
window : QWindow*
Diese Eigenschaft enthält die „ QWindow “ für diese „ QWaylandOutput “.
Zugriffsfunktionen:
| QWindow * | window() const |
| void | setWindow(QWindow *window) |
Benachrichtigungssignal:
| void | windowChanged() |
Dokumentation der Member-Funktionen
QWaylandOutput::QWaylandOutput(QWaylandCompositor *compositor, QWindow *window)
Erstellt ein `QWaylandOutput` in ` compositor ` und mit dem angegebenen ` window`. Die Funktion ` create()` muss für das ` compositor ` aufgerufen werden, bevor ein `QWaylandOutput` dafür erstellt wird.
Das QWaylandOutput-Objekt wird später als Reaktion auf ein Ereignis initialisiert. Zu diesem Zeitpunkt wird es als Ausgabe für das compositor hinzugefügt. Handelt es sich um das erste QWaylandOutput-Objekt, das für dieses compositor erstellt wurde, wird es zum default output.
[override virtual noexcept] QWaylandOutput::~QWaylandOutput()
Zerstört die „ QWaylandOutput “.
void QWaylandOutput::addMode(const QWaylandOutputMode &mode, bool preferred = false)
Fügt den Modus „ mode “ zur Ausgabe hinzu und markiert ihn als bevorzugt, sofern „ preferred “ auf „ true “ gesetzt ist. Bitte beachten Sie, dass es nur einen bevorzugten Modus geben kann.
QWaylandCompositor *QWaylandOutput::compositor() const
Gibt den Compositor für dieses ` QWaylandOutput` zurück.
Hinweis: Getter -Funktion für die Eigenschaft „compositor“.
QWaylandOutputMode QWaylandOutput::currentMode() const
Gibt die Größe der Ausgabe in Pixeln und die Bildwiederholfrequenz in mHz zurück. Wenn der aktuelle Modus nicht festgelegt ist, wird ein ungültiger Modus zurückgegeben.
Siehe auch setCurrentMode(), QWaylandOutput::modes und QWaylandOutputMode.
void QWaylandOutput::frameStarted()
Teilt „ QWaylandOutput “ mit, dass ein Frame gestartet wurde.
[static] QWaylandOutput *QWaylandOutput::fromResource(wl_resource *resource)
Gibt den „ QWaylandOutput “ zurück, der „ resource “ entspricht.
QList<QWaylandOutputMode> QWaylandOutput::modes() const
Gibt die Liste der Modi zurück.
void QWaylandOutput::sendFrameCallbacks()
Sendet ausstehende Frame-Callbacks.
void QWaylandOutput::setCurrentMode(const QWaylandOutputMode &mode)
Legt den aktuellen Modus fest. Das Modus- mode muss zuvor hinzugefügt worden sein.
Siehe auch currentMode(), QWaylandOutput::modes und QWaylandOutputMode.
[virtual] void QWaylandOutput::update()
Legt fest, dass ein „ QEvent::UpdateRequest “ an die E-Mail-Adresse window der „ QWaylandOutput “ gesendet wird.
Siehe auch QWindow::requestUpdate().
© 2026 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.
