このページでは

FastBlur QML Type

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

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

Item

プロパティ

詳細説明

注意: MultiEffect コンポーネントは、いくつかのパフォーマンス上の利点を持つぼかし効果を提供します。新しいコードでは、QtGraphical Effects を使用する代替として考慮する必要があります。

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

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