MaskedBlur QML Type

さまざまな強さのぼかし効果を適用します。詳細...

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

プロパティ

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

詳細説明

MaskedBlur エフェクトは画像をぼかすことでソフトにします。ぼかしの強さは、maskSource を使ってピクセルごとに制御できるので、ソースのある部分が他の部分よりもぼかされます。

ぼかしをライブで実行するのはコストのかかる操作です。適度なサンプル数のフルスクリーンガウスぼかしでさえ、ハイエンドグラフィックスハードウェアでは60fpsでしか実行できません。

例

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

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

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

例えば、半径が 0.0 から 4.0 の間でアニメートされる場合、サンプル数は 9 に設定されるべきです。

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

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

source : alias

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