WaylandCompositor QML Type

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

Import Statement: import QtWayland.Compositor
In C++: QWaylandCompositor

プロパティ

シグナル

メソッド

詳細説明

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

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

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

プロパティ Documentation

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 に対してハードウェア統合拡張を有効にするかどうかを保持する。

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


シグナル

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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。