En esta página

QWaylandOutput Class

La clase `QWaylandOutput` representa un área de visualización gestionada por el compositor. Más información...

Encabezado: #include <QWaylandOutput>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
En QML: WaylandOutput
Heredan de: QWaylandObject

Tipos públicos

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

Propiedades

Funciones públicas

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

Señales

Miembros públicos estáticos

QWaylandOutput *fromResource(wl_resource *resource)

Descripción detallada

QWaylandOutput gestiona un área rectangular dentro de los límites de la geometría del compositor, para utilizarla en la visualización del contenido del cliente. Esto podría ser, por ejemplo, una pantalla gestionada por la interfaz WaylandCompositor.

La clase se corresponde con la interfaz « wl_output » del protocolo Wayland.

Documentación sobre los tipos de miembros

enum QWaylandOutput::Subpixel

Este tipo de enumeración se utiliza para especificar la disposición de los subpíxeles de un ` QWaylandOutput`.

ConstanteValorDescripción
QWaylandOutput::SubpixelUnknown0La disposición de subpíxeles no está definida.
QWaylandOutput::SubpixelNone1No hay subpíxeles.
QWaylandOutput::SubpixelHorizontalRgb2Los subpíxeles están dispuestos horizontalmente en el orden rojo, verde, azul.
QWaylandOutput::SubpixelHorizontalBgr3Los subpíxeles están dispuestos horizontalmente en el orden azul, verde, rojo.
QWaylandOutput::SubpixelVerticalRgb4Los subpíxeles están dispuestos verticalmente en el orden rojo, verde, azul.
QWaylandOutput::SubpixelVerticalBgr5Los subpíxeles están dispuestos verticalmente en el orden azul, verde, rojo.

Véase también QWaylandOutput::subpixel.

enum QWaylandOutput::Transform

* * Este tipo de enumeración se utiliza para especificar la orientación de un QWaylandOutput. * *

ConstanteValorDescripción
QWaylandOutput::TransformNormal0La orientación es normal. *
QWaylandOutput::Transform901La orientación está girada 90 grados. *
QWaylandOutput::Transform1802La orientación está girada 180 grados. *
QWaylandOutput::Transform2703La orientación está girada 270 grados. *
QWaylandOutput::TransformFlipped4La orientación está invertida. *
QWaylandOutput::TransformFlipped905La orientación está invertida y girada 90 grados. *
QWaylandOutput::TransformFlipped1806La orientación está reflejada y girada 180 grados. *
QWaylandOutput::TransformFlipped2707La orientación está reflejada y girada 270 grados. * *

Véase también QWaylandOutput::transform.

Documentación de la propiedad

availableGeometry : QRect

Esta propiedad contiene la geometría del objeto « QWaylandOutput » disponible para mostrar contenido. La geometría disponible se encuentra en el espacio de coordenadas de salida, comienza en (0,0) y, por defecto, tiene el mismo tamaño que la salida.

Funciones de acceso:

QRect availableGeometry() const
void setAvailableGeometry(const QRect &availableGeometry)

Señal de notificación:

void availableGeometryChanged()

Véase también « QWaylandOutput::currentMode » y « QWaylandOutput::geometry ».

compositor : QWaylandCompositor*

Esta propiedad indica que el compositor muestra contenido en este QWaylandOutput.

Nota: Esta propiedad solo se puede establecer una vez, antes de que se haya inicializado el QWaylandOutput.

Funciones de acceso:

QWaylandCompositor *compositor() const

Señal del notificador:

void compositorChanged()

[read-only] geometry : QRect

Esta propiedad contiene la geometría del « QWaylandOutput ».

Funciones de acceso:

QRect geometry() const

Señal de notificación:

void geometryChanged()

Véase también QWaylandOutput::currentMode.

manufacturer : QString

Esta propiedad contiene una descripción textual del fabricante de la pantalla gestionada por este QWaylandOutput.

Funciones de acceso:

QString manufacturer() const
void setManufacturer(const QString &manufacturer)

Señal de notificación:

void manufacturerChanged()

model : QString

Esta propiedad contiene una descripción textual del modelo de la pantalla gestionada por este QWaylandOutput.

Funciones de acceso:

QString model() const
void setModel(const QString &model)

Señal de notificación:

void modelChanged()

physicalSize : QSize

Esta propiedad contiene el tamaño físico del « QWaylandOutput » en milímetros.

Funciones de acceso:

QSize physicalSize() const
void setPhysicalSize(const QSize &size)

Señal de Notifier:

void physicalSizeChanged()

