ConicalGradient QML Type

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

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

プロパティ

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

詳細な説明

グラデーションとは、2色以上の色がシームレスに混ざり合うことで定義されます。色は指定された角度から始まり、その角度値に360度を加えた角度で終わります。

例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    ConicalGradient {
        anchors.fill: parent
        angle: 0.0
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

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

angle : real

このプロパティは、グラデーションの位置 0.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` に設定されています。

source : variant

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

verticalOffset : real

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

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