Sur cette page

WaylandOutput QML Type (Uncreatable)

Permet d'accéder à une zone d'affichage gérée par le compositeur. En savoir plus...

Import Statement: import QtWayland.Compositor
In C++: QWaylandOutput

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

Propriétés

Description détaillée

Le WaylandOutput 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 l'WaylandCompositor.

Le type correspond à l’interface ` wl_output ` du protocole Wayland.

Remarque : si le compositeur dispose de plusieurs sorties Wayland, l’attribut ` Qt::AA_ShareOpenGLContexts ` doit être défini avant la construction de l’objet ` QGuiApplication `.

Documentation sur les propriétés

automaticFrameCallback : bool [default: true]

Cette propriété indique si l'WaylandOutput envoie automatiquement des callbacks de trame lors du rendu.

availableGeometry : rect

Cette propriété contient la géométrie de l'WaylandOutput, qui permet d'afficher du contenu. La géométrie disponible est définie dans l'espace de coordonnées de sortie, commence à 0,0 et, par défaut, couvre toute la surface de sortie.

Voir également QWaylandOutput::geometry.

compositor : WaylandCompositor

Cette propriété détermine le compositeur chargé d'afficher le contenu de cette WaylandOutput.

Remarque : cette propriété ne peut être définie qu'une seule fois, avant que le composant « WaylandOutput » ne soit finalisé.

geometry : rect [read-only]

Cette propriété contient la géométrie de l'WaylandOutput.

manufacturer : string

Cette propriété contient une description textuelle du fabricant de l'écran géré par ce site WaylandOutput.

model : string

Cette propriété contient une description textuelle du modèle de l'écran géré par cette WaylandOutput.

physicalSize : size

Cette propriété contient la taille physique de l'WaylandOutput, exprimée en millimètres.

Voir également « QWaylandOutput::geometry ».

position : point

Cette propriété indique la position de cet WaylandOutput dans le système de coordonnées du compositeur.

scaleFactor : int

Cette propriété contient le facteur de mise à l'échelle utilisé par l'WaylandCompositor pour redimensionner les tampons de surface avant leur affichage. Elle est utilisée sur les périphériques de sortie à haute densité, où un contenu non redimensionné serait trop petit pour être exploitable. Le client peut à son tour définir le facteur d'échelle de son tampon afin de l'adapter à la sortie s'il préfère fournir un contenu en haute résolution adapté au périphérique de sortie.

La valeur par défaut est 1 (pas de mise à l'échelle).

sizeFollowsWindow : bool [default: false]

Cette propriété détermine si la taille de l’ WaylandOutput correspond à celle de sa fenêtre.

Si cette propriété est définie sur « true », tous les modes précédemment ajoutés sont remplacés par un mode adapté à la taille de la fenêtre et à la fréquence de rafraîchissement de l’écran. Cela s’avère particulièrement utile dans une configuration de compositeurs imbriqués pendant le développement.

subpixel : enum

Cette propriété contient la configuration des sous-pixels de cet WaylandOutput.

  • WaylandOutput.SubpixelUnknown La disposition des sous-pixels n'est pas définie.
  • WaylandOutput.SubpixelNone Il n'y a pas de sous-pixels.
  • WaylandOutput.SubpixelHorizontalRgb Les sous-pixels sont disposés horizontalement dans l'ordre rouge, vert, bleu.
  • WaylandOutput.SubpixelHorizontalBgr Les sous-pixels sont disposés horizontalement dans l'ordre bleu, vert, rouge.
  • WaylandOutput.SubpixelVerticalRgb Les sous-pixels sont disposés verticalement dans l'ordre rouge, vert, bleu.
  • WaylandOutput.SubpixelVerticalBgr Les sous-pixels sont disposés verticalement dans l'ordre bleu, vert, rouge.

La valeur par défaut est WaylandOutput.SubpixelUnknown.

transform : enum

Cette propriété contient la transformation que l'QWaylandCompositor applique à une surface afin de compenser l'orientation de l'QWaylandOutput.

  • WaylandOutput.TransformNormal L'orientation est normale.
  • WaylandOutput.Transform90 L'orientation est pivotée de 90 degrés.
  • WaylandOutput.Transform180 L'orientation est pivotée de 180 degrés.
  • WaylandOutput.Transform270 L'orientation est pivotée de 270 degrés.
  • WaylandOutput.TransformFlipped L'orientation est inversée.
  • WaylandOutput.TransformFlipped90 L'orientation est inversée, puis pivotée de 90 degrés.
  • WaylandOutput.TransformFlipped180 L'orientation est inversée, puis pivotée de 180 degrés.
  • WaylandOutput.TransformFlipped270 L'orientation est inversée, puis pivotée de 270 degrés.

La valeur par défaut est WaylandOutput.TransformNormal.

window : Window

Cette propriété contient la fenêtre associée à cette instance de ` WaylandOutput`.

Remarque : cette propriété ne peut être définie qu'une seule fois, avant que le composant « WaylandOutput » ne soit finalisé.

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