DirectionalBlur QML Type

指定した方向にぼかし効果を適用します。もっと詳しく...

Import Statement:	`import Qt5Compat.GraphicalEffects`
Since:	QtGraphicalEffects 1.0
Inherits:	Item

継承されたメンバを含む、すべてのメンバのリスト

プロパティ

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

詳細説明

ソースアイテムがぼかしの方向に動いているように見えるエフェクトです。ぼかしは各ピクセルの両側に適用されるため、方向を 0 と 180 に設定すると同じ結果になります。

他の利用可能なモーションブラーエフェクトは、ZoomBlur とRadialBlur です。

ソース	適用されるエフェクト

注意： このエフェクトはOpenGLで動作しているときに利用できます。

例

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

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

角度値を変えた出力例

角度: 0.0	角度45.0	角度：90.0
samples: 24	samples: 24	samples: 24
length:32	length:32	length:32

cached : bool

このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。

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

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

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

length : real

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

ブラーの質はsamples プロパティに依存します。長さの値が大きい場合、視覚的な品質を高いレベルに保つために、より多くのサンプルが必要になります。

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

長さの値を変えた出力例

長さ: 0.0	長さ：32.0	長さ：48.0
samples: 24	samples: 24	samples: 24
angle:0	angle:0	angle:0

samples : int

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

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

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

source : variant

このプロパティは、ぼかすソース項目を定義します。

注意： 例えば source をエフェクトの親に設定するなど、エフェクト自身を含めることはサポートされていません。

transparentBorder : bool

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

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

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

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

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。