Qt 5 Compatibility APIs:Graphical Effects
QtGraphical Effects モジュールは、Qt 5向けに作成されたアプリケーションとの互換性を確保するために提供されています。
QtGraphical Effects モジュールは、ユーザーインターフェースに視覚的に印象的で設定可能なエフェクトを追加するための一連のQML型を提供します。エフェクトとは、Qt Quick のユーザーインターフェースにUIコンポーネントとして追加できる視覚的要素のことです。
注： QtGraphical Effects モジュールは、 エフェクトが重ね合わされた場合にパフォーマンス上の制約があるため 、主に Qt 5 アプリケーションとの互換性を確保するために含まれています。 新しいコードを記述する際は、Qt 6で導入されたエフェクト用の新しいソリューションのいずれかを使用することを推奨します。一般的なUIエフェクトについては、Qt Quick にはMultiEffect が用意されており、1回の処理で複数のエフェクトを適用できます。このコンポーネントでは対応できない高度なユースケースについては、Qt Quick のEffect Makerツールを使用して、必要なシェーダーエフェクトを正確にカスタマイズおよび微調整することができます。
Qtの使用Graphical Effects
QtのGraphical Effects 型をインポートするには、QMLファイルに次の記述を追加して、QtのGraphical Effects モジュールをインクルードしてください。
import Qt5Compat.GraphicalEffectsエフェクトを使用するには、QMLシーンに特定のエフェクト宣言を追加し、エフェクトのプロパティを設定するだけです。 エフェクトには、エフェクトが適用される視覚的な入力を指定するための1つ以上のソースプロパティがあります。変更された視覚的な出力は、エフェクトアイテム自体に表示されます。ソースアイテムの型は、ビデオや他のエフェクトを含め、任意のQML型にすることができます。複数のエフェクトをパイプライン処理することで、さらに印象的な出力を簡単に作成できます。
以下のリストは、Qt XMLGraphical Effects に含まれるタイプの機能別分類を示しています。
注： Qt Quick のsoftware バックエンドで実行している場合、エフェクトは 利用できません。Qt Quick のシーングラフバックエンドに関する詳細については、「シーングラフの適応」を参照してください。
注： GaussianBlur などの実行時に生成される エフェクトは、QTemporaryFile を使用してシェーダーファイルを一時ストレージに保存するため、書き込み可能なファイルシステムが必要です。
Blend
ブレンドモードを使用して、2 つのソース項目を統合します。 |
色
明るさとコントラストを調整します。 | |
オーバーレイカラーを適用して、ソースアイテムの色を変更します。 | |
HSL色空間で色を設定します | |
色の彩度を下げます | |
ソース項目の輝度を変更します | |
HSL色空間でソース項目の色を変更します | |
RGBA色空間で色レベルを調整します |
グラデーション
円錐状のグラデーションを描画します | |
線形グラデーションを描画します | |
放射状グラデーションを描画します |
歪み
指定された変位マップに従って、ソース項目のピクセルを移動します |
ドロップシャドウ
ソース項目の背後にソフトな影を生成します | |
ソース内部に、色付けされぼかされた影を生成します |
ぼかし
1つ以上のソースアイテムに高速なぼかし効果を適用します | |
より高品質なぼかし効果を適用します | |
強度が変化するぼかし効果を適用します | |
繰り返しぼかし処理を行い、強いぼかし効果を生み出します |
モーションブラー
指定した方向にぼかし効果を適用します | |
アイテムの中心点を軸に円形方向に方向性のあるぼかしを適用します | |
ソースアイテムの中心点に向かって方向性のあるぼかし効果を適用します |
グロー
ソース画像のぼかして着色した画像を生成し、元の画像の背後に配置することで、ソースが光っているような印象を与えます | |
ぼかして着色された長方形を生成し、ソースが光っているような印象を与えます |
マスク
ソースアイテムを別のアイテムでマスクします | |
ソースアイテムを別のアイテムでマスクし、しきい値を適用します |
© 2026 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.
