DirectionalBlur QML Type
指定した方向にぼかし効果を適用します。もっと詳しく...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
プロパティ
詳細説明
エフェクトは、ソースアイテムがぼかしの方向に動いているように見える知覚を作成します。ぼかしは各ピクセルの両側に適用されるため、方向を 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 |
cached : bool |
このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。
ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクト出力を保存するために余分なメモリバッファが必要になるため、メモリ消費量が増加します。
ソースまたはエフェクトプロパティがアニメーションするときは、キャッシュを無効にすることをお勧めします。
デフォルトでは、このプロパティはfalse に設定されています。
length : real |
samples : int |
このプロパティは、ぼかし計算が行われるときに、1ピクセルあたりいくつのサンプルを取るかを定義する。値が大きいほど画質は良くなるが、レンダリングに時間がかかる。
このプロパティはアニメーションを意図していません。このプロパティを変更すると、基礎となるOpenGLシェーダが再コンパイルされる可能性があります。
許可される値は 0 から inf の間です（実用的な最大値は GPU に依存します）。デフォルトでは、このプロパティは0 （サンプルなし）に設定されています。
source : variant |
このプロパティは、ぼかすソース項目を定義します。
注意： 例えば source をエフェクトの親に設定するなど、エフェクト自身を含めることはサポートされていません。
transparentBorder : bool |
このプロパティは、アイテムのエッジ付近のぼかし動作を定義します。ピクセルのぼかしは、ソースエッジの外側のピクセルに影響されます。
このプロパティがtrue に設定されている場合、ソースの外側のピクセルは透明であると解釈され、これは OpenGL のクランプからボーダーへの拡張に似ています。ぼかしは、効果項目領域の外側でわずかに拡張される。
このプロパティがfalse に設定されている場合、ソースの外側のピクセルはアイテムの端のピクセルと同じ色を含むと解釈され、これは OpenGL のクランプから端への動作に似ています。ぼかしは効果アイテムの領域外には拡大しない。
デフォルトでは、このプロパティはfalse に設定されています。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
