Colorize QML Type

HSL色空間の色を設定します。詳細...

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

プロパティ

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

詳細な説明

このエフェクトは、グレースケール画像の上に色付けされたガラスを重ねたときと同様の効果をもたらします。Colorizeは、色相（hue）、彩度（saturation）、明度（lightness）からなるHSL色空間を使用します。各プロパティについて、希望する値を指定できます。HueSaturation エフェクトを使用すると、すべてのHSL値をシフトさせることができます。

あるいは、ColorOverlay エフェクトを使用して、ソースアイテムをRGBA色空間でカラー化することも可能です。

例

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

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
    }

    Colorize {
        anchors.fill: bug
        source: bug
        hue: 0.0
        saturation: 0.5
        lightness: -0.2
    }
}

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

cached : bool

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

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

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

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

hue : real

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

値の範囲は 0.0 から 1.0 です。デフォルトでは、このプロパティは `0.0` に設定されており、これによりわずかに赤みがかった色が生成されます。

lightness : real

このプロパティは、元の明度値をどれだけ増減させるかを定義します。

色相や彩度のプロパティとは異なり、明度は使用される値を設定するのではなく、既存の光源ピクセルの明度値をシフトさせます。

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

saturation : real

このプロパティは、ソースに色付けを行う際に使用される彩度値を定義します。

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

source : variant

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