RecursiveBlur QML Type

繰り返しぼかし処理を行い、強力なぼかし効果を生み出します。詳細...

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

プロパティ

• cached : bool
• loops : int
• progress : real
• radius : real
• source : variant
• transparentBorder : bool

詳細な説明

RecursiveBlur エフェクトは、再帰的なフィードバックループを用いてソース画像を複数回ぼかすアルゴリズムにより、画像を柔らかくぼかします。このエフェクトは、GaussianBlur や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
    }

    RecursiveBlur {
        anchors.fill: bug
        source: bug
        radius: 7.5
        loops: 50
    }
}

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

cached : bool

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

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

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

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

loops : int

このプロパティは、ソースに対して実行されるぼかし反復処理の回数を定義します。このプロパティが変更されると、反復的なぼかし処理が開始されます。値が減少した場合、または値がゼロからゼロ以外に変更された場合、ソースからスナップショットが取得されます。このスナップショットは、処理の開始点として使用されます。

反復ループは可能な限り高速に実行されるよう試みます。速度は、VSYNC や 1 回のぼかし処理に必要な時間、あるいはその両方の影響を受けて制限される場合があります。場合によっては、より遅いペースでぼかし処理を実行した方が望ましいこともあります。その場合は、値を増加させるアニメーションを使用してこのプロパティを制御すると便利です。

値の範囲は0からinfです。デフォルトでは、このプロパティは0 に設定されています。

progress : real

このプロパティは、非同期のソースぼかし処理の進行状況を、0.0（ぼかし処理なし）から1.0（完了）までの範囲で保持します。

radius : real

このプロパティは、個々のピクセルのぼかしに影響を与える隣接ピクセルの距離を定義します。半径を大きくすると画質は向上しますが、レンダリングに時間がかかります。

注：このエフェクトの半径値は、頻繁に変更したりアニメーション化したりすることを想定していません。正しい使用方法は、適切な値を設定し、反復的なぼかし処理の全期間を通じてその値を変更しないことです。

値の範囲は（ぼかしなし）から16.0（最大ぼかしステップ）までです。デフォルトでは、このプロパティは0.0 （ぼかしなし）に設定されています。

source : variant

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

transparentBorder : bool

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

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

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

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