LevelAdjust QML Type

RGBA色空間の色レベルを調整します。詳細...

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

プロパティ

• cached : bool
• gamma : variant
• maximumInput : color
• maximumOutput : color
• minimumInput : color
• minimumOutput : color
• source : variant

詳細説明

このエフェクトは、ソースアイテムの色をカラーチャンネルごとに個別に調整します。ソースアイテムのコントラストを調整し、カラーバランスを変更できます。

適用例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

プロパティの説明

cached : bool

このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。

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

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

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

gamma : variant

このプロパティは、各ピクセルの色チャンネルの値が式に従ってどのように変更されるかの変更係数を定義します：

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

QtVector3d(1.0,1.0,1.0)以下のガンマ値を設定すると暗くなり、QtVector3d(1.0,1.0,1.0)以上のガンマ値を設定すると明るくなります。

値の範囲はQtVector3d(0.0, 0.0, 0.0)(最も暗い)からinf(最も明るい)までです。デフォルトでは、QtVector3d(1.0, 1.0, 1.0) （変化なし）に設定されています。

maximumInput : color

このプロパティは、各色チャンネルの最大入力レベルを定義する。このプロパティは白色点を設定し、このプロパティより高い値を持つすべてのピクセルは白色としてレンダリングされます（色チャンネルごと）。値を小さくすると、明るい部分が明るくなります。

値の範囲は "#ffffffff" から "#00000000" です。デフォルトでは、このプロパティは"#ffffffff" （変更なし）に設定されています。

maximumOutput : color

このプロパティは、各色チャンネルの最大出力レベルを定義する。値を小さくすると明るい部分が暗くなり、コントラストが低下します。

値の範囲は「#ffffffff」から「#00000000」までです。デフォルトでは、このプロパティは"#ffffffff" （変更なし）に設定されています。

minimumInput : color

このプロパティは、各色チャンネルの最小入力レベルを定義する。これはブラックポイントを設定し、このプロパティより低い値を持つすべてのピクセルは黒としてレンダリングされます（カラーチャンネルごとに）。値を大きくすると暗い部分が暗くなります。

値の範囲は "#00000000" から "#ffffff" です。デフォルトでは、このプロパティは"#00000000" （変更なし）に設定されています。

minimumOutput : color

このプロパティは、各色チャンネルの最小出力レベルを定義する。値を大きくすると暗い部分が明るくなり、コントラストが低下します。

値の範囲は "#00000000" から "#ffffff" までです。デフォルトでは、このプロパティは"#00000000" （変更なし）に設定されています。

source : variant

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