Qt 5 Compatibility APIs:Graphical Effects
QtGraphical Effects モジュールは Qt 5 用に書かれたアプリケーションとの互換性のために提供されています。
QtGraphical Effects モジュールは、ユーザーインターフェースに視覚的に印象的で設定可能なエフェクトを追加するための QML タイプのセットを提供します。エフェクトは、Qt Quick のユーザーインターフェースに UI コンポーネントとして追加できるビジュアルアイテムです。
APIは20以上のエフェクトから構成され、個別のQMLタイプとして提供されます。エフェクトは、マスキング、ぼかし、カラーリングなどの機能領域をカバーしています。
はじめに
QtGraphical Effects を読み込むには、.qml ファイルに以下の import 文を追加してください:
import Qt5Compat.GraphicalEffects
エフェクトを使用するには、QMLシーンに特定のエフェクト宣言を追加し、エフェクトのプロパティを設定するだけです。エフェクトには、エフェクトが適用されるビジュアル入力を指定するための 1 つ以上のソースプロパティがあります。変更されたビジュアル出力は、エフェクトアイテム自体に表示されます。ソースは、QML シーン内の別のアイテム(多くの場合非表示)にすることができます。より複雑なエフェクトは複数のソースを持つことができます。ソースアイテムの種類はQMLの種類を問わず、ビデオや別のエフェクトでも可能です。複数のエフェクトをパイプライン接続することで、より印象的なアウトプットを作成することができます。
各エフェクトには、エフェクト出力の設定に使用できるプロパティのセットがあります。プロパティは他のQMLプロパティと同様にアニメーションさせることができます。QMLタイプのドキュメントには、プロパティの説明と基本的な使用例が記載されています。
注: Qt Quick のsoftware
バックエンドで実行する場合、エフェクトは利用できません。Qt Quick のシーングラフバックエンドについての詳細は、シーングラフの適応を参照してください。
注: GaussianBlur のようなランタイムで生成されるエフェクトは、QTemporaryFile を使用して一時ストレージにシェーダーファイルを保存します。したがって、書き込み可能なファイルシステムが必要です。
QML タイプ
ブレンドモードを使用して2つのソースアイテムをマージします。 | |
明るさとコントラストを調整します。 | |
オーバーレイカラーを適用して、ソースアイテムの色を変更します。 | |
HSL色空間で色を設定します。 | |
円錐形のグラデーションを描画します。 | |
色の彩度を下げる | |
指定した方向にぼかし効果を適用します | |
指定された変位マップに従ってソースアイテムのピクセルを移動します。 | |
ソースアイテムの背後にソフトシャドウを生成します | |
1つまたは複数のソースアイテムに高速ぼかし効果を適用します。 | |
ソース アイテムの輝度を変更します。 | |
より高品質なぼかし効果を適用します。 | |
ソースをぼかして色付けしたイメージを生成し、ソースの後ろに配置します。 | |
HSL色空間でソースアイテムの色を変更します。 | |
ソースの内側にカラー化されぼかされた影を生成します。 | |
RGBA色空間で色レベルを調整します。 | |
線形グラデーションを描画します。 | |
強弱のあるぼかし効果を適用します。 | |
ソースアイテムを別のアイテムでマスクします。 | |
アイテムの中心点を中心に円形方向に方向性のあるぼかしを適用します。 | |
放射状グラデーション | |
ソースが光っているような印象を与える、ぼかして色付けした矩形を生成します。 | |
繰り返しぼかし、強いぼかし効果を与えます。 | |
ソースアイテムを別のアイテムでマスクし、しきい値を適用します。 | |
ソース アイテムの中心点に向かって方向性のあるぼかし効果を適用します。 |
参照
© 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.