FastBlur QML Type

1つまたは複数のソースアイテムに高速ぼかし効果を適用します。詳細...

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

Item

プロパティ

詳細説明

FastBlur エフェクトは、ソース コンテンツのダウンスケーリングとバイリニア フィルタリングを使用するアルゴリズムで、ソース コンテンツをぼかして柔らかくします。

ソース適用される効果

適用例

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

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
    }

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

プロパティの説明

cached : bool

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

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

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

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


radius : real

このプロパティは、個々のピクセルのぼかしに影響を与える隣接ピクセルの距離を定義します。半径が大きいほど、ぼかし効果が大きくなります。FastBlur アルゴリズムは、良好なレンダリングパフォーマンスを提供するために、内部的に半径の精度を下げることがあります。

値の範囲は0.0(ぼかしなし)からinfまでです。半径が値64を超えると、ぼかしの視覚的品質が低下します。デフォルトでは、このプロパティは0.0 (ぼかしなし)に設定されています。

ブラー値を変えた出力例

半径: 0 半径32 半径: 64

source : variant

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

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


transparentBorder : bool

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

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

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

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

transparentBorder の値を変えた出力例

transparentBorder: false transparentBorder: true
radius: 64radius: 64

© 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.