MaskedBlur QML Type

強度が変化するぼかし効果を適用します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• cached : alias
• maskSource : alias
• radius : alias
• samples : alias
• source : alias

詳細な説明

MaskedBlurエフェクトは、画像にぼかしをかけて柔らかく仕上げます。maskSource を使用することで、ピクセルごとにぼかしの強度を制御できるため、元の画像の一部を他の部分よりも強くぼかすことが可能です。

リアルタイムでのぼかし処理は負荷の高い操作です。サンプル数がそれほど多くない場合でも、フルスクリーンのガウスぼかしは、ハイエンドのグラフィックスハードウェアであっても60 fpsでしか実行できません。

例

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

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
    }

    LinearGradient {
        id: mask
        anchors.fill: bug
        gradient: Gradient {
            GradientStop { position: 0.2; color: "#ffffffff" }
            GradientStop { position: 0.5; color: "#00ffffff" }
        }
        start: Qt.point(0, 0)
        end: Qt.point(300, 0)
        visible: false
    }

    MaskedBlur {
        anchors.fill: bug
        source: bug
        maskSource: mask
        radius: 16
        samples: 24
    }
}

プロパティのドキュメント

cached : alias

このプロパティを有効にすると、エフェクトの出力ピクセルがキャッシュされ、レンダリングパフォーマンスが向上します。ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ使用量が増加します。

ソースまたはエフェクトのプロパティがアニメーション処理される場合は、キャッシュを無効にすることを推奨します。

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

maskSource : alias

このプロパティは、ぼかしの最終的な強度を制御する項目を定義します。maskSource のピクセルアルファチャンネルの値は、対応するソースピクセルをぼかす際に実際に使用されるぼかし半径を決定します。

maskSourceの不透明なピクセルは、指定されたradius でぼかしを生成しますが、透明なピクセルはぼかしを完全に抑制します。半透明なmaskSourceピクセルは、ピクセルの透明度レベルに応じて補間された半径でぼかしを生成します。

radius : alias

このプロパティは、個々のピクセルのぼかしに影響を与える隣接ピクセルとの距離を定義します。半径を大きくすると、ぼかし効果が強くなります。

半径の値に応じて、視覚的な品質を確保するために、samples の値を十分に大きく設定する必要があります。

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

samples : alias

このプロパティは、ぼかし計算を行う際に1ピクセルあたり何個のサンプルを採取するかを定義します。値を大きくすると画質は向上しますが、レンダリングに時間がかかります。

理想的には、この値は必要な最大半径値の2倍に1を加えた値に設定すべきです。例えば、半径が0.0から4.0の間でアニメーションされる場合、サンプル数は9に設定する必要があります。

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

このプロパティはアニメーション化を想定していません。このプロパティを変更すると、基盤となる OpenGL シェーダーが再コンパイルされる場合があります。

source : alias

このプロパティは、ぼかし処理の対象となるソースアイテムを指定します。