QWaylandOutput Class
La classe QWaylandOutput représente une zone affichable gérée par le compositeur. Plus d'informations...
| En-tête : | #include <QWaylandOutput> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake : | QT += waylandcompositor |
| En QML : | WaylandOutput |
| Héritages : | QWaylandObject |
Types publics
| enum | Subpixel { SubpixelUnknown, SubpixelNone, SubpixelHorizontalRgb, SubpixelHorizontalBgr, SubpixelVerticalRgb, SubpixelVerticalBgr } |
| enum | Transform { TransformNormal, Transform90, Transform180, Transform270, TransformFlipped, …, TransformFlipped270 } |
Propriétés
|
|
Fonctions publiques
| 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 |
Signaux
| void | availableGeometryChanged() |
| void | compositorChanged() |
| void | geometryChanged() |
| void | manufacturerChanged() |
| void | modelChanged() |
| void | physicalSizeChanged() |
| void | positionChanged() |
| void | scaleFactorChanged() |
| void | sizeFollowsWindowChanged() |
| void | subpixelChanged() |
| void | transformChanged() |
| void | windowChanged() |
Membres publics statiques
| QWaylandOutput * | fromResource(wl_resource *resource) |
Description détaillée
Le QWaylandOutput gère une zone rectangulaire dans les limites de la géométrie du compositeur, afin de l'utiliser pour afficher le contenu du client. Il peut s'agir, par exemple, d'un écran géré par WaylandCompositor.
La classe correspond à l'interface wl_output du protocole Wayland.
Type de membre Documentation
enum QWaylandOutput::Subpixel
Ce type d'énumération est utilisé pour spécifier la disposition des sous-pixels d'un site QWaylandOutput.
| Constante | Valeur | Description |
|---|---|---|
QWaylandOutput::SubpixelUnknown | 0 | La disposition des sous-pixels n'est pas définie. |
QWaylandOutput::SubpixelNone | 1 | Il n'y a pas de sous-pixels. |
QWaylandOutput::SubpixelHorizontalRgb | 2 | Les sous-pixels sont disposés horizontalement dans l'ordre rouge, vert, bleu. |
QWaylandOutput::SubpixelHorizontalBgr | 3 | Les sous-pixels sont disposés horizontalement dans l'ordre bleu, vert, rouge. |
QWaylandOutput::SubpixelVerticalRgb | 4 | Les sous-pixels sont disposés verticalement dans l'ordre rouge, vert, bleu. |
QWaylandOutput::SubpixelVerticalBgr | 5 | Les sous-pixels sont disposés verticalement dans l'ordre bleu, vert, rouge. |
Voir aussi QWaylandOutput::subpixel.
enum QWaylandOutput::Transform
* * Ce type d'enum est utilisé pour spécifier l'orientation d'un QWaylandOutput. * *
| Constante | Valeur | Description |
|---|---|---|
QWaylandOutput::TransformNormal | 0 | L'orientation est normale. * |
QWaylandOutput::Transform90 | 1 | L'orientation est tournée de 90 degrés. * |
QWaylandOutput::Transform180 | 2 | L'orientation est tournée de 180 degrés. * |
QWaylandOutput::Transform270 | 3 | L'orientation est tournée de 270 degrés. * |
QWaylandOutput::TransformFlipped | 4 | L'orientation est réfléchie. * |
QWaylandOutput::TransformFlipped90 | 5 | L'orientation est inversée et tournée de 90 degrés. * |
QWaylandOutput::TransformFlipped180 | 6 | L'orientation est reflétée et tournée de 180 degrés. * |
QWaylandOutput::TransformFlipped270 | 7 | L'orientation est reflétée et tournée de 270 degrés. * * |
Voir aussi QWaylandOutput::transform.
Documentation sur les propriétés
availableGeometry : QRect
Cette propriété définit la géométrie du site QWaylandOutput disponible pour l'affichage du contenu. La géométrie disponible est dans l'espace des coordonnées de sortie, commence à 0,0 et est aussi grande que la sortie par défaut.
Fonctions d'accès :
| QRect | availableGeometry() const |
| void | setAvailableGeometry(const QRect &availableGeometry) |
Signal Notifier :
| void | availableGeometryChanged() |
Voir aussi QWaylandOutput::currentMode et QWaylandOutput::geometry.
compositor : QWaylandCompositor*
Cette propriété contient le compositeur affichant le contenu sur ce site QWaylandOutput.
Note : Cette propriété ne peut être définie qu'une seule fois, avant que le site QWaylandOutput n'ait été initialisé.
Fonctions d'accès :
| QWaylandCompositor * | compositor() const |
Notifier signal :
| void | compositorChanged() |
[read-only] geometry : QRect
Cette propriété contient la géométrie du site QWaylandOutput.
Fonctions d'accès :
| QRect | geometry() const |
Signal de notification :
| void | geometryChanged() |
Voir aussi QWaylandOutput::currentMode.
manufacturer : QString
Cette propriété contient une description textuelle du fabricant de l'écran géré par ce site QWaylandOutput.
Fonctions d'accès :
| QString | manufacturer() const |
| void | setManufacturer(const QString &manufacturer) |
Signal de notification :
| void | manufacturerChanged() |
model : QString
Cette propriété contient une description textuelle du modèle de l'écran géré par ce site QWaylandOutput.
Fonctions d'accès :
| QString | model() const |
| void | setModel(const QString &model) |
Signal de notification :
| void | modelChanged() |
physicalSize : QSize
Cette propriété indique la taille physique du site QWaylandOutput en millimètres.
Fonctions d'accès :
| QSize | physicalSize() const |
| void | setPhysicalSize(const QSize &size) |
Signal de notification :
| void | physicalSizeChanged() |
Voir aussi QWaylandOutput::geometry et QWaylandOutput::currentMode.
position : QPoint
Cette propriété indique la position de ce site QWaylandOutput dans le système de coordonnées du compositeur.
Fonctions d'accès :
| QPoint | position() const |
| void | setPosition(const QPoint &pt) |
Signal de notification :
| void | positionChanged() |
scaleFactor : int
Cette propriété définit le facteur par lequel QWaylandCompositor met à l'échelle les tampons de surface avant qu'ils ne soient affichés. Cette propriété est utilisée sur les périphériques de sortie à haute densité où le contenu non mis à l'échelle serait trop petit pour être pratique. Le client peut à son tour définir le facteur d'échelle de son tampon pour qu'il corresponde à la sortie s'il préfère fournir un contenu à haute résolution adapté au périphérique de sortie.
La valeur par défaut est 1 (pas de mise à l'échelle).
Fonctions d'accès :
| int | scaleFactor() const |
| void | setScaleFactor(int scale) |
Signal de notification :
| void | scaleFactorChanged() |
sizeFollowsWindow : bool
Cette propriété détermine si la taille du site QWaylandOutput correspond à la taille de sa fenêtre.
Si cette propriété est vraie, tous les modes précédemment ajoutés sont remplacés par un mode qui correspond à la taille de la fenêtre et au taux de rafraîchissement de l'écran.
La valeur par défaut est false.
Fonctions d'accès :
| bool | sizeFollowsWindow() const |
| void | setSizeFollowsWindow(bool follow) |
Notifier signal :
| void | sizeFollowsWindowChanged() |
subpixel : QWaylandOutput::Subpixel
Cette propriété contient la disposition des sous-pixels de ce site QWaylandOutput. La valeur par défaut est QWaylandOutput::SubpixelUnknown.
Fonctions d'accès :
| QWaylandOutput::Subpixel | subpixel() const |
| void | setSubpixel(const QWaylandOutput::Subpixel &subpixel) |
Signal de notification :
| void | subpixelChanged() |
transform : QWaylandOutput::Transform
Cette propriété définit la transformation que QWaylandCompositor applique à une surface pour compenser l'orientation de QWaylandOutput.
La valeur par défaut est QWaylandOutput::TransformNormal.
Fonctions d'accès :
| QWaylandOutput::Transform | transform() const |
| void | setTransform(const QWaylandOutput::Transform &transform) |
Signal de notification :
| void | transformChanged() |
window : QWindow*
Cette propriété contient le site QWindow pour ce site QWaylandOutput.
Fonctions d'accès :
| QWindow * | window() const |
| void | setWindow(QWindow *window) |
Signal du notificateur :
| void | windowChanged() |
Fonction membre Documentation
QWaylandOutput::QWaylandOutput(QWaylandCompositor *compositor, QWindow *window)
Construit un QWaylandOutput dans compositor et avec le window spécifié. La fonction create() doit être appelée sur le site compositor avant de construire un QWaylandOutput pour celui-ci.
L'objet QWaylandOutput est initialisé ultérieurement, en réaction à un événement. Il est alors ajouté en tant que sortie pour le site compositor. S'il s'agit du premier objet QWaylandOutput créé pour ce site compositor, il devient le site default output.
[override virtual noexcept] QWaylandOutput::~QWaylandOutput()
Détruit le site QWaylandOutput.
void QWaylandOutput::addMode(const QWaylandOutputMode &mode, bool preferred = false)
Ajoute le mode mode à la sortie et le marque comme préféré si preferred est true. Veuillez noter qu'il ne peut y avoir qu'un seul mode préféré.
QWaylandCompositor *QWaylandOutput::compositor() const
Renvoie le compositeur de cette QWaylandOutput.
Note : Fonction Getter pour le compositeur de propriétés.
QWaylandOutputMode QWaylandOutput::currentMode() const
Renvoie la taille de la sortie en pixels et le taux de rafraîchissement en mHz. Si le mode actuel n'est pas défini, il renvoie un mode invalide.
Voir aussi setCurrentMode(), QWaylandOutput::modes, et QWaylandOutputMode.
void QWaylandOutput::frameStarted()
Informe QWaylandOutput qu'une trame a commencé.
[static] QWaylandOutput *QWaylandOutput::fromResource(wl_resource *resource)
Retourne le QWaylandOutput correspondant au resource.
QList<QWaylandOutputMode> QWaylandOutput::modes() const
Renvoie la liste des modes.
void QWaylandOutput::sendFrameCallbacks()
Envoie les rappels de trame en attente.
void QWaylandOutput::setCurrentMode(const QWaylandOutputMode &mode)
Définit le mode actuel. Le mode mode doit avoir été ajouté précédemment.
Voir aussi currentMode(), QWaylandOutput::modes, et QWaylandOutputMode.
[virtual] void QWaylandOutput::update()
Planifie la livraison d'un QEvent::UpdateRequest à l'adresse window de QWaylandOutput.
Voir également 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.
