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
| void | availableGeometryChanged() |
| void | compositorChanged() |
| void | geometryChanged() |
| void | manufacturerChanged() |
| void | modelChanged() |
| void | physicalSizeChanged() |
| void | positionChanged() |
| void | scaleFactorChanged() |
| void | sizeFollowsWindowChanged() |
| void | subpixelChanged() |
| void | transformChanged() |
| void | windowChanged() |
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`.
| Constante | Valor | Descripción |
|---|---|---|
QWaylandOutput::SubpixelUnknown | 0 | La disposición de subpíxeles no está definida. |
QWaylandOutput::SubpixelNone | 1 | No hay subpíxeles. |
QWaylandOutput::SubpixelHorizontalRgb | 2 | Los subpíxeles están dispuestos horizontalmente en el orden rojo, verde, azul. |
QWaylandOutput::SubpixelHorizontalBgr | 3 | Los subpíxeles están dispuestos horizontalmente en el orden azul, verde, rojo. |
QWaylandOutput::SubpixelVerticalRgb | 4 | Los subpíxeles están dispuestos verticalmente en el orden rojo, verde, azul. |
QWaylandOutput::SubpixelVerticalBgr | 5 | Los 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. * *
| Constante | Valor | Descripción |
|---|---|---|
QWaylandOutput::TransformNormal | 0 | La orientación es normal. * |
QWaylandOutput::Transform90 | 1 | La orientación está girada 90 grados. * |
QWaylandOutput::Transform180 | 2 | La orientación está girada 180 grados. * |
QWaylandOutput::Transform270 | 3 | La orientación está girada 270 grados. * |
QWaylandOutput::TransformFlipped | 4 | La orientación está invertida. * |
QWaylandOutput::TransformFlipped90 | 5 | La orientación está invertida y girada 90 grados. * |
QWaylandOutput::TransformFlipped180 | 6 | La orientación está reflejada y girada 180 grados. * |
QWaylandOutput::TransformFlipped270 | 7 | La 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.