Класс QWaylandOutput
Класс QWaylandOutput представляет область отображения, управляемую композитором. Подробнее...
| Заголовок: | #include <QWaylandOutput> |
| CMake: | find_package(Qt6 COMPONENTS Waylandcompositor REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Waylandcompositor) |
| qmake: | QT += waylandcompositor |
| С момента: | Qt 5.8 |
| Инициализируется: | WaylandOutput |
| Наследует: | QWaylandObject |
Типы
| Перечисление | Subpixel { SubpixelUnknown, SubpixelNone, SubpixelHorizontalRgb, SubpixelHorizontalBgr, SubpixelVerticalRgb, SubpixelVerticalBgr } |
| Перечисление | Преобразование { TransformNormal, Transform90, Transform180, Transform270, TransformFlipped, …, TransformFlipped270 } |
Свойства
|
|
Общедоступные функции
| 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 |
Сигналы
| void | availableGeometryChanged() |
| void | compositorChanged() |
| void | geometryChanged() |
| void | manufacturerChanged() |
| void | modelChanged() |
| void | physicalSizeChanged() |
| void | positionChanged() |
| void | scaleFactorChanged() |
| void | sizeFollowsWindowChanged() |
| void | subpixelChanged() |
| void | transformChanged() |
| void | windowChanged() |
Статические общедоступные члены
| QWaylandOutput * | fromResource(wl_resource *resource) |
Подробное описание
Класс QWaylandOutput управляет прямоугольной областью в пределах геометрии композитора, для использования её при отображении контента клиента. Например, это может быть экран, управляемый WaylandCompositor.
Класс соответствует интерфейсу wl_output в протоколе Wayland.
Документация по типам членов
перечисление QWaylandOutput::Subpixel
Это перечисление используется для указания расположения субпикселей QWaylandOutput.
| Постоянная | Значение | Описание |
|---|---|---|
QWaylandOutput::SubpixelUnknown |
0 |
Расположение субпикселей не установлено. |
QWaylandOutput::SubpixelNone |
1 |
Субпикселей нет. |
QWaylandOutput::SubpixelHorizontalRgb |
2 |
Субпиксели расположены горизонтально в порядке R, G, B. |
QWaylandOutput::SubpixelHorizontalBgr |
3 |
Субпиксели расположены горизонтально в порядке B, G, R. |
QWaylandOutput::SubpixelVerticalRgb |
4 |
Субпиксели расположены вертикально в порядке R, G, B. |
QWaylandOutput::SubpixelVerticalBgr |
5 |
Субпиксели расположены вертикально в порядке B, G, R. |
См. также QWaylandOutput::subpixel.
перечисление QWaylandOutput::Transform
* * Это перечисление используется для указания ориентации QWaylandOutput. * *
| Постоянная | Значение | Описание |
|---|---|---|
QWaylandOutput::TransformNormal |
0 |
Ориентация нормальная. * |
QWaylandOutput::Transform90 |
1 |
Ориентация повернута на 90 градусов. * |
QWaylandOutput::Transform180 |
2 |
Ориентация повернута на 180 градусов. * |
QWaylandOutput::Transform270 |
3 |
Ориентация повернута на 270 градусов. * |
QWaylandOutput::TransformFlipped |
4 |
Ориентация зеркально отображена. * |
QWaylandOutput::TransformFlipped90 |
5 |
Ориентация зеркально отображена и повернута на 90 градусов. * |
QWaylandOutput::TransformFlipped180 |
6 |
Ориентация зеркально отображена и повернута на 180 градусов. * |
QWaylandOutput::TransformFlipped270 |
7 |
Ориентация зеркально отображена и повернута на 270 градусов. * * |
См. также QWaylandOutput::transform.
Документация свойств
availableGeometry : QRect
Это свойство содержит геометрию QWaylandOutput, доступную для отображения содержимого. Доступная геометрия находится в пространстве координат вывода, начинается с 0,0 и по умолчанию имеет размер всего вывода.
Функции доступа:
| QRect | availableGeometry() const |
| void | setAvailableGeometry(const QRect &availableGeometry) |
Сигнал уведомления:
| void | availableGeometryChanged() |
См. также QWaylandOutput::currentMode и QWaylandOutput::geometry.
[read-only] geometry : const QRect
Это свойство содержит геометрию QWaylandOutput.
Функции доступа:
| QRect | geometry() const |
Сигнал уведомления:
| void | geometryChanged() |
См. также QWaylandOutput::currentMode.
manufacturer : QString
Это свойство содержит текстовое описание производителя QWaylandOutput.
Функции доступа:
| QString | manufacturer() const |
| void | setManufacturer(const QString &manufacturer) |
Сигнал уведомления:
| void | manufacturerChanged() |
model : QString
Это свойство содержит текстовое описание модели QWaylandOutput.
Функции доступа:
| QString | model() const |
| void | setModel(const QString &model) |
Сигнал уведомления:
| void | modelChanged() |
physicalSize : QSize
Это свойство содержит физический размер QWaylandOutput в миллиметрах.
Функции доступа:
| QSize | physicalSize() const |
| void | setPhysicalSize(const QSize &size) |
Сигнал уведомления:
| void | physicalSizeChanged() |
См. также QWaylandOutput::geometry и QWaylandOutput::currentMode.
position : QPoint
Это свойство содержит положение QWaylandOutput в системе координат композитора.
Функции доступа:
| QPoint | position() const |
| void | setPosition(const QPoint &pt) |
Сигнал уведомления:
| void | positionChanged() |
scaleFactor : int
Это свойство содержит коэффициент масштабирования буферов поверхностей QWaylandCompositor перед их отображением. Используется на устройствах с высоким разрешением, где не масштабируемое содержимое будет слишком маленьким. Клиент может в свою очередь установить коэффициент масштабирования своего буфера, чтобы соответствовать выводу, если предпочитает предоставить контент высокого разрешения, подходящий для устройства вывода.
По умолчанию значение 1 (без масштабирования).
Функции доступа:
| int | scaleFactor() const |
| void | setScaleFactor(int scale) |
Сигнал уведомления:
| void | scaleFactorChanged() |
sizeFollowsWindow : bool
Это свойство управляет тем, соответствует ли размер QWaylandOutput размеру его окна.
Если это свойство имеет значение true, все ранее добавленные режимы заменяются режимом, который соответствует размеру окна и частоте обновления экрана.
По умолчанию значение false.
Функции доступа:
| bool | sizeFollowsWindow() const |
| void | setSizeFollowsWindow(bool follow) |
Сигнал уведомления:
| void | sizeFollowsWindowChanged() |
subpixel : QWaylandOutput::Subpixel
Это свойство содержит расположение субпикселей этого QWaylandOutput. По умолчанию QWaylandOutput::SubpixelUnknown.
Функции доступа:
| QWaylandOutput::Subpixel | subpixel() const |
| void | setSubpixel(const QWaylandOutput::Subpixel &subpixel) |
Сигнал уведомления:
| void | subpixelChanged() |
transform : QWaylandOutput::Transform
Это свойство содержит преобразование, которое QWaylandCompositor применяет к поверхности для компенсации ориентации QWaylandOutput.
По умолчанию QWaylandOutput::TransformNormal.
Функции доступа:
| QWaylandOutput::Transform | transform() const |
| void | setTransform(const QWaylandOutput::Transform &transform) |
Сигнал уведомления:
| void | transformChanged() |
window : QWindow*
Это свойство содержит QWindow для данного QWaylandOutput.
Функции доступа:
| QWindow * | window() const |
| void | setWindow(QWindow *window) |
Сигнал уведомления:
| void | windowChanged() |
Документация функций-членов
QWaylandOutput::QWaylandOutput(QWaylandCompositor *compositor, QWindow *window)
Создаёт QWaylandOutput в compositor и со указанным window. Функция create() должна быть вызвана для compositor перед созданием QWaylandOutput для него.
Объект QWaylandOutput инициализируется позже, в ответ на событие. В этот момент он добавляется в качестве выхода для композитора. Если это первый объект QWaylandOutput, созданный для данного композитора, он становится стандартным выходом.
[override virtual] QWaylandOutput::~QWaylandOutput()
Удаляет QWaylandOutput.
void QWaylandOutput::addMode(const QWaylandOutputMode &mode, bool preferred = false)
Добавляет режим mode к выходу и отмечает его как предпочтительный, если preferred равно true. Обратите внимание, что может быть только один предпочтительный режим.
QWaylandCompositor *QWaylandOutput::compositor() const
Возвращает композитор для данного QWaylandOutput.
Примечание: Функция-геттер для свойства compositor.
QWaylandOutputMode QWaylandOutput::currentMode() const
Возвращает размеры выхода в пикселях и частоту обновления в мГц. Если текущий режим не задан, будет возвращен неверный режим.
См. также setCurrentMode(), QWaylandOutput::modes и QWaylandOutputMode.
void QWaylandOutput::frameStarted()
Сообщает QWaylandOutput о начале кадра.
[static] QWaylandOutput *QWaylandOutput::fromResource(wl_resource *resource)
Возвращает QWaylandOutput, соответствующий resource.
QList<QWaylandOutputMode> QWaylandOutput::modes() const
Возвращает список режимов.
void QWaylandOutput::sendFrameCallbacks()
Отправляет ожидающие обратные вызовы кадра.
void QWaylandOutput::setCurrentMode(const QWaylandOutputMode &mode)
Устанавливает текущий режим. Режим mode должен быть добавлен ранее.
См. также currentMode(), QWaylandOutput::modes и QWaylandOutputMode.
[virtual] void QWaylandOutput::update()
Планирует доставку QEvent::UpdateRequest окну QWaylandOutput .
См. также QWindow::requestUpdate().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qwaylandoutput.html
