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
    }
}

ブラーをライブで実行するのはコストのかかる操作です。適度なサンプル数を持つフルスクリーンガウスぼかしは、ハイエンドグラフィックスハードウェア上では60fpsでしか動作しません。

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

cached : bool

このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクト出力を保存するために余分なメモリバッファが必要になるため、メモリ消費量が増加します。

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

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

deviation : real

このプロパティは、ぼかしのための隣接ピクセルの重みを計算するときに使用されるガウス関数のパラメータです。偏差が大きいと画像がよりぼやけて見えますが、ぼかしの質も低下します。偏差値が非常に大きいと、例えばボックスブラーアルゴリズムのような効果が得られます。偏差値が小さすぎると、半径に近いピクセルでは効果が小さくなります。

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

値の範囲は0.0（偏差なし）からinf（最大偏差）まで。デフォルトでは、偏差は半径に束縛されます。半径が大きくなると、偏差は自動的に直線的に大きくなります。半径の値が 8 の場合、偏差のデフォルト値はおよそ 2.7034 になります。この値は、ぼかしの品質と全体的なぼかしの妥協点を生み出します。

radius : real

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

理想的なぼかしは、samples = 1 + radius * 2 のように、samples とradius を選択することで得られます：

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

samples : int

このプロパティは、ぼかしの計算が行われるときに、ピクセルあたりいくつのサンプルが取得されるかを定義します。値が大きいほど品質は向上しますが、レンダリングに時間がかかります。

例えば、半径が 0.0 から 4.0 の間でアニメートされる場合、サンプル数は 9 に設定されるべきです。

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

source : variant

このプロパティは、ぼかされるソースアイテムを定義します。

transparentBorder : bool

このプロパティは、アイテムのエッジ付近のぼかし動作を定義し、ピクセルのぼかしはソースのエッジの外側のピクセルに影響される。

このプロパティがtrue に設定されている場合、ソースの外側のピクセルは透明であると解釈され、これは OpenGL のクランプからボーダーへの拡張に似ている。ぼかしは、効果項目領域の外側でわずかに拡張される。

このプロパティがfalse に設定されている場合、ソースの外側のピクセルはアイテムの端のピクセルと同じ色を含むと解釈され、これは OpenGL のクランプから端への動作に似ています。ぼかしは効果アイテムの領域外には拡大しない。

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