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