WaylandCompositor QML Type
Wayland 디스플레이 서버를 관리합니다. 더 보기...
Import Statement: | import QtWayland.Compositor |
In C++: | QWaylandCompositor |
속성
- additionalShmFormats : list<enum>
(since 6.0)
- created : bool
- defaultOutput : WaylandOutput
- defaultSeat : WaylandSeat
- extensions : list
- retainedSelection : bool
- socketName : string
- useHardwareIntegrationExtension : bool
신호
- void surfaceCreated(WaylandSurface surface)
- void surfaceRequested(WaylandClient client, int id, int version)
방법
- addSocketDescriptor(fd)
- destroyClient(client)
- destroyClientForSurface(surface)
자세한 설명
웨이랜드 컴포저는 클라이언트와 다른 outputs 및 seats 에 대한 연결을 관리합니다.
일반적으로 컴포저 애플리케이션에는 하나의 웨이랜드 컴포저 인스턴스가 있으며, 이 인스턴스는 여러 출력을 자손으로 가질 수 있습니다. 클라이언트가 컴포저에 서피스 생성을 요청하면, 요청은 onSurfaceRequested 핸들러에 의해 처리됩니다.
컴포저에서 지원하는 확장은 인스턴스화하여 확장 프로퍼티에 추가해야 합니다.
프로퍼티 문서
additionalShmFormats : list<enum> |
이 프로퍼티에는 컴포저에서 지원한다고 광고하는 추가 wl_shm 형식의 목록이 들어 있습니다.
기본적으로 필수 ShmFormat_ARGB8888 및 ShmFormat_XRGB8888만 나열되며 이 목록은 비어 있습니다. 추가 포맷은 내부적으로 변환이 필요할 수 있으므로 성능에 영향을 줄 수 있습니다.
이 속성은 컴포저 컴포넌트가 완료되기 전에 설정해야 합니다. 그 이후의 변경 사항은 적용되지 않습니다.
이 속성은 Qt 6.0에 도입되었습니다.
created : bool |
WaylandCompositor 이 초기화되면 이 프로퍼티는 참이고, 그렇지 않으면 거짓입니다.
defaultOutput : WaylandOutput |
이 속성은 WaylandCompositor 에 추가된 출력 목록의 첫 번째 출력을 포함하거나, 추가된 출력이 없는 경우 null을 포함합니다.
새 기본 출력을 설정하면 출력 목록에 추가되어 새 기본값이 되지만 이전 기본값은 목록에서 제거되지 않습니다.
defaultSeat : WaylandSeat |
이 속성에는 이 WaylandCompositor 에 대한 기본 시트가 포함되어 있습니다.
extensions : list |
컴포저가 클라이언트에 광고하는 확장 목록입니다. 컴포저가 지원해야 하는 모든 웨일랜드 확장에 대해 컴포넌트를 인스턴스화하여 확장 목록에 추가합니다.
예를 들어, 다음 코드는 클라이언트가 wl_shell
인터페이스를 사용하여 컴포저에서 wl_shell
서페이스를 요청할 수 있도록 합니다.
import QtWayland.Compositor WaylandCompositor { WlShell { // ... } }
retainedSelection : bool |
이 속성은 유지된 선택이 활성화되었는지 여부를 보유합니다.
socketName : string |
이 프로퍼티는 WaylandCompositor 에서 클라이언트와 통신하는 데 사용하는 소켓 이름을 보유합니다. 컴포넌트가 완료되기 전에 설정해야 합니다.
소켓 이름이 비어 있으면(기본값), 시작 인수 --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
입니다.
메서드 문서
addSocketDescriptor(fd) |
이미 바인딩되어 수신 대기 중인 서버 소켓을 참조하여 파일 설명자 fd 에서 클라이언트 연결을 수신 대기합니다.
파일 디스크립터의 소유권을 가지지 않으므로 필요한 경우 명시적으로 닫아야 합니다.
참고: 이 메서드는 libwayland 1.10.0 이상에서만 사용할 수 있습니다. 이전 libwayland 런타임에 대해 빌드된 경우, 이 메서드는 noop입니다.
destroyClient(client) |
주어진 WaylandClient client 을 삭제합니다.
destroyClientForSurface(surface) |
WaylandSurface surface 에 대한 클라이언트를 삭제합니다.
© 2025 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.