RadialGradient QML Type

放射状のグラデーションを描画します。詳細...

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

プロパティ

• angle : real
• cached : bool
• gradient : Gradient
• horizontalOffset : real
• horizontalRadius : real
• source : variant
• verticalOffset : real
• verticalRadius : real

詳細な説明

グラデーションとは、2色以上の色がシームレスに混ざり合うことで形成されるものです。色はアイテムの中央から始まり、端で終わります。

例

以下の例は、この効果を適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    RadialGradient {
        anchors.fill: parent
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 0.5; color: "black" }
        }
    }
}

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

angle : real

このプロパティは、グラデーションの中心点を中心とした回転を定義します。この回転は、horizontalRadius プロパティとverticalRadius プロパティの値が等しくない場合にのみ表示されます。角度は度単位で指定され、デフォルト値は0 です。

cached : bool

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

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

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

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

gradient : Gradient

グラデーションとは、2色以上の色がシームレスに混ざり合うことで定義されます。色は、GradientStop の子要素のセットとして指定され、各要素はグラデーション上の位置（0.0～1.0）と色を定義します。各GradientStop の位置は、positionプロパティを設定することで定義されます。色は、colorプロパティを設定することで定義されます。

Gradient {
  GradientStop {
   position: 0.000
   color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
   position: 0.167
   color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
   position: 0.333
   color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
   position: 0.500
   color: Qt.rgba(0, 1, 1, 1)
   }
  GradientStop {
   position: 0.667
   color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
   position: 0.833
   color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
   position: 1.000
   color: Qt.rgba(1, 0, 0, 1)
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#F0F0F0"
  }
  GradientStop {
    position: 0.5
    color: "#000000"
  }
  GradientStop {
    position: 1.0
    color: "#F0F0F0"
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}

horizontalOffset : real

horizontalOffset およびverticalOffset プロパティは、アイテムの中心に対するグラデーションの中心点のオフセットをピクセル単位で指定します。

値の範囲は-infからinfです。デフォルトでは、これらのプロパティは0 に設定されています。

horizontalRadius : real

horizontalRadius およびverticalRadius プロパティは、放射状グラデーションの形状とサイズを定義します。半径が等しい場合、グラデーションの形状は円になります。水平半径と垂直半径が異なる場合、形状は楕円になります。半径はピクセル単位で指定されます。

値の範囲は-infからinfです。デフォルトでは、horizontalRadiusはwidthに、verticalRadius はheightに紐付けられています。

source : variant

このプロパティは、グラデーションで塗りつぶされる項目を指定します。ソース項目は中間ピクセルバッファにレンダリングされ、その結果から得られるアルファ値を用いて、表示上のグラデーションのピクセルの可視性が決定されます。source のデフォルト値は未定義であり、その場合はエフェクト領域全体がグラデーションで塗りつぶされます。

verticalOffset : real

horizontalOffset および verticalOffset プロパティは、アイテムの中心に対するグラデーションの中心点のオフセット（ピクセル単位）を定義します。

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

verticalRadius : real

horizontalRadius および verticalRadius プロパティは、放射状グラデーションの形状とサイズを定義します。半径が等しい場合、グラデーションの形状は円になります。水平半径と垂直半径が異なる場合、形状は楕円になります。半径はピクセル単位で指定されます。

値の範囲は -inf から inf です。デフォルトでは、horizontalRadius は幅に、verticalRadius は高さに紐付けられています。