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 プロパティに依存します。長さの値が大きい場合、視覚的な品質を高いレベルに保つために、より多くのサンプルが必要になります。

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

samples : int

このプロパティは、ぼかしの計算が行われるときに、ピクセルあたり何個のサンプルを取得するかを定義します。値が大きいほど高品質になりますが、レンダリングに時間がかかります。

このプロパティはアニメーションを目的としていません。このプロパティを変更すると、基礎となるOpenGLシェーダが再コンパイルされる可能性があります。

許可される値は 0 から inf の間です（実用的な最大値は GPU に依存します）。デフォルトでは、このプロパティは0 （サンプルなし）に設定されています。

source : variant

このプロパティは、ぼかされるソースアイテムを定義します。

transparentBorder : bool

このプロパティは、アイテムのエッジ付近のぼかし動作を定義し、ピクセルのぼかしはソースのエッジの外側のピクセルに影響される。

このプロパティがtrue に設定されている場合、ソースの外側のピクセルは透明であると解釈され、これは OpenGL のクランプからボーダーへの拡張に似ている。ぼかしは、効果項目領域の外側でわずかに拡張される。

このプロパティがfalse に設定されている場合、ソースの外側のピクセルはアイテムの端のピクセルと同じ色を含むと解釈され、これは OpenGL のクランプから端への動作に似ています。ぼかしは効果アイテムの領域外には拡大しない。

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

verticalOffset : real

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

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