FastBlur QML Type

1つまたは複数のソース項目に、高速なぼかし効果を適用します。詳細...

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

プロパティ

• cached : bool
• radius : real
• source : variant
• transparentBorder : bool

詳細な説明

FastBlurエフェクトは、ソースコンテンツのダウンサンプリングと双線形フィルタリングを利用するアルゴリズムを用いてぼかし処理を行い、ソースコンテンツを柔らかく表現します。

例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

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

cached : bool

このプロパティを使用すると、エフェクトの出力ピクセルをキャッシュして、レンダリング性能を向上させることができます。

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

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

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

radius : real

このプロパティは、個々のピクセルのぼかしに影響を与える隣接ピクセルとの距離を定義します。半径を大きくすると、ぼかし効果が強まります。FastBlur アルゴリズムでは、レンダリングパフォーマンスを向上させるために、内部的に半径の精度が低下する場合があります。

値の範囲は 0.0（ぼかしなし）から inf です。半径が 64 を超えると、ぼかしの視覚的な品質が低下します。デフォルトでは、このプロパティは0.0 （ぼかしなし）に設定されています。

source : variant

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

transparentBorder : bool

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

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

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

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