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

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

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

APIは20以上のエフェクトで構成され、個別のQMLタイプとして提供されます。エフェクトは、マスキング、ぼかし、カラーリングなどの機能領域をカバーしています。

はじめに

Qt Graphical Effects を読み込むには、.qml ファイルに以下の import 文を追加してください:

import Qt5Compat.GraphicalEffects

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

各エフェクトには、エフェクト出力の設定に使用できるプロパティのセットがあります。プロパティは他のQMLプロパティと同様にアニメーションさせることができます。QMLタイプのドキュメントには、プロパティの説明と基本的な使用例が記載されています。

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

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

QML タイプ

Blend

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

BrightnessContrast

明るさとコントラストを調整します。

ColorOverlay

オーバーレイカラーを適用して、ソースアイテムの色を変更します。

Colorize

HSL色空間で色を設定します。

ConicalGradient

円錐形のグラデーションを描画します。

Desaturate

色の彩度を下げる

DirectionalBlur

指定した方向にぼかし効果を適用します

Displace

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

DropShadow

ソースアイテムの背後にソフトシャドウを生成します

FastBlur

1つまたは複数のソースアイテムに高速ぼかし効果を適用します。

GammaAdjust

ソース アイテムの輝度を変更します。

GaussianBlur

より高品質なぼかし効果を適用します。

Glow

ソースをぼかして色付けしたイメージを生成し、ソースの後ろに配置します。

HueSaturation

HSL色空間でソースアイテムの色を変更します。

InnerShadow

ソースの内側にカラー化されぼかされた影を生成します。

LevelAdjust

RGBA色空間で色レベルを調整します。

LinearGradient

線形グラデーションを描画します。

MaskedBlur

強弱のあるぼかし効果を適用します。

OpacityMask

ソースアイテムを別のアイテムでマスクします

RadialBlur

アイテムの中心点を中心に円形方向に方向性のあるぼかしを適用します。

RadialGradient

放射状グラデーション

RectangularGlow

ソースが光っているような印象を与える、ぼかして色付けした矩形を生成します。

RecursiveBlur

繰り返しぼかし、強いぼかし効果を与えます。

ThresholdMask

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

ZoomBlur

ソース アイテムの中心点に向かって方向性のあるぼかし効果を適用します。

参照

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