Класс 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 } |
| Перечисление | Transform { 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.
Документация типов членов
enum QWaylandOutput::Subpixel
Этот тип перечисления используется для указания расположения субпикселей QWaylandOutput.
| Константа | Значение | Описание |
|---|---|---|
QWaylandOutput::SubpixelUnknown |
0 |
Расположение субпикселей не задано. |
QWaylandOutput::SubpixelNone |
1 |
Субпикселей нет. |
QWaylandOutput::SubpixelHorizontalRgb |
2 |
Субпиксели расположены горизонтально в порядке красный, зелёный, синий. |
QWaylandOutput::SubpixelHorizontalBgr |
3 |
Субпиксели расположены горизонтально в порядке синий, зелёный, красный. |
QWaylandOutput::SubpixelVerticalRgb |
4 |
Субпиксели расположены вертикально в порядке красный, зелёный, синий. |
QWaylandOutput::SubpixelVerticalBgr |
5 |
Субпиксели расположены вертикально в порядке синий, зелёный, красный. |
См. такжеQWaylandOutput::subpixel.
enum 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.1/qwaylandoutput.html
