ZoomBlur QML Type

ソース項目の中心点に向かって、方向性のあるぼかし効果を適用します。詳細...

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

プロパティ

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

詳細な説明

このエフェクトは、対象物がZ軸方向に中心点に向かって動いているように見える、あるいはカメラが急速にズームしているように見える視覚効果を生み出します。その他のモーションブラーエフェクトには、DirectionalBlur およびRadialBlur があります。

例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

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

cached : bool

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

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

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

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

horizontalOffset : real

これらのプロパティは、ぼかし方向の中心点に対するピクセル単位のオフセットを定義します。

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

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` に設定されています。

verticalOffset : real

これらのプロパティは、ぼかし方向の中心点に対するピクセル単位のオフセットを定義します。

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