Color QML Type (Singleton)

色に関するユーティリティ関数を保持しています。詳細...

注：この型はQMLシングルトンです。QMLエンジン内には、この型のインスタンスが1つしか存在しません。

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

メソッド

• color blend(color a, color b, real factor)
• color darker(color baseColor, real factor)
• bool equal(color lhs, color rhs)
• color fromString(string name)
• color hsla(real hue, real saturation, real lightness, real alpha)
• color hsva(real hue, real saturation, real value, real alpha)
• color lighter(color baseColor, real factor)
• color rgba(real red, real green, real blue, real alpha)
• color tint(color baseColor, color tintColor)
• color transparent(color color, real opacity)

詳細な説明

メソッドのドキュメント

color blend(color a, color b, real factor)

a とb をブレンドした色を返します。結果の色は、a およびb の RGB カラーチャンネルの独立した線形補間から構成されます。

factor が 0.0 より小さい場合、a が返されます。factor が 1.0 より大きい場合、b が返されます。

color darker(color baseColor, real factor)

指定されたfactor 分だけ、baseColor よりも暗い色を返します。

この関数は、現在のRGB色をHSVに変換し、値（V）成分をfactorで割り、その色を再びRGBに変換します。

factorが1.0より大きい場合、この関数はより暗い色を返します。 factor を 3.0 に設定すると、明度が 3 分の 1 の色が返されます。factor が 1.0 未満の場合、返される色は明るくなりますが、この目的にはColor::lighter() 関数を使用することをお勧めします。factor が 0 または負の場合、戻り値は未定義となります。

bool equal(color lhs, color rhs)

lhs とrhs が等しい場合、true を返します。operator==() を参照してください。

color fromString(string name)

指定されたname に対応する色（つまり、red または #ff0000）を返します。そのような色が存在しない場合は、例外がスローされます。

color hsla(real hue, real saturation, real lightness, real alpha)

指定されたhue 、saturation 、lightness 、およびalpha の各成分を持つ色を返します。すべての成分は0から1までの範囲（0および1を含む）である必要があります。

color hsva(real hue, real saturation, real value, real alpha)

指定されたhue 、saturation 、value 、alpha の各成分を持つ色を返します。すべての成分は0～1（両端を含む）の範囲内である必要があります。

color lighter(color baseColor, real factor)

指定されたfactor 分だけ、baseColor よりも明るい色を返します。

この関数は、現在のRGB色をHSVに変換し、値（V）成分に倍率を乗算してから、その色を再びRGBに変換します。

factorが1.0より大きい場合、この関数はより明るい色を返します。 factor を 1.5 に設定すると、50% 明るい色が返されます。factor が 1.0 未満の場合、返される色は暗くなりますが、この目的にはColor::darker() 関数の使用を推奨します。factor が 0 または負の場合、戻り値は未定義となります。

color rgba(real red, real green, real blue, real alpha)

指定されたred 、green 、blue 、およびalpha の各成分を持つ色を返します。すべての成分は0～1（両端を含む）の範囲内である必要があります。

color tint(color baseColor, color tintColor)

この関数を使用すると、ある色（baseColor ）に別の色（tintColor ）の着色効果を加えることができます。

通常、ティントカラーはほぼ透明である必要があります。そうしないと、下地の色が見えなくなってしまいます。以下の例では、ティントカラーを不透明度がわずか1/16の純赤に設定することで、わずかに赤みを帯びた色合いにしています。

Item {
    Rectangle {
        x: 0
        width: 80
        height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Color.tint("lightsteelblue", "#10FF0000")
    }
}

ティントは、何らかのイベントによって微妙な変化を表現したい場合に最も有用です。ティントを使用することで、表示される色を効果的に調整することができます。

color transparent(color color, real opacity)

アルファ値がopacity のcolor を返します。この値は、0（完全に透明）から1（完全に不透明）までの範囲です。