Тип 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.

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

[с 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

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

socketName : строка

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

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

useHardwareIntegrationExtension : bool

Это свойство указывает, следует ли включить расширение аппаратной интеграции для этого 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, относящемся к уже привязанному и прослушивающему сокету сервера.

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

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

destroyClient(client)

Удаляет указанный WaylandClient client.

destroyClientForSurface(surface)

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