DirectionalBlur QML Type

指定した方向にぼかし効果を適用します。詳細...

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

プロパティ

• angle : real
• cached : bool
• length : real
• samples : int
• source : variant
• transparentBorder : bool

詳細な説明

このエフェクトは、対象物がぼやけの方向に向かって動いているかのような視覚的印象を生み出します。ぼかしは各ピクセルの両側に適用されるため、方向を0または180に設定しても同じ結果になります。

その他のモーションブラー効果として、ZoomBlur およびRadialBlur があります。

例

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

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
    }

    DirectionalBlur {
        anchors.fill: bug
        source: bug
        angle: 90
        length: 32
        samples: 24
    }
}

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

angle : real

このプロパティは、ぼかしの方向を定義します。ぼかしは各ピクセルの両側に適用されるため、方向を 0 または 180 に設定しても結果は同じになります。

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

cached : bool

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

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

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

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

length : real

このプロパティは、各ピクセルに対する動きの知覚量を定義します。動きは各ピクセルの両側に均等に分割されます。

ぼかしの品質は、samples プロパティによって決まります。lengthの値が大きいほど、高い視覚品質を維持するために必要なサンプル数が増えます。

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

samples : int

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

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

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

source : variant

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

transparentBorder : bool

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

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

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

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