RadialBlur QML Type

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

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

プロパティ

• angle : real
• cached : bool
• horizontalOffset : real
• samples : int
• source : variant
• transparentBorder : bool
• verticalOffset : real

詳細説明

このエフェクトは、元のオブジェクトがボケの方向に向かって回転しているかのような視覚的印象を与えます。

その他のモーションブラーエフェクトには、ZoomBlur およびDirectionalBlur があります。

使用例

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

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
    }

    RadialBlur {
        anchors.fill: bug
        source: bug
        samples: 24
        angle: 30
    }
}

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

angle : real

このプロパティは、ぼかしの方向と、同時にぼかしの度合いを定義します。角度が大きくなるほど、結果はよりぼやけたものになります。ぼかしの品質は、samples プロパティによって決まります。角度の値が大きい場合、視覚的な品質を高いレベルに保つためには、より多くのサンプルが必要となります。

指定可能な値は 0.0 から 360.0 までの範囲です。デフォルトでは、このプロパティは `0.0` に設定されています。

cached : bool

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

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

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

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

horizontalOffset : real

これらのプロパティは、回転の視覚的な中心点のオフセット（ピクセル単位）を定義します。

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

samples : int

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

このプロパティはアニメーションを想定したものではありません。このプロパティを変更すると、基盤となる OpenGL シェーダーが再コンパイルされる場合があります。

指定可能な値は0からinfの間です（実用上の最大値はGPUによって異なります）。デフォルトでは、このプロパティは0 （サンプリングなし）に設定されています。

source : variant

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

transparentBorder : bool

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

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

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

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

verticalOffset : real

これらのプロパティは、回転の知覚上の中心点に対するピクセル単位のオフセットを定義します。

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