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)
詳細説明
WaylandCompositorはクライアントとの接続を管理し、さまざまなoutputs 、seats 。
通常、コンポジターアプリケーションは1つのWaylandCompositorインスタンスを持ち、子インスタンスとして複数のアウトプットを持つことができます。クライアントがコンポジターにサーフェスの作成を要求すると、onSurfaceRequestedハンドラーがその要求を処理します。
コンポジターがサポートする拡張機能は、インスタンス化して extensions プロパティに追加する必要があります。
プロパティ Documentation
additionalShmFormats : list<enum> |
このプロパティは、コンポジターによってサポートされると宣伝されている追加の wl_shm フォーマットのリストを保持する。
デフォルトでは、必須の ShmFormat_ARGB8888 と ShmFormat_XRGB8888 のみがリストされ、このリストは空になります。その他のフォーマットは内部的に変換が必要な場合があり、パフォーマンスに影響します。
このプロパティは、コンポジターコンポーネントが完了する前に設定する必要があります。それ以降の変更は影響しません。
このプロパティは Qt 6.0 で導入されました。
created : bool |
このプロパティは、WaylandCompositor が初期化されていれば真、そうでなければ偽です。
defaultOutput : WaylandOutput |
このプロパティには、WaylandCompositor に追加された出力リストの最初の出力が含まれ、出力が追加されていない場合は null になります。
新しいデフォルト出力を設定すると、その出力が出力リストの先頭に追加され、新しいデフォルトになりますが、以前のデフォルトはリストから削除されません。
defaultSeat : WaylandSeat |
このプロパティには、このWaylandCompositor のデフォルトシートが含まれます。
extensions : list |
コンポジターがクライアントにアドバタイズする拡張機能のリスト。コンポジターがサポートすべきWayland拡張について、そのコンポーネントをインスタンス化し、拡張のリストに追加する。
例えば、以下のコードでは、wl_shell
インターフェイスを使用して、クライアントがコンポジターでwl_shell
サーフェスをリクエストできるようにします。
import QtWayland.Compositor WaylandCompositor { WlShell { // ... } }
retainedSelection : bool |
このプロパティは、保持された選択が有効かどうかを保持する。
socketName : string |
このプロパティは、WaylandCompositor がクライアントとの通信に使用するソケット名を保持する。コンポーネントが完了する前に設定する必要がある。
socketName が空(デフォルト)の場合、代わりに開始引数--wayland-socket-name
の内容が使用される。引数が設定されていない場合、コンポジターはソケット名を探そうとするが、デフォルトではwayland-0
である。
useHardwareIntegrationExtension : bool |
このプロパティは、このWaylandCompositor に対してハードウェア統合拡張を有効にするかどうかを保持する。
このプロパティは、コンポジターコンポーネントが完了する前に設定する必要がある。
シグナル
void surfaceCreated(WaylandSurface surface) |
このシグナルは、新しいWaylandSurface インスタンスsurface が作成されたときに発行されます。
注意: 対応するハンドラはonSurfaceCreated
です。
void surfaceRequested(WaylandClient client, int id, int version) |
このシグナルは、client が idid を持つサーフェスを作成したときに発行されます。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.