GaussianBlur QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• cached : bool
• deviation : real
• radius : real
• samples : int
• source : variant
• transparentBorder : bool

詳細な説明

GaussianBlurエフェクトは、ガウス関数を用いて効果を計算するアルゴリズムで画像をぼかすことにより、画像を柔らかく仕上げます。このエフェクトはFastBlur よりも高品質ですが、レンダリングに時間がかかります。

特に、ガウスぼかしのプロパティを変更する場合、多くの場合、シェーダーコードを最初から再構築する必要があるため、このエフェクトのプロパティをアニメーション化すると、パフォーマンスが低下するだけでなく、大量のキャッシュ領域を必要とする可能性があります。したがって、アニメーションを伴うぼかし効果には、通常、FastBlur を使用することを推奨します。

例

以下の例は、このエフェクトを適用する方法を示しています。

import QtQuick
import QtGraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    GaussianBlur {
        anchors.fill: bug
        source: bug
        radius: 8
        samples: 16
    }
}

ライブでのぼかし処理は、負荷の高い操作です。サンプル数がそれほど多くない場合でも、フルスクリーンのガウスぼかしは、ハイエンドのグラフィックハードウェアでなければ 60 fps で実行できません。

プロパティのドキュメント

cached : bool

このプロパティを有効にすると、エフェクトの出力ピクセルがキャッシュされ、レンダリング性能が向上します。ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ使用量が増加します。

ソースまたはエフェクトのプロパティがアニメーション化される場合は、キャッシュを無効にすることをお勧めします。

デフォルトでは、このプロパティはfalse に設定されています。

deviation : real

このプロパティは、ぼかし処理において隣接するピクセルの重みを計算する際に使用されるガウス関数のパラメータです。偏差の値が大きいほど、画像はよりぼやけて見えますが、ぼかしの品質も低下します。偏差の値を非常に大きくすると、その効果は、例えばボックスぼかしアルゴリズムで生成される結果に少し似たものになります。 偏差の値が小さすぎると、半径付近のピクセルに対する効果がほとんど感じられなくなります。

上の画像は、黄色（1）とシアン（2.7）という 2 つの異なる偏差値を用いたガウス関数を示しています。y 軸は重みを、x 軸はピクセル間隔を示しています。

値の範囲は 0.0（偏差なし）から inf（最大偏差）までです。 デフォルトでは、偏差は半径に連動しています。半径が大きくなると、偏差も自動的に直線的に増加します。半径の値が 8 の場合、偏差のデフォルト値は約 2.7034 になります。この値は、ぼかしの品質と全体的なぼかし具合のバランスが取れた結果となります。

radius : real

このプロパティは、個々のピクセルのぼかしに影響を与える隣接ピクセルとの距離を定義します。半径を大きくすると、ぼかし効果が強まります。

理想的なぼかし効果は、「samples 」と「radius 」を、samples = 1 + radius * 2 となるように選択することで得られます。例えば、次のように設定します。

値の範囲は0.0（ぼかしなし）からinfまでです。デフォルトでは、このプロパティはfloor(samples / 2.0) に設定されています。

samples : int

このプロパティは、ぼかしの計算を行う際に、1ピクセルあたり何個のサンプルを採取するかを定義します。値を大きくすると画質は向上しますが、レンダリングに時間がかかります。

理想的には、この値は、必要となる最大半径値の2倍に1を加えた値に設定すべきです。例えば、半径が0.0から4.0の間でアニメーションされる場合、サンプル数は9に設定する必要があります。

デフォルトでは、このプロパティは9 に設定されています。

source : variant

このプロパティは、ぼかし処理の対象となるソース項目を指定します。

transparentBorder : bool

このプロパティは、アイテムの端付近におけるぼかし挙動を定義するもので、ソースの端の外側にあるピクセルの影響を受けてピクセルがぼかされる。

このプロパティが `true` に設定されている場合、ソースの外側のピクセルは透明であると解釈され、これは OpenGL の clamp-to-border 拡張機能と同様です。ぼかしは、エフェクト対象のアイテム領域の外側にわずかに広がります。

このプロパティが `false` に設定されている場合、ソースの外部にあるピクセルは、アイテムの端のピクセルと同じ色を含むものと解釈されます。これは、OpenGL の `clamp-to-edge` 動作に似ています。ぼかしは、エフェクトアイテム領域の外側には広がりません。

デフォルトでは、このプロパティはfalse に設定されています。