RectangularGlow QML Type

ぼかしと色付けが施された長方形を生成し、元画像が光っているような印象を与えます。詳細...

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

プロパティ

• cached : bool
• color : color
• cornerRadius : real
• glowRadius : real
• spread : real

詳細な説明

このエフェクトは、優れたパフォーマンスを発揮するように設計されています。グローの形状は、角の半径をカスタマイズできる長方形に限定されています。独自の形状が必要な場合は、「Glow 」エフェクトをご検討ください。

例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Rectangle {
        id: background
        anchors.fill: parent
        color: "black"
    }

    RectangularGlow {
        id: effect
        anchors.fill: rect
        glowRadius: 10
        spread: 0.2
        color: "white"
        cornerRadius: rect.radius + glowRadius
    }

    Rectangle {
        id: rect
        color: "black"
        anchors.centerIn: parent
        width: Math.round(parent.width / 1.5)
        height: Math.round(parent.height / 2)
        radius: 25
    }
}

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

cached : bool

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

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

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

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

color : color

このプロパティは、グローに使用されるRGBAカラー値を定義します。

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

cornerRadius : real

このプロパティは、角が丸いグローを描画するために使用される角の半径を定義します。

値の範囲は 0.0 から、グローの実効幅または実効高さのいずれか小さい方の半分までです。これは次の式で計算できます:min(width, height) / 2.0 + glowRadius

デフォルトでは、このプロパティはglowRadius プロパティに紐付けられています。glowRadius プロパティを調整すると、グローはあたかも長方形がぼかされたかのように振る舞います。

glowRadius : real

このプロパティは、アイテム領域の外側までグローがどの程度広がるかを定義します。

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

spread : real

このプロパティは、光源の縁付近でグローカラーがどの程度強調されるかを定義します。

値の範囲は 0.0（強度の上昇なし）から 1.0（最大強度の上昇）までです。デフォルトでは、このプロパティは0.0 に設定されています。