Qt 5 Compatibility APIs:Graphical Effects

QtGraphical Effects モジュールは Qt 5 用に書かれたアプリケーションとの互換性のために提供されています。

QtGraphical Effects モジュールは、ユーザーインターフェースに視覚的に印象的で設定可能なエフェクトを追加するための QML タイプのセットを提供します。エフェクトは、UI コンポーネントとしてQt Quick のユーザーインターフェースに追加できるビジュアルアイテムです。

注意: QtGraphical Effects モジュールには、エフェクトを重ねる際のパフォーマンス上の制約があるため、主に Qt 5 アプリケーションとの互換性のために含まれています。新しいコードは、Qt 6で導入されたエフェクトのための新しいソリューションのいずれかを使って書かれることをお勧めします。Qt Quick 典型的な UI エフェクトには、MultiEffect があります。このコンポーネントではカバーできない高度な使用例については、Qt Quick Effect Maker ツールを使用して、必要なシェーダーエフェクトを正確にカスタマイズし、微調整することができます。

Qtの使用Graphical Effects

QtGraphical Effects タイプをインポートするには、QtGraphical Effects モジュールを QML ファイルに追加してください：

import Qt5Compat.GraphicalEffects

エフェクトを使用するには、QML シーンに特定のエフェクト宣言を追加し、エフェクトのプロパティを設定するだけです。エフェクトには、エフェクトを適用するビジュアル入力を指定するためのソースプロパティが1つ以上あります。変更されたビジュアル出力は、エフェクトアイテム自体に表示されます。ソースアイテムのタイプは QML の種類を問わず、ビデオや別のエフェクトでも可能です。複数のエフェクトをパイプライン接続することで、より印象的な出力を簡単に作成することができます。

以下のリストは、QtGraphical Effects に含まれるタイプの機能的な区分です。

注: Qt Quick のsoftware バックエンドで動作している場合、エフェクトは利用できません。Qt Quick シーングラフバックエンドについての詳細は、Scene Graph Adaptations を参照してください。

注: GaussianBlur のようなランタイムで生成されるエフェクトは、QTemporaryFile を使って一時ストレージにシェーダーファイルを保存します。

ブレンド

Blend

ブレンドモードを使用して、2 つのソースアイテムをマージします。

カラー

BrightnessContrast	明るさとコントラストを調整します。
ColorOverlay	オーバーレイカラーを適用してソースアイテムの色を変更します。
Colorize	HSL色空間で色を設定します。
Desaturate	色の彩度を下げます
GammaAdjust	ソースアイテムの輝度を変更します。
HueSaturation	HSL 色空間でソースアイテムの色を変更します。
LevelAdjust	RGBA 色空間の色レベルを調整します。

グラデーション

ConicalGradient	円錐形のグラデーションを描画します。
LinearGradient	直線グラデーション
RadialGradient	放射状のグラデーションを描画します。

ディストーション

Displace

指定された変位マップに従って、ソースアイテムのピクセルを移動します。

ドロップシャドウ

DropShadow	ソースアイテムの後ろにソフトシャドウを描画します。
InnerShadow	ソースの内側に色付けされぼかされた影を生成します。

ぼかし

FastBlur	1つまたは複数のソースアイテムに高速ぼかし効果を適用します。
GaussianBlur	より高品質なぼかし効果を適用します。
MaskedBlur	様々な強さのぼかし効果を適用します。
RecursiveBlur	繰り返しぼかし、強いぼかし効果を与えます。

モーションぼかし

DirectionalBlur	指定した方向にぼかし効果を適用します。
RadialBlur	アイテムの中心点を中心とした円周方向にぼかしをかけます。
ZoomBlur	アイテムの中心点に向かってぼかします。

グロー

Glow	ソースのぼかしとカラー化されたイメージを生成し、ソースの後ろに配置します。
RectangularGlow	ぼかしと色付けを施した矩形を生成し、ソースが光っているように見せます。

マスク

OpacityMask	ソースアイテムを別のアイテムでマスクします。
ThresholdMask	ソースアイテムを別のアイテムでマスクし、しきい値を適用します。

© 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.