WaylandSurface QML Type (Uncreatable)

Représente une zone rectangulaire sur un périphérique de sortie. En savoir plus...

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• bufferScale : size
• bufferSize : size
• client : WaylandClient
• contentOrientation : enum
• cursorSurface : bool
• destinationSize : size
• hasContent : bool
• inhibitsIdle : bool
• isOpaque : bool (since 6.4)
• origin : enum
• sourceGeometry : rect
• useTextureAlpha : bool

Signaux

• childAdded(WaylandSurface child)
• void dragStarted(WaylandDrag drag)
• surfaceDestroyed()

Méthodes

• void destroy()
• void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
• bool isDestroyed()

Description détaillée

Ce type encapsule une zone rectangulaire de pixels affichée sur un périphérique de sortie. Il correspond à l'interface wl_surface du protocole Wayland.

Documentation des propriétés

bufferScale : size [read-only]

Cette propriété contient l'échelle de la zone tampon de l'WaylandSurface. L'échelle de la zone tampon permet à un client de fournir des données de zone tampon à plus haute résolution destinées à être utilisées dans des sorties haute résolution.

bufferSize : size [read-only]

Cette propriété contient la taille du tampon actuel de cette WaylandSurface en pixels, et non en coordonnées de surface.

Pour obtenir la taille en coordonnées de surface, utilisez plutôt la propriété « destinationSize ».

Voir également destinationSize et bufferScale.

client : WaylandClient [read-only]

Cette propriété contient le client qui utilise cette adresse WaylandSurface.

contentOrientation : enum [read-only]

Cette propriété définit l'orientation du contenu de l'WaylandSurface.

Voir également WaylandOutput.transform.

cursorSurface : bool

Cette propriété s'applique que l'WaylandSurface e soit ou non une surface de curseur.

destinationSize : size [read-only]

Cette propriété contient la taille de cet WaylandSurface en coordonnées de surface.

Voir également « bufferScale » et « bufferSize ».

hasContent : bool [read-only]

Cette propriété indique si la surface dispose actuellement d'un tampon validé et non nul.

Voir également WaylandSurface::bufferSize.

inhibitsIdle : bool [read-only]

Cette propriété détermine si cette surface est destinée à empêcher le compositeur d'adopter un comportement en mode veille, tel que la mise en noir de l'écran, le verrouillage ou l'activation de l'économiseur d'écran.

Voir également IdleInhibitManagerV1.

isOpaque : bool [read-only, since 6.4]

Cette propriété s'applique que la surface soit entièrement opaque ou non, comme indiqué par le client via la requête `set_opaque_region`.

Cette propriété a été introduite dans Qt 6.4.

origin : enum [read-only]

Cette propriété contient l'origine du tampon de l'WaylandSurface, ou WaylandSurface.OriginTopLeft si la surface ne dispose pas de tampon.

Elle peut prendre les valeurs suivantes :

• WaylandSurface.OriginTopLeft : l'origine est le coin supérieur gauche du tampon.
• WaylandSurface.OriginBottomLeft : l'origine est le coin inférieur gauche du tampon.

sourceGeometry : rect [read-only]

Cette propriété décrit la partie du tampon Wayland associé qui doit être affichée à l'écran. Les coordonnées sont calculées à partir du coin du tampon et sont mises à l'échelle selon la formule bufferScale.

Voir également bufferScale, bufferSize et destinationSize.

useTextureAlpha : bool [default: true]

Cette propriété permet de déterminer si la surface doit utiliser l'alpha de la texture pour le mélange.

Lorsque l'option « true » est activée, le canal alpha de la surface sera utilisé pour le mélange ; lorsque l'option « false » est activée, la surface sera traitée comme opaque.

Documentation Signal

childAdded(WaylandSurface child)

Ce signal est émis lorsqu'un wl_subsurface, child, a été ajouté à la surface.

void dragStarted(WaylandDrag drag)

Ce signal est émis lorsqu'un « drag » a démarré depuis cette surface.

surfaceDestroyed()

Ce signal est émis lorsque la surface wl_surface correspondante est détruite.

Documentation de la méthode

void destroy()

Supprime l'WaylandSurface.

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

Initialise l'WaylandSurface avec les valeurs fournies pour compositor et client, ainsi qu'avec les valeurs fournies pour id et version.

bool isDestroyed()

Renvoie « true » si l’ WaylandSurface a été détruite. Sinon, renvoie « false ».