WaylandCompositor QML Type

Waylandディスプレイ・サーバーを管理する。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• 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)

方法

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

詳細説明

WaylandCompositorはクライアントとの接続を管理し、さまざまなoutputs 、seats 。

通常、コンポジターアプリケーションは1つのWaylandCompositorインスタンスを持ち、子インスタンスとして複数のアウトプットを持つことができます。クライアントがコンポジターにサーフェスの作成を要求すると、onSurfaceRequestedハンドラーがその要求を処理します。

コンポジターがサポートする拡張機能は、インスタンス化して extensions プロパティに追加する必要があります。

プロパティのドキュメント

additionalShmFormats : list<enum> [since 6.0]

このプロパティは、コンポジターがサポートすると宣伝されている追加の wl_shm フォーマットのリストを保持します。

デフォルトでは、必須の ShmFormat_ARGB8888 と ShmFormat_XRGB8888 のみがリストされ、このリストは空になります。その他のフォーマットは内部的に変換が必要な場合があり、パフォーマンスに影響します。

このプロパティは、コンポジターコンポーネントが完了する前に設定する必要があります。それ以降の変更は影響しません。

このプロパティは Qt 6.0 で導入されました。

created : bool [read-only]

このプロパティは、WaylandCompositor が初期化されていれば真、そうでなければ偽となる。

defaultOutput : WaylandOutput

このプロパティには、WaylandCompositor に追加された出力リストの先頭が格納され、出力が追加されていない場合は null が格納されます。

新しいデフォルト出力を設定すると、その出力が出力リストの先頭に追加され、新しいデフォルトになりますが、以前のデフォルトはリストから削除されません。

defaultSeat : WaylandSeat [read-only]

このプロパティには、この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 で有効にするかどうかを保持します。

このプロパティは、コンポジターコンポーネントが完了する前に設定する必要があります。

Signal ドキュメント

void surfaceCreated(WaylandSurface surface)

このシグナルは、新しいWaylandSurface インスタンスsurface が生成されたときに発せられる。

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

このシグナルは、client が idid を持つサーフェスを作成したときに発せられる。インターフェースversion も利用可能です。

このシグナルに接続するスロットは、スロットのスコープ内でWaylandSurface インスタンスを作成し、初期化することができます。そうでない場合は、デフォルトのサーフェスが作成されます。

メソッドのドキュメント

void addSocketDescriptor(fd)

既にバインドされリッスンしているサーバーソケットを参照して、ファイルディスクリプタfd のクライアント接続をリッスンする。

ファイルディスクリプタの所有権は持たないので、必要であれば明示的にクローズする必要がある。

void destroyClient(client)

与えられたWaylandClient client を破壊する。

void destroyClientForSurface(surface)

WaylandSurface surface のクライアントを破壊する。