HueSaturation QML Type

HSL色空間におけるソース項目の色を変更します。詳細...

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

プロパティ

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

詳細な説明

HueSaturationはColorize エフェクトと似ていますが、色相（hue）と彩度（saturation）のプロパティ値の扱いが異なります。HueSaturationエフェクトは、色相、彩度、明度を設定するのではなく、常に元の値からシフトさせます。

例

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

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
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

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

cached : bool

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

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

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

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

hue : real

このプロパティは、ソースの色相値に加算される色相値を定義します。

値の範囲は-1.0（減少）から1.0（増加）です。デフォルトでは、このプロパティは0.0 （変更なし）に設定されています。

lightness : real

このプロパティは、ソースの彩度値に加算される明度値を定義します。

値の範囲は-1.0（減少）から1.0（増加）です。デフォルトでは、このプロパティは0.0 （変更なし）に設定されています。

saturation : real

このプロパティは、ソースの彩度値に加算される彩度値を定義します。

値の範囲は、-1.0（減少）から1.0（増加）です。デフォルトでは、このプロパティは0.0 （変更なし）に設定されています。

source : variant

このプロパティは、エフェクトのソースピクセルを提供するソースアイテムを定義します。