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 のクライアントを破棄します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。