Тип QML WaylandCompositor

Управляет сервером отображения Wayland. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• additionalShmFormats : список<перечисление>
• created : bool
• defaultOutput : WaylandOutput
• defaultSeat : WaylandSeat
• extensions : список
• retainedSelection : bool
• socketName : строка
• useHardwareIntegrationExtension : bool

Сигналы

• void surfaceCreated(WaylandSurface surface)
• void surfaceRequested(WaylandClient client, int id, int version)

Методы

• addSocketDescriptor(fd)
• destroyClient(client)
• destroyClientForSurface(surface)

Подробное описание

WaylandCompositor управляет подключениями к клиентам, а также различными выводами и местами.

Обычно приложение-композитор имеет один экземпляр WaylandCompositor, который может иметь несколько выводов в качестве дочерних элементов. Когда клиент запрашивает у композитора создание поверхности, запрос обрабатывается обработчиком onSurfaceRequested.

Расширения, которые поддерживаются композитором, должны быть созданы и добавлены в свойство extensions.

Документация по свойствам

[since 6.0] additionalShmFormats : список<перечисление>

Это свойство содержит список дополнительных форматов wl_shm, рекламируемых как поддерживаемые композитором.

По умолчанию перечислены только необходимые ShmFormat_ARGB8888 и ShmFormat_XRGB8888, и этот список будет пустым. Дополнительные форматы могут потребовать внутренней конвертации и, таким образом, повлиять на производительность.

Это свойство должно быть установлено до завершения компонента композитора. Последующие изменения не окажут никакого эффекта.

Это свойство было введено в Qt 6.0.

created : bool

Это свойство имеет значение true, если WaylandCompositor был инициализирован, в противном случае оно имеет значение false.

defaultOutput : WaylandOutput

Это свойство содержит первый в списке выходов, добавленных в WaylandCompositor, или null, если выходы не были добавлены.

Установка нового значения для свойства default output помещает его в начало списка выходов, делая его новым значением по умолчанию, но предыдущее значение по умолчанию не удаляется из списка.

defaultSeat : WaylandSeat

Это свойство содержит место по умолчанию для этого WaylandCompositor.

extensions : список

Список расширений, которые композитор рекламирует своим клиентам. Для любого расширения Wayland, которое должен поддерживать композитор, создайте его компонент и добавьте его в список расширений.

Например, следующий код позволит клиентам запрашивать wl_shell поверхности в композиторе с использованием интерфейса wl_shell.

import QtWayland.Compositor

WaylandCompositor {
    WlShell {
        // ...
    }
}

retainedSelection : bool

Это свойство содержит значение true, если сохранение выделения включено.

socketName : строка

Это свойство содержит имя сокета, используемое WaylandCompositor для связи с клиентами. Оно должно быть установлено до завершения компонента.

Если socketName пустое (по умолчанию), используется содержимое аргумента start --wayland-socket-name. Если аргумент не задан, композитор пытается найти имя сокета, которое по умолчанию равно wayland-0.

useHardwareIntegrationExtension : bool

Это свойство содержит значение true, если необходимо включить расширение интеграции аппаратного обеспечения для этого WaylandCompositor.

Это свойство должно быть установлено до завершения компонента композитора.

Документация по сигналам

void surfaceCreated(WaylandSurface surface)

Этот сигнал испускается, когда создан новый экземпляр WaylandSurface surface.

Примечание: Соответствующий обработчик — onSurfaceCreated.

void surfaceRequested(WaylandClient client, int id, int version)

Этот сигнал испускается, когда client создал поверхность с id id. Также доступен интерфейс version.

Слот, подключенный к этому сигналу, может создать и инициализировать экземпляр WaylandSurface в области действия слота. В противном случае создается поверхность по умолчанию.

Примечание: Соответствующий обработчик — onSurfaceRequested.

Документация по методам

[since 5.12] addSocketDescriptor(fd)

Прослушивает подключения клиентов по дескриптору файла fd, относящемуся к сокету сервера, уже привязанному и ожидающему соединения.

Не принимает владения дескриптором файла; его необходимо явно закрыть, если это необходимо.

Примечание: Этот метод доступен только с libwayland 1.10.0 или новее. Если построение выполняется с более ранней libwayland, этот метод является пустой операцией.

Этот метод был введен в Qt 5.12.

destroyClient(client)

Удаляет заданного WaylandClient client.

destroyClientForSurface(surface)

Удаляет клиента для WaylandSurface surface.