Qt 5 互換 API：Qt グラフィカルエフェクト

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

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

Qt グラフィカルエフェクトの使用

エフェクトは、UI コンポーネントとして Qt Quick ユーザーインターフェースに追加できるビジュアルアイテムです。Qt Graphical Effects の種類をインポートするには、QML ファイルに以下の記述を追加して Qt Graphical Effects モジュールをインクルードします：

import Qt5Compat.GraphicalEffects

エフェクトを使用するには、QMLシーンに特定のエフェクト宣言を追加し、エフェクトのプロパティを設定するだけです。ソースアイテムのタイプは、ビデオや別のエフェクトであっても、どのようなQMLタイプでも構いません。複数のエフェクトをパイプライン接続することで、より印象的な出力を簡単に作成することができます。

以下のリストは、Qt グラフィカルエフェクトに含まれるタイプの機能的な区分です。

ブレンド

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	ソースアイテムを別のアイテムでマスクし、しきい値を適用します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。