Véase también « QWaylandOutput::geometry » y « QWaylandOutput::currentMode ».

position : QPoint

Esta propiedad indica la posición de este QWaylandOutput en el sistema de coordenadas del compositor.

Funciones de acceso:

QPoint position() const
void setPosition(const QPoint &pt)

Señal de notificación:

void positionChanged()

scaleFactor : int

Esta propiedad contiene el factor por el que el « QWaylandCompositor » escala los búferes de superficie antes de mostrarlos. Se utiliza en dispositivos de salida de alta densidad, en los que el contenido sin escalar resultaría demasiado pequeño para ser práctico. A su vez, el cliente puede establecer el factor de escala de su búfer para que se adapte a la salida, si prefiere proporcionar contenido de alta resolución adecuado para el dispositivo de salida.

El valor por defecto es 1 (sin escalado).

Funciones de acceso:

int scaleFactor() const
void setScaleFactor(int scale)

Señal de notificación:

void scaleFactorChanged()

sizeFollowsWindow : bool

Esta propiedad controla si el tamaño del « QWaylandOutput » se ajusta al tamaño de su ventana.

Si esta propiedad es «true», todos los modos añadidos anteriormente se sustituyen por un modo que se adapta al tamaño de la ventana y a la frecuencia de actualización de la pantalla.

El valor por defecto es «false».

Funciones de acceso:

bool sizeFollowsWindow() const
void setSizeFollowsWindow(bool follow)

Señal del notificador:

void sizeFollowsWindowChanged()

subpixel : QWaylandOutput::Subpixel

Esta propiedad contiene la disposición de subpíxeles de este QWaylandOutput. El valor por defecto es QWaylandOutput::SubpixelUnknown.

Funciones de acceso:

QWaylandOutput::Subpixel subpixel() const
void setSubpixel(const QWaylandOutput::Subpixel &subpixel)

Señal de notificación:

void subpixelChanged()

transform : QWaylandOutput::Transform

Esta propiedad contiene la transformación que el « QWaylandCompositor » aplica a una superficie para compensar la orientación del « QWaylandOutput ».

El valor por defecto es QWaylandOutput::TransformNormal.

Funciones de acceso:

QWaylandOutput::Transform transform() const
void setTransform(const QWaylandOutput::Transform &transform)

Señal de notificación:

void transformChanged()

window : QWindow*

Esta propiedad contiene el « QWindow » correspondiente a este « QWaylandOutput ».

Funciones de acceso:

QWindow *window() const
void setWindow(QWindow *window)

Señal de notificación:

void windowChanged()

Documentación de funciones de miembro

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

Crea un objeto `QWaylandOutput` en ` compositor ` y con el ` window` especificado. La función ` create()` debe llamarse en el ` compositor ` antes de crear un `QWaylandOutput` para él.

El objeto QWaylandOutput se inicializa más tarde, en respuesta a un evento. En ese momento, se añade como salida para el compositor. Si es el primer objeto QWaylandOutput creado para este compositor, se convierte en el default output.

[override virtual noexcept] QWaylandOutput::~QWaylandOutput()

Destruye el « QWaylandOutput ».

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

Añade el modo « mode » a la salida y lo marca como preferido si « preferred » es « true ». Ten en cuenta que solo puede haber un modo preferido.

QWaylandCompositor *QWaylandOutput::compositor() const

Devuelve el compositor de este ` QWaylandOutput`.

Nota: Funcióngetter para la propiedad «compositor».

QWaylandOutputMode QWaylandOutput::currentMode() const

Devuelve el tamaño de la salida en píxeles y la frecuencia de actualización en mHz. Si el modo actual no está configurado, devolverá un modo no válido.

Véase también setCurrentMode(), QWaylandOutput::modes y QWaylandOutputMode.

void QWaylandOutput::frameStarted()

Notifica a « QWaylandOutput » que se ha iniciado un fotograma.

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

Devuelve el objeto ` QWaylandOutput ` correspondiente a ` resource`.

QList<QWaylandOutputMode> QWaylandOutput::modes() const

Devuelve la lista de modos.

void QWaylandOutput::sendFrameCallbacks()

Envía las llamadas de retorno de los fotogramas pendientes.

void QWaylandOutput::setCurrentMode(const QWaylandOutputMode &mode)

Establece el modo actual. El modo mode debe haberse añadido previamente.

Véase también currentMode(), QWaylandOutput::modes y QWaylandOutputMode.

[virtual] void QWaylandOutput::update()

Programa un « QEvent::UpdateRequest » para que se envíe a window, de la QWaylandOutput.

Véase también 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.